Midea AC LAN : intégration Home Assistant pour les appareils M-Smart
Aperçu du projet : Configurez automatiquement puis contrôlez vos appareils Midea M-Smart (climatiseur, ventilateur, chauffe-eau, laveuse, etc.) via le réseau local.
En bref
- De quoi s’agit-il ?
- Un composant Home Assistant basé sur Python pour découvrir et contrôler les appareils Midea M-Smart sur le réseau local, avec des notes d'installation et un avertissement concernant la fermeture des API de jetons cloud.
- À qui s’adresse-t-il ?
- Le référentiel reste en développement actif avec 128 problèmes ouverts, et son avenir pour l'ajout de nouveaux appareils dépend de la disponibilité des API de jetons NetHome Plus, que Midea a indiqué devoir fermer à terme.
- Puis-je l’utiliser commercialement ?
- Oui. MIT est une licence permissive : vous pouvez utiliser, modifier et vendre un logiciel qui en dépend, à condition de conserver les mentions de droit d’auteur et de licence.
- Est-il encore maintenu ?
- Oui. Le dépôt a reçu de nouveaux commits au cours des dernières 24 heures.
- En quel langage est-il écrit ?
- Principalement Python, d’après les statistiques de langage de GitHub.
Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 18 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.
ANALYSE OPEN SOURCE APPROFONDIE
Contrôle local des appareils Midea M-Smart
Le référentiel décrit une intégration Home Assistant pour contrôler les appareils Midea M-Smart tels que les climatiseurs, les ventilateurs, les chauffe-eau et les lave-linge sur le réseau local. Elle utilise l'interface de flux de configuration de Home Assistant pour la découverte et la configuration automatisées des appareils, et maintient une connexion TCP longue durée pour synchroniser l'état en quasi temps réel. Le projet est écrit en Python et, selon les métadonnées du référentiel, compte 1 815 étoiles, 150 forks et 128 problèmes ouverts au dernier instantané des métadonnées.
Changements d'API de jetons cloud et sauvegardes d'appareils
Le README contient un avis important pour quiconque ajoute de nouveaux appareils. Midea a fermé les API de jetons côté serveur dans Meiju Cloud et Smarthome Cloud. Ce projet utilise désormais les API de jetons cloud NetHome Plus pour ajouter des appareils, et ces API devraient également être fermées, ce qui empêchera l'ajout de nouveaux appareils à l'avenir. Pour les appareils déjà ajoutés, le README recommande fortement de copier ou de sauvegarder le fichier de configuration `.json` de chaque appareil sur un appareil de sauvegarde en dehors de HAOS, en particulier pour les appareils v3. La raison invoquée est que l'API LAN v1 supposait initialement que la communication client était déjà chiffrée, de sorte que les jetons générés par le service cloud n'avaient pas de date d'expiration. De nombreux plugins HA sur GitHub utilisent un chiffrement client cassé, ce qui rend les jetons non expirables et crée une vulnérabilité de sécurité. Midea ferme donc progressivement ces services de jetons et passe à une nouvelle API de contrôle cloud v2 qui rendra finalement l'API de contrôle LAN v1 inutilisable. Le README ne précise pas de calendrier pour ces fermetures.
Chemin de mise à niveau depuis georgezhao2010/midea_ac_lan
Le projet prend explicitement en charge la mise à niveau depuis l'ancienne intégration georgezhao2010/midea_ac_lan. Les étapes documentées sont : supprimer l'ancienne intégration, installer cette intégration actuelle, puis redémarrer Home Assistant. Les appareils existants ne doivent pas être supprimés et n'ont pas besoin d'être redécouverts ou rajoutés. Si les entrées d'appareils ne sont pas trouvées, le README indique d'aller dans Paramètres -> Appareils et services -> Midea AC LAN -> Appareils -> CONFIGURER et d'activer l'appareil. Le README ne liste aucune étape de migration de données au-delà de la conservation de la configuration existante des appareils.
Options d'installation · wuwentao midea ac lan
Trois méthodes d'installation sont documentées. La première passe par HACS ; le README demande de s'assurer que HACS est installé dans Home Assistant, puis d'installer l'intégration et de redémarrer Home Assistant. La deuxième est un script exécutable dans le terminal HA ou le module complémentaire SSH : `wget -O - https://github.com/wuwentao/midea_ac_lan/raw/main/scripts/install.sh | ARCHIVE_TAG=latest bash -`. La troisième est manuelle : télécharger `midea_ac_lan.zip` depuis la dernière version, le copier dans `/custom_components/midea_ac_lan` dans Home Assistant, puis redémarrer. Après l'installation, la configuration commence dans Paramètres, Appareils et services, Intégrations, Midea AC Lan, puis vous initialisez la configuration et ajoutez tous les appareils. Le README note que Home Assistant 2024.4.1 ou supérieur est requis.
Ajout et configuration des appareils
Avant d'ajouter des appareils, le README conseille de définir une adresse IP statique pour chaque appareil dans le routeur. Le flux de configuration peut demander un compte et un mot de passe Midea car les informations de jeton et de clé sont récupérées depuis le serveur cloud Midea ; une fois tous les appareils configurés, le compte peut être supprimé sans affecter l'utilisation. Trois méthodes d'ajout sont disponibles : la découverte automatique, qui liste les appareils M-Smart sur le même sous-réseau et permet d'en sélectionner un ; la configuration manuelle, qui nécessite le code de l'appareil, le type d'appareil, l'adresse IP, le port (par défaut 6444), la version du protocole, le jeton et la clé ; et la liste de tous les appareils, qui affiche les appareils découvrables avec leurs ID, types, numéros de série et autres détails. Après l'ajout, la configuration se fait dans Paramètres -> Appareils et services -> Midea AC LAN -> Appareils -> CONFIGURER. L'adresse IP peut être redéfinie lorsque l'IP de l'appareil change. L'intervalle de rafraîchissement pour interroger activement l'état de l'appareil est de 30 secondes par défaut ; le définir sur 0 désactive le rafraîchissement actif, et le README avertit que des intervalles plus courts peuvent augmenter la consommation d'énergie. Des entités de capteurs et d'interrupteurs supplémentaires peuvent être activées pour les appareils pris en charge, et certains types d'appareils acceptent une personnalisation JSON, par exemple `{"refresh_interval": 15, "fan_speed": 100}`.
Marques prises en charge, types d'appareils et développement
Le README liste 16 marques prises en charge avec logos, notamment Midea, Carrier, Toshiba, Electrolux et autres, ainsi qu'un tableau de 35 types d'appareils avec des liens vers les documents des appareils. Les exemples incluent les climatiseurs, les lave-linge, les chauffe-eau, les réfrigérateurs, les ventilateurs et bien d'autres. Pour le développement, le projet utilise `uv` et un script d'installation ; le README renvoie à `CONTRIBUTING.md` pour la configuration complète, l'exécution locale de Home Assistant, et les règles de style de code et de commit. Les instructions de débogage et de test se trouvent dans `doc/debug.md`. Le référentiel est sous licence MIT, qui accorde la permission d'utiliser, copier, modifier, fusionner, publier, distribuer, sous-licencier et vendre des copies, à condition que l'avis de droit d'auteur et l'avis de permission soient inclus. La licence fournit explicitement le logiciel "tel quel" sans garantie d'aucune sorte, et le README n'offre aucune garantie de support.
Le périmètre documenté de wuwentao-midea-ac-lan-deep-analysis
Le README de wuwentao-midea-ac-lan-deep-analysis constitue la base de cette fiche. Relevez les commandes, fichiers, formats et services nommés par le dépôt avant toute utilisation. Lorsqu une information manque, elle reste non établie; aucune performance, compatibilité ou garantie supplémentaire ne doit être déduite de la seule description.
Vérifier wuwentao-midea-ac-lan-deep-analysis avec ses propres entrées
Pour vérifier wuwentao-midea-ac-lan-deep-analysis, reprenez l exemple, le fichier ou le lien explicitement fourni par le README et comparez l entrée avec la sortie observée. Notez la version, le système et les dépendances employés. Ce contrôle porte sur wuwentao-midea-ac-lan-deep-analysis et ne transforme pas un exemple documenté en promesse générale.
Conclusion éditoriale
Le référentiel reste en développement actif avec 128 problèmes ouverts, et son avenir pour l'ajout de nouveaux appareils dépend de la disponibilité des API de jetons NetHome Plus, que Midea a indiqué devoir fermer à terme.
Notes de la communauté