Can I connect the air conditioner to Alice without buying a Wi-Fi module?

Yes. Instead of a ready-made Wi-Fi module for 3000–7000 ₽, you can use an ESP32-C6 SuperMini — the board costs about 200–400 ₽ on AliExpress. The firmware is free and installs straight from the browser in 5 minutes, with no soldering iron and no programming. It works with Royal Clima, Midea, Kentatsu and other Midea OEM brands.

Which air conditioners can be connected to Alice with an ESP32?

Air conditioners using the Midea UART protocol are supported: Royal Clima, Midea, Comfee, MDV, Kentatsu, Ballu, Lessar, Lanzkraft, Abion, Dantex and other OEM models. If a NetHome Plus, Midea Air or MSmartHome adapter is sold for your air conditioner, PirogovX firmware will almost certainly work.

Are Samsung air conditioners supported (NASA F1/F2 bus)?

Yes, since version 0.6.44. On Samsung NASA series air conditioners (stock Wi-Fi kit MIM-H04N) the F1/F2 bus is RS-485, not a regular UART, so a MAX3485/SP3485 transceiver is required. The “Samsung NASA” profile is auto-detected (passive detection from F1/F2 frames — the module transmits nothing until the user sends a command) or can be selected manually. Verified models: Samsung AC120MNMDKH/EU indoor unit and AC120MXADKH/EU outdoor unit. Control: on/off, auto/cool/dry/fan/heat modes, temperature, fan, louvers; statuses: room and outdoor temperature.

How do I wire an ESP32 to a Samsung NASA (F1/F2) air conditioner?

Only through an RS-485 transceiver: TX GPIO7 → DI (MAX3485/SP3485), RX GPIO6 ← RO, transceiver outputs A → F1 and B → F2, common GND. Do not connect the ESP32 GPIO directly to F1/F2 — this is an RS-485 bus, and a direct connection can damage the board. If needed, enable DE/RE direction control in the app (uart_de_gpio); the protocol runs at 9600 8E1, and the firmware will set the profile itself.

How much does a DIY Wi-Fi module for an air conditioner cost?

A DIY Wi-Fi module costs about 200–400 ₽: an ESP32-C6 SuperMini board from AliExpress plus three wires GND/TX/RX. A ready-made branded module (NetHome Plus, OSK102) costs 2500–7000 ₽. The firmware is free and open source.

Royal Clima: how do I connect it to Wi-Fi and Alice?

Select the “Royal Clima / Midea OEM” profile. For the current ESP32-C6 Wi-Fi firmware, connect TX GPIO7 → air conditioner RX, RX GPIO6 ← air conditioner TX, GND → GND. After flashing and setting up Wi-Fi, the air conditioner will appear in WQTT and Alice. Control: on/off, temperature, mode, fan, louvers, Turbo/Quiet.

How does WQTT differ from Home Assistant for air conditioner control?

WQTT is a cloud MQTT broker that lets you control your air conditioner through Alice without a server, and it takes 5 minutes to set up. Home Assistant is a full-fledged smart home system on your own server, with more flexibility, but it requires infrastructure. PirogovX firmware supports MQTT and works with both options.

The browser does not see the board / no port shows up

Connect the ESP32-C6 while holding the BOOT button — this puts the board into flashing mode. Check the cable (some USB cables are charge-only). It works only in Chrome and Edge on a computer — mobile browsers do not support Web Serial.

Can I use a regular ESP32 or ESP8266?

No. The firmware is built specifically for the ESP32-C6. The classic ESP32, ESP32-S2/S3 and ESP8266 are not compatible — different architecture. For the TCL protocol, firmware for the ESP32-C3 SuperMini is available.

Can I control the air conditioner through Home Assistant?

Yes. Zigbee builds (ESP32-H2/C6) connect to Home Assistant via Zigbee2MQTT with the external converter esp-ac.js — the air conditioner appears as a device with control of temperature, mode, fan and louvers, plus temperature telemetry. Wi-Fi builds work over MQTT: you can use your own MQTT broker or the cloud WQTT.

