ARSDK commands: Animation, Follow_me and others
Part of the ARSDK command reference. Read its section on how to read the tables first. Tags in the cells: V Verified, A Agent-cited, I Inference, O Open.
Animation
Section titled “Animation”Project id 144. Not in the vendored XML. A feature project with no class level: one start command and one state event per animation type, plus Availability, State and Cancel (V). The library also describes Start_vertigo and Vertigo_state (ids 22 and 23); neither has a registration or call site in dragon-prog (V).
Animation (feature project 144)
Section titled “Animation (feature project 144)”| Command | Id | Dir | Arguments | What it does | Status in dragon-prog | Notes |
|---|---|---|---|---|---|---|
| Availability | 144.0.1 | send | Values:u32 bits{NONE=0,FLIP=1,HORIZONTAL_PANORAMA=2,DRONIE=3,HORIZONTAL_REVEAL=4,VERTICAL_REVEAL=5,SPIRAL=6,PARABOLA=7,CANDLE=8,DOLLY_SLIDE=9,VERTIGO=10} | Event with a bitfield of the animation types currently available (I). | GEN 0x65660 | not in vendored XML |
| State | 144.0.2 | send | Type:enum{NONE="0,FLIP=1,HORIZONTAL_PANORAMA=2,DRONIE=3,HORIZONTAL_REVEAL=4,VERTICAL_REVEAL=5,SPIRAL=6,PARABOLA=7,CANDLE=8,DOLLY_SLIDE=9,VERTIGO=10"}; Percent:u8 | Event with the running animation type and a percent value (I). | GEN 0x657e8 | not in vendored XML |
| Cancel | 144.0.3 | receive | (none) | Cancels the running animation; the posted message is ANIMATION_STOP (I). | REG 0x65cb8 cb 0x6558c; msg 153 ANIMATION_STOP (A) | not in vendored XML |
| Start_flip | 144.0.4 | receive | Type:enum{FRONT="0,BACK=1,LEFT=2,RIGHT=3"} | Starts a flip; second decoder for the same feature as Ardrone3.Animations.Flip (A: bebop2-flip-acceptance.md). | REG 0x65d08 cb 0x6514c; msg 152 ANIMATION_START (A) | not in vendored XML; gate: same decoder path and gates as Ardrone3.Animations.Flip (Agent-cited, bebop2-flip-acceptance.md); direction enum order differs (LEFT 2, RIGHT 3) |
| Flip_state | 144.0.5 | send | State:enum{IDLE="0,RUNNING=1,CANCELING=2"}; Type:enum{FRONT="0,BACK=1,LEFT=2,RIGHT=3"} | Event with the flip state IDLE, RUNNING or CANCELING and the flip direction (V descriptor; meaning I). | GEN 0x65a50 | not in vendored XML |
| Start_horizontal_panorama | 144.0.6 | receive | Provided_params:u8 bits{ROTATION_ANGLE=0,ROTATION_SPEED=1}; Rotation_angle:float; Rotation_speed:float | Starts a horizontal panorama (rotation angle, rotation speed) (I). | REG 0x65d1c cb 0x65088; msg 152 ANIMATION_START (A) | not in vendored XML |
| Horizontal_panorama_state | 144.0.7 | send | State:enum{IDLE="0,RUNNING=1,CANCELING=2"}; Rotation_angle:float; Rotation_speed:float | State event for the horizontal panorama with the parameters in use (I). | GEN 0x65ab8 | not in vendored XML |
| Start_dronie | 144.0.8 | receive | Provided_params:u8 bits{SPEED=0,DISTANCE=1,PLAY_MODE=2}; Speed:float; Distance:float; Play_mode:enum{NORMAL="0,ONCE_THEN_MIRRORED=1"} | Starts the dronie animation (speed, distance, play mode) (I). | REG 0x65cf4 cb 0x65290; msg 152 ANIMATION_START (A) | not in vendored XML |
| Dronie_state | 144.0.9 | send | State:enum{IDLE="0,RUNNING=1,CANCELING=2"}; Speed:float; Distance:float; Play_mode:enum{NORMAL="0,ONCE_THEN_MIRRORED=1"} | State event for the dronie animation (I). | GEN 0x65c00 | not in vendored XML |
| Start_horizontal_reveal | 144.0.10 | receive | Provided_params:u8 bits{SPEED=0,DISTANCE=1,PLAY_MODE=2}; Speed:float; Distance:float; Play_mode:enum{NORMAL="0,ONCE_THEN_MIRRORED=1"} | Starts the horizontal reveal animation (speed, distance, play mode) (I). | REG 0x65d30 cb 0x64f90; msg 152 ANIMATION_START (A) | not in vendored XML |
| Horizontal_reveal_state | 144.0.11 | send | State:enum{IDLE="0,RUNNING=1,CANCELING=2"}; Speed:float; Distance:float; Play_mode:enum{NORMAL="0,ONCE_THEN_MIRRORED=1"} | State event for the horizontal reveal (I). | GEN 0x65ba0 | not in vendored XML |
| Start_vertical_reveal | 144.0.12 | receive | Provided_params:u8 bits{SPEED=0,VERTICAL_DISTANCE=1,ROTATION_ANGLE=2,ROTATION_SPEED=3,PLAY_MODE=4}; Speed:float; Vertical_distance:float; Rotation_angle:float; Rotation_speed:float; Play_mode:enum{NORMAL="0,ONCE_THEN_MIRRORED=1"} | Starts the vertical reveal animation (speed, vertical distance, rotation angle and speed, play mode) (I). | REG 0x65d70 cb 0x64c58; msg 152 ANIMATION_START (A) | not in vendored XML |
| Vertical_reveal_state | 144.0.13 | send | State:enum{IDLE="0,RUNNING=1,CANCELING=2"}; Speed:float; Vertical_distance:float; Rotation_angle:float; Rotation_speed:float; Play_mode:enum{NORMAL="0,ONCE_THEN_MIRRORED=1"} | State event for the vertical reveal (I). | GEN 0x65bd4 | not in vendored XML |
| Start_spiral | 144.0.14 | receive | Provided_params:u8 bits{SPEED=0,RADIUS_VARIATION=1,VERTICAL_DISTANCE=2,REVOLUTION_NB=3,PLAY_MODE=4}; Speed:float; Radius_variation:float; Vertical_distance:float; Revolution_nb:float; Play_mode:enum{NORMAL="0,ONCE_THEN_MIRRORED=1"} | Starts the spiral animation (speed, radius variation, vertical distance, revolutions, play mode) (I). | REG 0x65d58 cb 0x64d78; msg 152 ANIMATION_START (A) | not in vendored XML |
| Spiral_state | 144.0.15 | send | State:enum{IDLE="0,RUNNING=1,CANCELING=2"}; Speed:float; Radius_variation:float; Vertical_distance:float; Revolution_nb:float; Play_mode:enum{NORMAL="0,ONCE_THEN_MIRRORED=1"} | State event for the spiral (I). | GEN 0x65aec | not in vendored XML |
| Start_parabola | 144.0.16 | receive | Provided_params:u8 bits{SPEED=0,VERTICAL_DISTANCE=1,PLAY_MODE=2}; Speed:float; Vertical_distance:float; Play_mode:enum{NORMAL="0,ONCE_THEN_MIRRORED=1"} | Starts the parabola animation (speed, vertical distance, play mode) (I). | REG 0x65d44 cb 0x64e98; msg 152 ANIMATION_START (A) | not in vendored XML |
| Parabola_state | 144.0.17 | send | State:enum{IDLE="0,RUNNING=1,CANCELING=2"}; Speed:float; Vertical_distance:float; Play_mode:enum{NORMAL="0,ONCE_THEN_MIRRORED=1"} | State event for the parabola (I). | GEN 0x65b18 | not in vendored XML |
| Start_candle | 144.0.18 | receive | Provided_params:u8 bits{SPEED=0,VERTICAL_DISTANCE=1,PLAY_MODE=2}; Speed:float; Vertical_distance:float; Play_mode:enum{NORMAL="0,ONCE_THEN_MIRRORED=1"} | Starts the candle animation (speed, vertical distance, play mode) (I). | REG 0x65ccc cb 0x65494; msg 152 ANIMATION_START (A) | not in vendored XML |
| Candle_state | 144.0.19 | send | State:enum{IDLE="0,RUNNING=1,CANCELING=2"}; Speed:float; Vertical_distance:float; Play_mode:enum{NORMAL="0,ONCE_THEN_MIRRORED=1"} | State event for the candle (I). | GEN 0x65b44 | not in vendored XML |
| Start_dolly_slide | 144.0.20 | receive | Provided_params:u8 bits{SPEED=0,ANGLE=1,HORIZONTAL_DISTANCE=2,PLAY_MODE=3}; Speed:float; Angle:float; Horizontal_distance:float; Play_mode:enum{NORMAL="0,ONCE_THEN_MIRRORED=1"} | Starts the dolly slide animation (speed, angle, horizontal distance, play mode) (I). | REG 0x65ce0 cb 0x65388; msg 152 ANIMATION_START (A) | not in vendored XML |
| Dolly_slide_state | 144.0.21 | send | State:enum{IDLE="0,RUNNING=1,CANCELING=2"}; Speed:float; Angle:float; Horizontal_distance:float; Play_mode:enum{NORMAL="0,ONCE_THEN_MIRRORED=1"} | State event for the dolly slide (I). | GEN 0x65b74 | not in vendored XML |
Follow_me
Section titled “Follow_me”Project id 134. Not in the vendored XML. Follow-me tracking and five follow-me animations (V). The library also describes Set_target_is_controller (26) and Target_is_controller (27), neither handled in dragon-prog (V).
Follow_me (feature project 134)
Section titled “Follow_me (feature project 134)”| Command | Id | Dir | Arguments | What it does | Status in dragon-prog | Notes |
|---|---|---|---|---|---|---|
| Start | 134.0.1 | receive | Mode:enum{NONE="0,LOOK_AT=1,GEOGRAPHIC=2,RELATIVE=3"} | Starts the follow-me function in the chosen mode (NONE, LOOK_AT, GEOGRAPHIC, RELATIVE) (I). | REG 0x60f48 cb 0x56664; no msg id found (O) | not in vendored XML; Callback does not use the 0x6a374 poster; effect not traced (O). |
| Stop | 134.0.2 | receive | (none) | Stops follow-me (I). | REG 0x60f5c cb 0x58da8; no msg id found (O) | not in vendored XML; Callback does not use the 0x6a374 poster; effect not traced (O). |
| State | 134.0.3 | send | Mode:enum{NONE="0,LOOK_AT=1,GEOGRAPHIC=2,RELATIVE=3"}; Behavior:enum{IDLE="0,FOLLOW=1,LOOK_AT=2"}; Animation:enum{NONE="0,HELICOID=1,SWING=2,BOOMERANG=3,CANDLE=4,DOLLY_SLIDE=5"}; Animation_available:u16 bits{NONE=0,HELICOID=1,SWING=2,BOOMERANG=3,CANDLE=4,DOLLY_SLIDE=5} | Event with the current follow-me mode, behavior, running animation and the animations available (I). | GEN 0x5ffbc | not in vendored XML |
| Mode_info | 134.0.4 | send | Mode:enum{NONE="0,LOOK_AT=1,GEOGRAPHIC=2,RELATIVE=3"}; Missing_requirements:u16 bits{DRONE_CALIBRATED=0,DRONE_GPS_GOOD_ACCURACY=1,TARGET_GPS_GOOD_ACCURACY=2,TARGET_BAROMETER_OK=3,DRONE_FAR_ENOUGH=4,DRONE_HIGH_ENOUGH=5,IMAGE_DETECTION=6}; Improvements:u16 bits{DRONE_CALIBRATED=0,DRONE_GPS_GOOD_ACCURACY=1,TARGET_GPS_GOOD_ACCURACY=2,TARGET_BAROMETER_OK=3,DRONE_FAR_ENOUGH=4,DRONE_HIGH_ENOUGH=5,IMAGE_DETECTION=6} | Event listing, per mode, which requirements are missing and which would improve tracking (drone calibrated, GPS accuracy of drone and target, target barometer, distance, height, image detection) (I). | GEN 0x602d4 | not in vendored XML |
| Configure_geographic | 134.0.6 | receive | Use_default:u8 bits{DISTANCE=0,ELEVATION=1,AZIMUTH=2}; Distance:float; Elevation:float; Azimuth:float | Sets distance, elevation and azimuth for the geographic follow mode; Use_default marks values to leave at default (I). | REG 0x60fc0 cb 0x58bac; no msg id found (O) | not in vendored XML; Callback does not use the 0x6a374 poster; effect not traced (O). |
| Geographic_config | 134.0.7 | send | Use_default:u8 bits{DISTANCE=0,ELEVATION=1,AZIMUTH=2}; Distance:float; Elevation:float; Azimuth:float | Event echoing the geographic follow settings (I). | GEN 0x60208 | not in vendored XML |
| Configure_relative | 134.0.8 | receive | Use_default:u8 bits{DISTANCE=0,ELEVATION=1,AZIMUTH=2}; Distance:float; Elevation:float; Azimuth:float | Sets distance, elevation and azimuth for the relative follow mode (I). | REG 0x60fd4 cb 0x58af8; no msg id found (O) | not in vendored XML; Callback does not use the 0x6a374 poster; effect not traced (O). |
| Relative_config | 134.0.9 | send | Use_default:u8 bits{DISTANCE=0,ELEVATION=1,AZIMUTH=2}; Distance:float; Elevation:float; Azimuth:float | Event echoing the relative follow settings (I). | GEN 0x60144 | not in vendored XML |
| Target_trajectory | 134.0.10 | send | Latitude:double; Longitude:double; Altitude:float; North_speed:float; East_speed:float; Down_speed:float | Event carrying the tracked target position and NED velocity (I). | GEN 0x60684 | not in vendored XML |
| Stop_animation | 134.0.11 | receive | (none) | Stops the running follow-me animation (I). | REG 0x6104c cb 0x56c54; msg 153 ANIMATION_STOP (A) | not in vendored XML |
| Start_helicoid_anim | 134.0.12 | receive | Use_default:u8 bits{SPEED=0,REVOLUTION_NB=1,VERTICAL_DISTANCE=2}; Speed:float; Revolution_number:float; Vertical_distance:float | Starts the helicoid follow-me animation (speed, revolutions, vertical distance) (I). | REG 0x60fe8 cb 0x56f90; msg 152 ANIMATION_START (A) | not in vendored XML |
| Helicoid_anim_config | 134.0.13 | send | Use_default:u8 bits{SPEED=0,REVOLUTION_NB=1,VERTICAL_DISTANCE=2}; Speed:float; Revolution_nb:float; Vertical_distance:float | Event echoing helicoid animation settings (I). | GEN 0x605cc | not in vendored XML |
| Start_swing_anim | 134.0.14 | receive | Use_default:u8 bits{SPEED=0,VERTICAL_DISTANCE=1}; Speed:float; Vertical_distance:float | Starts the swing follow-me animation (speed, vertical distance) (I). | REG 0x60ffc cb 0x56ee0; msg 152 ANIMATION_START (A) | not in vendored XML |
| Swing_anim_config | 134.0.15 | send | Use_default:u8 bits{SPEED=0,VERTICAL_DISTANCE=1}; Speed:float; Vertical_distance:float | Event echoing swing animation settings (I). | GEN 0x60554 | not in vendored XML |
| Start_boomerang_anim | 134.0.16 | receive | Use_default:u8 bits{SPEED=0,DISTANCE=1}; Speed:float; Distance:float | Starts the boomerang follow-me animation (speed, distance) (I). | REG 0x61010 cb 0x56e30; msg 152 ANIMATION_START (A) | not in vendored XML |
| Boomerang_anim_config | 134.0.17 | send | Use_default:u8 bits{SPEED=0,DISTANCE=1}; Speed:float; Distance:float | Event echoing boomerang animation settings (I). | GEN 0x60520 | not in vendored XML |
| Start_candle_anim | 134.0.18 | receive | Use_default:u8 bits{SPEED=0,VERTICAL_DISTANCE=1}; Speed:float; Vertical_distance:float | Starts the candle follow-me animation (speed, vertical distance) (I). | REG 0x61024 cb 0x56d80; msg 152 ANIMATION_START (A) | not in vendored XML |
| Candle_anim_config | 134.0.19 | send | Use_default:u8 bits{SPEED=0,VERTICAL_DISTANCE=1}; Speed:float; Vertical_distance:float | Event echoing candle animation settings (I). | GEN 0x60588 | not in vendored XML |
| Start_dolly_slide_anim | 134.0.20 | receive | Use_default:u8 bits{SPEED=0,ANGLE=1,HORIZONTAL_DISTANCE=2}; Speed:float; Angle:float; Horizontal_distance:float | Starts the dolly-slide follow-me animation (speed, angle, horizontal distance) (I). | REG 0x61038 cb 0x56ccc; msg 152 ANIMATION_START (A) | not in vendored XML |
| Dolly_slide_anim_config | 134.0.21 | send | Use_default:u8 bits{SPEED=0,ANGLE=1,HORIZONTAL_DISTANCE=2}; Speed:float; Angle:float; Horizontal_distance:float | Event echoing dolly-slide animation settings (I). | GEN 0x60484 | not in vendored XML |
| Target_framing_position | 134.0.22 | receive | Horizontal:i8; Vertical:i8 | Sets where the subject should sit in the frame (horizontal and vertical, signed bytes) (I). | REG 0x60fac cb 0x58c60; no msg id found (O) | not in vendored XML; Callback does not use the 0x6a374 poster; effect not traced (O). |
| Target_framing_position_changed | 134.0.23 | send | Horizontal:i8; Vertical:i8 | Event echoing the framing position (I). | GEN 0x5fe0c | not in vendored XML |
| Target_image_detection | 134.0.24 | receive | Target_azimuth:float; Target_elevation:float; Change_of_scale:float; Confidence_index:u8; Is_new_selection:u8; Timestamp:u64 | Controller-side input: a detected target (azimuth, elevation, scale change, confidence, new-selection flag, timestamp) (I). | REG 0x60f70 cb 0x58cf4; no msg id found (O) | not in vendored XML; Callback does not use the 0x6a374 poster; effect not traced (O). |
| Target_image_detection_state | 134.0.25 | send | State:enum{NONE="0,OK=1,LOST=2"} | Event with the image detection state NONE, OK or LOST (I). | GEN 0x607c8 | not in vendored XML |
Controller_info
Section titled “Controller_info”Project id 140. Not in the vendored XML. The controller sends its own GPS and barometer readings to the aircraft (I from names and arguments).
Controller_info (feature project 140)
Section titled “Controller_info (feature project 140)”| Command | Id | Dir | Arguments | What it does | Status in dragon-prog | Notes |
|---|---|---|---|---|---|---|
| Gps | 140.0.1 | receive | Latitude:double; Longitude:double; Altitude:float; Horizontal_accuracy:float; Vertical_accuracy:float; North_speed:float; East_speed:float; Down_speed:float; Timestamp:double | The controller reports its own position, accuracy and NED velocity with a timestamp (I). | REG 0x60f84 cb 0x570dc; msg 131 CONTROLLER_INFO_GPS (A) | not in vendored XML |
| Barometer | 140.0.2 | receive | Pressure:float; Timestamp:double | The controller reports a pressure reading with a timestamp (I). | REG 0x60f98 cb 0x57050; msg 132 CONTROLLER_INFO_BARO (A) | not in vendored XML |
Sequoia_cam
Section titled “Sequoia_cam”Project id 147. Not in the vendored XML. Only the calibration start command is handled; Radiometric_calib_status and Radiometric_calib_result have descriptors but no call site (V). The earlier hidden-commands report listed all three as wired; that was wrong for the two events (see section 7).
Sequoia_cam (feature project 147)
Section titled “Sequoia_cam (feature project 147)”| Command | Id | Dir | Arguments | What it does | Status in dragon-prog | Notes |
|---|---|---|---|---|---|---|
| Radiometric_calib_start | 147.0.3 | receive | Id:u8 | Starts radiometric calibration for the camera with the given id (I). | REG 0x6234c cb 0x614ec; msg 156 SEQUOIA_RADIO_CALIB (A) | not in vendored XML |
Thermal_cam
Section titled “Thermal_cam”Project id 142. Not in the vendored XML. Five of the seven descriptors are handled: Activate, Deactivate, Camera_state, Calibration_infos, Charging_status. Whether a thermal camera exists on a stock Bebop 2 was not determined (O).
Thermal_cam (feature project 142)
Section titled “Thermal_cam (feature project 142)”| Command | Id | Dir | Arguments | What it does | Status in dragon-prog | Notes |
|---|---|---|---|---|---|---|
| Activate | 142.0.1 | receive | Cam_id:u8 | Activates the thermal camera with the given id; the posted message is THERMAL_VIDEO_ENABLE (I). | REG 0xc2cec cb 0xc2bf4; msg 53 THERMAL_VIDEO_ENABLE (A) | not in vendored XML |
| Deactivate | 142.0.2 | receive | Cam_id:u8 | Deactivates the thermal camera with the given id; same posted message as Activate (I). | REG 0xc2d04 cb 0xc2b14; msg 53 THERMAL_VIDEO_ENABLE (A) | not in vendored XML |
| Camera_state | 142.0.3 | send | Cam_id:u8; State:enum{ACTIVATED="0,DEACTIVATED=1,PENDING=2"}; List_flags:u8 bits{FIRST=0,LAST=1,EMPTY=2,REMOVE=3} | Event with a thermal camera state ACTIVATED, DEACTIVATED or PENDING, in a list (List_flags) (I). | GEN 0xc2d6c | not in vendored XML |
| Calibration_infos | 142.0.6 | send | Cam_id:u8; Roll:float; Pitch:float; Yaw:float; List_flags:u8 bits{FIRST=0,LAST=1,EMPTY=2,REMOVE=3} | Event with roll, pitch and yaw calibration of a thermal camera (I). | GEN 0xc3044 | not in vendored XML |
| Charging_status | 142.0.7 | send | Cam_id:u8; State:enum{NOT_CHARGING="0,CHARGING_ONLY=1,CHARGING=2,UNKNOWN=3"}; List_flags:u8 bits{FIRST=0,LAST=1,EMPTY=2,REMOVE=3} | Event with the charging state of a thermal camera (I). | GEN 0xc2ecc | not in vendored XML |
Comments
Spotted a mistake, or tried this on your own Bebop? Leave a note. Comments are kept on this site's own server.