Help¶

TRC_START: Starts the tracing directly. In snapshot mode this allows for
starting the trace at any point in your code, assuming vTraceEnable(TRC_INIT)
has been called in the startup.
Can also be used for streaming without Tracealyzer control, e.g. to a local
flash file system (assuming such a "stream port", see trcStreamingPort.h).

TRC_START_AWAIT_HOST: For streaming mode only. Initializes the trace recorder
if necessary and waits for a Start command from Tracealyzer ("Start Recording"
button). This call is intentionally blocking! By calling vTraceEnable with
this option from the startup code, you start tracing at this point and capture
the early events.

TRC_INIT: Initializes the trace recorder, but does not start the tracing.
In snapshot mode, this must be followed by a vTraceEnable(TRC_START) sometime
later.

Direct dependencies¶

PERCEPIO_TRACERECORDER

(Includes any dependencies from ifs and menus.)

Default¶

PERCEPIO_RECORDER_CFG_START_MODE_START_AWAIT_HOST

Choice options¶

Kconfig definition¶

At /home/runner/work/sdk-nrf/sdk-nrf/ncs/modules/debug/TraceRecorder/kernelports/Zephyr/Kconfig:32

Included via <Zephyr>/Kconfig:8 → <Zephyr>/Kconfig.zephyr:23 → <Zephyr>/modules/Kconfig:6 → <BuildDir>/kconfig/Kconfig.modules:56

Menu path: (Top) → Modules → TraceRecorder (/home/runner/work/sdk-nrf/sdk-nrf/ncs/modules/debug/TraceRecorder) → Percepio Trace Recorder

choice PERCEPIO_RECORDER_CFG_START_MODE
    bool "Recorder Start Mode"
    default PERCEPIO_RECORDER_CFG_START_MODE_START_AWAIT_HOST
    depends on PERCEPIO_TRACERECORDER
    help
      TRC_START: Starts the tracing directly. In snapshot mode this allows for
      starting the trace at any point in your code, assuming vTraceEnable(TRC_INIT)
      has been called in the startup.
      Can also be used for streaming without Tracealyzer control, e.g. to a local
      flash file system (assuming such a "stream port", see trcStreamingPort.h).

      TRC_START_AWAIT_HOST: For streaming mode only. Initializes the trace recorder
      if necessary and waits for a Start command from Tracealyzer ("Start Recording"
      button). This call is intentionally blocking! By calling vTraceEnable with
      this option from the startup code, you start tracing at this point and capture
      the early events.

      TRC_INIT: Initializes the trace recorder, but does not start the tracing.
      In snapshot mode, this must be followed by a vTraceEnable(TRC_START) sometime
      later.

(The ‘depends on’ condition includes propagated dependencies from ifs and menus.)