Capturing modem trace data

nRF Connect for Desktop

tags
nRF Connect for Desktop

Complete the following steps to trace data:

  1. Set the trace options in the Cellular Monitor app side panel according to your needs. See Overview and user interface for the description of the available options.

  2. If you want traces to be saved, make sure that Save trace file to disk is enabled before starting the trace.

  3. Click Start to trace. Depending on the options you have chosen, the application starts tracing and applies the selected options. The initialization of tracing can take some time.

  4. Generate additional trace data.

  5. Follow the progress in the Connection Status side panel. On success, the stage's status indicator turns green with a checkmark.

    If a stage fails, a red X is displayed along with a reason for the failure. You can check the corresponding dashboard field for troubleshooting information.

    • If the minimum requirements for trace have been met, the Trace checkmark should be green. See Minimum requirements and limitations.
    • SIM shows the Subscriber Identity Module (SIM) card status. For example, if you remove your SIM card from the device, the SIM turns red.
    • Long-Term Evolution (LTE) Connection depends on conditions in the local cellular network to which you are subscribed.
    • Packet Data Network (PDN) turns green when the device has successfully connected to the connection endpoint.

Cellular Monitor app: tracing started

For more information on trace data visualization, see Viewing a modem trace in the Cellular Monitor app.

If the trace data is not displayed or the file size does not increase, check the following settings:

  • The trace serial port used.
    The number and function of the serial ports depends on the selected device and the onboard application firmware.

    The virtual serial ports on a Nordic Semiconductor Development Kit (DK) are indexed from zero. Your computer's operating system maps each of the device's virtual serial ports to a unique, persistent serial port identifier for the device and computer. The nRF Connect for Desktop app lists the selected device's serial ports in ascending order of its virtual serial port index.

    Note

    Serial ports are also referred to as COM ports on Windows, ttyACM devices on Linux, and /dev/tty devices on macOS.

  • The default UART trace settings: 1,000,000 baud rate, with hardware flow control enabled.