Backups and diagnostics

These tools are in the web interface of HomeKit-compatible and Matter-compatible firmware. For ESPHome, back up the YAML in the ESPHome dashboard and use its logs, as described at the end of this page.

On this page

Back up and restore settings

On HomeKit-compatible and Matter-compatible firmware, save a copy of the controller's settings before you try a pre-release build, return to an older version, switch firmware, or do a factory reset.

  1. Open the web interface and expand Device.
  2. Select Export Settings. Your browser downloads a file named after the controller, for example living-room-settings.json.
  3. To restore, select Import Settings and choose the file. The settings apply straight away. If the file changes the modes under Unit Capabilities, select Firmware > Restart Device so your app shows them.

Scroll sideways to read all columns.

The file includesThe file leaves out
Device name, °C or °F, vane type, and unit capabilitiesThe Wi-Fi network and password
Separate heat and cool targets for Auto modeThe setup code and app pairing
Room temperature source and sensor timeoutA paired Serin Link and its Night Dimming settings
The first Bluetooth thermometerOther thermometers, sensor names, offsets, and the Single or Average choice
Poll interval and log levelThe Beta updates setting

On Matter-compatible firmware, the file also includes the thermostat and fan tile names and the Separate Sensor Tiles setting. A file exported from HomeKit-compatible firmware can be imported on Matter-compatible firmware. HomeKit-compatible firmware does not accept a file exported from Matter-compatible firmware.

Copy diagnostics for support

When you contact support about a controller running HomeKit-compatible or Matter-compatible firmware, include the text from Copy Diagnostics. It answers most of the first questions about a controller.

  1. Open the web interface and expand About.
  2. Select Copy Diagnostics. The page shows "Diagnostics copied".
  3. Paste the text into your message or the contact form.
About section listing board, firmware version, IP address, mDNS name, MAC, last reset, boots, crashes, memory and drop counts, a Copy Diagnostics button, and a Device Events list
Wi-Fi Drops and Pump Link Drops count since the last restart; Boots and Crashes count since the last factory reset. View full-size screenshot.

The copied text lists the board, firmware version, network name, signal strength, IP address, MAC address, uptime, restart reason, crash count, the heat-pump connection and any error code, the pairing status, and recent device events. It does not include your Wi-Fi password or the setup code.

Last Reset shows why the controller last started:

Scroll sideways to read all columns.

ValueWhat it means
POWER_ONPower was switched on or restored.
SW_RESTARTThe controller restarted itself: after an update, a pairing or Wi-Fi reset, or Restart Device.
BROWNOUTThe supply voltage dropped too low. Check the power source and the cable connections.
PANIC, TASK_WDT, INT_WDT, WDTThe firmware crashed and restarted. Include the diagnostics text in a support request.

Read device events

On HomeKit-compatible and Matter-compatible firmware, Device Events, under About, keeps the last 24 events, newest first, and keeps them through restarts. Select Refresh to load new ones. An event shows the date and time, or boot #N and the time since that start if the controller had not yet set its clock.

Scroll sideways to read all columns.

EventWhat happened
BOOTThe controller started. The reason follows in parentheses, using the Last Reset values above.
CRASHThe controller restarted after a crash.
SAFE_MODERepeated crashes started safe mode.
OTAA firmware update was installed.
CN105_LOSTThe indoor unit stopped answering over the CN105 cable.
CN105_OKThe indoor unit answered again.
CN105_ERRORThe indoor unit reported an error code.
RECOVERY_APThe backup setup network opened.
HK_RESETApp pairing was reset.
WIFI_CREDSThe saved Wi-Fi network changed. (erased) means it was erased.

Repeated CN105_LOST events point to the cable or connector; see CN105 troubleshooting.

Capture a live log

On HomeKit-compatible and Matter-compatible firmware, a live log shows what the controller is doing while a problem happens. Support may ask for one.

  1. Open the web interface and expand Diagnostics · Logs.
  2. Under Log Level, select Debug for the most detail.
  3. Leave the page open and make the problem happen again.
  4. Select Copy under Live Log and paste the text into your message.
Diagnostics · Logs section with Log Level set to Debug, Copy and Clear buttons, and several live log lines
The log keeps the last 200 lines, and only while the page is open. Debug returns to Info when the controller restarts. View full-size screenshot.

ESPHome

Back up the controller's YAML from the ESPHome dashboard, with any secrets it uses. For logs, select Logs on the controller's card in the ESPHome dashboard, or open the controller's own web page. Diagnostic sensors can be added through the YAML generator.

Browse the manual ↑