Skip to content

iDotMatrix WLED Usermod v0.9.2

Choose a tag to compare

@piggei piggei released this 30 Sep 14:56

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.