Control tables¶
Every servo has a control table: a block of registers that is read and written with the Read and Write instructions.
The addresses and units differ by family. The driver keeps one table per family and one family-neutral name per
register (Reg), so ReadRegister({id, family}, Reg::PresentPosition) works on any family that has one.
Datasheet sections this page relies on
- Control table, X series (addresses, sizes, units): ROBOTIS e-Manual, XM430-W350 web page, no revision mark, 2 Control Table; 2.1 Control Table of EEPROM Area; 2.2 Control Table of RAM Area, p. 1
- Specifications, baud rates and ID range: ROBOTIS e-Manual, XM430-W350 web page, no revision mark, 1 Specifications, p. 1
- Control table, AX / RX / DX series (protocol 1.0): ROBOTIS e-Manual, AX-12A web page, no revision mark, 2 Control Table; 2.2 EEPROM Area; 2.3 RAM Area, p. 1
- Control table, XL-320: ROBOTIS e-Manual, XL-320 web page, no revision mark, 2 Control Table; 2.2 EEPROM Area; 2.3 RAM Area, p. 1
All of them, with the driver API for each: Datasheet map.
Families¶
Info(family) gives the facts below, FindModel() the model number to family mapping (47 model numbers), and
FamilyOf(model) the family of a ping reply. A model number the catalogue does not list is Family::Generic: raw
addresses only.
Family |
Models | Protocol | Baud register | Position per turn | Table page of the e-Manual |
|---|---|---|---|---|---|
AxRxDx |
AX-12A, AX-12W, RX-10, RX-24F, RX-28, RX-64, DX-113, DX-116, DX-117 | 1.0 | divider | 1024 (300 degrees) | ax/ax-12a, rx/rx-28, dx/dx-116 |
Mx28, Mx64, Mx106 |
MX-28, MX-12W, MX-64, MX-106 | 1.0 | divider | 4096 | mx/mx-28, mx/mx-64, mx/mx-106 |
Mx28v2, Mx64v2 |
MX-28(2.0), MX-64(2.0), MX-106(2.0) | 2.0 | table of 8 | 4096 | mx/mx-28-2, mx/mx-64-2, mx/mx-106-2 |
Xl320 |
XL-320 | 2.0 | table of 4 | 1024 | x/xl320 |
X330 |
XL330, XC330, XM335 | 1.0, 2.0 | table of 7 | 4096 | x/xl330-m288 |
X430Basic |
XL430, XC430, 2XL430, 2XC430 | 1.0, 2.0 | table of 8 | 4096 | x/xl430-w250 |
X430 |
XM430, XH430, XD430 | 1.0, 2.0 | table of 8 | 4096 | x/xm430-w350 |
X540 |
XM540, XH540, XD540 | 1.0, 2.0 | table of 8 | 4096 | x/xm540-w270 |
Xw |
XW430, XW540 | 1.0, 2.0 | table of 8 | 4096 | x/xw430-t333 |
The pages are under https://emanual.robotis.com/docs/en/dxl/. The Pro, P, H, L and Y series are not in the
catalogue: read them with raw addresses and Family::Generic.
Kinds of value¶
Each register has a Kind that says how its bytes decode:
Kind |
Registers | Decoding |
|---|---|---|
Unsigned |
most of them | little-endian unsigned |
Signed |
position, velocity, current and offsets of protocol 2.0 families | two's complement of the register width |
SignMag10 |
speed, load and torque of protocol 1.0 families | bits 9 to 0 magnitude, bit 10 the direction |
Offset2048 |
current of the MX-64 and MX-106 (1.0) | value minus 2048 |
WriteRegister() checks that the value fits the register and its kind (InvalidArgument, nothing sent), refuses a
read-only register, and returns Unsupported for a family without the register.
Units¶
Info(family) and FindModel(model) carry the unit of position, velocity and current:
- position:
microdeg_per_count(for example 88 000 micro-degrees for the 4096-count families); - velocity:
mrpm_per_count(milli-rpm per count); - current:
ModelInfo::current_ua(micro-amperes per count, 0 when the table has no current register).
ReadFeedback() returns position, velocity, effort (load in per mille, or current in counts: Feedback::EffortKind),
voltage in 0.1 V and temperature in degrees Celsius, read in one transfer.
Indirect addresses¶
The X430, X540, XW and MX(2.0) tables have indirect address and indirect data blocks: map up to 28 (or 56)
scattered registers to one contiguous block, so that a single Read or Sync Read fetches them all.
Indirect(family, index) gives the addresses of the pair index (1 to 28 in the first block, to 56 in the second
block above address 255); Info(family).indirect_blocks says how many blocks a family has.
Baud rates¶
SetServoBaudRate() writes the servo's Baud Rate register with the value its family's scheme encodes
(BaudValueFor()), and ChangeBusBaud() then moves the UART. The divider families encode 2 000 000 / (value + 1);
the table families list 9 600, 57 600, 115 200, 1 000 000, 2 000 000, 3 000 000, 4 000 000 and 4 500 000 bit/s as the
e-Manual does for their model.