Decoder and tracer for RISC-V E-Traces

This library provides a decoder and a tracer for the instruction tracing defined in the Efficient Trace for RISC-V specification. It provides:

a decoder and an encoder for instruction trace payloads as well as a few relevant packet formats,
a software trace encoder implementation, which produces payloads from user-defined steps of execution,
a tracer which processes these payloads and generates a sequence of tracing items, each corresponding to a single traced instruction,
a specialized instruction database with limited decoding capabilities,
support for user-provided and external instruction types and
various utilities, including types for handling trace encoder parameters.

Supported packet formats

The following packet formats are supported directly by this library:

Unformatted Trace & Diagnostic Data Packet Encapsulation for RISC-V and
Siemens Messaging Infrastructure.

Supported external instruction information types

In addition to a built-in type for instruction information, the following libraries are supported:

riscv-isa.

Supported trace encoders

Some aspects of support packets are defined by trace encoder implementations. This library provides an interface for abstracting them and support for the followng specific encoders (and, of course, compatible units):

the reference encoder implementation and
the PULP rv tracer.

License

This library is licensed under the Apache License 2.0.

Acknowledgment