Update version information files. Update README.md to describe new version updates. Update HOWTO.md for additional perf build option.
Signed-off-by: Mike Leach mike.leach@linaro.org --- HOWTO.md | 11 ++++++++++- README.md | 4 +++- TODO | 16 ++-------------- decoder/include/ocsd_if_version.h | 6 +++--- 4 files changed, 18 insertions(+), 19 deletions(-)
diff --git a/HOWTO.md b/HOWTO.md index 596efab..835def5 100644 --- a/HOWTO.md +++ b/HOWTO.md @@ -7,7 +7,7 @@ This HOWTO explains how to use the perf cmd line tools and the openCSD library to collect and extract program flow traces generated by the CoreSight IP blocks on a Linux system. The examples have been generated using an aarch64 Juno-r0 platform. All information is considered accurate and tested -using library version v0.5 and the `perf-opencsd-master` branch on the +using library version v0.6 and the `perf-opencsd-master` branch on the [OpenCSD github repository][1].
@@ -308,6 +308,15 @@ When compiling Perf, some perl libraries may not be present on the host system. Adding the "NO_LIBPERL=1" option will prevent the build script from complaining too much.
+Additional debug output from the decoder can be compiled in by setting the +`CSTRACE_RAW` environment variable. Setting this to `packed` gets trace frame +output as follows:- + + Frame Data; Index 576; RAW_PACKED; d6 d6 d6 d6 d6 d6 d6 d6 fc fb d6 d6 d6 d6 e0 7f + Frame Data; Index 576; ID_DATA[0x14]; d7 d6 d7 d6 d7 d6 d7 d6 fd fb d7 d6 d7 d6 e0 + +Set to any other value will remove the RAW_PACKED lines. + At the end of the compilation a new perf binary is available in `tools/perf/`
diff --git a/README.md b/README.md index f7c2e26..464f070 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,7 @@ Releases will appear on the master branch in the git repository with an appropri CoreSight Trace Component Support. ----------------------------------
-_Current Version 0.5.4_ +_Current Version 0.6.0_
### Current support:
@@ -107,6 +107,8 @@ Version and Modification Information - _Version 0.5.2_: Minor Update & Bugfixes - Update trace info packet string o/p + Cycle count packet bugfixes. - _Version 0.5.3_: Doc update for using AutoFDO with ETM and additional timestamp and cycle count options. - _Version 0.5.4_: Updates: X-compile for arm/arm64. Remove deprecated VS2010 builds. Bugfix: GCC inline semantics in debug build. +- _Version 0.6.0_: Packet printers moved from tests into the main library. C++ and C APIs updated to allow clients to use them. + Update to allow perf to insert barrier packets (4xFSYNC) which the decoder can be made to use to reset the decode state.
Licence Information =================== diff --git a/TODO b/TODO index e705a82..1dbb6dd 100644 --- a/TODO +++ b/TODO @@ -1,15 +1,3 @@ -* Decode Tree API updates. --> Re-factor the decode tree API to: - 1) Use new structure to enable custom decoders - may be proprietary / binaries to - be used in the decoder structure. - 2) Make it easier to add a new decoder to the library source, without the overhead of - doing all the creation fns. - -* STM "full decode". --> This is simply to come up with a generic packet format that will consist of - Master+Channel+<payload>, where <payload> is [data]+[TS]+[marker/flag]. This - combines a number of packets from the raw STPv2 format. - * ETMv4/PTM - decoder updates to handle advanced configuration. -> Certain (currently unused by perf / current hardware) configuration settings can alter the format of the trace output. One example is Return Stack - @@ -26,6 +14,6 @@ the instruction trace.
Cortex-A cores do not support this architecturally. On R and M profile cores it -is an option. There are scenrios in future that could see linux on R cores, plus +is an option. There are scenarios in future that could see linux on R cores, plus on something like Juno it is possible to switch on trace for the SCP -(M class processor). So at some point data trace +(M class processor). So at some point data trace may be required. diff --git a/decoder/include/ocsd_if_version.h b/decoder/include/ocsd_if_version.h index 0fd0a2a..1d58607 100644 --- a/decoder/include/ocsd_if_version.h +++ b/decoder/include/ocsd_if_version.h @@ -43,8 +43,8 @@ /** @name Library Versioning @{*/ #define OCSD_VER_MAJOR 0x0 /**< Library Major Version */ -#define OCSD_VER_MINOR 0x5 /**< Library Minor Version */ -#define OCSD_VER_PATCH 0x4 /**< Library Patch Version */ +#define OCSD_VER_MINOR 0x6 /**< Library Minor Version */ +#define OCSD_VER_PATCH 0x0 /**< Library Patch Version */
/** Library version number - MMMMnnpp format. MMMM = major version, @@ -53,7 +53,7 @@ */ #define OCSD_VER_NUM (((uint32_t)OCSD_VER_MAJOR << 16) | ((uint32_t)OCSD_VER_MINOR << 8) | ((uint32_t)OCSD_VER_PATCH))
-#define OCSD_VER_STRING "0.5.4" /**< Library Version string */ +#define OCSD_VER_STRING "0.6.0" /**< Library Version string */ #define OCSD_LIB_NAME "OpenCSD Library" /**< Library name string */ #define OCSD_LIB_SHORT_NAME "OCSD" /**< Library Short name string */ /** @}*/