Open Source RoboticsRobots, software & learning

Wheelbot

Robot / hardware build

Reaction-wheel unicycle research platform, scoped to v2.5 CAD and firmware with a documented state-estimation error and historical development tools. [1]

Build & first use →Official websiteBill of materials

For
Controls researchers able to fabricate mechanics and commission embedded electronics [1]
Cost
No current cost yet. Upstream bill of materials [7]
Source rights
Named licenses are documented by part. Review licenses
Unknowns
host computer, operating system not fully established. Review gaps

Source researched · Not tested by us
Sources checked · Research details

Upstream illustration of the Wheelbot assembly and wheel arrangement, not a photograph.
Upstream illustration of the Wheelbot assembly and wheel arrangement, not a photograph. Andreas René Geist and Wheelbot contributors · GPL-3.0. Original image unchanged; displayed responsively.
Licenses & related hardware

Requirements · Research details and dates

On this page

Overview

Wheelbot is a reaction-wheel unicycle research platform. This entry covers the v2.5 repository, which supplies mechanical files, motherboard circuitry, embedded firmware and MATLAB/Simulink models. The README links a newer Mini Wheelbot as a separate design; its parts and instructions should not be silently substituted into a v2.5 build. [1] [2]

Is this for you?

Known limitations
  • Pinned firmware retains the body-rate transform identified as erroneous in the README
  • Mini Wheelbot is a separate newer design
  • Documented simulation and host tools are historical
  • No complete current configuration-specific robot budget verified

Code was inspected; no execution or repair validation.

[1] [5] [7] · Editorial assessment

3D preview

Wheelbot v2.5 source-positioned assembly. The complete Wheelbot v2.5 assembly represented by all 31 official STL exports in their shared source coordinate frame. Source directory groups and exported SolidWorks assembly-path names are retained. Display colors only distinguish part categories; joint kinematics, material identity and physical operation are not verified.

The 3D preview loads after the page.

Drag to orbit · Scroll or pinch to zoom · Right-drag to pan. Use the view buttons for front, side and top views. The tree shows names supplied by the source; unnamed bodies remain labeled as such.

Download original source-positioned STL bundle (ZIP) · File checksums and provenance

Separate bodies can be inspected in the model tree. Explode is a viewing aid, not an assembly sequence.

Source, license and scale

Source: Andre Rene Geist and Wheelbot contributors, revision cd3b0945aa3f41ca25f0ad4868fb214ecb8b4de7. Original and preview: GPL-3.0-only. Preview conversion by Open Source Robotics; source files unchanged inside the downloadable bundle. Preview coordinates are centered and rounded to six decimal places. All source STL components retain the shared assembly-coordinate vertices exported by the project; directory groups and assembly-path names are retained, and no component placement was inferred. No physical part tested.

Viewer: three-cad-viewer 5.0.7 (MIT license). Confirm scale and manufacturing settings before printing.

What you need

Dependencies
  • MATLAB/Simulink for documented simulation workflow
  • Maevarm M2 and uDriver-v2 hardware/firmware environment
  • Historical Python interface described on Ubuntu 18.04

[1]

Tools
  • Markforged Onyx One with Onyx material in documented print setup
  • Fabrication of copper reaction-wheel rings
  • MATLAB/Simulink R2020a recommended by upstream
  • Embedded firmware development and board assembly tools

First three are documented; fabrication/embedded skills follow the supplied artifacts.

[1] · Editorial assessment

Hardware & parts

Upstream bill of materials [7]

Hardware configuration

Reaction-wheel unicycle, reviewed at the v2.5 design.

[1]

Controller

Maevarm M2 on the robot motherboard and a separate M2 wireless dongle; uDriver-v2 motor-control dependency.

[1]

Assembly & first use

Project documentation [1]

  • Select v2.5 rather than the linked Mini Wheelbot design
  • Inspect the assembly, board files and component list
  • Reconcile the documented body-rate transform erratum with the selected firmware
  • Prepare simulation using the upstream LQR-design step before the Simulink model
  • Commission hardware only after configuration and implementation review