Does air conditioner control work without the cloud?

Yes. Local control works without WQTT and without the internet: the app controls the module over the local network, and automations run on the ESP itself. The cloud (WQTT) is only needed for Yandex Alice and remote access from anywhere.

How do I check whether my air conditioner model is compatible?

Signs of compatibility: the air conditioner has a UART connector for a stock Wi-Fi module, a stock OSK102/OSK103/OSK302 module, or a native NetHome Plus / Midea Air / MSmartHome app. Look up your model in the search on the page; if it is not there, submit a request via the “Report a model” form.

Can I control the air conditioner from my phone?

Yes, there is a PirogovX Android app for this: it is published in RuStore, and the APK can be downloaded right from the page. The module is set up over Bluetooth or through a Wi-Fi access point, and after that you control temperature, mode, fan and louvers — locally or through Alice.

Is Yandex Alice supported?

Yes, through WQTT. Enter the WQTT API token in the module settings, then link your WQTT account in the Yandex Smart Home app — the air conditioner will appear in the device list. A step-by-step guide is in the “WQTT/Alice” section on this page.

Which ESP32 module do I need?

The main recommendation is the ESP32-C6 SuperMini: for Wi-Fi, Matter and Zigbee builds. The ESP32-C3 SuperMini is used in certain Wi-Fi builds (TCL, Hommyn/Neoline), and the ESP32-H2 only in Zigbee builds. A regular ESP32, ESP32-S2/S3 and ESP8266 are not suitable.

Do I need to solder anything?

No. The firmware is installed from the browser over USB (Web Serial), with no soldering iron and no programming. Connection to the air conditioner board requires three wires GND/TX/RX to the UART connector.

The AC-Setup-xxxx access point does not appear after flashing

Wait 10–15 seconds after flashing — the module reboots and brings up the AP. If the access point is not there: open the Serial Monitor at 115200 and check the logs after the reboot. Make sure you selected the correct air conditioner profile before flashing.

The air conditioner does not respond to commands after Wi-Fi setup

Check the physical connection: TX → air conditioner board RX, RX → TX — crossed over, which is the UART standard. Make sure GND is connected. For ESP32-C6: TX GPIO7 / RX GPIO6. For ESP32-C3: TX GPIO5 / RX GPIO6. Check the baud rate: the firmware uses 9600 baud.

“Not supported” or “HTTPS required” error

Web Serial works only over HTTPS or on localhost. If you opened the page over HTTP, the browser will block access to the port. Browser: Chrome or Edge (Firefox and Safari do not support Web Serial).

I cannot find my air conditioner in the compatibility list

Many air conditioners sold under different brands use the same Midea OEM board. Try the “Royal Clima / Midea OEM” profile — it suits most brands: Royal Clima, Kentatsu, Lanzkraft, Abion and other Midea OEM brands. If that does not help, submit a request via the “Report a model” form.

What if my air conditioner has a factory OSK102, OSK103 or OSK302 module?

OSK102, OSK103 and OSK302 are often found on Midea OEM air conditioners and compatible brands. If the native module works through NetHome Plus, Midea Air or MSmartHome, it is usually worth starting with the “Royal Clima / Midea OEM” profile. The ESP32 connects to the same UART connector where the stock module was installed.

Will Ballu, TCL, Lessar, MDV or Dantex work?

Some models from these brands run on Midea/TCL UART protocols, but compatibility depends on the specific indoor unit board. Verified models are added to the search database on the site. If your model is not found, message us on Telegram or submit a request — a UART log can show which profile is needed.

How do I update the firmware on a module that is already installed?

Connect the ESP32-C6 over USB and flash it again through this same page. The firmware supports OTA partitions — your previous Wi-Fi settings and WQTT token are preserved if you use the same profile.

What is the “Universal firmware” and how do I set it up?

The universal firmware (ESP32-C6) detects the air conditioner protocol by itself: Midea, TCL, Haier (SmartAir2 and hOn), Hisense (RS-485 via HW-519), Gree and Samsung NASA (F1/F2, RS-485). On the site you do not need to choose a protocol — select the ESP32-C6 board and click “Flash”. After flashing, open the PirogovX Climate app and choose automatic detection.

