❄️ ESPHome AC Control - Hisense Wi-Fi Module Replacement
An ESPHome external component for local Home Assistant control of air
conditioners with compatible Hisense Wi-Fi modules. Replace the original module
with a DIY ESP32 and RS-485 adapter to control your AC without the vendor cloud.
Confirmed setups include Hisense, Tornado and ACOND air conditioners; support
depends on the model and protocol, not the brand alone.
A real Home Assistant setup using this component. Available controls depend on the AC model.
- See what the AC actually did: state comes from the unit by default, rather
than assuming a command succeeded. Physical-remote changes are reflected too.
- Control and monitor in one place: Heat, Cool, Dry and Fan modes, fan and
swing controls, plus optional display control, compressor frequency,
temperature and humidity sensors.
- Troubleshoot with useful feedback: optional connection health, status age
and error counters, plus detailed protocol logs.
For presets, model-specific Dry adjustment
and feature limitations, see the configuration guide.
Quick start | Compatibility |
Wiring guide | All configuration options |
FAQ | Support
✅ Compatible air conditioners
These setups have been reported working with this component:
| AC model |
Original Wi-Fi module |
| Tornado TOP-INV-120A (WIFI) |
AEH-W4F1 |
| Tornado MULTI-12A (WIFI) (AST-09UW4RVETV00D, 2020) |
AEH-W4G2 |
| Hisense AST-12UW4RVETG00A |
AEH-W4E1 |
| Hisense New Comfort DJ25VE0BG (multi-split, 2021) |
AEH-W4E1 |
| Hisense DJ50XA0BG (multi-split) |
AEH-W4E1 |
| ACOND ASTI-09UW4RVEDC00 |
AEH-W4B1 |
See the full compatibility notes for the
TOP-INV-140A/180A variants and how to report a new setup.
Broader compatibility: Additional Hisense, Ballu and Newtek models are
expected to be compatible
based on public protocol information. Confirmation with this component is still
pending, and optional features may vary by model.
🚀 Quick start
You need an ESP32, an RS-485/UART adapter with automatic direction switching,
and the appropriate connector. Adapters requiring DE/RE control are not supported.
⚠️ Disconnect AC power at the circuit breaker before opening the unit. Check
pinout, supply voltage and logic levels using the
hardware and wiring guide. Hardware modifications are
at your own risk.
- Check your model and complete the hardware setup.
- Create an ESP32 device in ESPHome Device Builder
using the board you have.
Keep its generated
esphome, esp32, Wi-Fi, encrypted API and OTA settings.
- Add the configuration below. Merge
logger settings into your existing
section rather than creating a second one. GPIO16/17 match the wiring example;
use the pins you actually connected and a dedicated UART for each AC.
- Install the firmware and add the device through Home Assistant’s
ESPHome integration.
The climate entity will report state after receiving a valid status from the AC.
logger:
baud_rate: 0
external_components:
- source: github://akrabi/hisense_ac_esphome
components: [hisense_ac]
uart:
id: uart_bus
tx_pin: GPIO17
rx_pin: GPIO16
baud_rate: 9600
climate:
- platform: hisense_ac
name: "Air Conditioner"
uart_id: uart_bus
temperature_unit: CELSIUS
display:
name: "Display"
Remove display if your unit does not support it. For optional sensors,
diagnostics and multi-room examples, see the
configuration guide.
By default, Home Assistant shows device-reported state. For immediate control
feedback followed by reconciliation, see
optimistic and migration notes.
❓ Frequently asked questions
Does this work without the Hisense cloud?
Yes. After setup, Home Assistant communicates with the ESP32 over your local
network, and the ESP32 communicates with the AC over RS-485. Normal control does
not require a vendor account or cloud service. Downloading ESPHome and this
component for installation or updates requires internet access.
Can I flash ESPHome onto the original Hisense Wi-Fi module?
This project documents replacing the original module with an ESP32 and an
RS-485/UART adapter, not reflashing the stock module. Check the
confirmed AC and module combinations and
wiring requirements before buying parts.
Is this a HACS integration or an infrared remote controller?
Neither. Install hisense_ac as an
ESPHome external component
on the ESP32, then use Home Assistant’s ESPHome integration. It communicates
directly with the AC over a wired RS-485 connection rather than sending infrared
commands.
Will Home Assistant reflect changes made with the physical remote?
Yes, when the AC reports a supported status, the component updates Home Assistant
with device-reported state, including physical-remote changes. Optional controls
and feedback vary by model; preset feedback is not verified. See
state reporting and limitations.
For missing or stale updates, start with
hardware troubleshooting and
debug logging.
📚 Documentation and support
Contributions are welcome. Remove passwords, API keys and other secrets from
logs and configurations before sharing.
If this component helps you, open the repository
and click ⭐ Star to bookmark it, use Watch → Custom → Releases for release
notifications, or contribute a compatibility report or pull request.
🙏 Acknowledgments
This project was built based on esphome_airconintl.
⚠️ Disclaimer
USE AT YOUR OWN RISK: This component is provided “as is” without warranty of any kind, express or implied. The author(s) and contributors of this component take no responsibility for any damage to your air conditioning unit, ESP32 device, or any other equipment that may occur as a result of using this component. By using this component, you acknowledge and agree that you are doing so at your own risk and that you will be solely responsible for any damage that may occur to your equipment.
📄 License
This project is released under the MIT License.
评论