Firmware Guide
This guide explains how to update or reflash the firmware on your UltimateSensor Mini.
The latest firmware files (.bin and .yaml) can be found on GitHub.
Update Firmware (Recommended)
Via Home Assistant Update Entity
The easiest way to update is using the built-in Update entity:
- In Home Assistant, go to Settings → Devices & Services → Devices
- Select your UltimateSensor Mini
- Open the Entities tab
- Enable the
UltimateSensor Mini Firmwareentity if disabled - Click the entity → Check for updates → Install
- Optionally enable Auto update
The device will download the firmware and reboot. On success, the front LED briefly flashes green.
Via ESPHome Dashboard
If your device is adopted in ESPHome:
- Open ESPHome Dashboard in Home Assistant
- Click on your UltimateSensor Mini device
- Click Install/Update → Wirelessly
- Wait for completion
Reflash Firmware
There are two ways to reflash the UltimateSensor Mini:
Method 1: Adopt in ESPHome (OTA)
- Open ESPHome in Home Assistant
- Use Adopt to add the UltimateSensor Mini
- Make changes to the YAML if needed
- Click Update to deploy OTA
Method 2: Flash via USB-C (Web Flasher)
- Connect the UltimateSensor Mini via USB-C to your computer
- Open the web flasher: smarthomeshop.io/en/firmware?product=ultimatesensor-mini
- Select the correct variant (Basic/Complete)
- Click Connect → Install and follow the prompts
Note: Flashing new firmware may reset device settings. You may need to readopt the device in Home Assistant.
Important Notes
- Ensure the device stays powered during updates
- Keep the device within WiFi range during OTA updates
- The
ota:component must be enabled in the YAML for OTA updates
Need Help?
- Discord: smarthomeshop.io/discord
- GitHub: github.com/smarthomeshop/ultimatesensor-mini