MHI L/L warmtepomp / airco aansturen via een esp

[LinuZZ]

Na diverse verzoeken in het Het MHI L/L warmtepomp/airco topic topic, hierbij een eigen topic voor het aansturen van de MHI airco units via een esp module.

Waarom je airco aansturen via een ESP?

1. Omdat het kan
2. Lokaal aansturen kan sneller en betrouwbaarder zijn
3. Je kunt het integreren in je eigen domotica systeem (Home Assistant, Domoticz, etc)
4. Je bent niet afhankelijk van de cloud diensten van Mitsubishi

Benodigdheden

Voor het besturen van de airco via een ESP module zijn een aantal opties mogelijk. Kort gezegd komt het erop neer dat je een esp nodig hebt voor de communicatie en wat voltage omzetting / stabilisatie om de esp module aan te sluiten op de airco.

• Je kunt een kant en klare module kopen bij https://tweakers.net/gallery/192109/aanbod/
• Er is een kant en klare UniversalAircoController die werkt met sommige software versies https://github.com/ginkag...AircoController/README.md
• Je kunt de handleiding op https://github.com/ginkag...master/JLCPCB/Hardware.md gebruiken om een PCB te laten maken via JLCPCB of een andere PCB fabrikant.
• Je kunt een module zelf bouwen door de handleiding in het original project te volgen: https://github.com/absalo...l/blob/master/Hardware.md

Software opties

• MHI-AC-Ctrl-ESPHome - Een ESPHome integratie voor MHI airco's
• MHI-AC-Ctrl-Atom - Een aangepaste versie van MHI-AC-Ctrl atom esp32 s3 ondersteuning en verbeterde webinterface
• MHI-AC-Ctrl - Een alternatieve firmware voor het besturen van MHI airco's met een ESP8266
• mhi-ac-ctrl-esp32-c3 - MHI-AC-Ctrl esphome variant met ondersteuning voor de ESP32-C3 en hardware SPI
• esp32_homekit_mhi - Een HomeKit integratie voor MHI airco's met een ESP32 (niet door mij getest)

Installatie

Voor het inbouwen van de wifi module moet je de airco unit openen. In de volgende video wordt dit gedemonstreerd:

Opmerkingen

• Zorg ervoor dat je de juiste hardware versie en software versie gebruikt die compatibel is met jouw MHI airco unit.
• Wees voorzichtig bij het werken met elektrische apparaten en volg de veiligheidsrichtlijnen.
• Dit project is niet officieel ondersteund door Mitsubishi en kan mogelijk de garantie van je airco beïnvloeden.
• Medeauteurs voor dit topic zijn welkom .

[Soepstengel]

Vandaag een unit aangepast zodat het met een MHI-AC-Ctrl-ESPHome unit werkt. Ik had al een wifi unit in mijn airco zitten (SRK20ZS-WF) maar ik was ontevreden over de temperatuur bediening waarbij de offset enorm fluctueerde bij het verwarmen omdat alles in die unit blijft hangen.

In de repository staat een voorbeeld om een externe temperatuur sensor aan te haken via ESPHome wat ik wel interessant vond, maar ik kwam er niet achter of er een fallback is wanneer de sensor uitvalt (bijvoorbeeld als een draadloze sensor uit gaat omdat de batterij leeg is). Vandaag even getest, en ja hij valt terug op de interne sensor als de externe ingestelde sensor weg valt, zie hieronder:


Dus dit werkt geweldig voor mijn doeleinden! Als ik 20 graden instel houdt die netjes de 20 graden aan zonder gezeur. Daarnaast heb ik nu ook veel meer informatie in HA staan, waar onder defrost informatie. Ik ga binnenkort nog 2 units bestellen voor de andere airco's hier in huis

[Maarten60]

Super dat er een aparte pagina voor de aansturing via esp is. Dus maar meteen een vraag
Ik heb een update naar ESPHome builder gedaan naar 2025.11.2 en krijg een foutmelding dat de packages niet gevonden worden.

code:

Failed config

