Open Source RoboticsRobots, software & learning

Bobble-Bot

Robot / hardware build

Two-wheel balancing robot with ROS 1 control and Gazebo simulation sources; physical construction uses custom motor drives, a Pi CAN shield and power distribution board. [1] [5] [6]

Build & first use →Official websiteBill of materials

For
ROS users studying balance control and experienced builders able to reconcile custom electronics [1]
Cost
No current cost yet. Upstream bill of materials [6]
Source rights
Some licenses are unresolved. Review licenses
Unknowns
tools not fully established. Review gaps

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

Upstream CAD illustration of Bobble-Bot, not a photograph.
Upstream CAD illustration of Bobble-Bot, not a photograph. S.O. Engineering, LLC and Bobble-Bot contributors · BSD-3-Clause. Original image unchanged; displayed responsively. Preview re-encoded for faster display; the link opens the original file.
Licenses & related hardware
License
BSD-3-Clause · license not fully assessed for mechanical design · Details by part

Requirements · Research details and dates

On this page

Overview

Bobble-Bot is a two-wheel balancing robot whose released controller repository includes ROS 1 balance logic, Gazebo simulation and analysis tools. The maintainer recommends starting with simulation. The physical BB2 design adds a Raspberry Pi 3B, custom CAN shield, power distribution board and two Chupacabra servo drives; those are additional reproduction requirements, not components supplied by the simulator. [1] [5] [6]

Is this for you?

Known limitations
  • Physical custom board design and firmware completeness not established
  • Historical BOM has missing prices and document discrepancies
  • Simulator settings do not validate physical operating limits
  • No build or balancing reproduction performed

[1] [5] [6] [8] [9]

3D preview

Bobble-Bot simulation assembly. The Gazebo source configuration at zero joint positions, including its supplied battery, electronics and camera representations. It is visualization geometry, not a complete manufacturing package.

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 URDF source 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: S.O. Engineering, LLC / Bobble-Bot contributors, revision b7db2607759d256b1bcf729ab943d1794c2774d2. Original and preview: BSD-3-Clause. Preview conversion by Open Source Robotics; source files unchanged inside the downloadable bundle. Preview coordinates are centered and rounded to six decimal places. URDF visual origins, mesh scales and joint transforms applied at zero joint positions, then metres converted to millimetres. No physical part tested.

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

What you need

Operating system
  • ROS 1 Melodic environment for the documented simulator

Other ROS versions are not officially supported in the selected README; current installation not tested.

[1]

Host computer

ROS/Gazebo workstation for simulation; Raspberry Pi 3B for the documented physical robot.

[1] [6]

Dependencies
  • ROS 1 Melodic
  • Gazebo and Hector Gazebo plugins
  • bobble_description repository
  • catkin and Python analysis packages

[1] [10]

Hardware & parts

Upstream bill of materials [6]

Hardware configuration

Two-wheel inverted-pendulum balancing robot.

[1]

Actuators
  • Two Turnigy Multistar 4822-690kV 22-pole BLDC motors in the BB2 BOM

Harness overview separately labels motors TACON; reconcile document revisions before procurement.

[6]

Controller

Raspberry Pi 3B with custom SOE CAN shield, PDU and two Chupacabra servo drives.

[5] [6] [7]

Sensors
  • AS5047D wheel position sensors
  • DFRobot SEN0140 IMU in the physical BOM

[6] [7]

Assembly & first use

Project documentation [1]

Assembly

Printed structural components, heat-set inserts, custom electronics and fabricated cable harnesses.

[5] [6] [7] [8]

Calibration

Keep simulation controller gains separate from physical motor, encoder, IMU and safety-board commissioning.

Editorial distinction from InSim configuration and physical hardware description; no commissioning performed.

[5] [9] · Editorial assessment

Cost

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

Project notes

Preserve both simulation repositories

The documented source build uses ROS Melodic, Gazebo, Hector Gazebo plugins and catkin, with both bobble_controllers and bobble_description cloned into one workspace. This review preserved the controller revision recorded in the profile and description commit b7db2607759d256b1bcf729ab943d1794c2774d2. They were not built or tested together. The README's generic clones and unpinned Python packages do not constitute a locked environment. [1] [2] [10]

Keyboard control requires its terminal to have focus and uses the space bar to activate the balance controller. The upstream impulse-response example records a ROS bag, then generates tilt and velocity plots. That gives readers a defined simulation experiment to investigate; this review did not execute it or reproduce the published plots. [1]

Simulation parameters are not hardware limits

config/bobble_sim_balance_control.yaml selects BalanceSimController with InSim: true, a 500 Hz control-loop setting, 0.05 m wheel radius and starting/maximum tilt settings of 10/20 degrees. These are source configuration values. They do not establish a measured loop rate, physical stability envelope or tested stopping behavior. The file's IMU name is bno055, while the physical BOM names a DFRobot SEN0140; preserve the distinction when mapping a real device. [6] [9]

The documented Docker graphics route historically required an NVIDIA GPU; its headless route did not require graphics. The container payload and its current compatibility were not validated here. [1]

The historical BOM is useful but not a complete quote

The preserved BB2 workbook lists printed part numbers, fasteners, a 4S 5000 mAh battery, two Turnigy Multistar 4822-690kV motors, wheel encoders and the custom boards. Several board and encoder prices are blank. Some fastener prices are for packs rather than quantities consumed, and cell I26 sums only H20:H26. That subtotal is not the cost of a complete robot. No current regional availability or delivered total was verified. [6]

The six-page assembly document identifies mirrored actuator parts, the central bulkhead, electronics mounts and IMU placement. Its exploded actuator drawing connects the wheel, motor, AS5047D sensor and Chupacabra drive. These instructions help interpret the parts list, but they do not by themselves supply complete editable designs and firmware for every custom board. [7]

Reconcile the wiring documents before procurement

The cable-harness document identifies power, CAN, encoder, IMU and PDU-enable connections. It also contains discrepancies that should be resolved against the actual hardware revision: its overview labels the motors TACON while the BOM and assembly document specify Turnigy Multistar. On page 5, the IMU harness parts list names connector 5023800900, while the four-pin drawing labels it 5023800400. This review preserves both readings and does not choose a replacement part or validate a wiring procedure. [6] [7] [8]

The controller and description repositories carry BSD 3-Clause notices. The external BOM and assembly files are available to read, but their redistribution terms and a complete matching hardware source set were not established. The profile therefore covers a useful open simulation/control project with documented physical hardware, rather than claiming a fully reproduced or commercially qualified build. No installation, fabrication, wiring or balancing test was performed. [3] [5] [11] [12]

What we checked

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

Not yet established

  • Requirements: tools
  • A step-by-step setup summary

Updates

Upstream last updated
Dec 5, 2021 [2]
Latest release
Not established
Profile updated
Oct 25, 2026
Sources last checked
Oct 1, 2026
Next review
Oct 31, 2026
Reviewed revision
07ea4f9f1282d4e2cf5cc423aee7b5e0621a10c7 (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 · License not fully assessed
Robot description/model repository preserved under BSD-3-Clause software notice; manufacturing completeness and hardware-specific rights unresolved. [10] [11]
electronicsnot found · License not fully assessed
Custom Chupacabra, CAN shield and PDU are documented, but complete matching editable board source and device firmware were not established by this review. [5] [6] [8] [12]
firmwarenot found · License not fully assessed
Custom Chupacabra, CAN shield and PDU are documented, but complete matching editable board source and device firmware were not established by this review. [5] [6] [8] [12]
softwareavailable · BSD-3-Clause
Balance controller and simulation software; external ROS, Gazebo and dependencies retain separate terms. [1] [3]
documentationavailable · BSD-3-Clause
Repository documentation only; separate Hackaday PDF/BOM rights were not established. [1] [3]

Selected feedback-control and simulation workflow needs no pretrained policy or dataset.

References

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

Project sources

Videos

  • S013 Bobble On, Bobble-Bot - Hackaday Prize 2019 (YouTube video)
    Video from the project’s own channel (Super Owesome), linked from the project’s own documentation. Not reviewed by us for accuracy.
    Revision, date & where cited

    YouTube video Super Owesome · youtube.com · Accessed Oct 4, 2026

  • S014 Bobble Bot Assembly (YouTube video)
    Video from the project’s own channel (Super Owesome), linked from the project’s own documentation. Not reviewed by us for accuracy.
    Revision, date & where cited

    YouTube video Super Owesome · youtube.com · Accessed Oct 4, 2026

  • S015 Bobblebot Drive without Inductors (YouTube video)
    Video from the project’s own channel (Super Owesome), linked from the project’s own documentation. Not reviewed by us for accuracy.
    Revision, date & where cited

    YouTube video Super Owesome · youtube.com · Accessed Oct 4, 2026

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

Change history

2026-10-04 — Added 3 YouTube reference(s) (S013, S014, S015): official channel or videos linked from the pinned upstream sources. Existing claims, source-check dates and evidence are unchanged.

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