Skip to content

Physical Buttons

PuffiAir is equipped with two physical buttons that allow you to control LED indicators and voice alerts directly from the device — no need to access the web interface.

Button 1 — LED Toggle

  • Short Press:\ Toggles the RGB status LED on or off.
  • When ON, the LED shows air quality using color codes:
    • 🟢 Green — Normal air quality
    • 🟡 Yellow — Near warning level
    • 🔴 Red — Dangerous level detected
  • When OFF, the LED remains off regardless of air quality.
  • Long Press (approx. 10 seconds):\ Enters Wi-Fi Configuration Mode (AP Mode):
  • The top LED begins blinking
  • A Wi-Fi hotspot named PuffiAir_Config will appear
  • Connect to the hotspot and open http://192.168.4.1 in a browser to configure Wi-Fi and MQTT
  • Auto Exit After 15 Minutes:\ If no connection is made within 15 minutes, the device will automatically exit AP mode and return to normal operation

Button 2 — Mute (Speaker Control)

  • Short Press:\ Toggles the voice alert speaker on or off
  • First press: Mute the voice alerts — no sound will play during danger levels
  • Press again: Unmute — voice warnings will resume when danger is detected
  • The mute state is persistent and remains active until toggled again or the device is reset
  • The mute state may be reset after reboot, depending on firmware version.
  • These buttons work even without network or MQTT connected.