pilot/scripts/check_ha_mqtt.md

Guide de Diagnostic - Home Assistant MQTT Discovery

Problème: L'appareil Pilot n'apparaît pas dans Home Assistant

✅ Checklist de Diagnostic

1. Vérifier que Home Assistant est connecté au broker MQTT

Option A: Via l'interface HA

1. Allez sur http://10.0.0.2:8123
2. Connectez-vous (user: gilles, password: gilles)
3. Allez dans Paramètres → Appareils et Services
4. Cherchez l'intégration MQTT
   • ✅ Si présente: Vérifiez la configuration
   • ❌ Si absente: Ajoutez l'intégration MQTT

Option B: Via configuration.yaml

mqtt:
  broker: 10.0.0.3
  port: 1883
  discovery: true
  discovery_prefix: homeassistant

Après modification, redémarrez Home Assistant.

2. Vérifier la connexion au broker

Dans Home Assistant:

1. Allez dans Outils de développement → MQTT
2. Essayez de vous abonner au topic pilot/#
3. Vous devriez voir des messages arriver

3. Vérifier les topics de découverte

Les topics de découverte Pilot doivent être:

homeassistant/sensor/asus/asus_cpu_usage/config
homeassistant/sensor/asus/asus_memory_used_mb/config
homeassistant/sensor/asus/asus_memory_total_mb/config
homeassistant/sensor/asus/asus_ip_address/config
homeassistant/sensor/asus/asus_power_state/config
homeassistant/sensor/asus/asus_battery_level/config
homeassistant/sensor/asus/asus_battery_state/config
homeassistant/switch/asus/asus_shutdown/config
homeassistant/switch/asus/asus_reboot/config
homeassistant/switch/asus/asus_sleep/config
homeassistant/switch/asus/asus_screen/config

4. Forcer la republication des messages discovery

Redémarrez Pilot pour qu'il republie les messages de découverte:

pkill -f pilot-v2
cd /home/gilles/app/pilot/pilot-v2
cargo run --release &

5. Vérifier les logs Home Assistant

Dans Home Assistant:

1. Allez dans Paramètres → Système → Journaux
2. Cherchez des erreurs liées à MQTT

🔧 Solutions Courantes

Problème: MQTT non configuré dans HA

• Solution: Ajoutez l'intégration MQTT pointant vers 10.0.0.3:1883

Problème: Discovery désactivé

• Solution: Dans la config MQTT de HA, activez discovery: true

Problème: Mauvais prefix de découverte

• Solution: Vérifiez que HA utilise le prefix homeassistant (par défaut)

Problème: L'appareil n'apparaît pas après ajout MQTT

• Solution: Redémarrez Pilot ET Home Assistant

📊 Test manuel de publication MQTT

Si vous avez mosquitto-clients installé:

# Installer
sudo apt install mosquitto-clients

# Écouter tous les messages
mosquitto_sub -h 10.0.0.3 -t '#' -v

# Écouter uniquement discovery
mosquitto_sub -h 10.0.0.3 -t 'homeassistant/#' -v

# Écouter uniquement Pilot
mosquitto_sub -h 10.0.0.3 -t 'pilot/#' -v

🐍 Alternative: Script Python de monitoring

Si paho-mqtt est installé:

pip3 install paho-mqtt
python3 /home/gilles/app/pilot/scripts/mqtt_monitor.py

✅ Vérification Finale

Une fois configuré correctement, vous devriez voir dans HA:

• Appareil: "asus" dans la liste des appareils MQTT
• 7 Capteurs: CPU Usage, Memory Used/Total, IP Address, Power State, Battery Level/State
• 4 Switches: Shutdown, Reboot, Sleep, Screen

L'appareil apparaît dans: Paramètres → Appareils et Services → MQTT → Appareils