# 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**
```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:
```bash
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é:
```bash
# 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é:
```bash
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**