D, R, G, M, X, r, w, V, d, t, s, m, b, i, c, o, K, Z, T
same string, letters followed by a colon
Verified
Long option names stored as separate strings
help, no_verbose, quit, scicos, Power_supply, Weight_captor, and the long names in the table below
strings of the binary
Verified
Long option names --I2C_bridge, --interactive
Present as strings; not printed in the usage block
strings of the binary
Verified
Help-text origin
Printed by the tool itself; the usage block is grouped under the headings MTB firmware, MTB external peripherals, Basic unitary commands to BLDC, Remote control, Motor settings, Speed steps, Computation, Unitary tests
Prints information; sends no motor, setting or GPIO change.
Clears error flag only
Clears the controller error flag; the help text does not say motors stop.
Stops motors
Stops spinning the motors.
Starts or spins motors
Starts motors, or sets, builds or launches a speed reference.
Writes persistent settings
Writes a motor setting.
Clears EEPROM
Clears the controller EEPROM.
Changes GPIO or sound
Changes controller GPIO logic or plays sound.
Other test mode
Concerns bench peripherals or the host link, not the motors directly. -P and -V act on a bench power supply and change its output.
Unknown (treat as spinning motors)
The help text does not establish the effect.
Classification is conservative. Any option that sets a speed profile, launches a wave, runs a unit test, computes feedforward or Kv, orders motors or starts motors is labelled as starting or spinning motors.
The Effect column paraphrases the help text. Four lines that carry a warning are quoted exactly (-H, -C, -E, -N). Arguments are as shown in the help text.
Reads a weight measurement from a KERN440 balance.
Other test mode
Verified
-todo
none
none
Listed entry for reading propeller speed from an optical sensor; no option letter matches it.
Unknown (treat as spinning motors)
Verified
The -todo line is printed in the usage block, but the getopt string has no t option that matches it as printed. -t is a separate option (see Speed steps).
Starts the motors with a given direction; clears an error automatically first.
Starts or spins motors
Verified
-S
--secure_start_motors
none
Starts the motors; clears an error automatically first.
Starts or spins motors
Verified
-H
--stop_motors
none
“Stop spinning the motors”
Stops motors
Verified
-C
--clear_error
none
“Clear BLDC error flag”
Clears error flag only
Verified
-O
--get_obs_speed
none
Reads the observed speed.
Read only
Verified
-R
--set_ref_speed
RPM1 RPM2 RPM3 RPM4
Sets a reference speed for each of the four motors.
Starts or spins motors
Verified
-A
--rev_spin_dir
none
Reverses the spin direction of all propellers.
Unknown (treat as spinning motors)
Verified
-G
--GPIO
r g p s
Changes the logic level of the board GPIO lines (two LEDs, a reset line for the main SoC and a switch line, as the help text names them).
Changes GPIO or sound
Verified
-M
--Musique
m
Plays a sound: a negative value loops it, zero stops it, a positive value plays it once.
Unknown (treat as spinning motors)
Verified
-E
--EEPROM_clear
none
“Clear the content of EEPROM”
Clears EEPROM
Verified
-X
--set_i2c_timeout
ms
Sets the I2C timeout in milliseconds, up to 30000.
Unknown (treat as spinning motors)
Verified
The help text for -M does not say how the board produces sound, so it is labelled Unknown. A project note (firmware-4.7.1.md) reports that it moves the motors briefly (the boot chirp); that was not verified. The factory script carries the comment ### Stop motors to produce sound (if error detecetd) above its -C call.
Runs unit tests from the first to the last given number.
Starts or spins motors
Verified
Related strings in the same binary: “Usage for MTB unitary tests: -T f [l]”, and a prompt in French asking that the propeller be blocked before a start.
The dispatch table of the motor-board firmware image (BLDC.cyacd) was read by a project note. It lists handlers for commands 0x02, 0x20, 0x40, 0x4D, 0x60, 0x80, 0x82, 0x8D, 0xA0 and 0xFA. It has no entry for 0x06, 0x2B, 0xC0 or 0xE0. The host tool contains code that sends all four. The table was re-read from the image bytes for this page: it holds entries for exactly those ten command bytes and none for 0x06, 0x2B, 0xC0 or 0xE0. The flag-to-command links in the table below were not re-derived.
Command
Host function name
Flags that depend on it
Basis
Status
0x06
MTB_BLDC_reverse_spin_direction
-A
Function name and help text match; the decompile note does not print the flag-to-function link
Agent-cited
0xC0
settings access, read form C0 52 id 00 00, write form C0 57 id hi lo
-r, -w, -a
The project notes state the mapping from the “Motor settings” group; the decompile note names the read and write functions without naming flags
Agent-cited
0x2B
MTB_BLDC_get_assert
none
The decompile note says it is called only when the reported errno is 13, not from an option
Agent-cited
0xE0
observed-data log dump, 75 pages
not established
The decompile note names the dumping function and not the option that reaches it
Open
The notes state that commands without a table entry fall to an unknown-command default on 4.7.1. That behaviour was not observed on hardware.
Comments
Spotted a mistake, or tried this on your own Bebop? Leave a note. Comments are kept on this site's own server.