General protocol description: en/SerialProtocol
The structs used below are defined in uart.h. For implementation details, see uart.c.
Addresses are defined as follows:
Here you find some of the structs and defines used for serial commands:
/BLDataStruct /DebugOutStruct /ExternalControl /NaviDataStruct /NaviDataStruct_V2 /ParamsetStruct /VersionStruct /WayPointStruct |
Address used for communication:
Common Commands
|
Received |
Sent |
|||||
Description |
ID |
Address |
Data |
ID |
Address |
Data |
remark |
Labels of the analog values in the Debug Data Struct (see 'd') |
'a' |
AnyAddr |
u8 Index of Analog Channel |
'A' |
SlaveAddr |
u8 Index, char[16] label text |
|
'b' |
AnyAddr |
ExternControl Struct |
'B' |
SlaveAddr |
unsigned char, echo of ExternalControl.Frame as confirmation |
Strcture changed since 2.13 |
|
Request display |
'h' |
AnyAddr |
u8 ~RemoteKey, u8 AutoSendInterval |
'H' |
SlaveAddr |
char[80] DisplayText |
|
Request display |
'l' |
AnyAddr |
u8 MenuItem |
'L' |
SlaveAddr |
u8 MenuItem, u8 MaxMenuItem, char[80] Display Text |
|
Version Request |
'v' |
AnyAddr |
none |
'V' |
SlaveAddr |
||
Debug Request |
'd' |
AnyAddr |
u8 AutoSendInterval |
'D' |
SlaveAddr |
||
Serial Poti |
'y' |
FC-Addr |
s8 Poti[12] |
- |
- |
- |
since 2.13 accepted by NC |
Get External Control |
'g' |
AnyAddr |
none |
'G' |
SlaveAddr |
ExternControl Struct |
since 2.13 accepted by NC |
Read PPM Channels |
'p' |
FC-Addr |
none |
'P' |
FC-Addr |
s16 PPM-Array[11] |
since 2.13 accepted by NC |
Reset |
'R' |
AnyAddr |
none |
- |
- |
- |
Flight-Ctrl
|
Received by FC |
Sent by FC |
|
||||
Description |
ID |
Address |
Data |
ID |
Address |
Data |
since FC Firmware |
Compass Heading |
'K' |
FC-Addr |
s16 Compass Value |
'k' |
MK3MAG-Addr |
Nick Roll Attitude ... |
0.71f |
Engine Test |
't' |
FC-Addr |
u8[16] values for the engines |
'T' |
FC-Addr |
- |
0.71f |
Settings Request |
'q' |
FC-Addr |
u8 Settings Index ( 1..5 READ or 0xff for actual setting) |
'Q' |
FC-Addr |
u8 Settings Index, u8 Settings Version, ParamsetStruct |
0.71f |
Write Settings |
's' |
FC-Addr |
u8 Settings Index, u8 Settings Version, ParamsetStruct |
'S' |
FC-Addr |
u8 Settings Index (1 ..5, 0=Error) |
0.71f |
Read PPM Channels |
'p' |
FC-Addr |
none |
'P' |
FC-Addr |
s16 PPM-Array[11] |
0.71f |
get External Control |
'g' |
FC-Addr |
none |
'G' |
FC-Addr |
ExternControl Struct |
0.71f |
Set 3D-Data Interval |
'c' |
AnyAddr |
u8 Interval |
'C' |
FC-Addr |
struct Data3D |
0.72p |
Mixer Request |
'n' |
FC-Addr |
none |
'N' |
FC-Addr |
u8 MixerRevision, u8 Name[12], u8 MixerTable[16][4] |
0.73 |
Mixer Write |
'm' |
FC-Addr |
u8 MixerRevision, u8 Name[12], u8 MixerTable[16][4] |
'M' |
FC-Addr |
u8 ack (1 = okay, 0 = error) |
0.73 |
Change setting |
'f' |
FC-Addr |
u8 Number of new Setting |
'F' |
FC-Addr |
u8 Number |
0.77 |
Serial Poti |
'y' |
FC-Addr |
s8 Poti[12] |
- |
- |
- |
0.77 |
BL parameter request |
'u' |
FC-Addr |
u8 BL_Addr |
'U' |
FC-Addr |
u8 Status1, u8 Status2, u8 BL_Addr, BLConfig Struct |
0.80 |
BL parameter write |
'w' |
FC-Addr |
u8 BL_Addr, BLConfig Struct |
'W' |
FC-Addr |
u8Status1, u8 Status2 |
0.80 |
Navi-Ctrl
|
Received by NC |
Sent by NC |
|
||||
Description |
ID |
Address |
Data |
ID |
Address |
Data |
since NC Firmware |
Serial Link Test |
'z' |
NC-Addr |
u16 EchoPattern |
'Z' |
NC-Addr |
u16 EchoPattern |
0.14f |
Error Text Request |
'e' |
NC-Addr |
none |
'E' |
NC-Addr |
char[] Error Message String |
0.12h |
Send target Position |
's' |
NC-Addr |
- |
- |
- |
0.12h |
|
Send Waypoint |
'w' |
NC-Addr |
WayPointStruct (sending an invalid position will clear the WPList) |
'W' |
NC-Addr |
u8 Number of WPs |
0.12h |
Request Waypoint |
'x' |
NC-Addr |
u8 WP-Index |
'X' |
NC-Addr |
u8 Number of WPs, u8 WP-Index, WayPointStruct |
0.14f |
Request OSD-Data (old) |
'o' |
NC-Addr |
1 byte sending interval ( in 10ms steps ) |
'O' |
NC-Addr |
0.12h |
|
Request OSD-Data (new) |
'o' |
NC-Addr |
1 byte sending interval ( in 10ms steps ) |
'O' |
NC-Addr |
2.10a |
|
Redirect UART |
'u' |
NC-Addr |
1 byte param for uart selector (0=FC, 1=MK3MAG, 2=MKGPS), can be switched back to NC debug by sending the magic packet "0x1B,0x1B,0x55,0xAA,0x00" |
- |
- |
- |
0.12h |
Set 3D-Data Interval |
'c' |
AnyAddr |
u8 Interval |
'C' |
NC-Addr |
struct Data3D |
0.14a |
Set/get NC-Parameter |
'j' |
NC-Addr |
u8 get(=0)/set(=1),u8 parameterId, s16 value (only when set) |
'J' |
NC_Addr |
u8 parameterId, s16 value |
0.20 |
BL Ctrl Status |
'k' |
AnyAddr |
u8 Interval |
'K' |
SlaveAddr |
||
't' |
NC-Addr |
u8 Interval |
'T' |
NC-Addr |
struct DateTime_t (from timer1.h) |
0.31 |
|
Store WP-List to SD |
'i' |
NC-Addr |
struct WPL_Store_t |
'I' |
NC-Addr |
struct WPL_Answer_t |
2.06 |
MK3-MAG
|
Received by MK3-MAG |
Sent by MK3-MAG |
|
||||
Description |
ID |
Address |
Data |
ID |
Address |
Data |
since MK3-MAG Firmware |
Heading Request |
'w' |
MK3MAG-Addr |
Attitude (s16 Nick, s16 Roll, u8 Param1, u8 Param2, u8 CalcState, u8 Orientation) |
'K' |
FC-Addr |
s16 Heading |
since beginning |