Repository navigation
Releases
v1.7.6 — A4988 & DRV8825 STEP/DIR Support
dengebot v1.7.6 — A4988 & DRV8825 STEP/DIR Support
Added separate A4988 and DRV8825 motor driver demos and applied the necessary fixes.
Changes
- Added separate ESP32 A4988 and DRV8825 STEP/DIR demos.
- Cleaned up duplicate example directories.
- Updated documentation and driver compatibility notes.
- Extended GitHub Actions to test ESP32 2.0.17 and 3.0.7.
- Fixed the Gemma AVR core dependency.
Validation
- Host tests: PASS
- Arduino board compilation: PASS
- ESP32 and ESP32-S3 compilation: PASS
Note: Hardware testing of A4988 and DRV8825 motor drivers is still in progress. This release is marked as a pre-release.
v1.7.5 — Safe PWM Motor Calibration
- Add safe four-direction PWM motor calibration
- Set calibration demo pulse duration to 150 ms
- Improve motor safety and timeout handling
- Update examples, regression tests, README and CHANGELOG
- Prepare v1.7.5
v1.7.4 – Safety Guard Fixes
This release focuses on improving safety, reliability, and fault recovery for two-wheel self-balancing robots using the dengebot Arduino library.
What's New and Improved
- Fixed Header Conflicts: Resolved include guard conflicts between public and internal library headers.
- Safer START/STOP Handling: Improved controller initialization and PID state reset during safe re-arming.
- Target-Relative Fall Protection: Added optional
setMaxAbsErrorDeg()to detect excessive tilt relative to the configured balance target. - Improved FAULT Recovery: Strengthened validation when restarting after a safety fault, without requiring a board reboot.
- Enhanced Sensor Safety: Improved validation of sensor readings and startup conditions.
- Expanded Regression Testing: Added safety-focused tests and improved Arduino compilation coverage.
Compatibility
The library supports the Arduino framework on:
- Arduino Uno
- Arduino Nano
- Arduino Mega 2560
- ESP8266
- ESP32
- ESP32-S3
GitHub Actions: All six board configurations passed.
Physical Testing
Safety behavior was tested on an Arduino Nano-based two-wheel balancing robot, including:
- START and STOP operation
- Fall-angle protection
- FAULT detection and recovery
- Restarting safely without rebooting
These results reflect the tested hardware configuration; additional community testing is encouraged.
Important Safety Notice
dengebot provides software-level safety mechanisms. Applications must still properly disable motor-driver EN/PWM outputs during STOP or FAULT conditions.
For safety-critical applications, additional independent hardware protection and watchdog mechanisms are recommended.
v1.7.3 – STOP/FAULT Safety Update
dengebot v1.7.3 – STOP/FAULT Safety Update
Community Preview | Arduino Balancing Robot Library
This release introduces optional safety management and controlled fault recovery for two-wheel balancing robots.
What's New
- Added optional
EDASafetyGuardfor STOP/FAULT management. - Added fall-angle and sensor timeout protection.
- Added safe recovery from a latched FAULT using
requestStart(), without rebooting the controller. - Added safety examples and regression tests.
- Preserved existing PID control algorithms and APIs.
Compatibility and Testing
- GitHub Actions: All checks passed.
- Compilation tested across multiple AVR, ESP8266, and ESP32 board configurations.
- START/STOP, fall-angle shutdown, and safe restart after FAULT tested on an Arduino Nano balancing robot.
Important Safety Note
The library does not directly disable physical motor-driver outputs. Applications must implement appropriate motor shutdown behavior.
Hardware validation has been performed on a limited configuration. Other hardware combinations require independent testing.
Coming Next — v1.7.4
PWM threshold calibration and motor dead-zone improvements.
Community Feedback
Testing and feedback are welcome!
Please share your board, IMU, motor driver, motor type, and test results.
dengebot v1.7.2 – Dead-Zone Compensation (Community Preview)
dengebot v1.7.2 – Dead-Zone Compensation
This community preview introduces optional dead-zone compensation for two-wheel balancing robot motor control.
What's New
- Added optional dead-zone compensation to help overcome motor startup dead zones.
- Introduced the unified
#include <dengebot.h>header for easier integration. - Preserved the existing controller API and safety features.
- Added a
DeadZoneDemoexample.
Compatibility and Testing
- Successfully compiled for 18 Arduino board profiles across AVR, ESP32, and ESP8266 families.
- GitHub Actions automated tests passed.
- Dead-zone compensation was tested on an Arduino Nano-based balancing robot.
Community Testing
We welcome feedback from the Arduino and robotics community.
Please share your board, IMU, motor driver, motor type, configuration, and test results.
Report issues or suggestions here:
https://github.com/Gmby06/dengebot/issues
Note: This is a community preview. Compilation compatibility does not guarantee successful operation on every hardware configuration.
dengebot v1.7.1 — Adaptive Sensor Fusion & Stability Improvements
dengebot v1.7.1 — Adaptive Sensor Fusion & Stability Improvements
Community Preview | Arduino Balancing Robot Library
We're pleased to introduce dengebot v1.7.1, featuring adaptive sensor fusion, gyroscope bias calibration, expanded telemetry, and improved reliability for two-wheel self-balancing robots.
This release builds on v1.6.1 while preserving the existing PID controller and motor command behavior.
What's New in v1.7.1
1. Adaptive Complementary Filter
- Combines accelerometer and gyroscope measurements for pitch estimation.
- Optional adaptive alpha switching between 0.980 and 0.998.
- Acceleration-magnitude-based switching with hysteresis.
- Updated default thresholds: 0.03 g activation / 0.02 g deactivation.
- Preserves the original fixed-alpha filtering API.
- Provides
usedAlpha()for monitoring filter behavior.
Adaptive filtering remains disabled by default for backward compatibility.
2. Gyroscope Bias Calibration
- New
EDAGyroBiasCalibratorhelper. - Supports stationary gyroscope bias measurement.
- Rejects invalid or excessive-motion calibration samples.
- Allows calibrated bias compensation in the complementary filter.
- Includes a new
GyroBiasCalibrationDemoexample.
3. Extended Telemetry and Diagnostics
- New lightweight telemetry support for embedded systems.
- CSV output for sensor and controller analysis.
- Optional reference pitch angle.
- Event codes for recording test events.
- Sensor timestamps and active alpha reporting.
- Extended CSV output works without a reference angle.
4. Reliability and Safety Improvements
- Improved adaptive-alpha configuration validation.
- Protection against inverted normal/high-alpha settings.
- Validation of sensor values and time intervals.
- Shared portable floating-point validation utilities.
- Existing PID fault handling and motor safety behavior retained.
5. Examples and Testing
Includes four Arduino examples:
BasicBalanceMotorCommandDemoFilterTelemetryDemoGyroBiasCalibrationDemo
Host regression tests cover the controller, motor conversion, filtering, telemetry, and gyro calibration functionality.
Simulation Results
In a 50-scenario inverted-pendulum simulation, the updated adaptive filter reduced average peak pitch-estimation error during the first second after a disturbance:
| Configuration | Average peak estimation error |
|---|---|
| Fixed alpha 0.980 | 4.95° |
| Adaptive alpha, previous thresholds | 4.92° |
| Adaptive alpha, v1.7.1 thresholds | 1.92° |
This represents approximately a 61% reduction compared with fixed alpha 0.980 under the simulated conditions.
Gyroscope bias calibration also reduced simulated true upright-angle deviation from 0.48° to 0.25° for the adaptive configuration.
Important: These are model-dependent simulation results, not guaranteed improvements on physical robots. Sensor vibration, mechanical configuration, motor characteristics, and calibration can affect performance.
Compatibility
Designed for Arduino-compatible platforms including:
- Arduino Nano / Uno / Mega 2560
- ESP8266
- ESP32
- ESP32-S3
The existing PID core and motor command conversion remain unchanged. Physical compatibility and behavior depend on the selected board, sensors, drivers, and application code.
Development Status
This is a Community Preview release. Host tests and simulations have been performed, and initial user-reported robot testing is encouraging. Comprehensive physical validation of adaptive sensor fusion is still in progress.
We welcome community feedback, hardware testing, bug reports, and contributions.
Repository: https://github.com/Gmby06/dengebot
License: MIT
Balancing Robot - dengebot v1.6.1 - Community Preview
dengebot v1.6.1 — Community Preview
The first public community preview of dengebot, an Arduino-compatible control library for two-wheeled self-balancing robots.
Features
- Gyroscope-based PID control
- Configurable anti-windup and fault handling
- Hardware-independent motor command helpers
- DC motor PWM and stepper velocity command conversion
- Automated host regression and safety tests
- Arduino compilation checks for Uno, Nano, Mega, ESP8266, ESP32 and ESP32-S3
Community Testing
We invite makers, students, robotics enthusiasts and developers worldwide to test dengebot on their own hardware.
Please share your results through GitHub Issues, including your board, IMU sensor, motor driver, motor type, PID settings and observed balancing behavior.
Important Notes
This is an experimental community preview, not a production-ready motor control system.
Successful compilation and host tests do not guarantee stable physical balancing. Stepper pulse generation and NEMA 17 balancing have not yet been physically validated.
License
MIT License.
Special acknowledgment to Brett Beauregard and the Arduino PID_v1 project for their contributions to the Arduino PID community.
We welcome bug reports, suggestions, test results and contributions!