Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / OpenCSD / aacd01a2fc2429d2e98e33c4a9c9b99d7cc1c5af
commitaacd01a2fc2429d2e98e33c4a9c9b99d7cc1c5af[log] [tgz]
authorMike Leach <mike.leach@linaro.org>Mon Jul 18 16:24:37 2016 +0100
committerMike Leach <mike.leach@linaro.org>Thu Aug 18 13:00:36 2016 +0100
tree072efca3b0617386d1de6f700ee1f1ef26f996dd
parent7a953e5c10f7a36305b9013b850bfe9bb7ba7a93 [diff]
opencsd: Update memory accessor API on decode tree.

Memory accessors allow trace analyser to follow opcodes of program traced.
The C-API has a relatively simple _add_accessor-...() set of functions.

The decode tree allowed access to the accessor map object which collates
all the accessors by address and a couple of functions to add to the map.

This results in the decode tree API for memory accessors requiring some
knowledge of the memory mapper, plus this resulted in a lot of intermediate
code in the C-API wrapper to do all the mapping operations.

The decode tree now also has a simple _AddAccessor interface, all the
intermediate code now being inside the decode tree object.

This makes the C-API and decode tree API consistent and the C++ library
easier to used.

Signed-off-by: Mike Leach <mike.leach@linaro.org>
9 files changed
tree: 072efca3b0617386d1de6f700ee1f1ef26f996dd
  1. decoder/
  2. .gitignore
  3. HOWTO.md
  4. LICENSE
  5. README.md
  6. TODO
README.md

OpenCSD - An open source CoreSight(tm) Trace Decode library {#mainpage}

This library provides an API suitable for the decode of ARM(r) CoreSight(tm) trace streams.

The library will decode formatted trace in three stages:-

  1. Frame Deformatting : Removal CoreSight frame formatting from individual trace streams.
  2. Packet Processing : Separate individual trace streams into discrete packets.
  3. Packet Decode : Convert the packets into fully decoded trace describing the program flow on a core.

The library is implemented in C++ with an optional "C" API.

CoreSight Trace Component Support.

Current Version 0.004

Current support:

  • ETMv4 instruction trace - packet processing and packet decode.
  • PTM instruction trace - packet processing and packet decode.
  • ETMv3 instruction trace - packet processing and packet decode.
  • ETMv3 data trace - packet processing.
  • STM software trace - packet processing.

Support to be added:

  • STM software trace - packet decode.
  • ITM software trace - packet processing and decode.
  • ETMv3 data trace - packet decode.
  • ETMv4 data trace - packet processing and decode.

Note: for ITM and STM, packet decode is combining Master+Channel+Marker+Payload packets into a single generic output packet.

Note on the Git Repository.

At present, the git repository for OpenCSD contains both branches for the OpenCSD library itself, and branches that have the perf updates that are not yet upstream in the main linux tree for using perf to record and decode trace.

These perf branches are snapshots of the kernel tree and are thus quite large. It is advised if only the OpenCSD library is required, clone only selected branches. Otherwise, downloading may take some time.

e.g.

git clone -b opencsd-0v003 --single-branch https://github.com/Linaro/OpenCSD

Documentation

API Documentation is provided inline in the source header files, which use the doxygen standard mark-up. Run doxygen on the ./doxygen_config.dox file located in the ./docs directory..

doxygen ./doxygen_config.dox

This will produce the documentation in the ./docs/html directory. The doxygen configuration also includes the *.md files as part of the documentation.

Building the Library

See [build_libs.md](@ref build_lib) in the ./docs directory for build details.

How the Library is used in Linux perf

The library and additional infrastructure for programming CoreSight components has been integrated with the standard linux perfomance analysis tool perf.

See [HOWTO.md](@ref howto_perf) for details.

Version and Modification Information

  • Version 0.001: Library development - tested with perf tools integration - BKK16, 8th March 2016
  • Version 0.002: Library development - added in PTM decoder support. Restructure header dir, replaced ARM rctdl prefix with opencsd/ocsd.
  • Version 0.003: Library development - added in ETMv3 instruction decoder support.
  • Version 0.004: In development - decode tree api updates.

Licence Information

This library is licensed under the BSD three clause licence.

A copy of this license is in the LICENCE file included with the source code.