diff --git a/README.md b/README.md index b056a51..98a12e3 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ Passerelle SNMP vers MQTT pour l'intégration Home Assistant. Ce script Python s ### Composants principaux -- **Client SNMP** : Utilise `pysnmp.hlapi.asyncio.slim` pour la récupération asynchrone des données SNMP +- **Client SNMP** : Utilise `pysnmp.hlapi.asyncio` (version 7.x) pour la récupération asynchrone des données SNMP avec `get_cmd`, `SnmpEngine` et `UdpTransportTarget` - **Publisher MQTT** : Utilise `paho.mqtt.client` pour publier les données vers un broker MQTT - **Intégration Home Assistant** : Génère la configuration de découverte automatique compatible avec Home Assistant MQTT Discovery - **Traitement des données** : Convertit les valeurs des OID SNMP vers les types appropriés (int, bool) pour les capteurs Home Assistant @@ -28,6 +28,14 @@ Passerelle SNMP vers MQTT pour l'intégration Home Assistant. Ce script Python s - Accès réseau aux équipements SNMP à surveiller - Broker MQTT accessible +### Dépendances principales + +- **pysnmp >= 7.0.0** : Bibliothèque SNMP avec nouvelle API asynchrone +- **paho-mqtt >= 1.6.0** : Client MQTT pour la communication avec le broker +- **PyYAML >= 6.0.0** : Parsing des fichiers de configuration YAML + +⚠️ **Note importante** : Ce projet utilise pysnmp version 7.x qui introduit des changements d'API incompatibles avec les versions 6.x et antérieures. L'ancienne classe `Slim` a été supprimée au profit de `get_cmd()` avec des objets `SnmpEngine`, `UdpTransportTarget`, etc. + ### Configuration de l'environnement ```bash @@ -361,6 +369,11 @@ devices: - Vérifiez que MQTT Discovery est activé dans Home Assistant - Surveillez les logs MQTT avec `mosquitto_sub` +5. **Erreurs liées à PySNMP** + - **"ModuleNotFoundError: No module named 'pysnmp.hlapi.asyncio.slim'"** : Vous utilisez une version pysnmp 6.x. Mettez à jour vers >= 7.0.0 + - **"Please call .create() to construct UdpTransportTarget object"** : Erreur corrigée dans cette version, utilisez `pip install -r requirements.txt` + - **Erreurs d'importation SNMP** : Assurez-vous d'avoir pysnmp 7.x avec `pip show pysnmp` + ### Commandes de test utiles ```bash