NSH Debugging

NSH is the PX4 command-line debugging terminal. It can be used to view low-level operating status, module status, parameters, uORB topics, and communication links. This page is intended for advanced users with flight controller debugging experience.

Warning:

NSH commands may change parameters, actuator states, or module operating states. Before executing commands that write data, stop or restart modules, or involve motors, remove the propellers, back up the parameters, and confirm that the commands are applicable to the current PX4 build.

Accessing NSH via QGC

Prerequisites

• QGC is successfully connected to FlyCore-FC;
• The aircraft is in a safe, non-armable state for ground debugging;
• If parameters need to be modified, the current parameters have been exported and their original values recorded.

Procedure

1. In QGC, go to the Analyze page.
2. Open MAVLink Console.
3. Enter a read-only status command and press Enter to execute it.

Common Read-Only Diagnostic Commands

Examples of High-Risk Commands

After execution, restart PX4 and complete propeller-free verification for each motor as described in Actuator Configuration and Motor Testing.