packages: [source /config/esphome/ac-boven.yaml:35]
  
  couldn't find remote ref atom.
  remote_package: 
    url: https://github.com/fonske/MHI-AC-Ctrl-ESPHome/
    ref: atom
    refresh: always
    files: 
      - confs/wifi-info.yml
      - confs/labels-en.yml

Mogelijk is de code verplaatst, weet ook niet of er een relatie is met de update.

Ik gebruik nu

code:

## version V4.2 Atom S3 Lite

packages:
  remote_package:
    url: https://github.com/fonske/MHI-AC-Ctrl-ESPHome/
    ref: atom
    refresh: always
    files: [ 
            #confs/onewire.yml,
            #confs/debug.yml,
            confs/wifi-info.yml,
            confs/labels-en.yml,
            #confs/labels-nl.yml,
           ]

Iemand een suggestie?
Verder staat er issue over het arduino of esp-IDF framework open. Moet ik daar nog iets voor veranderen?

[LinuZZ]

Dat is de repo van @AUijtdehaag misschien kan hij je verder helpen of staat er iets in de documentatie

De ginkage release is bijgewerkt vorige maand.

[AUijtdehaag]

@Maarten60
De atom versie heb ik offline gehaald vanwege mhi_ac_ctrl_loop errors
Updaten heeft ook totaal geen nut, er is geen nieuwe code bijgekomen.
Werkt eerder averechts dat esphome weer eens de code sloopt met updates.

@LinuZZ
Is de UniversalAircoController code wel fout meldings loos incl framesize 33?
Als ik die op een Atom zet krijg ik dezefde mhi_ac_ctrl_loop errors namelijk.

[ Voor 38% gewijzigd door AUijtdehaag op 03-12-2025 19:33 ]

[LinuZZ]

AUijtdehaag schreef op woensdag 3 december 2025 @ 19:28:


@LinuZZ
Is de UniversalAircoController code wel fout meldings loos incl framesize 33?

Ik verwacht van niet eerlijk gezegd. Ik heb de hardware spi nog op mijn wensenlijstje staan, dat zal deze problemen oplossen verwacht ik, maar ik merk dat ik minder tijd heb dan ik zou willen

[HYM1100S]

AUijtdehaag schreef op woensdag 3 december 2025 @ 19:28:
@Maarten60
De atom versie heb ik offline gehaald vanwege mhi_ac_ctrl_loop errors
Updaten heeft ook totaal geen nut, er is geen nieuwe code bijgekomen.
Werkt eerder averechts dat esphome weer eens de code sloopt met updates.

Zelfde vraag vanuit deze kant.
Zit nog op versie 2025.6.3 met 2 atom bordjes en had hem graag geupdate naar de laatste versie vanwege: https://github.com/esphom...ories/GHSA-mxh2-ccgj-8635

Wat is jouw advies daarin? Op zoek naar een andere repo?

[michaelvo]

Voor de geïnteresseerden, ik heb mijn M5stack Atom S3 Lite geüpdatet naar ESPHome 2025.12.2. Ik had al eerder een keer door een update de mhi_ac_ctrl_core.loop errors geïntroduceerd en die zitten er nu nog steeds in maar dat lijkt de werking verder niet echt kwaad te doen. Hierbij de door mij gebruikte yaml:

YAML:

esphome:
  name: ac-overloop
  friendly_name: AC overloop
  min_version: 2024.6.0
  platformio_options:
    # Run CPU at 160Mhz to fix mhi_ac_ctrl_core.loop error: -2
    board_build.f_cpu: 160000000L

esp32:
  board: esp32-s3-devkitc-1
  framework:
    type: arduino

logger:
  level: DEBUG
  baud_rate: 0

ota:
  - platform: esphome

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

  # Enable fallback hotspot (captive portal) in case wifi connection fails
  ap:
    ssid: ac-overloop
    password: ac-overloop-password

captive_portal:

external_components:
  - source: github://ginkage/MHI-AC-Ctrl-ESPHome@master
    components: [MhiAcCtrl]

api:
  reboot_timeout: 0s
  services:
    - service: set_external_room_temperature
      variables:
        temperature_value: float # temperature to set in Celsius
      then:
        - climate.mhi.set_external_room_temperature:
            temperature: !lambda "return temperature_value;"

