Midea PortaSplit dans Home Assistant : configuration et tableau de bord

La Midea PortaSplit peut être commandée directement sur le réseau local via Home Assistant grâce à une intégration communautaire. En sept étapes, de l’association dans l’application au tableau de bord, vous obtenez une commande locale avec indicateurs et graphiques d’historique. Le tableau de bord, les capteurs auxiliaires et le thème sont disponibles dans le dépôt GitHubpfstr/ha-portasplit-dashboard.

L’illustration montre le tableau de bord final en mode refroidissement avec les indicateurs, les commandes et les historiques des dernières 24 heures.

La série compte trois parties : la partie 1 décrit la configuration, la partie 2 traite de la sécurisation du token, de la clé et du réseau domestique, tandis que la partie 3 met en contexte les avertissements concernant l’API cloud de Midea.

Fonctionnement de la commande locale

Après la configuration, les commandes sont envoyées directement de Home Assistant à la PortaSplit, sans passer par un serveur Midea. Sur les appareils utilisant le protocole V3, la PortaSplit n’accepte toutefois les commandes locales qu’avec deux valeurs propres à l’appareil : le token et la clé. Lors de la configuration, l’intégration récupère une seule fois les deux via le cloud Midea et les enregistre localement :

Einrichtung:   Home Assistant → Midea-Cloud → Token und Key
Betrieb:       Home Assistant → lokales Netz (6444/TCP) → PortaSplit

Les intégrations décrites sont issues de la communauté et ne sont officiellement prises en charge ni par Midea ni par Home Assistant. Des modifications du firmware ou du cloud peuvent influencer leur fonctionnement.

Quelle intégration choisir

Deux intégrations communautaires prennent en charge la PortaSplit :

Pour ma PortaSplit, j’utilise Midea AC LAN; les instructions et le tableau de bord reposent sur ses entités. Avec Midea Smart AC, les entités portent d’autres noms ; le tableau de bord ne peut alors être utilisé qu’après adaptation. Utiliser les deux intégrations simultanément avec le même appareil entraîne des problèmes d’état et n’est pas pertinent.

Prérequis

• Midea PortaSplit avec fonction Wi-Fi et un réseau Wi-Fi 2,4 GHz
• Application MSmartHome avec compte Midea
• Home Assistant à partir de la version 2024.10 (testé avec 2026.7), avec accès au répertoire de configuration /config, par exemple via l’add-on File editor, Samba ou SSH
• HACS pour la carte graphique apexcharts-card
• Accès réseau de Home Assistant à la PortaSplit sur le port 6444/TCP

Étape 1 : connecter la PortaSplit à MSmartHome

1. Installez l’application MSmartHome et connectez-vous avec le compte Midea.
2. Placez la PortaSplit en mode d’association Wi-Fi et connectez-la au réseau Wi-Fi 2,4 GHz.
3. Vérifiez que la PortaSplit peut être commandée via l’application.
4. Créez une réservation DHCP pour la PortaSplit dans le routeur afin qu’elle reçoive durablement la même adresse IP.

Si le routeur utilise le même SSID pour les bandes 2,4 et 5 GHz, l’association fonctionne généralement malgré tout. En cas de problème, un réseau Wi-Fi 2,4 GHz séparé peut aider temporairement.

Étape 2 : installer Midea AC LAN

Via HACS : ouvrez HACS, recherchez Midea AC LAN, téléchargez l’intégration et redémarrez Home Assistant.

Sans HACS : téléchargez directement l’archive de publication dans le répertoire custom_components. Dans une installation Docker, cela se fait avec docker exec -it homeassistant bash dans le conteneur ; sur Home Assistant OS, utilisez l’add-on Terminal :

mkdir -p /config/custom_components
cd /config/custom_components
wget https://github.com/wuwentao/midea_ac_lan/releases/download/v2026.9.2/midea_ac_lan.zip
unzip midea_ac_lan.zip -d midea_ac_lan
rm midea_ac_lan.zip

Le numéro de version actuel se trouve sur la page des publications du projet. Redémarrez ensuite Home Assistant via Paramètres, Système et Redémarrer. L’avertissement We found a custom integration midea_ac_lan which has not been tested by Home Assistant dans le journal est normal pour toute intégration personnalisée.

Étape 3 : ajouter la PortaSplit

Sous Paramètres, Appareils et services, Ajouter une intégration, recherchez Midea AC LAN. L’assistant de configuration demande successivement :

1. Action : Discover automatically.
2. Adresse IP : auto parcourt le réseau local. Si la PortaSplit se trouve dans un autre VLAN, saisissez son adresse IP, car la recherche par diffusion ne traverse pas les limites de VLAN.
3. Appareil : la PortaSplit apparaît comme <Geräte-ID> (Air Conditioner).
4. Connexion : compte, mot de passe et serveur. Pour un compte de l’application MSmartHome, sélectionnez SmartHome; si la connexion échoue, essayez NetHome Plus avec les mêmes identifiants. L’intégration récupère ainsi une seule fois le token et la clé.

L’appareil apparaît ensuite avec une seule entité climate.<geräte-id>_climate. L’identifiant de l’appareil est un nombre à 15 chiffres et est désigné ci-après par DEVICE_ID.

Étape 4 : activer les capteurs

Midea AC LAN ne crée par défaut que l’entité de climatisation. Sous Paramètres, Appareils et services, Midea AC LAN, Configurer, la boîte de dialogue d’options s’ouvre :

