# M17 Servomotor — hardware version 1.3

> This product is a Servomotor with 4-in-1 integrated motor + motor driver + motion controller + encoder in a NEMA 17 form factor

Canonical page: https://9o.at/products/m17/1.3
Product code: M17. Hardware version: 1.3.

## Documents
- Datasheet (English): https://cdn.jsdelivr.net/gh/tomrodinger/servomotor@main/servomotor_datasheets/datasheet_latest_en.pdf
- Datasheet (Deutsch): https://cdn.jsdelivr.net/gh/tomrodinger/servomotor@main/servomotor_datasheets/datasheet_latest_de.pdf
- Datasheet (Français): https://cdn.jsdelivr.net/gh/tomrodinger/servomotor@main/servomotor_datasheets/datasheet_latest_fr.pdf
- Datasheet (Español): https://cdn.jsdelivr.net/gh/tomrodinger/servomotor@main/servomotor_datasheets/datasheet_latest_es.pdf
- Datasheet (Italiano): https://cdn.jsdelivr.net/gh/tomrodinger/servomotor@main/servomotor_datasheets/datasheet_latest_it.pdf
- Datasheet (Português): https://cdn.jsdelivr.net/gh/tomrodinger/servomotor@main/servomotor_datasheets/datasheet_latest_pt.pdf
- Schematic (PDF): https://raw.githubusercontent.com/tomrodinger/servomotor/main/PCB/Servomotor3/1.3/schematic/1.3-index-schTop.pdf
- Hardware design files on GitHub: https://github.com/tomrodinger/servomotor/tree/main/PCB/Servomotor3/1.3
- Tutorial: https://tutorial.gearotons.com/
- Python API reference (Markdown): https://9o.at/docs/python.md
- Arduino API reference (Markdown): https://9o.at/docs/arduino.md
- MCP server (drive the motor from an AI assistant): https://github.com/Gearotons/servomotor-mcp
- Store: https://gearotons.com/store

## Firmware
Newest first. Update with the browser tool at https://motor-maintenance.gearotons.com/ (Chromium browsers) or the Python tools in the repository.

| Version | Compatibility | Date | SHA-256 | File |
|---|---|---|---|---|
| 0.13.0.0 | 3 | 2025-09-05 | 0c6ddd1d88d84a304e057422fabfa612cdfebd2ee5ee2bee8ca8846a1b399bb8 | https://cdn.jsdelivr.net/gh/tomrodinger/servomotor@main/firmware/firmware_releases/servomotor_M17_fw0.13.0.0_scc3_hw1.3.firmware |
| 0.13.0.0 | 4 | 2025-12-30 | 23ccd2e72bd694aab7f77a124310858b9a57b79c3834c190d5d2fe9ae0bfa2f7 | https://cdn.jsdelivr.net/gh/tomrodinger/servomotor@main/firmware/firmware_releases/servomotor_M17_fw0.13.0.0_scc4_hw1.3.firmware |

### Updating from the command line

Once per computer, run these two commands separately:

```sh
pip3 install --upgrade servomotor
```

```sh
servomotor_command -P
```

The second shows a numbered list of serial ports; type the number of the USB-to-RS-485 adapter and press Enter. The choice is saved, so no later command needs `-p`, and nothing is sent to the motor. Run it on its own: it reads its answer from the terminal, so inside a pasted block it would take the next pasted line as its answer. For scripts, pass `-p <PORT>` or set `SERVOMOTOR_PORT` instead; either overrides the saved choice.

Then, for each upgrade:

```sh
# Download the firmware file into the current folder.
curl -LO https://cdn.jsdelivr.net/gh/tomrodinger/servomotor@main/firmware/firmware_releases/servomotor_M17_fw0.13.0.0_scc3_hw1.3.firmware
# Update every motor on the bus that this file is for. Motors of another
# model or compatibility code ignore it and keep their firmware.
upgrade_firmware servomotor_M17_fw0.13.0.0_scc3_hw1.3.firmware
# Check the result: the Firmware Version column should show the new version
# for every motor. The upgrade itself cannot tell you whether it worked.
show_device_information_for_all_devices
```

This updates every motor on the bus that the file is for; motors of another model or firmware compatibility code ignore it and keep their firmware. No motor answers during a broadcast transfer, so upgrade_firmware reports every page as written whether or not it was: the final `show_device_information_for_all_devices` is the real check, and its Firmware Version column should show the new version for every motor. If it stops with "Communication error" instead of printing its table, a motor is probably still in its bootloader (its green LED blinks fast); run the upgrade again. To update only one motor, use the browser maintenance tool at https://motor-maintenance.gearotons.com/ — press Firmware on that motor's row; it flashes only that motor, leaves the rest of the bus alone and reads the version back — or add `-a <ALIAS>` to the upgrade command. The command-line tool reboots the whole bus into its bootloader during the transfer, even with -a. An interrupted upgrade cannot brick a motor, and the alias and calibration survive.