MhiAcCtrl:
  # Only 20 (legacy) or 33 (includes 3D auto and vertical vanes) possible.
  # If you encounter mhi_ac_ctrl_core.loop error: -2 errors, change the frame_size to 20
  frame_size: 33
  sck_pin: 8
  mosi_pin: 38
  miso_pin: 39
  initial_vertical_vanes_position: 1
  initial_horizontal_vanes_position: 3
  # Update the following to change the default room temp timeout
  room_temp_timeout: 60

button:
  - platform: restart
    name: Restart
    entity_category: diagnostic

climate:
  - platform: MhiAcCtrl
    name: "MHI Air Conditioner"
    temperature_offset: true
    visual_min_temperature: 17.0
    visual:
      temperature_step:
        target_temperature: 0.5
        current_temperature: 0.1

time:
  - platform: homeassistant
    id: homeassistant_time

binary_sensor:
  - platform: MhiAcCtrl
    defrost:
      name: "Defrost"
    vanes_3d_auto_enabled:
      name: "3D Auto"

sensor:
  - platform: uptime
    name: Uptime
  - platform: wifi_signal
    name: WiFi Signal
    update_interval: 60s
  - platform: MhiAcCtrl
    outdoor_temperature:
      name: "Outdoor temperature"
    return_air_temperature:
      name: "Return air temperature"
    outdoor_unit_fan_speed:
      name: "Outdoor unit fan speed"
    indoor_unit_fan_speed:
      name: "Indoor unit fan speed"
    compressor_frequency:
      name: "Compressor frequency"
    indoor_unit_total_run_time:
      name: "Indoor unit total run time"
    compressor_total_run_time:
      name: "Compressor total run time"
    current_power:
      name: "Current power"
    energy_used:
      name: "Energy used"
    indoor_unit_thi_r1:
      name: "Indoor (U-bend) HE temp 1"
    indoor_unit_thi_r2:
      name: "Indoor (capillary) HE temp 2"
    indoor_unit_thi_r3:
      name: "Indoor (suction header) HE temp 3"
    outdoor_unit_tho_r1:
      name: "Outdoor HE temp"
    outdoor_unit_expansion_valve:
      name: "Outdoor unit exp. valve"
    outdoor_unit_discharge_pipe:
      name: "Outdoor unit discharge pipe"
    outdoor_unit_discharge_pipe_super_heat:
      name: "Outdoor unit discharge pipe super heat"
    protection_state_number:
      name: "Compressor protection code"
    error_code:
      name: "Error code"
    vanes_pos:
      name: "Vanes"
    vanesLR_pos:
      name: "Vanes Left/Right"

text_sensor:
  - platform: version
    name: ESPHome Version
  - platform: wifi_info
    ip_address:
      name: IP
    ssid:
      name: SSID
    bssid:
      name: BSSID
  - platform: MhiAcCtrl
    protection_state:
      name: "Compressor protection status"

select:
  - platform: MhiAcCtrl
    vertical_vanes:
      name: Fan Control Up Down
    horizontal_vanes:
      name: Fan Control Left Right
    fan_speed:
      name: "Fan Speed"

switch:
  - platform: MhiAcCtrl
    vanes_3d_auto:
      name: "3D Auto"

[DaWizza]

2 jaar na aanschaf vd airco (die wel met wifi module geleverd werd terwijl dit niet gevraagd/betaald was) ging de module gisteren kapot.
Gelukkig had ik al een esp bordje liggen van @AUijtdehaag , die heb ik vandaag geplaatst.

Het was wel ff klooien met de yaml code, daar moest een api key in. Nergens op GitHub bij de handleidingen heb ik kunnen vinden waar die dan vandaan moet komen.

Op https://esphome.io/components/api/ uiteindelijk een generator gevonden die je kunt gebruiken om iets op je scherm te toveren. Flashen, inprikken en klaar. Met de ongeveer 25 sensoren heb je ook veel meer info dan de standaard wifi module

[LinuZZ]

