Repository navigation
iDotMatrix WLED Usermod v0.9.2
Version 0.9.2 improves the iDotMatrix compatibility layer with configurable active/passive buzzer support, persistent Clock preferences, and related configuration and runtime improvements.
Highlights
- Added support for both active and passive buzzers.
- Added configurable passive buzzer trigger polarity:
- High
- Low
- Added hardware LEDC tone generation for passive buzzers at 2 kHz.
- Added safe idle-level handling for low-level-trigger passive buzzer modules.
- Added buzzer feedback for:
- BLE connection
- Countdown completion
- Alarm
- Program / Schedule
- Improved buzzer timing using the ESP32 high-resolution timer to keep sound patterns stable under WLED, BLE, filesystem and media workloads.
- Added Clock preference persistence across reboot.
- Improved the Usermod configuration interface for buzzer settings.
Buzzer support
v0.9.2 contains the buzzer implementation directly inside the iDotMatrix Usermod.
The configuration supports:
- Buzzer GPIO
- Active or Passive buzzer type
- Active-buzzer polarity
- Passive-buzzer trigger polarity
- Test buzzer
Passive buzzer operation uses hardware LEDC at approximately 2 kHz.
Special handling is included for low-level-trigger modules so the GPIO returns to the electrically safe idle state after playback.
Clock persistence
Clock preferences are now persisted and restored during startup before a boot/fallback Clock is rendered.
Persisted settings include:
- Clock style
- 12/24-hour mode
- Show-date option
- Clock color settings
The iDotMatrix reset command also clears the persisted Clock preferences.
Buzzer timing improvements
Alarm and Program / Schedule playback was hardened to avoid timing irregularities caused by media loading and normal WLED loop activity.
On ESP32, buzzer timing uses esp_timer, decoupling sound sequencing from the normal WLED loop and providing stable playback even while other iDotMatrix features are active.