Removing the chinese wifi from my minisplit with ESPHome.

Why do this?

I have multiple AC units on my property and 3 of those are from MRCool. Now given the issues I’ve had with their non-existent customer service I CANNOT recommend them. But I have them so I am removing their wifi dongle that phones home to their servers. I am all about NOT having devices with unknown code on my network, especially once from china. Using a few parts and the Midea Integration from ESPHome I was able to strip out their module and have direct, local control over my split units.

ID10T NOTICE: ALL INFORMATION PROVIDED HERE IS PROVIDED AS-IS. I AM NOT TO BE HELD LIABLE IF YOU BREAK SOMETHING, CATCH SOMETHING ON FIRE, OR WHATEVER IF YOU DECIDE TO DO SOMETHING IN THIS GUIDE.

Making the Adapter

Instead of bodging up some PCB I used off the shelf parts and the ONLY soldering involved is the 4 wires to the USB breakout board to the ESP-01 adapter board. That adapter board has a built in 5V to 3.3V step down and the proper pullups to use the cheap ESP-01 modules with it. Click on the pictures to go to amazon to get the parts (these are affiliate links) that I used for this build.

USB Breakout Board
ESP-01 Modules
ESP-01 USB Programmer
ESP-01 Adapter
Female Dupont jumper wires

If you look on the ESP-01 Adapter board you will see it has TX RX, VCC, and GND labeled.

Connecting the ESP-01 Adapter board to the USB Breakout Adapter Board

  1. Connect the GND to GND solder pad on the USB breakout adapter
  2. Connect VCC to the VBUS solder pad on the USB breakout adapter
  3. Connect TX to the D+ solder pad on the USB breakout adapter
  4. Connect RX to the D- solder pad on the USB breakout adapter

Now this wiring listed works for my MRCool branded units and they are kind enough to label them on the PCB that accepts their wifi dongle. I removed and disconnected the whole wifi dongle “box” from the unit and disconnected it to work on it on my bench. Now if you don’t get communication between the split unit later on in the guide when we setup ESPHome then you will want to swap the TX and RX pins. If your split unit PCB is not labeled like mine was then you’ll have a 50/50 shot of getting the TX RX correct. It won’t hurt anything to get it swapped, it just won’t work. I used Dupont jumper wires with one end cut off and stripped to make the connection between the two. Once I had the USB breakout end soldered up I put some hot glue on there and then wrapped it in electrical tape while it was still hot to make my own strain relief for the wires.

“USB” Connector – Force it in

If you notice the USB connector on mine is not really USB. It has extra edges on it to prevent insertion of a normal USB device in. Luckily you can just force it in and it works.

ESPHome Setup

Now I am going to assume you know how to use ESPHome. If you don’t then read their documentation. At this point put the ESP-01 into the programmer and plug it into your PC. Then use the ESPHome Wizard to do the initial flashing.

Below is the YAML code i used for my setup and I did have to manually add certain modes for my unit. It does have auto-detect but on my MRCool units it didn’t work 100%. There is also code added to allow you to disable and enable the annoying beep they make when you change a setting. Basically your mileage may vary and read the ESPHome docs on the Midea Air integration to learn how to fine tune it for your particular unit if my example doesn’t work. I also intentionally omitted the HEAT mode since I don’t use it here. Once you have the device flashed you can install it on the ESP-01 adapter board that we wired up earlier and put it in the unit. I did mine with the power on but if you are paranoid you can cut power to the minisplit before you plug in the new adapter. Its all 5V DC so its not going to hurt you.

I used hot glue to secure the ESP-01 adapter board in the plastic mount from the minisplit.

Once its all installed and you check the ESP logs to see if its communicating with your split unit then go ahead and add it to Home Assistant as you would any other ESPHome device using the Home Assistant integrations feature.

esphome:
  name: garage-office-ac

esp8266:
  board: esp01_1m

# Disable logging over UART (required)
logger:
  baud_rate: 0

# Enable Home Assistant API
api:
  encryption:
    key: "REDACTED"

ota:
  password: "REDACTED"

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

  # Enable fallback hotspot (captive portal) in case wifi connection fails
  ap:
    ssid: "Garage-Office-Ac"
    password: "REDACTED"

captive_portal:

# UART settings for Midea dongle (required)
uart:
  tx_pin: GPIO1         # hardware dependant
  rx_pin: GPIO3         # hardware dependant
  baud_rate: 9600

# Main settings
climate:
  - platform: midea
    name: Garage Office AC     # Use a unique name.
    autoconf: false
    beeper: false                
    visual:                     
      min_temperature: 16 °C    
      max_temperature: 30 °C    
      temperature_step: 1 °C  
    supported_modes:            # All capabilities in this section detected by autoconf.
      - FAN_ONLY                # This capability is always used.
      - COOL
      - DRY
    supported_presets:          # All capabilities in this section detected by autoconf.
      - BOOST
    supported_swing_modes:
      - VERTICAL                # This capability is always used.

switch:
  - platform: template
    name: Garage Office AC Beeper
    icon: mdi:volume-source
    optimistic: true
    turn_on_action:
      midea_ac.beeper_on:
    turn_off_action:
      midea_ac.beeper_off:

I know this isn’t a SUPER detailed guide but this should be more than enough to get you going if you know what you are doing 🙂 Now go enjoy one less chinese code run wifi device on your network!

Affiliate disclosure: I use affiliate links on my site to help generate revenue. These do not cost you more to purchase and help pay for costs associated with my site hosting and projects. I appreciate your support!

12 thoughts on “Removing the chinese wifi from my minisplit with ESPHome.”

  1. Thank you very much for inspiring me to do this myself. I was curious though, I did everything, I believe successfully because I can echo the tx/rx and see traffic within my ESPHome logs. The problem I see is that when connected to the Mr. Cool DIY 24 that the ESPHome Logs just say “Response timeout…”. Is this normal, does your Mr. Cool not respond either?

  2. will this adapter work?
    REMOVED FOR AFFILIATE LINK

    I’m making getting parts from ali express. the combined total for parts and shipping was 13 dollars.

  3. am i getting closer? … not sure if im on the right track. i opened up my split and we have the same exact parts. except mine is 16k btu. I spent all day trying to get the esp01 online with mdns issues but finally got it online after several hours…heres my paste bin of my yaml logs of my device.. any guidance is appreciated . thanks!

    https://pastebin.com/9kLJ7wy0

Leave a Comment

Your email address will not be published. Required fields are marked *

two × 1 =