Messages

The Messages tab of the Properties panel enables you to send debug messages to individual drones. Available messages for each supported autopilot type are summarized below.

Table 1. Supported messages with ArduCopter firmware
usage description

calib COMPONENT

calibrate the given component, where COMPONENT can be one of accel, baro, compass, gyro or level

color R G B

override the light module with the given RGB color (use values for the R, G and B channels between 0 and 255)

color #RRGGBB

override the light module with the given RGB color (expressed in hexadecimal numbers)

color NAME

override the light module with the given color if NAME is recognized as a color name (e.g., red)

color off

stop overriding the light module with GCS-based colors

mode NAME

switch the drone into the flight mode given by NAME, such as show, land, rth, loiter etc. (works only on ArduCopter-based drones)

param NAME

get the value of an autopilot configuration parameter given in NAME

param NAME=VALUE

set the value of an autopilot configuration parameter given in NAME to VALUE

servo CHANNEL VALUE

set the (1-based) servo channel (CHANNEL) on the UAV to the given raw PWM value (VALUE)

show remove

remove the current show file from the autopilot

test camera

perform camera test

test led

perform LED test

test motor

perform individual motor tests for all motors consecutively

test pyro

perform pyro test on all pyro channels in parallel

version

show the version of the autopilot

Table 2. Supported messages with Crazyflie firmware
usage description

alt VALUE

send the UAV to the given altitude (VALUE)

color R G B

override the light module with the given RGB color (use values for the R, G and B channels between 0 and 255)

color #RRGGBB

override the light module with the given RGB color (expressed in hexadecimal numbers)

color NAME

override the light module with the given color if NAME is recognized as a color name (e.g., red)

color off

stop overriding the light module with GCS-based colors

fence [get]

show the activation status of the geofence of the UAV

fence on

activate the geofence on the UAV

fence off

deactivate the geofence on the UAV

fence set XMIN YMIN ZMIN XMAX YMAX ZMAX

set up a geofence based on the given axis-aligned bounding box expressed with parameters XMIN YMIN ZMIN XMAX YMAX and ZMAX

go X Y Z

send the UAV to the given X, Y and Z coordinates

home

retrieve the current home position of the UAV

kalman reset

reset the Kalman filter of the UAV

land

send a land command to the UAV

mode NAME

switch the drone into the flight mode given by NAME, such as show, land, rth, loiter etc. (works only on ArduCopter-based drones)

motoroff

stop the motor of the UAV immediately (alias to the stop command)

param NAME

get the value of an autopilot configuration parameter given in NAME

param NAME=VALUE

set the value of an autopilot configuration parameter given in NAME to VALUE

show remove

remove the current show file from the autopilot

stop

stop the motor of the UAV immediately

test battery

perform battery test

test led

perform LED test

test motor

perform individual motor tests for all motors consecutively

version

show the version of the autopilot

Table 3. Supported messages with virtual drones
usage description

arm

arm the virtual UAV if it is on the ground

async_exception

throw an asynchronous exception

battery VALUE

sets the voltage level of the battery of the virtual UAV to the given VALUE, in Volts, or to the given percentage if VALUE ends with %

calib COMPONENT

calibrate the given component, where COMPONENT can be one of accel, baro, compass, gyro or level

color R G B

override the light module with the given RGB color (use values for the R, G and B channels between 0 and 255)

color #RRGGBB

override the light module with the given RGB color (expressed in hexadecimal numbers)

color NAME

override the light module with the given color if NAME is recognized as a color name (e.g., red)

color off

stop overriding the light module with GCS-based colors

disarm

disarm the virtual UAV

echo MESSAGE

echo a message back to the client using a SYS-MSG message and as normal response as well

error X

sets the error code of the drone to X, where X should be a number in the 0-65535 range (0 clears errors).

exception

throw a synchronous exception

param NAME

get the value of an autopilot configuration parameter given in NAME

param NAME=VALUE

set the value of an autopilot configuration parameter given in NAME to VALUE

progress

dummy command that can be used to test progress reports sent during the execution of a command

progress_and_suspend

dummy command that can be used to test progress reports sent during the execution of a command, with suspension support

test led

perform LED test

test motor

perform individual motor tests for all motors consecutively

timeout

dummy command that does not respond in a reasonable amount of time; can be used on the client side to test response timeouts

version

show the version of the autopilot

yo

test basic communication with the autopilot