Air Conditioner Firmware — Wi-Fi, Home Assistant and Alice on ESP32

Free ESP32 firmware that plugs into your air conditioner's UART port in place of the stock Wi-Fi module. Control your air conditioner locally or through Home Assistant, MQTT and Yandex Alice. Flash it straight from your browser — no soldering iron, no mandatory cloud.

Go to Flashing What's Next Help on Telegram

ESP32-C6 / C3
Local MQTT
OTA Updates
Home Assistant
Open Source

Firmware Installation

Works in Chrome, Edge and other browsers with Web Serial. The page must be opened over HTTPS.

Firmware Type

Air Conditioner Profile

⚠️ Flash at your own risk. Make sure your air conditioner is compatible and cut power to the unit before connecting the ESP32 module. The project author is not liable for any damage to your equipment.

This browser doesn't support Web Serial. Open the page in Chrome or Edge on a computer.

Flashing requires an HTTPS domain or localhost.

Android App for ESP Setup

Quick module setup over the AC-Setup Wi-Fi access point or Bluetooth BLE, local air conditioner control, and WQTT connection later.

Download APK Directly · 1.9 · 19.8 MB

The RuStore build updates through the store, while the APK from this page updates in-app. Module setup and control work the same in both builds.

1. Connect the Module

Connect the ESP32-C6 SuperMini over USB. If the browser can't see the port, hold the BOOT button while plugging it in.

2. Set Up Wi-Fi

After flashing, the module brings up the access point AC-Setup-xxxx. Set up Wi-Fi through the Android app over Bluetooth/Wi-Fi or via the page 192.168.4.1. You can connect WQTT later.

3. Check Alice

Once WQTT registration succeeds, your air conditioner shows up in the device list. Commands go over MQTT, with no Home Assistant needed.

App Setup in a Couple of Minutes

Open “My Home”

Tap “Add Device”.

Find the Module over Bluetooth

The app finds PirogovX-AC-xxxx on its own.

Share Wi-Fi

Network and password go over BLE. The WQTT token is optional.

The Device Adds Itself

IP, name, protocol and key — set automatically.

Control It

Power, mode, temperature, turbo/night — locally or through Alice.

PirogovX App for Android

Free, Android 8.0+. Set up the module over Bluetooth and Wi-Fi, and control your air conditioner and smart home from your phone.

Download APK Directly · 1.9 · 19.8 MB

Firmware for Remote Air Conditioner Control

PirogovX AC Flash is free ESP32 firmware that turns an ordinary air conditioner into a smart one. The ESP32 module plugs into the UART port on the air conditioner board — the same slot where the stock Wi-Fi module goes — and talks to the air conditioner in its native protocol: Midea, TCL, Haier, Hisense, Gree, Samsung NASA (F1/F2) and others.

The firmware reads the air conditioner's actual state over UART: temperature, mode, fan speed, louver position. You can control it locally — from your phone via the app, from a browser or over MQTT — with no mandatory cloud.

From there, take your pick: Home Assistant, your own MQTT broker, Yandex Alice via WQTT, or Matter and Zigbee for your smart home. Updates install over the air (OTA) straight from this page.

The firmware is free and open source. Installation takes a couple of minutes: pick your air conditioner model, connect the module over USB, press one button.

Why UART/Wi-Fi Control Beats an IR Remote

Real state feedback. The module reads the air conditioner's actual state over UART — temperature, mode, fan, louvers — rather than “assuming” it.
Your stock IR remote keeps working. The module polls state over UART, so changes made with the remote show up right away in the app and your smart home — everything stays in sync.
Home Assistant and apps see actual data. The real room temperature and the current mode are available in your smart home.
Control doesn't depend on where the IR beam points. Commands travel over wires — no need to aim the module at the air conditioner, and walls or furniture don't get in the way.
Local MQTT. MQTT control with no mandatory cloud.

