114 lines
3.3 KiB
Markdown
114 lines
3.3 KiB
Markdown
# 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**
|