Après l’enregistrement, l’intégration crée les entités sans redémarrage, selon le modèle sensor.DEVICE_ID_indoor_temperature. Une PortaSplit (type d’appareil 0xAC, protocole V3) avec Midea AC LAN v2026.9.2 fournissait les valeurs suivantes en veille :

La PortaSplit ne possède pas de capteur d’humidité ; indoor_humidity reste donc vide. L’entité de climatisation connaît les modes Arrêt, Auto, Refroidissement, Déshumidification, Chauffage et Ventilation, des températures de consigne de 16 à 30 °C par pas de 0,5 °C ainsi que les vitesses de ventilation Silent, Low, Medium, High, Full et Auto.

Étape 5 : installer la carte graphique

Les graphiques d’historique utilisent apexcharts-card. Dans HACS, recherchez apexcharts-card et téléchargez-la. HACS enregistre la carte comme ressource de tableau de bord ; rechargez ensuite le navigateur une fois.

Étape 6 : configurer les capteurs auxiliaires et le thème

Le tableau de bord nécessite cinq capteurs auxiliaires : compresseur activé/désactivé, vitesse du ventilateur sous forme numérique pour le graphique à paliers, durée de fonctionnement et énergie depuis minuit, ainsi que l’heure du dernier rapport. Activez d’abord les packages et les thèmes dans configuration.yaml, si ce n’est pas déjà fait :

homeassistant:
  packages: !include_dir_named packages

frontend:
  themes: !include_dir_merge_named themes

Copiez ensuite packages/portasplit.yaml depuis le dépôt vers /config/packages/ et themes/portasplit.yaml vers /config/themes/, puis remplacez dans le fichier de package chaque DEVICE_ID par votre propre identifiant d’appareil. Le package contient :

template:
  - binary_sensor:
      - name: "PortaSplit Kompressor"
        unique_id: portasplit_kompressor
        icon: mdi:heat-pump-outline
        device_class: running
        state: >
          {% set f = states('sensor.DEVICE_ID_compressor_frequency') %}
          {% if f | is_number %}{{ f | float > 0 }}
          {% else %}{{ states('sensor.DEVICE_ID_realtime_power') | float(0) > 150 }}{% endif %}
  - sensor:
      - name: "PortaSplit Lüfterstufe"
        unique_id: portasplit_luefterstufe_num
        icon: mdi:fan
        state: >
          {% set m = state_attr('climate.DEVICE_ID_climate', 'fan_mode') %}
          {{ {'silent': 1, 'low': 2, 'medium': 3, 'high': 4,
              'full': 5, 'auto': 6}.get(m, none) }}
      - name: "PortaSplit letzte Meldung"
        unique_id: portasplit_letzte_meldung
        icon: mdi:sync
        device_class: timestamp
        state: "{{ states.climate['DEVICE_ID_climate'].last_reported }}"

sensor:
  - platform: history_stats
    name: "PortaSplit Laufzeit heute"
    unique_id: portasplit_laufzeit_heute
    entity_id: binary_sensor.portasplit_kompressor
    state: "on"
    type: time
    start: "{{ today_at() }}"
    end: "{{ now() }}"

utility_meter:
  portasplit_energie_heute:
    name: "PortaSplit Energie heute"
    unique_id: portasplit_energie_heute
    source: sensor.DEVICE_ID_total_energy_consumption
    cycle: daily

Vérifiez la configuration sous Outils de développement, YAML, Vérifier la configuration, puis redémarrez Home Assistant ; utility_meter ne peut pas être chargé par rechargement. Ensuite, binary_sensor.portasplit_kompressor, sensor.portasplit_lufterstufe, sensor.portasplit_laufzeit_heute, sensor.portasplit_energie_heute et sensor.portasplit_letzte_meldung existent. Home Assistant supprime le tréma lors de la création de l’ID d’entité, d’où lufterstufe.

Étape 7 : créer le tableau de bord

1. Paramètres, Tableaux de bord, Ajouter un tableau de bord, Nouveau tableau de bord à partir de zéro, nom PortaSplit.
2. Ouvrez le nouveau tableau de bord et passez en mode édition via le crayon.
3. Ouvrez l’éditeur de configuration brute via le menu à trois points.
4. Remplacez entièrement le contenu par dashboard.yaml du dépôt, après avoir remplacé chaque DEVICE_ID par votre propre identifiant d’appareil.
5. Enregistrez et quittez le mode édition.

Le tableau de bord utilise la vue « Sections » à quatre colonnes et le thème PortaSplit Dark. Huit indicateurs se trouvent en haut, à gauche les commandes avec thermostat, mode de fonctionnement et vitesse du ventilateur, et à droite les historiques des dernières 24 heures. En dessous figurent les valeurs techniques du circuit frigorifique ainsi qu’un bloc d’état avec le code d’erreur, l’état du filtre et le dernier rapport.

Juste après la configuration, les graphiques sont vides et se remplissent au fil du temps. Energie heute affiche Unbekannt, jusqu’à ce que le compteur d’énergie augmente pour la première fois.

Après la configuration

Le token et la clé se trouvent désormais dans Home Assistant. S’il n’est plus possible de les obtenir via le cloud par la suite, une sauvegarde est le seul moyen de procéder à une nouvelle configuration. La partie 2 : sécuriser la PortaSplit explique comment sauvegarder le token, la clé et la configuration, et isoler la PortaSplit sur le réseau domestique.