Air Conditioner Control via Home Assistant, MQTT and Alice

Home Assistant sees your air conditioner as a full climate entity — mode, temperature, fan and louvers in a single card.

MQTT Discovery
The device shows up in Home Assistant automatically.
Modes and Temperature
Cool, heat, auto, dry, fan and one-degree setpoints.
Local Control
Commands run through your MQTT broker inside your home.

Home Assistant

The Zigbee builds (ESP32-H2 and ESP32-C6) connect to Home Assistant through Zigbee2MQTT: add the external converter esp-ac.js and run Reconfigure on the device. The air conditioner appears in Home Assistant with control over temperature, mode, fan and louvers, plus temperature telemetry.

The Wi-Fi builds work over MQTT — you can use your own broker or the WQTT cloud. The Android app can control Home Assistant climate entities directly (by address and token).

MQTT

The firmware supports MQTT: local command control and state feedback from the air conditioner. No cloud required — you can run an MQTT broker at home.

Yandex Alice

Alice connects through WQTT: enter your WQTT API token in the module settings, link your WQTT account in the “House with Alice” app — and you can control your air conditioner by voice. A step-by-step guide is in the WQTT/Alice section below.

Runs on Your Network

Control through your local MQTT broker and Home Assistant. The cloud is used only for Alice voice scenarios via WQTT — your choice.

ESP32

MQTT

Home Assistant

OTA — No Need to Remove the Board

Once the ESP32 is installed in your air conditioner, you can update the firmware over the air. No need to take the unit apart again.

v0.6.5current

v0.6.7over the air

Which Air Conditioners Are Supported

The firmware has been tested on air conditioners from Royal Clima, Midea, TCL, Haier, Hisense, Gree, Samsung NASA, Kentatsu, Ballu, Hommyn, Neoline, JAX, NewTek and others — the full model list is below. Compatibility depends on the board and the UART protocol, so one firmware build often fits several brands at once (Midea OEM).

Royal Clima · 11 Midea · 3 TCL · 13 Haier · 2 Hisense · 4 Gree · 1 Samsung · 3 Kentatsu · 5 Ballu · 3 Daichi · 4 Dantex · 1 Ecostar · 1 NewTek · 6 Hommyn · 1 Neoline · 1 JAX · 3 Lessar · 1 Axioma · 1 Stock Modules (OSK/EU-OSK) · 4

Check Your Model

Enter your air conditioner's manufacturer or model. If there's no exact match, send a request and I'll add the model to the compatibility list after checking it.

Manufacturer or Model

Report a model

How to Tell If the Firmware Fits Your Air Conditioner

Your air conditioner has a UART port for the stock Wi-Fi module (usually on the indoor unit board).
The stock module is an OSK102, OSK103, OSK302 or EU-OSK103 (Syncleo dongle).
The air conditioner's native app is NetHome Plus, Midea Air or MSmartHome.
The air conditioner is a Midea OEM brand: Royal Clima, Kentatsu, Ballu, MDV, Lanzkraft, Abion and others.
Your model is in the search above or in the compatibility list below.
If you can't find your model, send a request through the “Report a model” form or message us on Telegram: we'll use the UART logs to work out the right firmware profile.

Compatible Model List

Models are grouped by firmware profile: chip, protocol and build status. The first models of each profile are shown right away; the full list is behind the “Show All” button.

Universal firmware (ESP32-C6) — recommended

ESP32-C6 · Protocol: auto-detect · 15 models · Recommended

Midea OEM
Royal Clima
Royal Clima RCI
Royal Clima RCI-TWA22HN
TCL
Haier
Hisense
NewTek NT-77HSDC
GREE
JAX

Show All 15 Models

Kentatsu KSGU
Lessar
Samsung NASA (F1/F2)
Samsung AC120MNMDKH/EU
Samsung AC120MXADKH/EU

Universal Midea / TCL / Haier (ESP32-C6)

ESP32-C6 · Protocol: TCL UART · 33 models · Stable

