Home Assistant Integration (MQTT)
Native MQTT integration with auto-discovery. 12 sensors (PM1.0, PM2.5, PM4.0, PM10, Temperature, Humidity, VOC, NOx, CO₂, HCHO, IAQ Score, AQI) automatically register with Home Assistant. Cloud-synced settings with availability tracking and 1-minute averaged data for clean graphs.
Redesigned Display Screens
New per-pollutant detail screens with large, easy-to-read values and color-coded thresholds. Redesigned 2×2 overview grid replacing the old dense text list. New flip-calendar date screen. Cleaner layouts with more breathing room.
IAQ Data Quality Tracking
Every reading now includes provenance metadata showing whether data is provisional (single reading) or fully averaged (1-minute), with clear warm-up indicators across display, LED, and cloud dashboard.
Watchdog Timer Protection
Hardware watchdog monitors firmware during setup and operation. Automatically resets device if it hangs due to sensor or network issues. Seven diagnostic checkpoints tracked and persisted for troubleshooting.
HTTP Circuit Breaker
Detects consecutive cloud connection failures and temporarily stops retrying, preventing 9-second TCP timeouts from blocking display, sensors, and LED. Automatically re-enables when connectivity returns.
General MQTT Setup
MQTT on ambient one is not limited to Home Assistant — it works with any MQTT broker and client. The device publishes sensor data to standard MQTT topics, so you can consume it with Node-RED, Grafana, custom scripts, or any MQTT-compatible platform.
Defaults
| Setting |
Default |
Notes |
Broker |
homeassistant.local |
Change to any broker IP/hostname |
Port |
1883 |
Standard MQTT port |
Discovery prefix |
homeassistant |
Only relevant for HA auto-discovery |
Publish interval |
60s |
Configuration
Configure MQTT settings from the device settings in the Ambient Works App, or directly on the device via the Settings → MQTT menu.
Authentication (Optional)
By default, no credentials are required. If your broker requires authentication (e.g., Home Assistant's Mosquitto add-on), you can set a username and password via the Ambient Works App. Credentials are stored encrypted in secure NVS on the device and are never sent to the cloud.
Using with Non-HA Brokers
MQTT works with any standalone Mosquitto, EMQX, HiveMQ, or other MQTT 3.1.1 broker. Simply configure your broker's IP address and optional credentials via the app.
The device will publish sensor data to ambient/{device_id}/state regardless of the discovery prefix. You can subscribe with any MQTT client:
mosquitto_sub -h 192.168.1.50 -u myuser -P mypass -t "ambient/#" -v
Note: MQTT is currently publish-only. The device sends sensor data but does not accept commands via MQTT (e.g., you cannot trigger OTA updates or change settings over MQTT).