Wheelbot
Based on published sources · Not tested by us ·
Overview
Reaction-wheel unicycle research platform, scoped to v2.5 CAD and firmware with a documented state-estimation error and historical development tools. [S001]
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. [S001] [S002]
Specifications
| Detail | Description |
|---|---|
| Type | Reaction-wheel unicycle, reviewed at the v2.5 design. Reported by source [S001] · Checked 2026-10-01 |
| Intended users | Controls researchers able to fabricate mechanics and commission embedded electronics Editorial assessment [S001] · Checked 2026-10-01 |
| Assembly | STL parts, copper-ring drawing and interactive assembly PDF supplied; motherboard circuitry and component spreadsheet are separate from a complete robot parts budget. Reported by source [S001] [S006] [S007] · Checked 2026-10-01 |
| Calibration | Not known |
| Operating system | Not known |
| Computer needed | Not known |
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
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. [S001] [S005] [S006]
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. [S001] [S005]
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. [S001] [S006]
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. [S001] [S007]
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. [S001]
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. [S003]
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 · GPL-3.0-only Root GPL v3 license accompanies this archive; external libraries, purchased boards and tools retain separate terms. [S001] [S003] [S006] |
| electronics | available · GPL-3.0-only Root GPL v3 license accompanies this archive; external libraries, purchased boards and tools retain separate terms. [S001] [S003] [S006] |
| firmware | available · GPL-3.0-only Root GPL v3 license accompanies this archive; external libraries, purchased boards and tools retain separate terms. [S001] [S003] [S006] |
| software | available · GPL-3.0-only Root GPL v3 license accompanies this archive; external libraries, purchased boards and tools retain separate terms. [S001] [S003] [S006] |
| documentation | available · GPL-3.0-only Root GPL v3 license accompanies this archive; external libraries, purchased boards and tools retain separate terms. [S001] [S003] [S006] |
This profile selects the mechanical/control research platform, not a learned policy or dataset.
References
Links identify the documentation and revisions used in this profile. Access dates record when each source was retrieved.
- S001 · AndReGeist / 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 · AndReGeist / project contributors
Repository revision and release metadata
Accessed 2026-10-01 · cd3b0945aa3f41ca25f0ad4868fb214ecb8b4de7Source notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S003 · AndReGeist / project contributors
Repository license
Accessed 2026-10-01 · LICENSESource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S004 · AndReGeist / project contributors
Pinned repository artifact inventory
Accessed 2026-10-01 · cd3b0945aa3f41ca25f0ad4868fb214ecb8b4de7 archive file inventorySource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S005 · AndReGeist / project contributors
Wheelbot v2.5 firmware
Accessed 2026-10-01 · cd3b0945aa3f41ca25f0ad4868fb214ecb8b4de7 / body-rate transform at lines 334-350Source notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S006 · AndReGeist / project contributors
Wheelbot archive inventory
Accessed 2026-10-01 · Preserved filenames; not a completeness or manufacturing testSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S007 · AndReGeist / project contributors
Motherboard component spreadsheet
Accessed 2026-10-01 · Extracted cell values from pinned XLSX; board list, not complete robot BOMSource 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