Royal Clima
Royal Clima Gloria Inverter
Royal Clima RCI
Royal Clima RC
Royal Clima RCI-TWA22HN
Royal Clima RCI-TWA22HN TRIUMPH
RCI-TWA22HN
TRIUMPH
Axioma ASX09H1/ASB09H1
Ballu Discovery DC BSVI-07HN8

Show All 33 Models

Ballu Discovery DC BSVI-09HN8
Ballu Discovery DC BSVI-12HN8
Daichi AIR20AVQ1/AIR20FV1
Daichi AIR25AVQS1R-1/AIR25FVS1R-1
Daichi AIR35AVQS1R-1/AIR35FVS1R-1
Daichi DA35EVQ1-1/DF35EV1-1
Dantex RK-12SATI/RK-12SATIE
Ecostar Radium KVS-RAD09CH
TCL ELI ONF 12
TCL Liferise ONF 09
TCL TAC-CT09INV/R
TCL One Inverter TACM-09HRID/E1
TCL TAC-07CHSA/TPG-W
TCL TAC-09CHSA/TPG
TCL TAC-09CHSA/DSEI-W
TCL TAC-09HRID/E1
TCL TAC-12CHSA/TPG
TCL TAC-12CHSA/TPGI
TCL TAC-XAL24I
TCL TPG31IHB
OSK102
OSK103
OSK302

Hommyn / Neoline / Midea — 0x64 (ESP32-C6, pins are configurable)

ESP32-C6 · Protocol: Midea UART · 9 models · Stable

Neoline NAM 07HN1
Hommyn
Royal Clima (old revision)
Royal Clima RCI-T30HN/IN
Midea OEM (old UART revision)
OSK102
OSK103
EU-OSK103
OSK302

Hisense / NewTek RS-485 (ESP32-C6)

ESP32-C6 · Protocol: Hisense RS-485 · 9 models · Stable

Hisense
Hisense AS-10UW4RYDTV02
Hisense AS-10UW4RYDTV02G
Hisense Expert Pro DC Inverter
NewTek NT-77HSDC07
NewTek NT-77HSDC12
NewTek NT-77HSDC09
NewTek NT-77HSDC18
NewTek NT-77HSDC24

Universal UART Module (ESP32-C3)

ESP32-C3 · Protocol: Midea UART · 12 models · Stable

Royal Clima
Royal Clima RCI
Royal Clima RC
Royal Clima RCI-TWA22HN
Royal Clima RCI-TWA22HN TRIUMPH
RCI-TWA22HN
TRIUMPH
Midea
Haier AS09TT4HRA
OSK102

Show all 12 models

OSK103
OSK302

Hommyn / Neoline (ESP32-C3, configurable pins)

ESP32-C3 · Protocol: Midea UART · 6 models · Stable

Neoline NAM 07HN1
Hommyn
Royal Clima (old revision)
Midea OEM (old UART revision)
OSK103
EU-OSK103

Royal Clima / Midea OEM (Matter ESP32-C6)

ESP32-C6 · Protocol: Matter (Midea UART) · 8 models · Testing

Royal Clima
Royal Clima RCI-TWA22HN
Royal Clima RCI-TWA22HN TRIUMPH
RCI-TWA22HN
TRIUMPH
OSK102
OSK103
OSK302

TCL UART (Matter ESP32-C6)

ESP32-C6 · Protocol: Matter (TCL UART) · 13 models · Testing

TCL
TCL ELI ONF 12
TCL Liferise ONF 09
TCL TAC-CT09INV/R
TCL One Inverter TACM-09HRID/E1
TCL TAC-07CHSA/TPG-W
TCL TAC-09CHSA/TPG
TCL TAC-09CHSA/DSEI-W
TCL TAC-09HRID/E1
TCL TAC-12CHSA/TPG

Show all 13 models

TCL TAC-12CHSA/TPGI
TCL TAC-XAL24I
TCL TPG31IHB

Royal Clima / Midea OEM (Zigbee ESP32-H2)

ESP32-C6 · Protocol: Zigbee (Midea UART) · 11 models · Stable