DaWizza schreef op vrijdag 20 februari 2026 @ 21:21:
2 jaar na aanschaf vd airco (die wel met wifi module geleverd werd terwijl dit niet gevraagd/betaald was) ging de module gisteren kapot.
Gelukkig had ik al een esp bordje liggen van @AUijtdehaag , die heb ik vandaag geplaatst.

Het was wel ff klooien met de yaml code, daar moest een api key in. Nergens op GitHub bij de handleidingen heb ik kunnen vinden waar die dan vandaan moet komen.

Op https://esphome.io/components/api/ uiteindelijk een generator gevonden die je kunt gebruiken om iets op je scherm te toveren. Flashen, inprikken en klaar. Met de ongeveer 25 sensoren heb je ook veel meer info dan de standaard wifi module

Super dat het gelukt is. Ik heb de esphome api key generator erbij gezet in de documentatie

[hberntsen]

Mijn project ( https://github.com/hberntsen/mhi-ac-ctrl-esp32-c3 ) dat gebruik maakt van hardware SPI heeft nu geen chip select loopback meer nodig via GPIO pinnen. Daarmee moet de code op meer bordjes gelijk al kunnen werken. Op mijn ESP32-C3 bordjes werkt het. Ik ben bang dat het op een ESP32 niet werkt vanwege de SPI_LL_SLAVE_NEEDS_CS_WORKAROUND in de ESP-IDF.

Verder ben ik nog aan het testen met een ESP32-S3. Daar werkt de code wel, maar hij is alleen maar stabiel als ik de SPI klok op pin 43 zet (niet ideaal, 43 is de uart tx pin). Anders krijgt de SPI transactie regelmatig een paar bitjes teveel en heel soms flink wat te weinig. Ook de USB logging open hebben staan geeft dat probleem. Ik tast nog in het duister waar dat probleem vandaan kan komen.

[ Voor 3% gewijzigd door hberntsen op 20-03-2026 17:41 ]

[hberntsen]

@LinuZZ De link naar mhi-ac-ctrl-esp32-c3 mag aangepast worden naar https://github.com/hberntsen/mhi-ac-ctrl-esp32 . Ik heb C3 uit de naam gehaald omdat ik nu ook de S3 zelf ondersteun, zij het met de SPI klok op pin 43 zoals hierboven omschreven.

Ik heb ook een voorbeeld toegevoegd voor het gebruik van een externe sensor, inclusief slider om het maximale temperatuurverschil te beperken. Daarmee kan ik mijn AC met een lager vermogen laten verwarmen / koelen. Hoe de AC daar op reageert zal per model kunnen verschillen.

[Theetjuh]

@hberntsen ik heb nu een boardje van @AUijtdehaag, is het Wemos d1 mini boardje simpel te vervangen met de ESP-C3-32S(4M)-KIT of komt er meer bij kijken?

[hberntsen]

@Theetjuh in principe wel ja. Dan moet je een bordje vinden dat met dezelfde pinout werkt. Ik heb er geen ervaring mee maar een snelle zoekopdracht levert https://nl.aliexpress.com/item/1005010741726530.html op. Als ik dat schema vergelijk met https://github.com/fonske/MHI-AC-Ctrl-ESPHome/blob/master/JLCPCB/Hardware.md , dan past die qua functie van de pinnen. De 22.86 afstand tussen de pinnen komt ook overeen met een WeMos D1 Mini.

Ik ben wel benieuwd: waarom zou je 'm willen vervangen ?

[ Voor 15% gewijzigd door hberntsen op 29-03-2026 19:40 ]

[lonkhuijzen]

Qua formaat en pins past de wemos lolin s3 mini uitstekend op de espac interface van nodo-shop.nl

Die is qua pins 1:1 met de d1 mini

Ik had deze als proef uitstekend werkend maar dan wel met mhi_ac_ctrl_core.loop errors.

[hberntsen]

@lonkhuijzen Dat is een ESP32-S3. Mijn ESP32-S3 bord werkt alleen stabiel als ik de SPI clock aan pin 43 hang, zie https://esp32.com/viewtopic.php?t=47883 . Ik ben nog op zoek naar een verklaring. Andere pinnen werken mogelijk wel stabiel genoeg in jouw situatie (ik ben benieuwd).

@Theetjuh Ik zie hier nog een ander bord genoemd worden, dat lijkt mij ook een mogelijkheid.

[ Voor 16% gewijzigd door hberntsen op 29-03-2026 20:05 ]

[Theetjuh]

hberntsen schreef op zondag 29 maart 2026 @ 19:36:
Ik ben wel benieuwd: waarom zou je 'm willen vervangen ?

Aangezien de 8266 al even EoL is, hij werkt nu nog prima hoor, maar iets meer toekomst gericht zou mooi zijn vandaar.

[hberntsen]

👍. Ik heb maar kort de ginkage versie op mijn C3 geprobeerd, daar kreeg ik wel een hoop loop errors. Mogelijk zit je daarmee dus wel vast aan mijn implementatie met hardware SPI. In de praktijk zijn de verschillen in functionaliteit klein.

[HarmoniousVibe]

Mijn excuses als het een vraag is die elders al is beantwoord, maar ik heb zelf 3 x een SRK-ZSX (Diamond) met ingebouwde wifi (WF-RAC). Ik kan deze reeds lokaal benaderen via deze Home Assistant-HACS-integratie

Wat zijn de voordelen deze oplossing met ESP boven een lokale WF-RAC-aansturing? 1 daarvan is natuurlijk dat MHI zou kunnen besluiten the local API uit te zetten, maar dat zie ik niet snel gebeuren. Het is niet zo dat hun cloudoplossing geld in het laatje brengt en/of zo vermarketbaar is

Of is het (vooral) voor oudere units die geen wifi-module hebben?

[LED-Maniak]

Met de lokale oplossingen kan je veel meer gegevens uitlezen dan alleen met de wf-rac integratie. Met de oplossingen in de TS verlies je wel de mogelijkheden van je WF-RAC module.

[ Voor 29% gewijzigd door LED-Maniak op 19-05-2026 11:10 ]

[eiPionezero]

Sinds februari hangt hier de volgende airco in huis:

• buitenunit: MHI SCM 40 ZS-W
• slaapkamer: MHI SRK20 ZS-W
• woonkamer: MHI SRK35 ZS-W

Sinds een halfjaartje druk aan het spelen met HA, dus leek het mij gistermiddag een goed idee de airco's ook maar eens te integreren. Bij Tinytronics twee stuks van de volgende onderdelen gehaald:

• https://www.tinytronics.nl/nl/development-boards/microcontroller-boards/met-wi-fi/universele-airco-controller-esp32-s3
• https://www.tinytronics.nl/en/cables-and-connectors/cables-and-adapters/jst-compatible/jst-xh-female-to-dupont-female-compatible-cable-5p-15cm

Gisteravond geprobeerd met deze config de boel werkend te krijgen: https://github.com/ginkage/MHI-AC-Ctrl-ESPHome/blob/master/UniversalAircoController/README.md
Helaas kreeg ik te maken met het control loop issue waar al voor gewaarschuwd werd: https://github.com/ginkage/MHI-AC-Ctrl-ESPHome/issues/196

Daarom vanochtend een tweede poging gedaan met deze ESPHome code: https://github.com/hberntsen/mhi-ac-ctrl-esp32. Deze bleek wel netjes zonder issues te draaien

Dus, voor de geïnteresseerden die ook een MHI uit 2025 hebben hangen en deze in HA willen integreren: bestel de hierboven genoemde onderdelen, bestel ook https://www.tinytronics.nl/en/cables-and-connectors/connectors/pin-headers/male/40-pins-header-male-90-degrees mee indien je niet nog wat op voorraad heb liggen, en met onderstaande config wordt je hopelijk een net zo'n blije gebruiker als ik:

YAML:

substitutions:
  mhi_device_id: "mhi_ac_slaap"
  device_id: "airco_ctrl"
  device_name: "airco slaapkamer"

esphome:
  name: ${device_id}
  friendly_name: ${device_name}
  platformio_options:
    board_build.flash_mode: dio

esp32:
  board: esp32-s3-devkitc-1
  cpu_frequency: 80MHz
  framework:
    type: esp-idf

logger:
  level: INFO
  baud_rate: 0

api:
  encryption:
    key: !secret esphome_api_key
  on_client_connected:
    then:
      - switch.turn_on: ${device_id}_active_mode

ota:
  - platform: esphome
    password: !secret esphome_ota_pwd
    
wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_pwd
  ap:
    ssid: "${device_name} fallback"
    password: "12345678"

captive_portal:

external_components:
  - source: github://hberntsen/mhi-ac-ctrl-esp32@master
    components: [MhiAcCtrl]

MhiAcCtrl:
  id: ${mhi_device_id}
  mosi_pin: GPIO48
  miso_pin: GPIO34
  sclk_pin: GPIO21
  use_long_frame: true

climate:
  - platform: MhiAcCtrl
    mhi_ac_ctrl_id: ${mhi_device_id}
    id: ${device_id}
    name: ${device_name}

sensor:
  - platform: MhiAcCtrl
    mhi_ac_ctrl_id: ${mhi_device_id}
    climate_current_temperature:
      id: climate_current_temperature
      name: Indoor temperature
      accuracy_decimals: 1
      filters:
        - heartbeat: 10s
    outdoor_air_temperature:
      name: Outdoor temperature
    current:
      # in steps of 14/51A
      name: Current
    power:   
      # current multiplied by 230V
      name: Power
    energy_used:
      # in steps of 250Wh
      # resets every now and then
      name: Energy used
    compressor_frequency:
      name: Compressor frequency
    indoor_fan_speed:
      name: Indoor fan speed
    outdoor_fan_speed:
      name: Outdoor fan speed

binary_sensor:
  - platform: MhiAcCtrl
    mhi_ac_ctrl_id: ${mhi_device_id}
    defrosting:
      name: Defrosting

switch:
  - platform: MhiAcCtrl
    mhi_ac_ctrl_id: ${mhi_device_id}
    active_mode:
      name: Active mode
      id: ${device_id}_active_mode

[hberntsen]

@eiPionezero Leuk om te horen dat het werkt! Zou je eens de frame_errors sensor toe willen voegen? Ik ben wel benieuwd of die bij jou ook oploopt op de UAC versie v1.0. Binnenkort ontvang ik een testexemplaar van een nieuwe versie die dat zou moeten stabiliseren.

[eiPionezero]

@hberntsen Yes, het werkt heerlijk, dank voor je werk! Zit nu op telefoon, zal vanavond de error count sensors toevoegen.

Wat mij de afgelopen dagen wel opvalt is dat de door de airco gemelde binnentemperatuur meerdere graden afwijkt van een losse sensor welke ongeveer anderhalve meter onder de airco staat. Zowel in stand-by als na een aantal uren draaien is dit het geval. Een tweede punt wat mij opviel is dat de gemelde temperatuur bij beide binnen units 1 an 2 graden onder de target temperatuur zit: in de slaapkamer scheelt het 1.5 graden; in de woonkamer 2 graden. Geen idee waarom; ik neem aan dat dit een MHI dingetje is en geen UAC bug? Heb geen externe sensor oid in gebruik: mijn doel is altijd KISS; alles wat ik niet toevoeg gaat ook niet per ongeluk kapot

[hberntsen]

Dit is een MHI dingetje, tenzij je een externe temperatuur aanlevert via de UAC verandert een WiFi module niets aan dat regelgedrag.

Afhankelijk van je instellingen hanteert de airco een ander setpoint dan je zelf instelt. Je kan dit met de set_temperature sensor zien. Zo heb ik mijn airco bijvoorbeeld op 23 graden koelen gezet maar laat de set_temperature sensor zien dat hij daar zelf 22 van maakt. Dat komt in dit geval doordat 3D auto gebruikt wordt, dan vinden ze bij MHI dat blijkbaar beter. Bij verwarmen zit hij er standaard 2 graden boven en met 3D auto nog een keer een graad als ik het mij goed herinner.

Op mijn werkkamer gebruik ik een externe sensor en wat code die de sensorwaarde manipuleert om wel precies die ingestelde temperatuur te bereiken (staat in de repo). In de woonkamer doen we het met de interne sensor gewoon op gevoel en kijken we minder naar het getalletje.