1123
Kommentar: adding f and some Version infos
|
13674
Send != Sent
|
Gelöschter Text ist auf diese Art markiert. | Hinzugefügter Text ist auf diese Art markiert. |
Zeile 1: | Zeile 1: |
|| ''' Command ''' || ''' Description ''' || ''' Parameter's ''' || '''since FC Firmware'' ''''' || || K || compass || compass value || || || a || labels of analog Values || position of requested analog Value ( 1 byte ) || || || b || ExternControl || struct ExternControl (uart.h) || 0.68b || || c || ExternControl + Debug request || struct ExternControl (uart.h) || 0.68b || || h || request Display line || Key Value ( 1 Byte ) || || || t || Engine Test || values for the 4 engines ( 4 Bytes ) || || || k || Dubwise Keys || keys ( 4 bytes) || 0.67e || || v || Version Request || none || || || g || Debug Request || none || || || q || Settings Request || settings-num 1 Byte - or 0xff for actual setting (1 Byte) || || || l || Write Setting 1 || mk_param_struct (fc.h) || || || m || Write Setting 2 || mk_param_struct (fc.h) || || || n || Write Setting 3 || mk_param_struct (fc.h) || || || o || Write Setting 4 || mk_param_struct (fc.h) || || || p || Write Setting 5 || mk_param_struct (fc.h) || || || f || Debug Request || none || v0.72 || || R || Reset ATMEGA || in SIGNAL(INT_VEC_RX) || || |
The structs used below are defined in [[http://mikrokopter.de/mikrosvn/FlightCtrl/tags/V0.82b/uart.h|uart.h]]. For implementation details, see [[http://mikrokopter.de/mikrosvn/FlightCtrl/tags/V0.82b/uart.c|uart.c]]. Unfortunately, the latest (trunk) version of these files is not public. == Common Commands == ||<tablewidth="" tablestyle="text-align: center;"bgcolor="#cccccc"> ||||||<bgcolor="#cccccc" style="text-align: center;">'''''Received '''''''' ''' ||||||<bgcolor="#cccccc" style="text-align: center;">'''''Sent '''''''' ''' || ||<bgcolor="#cccccc">'''''Description''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''ID''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''Address''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''Data''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''ID''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''Address''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''Data''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' || ||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 || ||!ExternControl ||'b' ||!AnyAddr ||!ExternControl Struct ||'B' ||!SlaveAddr || unsigned char, echo of !ExternControl.Frame as confirmation || ||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 ||Version Info Struct || ||Debug Request ||'d' ||!AnyAddr ||u8 !AutoSendInterval. Value is multiplied by 10 in receiver and then used as milliseconds. Subsciption needs to be renewed every 4s. ||'D' ||!SlaveAddr ||Debug Data Struct || ||Reset ||'R' ||!AnyAddr ||none ||- ||- ||- || ||Get External Control ||'g' ||!AnyAddr ||none ||'G' ||!SlaveAddr ||!ExternControl Strcut || == Flight-Ctrl == ||<tablewidth="" tablestyle="text-align: center;"bgcolor="#cccccc"> ||||||<bgcolor="#cccccc" style="text-align: center;">'''''Received by FC '''''''' ''' ||||||<bgcolor="#cccccc" style="text-align: center;">'''''Sent by FC '''''''' ''' ||<bgcolor="#cccccc"> || ||<bgcolor="#cccccc">'''''Description''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''ID''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''Address''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''Data''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''ID''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''Address''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''Data''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''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) <<BR>> u8 Settings Index (11..15 RESET setting to default (channel mapping will not be changed))<<BR>> u8 Settings Index (21..25 RESET setting to default (complete reset including channel settings))||'Q' ||FC-Addr ||u8 Settings Index, u8 Settings Version, Settings Struct ||0.71f || || Write Settings || 's' ||FC-Addr || u8 Settings Index, u8 Settings Version, Settings Struct ||'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 || || 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 == ||<tablewidth="" tablestyle="text-align: center;"bgcolor="#cccccc"> ||||||<bgcolor="#cccccc" style="text-align: center;">'''''Received by NC '''''''' ''' ||||||<bgcolor="#cccccc" style="text-align: center;">'''''Sent by NC '''''''' ''' ||<bgcolor="#cccccc"> || ||<bgcolor="#cccccc">'''''Description''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''ID''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''Address''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''Data''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''ID''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''Address''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''Data''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''since NC Firmware''''' || ||<style="text-align: center;"> Serial Link Test ||<style="text-align: center;">'z' ||<style="text-align: center;">NC-Addr ||<style="text-align: center;">u16 !EchoPattern ||<style="text-align: center;">'Z' ||<style="text-align: center;">NC-Addr ||<style="text-align: center;">u16 !EchoPattern ||<style="text-align: center;"> 0.14f || ||<style="text-align: center;"> Error Text Request ||<style="text-align: center;">'e' ||<style="text-align: center;">NC-Addr ||<style="text-align: center;">none ||<style="text-align: center;">'E' ||<style="text-align: center;">NC-Addr ||<style="text-align: center;">char[] Error Message String ||<style="text-align: center;"> 0.12h || ||<style="text-align: center;"> Send target Position ||<style="text-align: center;">'s' ||<style="text-align: center;">NC-Addr ||<style="text-align: center;"> [[en/WayPointStruct|WayPointStruct]] ||<style="text-align: center;">- ||<style="text-align: center;">- ||<style="text-align: center;">- ||<style="text-align: center;"> 0.12h || ||<style="text-align: center;"> Send Waypoint ||<style="text-align: center;">'w' ||<style="text-align: center;">NC-Addr ||<style="text-align: center;">[[en/WayPointStruct|WayPointStruct]] (sending an invalid position will clear the WPList) ||<style="text-align: center;">'W' ||<style="text-align: center;">NC-Addr ||<style="text-align: center;">u8 Number of WPs ||<style="text-align: center;"> 0.12h || ||<style="text-align: center;"> Request Waypoint ||<style="text-align: center;">'x' ||<style="text-align: center;">NC-Addr ||<style="text-align: center;">u8 WP-Index ||<style="text-align: center;">'X' ||<style="text-align: center;">NC-Addr ||<style="text-align: center;">u8 Number of WPs, u8 WP-Index, [[en/WayPointStruct|WayPointStruct]] ||<style="text-align: center;"> 0.14f || ||<style="text-align: center;"> Request OSD-Data ||<style="text-align: center;">'o' ||<style="text-align: center;">NC-Addr ||<style="text-align: center;"> 1 byte sending interval ( in 10ms steps ) ||<style="text-align: center;">'O' ||<style="text-align: center;">NC-Addr ||<style="text-align: center;">[[en/NaviDataStruct|NaviDataStruct]] ||<style="text-align: center;"> 0.12h || ||<style="text-align: center;">Redirect UART ||<style="text-align: center;">'u' ||<style="text-align: center;">NC-Addr ||<style="text-align: center;">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" ||<style="text-align: center;">- ||<style="text-align: center;">- ||<style="text-align: center;">- ||<style="text-align: center;">0.12h || || Set 3D-Data Interval || 'c' || !AnyAddr || u8 Interval || 'C' || NC-Addr || struct Data3D|| 0.14a || || Set/get NC-Parameter || 'j' || !NC-Addr || ? ||- ||- ||- || 0.20 || == MK3-MAG == ||<tablewidth="" tablestyle="text-align: center;"bgcolor="#cccccc"> ||||||<bgcolor="#cccccc" style="text-align: center;">'''''Received by MK3-MAG '''''''' ''' ||||||<bgcolor="#cccccc" style="text-align: center;">'''''Sent by MK3-MAG '''''''' ''' ||<bgcolor="#cccccc"> || ||<bgcolor="#cccccc">'''''Description''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''ID''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''Address''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''Data''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''ID''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''Address''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''Data''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ||<bgcolor="#cccccc">'''''since MK3-MAG Firmware''''' || ||<style="text-align: center;"> Heading Request ||<style="text-align: center;">'w' ||<style="text-align: center;">MK3MAG-Addr ||<style="text-align: center;">Attitude (s16 Nick, s16 Roll, u8 Param1, u8 Param2, u8 !CalcState, u8 Orientation) ||<style="text-align: center;">'K' ||<style="text-align: center;">FC-Addr ||<style="text-align: center;">s16 Heading ||<style="text-align: center;"> since beginning || ---- . CategoryCoding KategorieFirmware KategorieFirmware |
The structs used below are defined in uart.h. For implementation details, see uart.c. Unfortunately, the latest (trunk) version of these files is not public.
Common Commands
|
Received |
Sent |
||||
Description |
ID |
Address |
Data |
ID |
Address |
Data |
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 |
ExternControl |
'b' |
AnyAddr |
ExternControl Struct |
'B' |
SlaveAddr |
unsigned char, echo of ExternControl.Frame as confirmation |
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 |
Version Info Struct |
Debug Request |
'd' |
AnyAddr |
u8 AutoSendInterval. Value is multiplied by 10 in receiver and then used as milliseconds. Subsciption needs to be renewed every 4s. |
'D' |
SlaveAddr |
Debug Data Struct |
Reset |
'R' |
AnyAddr |
none |
- |
- |
- |
Get External Control |
'g' |
AnyAddr |
none |
'G' |
SlaveAddr |
ExternControl Strcut |
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, Settings Struct |
0.71f |
Write Settings |
's' |
FC-Addr |
u8 Settings Index, u8 Settings Version, Settings Struct |
'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 |
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 |
'o' |
NC-Addr |
1 byte sending interval ( in 10ms steps ) |
'O' |
NC-Addr |
0.12h |
|
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 |
? |
- |
- |
- |
0.20 |
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 |