Editorial research sequence; no build, simulation or commissioning performed.

[1] [5] [6] [7] · Editorial assessment

Assembly

STL parts, copper-ring drawing and interactive assembly PDF supplied; motherboard circuitry and component spreadsheet are separate from a complete robot parts budget.

[1] [6] [7]

Cost

No current, complete configuration-specific build cost has been established for this profile.

Project notes

The archived firmware has a published erratum

The README identifies an incorrect transform from averaged body rates to Euler rates in the original state estimator. The inspected main.c still contains the matrix described as erroneous. Upstream explains that its experiments stayed close to the upright equilibrium, where the transforms were nearly equal; that explanation is not a general validation of the implementation away from upright. The repository includes a notebook explaining the corrected calculation. [1] [5] [6]

Before using this snapshot for a new experiment, reconcile the erratum with the selected firmware and verify the resulting estimator. This publication has not patched, compiled or tested a correction. The known implementation issue is distinct from the broader absence of a reproduction test. [1] [5]

Fabrication includes more than printed parts

The documented print setup uses a Markforged Onyx One, Onyx material and 0.2 mm layers. The mechanical folder also supplies a drawing for cut copper reaction-wheel rings and an interactive assembly PDF. These are useful manufacturing references, but they do not establish that a different print material or an unreviewed wheel substitution will preserve the intended mechanics. [1] [6]

The motherboard connects to a Maevarm M2 and supplies the uDriver-v2. A separate M2 dongle handles wireless communication with the computer. The archived spreadsheet lists motherboard components, package names and part references; it is not a complete robot BOM or a current delivered-build quote. The full cost remains unknown. [1] [7]

Preserve the development environment with the design

The simulation folder separates symbolic dynamics derivation from the Simulink model used for estimator and LQR tuning. The README recommends MATLAB R2020a and says to run the LQR-design step (s00_designLQR) before running s01_unicycle.slx. It describes the Python computer interface on Ubuntu 18.04. Those are historical setup details, not evidence of compatibility with current tool versions. [1]

The repository includes a GPL v3 license. External boards, software libraries and development tools require their own rights and availability checks. This profile records a useful research design and a concrete estimator issue; no manufacturing, firmware build, simulation or physical balancing experiment was performed. [3]

What we checked

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

Not yet established

  • Requirements: operating system, host computer

Updates

Upstream last updated
Mar 4, 2025 [2]
Latest release
Not established
Profile updated
Oct 25, 2026
Sources last checked
Oct 1, 2026
Next review
Oct 31, 2026
Reviewed revision
cd3b0945aa3f41ca25f0ad4868fb214ecb8b4de7 (commit snapshot; no published stable release found) · combined hardware and software repository

Source files and licenses

Available project sources support research coverage; complete build and commercial qualification remain separate.

LayerAvailability / license
mechanical designavailable · GPL-3.0-only
Root GPL v3 license accompanies this archive; external libraries, purchased boards and tools retain separate terms. [1] [3] [6]
electronicsavailable · GPL-3.0-only
Root GPL v3 license accompanies this archive; external libraries, purchased boards and tools retain separate terms. [1] [3] [6]
firmwareavailable · GPL-3.0-only
Root GPL v3 license accompanies this archive; external libraries, purchased boards and tools retain separate terms. [1] [3] [6]
softwareavailable · GPL-3.0-only
Root GPL v3 license accompanies this archive; external libraries, purchased boards and tools retain separate terms. [1] [3] [6]
documentationavailable · GPL-3.0-only
Root GPL v3 license accompanies this archive; external libraries, purchased boards and tools retain separate terms. [1] [3] [6]

This profile selects the mechanical/control research platform, not a learned policy or dataset.

References

Each source links to the exact revision we read. “Used for” shows where this page relies on it.

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

Change history

2026-10-25 — Added an attributed upstream image with linked reuse terms; technical evidence dates unchanged.