moteus
Based on published sources · Not tested by us ·
Overview
Open brushless servo-controller designs with CAN-FD control, board-specific electrical limits and motor calibration requirements. [S001]
moteus provides brushless servo-controller hardware designs, firmware and host libraries. It is a component for building an actuator: the motor, mechanical mounting, power system and host connection still need to be selected. The preserved repository covers r4.11, c1, n1 and x1 boards with different electrical and thermal limits. A specification from one column should not be applied to another board. [S001]
Specifications
| Detail | Description |
|---|---|
| Type | Motor controller board; motor and mechanism supplied separately Reported by source [S001] · Checked 2026-10-01 |
| Intended users | Robotics developers integrating brushless motors and feedback Editorial assessment [S001] · Checked 2026-10-01 |
| Assembly | Not known |
| Calibration | Bare boards require motor-specific calibration, then position-loop tuning; repeat when motor or mechanical registration changes. Reported by source [S009] [S010] · Checked 2026-10-01 |
| Operating system | Linux; Windows; macOS Documented host tools; firmware source build has separate Ubuntu requirements. Reported by source [S007] · Checked 2026-10-01 |
| Computer needed | Host computer running Python tools, with a supported communication adapter Reported by source [S007] · 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
Board ratings are not a complete actuator rating
For example, the overview lists a 10–44 V input range for r4.11 and 10–54 V for n1 and x1. It distinguishes uncooled, cooled and peak phase current. Those are upstream board figures, not a measured continuous torque rating for a motor, gearbox or assembled robot. The hardware archive includes revisioned board designs and some mechanical models; this review did not validate their geometry or fabrication outputs. [S001] [S012]
The onboard encoder route needs a diametrically magnetized magnet fixed to the motor rotor, with the board rigidly centered above it at approximately a 2 mm gap. The r4 encoder is offset from the mounting-hole pattern. The n1 guide also calls for an opaque enclosure because its regulator is light-sensitive. These are variant-specific mounting requirements, not interchangeable enclosure advice. [S005]
Power integration comes before motion
The electrical guide calls out absent reverse-polarity protection, inrush management and avoiding hot-plugged XT30 connections. Braking returns energy to the DC bus, so a supply that can only source current may be insufficient. Regeneration settings, energy absorption and voltage headroom must be considered together for the selected load. Software limits alone do not establish a validated power system. [S006]
CAN wiring, termination and connector quality also matter, especially as the number of controllers increases. The guide recommends a different power-distribution arrangement beyond three devices on a chain. A controller purchase therefore does not cover the cost or design of a multi-joint power and communications system. [S006]
Configure, calibrate and then tune
The documented host tools include moteus-gui and its tview interface on Linux, Windows and macOS. Linux USB adapters may need device-access rules. These installation instructions were inspected but not executed. [S007]
Before motion, choose application-specific position, phase-current, velocity and acceleration limits, gear scaling and a unique CAN-FD ID. Bare boards leave default velocity and acceleration limits unset. Parameter edits are volatile until saved with conf write; a working session is not proof that its configuration will survive a restart. [S008]
Bare boards require calibration for the attached motor, repeated after a motor change or a change in its registration with the controller. The normal procedure rotates the unloaded motor in both directions and includes high-speed motion. Calibration power must suit the motor; the documented default is not appropriate for every size. Development kits are typically pre-calibrated, which does not carry over automatically to a modified motor assembly. Position-loop tuning follows calibration and should use physically achievable acceleration limits. [S009] [S010]
Firmware releases distinguish the application ELF from the CAN bootloader ELF. Normal CAN flashing uses the application image; bootloader recovery is a separate SWD procedure. The source-build guide specifies x86-64 Ubuntu 22.04, 24.04 or 26.04 and a Bazel route. Its printed dependency-install line is incomplete as a shell command, so this profile does not present that sequence as a tested installation recipe. [S011]
What is open, and what remains to be supplied
The repository declares Apache-2.0 for files unless otherwise noted and contains board designs, firmware, client software and documentation. External components and dependencies need their own license assessment; the project names also have a separate trademark policy. A complete delivered budget remains unknown because it depends on the selected board, motor, magnet, mounting, cooling, power equipment, adapter and tools. No board was manufactured, firmware flashed, motor calibrated or performance measured for this profile. [S001] [S003] [S005] [S006] [S007] [S012]
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 | available · Apache-2.0 Board mechanical drawings/models for selected revisions; not a complete motor, gearbox or robot design. Geometry not inspected. [S001] [S003] [S012] |
| electronics | available · Apache-2.0 Repository default unless otherwise noted; external dependencies and purchased parts retain their own terms. No manufacturing or execution verified. [S001] [S003] [S012] |
| firmware | available · Apache-2.0 Repository default unless otherwise noted; external dependencies and purchased parts retain their own terms. No manufacturing or execution verified. [S001] [S003] [S012] |
| software | available · Apache-2.0 Repository default unless otherwise noted; external dependencies and purchased parts retain their own terms. No manufacturing or execution verified. [S001] [S003] [S012] |
| documentation | available · Apache-2.0 Repository default unless otherwise noted; external dependencies and purchased parts retain their own terms. No manufacturing or execution verified. [S001] [S003] [S012] |
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 · mjbots / 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 · mjbots / project contributors
Repository revision and release metadata
Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2bSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S003 · mjbots / project contributors
Repository license
Accessed 2026-10-01 · LICENSESource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S004 · mjbots / project contributors
Pinned repository artifact inventory
Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b archive file inventorySource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S005 · mjbots / project contributors
docs/guides/mechanical-setup.md
Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b / docs/guides/mechanical-setup.mdSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S006 · mjbots / project contributors
docs/guides/electrical-setup.md
Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b / docs/guides/electrical-setup.mdSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S007 · mjbots / project contributors
docs/guides/software-installation.md
Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b / docs/guides/software-installation.mdSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S008 · mjbots / project contributors
docs/guides/configuration.md
Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b / docs/guides/configuration.mdSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S009 · mjbots / project contributors
docs/guides/calibration.md
Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b / docs/guides/calibration.mdSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S010 · mjbots / project contributors
docs/guides/pid-tuning.md
Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b / docs/guides/pid-tuning.mdSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S011 · mjbots / project contributors
docs/reference/firmware.md
Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b / docs/reference/firmware.mdSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S012 · mjbots / project contributors
Complete archive inventory
Accessed 2026-10-01 · Preserved archive file inventorySource 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