Open Source RoboticsRobots, software & field notes

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

DetailDescription
TypeMotor controller board; motor and mechanism supplied separately
Reported by source [S001] · Checked 2026-10-01
Intended usersRobotics developers integrating brushless motors and feedback
Editorial assessment [S001] · Checked 2026-10-01
AssemblyNot known
CalibrationBare 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 systemLinux; Windows; macOS
Documented host tools; firmware source build has separate Ubuntu requirements.
Reported by source [S007] · Checked 2026-10-01
Computer neededHost 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.

LayerAvailability / license
mechanical designavailable · Apache-2.0
Board mechanical drawings/models for selected revisions; not a complete motor, gearbox or robot design. Geometry not inspected. [S001] [S003] [S012]
electronicsavailable · 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]
firmwareavailable · 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]
softwareavailable · 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]
documentationavailable · 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.

  1. S001 · mjbots / project contributors
    Upstream project overview
    Accessed 2026-10-01 · README.md
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  2. S002 · mjbots / project contributors
    Repository revision and release metadata
    Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  3. S003 · mjbots / project contributors
    Repository license
    Accessed 2026-10-01 · LICENSE
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  4. S004 · mjbots / project contributors
    Pinned repository artifact inventory
    Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b archive file inventory
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  5. S005 · mjbots / project contributors
    docs/guides/mechanical-setup.md
    Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b / docs/guides/mechanical-setup.md
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  6. S006 · mjbots / project contributors
    docs/guides/electrical-setup.md
    Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b / docs/guides/electrical-setup.md
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  7. S007 · mjbots / project contributors
    docs/guides/software-installation.md
    Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b / docs/guides/software-installation.md
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  8. S008 · mjbots / project contributors
    docs/guides/configuration.md
    Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b / docs/guides/configuration.md
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  9. S009 · mjbots / project contributors
    docs/guides/calibration.md
    Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b / docs/guides/calibration.md
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  10. S010 · mjbots / project contributors
    docs/guides/pid-tuning.md
    Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b / docs/guides/pid-tuning.md
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  11. S011 · mjbots / project contributors
    docs/reference/firmware.md
    Accessed 2026-10-01 · fdc6e318194443213c669d28d72e40be38147d2b / docs/reference/firmware.md
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  12. S012 · mjbots / project contributors
    Complete archive inventory
    Accessed 2026-10-01 · Preserved archive file inventory
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

Research and review details

Source research only; no installation, physical build or performance test performed. No affiliate links added.

Profile edited 2026-10-01 · Sources checked 2026-10-01 · Next review target 2026-10-31

Revision: fdc6e318194443213c669d28d72e40be38147d2b (release rust/v0.5.5). Combined hardware and software repository activity recorded 2026-09-04 [S002]

Correction guidance · Discussion is not enabled · Profile format 0.6.0-draft.1

Change history