Firmware & Software Guide for UltimateSensor Mini

Welcome to the Firmware Guide for the UltimateSensor Mini. This document provides detailed instructions on how to update or change the firmware of your device to enhance its functionality with additional features. The latest firmware .bin and .yaml files can be found on the corresponding GitHub page.

Reflashing Firmware

There are two ways to (re)flash the UltimateSensor Mini:

1) Adopt in ESPHome (OTA preferred)

1. Open ESPHome in Home Assistant.
2. Use Adopt to add the UltimateSensor Mini.
3. Then either:
   • Make changes to the YAML and click Update to deploy OTA, or
   • Simply click Update on the adopted device to reinstall the current configuration.

2) Flash via USB‑C using our website:

1. Connect the UltimateSensor Mini via USB‑C.
2. Open the flasher: https://smarthomeshop.io/en/firmware?product=ultimatesensor-mini
3. Pick the correct variant (Basic/Complete), click Connect → Install and follow the prompts.

Note: Flashing new firmware can potentially disrupt your device settings, or you may need to readopt the device inside Home Assistant.

Update to the latest software (recommended)

You can update to the latest official build directly from Home Assistant using the built‑in Update entity defined in your device configuration.

Steps:

1. In Home Assistant, go to Settings → Devices & Services → Devices → select “UltimateSensor Mini”.
2. Open the Entities tab. Enable the entity named “UltimateSensor Mini Firmware” (type: Update) if it is disabled.
3. Click the entity → Check for updates → Install. Optionally enable Auto update.
4. The device will download the firmware from the manifest and reboot. On success, the front LED briefly flashes green (as defined in the firmware on_update hook).
5. Verify after reboot: the Software Version text sensor and the device firmware version should reflect the new version.

Update via ESPHome Dashboard (alternative)

If your device is adopted in ESPHome, you can update OTA directly from the ESPHome Dashboard.

Steps:

1. Open ESPHome → click your UltimateSensor Mini device.
2. Click Install/Update → choose Wirelessly → confirm and wait for completion.
3. Alternatively, click the UPDATE button on the device tile if shown.

Notes

• Ensure ota: is enabled in the YAML and the device is online.
• Keep the device powered and within Wi‑Fi range during the update.

Firmware Changelog

Version 2.0 — 2025-08-14

• Builds are now produced via GitHub (CI pipeline).
• Fix: LED rmt_channel issue resolved.
• Feature: SPS30 now measures periodically (e.g., once every few minutes) instead of 24/7.
• Feature: CO₂ calibration button.
• Feature: Factory reset button.
• Feature: Restart button.
• Other optimizations for update flow and general improvements.

Version 1.1 — 2024-06-24

• Enhancements: Added platform: esphome to comply with the latest ESPHome version requirements.

For additional help, please join our support chat server for personal support.