跳到主要内容

Remote Control

Interface Changes​

✓ available, — not available. Interfaces not listed are identical on EVO Nest and Autel Nest2.

MethodFunctionEVO NestAutel Nest2Notes
drc_emergency_return_nestEmergency Return to Dock—✓
drone_emergency_disarmEmergency Propeller Stop—✓
drc_manual_precision_landingManual Precision Landing✓—

Service

Emergency Motor Stop​

seq is an incrementing sequence number to ensure commands are executed in order, at the same level as data

Topic: thing/product/{gateway_sn}/drc/down

Direction: down

Method: drone_emergency_stop

Data: null

Example:

{
"data": {},
"method": "drone_emergency_stop",
"seq": 1
}

Topic: thing/product/{gateway_sn}/drc/up

Direction: up

Method: drone_emergency_stop

Data:

ColumnNameTypeconstraintDescription
resultReturn CodeintNon-zero represents an error
outputOutputstructOutput of the command execution
»statusCurrent stageenum_string{"sent":"Command sent","ok":"Execution successful","failed":"Execution failed"}Command execution stage

Example:

{
"data": {
"output": {
"status": "ok"
},
"result": 0
},
"method": "drone_emergency_stop"
}

Emergency Landing​

After calling, the aircraft immediately aborts the current job and returns to home, then lands automatically after arriving at the dock. Use the drone_emergency_stop command to cancel. (seq is an incrementing sequence number to ensure commands are executed in order, at the same level as data)

Topic: thing/product/{gateway_sn}/drc/down

Direction: down

Method: drc_emergency_landing

Data: null

Example:

{
"data": {},
"method": "drc_emergency_landing",
"seq": 1
}

Topic: thing/product/{gateway_sn}/services_reply

Direction: up

Method: drc_emergency_landing

Data:

ColumnNameTypeconstraintDescription
resultReturn CodeintNon-zero represents an error
outputOutputstructOutput of the command execution
»statusCurrent stageenum_string{"sent":"Command sent","ok":"Execution successful","failed":"Execution failed"}Command execution stage

Example:

{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"data": {
"output": {
"status": "ok"
},
"result": 0
},
"method": "drc_emergency_landing",
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"timestamp": 1689748815503
}

Emergency Return to Dock​

After calling, the aircraft immediately aborts the current job and returns to home, then lands automatically after arriving at the dock. Use the drone_emergency_stop command to cancel. (seq is an incrementing sequence number to ensure commands are executed in order, at the same level as data)

Topic: thing/product/{gateway_sn}/drc/down

Direction: down

Method: drc_emergency_return_nest

Data: null

Example:

{
"data": {},
"method": "drc_emergency_return_nest",
"seq": 1
}

Topic: thing/product/{gateway_sn}/services_reply

Direction: up

Method: drc_emergency_return_nest

Data:

ColumnNameTypeconstraintDescription
resultReturn CodeintNon-zero represents an error
outputOutputstructOutput of the command execution
»statusCurrent stageenum_string{"sent":"Command sent","ok":"Execution successful","failed":"Execution failed"}Command execution stage

Example:

{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"data": {
"output": {
"status": "ok"
},
"result": 0
},
"method": "drc_emergency_return_nest",
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"timestamp": 1689748815503
}

Force Landing​

Not supported by the current firmware.

After calling, the aircraft will land directly to the ground regardless of whether there are obstacles. Use the drone_emergency_stop command to cancel. After landing, the aircraft can only be retrieved manually. Use with caution! (seq is an incrementing sequence number to ensure commands are executed in order, at the same level as data)

Topic: thing/product/{gateway_sn}/drc/down

Direction: down

Method: drc_force_landing

Data: null

Example:

{
"data": {},
"method": "drc_force_landing",
"seq": 1
}

Topic: thing/product/{gateway_sn}/drc/up

Direction: up

Method: drc_force_landing

Data:

ColumnNameTypeconstraintDescription
resultReturn CodeintNon-zero represents an error

Example:

{
"data": {
"result": 0
},
"method": "drc_force_landing",
"seq": 1
}

Emergency Propeller Stop​

After calling, the aircraft immediately stops all propellers. Executing this in flight will cause the aircraft to fall. Use with caution! (seq is an incrementing sequence number to ensure commands are executed in order, at the same level as data)

Topic: thing/product/{gateway_sn}/drc/down

Direction: down

Method: drone_emergency_disarm

Data: null

Example:

{
"data": {},
"method": "drone_emergency_disarm",
"seq": 1
}

Topic: thing/product/{gateway_sn}/services_reply

Direction: up

Method: drone_emergency_disarm

Data:

ColumnNameTypeconstraintDescription
resultReturn CodeintNon-zero represents an error
outputOutputstructOutput of the command execution
»statusCurrent stageenum_string{"sent":"Command sent","ok":"Execution successful","failed":"Execution failed"}Command execution stage

Example:

{
"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"data": {
"output": {
"status": "ok"
},
"result": 0
},
"method": "drone_emergency_disarm",
"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"timestamp": 1689748815503
}