Skip to content

Releases

v1.7.6 — A4988 & DRV8825 STEP/DIR Support

Choose a tag to compare

@Gmby06 Gmby06 released this 05 Nov 19:15
66611f6

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

Pre-release

Choose a tag to compare

@Gmby06 Gmby06 released this 02 Nov 15:51
fb8b939
  • 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

Pre-release

Choose a tag to compare

@Gmby06 Gmby06 released this 31 Oct 15:37
ede9dd1

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

Pre-release

Choose a tag to compare

@Gmby06 Gmby06 released this 31 Oct 01:59
8345686

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 EDASafetyGuard for 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.

https://github.com/Gmby06/dengebot/issues

dengebot v1.7.2 – Dead-Zone Compensation (Community Preview)

Choose a tag to compare

@Gmby06 Gmby06 released this 29 Oct 21:18
577ac9d

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 DeadZoneDemo example.

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

Choose a tag to compare

@Gmby06 Gmby06 released this 28 Oct 23:26
4d8bcd6

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 EDAGyroBiasCalibrator helper.
  • Supports stationary gyroscope bias measurement.
  • Rejects invalid or excessive-motion calibration samples.
  • Allows calibrated bias compensation in the complementary filter.
  • Includes a new GyroBiasCalibrationDemo example.

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:

  • BasicBalance
  • MotorCommandDemo
  • FilterTelemetryDemo
  • GyroBiasCalibrationDemo

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

Choose a tag to compare

@Gmby06 Gmby06 released this 25 Oct 14:26
1f2380b

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!