# Piloter une clim Mitsubishi en local avec ESP32, CN105 et MQTT

Guide synthétique — Julien Robert — CC BY 4.0

## Résultat

Un ESP32 dialogue directement avec le port CN105 de l'unité intérieure. ESPHome publie une entité `climate` en MQTT, découverte automatiquement par Home Assistant. La télécommande infrarouge reste utilisable.

## Matériel

- Un **Adafruit ESP32 Feather V2 avec headers** pour la qualité, ou un **ESP32-WROOM-32 DevKit 30 broches USB-C** pour le prix.
- Un câble **JST PA 2,0 mm PAP-05V-S vers Dupont 2,54 mm femelle, 5 broches, 26 AWG, 20 cm**.
- Une alimentation 230 V AC vers 5 V DC réellement isolée : **RECOM RAC05-05SK** intégrée dans un montage protégé ou **Mean Well HDR-15-5** en coffret sur rail DIN.
- Un boîtier isolant, des borniers protégés et un câble USB-C capable de transférer les données.

## Câblage CN105

Ne faites jamais confiance aux couleurs du faisceau. Travaillez avec les numéros de broches du connecteur.

| CN105 | Fonction unité intérieure | ESP32 |
|---:|---|---|
| 1 | 12 V | Non connecté |
| 2 | GND | GND |
| 3 | 5 V | Non connecté avec l'alimentation externe recommandée |
| 4 | TX de la clim | GPIO25, RX ESP32 avec pull-up |
| 5 | RX de la clim | GPIO26, TX ESP32 |

La règle est : **TX clim → RX ESP32** et **TX ESP32 → RX clim**.

## Alimentation

Sur les modèles documentés où l'unité intérieure est alimentée par l'unité extérieure, il existe environ **230 V AC entre S1 et S2**. L'alimentation isolée 5 V se reprend uniquement entre S1 et S2, après vérification du manuel du modèle et par une personne compétente.

**Ne jamais se reprendre sur S3.** S3 appartient à la liaison de communication intérieure/extérieure. Mitsubishi documente environ 24 V DC entre S2 et S3 sur certaines gammes et précise que cette liaison n'est pas isolée du secteur par un transformateur.

Couper au disjoncteur et contrôler l'absence de tension avant toute intervention. Séparer physiquement secteur et basse tension. Ne pas alimenter simultanément l'ESP32 par le split et par l'USB-C sans circuit de sélection de source.

## Firmware

Télécharger `mitsubishi-cn105-mqtt.yaml` et `secrets.example.yaml` depuis la page. ESPHome 2026.4 ou ultérieur fournit le composant natif `mitsubishi_cn105`.

Points essentiels :

- UART à 2400 bauds, 8 bits, parité paire, 1 stop (`8E1`) ;
- logger série désactivé avec `baud_rate: 0` ;
- MQTT Discovery actif ;
- `idf_send_async: true` pour éviter de bloquer la boucle principale ;
- `reboot_timeout: 0s` pour que la clim continue localement si le broker tombe ;
- pas de bloc `api:` pour une installation MQTT uniquement.

## Premier flash avec Codex ou Claude Code

Relier uniquement l'ESP32 à l'ordinateur par USB-C. Créer un dossier vide, y lancer `codex` ou `claude`, puis coller le prompt fourni sur la page. L'agent doit détecter le port série, créer les fichiers, demander les secrets, valider, compiler et demander confirmation avant le flash.

Commandes manuelles équivalentes :

```bash
esphome config mitsubishi-cn105-mqtt.yaml
esphome run mitsubishi-cn105-mqtt.yaml
esphome logs mitsubishi-cn105-mqtt.yaml
```

## Dépannage

- `NOT CONNECTED` : contrôler le GND puis inverser TX et RX seulement.
- ESP32 hors ligne : sortir l'antenne du caisson métallique et vérifier le 5 V sous charge.
- Pas d'entité Home Assistant : vérifier l'intégration MQTT, le préfixe `homeassistant` et les ACL du compte.
- Toujours aucune trame à 2400 bauds : consulter le manuel de service ; certaines unités utilisent 9600 bauds.

## Sources

- ESPHome — Mitsubishi CN105 : <https://esphome.io/components/climate/mitsubishi_cn105/>
- ESPHome — MQTT : <https://esphome.io/components/mqtt/>
- Mitsubishi Electric — documentation d'installation S1/S2/S3 : <https://www.mitsubishielectric.com.au/wp-content/uploads/2022/02/Installation_Manual-SLZ-KF25-60VA3_IM_BH79A415H01.pdf>
- Mitsubishi Electric — brochage CN105 : <https://www.mitsubishi-electric.co.nz/materials/PRODUCT/Aircon-VRF/PEFY-P_VMA-E/03_Manuals/1_Operation/Previous/OM_PEFY-P_VMA%28L%29-E_MEE10K030.pdf>
- JST PAP-05V-S : <https://www.digikey.com/en/products/detail/jst-sales-america-inc/PAP-05V-S/759977>

Ce guide ne remplace pas le manuel de service de l'unité ni les règles électriques locales. Les marques citées appartiennent à leurs propriétaires.
