ARSDK command reference
Every ARSDK command the Bebop 2 4.7.1 flight program (dragon-prog) handles or emits, built by reading the firmware and comparing it with the project’s vendored protocol XML. The tables for each project are on their own pages: Ardrone3, Common and Animation, Follow_me and others. The states these commands lead to are on the flight state machine page.
Static analysis only. Nothing was connected to: no drone, controller, network host or mcbebop tool. Sources: usr/bin/dragon-prog and usr/lib/libarsdk.so from the extracted 4.7.1 root filesystem, the vendored XML in the vendored XML folder (ardrone3.xml, common.xml), the disassembly dp.dis (virtual address = file offset + 0x10000 in text). Machine-readable twin: commands.json and commands.csv, produced by cmd_decode.py, and this file by gen_ref.py.
Tags: V Verified (read the symbol, descriptor, XML, listing, or ran the script), A Agent-cited (taken from an earlier report in this folder), I Inference, O Open.
1. Summary and counts
Section titled “1. Summary and counts”libarsdk.soexports 717g_arsdk_cmd_desc_*symbols: 716 command descriptors plusg_arsdk_cmd_desc_table, a pointer array. They span 23 projects (V,cmd_decode.py).- The vendored XML has 264 commands. 256 of them match a firmware descriptor by project, class and command id and by name. The other 8 (Ardrone3 and Common, mostly ANAFI-era) have no descriptor and no string in
libarsdk.so,libarcommands.soordragon-prog(V). So documented 256, undocumented 460 among descriptors. dragon-proghandles 248 commands: 110 receive (a registered decoder callback, REG) and 138 send (a generator call site, GEN). None is both (V).- Of the 248 handled commands, 193 are in the vendored XML and 55 are not (Animation 21, Follow_me 24, Thermal_cam 5, Controller_info 2, Sequoia_cam 1, Ardrone3 FlatTrim and its state event 2) (V).
- Handled per project: Ardrone3 137, Common 58, Animation 21, Follow_me 24, Controller_info 2, Sequoia_cam 1, Thermal_cam 5. The other 16 projects in the library have zero handled commands (V).
- 7 commands the XML lists as supported on 090c (the Bebop 2) have no decoder and no generator call site in
dragon-prog(section 4). 8 XML commands lack a descriptor entirely. - 28 handled commands are marked deprecated or unsupported (none, or other products only) by the XML (section 5).
- The earlier report counted 106 registered decoders; the scan with
blandb(tail call) finds all 110 importedARCOMMANDS_Decoder_Set*Cbsymbols registered, and 138 of 139ARCOMMANDS_Generator_Generate*imports with a call site (the missing one is section 4).
2. How to read the tables
Section titled “2. How to read the tables”- Command is the descriptor name as the firmware spells it (
Project.Class.Command; feature projects such as Animation have no class level). Id isproject.class.commandas decimal numbers read from the descriptor (V). - Dir:
receivemeans the aircraft decodes it from a controller (a callback is registered throughARCOMMANDS_Decoder_Set<Name>Cb).sendmeans the aircraft generates it as a state or event (a call toARCOMMANDS_Generator_Generate<Name>). Direction comes from which of the two APIsdragon-proguses, not from the class name (V). - Arguments:
name:type; enumerations as{NAME=value}. Types: i8 u8 i16 u16 i32 u32 i64 u64 float double string enum.u8 bits{...}and similar are bitfields: the descriptor gives an integer type plus a name table, and the table values read as bit positions (I). For commands in the vendored XML the names, types and enum values are the XML ones (documented commands); for the others they are decoded from the descriptor. All 256 XML commands that have a descriptor were compared: argument count, names, types are identical in all 256, enum names and values identical in 254; the 2 that differ are noted in the Notes column (V). - What it does: for documented commands, the XML
titleanddesctext, shortened (V: XML). Where the XML text mentions a limit or requirement, that is the XML talking, not something traced in the firmware. For undocumented commands, the text is read from the command and argument names and tagged (I) unless another tag says otherwise. - Status in dragon-prog:
REG <addr>is the address of thebl/bthat registers the decoder (V),cb <addr>the callback address computed from the literal pool (V).GEN <addr>is the first generator call site,(+n more)further sites (all incommands.json) (V).msg <id> <NAME>is the behaviour message id the callback posts through the poster at 0x6a374, taken fromcbmsg.json(A: a scripted scan of each callback body formov r1,#idbefore a call to 0x6a374; spot-checked in this session on TakeOff 7, Land 12, FlatTrim 6 and Flip 152). Several ids in one cell means the callback body contains several posts.no msg id foundmeans the callback does not use that poster, so the path was not traced (O). - Notes: XML flags (
deprecated,support), differences from the XML, acceptance gates already documented (only the flip has one), and callback oddities. “XML support” is thesupportattribute;090cis the Bebop 2 product code; a:x.y.zsuffix is a minimum firmware version. - Buffer types are in
commands.json(fieldbuffer): code 1 NON_ACK, 2 ACK, 3 HIGH_PRIO, validated against the XMLbufferattribute (V: 14 NON_ACK, 241 default ACK, 1 HIGH_PRIO all agree). - Scope: this is what
dragon-proghandles through theARCOMMANDS_Decoder_Set*CbandARCOMMANDS_Generator_Generate*API.dragon-progalso callsarsdk_cmd_fmtat 0x5188c and 0x519ac inside the network message thread, with a 512 byte buffer and, at the second site, a timestamp, which looks like command logging (I). It is the only binary in the rootfs that linkslibarsdk.soorlibarcommands.so(V:/usr/bin/grep -rloverusr bin sbin lib etc, plus the NEEDED list). Other processes and the network layer were not examined.
3. Projects with handled commands
Section titled “3. Projects with handled commands”Seven projects have at least one handled command. They are given in this order: Ardrone3, Common, Animation, Follow_me, Controller_info, Sequoia_cam, Thermal_cam. The remaining 16 projects (Battery, Camera, Debug, Drone_manager, Generic, Gimbal, Jpsumo, Mapper, Mapper_mini, Minidrone, Powerup, Rc, Rth, Skyctrl, User_storage, Wifi) have descriptors and no call site in dragon-prog (V, scan listed in commands.json, controls in section 7).
- Ardrone3: 137 handled commands
- Common: 58 handled commands
- Animation, Follow_me, Controller_info, Sequoia_cam and Thermal_cam: 53 handled commands, most of them not in the vendored XML
4. Supported on 090c per the XML, not handled by dragon-prog
Section titled “4. Supported on 090c per the XML, not handled by dragon-prog”Method: the command has a descriptor (or not) in libarsdk.so, and no ARCOMMANDS_Decoder_Set*Cb registration and no ARCOMMANDS_Generator_Generate* call site exists in dragon-prog under the same normalised name. Positive control: the identical join finds the registration or call site for the other 193 XML commands that are handled (V). The negative result only covers the ARCOMMANDS API; a renamed internal path would not show up (O).
| Command | Id | XML support | Deprecated | XML title | Re-check (V unless tagged) |
|---|---|---|---|---|---|
| Common.MavlinkState.MavlinkPlayErrorStateChanged | 0.12.1 | 0901:2.0.29;090c;090e | yes | FlightPlan error | Descriptor present, no call site; XML says deprecated, consistent. |
| Common.FlightPlanState.LockStateChanged | 0.17.2 | 0901:2.0.29;090c;090e | no | FlightPlan lock state | Descriptor present, no call site. |
| Common.FlightPlanSettings.ReturnHomeOnDisconnect | 0.32.0 | 0901:4.1.0;090c:4.1.0;090e:1.4.0 | no | Set ReturnHome behavior during FlightPlan | Descriptor present, no registration. Whether another path sets this behaviour is Open. |
| Common.FlightPlanSettingsState.ReturnHomeOnDisconnectChanged | 0.33.0 | 0901:4.1.0;090c:4.1.0;090e:1.4.0 | no | ReturnHome behavior during FlightPlan | Descriptor present, no call site. |
| Ardrone3.PilotingState.ReturnHomeBatteryCapacity | 1.4.15 | 090c:4.3.0 | no | Return home battery capacity | Descriptor present, no registration, no call site. The earlier explanation (superseded by another event) is an inference (I). |
| Ardrone3.GPSSettingsState.HomeChanged | 1.24.0 | 0901;090c;090e | no | Home location | Newly listed here. dragon-prog imports the generator (a JUMP_SLOT at 0x57b434) but no PLT stub points at that slot (the last stub uses 0x57b430) and there is no call; the control HomeTypeChanged has a stub (0x345b0) and a call at 0x5dbbc. The earlier report called this a likely false positive; the evidence says imported and never called. |
| Ardrone3.GPSSettingsState.ResetHomeChanged | 1.24.1 | 0901;090c | yes | Home location has been reset | Descriptor present, no call site; XML says deprecated, consistent. |
7 commands. The earlier report found six; the seventh is HomeChanged above (V).
4.1 XML commands with no descriptor in this firmware
Section titled “4.1 XML commands with no descriptor in this firmware”These 8 XML commands are not in libarsdk.so, and their names are absent as strings from libarsdk.so, libarcommands.so and dragon-prog (V; the same string search finds FlyingStateChanged as the positive control). So this firmware cannot encode or decode them.
| Command | Id | XML support | XML title |
|---|---|---|---|
| Common.SettingsState.BoardIdChanged | 0.3.8 | drones | Board id |
| Common.Controller.PeerStateChanged | 0.8.1 | 0918 | A SDK peer has connected/disconnected |
| Ardrone3.Piloting.StartPilotedPOIV2 | 1.0.15 | 0914:1.6.3;0919:1.6.3 | Start a piloted POI |
| Ardrone3.PilotingState.ForcedLandingAutoTrigger | 1.4.18 | Landing auto trigger. | |
| Ardrone3.PilotingState.WindStateChanged | 1.4.19 | 0914 | Wind state |
| Ardrone3.PilotingState.VibrationLevelChanged | 1.4.20 | 0914:1.6.0;0919:1.6.0 | Vibration level |
| Ardrone3.PilotingState.AltitudeAboveGroundChanged | 1.4.21 | 0914:1.6.2;0919:1.6.2 | Drone’s altitude above ground changed |
| Ardrone3.PilotingState.PilotedPOIV2 | 1.4.22 | 0914:1.6.3;0919:1.6.3 | Piloted POI state |
Only BoardIdChanged (“drones”, generic) and ForcedLandingAutoTrigger (empty support) could apply to a Bebop 2 by their XML text; the others list other product codes (V from the table, applicability I).
4.2 Not handled, XML silent or generic about 090c
Section titled “4.2 Not handled, XML silent or generic about 090c”22 commands have a descriptor, no handler, and an XML support that is absent, empty or “drones”, so the XML does not say they apply to the Bebop 2. Worth reading by name: Ardrone3.Piloting.CancelMoveBy (MoveBy is handled, its cancel is not), Ardrone3.PilotingState.MoveByChanged, Ardrone3.GPSSettingsState.GeofenceCenterChanged, Common.Factory.Reset, Common.OverHeatState.OverHeatRegulationChanged. The full list is in commands.json (filter handled false, xml_support_090c unspecified, empty or drones).
| Command | Id | XML support | Deprecated |
|---|---|---|---|
| Common.CommonState.MassStorageInfoRemainingListChanged | 0.5.6 | (none) | yes |
| Common.CommonState.CountryListKnown | 0.5.10 | (none) | yes |
| Common.OverHeatState.OverHeatRegulationChanged | 0.7.1 | (none) | no |
| Common.CalibrationState.PitotCalibrationStateChanged | 0.14.4 | (none) | no |
| Common.ARLibsVersionsState.ControllerLibARCommandsVersion | 0.18.0 | (none) | no |
| Common.ARLibsVersionsState.SkyControllerLibARCommandsVersion | 0.18.1 | (none) | no |
| Common.ChargerState.MaxChargeRateChanged | 0.29.0 | (none) | yes |
| Common.ChargerState.CurrentChargeStateChanged | 0.29.1 | (none) | yes |
| Common.ChargerState.LastChargeRateChanged | 0.29.2 | (none) | yes |
| Common.Factory.Reset | 0.31.0 | (none) | no |
| Ardrone3.Piloting.AutoTakeOffMode | 1.0.6 | (none) | yes |
| Ardrone3.Piloting.CancelMoveBy | 1.0.14 | (none) | no |
| Ardrone3.PilotingSettings.AbsolutControl | 1.2.2 | (none) | yes |
| Ardrone3.PilotingState.AutoTakeOffModeChanged | 1.4.7 | (none) | yes |
| Ardrone3.PilotingState.MoveByChanged | 1.4.16 | (none) | no |
| Ardrone3.PilotingSettingsState.AbsolutControlChanged | 1.6.2 | (none) | yes |
| Ardrone3.MediaRecord.Picture | 1.7.0 | (none) | yes |
| Ardrone3.MediaRecord.Video | 1.7.1 | (none) | yes |
| Ardrone3.MediaRecordState.PictureStateChanged | 1.8.0 | (none) | yes |
| Ardrone3.MediaRecordState.VideoStateChanged | 1.8.1 | (none) | yes |
| Ardrone3.SettingsState.ProductMotorVersionListChanged | 1.16.0 | (none) | yes |
| Ardrone3.GPSSettingsState.GeofenceCenterChanged | 1.24.6 | (none) | no |
5. Handled although the XML says unsupported or deprecated
Section titled “5. Handled although the XML says unsupported or deprecated”A command is listed when it is handled (REG or GEN) and the XML marks it deprecated, support="none", or lists support only for other products. This is the inverse of section 4. “Status” repeats the REG or GEN data.
| Command | Id | Dir | XML support | Deprecated | Status |
|---|---|---|---|---|---|
| Ardrone3.Piloting.StartPilotedPOI | 1.0.12 | receive | 090c:4.3.0 | yes | REG 0x60b2c cb 0x58200; msg 22 START_POI (A) |
| Ardrone3.Camera.Orientation | 1.1.0 | receive | 0901;090c;090e | yes | REG 0x60b54 cb 0x580e8; msg 33 CAMERA_ORIENTATION (A) |
| Ardrone3.PilotingState.PilotedPOI | 1.4.14 | send | 090c:4.3.0 | yes | GEN 0x593b8 |
| Ardrone3.NetworkSettingsState.WifiSecurityChanged | 1.10.1 | send | (none) | yes | GEN 0x5e8e0 |
| Ardrone3.SpeedSettings.Outdoor | 1.11.3 | receive | (none) | yes | REG 0x60d18 cb 0x5c528; no msg id found (O) |
| Ardrone3.SpeedSettingsState.OutdoorChanged | 1.12.3 | send | (none) | yes | GEN 0x5c440 |
| Ardrone3.SettingsState.MotorSoftwareVersionChanged | 1.16.3 | send | (none) | yes | GEN 0x5eef8 |
| Ardrone3.SettingsState.P7ID | 1.16.6 | send | (none) | yes | GEN 0x5cec0 |
| Ardrone3.GPSSettings.SetHome | 1.23.0 | receive | (none) | yes | REG 0x60e1c cb 0x575dc; msg 107 SET_GPS_HOME (A) |
| Ardrone3.GPSSettings.ResetHome | 1.23.1 | receive | 0901;090c | yes | REG 0x60e30 cb 0x57564; msg 109 RESET_GPS_HOME (A) |
| Ardrone3.GPSSettingsState.GPSUpdateStateChanged | 1.24.3 | send | 0901;090c;090e | yes | GEN 0x5d660 |
| Ardrone3.CameraState.Orientation | 1.25.0 | send | 0901;090c;090e | yes | GEN 0x5a64c |
| Ardrone3.CameraState.DefaultCameraOrientation | 1.25.1 | send | 0901;090c;090e | yes | GEN 0x5a310 |
| Ardrone3.PROState.Features | 1.32.0 | send | (none) | yes | GEN 0x5cfe0 |
| Ardrone3.AccessoryState.ConnectedAccessories | 1.33.0 | send | 090e:1.5.0 | no | GEN 0x6447c |
| Ardrone3.Sound.StartAlertSound | 1.35.0 | receive | none | no | REG 0x61060 cb 0x56bdc; msg 154 START_ALERT_SOUND (A) |
| Ardrone3.Sound.StopAlertSound | 1.35.1 | receive | none | no | REG 0x61078 cb 0x56b64; msg 155 STOP_ALERT_SOUND (A) |
| Ardrone3.SoundState.AlertSound | 1.36.0 | send | none | no | GEN 0x59120 |
| Common.Network.Disconnect | 0.0.0 | receive | none | yes | REG 0x621d8 cb 0x62100; msg 3 DISCONNECTED (A) |
| Common.CommonState.DeprecatedMassStorageContentChanged | 0.5.11 | send | (none) | yes | GEN 0x6404c |
| Common.OverHeat.SwitchOff | 0.6.0 | receive | none | yes | REG 0x60ee4 cb 0x57274; msg 123 TEMPERATURE_SHUTDOWN (A) |
| Common.OverHeatState.OverHeatChanged | 0.7.0 | send | (none) | yes | GEN 0x5ebc0 |
| Common.GPS.ControllerPositionForRun | 0.16.0 | receive | 0902;0905;0906 | no | REG 0x622c8 cb 0x6178c; msg 111 GPS_CONTROLLER_LATITUDE, 112 GPS_CONTROLLER_LONGITUDE (A) |
| Common.Audio.ControllerReadyForStreaming | 0.20.0 | receive | 0905;0906 | no | REG 0x62334 cb 0x61570; msg 141 SET_CONTROLLER_READY_FOR_STREAMING (A) |
| Common.Headlights.Intensity | 0.22.0 | receive | 0905;0906;0907 | no | REG 0x622dc cb 0x616fc; msg 136 SET_HEADLIGHTS (A) |
| Common.Animations.StartAnimation | 0.24.0 | receive | 0902;0905;0906;0907;0909 | no | REG 0x622f0 cb 0x61678; msg 133 START_ANIM (A) |
| Common.Animations.StopAnimation | 0.24.1 | receive | 0902;0905;0906;0907;0909 | no | REG 0x62304 cb 0x615f4; msg 134 STOP_ANIM (A) |
| Common.Animations.StopAllAnimations | 0.24.2 | receive | 0902;0905;0906;0907;0909 | no | REG 0x62320 cb 0x615f4; msg 134 STOP_ANIM (A) |
28 commands (V). The older report listed 27 and described the Common legacy animation, headlights and audio commands in prose; here they are counted by rule from the XML flags.
Also handled where the XML gives no support attribute and no deprecated flag (6 commands, for example Ardrone3.GPSSettings.ReturnHomeMinAltitude, whose support attribute is empty): see the Notes column in section 3 (V).
6. Safety index: commands that move the aircraft or change a limit
Section titled “6. Safety index: commands that move the aircraft or change a limit”This is a quick index. For documented commands the Basis column is the XML title; for the others it is read from the name (I). It is not traced behaviour, except the flip gates which are Agent-cited from bebop2-flip-acceptance.md. Each Link goes to the table that documents the command. Nothing here says a command is safe or unsafe to send.
| Group | Command | Dir | Link | Basis |
|---|---|---|---|---|
| Takeoff, landing, motor cut and direct piloting | Ardrone3.Piloting.TakeOff |
receive | Ardrone3.Piloting (class 0) | XML title: “Take off” (V) |
| Takeoff, landing, motor cut and direct piloting | Ardrone3.Piloting.UserTakeOff |
receive | Ardrone3.Piloting (class 0) | XML title: “Prepare the drone to take off” (V) |
| Takeoff, landing, motor cut and direct piloting | Ardrone3.Piloting.Landing |
receive | Ardrone3.Piloting (class 0) | XML title: “Land” (V) |
| Takeoff, landing, motor cut and direct piloting | Ardrone3.Piloting.Emergency |
receive | Ardrone3.Piloting (class 0) | XML title: “Cut out the motors” (V) |
| Takeoff, landing, motor cut and direct piloting | Ardrone3.Piloting.PCMD |
receive | Ardrone3.Piloting (class 0) | XML title: “Move the drone” (V) |
| Takeoff, landing, motor cut and direct piloting | Common.OverHeat.SwitchOff |
receive | Common.OverHeat (class 6) | XML title: “Switch off after an overheat”, deprecated (V) |
| Takeoff, landing, motor cut and direct piloting | Common.Common.Reboot |
receive | Common.Common (class 4) | XML title: “Reboot” (V) |
| Autonomous or scripted motion | Ardrone3.Animations.Flip |
receive | Ardrone3.Animations (class 5) | XML title: “Make a flip” (V) |
| Autonomous or scripted motion | Animation.Start_flip |
receive | Animation (feature project 144) | second flip decoder, same gates (A) |
| Autonomous or scripted motion | Animation.Start_horizontal_panorama |
receive | Animation (feature project 144) | animation start (I) |
| Autonomous or scripted motion | Animation.Start_dronie |
receive | Animation (feature project 144) | animation start (I) |
| Autonomous or scripted motion | Animation.Start_horizontal_reveal |
receive | Animation (feature project 144) | animation start (I) |
| Autonomous or scripted motion | Animation.Start_vertical_reveal |
receive | Animation (feature project 144) | animation start (I) |
| Autonomous or scripted motion | Animation.Start_spiral |
receive | Animation (feature project 144) | animation start (I) |
| Autonomous or scripted motion | Animation.Start_parabola |
receive | Animation (feature project 144) | animation start (I) |
| Autonomous or scripted motion | Animation.Start_candle |
receive | Animation (feature project 144) | animation start (I) |
| Autonomous or scripted motion | Animation.Start_dolly_slide |
receive | Animation (feature project 144) | animation start (I) |
| Autonomous or scripted motion | Animation.Cancel |
receive | Animation (feature project 144) | cancels the running animation (I) |
| Autonomous or scripted motion | Common.Animations.StartAnimation |
receive | Common.Animations (class 24) | XML title: “Start an animation” (V) |
| Autonomous or scripted motion | Follow_me.Start |
receive | Follow_me (feature project 134) | starts follow-me tracking (I) |
| Autonomous or scripted motion | Follow_me.Start_helicoid_anim |
receive | Follow_me (feature project 134) | follow-me animation (I) |
| Autonomous or scripted motion | Follow_me.Start_swing_anim |
receive | Follow_me (feature project 134) | follow-me animation (I) |
| Autonomous or scripted motion | Follow_me.Start_boomerang_anim |
receive | Follow_me (feature project 134) | follow-me animation (I) |
| Autonomous or scripted motion | Follow_me.Start_candle_anim |
receive | Follow_me (feature project 134) | follow-me animation (I) |
| Autonomous or scripted motion | Follow_me.Start_dolly_slide_anim |
receive | Follow_me (feature project 134) | follow-me animation (I) |
| Autonomous or scripted motion | Follow_me.Configure_geographic |
receive | Follow_me (feature project 134) | sets follow distance, elevation, azimuth (I) |
| Autonomous or scripted motion | Follow_me.Configure_relative |
receive | Follow_me (feature project 134) | sets follow distance, elevation, azimuth (I) |
| Autonomous or scripted motion | Follow_me.Target_framing_position |
receive | Follow_me (feature project 134) | moves the subject in frame (I) |
| Autonomous or scripted motion | Follow_me.Target_image_detection |
receive | Follow_me (feature project 134) | feeds a detected target to the tracker (I) |
| Autonomous or scripted motion | Ardrone3.Piloting.MoveBy |
receive | Ardrone3.Piloting (class 0) | XML title: “Move the drone to a relative position” (V) |
| Autonomous or scripted motion | Ardrone3.Piloting.MoveTo |
receive | Ardrone3.Piloting (class 0) | XML title: “Move to a location” (V) |
| Autonomous or scripted motion | Ardrone3.Piloting.CancelMoveTo |
receive | Ardrone3.Piloting (class 0) | XML title: “Cancel the moveTo” (V) |
| Autonomous or scripted motion | Ardrone3.Piloting.NavigateHome |
receive | Ardrone3.Piloting (class 0) | XML title: “Return home” (V) |
| Autonomous or scripted motion | Ardrone3.Piloting.StartPilotedPOI |
receive | Ardrone3.Piloting (class 0) | XML title: “Start a piloted POI”, deprecated (V) |
| Autonomous or scripted motion | Ardrone3.Piloting.StopPilotedPOI |
receive | Ardrone3.Piloting (class 0) | XML title: “Stop the piloted POI” (V) |
| Autonomous or scripted motion | Common.Mavlink.Start |
receive | Common.Mavlink (class 11) | XML title: “Start a FlightPlan” (V) |
| Autonomous or scripted motion | Common.Mavlink.Pause |
receive | Common.Mavlink (class 11) | XML title: “Pause a FlightPlan” (V) |
| Autonomous or scripted motion | Common.Mavlink.Stop |
receive | Common.Mavlink (class 11) | XML title: “Stop a FlightPlan” (V) |
| Return-home, home position, geofence | Ardrone3.GPSSettings.SetHome |
receive | Ardrone3.GPSSettings (class 23) | XML title: “Set home position”, deprecated (V) |
| Return-home, home position, geofence | Ardrone3.GPSSettings.ResetHome |
receive | Ardrone3.GPSSettings (class 23) | XML title: “Reset home position”, deprecated (V) |
| Return-home, home position, geofence | Ardrone3.GPSSettings.SendControllerGPS |
receive | Ardrone3.GPSSettings (class 23) | XML title: “Set controller gps location” (V) |
| Return-home, home position, geofence | Ardrone3.GPSSettings.HomeType |
receive | Ardrone3.GPSSettings (class 23) | XML title: “Set the preferred home type” (V) |
| Return-home, home position, geofence | Ardrone3.GPSSettings.ReturnHomeDelay |
receive | Ardrone3.GPSSettings (class 23) | XML title: “Set the return home delay” (V) |
| Return-home, home position, geofence | Ardrone3.GPSSettings.ReturnHomeMinAltitude |
receive | Ardrone3.GPSSettings (class 23) | XML title: “Set the return home min altitude” (V) |
| Return-home, home position, geofence | Ardrone3.PilotingSettings.NoFlyOverMaxDistance |
receive | Ardrone3.PilotingSettings (class 2) | XML title: “Enable geofence” (V) |
| Return-home, home position, geofence | Ardrone3.PilotingSettings.MaxDistance |
receive | Ardrone3.PilotingSettings (class 2) | XML title: “Set max distance” (V) |
| Return-home, home position, geofence | Controller_info.Gps |
receive | Controller_info (feature project 140) | controller GPS fix sent to the aircraft (I for its use) |
| Return-home, home position, geofence | Controller_info.Barometer |
receive | Controller_info (feature project 140) | controller barometer reading sent to the aircraft (I for its use) |
| Return-home, home position, geofence | Common.GPS.ControllerPositionForRun |
receive | Common.GPS (class 16) | XML title: “Set the position of a run” (V) |
| Speed, altitude, tilt and rotation limits | Ardrone3.PilotingSettings.MaxAltitude |
receive | Ardrone3.PilotingSettings (class 2) | XML title: “Set max altitude” (V) |
| Speed, altitude, tilt and rotation limits | Ardrone3.PilotingSettings.MaxTilt |
receive | Ardrone3.PilotingSettings (class 2) | XML title: “Set max pitch/roll” (V) |
| Speed, altitude, tilt and rotation limits | Ardrone3.PilotingSettings.SetAutonomousFlightMaxHorizontalSpeed |
receive | Ardrone3.PilotingSettings (class 2) | XML title: “Set autonomous flight max horizontal speed” (V) |
| Speed, altitude, tilt and rotation limits | Ardrone3.PilotingSettings.SetAutonomousFlightMaxVerticalSpeed |
receive | Ardrone3.PilotingSettings (class 2) | XML title: “Set autonomous flight max vertical speed” (V) |
| Speed, altitude, tilt and rotation limits | Ardrone3.PilotingSettings.SetAutonomousFlightMaxHorizontalAcceleration |
receive | Ardrone3.PilotingSettings (class 2) | XML title: “Set autonomous flight max horizontal acceleration” (V) |
| Speed, altitude, tilt and rotation limits | Ardrone3.PilotingSettings.SetAutonomousFlightMaxVerticalAcceleration |
receive | Ardrone3.PilotingSettings (class 2) | XML title: “Set autonomous flight max vertical acceleration” (V) |
| Speed, altitude, tilt and rotation limits | Ardrone3.PilotingSettings.SetAutonomousFlightMaxRotationSpeed |
receive | Ardrone3.PilotingSettings (class 2) | XML title: “Set autonomous flight max rotation speed” (V) |
| Speed, altitude, tilt and rotation limits | Ardrone3.PilotingSettings.BankedTurn |
receive | Ardrone3.PilotingSettings (class 2) | XML title: “Set banked turn mode” (V) |
| Speed, altitude, tilt and rotation limits | Ardrone3.SpeedSettings.MaxVerticalSpeed |
receive | Ardrone3.SpeedSettings (class 11) | XML title: “Set max vertical speed” (V) |
| Speed, altitude, tilt and rotation limits | Ardrone3.SpeedSettings.MaxRotationSpeed |
receive | Ardrone3.SpeedSettings (class 11) | XML title: “Set max rotation speed” (V) |
| Speed, altitude, tilt and rotation limits | Ardrone3.SpeedSettings.MaxPitchRollRotationSpeed |
receive | Ardrone3.SpeedSettings (class 11) | XML title: “Set max pitch/roll rotation speed” (V) |
| Speed, altitude, tilt and rotation limits | Ardrone3.SpeedSettings.HullProtection |
receive | Ardrone3.SpeedSettings (class 11) | XML title: “Set the presence of hull protection” (V) |
| Speed, altitude, tilt and rotation limits | Ardrone3.SpeedSettings.Outdoor |
receive | Ardrone3.SpeedSettings (class 11) | XML title: “Set outdoor mode”, deprecated (V) |
| Speed, altitude, tilt and rotation limits | Common.WifiSettings.OutdoorSetting |
receive | Common.WifiSettings (class 9) | XML title: “Set wifi outdoor mode” (V) |
| Calibration and reset | Ardrone3.Piloting.FlatTrim |
receive | Ardrone3.Piloting (class 0) | level calibration (I) |
| Calibration and reset | Common.Calibration.MagnetoCalibration |
receive | Common.Calibration (class 13) | XML title: “Start/Abort magnetometer calibration” (V) |
| Calibration and reset | Common.Settings.Reset |
receive | Common.Settings (class 2) | XML title: “Reset all settings” (V) |
| Calibration and reset | Common.Settings.AllSettings |
receive | Common.Settings (class 2) | XML title: “Ask for all settings” (V) |
Not in the index on purpose: Camera orientation and velocity, media, network, picture and audio settings, and all send state events, none of which move the aircraft or change a flight limit according to their XML titles (I from titles).
7. Method, controls and limits
Section titled “7. Method, controls and limits”Descriptor layout (V): a descriptor is 7 words used: name pointer, ids word (project in the low byte, class in the next, command in the high 16 bits), two words that are always 0, buffer code, pointer to the argument table, argument count. An argument entry is 16 bytes: name pointer, type code (0 i8 up to 11 enum, in the order listed in cmd_decode.py), enum table pointer, enum count; an enum entry is a name pointer and a signed 32-bit value. It was worked out on Ardrone3.Animations.Flip (one enum argument, 4 values), checked on Ardrone3.Piloting.MoveBy (four floats) and Ardrone3.PilotingState.FlyingStateChanged (nine enum values), then compared against all 256 XML commands with a descriptor (section 2).
Controls for negative results (V): (1) decoder registrations: the scan finds a site for all 110 ARCOMMANDS_Decoder_Set*Cb imports, so it has full recall against the import table; (2) generators: 138 of 139 imports have call sites and the one without (HomeChanged) has no PLT stub either, while the neighbouring HomeTypeChanged has both; (3) “not in the XML”: ids and names are matched together, 256 of 256 XML commands with a descriptor match, and the 8 that do not are absent as strings from three binaries while a present name is found; (4) normalised names collide for no descriptor pair.
Differences from bebop2-hidden-commands.md (V): 110 of 110 decoders registered (it said 106 plus 4 found by a wider pattern); Sequoia_cam handles 1 command, not 3; Thermal_cam 5 of 7; the undocumented handled count is 55, it said 56 (it counted a third FlatTrim id, 1.34.1, which is the descriptor Ardrone3.PilotingEvent.FlatTrimResult; dragon-prog does not import its generator and does not call it, V); XML 090c commands without a handler are 7, it said 6; the XML 090c count by my parser is 151, it said 150 (O, counting rule not recorded).
Not examined: what any callback does after the message is posted (except the flip, A); message ids for the 8 callbacks that do not use the 0x6a374 poster (Ardrone3 CancelMoveTo and Outdoor, six Follow_me commands); the arsdk_cmd_fmt and arsdk_cmd_itf_send callers beyond the logging reading; other processes. Open: whether Animation start commands and the Follow_me animations have acceptance gates like the flip (the earlier report asked the same).
Comments
Spotted a mistake, or tried this on your own Bebop? Leave a note. Comments are kept on this site's own server.