Crate itm_decode

A sans-I/O decoder for the ITM and DWT packet protocol as specifed in the ARMv7-M architecture reference manual, Appendix D4. Any references in this code base refers to this document.

Common abbreviations:

• ITM: instrumentation trace macrocell;
• PC: program counter;
• DWT: data watchpoint and trace unit;
• MSB: most significant bit;
• BE: big-endian;

Modules

cortex_m

Re-exports for exception types from the cortex-m crate.

Structs

Decoder

ITM and DWT packet protocol decoder.

Timestamp

Combined timestamp generated from local and global timestamp packets. Field values relate to the target’s global timestamp clock. See (Appendix C1, page 713).

TimestampedContext

A context in which to record the current timestamp between calls to Decoder::pull_with_timestamp.

TimestampedTracePackets

Association between a set of TracePackets and their Timestamp.

Enums

DecoderError

A header or payload byte failed to be decoded. The state of the decoder is now in an unknown state and manual intervention is required.

DecoderState

The decoder’s possible states. The default decoder state is Header and will always return there after a maximum of two steps. (E.g. if the current state is Syncing or HardwareSource, the next state is Header again.)

ExceptionAction

Denotes the exception action taken by the processor. (Table D4-6)

MemoryAccessType

Denotes the type of memory access.

TimestampDataRelation

Indicates the relationship between the generation of the local timestamp packet and the corresponding ITM or DWT data packet. (Appendix D4.2.4)

TracePacket

The set of possible packet types that may be decoded.