Orbcode Trace functions library
Public Attributes | List of all members

ITM configuration options. More...

#include <itm.h>

Public Attributes

int TraceBusID
 Trace bus ID. More...
 
ITMGlobalTimestampFrequency GlobalTimestampFrequency
 Configure global timestamp frequency. More...
 
ITMLocalTimestampPrescaler LocalTimestampPrescaler
 Configure local timestamp frequency. More...
 
bool EnableLocalTimestamp
 Enable local timestamps. More...
 
bool ForwardDWT
 Forward DWT packets. More...
 
bool EnableSyncPacket
 Enable ITM synchronization packet. More...
 
uint32_t EnabledStimulusPorts
 Enable stimulus port. More...
 

Detailed Description

ITM configuration options.

Check with vendor documetation which capabilities are available.

Member Data Documentation

◆ TraceBusID

int ITMOptions::TraceBusID

Trace bus ID.

This value is available in TPIU packets when formatting (TpiuOptions::FormattingEnabled) is enabled. It used to differentiate different trace data sources (e.g. ITM and ETM.)

◆ GlobalTimestampFrequency

ITMGlobalTimestampFrequency ITMOptions::GlobalTimestampFrequency

Configure global timestamp frequency.

Global timestamps are absolute values.

See ARMv7-M Architecture Reference Manual, section C1.7.1 ITM operation subsection Timestamp support for details.

◆ LocalTimestampPrescaler

ITMLocalTimestampPrescaler ITMOptions::LocalTimestampPrescaler

Configure local timestamp frequency.

Each local timestamp packet provides time delta relative to previous local timestamp packet.

See ARMv7-M Architecture Reference Manual, section C1.7.1 ITM operation subsection Timestamp support for details.

◆ EnableLocalTimestamp

bool ITMOptions::EnableLocalTimestamp

Enable local timestamps.

When enabled, local timestamp packets will be generated according to LocalTimestampPrescaler setting.

◆ ForwardDWT

bool ITMOptions::ForwardDWT

Forward DWT packets.

This is necessary to output e.g. PC sampling or data watchpoint packets. If the only required ITM capability is stimululs port output, there is no need to enable this option

◆ EnableSyncPacket

bool ITMOptions::EnableSyncPacket

Enable ITM synchronization packet.

Enable periodic synchronization packet which can be used by receiver to synchronize to incoming bit stream.

See ARMv7-M Architecture Reference Manual, section C1.7.1 ITM operation subsection Synchronization support for details.

◆ EnabledStimulusPorts

uint32_t ITMOptions::EnabledStimulusPorts

Enable stimulus port.

Each bit corresponds to single stimulus port. Bit set to 1 means that port is enabled, set to 0 - disabled. It is valid to set 1 for ports not available in specific MCU, however these ports will still be treated as disabled.

Set to ITM_ENABLE_STIMULUS_PORTS_ALL to enable all available ports.


The documentation for this struct was generated from the following file: