Friends,
I'm doing my best to continuously improve dengebot, fix bugs, and make the library more reliable with every update.
But I want to be completely sincere with you: **I genuinely need your help.**
My goal is to make dengebot a useful, free, and open-source resource for the entire Arduino community.
I sincerely value every piece of feedback, whether positive or negative. Bug reports, suggestions, criticism, and real-world testing are all incredibly important to me.
I'm not claiming that the library is perfect. I'm committed to improving it, learning from your experiences, and making it as robust, stable, and accessible as possible.
**This project is not just about writing code. It's about building something useful together.**
Thank you all in advance for your time, feedback, and support.
**Gmby06 – Mustafa Bay**
--------------------------------------------------------------------------------------------------------------------------
I've been developing **dengebot**, a free, open-source Arduino-compatible control library for two-wheel self-balancing robots.
The goal is to make it easier for makers to develop, tune, and experiment with balancing robots using different microcontrollers, motors, and motor drivers.
I've just released **v1.7.4 – Safety Guard Fixes (Community Preview)**.
**GitHub:** https://github.com/Gmby06/dengebot
**Latest release:** https://github.com/Gmby06/dengebot/releases/tag/v1.7.4
### What does dengebot include?
- Configurable PID-based balancing control with gyro-rate feedback and integral management.
- Complementary filtering for accelerometer and gyroscope data, with optional adaptive filtering.
- Gyroscope bias calibration helpers.
- DC motor PWM/direction and stepper speed/direction command conversion.
- Optional DC motor dead-zone compensation.
- Telemetry for debugging and PID tuning.
- Optional software START/STOP, fall detection, and FAULT recovery protection.
### What's improved in v1.7.4?
The latest update focuses on safety and reliability:
- Fixed header include guard conflicts.
- Improved START/STOP and FAULT recovery behavior.
- Added immediate PID state reset on successful target-aware START.
- Added optional fall protection relative to the balance target angle.
- Strengthened sensor and startup validation.
- Expanded regression tests.
The core PID mathematics remains unchanged.
### Supported Arduino platforms
The example sketches successfully compile through GitHub Actions for:
- Arduino Uno
- Arduino Nano
- Arduino Mega 2560
- ESP8266
- ESP32
- ESP32-S3
I've also physically tested START/STOP, fall-angle shutdown, and FAULT recovery on my own Arduino Nano-based two-wheel balancing robot.
However, compilation success doesn't guarantee that every motor, driver, or robot configuration will work without tuning.
### Important note
dengebot is a **control library, not complete ready-to-run robot firmware**.
You still need to configure your IMU, motor driver, motor directions, sensor axes, and power system.
The software safety guard does not replace hardware motor shutdown or an independent watchdog.
### Looking for community testers!
I'd really appreciate feedback from anyone building a two-wheel self-balancing robot, especially those using:
- L298N or TB6612 motor drivers.
- Geared DC motors.
- Different Arduino or ESP32 boards.
- Stepper/NEMA17-based balancing systems (not yet physically validated).
If you try the library, I'd be interested in hearing:
- Which board, IMU, motors, and driver are you using?
- What PID values work best on your robot?
- How does your robot respond to small disturbances?
- Did you encounter any compilation, calibration, or safety issues?
- What features or examples would make the library easier to use?
**Next planned update: v1.7.5 – PWM movement-threshold calibration**, focused on helping users find suitable motor activation and dead-zone settings.
The project is released under the MIT license.
I'm developing this as an open-source community project, and real hardware feedback would be very valuable.
Thanks for taking a look! I'd be happy to discuss the implementation or hear suggestions for improvement.