Repository navigation
v1.7.4 – Safety Guard Fixes
Pre-release
Pre-release
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.