On this page
Check the installed version
The flash tool reads the installed firmware and version over USB before writing anything.
HomeKit-compatible and Matter-compatible firmware
In the web interface, read Firmware > Installed. Reload after an update.
ESPHome
ESPHome firmware reports the ESPHome release it was built with. The Serin configuration has no version number of its own. Home Assistant shows it as the controller's ESPHome Version sensor.
Update over Wi-Fi
HomeKit-compatible and Matter-compatible Wi-Fi updates keep the network, pairing and settings.
- Open the web interface and expand Firmware.
- Select Versions. Releases for your board appear newest first: latest marks the newest stable release, beta marks a pre-release, and installed marks the current version. Older releases are under Other versions. Release notes opens the HomeKit-compatible release page.
- Select a version and confirm. Your phone or computer downloads it and sends it to the controller, which verifies it and restarts. Keep the page open, the phone awake and power on until it shows "Update complete! Restarting...". The light pulses white during installation.
- After the controller restarts, check Installed. Then change the mode or target temperature and confirm that the indoor unit responds.
The browser contacts the release server only when you open Versions. The phone or computer needs internet access, but the controller does not. If a newer release is found, the button and section show Update available. Installation is always manual.
If the new version cannot start, the controller restores the previous version. See the version did not change.
For a failed check, install, or unchanged version, see update troubleshooting.
Try a pre-release build
HomeKit-compatible and Matter-compatible pre-release builds are less tested than stable releases. Back up settings before trying one.
Serin's ESPHome firmware has no pre-release builds.
In Firmware > Versions, select a release tagged beta and confirm. With Beta updates on, the newest pre-release appears at the top and the page offers it as the update if it is newer than the latest stable release. The controller saves this preference. Beta releases remain available in the menu when it is off.
Return to the stable release
Turning off Beta updates does not change the installed version.
- Open Firmware > Versions.
- Select the release tagged latest and confirm.
- After the restart, check Installed and your settings.
To install an older release, select it under Other versions in the same menu.
Update over USB
Follow the USB installation steps to remove and reinstall the controller. Switch off power at the breaker and disconnect CN105 before connecting USB.
- Connect the controller to a computer with a USB-C data cable. Open the flash tool in Chrome, Edge, or Brave and select Connect a device.
- Select the firmware already installed.
- For a HomeKit-compatible or Matter-compatible pre-release, select Install the pre-release build. The box appears only when a pre-release exists for your board.
- To keep settings on HomeKit-compatible and Matter-compatible updates, leave Erase everything first unchecked. Obey any reset warning for the selected build. Reinstalling ESPHome erases saved settings even with Erase everything first unchecked. The button reads Reset and install. Select the install button and leave USB connected until it finishes.
To return to stable over USB, leave Install the pre-release build unchecked. If the tool warns that it is older than the installed build, select Install the older version anyway, then install.
Install a firmware file
For HomeKit-compatible or Matter-compatible firmware, use this when support supplies a file or the release server is unreachable.
- Get the application file for your board and installed firmware. For HomeKit-compatible firmware, open Versions > Release notes or the release page and download
firmware-nanoc6.binorfirmware-m5atoms3-lite.bin. - In Firmware, under Manual .bin Upload, select Choose File and pick the file. Select Upload and confirm.
- Wait for "Update complete! Restarting...", then reload the page and check Installed.
If the controller refuses the file, follow the upload-error checks.
For HomeKit-compatible command-line uploads with curl, see the source documentation.
ESPHome updates
- Adopted in the ESPHome dashboard. Select Install to build the current configuration and send it over Wi-Fi. This includes Serin configuration changes, even when the dashboard shows no update notice. That notice tracks ESPHome releases only.
- Customized with the YAML generator. The generated configuration is a copy made when you generated it. To get later changes, generate it again and install it.
- Not adopted yet. Adopt it to update from the dashboard, or reinstall over USB, which erases saved settings.
If an update fails or the controller stops responding, use update recovery.