ODrive v3.x
Based on published sources · Not tested by us ·
Overview
Legacy dual-axis brushless motor control with public v3.x firmware; v3.6 board designs and newer-generation firmware have different openness boundaries. [S001] [S006] [S008]
This profile covers the legacy ODrive v3.x platform, using the preserved fw-v0.5.6 source release and its v3.6 hardware documentation. The current upstream README says v3.x firmware is no longer actively developed. It separately states that firmware for newer products including Pro, S1 and Micro is not publicly available. The legacy repository cannot establish the openness or compatibility of those products. [S002] [S006] [S008]
Specifications
| Detail | Description |
|---|---|
| Type | Dual-axis motor controller; selected hardware example is v3.6 Reported by source [S005] [S006] · Checked 2026-10-01 |
| Intended users | Developers maintaining or researching legacy ODrive v3.x systems Editorial assessment [S001] · Checked 2026-10-01 |
| Assembly | Not known |
| Calibration | Configure motor and encoder parameters, save/reboot, run calibration without gravity or spring bias, inspect errors and tune closed-loop control. Reported by source [S005] · Checked 2026-10-01 |
| Operating system | Windows; macOS; Linux Historical documentation; current host dependency compatibility not tested. Reported by source [S005] · Checked 2026-10-01 |
| Computer needed | Computer running Python-based odrivetool; historical setup covers Windows, macOS and Linux Reported by source [S005] · Checked 2026-10-01 |
3D preview
Preview not available yet. A model has not yet been prepared and approved for display on this page. This does not mean the project lacks CAD files; see Source files and licenses for the reviewed source availability.
Assembly and use
Identify the board before using its limits
The v3.6 documentation distinguishes 24 V and 56 V variants, with listed input ranges of 12–24 V and 12–56 V respectively. It also says board files and schematics after v3.5 are closed source. Its linked v3.5 schematic and STEP model are therefore not a v3.6 manufacturing package. Public firmware, a board model and reproducible electronics are separate questions. [S006]
The controller supports two motor axes, but the getting-started guide recommends beginning with one motor and encoder. Budget for the motor, feedback device, power source, wiring and braking arrangement as well as the controller. The complete delivered cost and current availability of a matched legacy setup were not verified. [S005]
Commissioning depends on the motor and power system
USB does not power the board: the main supply is needed even for USB communication. Motor phase connections and a rigid encoder coupling must be established before calibration. Braking can return energy to the supply; the guide discusses a brake resistor and supply regeneration limits rather than assuming every power source can absorb that energy. [S005]
The setup requires motor current and velocity limits, suitable calibration current, pole pairs, torque constant and encoder counts per revolution. Encoder counts are not interchangeable with pulses per revolution. Parameters are saved to persistent memory through a save operation that reboots the board. Brake-resistor configuration also requires saving and rebooting to take effect. [S005]
Calibration measures motor electrical properties and encoder alignment while moving the rotor. The documented procedure allows inertia and weak friction but excludes a gravity or spring bias. Errors should be investigated before retrying; successful calibration is followed by closed-loop tuning. A communications watchdog exists but must be explicitly configured and enabled, so its presence in the code is not proof of an active stop-on-disconnection behavior. [S005]
Preserve the software pairing
The archive contains Python-based odrivetool instructions for Windows, macOS and Linux. Those instructions include old Python examples and historical package-management advice. They are useful evidence of the original setup, not confirmation that an unpinned install works on a current computer. Record the board revision, firmware and host-tool versions together before changing an existing system. [S002] [S005]
The guide also distinguishes older boards requiring initial ST-Link flashing from later boards described as preflashed. That historical shipment description does not establish the state of a used board today. No firmware was built or flashed, host tool installed, or motor operated during this review. [S005]
The selected firmware and repository software carry MIT licenses, with separate notices applying where present. This is a useful open legacy control stack for research and maintenance, with explicit limits on hardware design access and ongoing development. It is not a claim that every product sold under the ODrive name shares these sources. [S003] [S007] [S008]
Cost
No current, complete configuration-specific build cost has been established for this profile.
Source files and licenses
Available project sources support research coverage; complete build and commercial qualification remain separate.
| Layer | Availability / license |
|---|---|
| mechanical design | not found · License not fully assessed Selected v3.6: upstream says board files and schematics after v3.5 are closed source. Linked v3.5 schematic/STEP are a different revision and are not treated as v3.6 fabrication evidence. [S006] |
| electronics | not found · License not fully assessed Selected v3.6: upstream says board files and schematics after v3.5 are closed source. Linked v3.5 schematic/STEP are a different revision and are not treated as v3.6 fabrication evidence. [S006] |
| firmware | available · MIT Selected legacy repository sources; bundled third-party code and dependencies retain separate terms. [S003] [S004] [S007] |
| software | available · MIT Selected legacy repository sources; bundled third-party code and dependencies retain separate terms. [S003] [S004] [S007] |
| documentation | available · MIT Selected legacy repository sources; bundled third-party code and dependencies retain separate terms. [S003] [S004] [S007] |
Selected motor-control route does not require a learned policy or training dataset.
References
Links identify the documentation and revisions used in this profile. Access dates record when each source was retrieved.
- S001 · odriverobotics / project contributors
Upstream project overview
Accessed 2026-10-01 · README.mdSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S002 · odriverobotics / project contributors
Repository revision and release metadata
Accessed 2026-10-01 · a308314ed2ca613164b81e7bbdfacc53cd1859ffSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S003 · odriverobotics / project contributors
Repository license
Accessed 2026-10-01 · LICENSE.mdSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S004 · odriverobotics / project contributors
Pinned repository artifact inventory
Accessed 2026-10-01 · a308314ed2ca613164b81e7bbdfacc53cd1859ff archive file inventorySource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S005 · odriverobotics / project contributors
docs/getting-started.rst
Accessed 2026-10-01 · a308314ed2ca613164b81e7bbdfacc53cd1859ff / docs/getting-started.rstSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S006 · odriverobotics / project contributors
docs/specifications.rst
Accessed 2026-10-01 · a308314ed2ca613164b81e7bbdfacc53cd1859ff / docs/specifications.rstSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S007 · odriverobotics / project contributors
Firmware/LICENSE
Accessed 2026-10-01 · a308314ed2ca613164b81e7bbdfacc53cd1859ff / Firmware/LICENSESource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S008 · odriverobotics / project contributors
Current upstream maintenance and source-scope statement
Accessed 2026-10-01 · 3a2e4dd1bfbda9e4c534d5c7d8428a99c361e783 / README.mdSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
Correction guidance · Discussion is not enabled · Profile format 0.6.0-draft.1