Royal Clima
Royal Clima RCI-TWA22HN
Royal Clima RCI-TWA22HN TRIUMPH
RCI-TWA22HN
TRIUMPH
Kentatsu KSGYK35HZRN1
Kentatsu KSRYK35HZRN1
Kentatsu KSGYK35HZRN1/KSRYK35HZRN1
OSK102
OSK103

Show all 11 models

OSK302

TCL UART (Zigbee ESP32-H2)

ESP32-C6 · Protocol: Zigbee (TCL UART) · 14 models · Testing

TCL
TCL ELI ONF 12
TCL Liferise ONF 09
TCL TAC-CT09INV/R
TCL One Inverter TACM-09HRID/E1
TCL TAC-07CHSA/TPG-W
TCL TAC-09CHSA/TPG
TCL TAC-09CHSA/DSEI-W
TCL TAC-09HRID/E1
TCL TAC-12CHSA/TPG

Show all 14 models

TCL TAC-12CHSA/TPGI
TCL TAC-XAL24I
TCL TPG31IHB
Royal Clima TCL

Midea / Royal Clima / Hommyn (Zigbee ESP32-C6)

ESP32-C6 · Protocol: Zigbee (Midea UART) · 9 models · Testing

Neoline NAM 07HN1
Hommyn
Royal Clima
Royal Clima RCI-TWA22HN TRIUMPH
Midea OEM
Kentatsu
OSK102
OSK103
OSK302

GREE / JAX / Kentatsu / Lessar (Zigbee ESP32-C6)

ESP32-C6 · Protocol: Zigbee (GREE) · 5 models · Testing

JAX ACY-09HE/R32
JAX inverter
GREE
Kentatsu KSGU
Lessar

GREE / JAX / Kentatsu / Lessar (Zigbee ESP32-H2)

ESP32-H2 · Protocol: Zigbee (GREE) · 5 models · Testing

JAX ACY-09HE/R32
JAX inverter
GREE
Kentatsu KSGU
Lessar

Firmware by brand

Firmware for Royal Clima air conditioners

Royal Clima is supported by these profiles: Universal firmware (ESP32-C6) — recommended; Universal Midea / TCL / Haier (ESP32-C6); Hommyn / Neoline / Midea — 0x64 (ESP32-C6, pins are configurable); Universal UART module (ESP32-C3).

Model examples: Royal Clima, Royal Clima RCI, Royal Clima RCI-TWA22HN, Royal Clima Gloria Inverter, Royal Clima RC

Firmware for Midea air conditioners

Midea is supported by these profiles: Universal firmware (ESP32-C6) — recommended; Hommyn / Neoline / Midea — 0x64 (ESP32-C6, pins are configurable); Universal UART module (ESP32-C3); Hommyn / Neoline (ESP32-C3, pins are configurable).

Model examples: Midea OEM, Midea OEM (older UART revision), Midea

Firmware for TCL air conditioners

TCL is supported by these profiles: Universal firmware (ESP32-C6) — recommended; Universal Midea / TCL / Haier (ESP32-C6); TCL UART (Matter ESP32-C6); TCL UART (Zigbee ESP32-H2).

Model examples: TCL, TCL ELI ONF 12, TCL Liferise ONF 09, TCL TAC-CT09INV/R, TCL One Inverter TACM-09HRID/E1

Firmware for Haier air conditioners

Haier is supported by these profiles: Universal firmware (ESP32-C6) — recommended; Universal UART module (ESP32-C3).

Model examples: Haier, Haier AS09TT4HRA

Firmware for Hisense air conditioners

Hisense is supported by these profiles: Universal firmware (ESP32-C6) — recommended; Hisense / NewTek RS-485 (ESP32-C6).

Model examples: Hisense, Hisense AS-10UW4RYDTV02, Hisense AS-10UW4RYDTV02G, Hisense Expert Pro DC Inverter

Controlling Gree air conditioners with ESP32

