Skip to content

nsx doctor

Checks the local NSX development environment.

This command is useful before creating an app, and it is the first command to run when flash or view problems suggest a local tool issue rather than an app issue.

Syntax

nsx doctor [--json]

What It Checks

  • Python availability
  • uv
  • CMake
  • Ninja
  • Arm GNU toolchain (arm-none-eabi-gcc)
  • Arm Compiler for Embedded (armclang, armlink, fromelf) — optional
  • Arm Toolchain for Embedded ($ATFE_ROOT/bin/clang, llvm-objcopy, picolibc newlib config) — optional
  • JLinkExe
  • JLinkSWOViewerCL
  • basic SEGGER J-Link runtime startup

Use --json to emit the complete report in machine-readable form.

Example

nsx doctor

Notes

  • doctor checks that the tools are installed and can start.
  • it does not require a connected target board
  • if SEGGER runtime startup fails, fix that before debugging nsx flash or nsx view
  • run nsx commands --json for the authoritative machine-readable argument schema