Airton Serial Climate

The airton_serial climate platform controls Airton air conditioners that use the serial link between the indoor unit and its Wi-Fi module. The ESP takes the role of the original module and talks directly to the climate board (address 0x21).

This platform is separate from the IR-based airton component.

WARNING

The module connector provides +12 V. Never connect it directly to the ESP. Use a 5 V regulator (a 12 V → 5 V buck module, or a 7805 with a heatsink), verify its output before wiring, and connect a common ground.

WARNING

The data lines are 5 V TTL, and ESP GPIOs are rated for 3.3 V. Put a level shifter, or a resistor divider such as 10 kΩ / 20 kΩ, between the module’s TX and the ESP’s RX. If the board does not read the ESP’s 3.3 V TX reliably, use a bidirectional level shifter on both lines.

The bus is a 9600 baud, 8N1, TTL 5 V serial link with two data wires and a common ground. The platform requires a UART bus; the UART must use 9600 8N1 with both TX and RX.

NOTE

Tested on an ESP32-S3-Zero with GPIO5 (TX) and GPIO4 (RX), original Wi-Fi module removed. The board read the ESP’s 3.3 V TX directly.

# Example configuration entry
climate:
  - platform: airton_serial
    id: airton_climate
    name: Airton Climate

Configuration Variables

uart_id (Optional, ID): Manually specify the ID of the UART bus. Required if you have more than one UART bus.
All other options from Climate.

Switches

The optional switches control the settings that the board exposes on the same serial link:

switch:
  - platform: airton_serial
    airton_serial_id: airton_climate
    display:
      name: Display
    ionizer:
      name: Ionizer
    health:
      name: Health
    sleep:
      name: Sleep
    eco:
      name: Eco

airton_serial_id (Optional, ID): The ID of the airton_serial climate. Only needed when more than one is configured.
display (Optional, Switch): The display backlight.
ionizer (Optional, Switch): The ionizer.
health (Optional, Switch): The health setting. The board uses one bit for anti-mould and auxiliary heat, so both are controlled by this switch.
sleep (Optional, Switch): Sleep mode.
eco (Optional, Switch): Eco mode.

Each switch accepts all options from Switch inside its own block.

Sensors

sensor:
  - platform: airton_serial
    airton_serial_id: airton_climate
    total_usage_time:
      name: Total usage time
    revision:
      name: Protocol revision

airton_serial_id (Optional, ID): The ID of the airton_serial climate. Only needed when more than one is configured.
total_usage_time (Optional, Sensor): Total usage time in hours, read from the board’s poll response. All options from Sensor.
revision (Optional, Sensor): The board’s protocol revision counter. This is a diagnostic value. All options from Sensor.

Supported Features

HVAC modes: OFF, HEAT_COOL, COOL, HEAT, DRY, FAN_ONLY.
Fan modes: AUTO, LOW, MEDIUM, HIGH, QUIET, plus the custom modes medlow, medhigh and strong.
Swing: OFF, VERTICAL, HORIZONTAL and BOTH.
Current temperature and target temperature (16–31 °C, 1 °C steps).

Wiring

Module connector	ESP
+12 V (red)	input of a 5 V regulator (buck module, or 7805 with a heatsink); never directly to the ESP
TX (black)	UART RX (for example `GPIOXX`), through a level shifter or divider
RX (yellow)	UART TX (for example `GPIOXX`)
GND (green)	Common ground