Skip to content
Get started

Pioneer WT Climate

The pioneer_wt climate platform controls Pioneer mini split air conditioners that use the “WT” Wi-Fi module. These units are made by TCL and are also sold under other names, such as Parker Davis. The ESPHome device takes the role of the Wi-Fi module and talks directly to the indoor unit, so the unit is controlled locally without a cloud service.

The serial link runs at 115200 baud, 8N1, and each frame starts with the bytes A5 01. It is different from the serial protocol of other TCL units, which runs at 9600 baud.

The platform requires a UART bus; the UART must use 115200 baud, 8N1, with both TX and RX.

NOTE

Tested on one Pioneer WT series unit, with the original Wi-Fi module (a WBR3) running ESPHome and with an ESP8266 wired to the same serial lines.

# Example configuration entry
climate:
- platform: pioneer_wt
name: Pioneer WT
  • 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.
  • HVAC modes: OFF, HEAT_COOL, COOL, HEAT, DRY, FAN_ONLY.
  • Fan modes: AUTO, plus the custom modes Speed 1 to Speed 7.
  • Swing: OFF and VERTICAL.
  • Presets: NONE and ECO.
  • Current temperature and target temperature (16–31 °C, 1 °C steps). The unit keeps its setpoint in whole degrees Fahrenheit, so a setpoint in Celsius is rounded to the nearest degree Fahrenheit.

The unit reports its state after every change, including changes made with the handheld remote, so the state in ESPHome follows the unit.

The pioneer_wt switch platform adds switches for two settings of the indoor unit.

# Example configuration entry
switch:
- platform: pioneer_wt
display:
name: Display
beeper:
name: Beeper
  • pioneer_wt_id (Optional, ID): The ID of the pioneer_wt climate. Required if you have more than one.
  • display (Optional): Turns the display on the front of the indoor unit on or off. All options from Switch.
  • beeper (Optional): Turns the beep that the indoor unit makes when it receives a command on or off. All options from Switch.

The state of both switches follows what the unit reports. With the default restore_mode of DISABLED, ESPHome leaves both settings as the unit has them when it starts; any other restore mode sets them at boot.

The Wi-Fi module plugs into a socket on the indoor unit. The socket has the shape of a USB connector, but it carries a serial link and power, not USB. Do not plug it into a computer or a USB charger.

There are two ways to connect ESPHome to the unit.

The original module contains a WBR3 (RTL8720CF), which ESPHome supports through the RTL87xx platform. The WBR3 is connected to the unit on PA14 (TX) and PA13 (RX). Its log port is UART2, so the logger must stay on that port:

rtl87xx:
board: wbr3
logger:
hardware_uart: UART2
uart:
tx_pin: PA14
rx_pin: PA13
baud_rate: 115200
climate:
- platform: pioneer_wt
name: Pioneer WT

The first installation must be done over wires, because the original firmware does not accept other firmware over Wi-Fi. The WBR3 is flashed through its log port (PA15 and PA16) with PA00 held high during reset; see the WBR3 board page in the LibreTiny documentation. Make a backup of the original firmware first. After that, updates can be installed over Wi-Fi.

Any board with a free hardware UART can be used in place of the module. Wire its UART to the serial lines of the socket, and leave the original module unplugged so that only one device drives the lines:

Indoor unitBoard
TXUART RX (for example GPIOXX)
RXUART TX (for example GPIOXX)
GNDCommon ground

The table has no supply row because the supply pin of the socket is not confirmed. Power the board separately, or find and measure the supply pin first: the WBR3 is a 3.3 V part, so use a regulator if the socket supplies more than your board accepts.