Gree is supported by these profiles: Universal firmware (ESP32-C6) — recommended; GREE / JAX / Kentatsu / Lessar (Zigbee ESP32-C6); GREE / JAX / Kentatsu / Lessar (Zigbee ESP32-H2).

Model examples: GREE

Firmware for Samsung air conditioners

Samsung is supported by these profiles: Universal firmware (ESP32-C6) — recommended.

Model examples: Samsung NASA (F1/F2), Samsung AC120MNMDKH/EU, Samsung AC120MXADKH/EU

Other supported brands

Kentatsu (Kentatsu KSGU, Kentatsu KSGYK35HZRN1, Kentatsu KSRYK35HZRN1); Ballu (Ballu Discovery DC BSVI-07HN8, Ballu Discovery DC BSVI-09HN8, Ballu Discovery DC BSVI-12HN8); Daichi (Daichi AIR20AVQ1/AIR20FV1, Daichi AIR25AVQS1R-1/AIR25FVS1R-1, Daichi AIR35AVQS1R-1/AIR35FVS1R-1); Dantex (Dantex RK-12SATI/RK-12SATIE); Ecostar (Ecostar Radium KVS-RAD09CH); NewTek (NewTek NT-77HSDC, NewTek NT-77HSDC07, NewTek NT-77HSDC12); Hommyn (Hommyn); Neoline (Neoline NAM 07HN1); JAX (JAX, JAX ACY-09HE/R32, JAX inverter); Lessar (Lessar); Axioma (Axioma ASX09H1/ASB09H1)

Factory Wi-Fi modules

Air conditioners with factory OSK102, OSK103, OSK302 or EU-OSK103 modules (the Syncleo dongle) are a typical sign of compatibility with the Midea OEM profiles.

How to get a WQTT token and link it to Alice

These steps are for the Wi-Fi firmware. First set up a WQTT account and API token, then flash the module, enter the token in the ESP settings and refresh the devices in WQTT/Alice.

1. Setting up WQTT

Open your WQTT account page and sign in.
Go to your profile settings and create an API token.
After flashing, connect the ESP to Wi-Fi. You can add the WQTT token later in the air conditioner settings in the Android app.
Once the air conditioner shows up in WQTT, tap refresh devices in Yandex.

WQTT: open the account menu — Open the account menu in WQTT.

Go to the profile or settings.

WQTT: open the API token — Find the API token section.

WQTT: create or copy the API token — Create or copy the token.

WQTT: check the created device — After configuring the ESP, check the device.

WQTT: save or update the settings — Save the settings if needed.

WQTT: refresh Yandex devices — Tap refresh devices in Yandex.

2. Cloud binding for WQTT in the Dom s Alisoy app

Open the Dom s Alisoy app and add a new smart home device.
Find the manufacturer WQTT.RU.
Tap account linking and sign in to WQTT with the same account.
Refresh the device list. The air conditioner will appear in the room you selected in WQTT.

Dom s Alisoy: the WQTT card and the overall linking flow — Find WQTT.RU in the manufacturer list.

Dom s Alisoy: selecting WQTT — Select WQTT.RU.

Dom s Alisoy: link accounts — Tap account linking.

Dom s Alisoy: WQTT authorization — Sign in and refresh your devices.

Wiring diagram: ESP32-C6 to the air conditioner board

5V power comes from the air conditioner indoor unit (usually available on the board). If there is no 5V, use an external supply and connect a common GND.

For current firmware ESP32-C6 Wi-Fi and Matter TCL: TX GPIO7 → air conditioner RX, RX GPIO6 ← air conditioner TX. For ESP32-C3 SuperMini: TX GPIO5 → air conditioner RX, RX GPIO6 ← air conditioner TX. The older test Matter Midea build uses a different pinout, listed explicitly on its card.

Firmware profiles

Profile overview: chip, protocol and build status. A good sign of compatibility is a factory OSK102 / OSK103 / OSK302 Wi-Fi module or the NetHome Plus, Midea Air or MSmartHome apps. The wiring diagram and pins are in the Wiring section above.

Profile	Models	Chip	Status