Browse the manual

Controls, entities and diagnostics

On this page

Available controls depend on the indoor unit, installed firmware, and smart-home app. A listed option does not add a capability the indoor unit lacks. Check model compatibility and use the web interface guide for everyday operation.

HomeKit-compatible firmware

Scroll sideways to read all columns.

ControlFirmware capability
ModesOff, Heat, Cool, Auto, Dry, and Fan. Additional modes beyond Apple Home's thermostat controls are available in the web interface.
Target temperatureAdjustments in 0.5°C increments; independent heat and cool targets in Auto mode.
Fan speedAuto, Quiet, Low, Med, High, and Max.
Vertical vaneAuto, five fixed positions, and Swing.
Horizontal vaneFive fixed positions, Split, and Swing.
Room sensorOne source or an average of selected sources, with per-sensor offsets. See room temperature sensors.

Apple Home has no vane controls. Use the controller's web interface for both vane axes. Siri, scenes, and automations operate through the Apple Home thermostat; remote access and automations require an Apple Home Hub.

ESPHome standard entities

The standard browser-installed configuration creates one device in Home Assistant after setup. Entity IDs derive from the name you choose: for example, living-room produces climate.living_room.

Scroll sideways to read all columns.

EntityDomainPurpose
Indoor unitclimateMode, target temperature, fan speed, and current room temperature.
Vertical vaneselectUp-and-down airflow direction.
Horizontal vaneselectLeft-and-right airflow direction.
LEDlightThe board's RGB light. ESPHome assigns it no controller status function.
Buttonbinary_sensorThe controller's physical button.
Signal strengthsensorWi-Fi signal strength in decibels.
IP address and SSIDsensorNetwork address and Wi-Fi network name.
ESPHome versionsensorThe ESPHome version used to compile the firmware.

Climate and vane options

  • Modes: Off, Heat, Cool, Auto, Dry, and Fan.
  • Temperature: 15 to 31°C in 0.5° increments, with room temperature displayed to 0.1°. The indoor unit's limits still apply.
  • Fan speed: Auto, Quiet, Low, Medium, Middle, and High.
  • Vertical vane: Auto, five positions, and Swing.
  • Horizontal vane: five positions, Split, and Swing.

Auto mode uses one target by default. Separate heat/cool setpoints, swing on the climate entity, and Even/Indirect/Direct airflow control are generator options. Omit a horizontal vane from the configuration if the unit has none. Remote-control changes are read back by the controller and appear in Home Assistant.

The generator can also add an i-See occupancy binary sensor, supported Night mode/Air purifier/Circulator switches, Bluetooth proxy, and ISU installer settings. See optional configuration features for requirements and installation.

Heat-pump diagnostics

Readings depend on what the indoor unit reports. Use them to understand operating state and to include useful evidence with a support request.

Scroll sideways to read all columns.

FirmwareWhere to find diagnosticsReported data
HomeKit-compatibleController web interfaceCompressor frequency, outside temperature, runtime hours, error codes, sub mode, and stage information.
ESPHomeHome Assistant, after adding Diagnostics through the generatorNine sensors: compressor frequency, outside temperature, input power, energy use, runtime hours, heat-pump connection uptime, stage, sub mode, and auto sub mode.
Matter-compatibleController web interfaceCompressor frequency, outdoor temperature, runtime, and error codes; these do not appear in Google Home, Alexa, or SmartThings.

Compressor frequency indicates how hard the system is working. Outside temperature comes from the outdoor unit, not a weather service. Stage and sub modes describe its operating state. When ESPHome diagnostics are included, the generator enables those entities so they are available for history graphs without first enabling them individually.

For an error code or missing data, inspect the logs and follow CN105 troubleshooting. The status light reference covers controller signals separately from these readings.

Matter controls in Google Home, Alexa, and SmartThings

The beta Matter-compatible firmware presents a standard thermostat: power, Heat/Cool/Auto, target temperature, and reported room temperature. Google Home and Alexa offer voice commands and routines; SmartThings offers scenes and routines.

Dry mode, fan-only mode, fan speed, and vane direction may not appear in the app's thermostat card. Fan, vane, and diagnostic controls remain available in the controller's web interface. App-visible controls are narrower than the heat pump's full feature set.

This firmware is free to install, not Matter-certified, and its source is not published. See Matter setup for network and hub requirements, or choose a firmware route if you need a different set of controls.

Browse the manual ↑