Skip to content

Configuration Details

Language Selection

Choose your preferred language from the dropdown menu. The page will update instantly based on your selection.

setuppage

Wi-Fi Configuration

Wi-Fi SSID Enter the name of your Wi-Fi network (⚠️PuffiAir only supports 2.4GHz networks.)
Wi-Fi Password Enter the password for your Wi-Fi network.

MQTT Settings (for Home Assistant or other platforms)

MQTT Server Specify your MQTT broker address (e.g., `192.168.1.10` or `mqtt.example.com`).
MQTT User (optional) Enter your MQTT username, if authentication is required. Leave blank otherwise.
MQTT Password (optional) Enter the password for the MQTT user account, if used.
MQTT Port The default is 1883. Change it only if your broker uses a different port.

Sensor Readings (Read-only)

Shows the current temperature in degrees Celsius.

Shows the current temperature in degrees Celsius.

Sensor Calibration (Temp & Humi)

Enter a correction value to adjust the temperature reading.\ E.g., enter -1 if the sensor reads 1°C too high.

Enter a correction value to fine-tune the humidity reading.\ E.g., enter +5 to add 5% to the current humidity reading.

Info

Click here for more information.

Save Buttons

Saves all settings: Wi-Fi, MQTT, and offset values. The device will reboot and attempt to connect using the new settings.

Saves only the temperature and humidity offsets without restarting the device.

Manual CO2 Calibration

Info

Click here for more information.

Firmware Update

Click Firmware Update at the bottom of the page to access the firmware upload interface.\ You can upload a .bin file to update your PuffiAir system.

Custom File Upload

This section allows you to upload a custom voice alert that will play automatically when air quality reaches a dangerous level.

📂 File Naming Rules

Each file must use one of the following exact filenames:

  • notice_en.wav — English alert
  • notice_ja.wav — Japanese alert
  • notice_zh.wav — Chinese alert

⚠️ File names must match exactly as shown above. Otherwise, the upload will be ignored.

📐 Format Requirements

  • File Type: WAV (.wav)
  • Encoding: PCM, 16-bit
  • Sample Rate: 16 kHz (recommended)
  • File Size: Max \~300 KB
  • Duration: Suggested under 10 seconds

setuppage

Sensors Currently Enabled

This shows which sensors have been successfully detected and are currently active.

Only sensors connected and initialized correctly will appear with a ✅. If a sensor is not connected or not responding, it may be omitted from measurements.