Composant ESPHome SNMP

Ceci est la description du composant externe ESPHome qui permet la prise en charge du protocole SNMP. Le protocole est largement utilisé dans la gestion et la surveillance des réseaux.

Ce composant nécessite l'activation du Wi-Fi. Il prend en charge la version 2c du protocole. Tous les éléments sont en lecture seule.

# Example configuration entry
snmp:
  contact: Joe
  location: Basement

Variables de configuration

• contact (Optionnel, chaîne de caractères) : Valeur pour sysContact (1.3.6.1.2.1.1.4) OID. Par défaut, une chaîne vide.
• location (Optionnel, chaîne de caractères) : Valeur pour sysLocation (1.3.6.1.2.1.1.6) OID. Par défaut, une chaîne vide.

WARNING

SNMP n'est pas pris en charge pour Ethernet.

Installation

Ajoutez la section suivante à votre fichier de configuration YAML ESPHome :

external_components:
    # Composant SNMP
    - source: github://aquaticus/esphome-snmp

Liste des OID

OID (Identifiant d'Objet) est une adresse utilisée pour identifier uniquement les statuts.

Système

Informations générales sur le système.

• 1.3.6.1.2.1.1.1 (sysDescr) : Description du système incluant la version du firmware et le type de carte
• 1.3.6.1.2.1.1.2 (sysObjectId) : Identifiant d'objet, différent pour ESP32 et ESP8266
• 1.3.6.1.2.1.1.3 (sysUptime) : Le temps (en centièmes de seconde) depuis que la connexion Wi-Fi a été établie. Si le composant WiFi standard est utilisé, toujours 0.
• 1.3.6.1.2.1.1.4 (sysContact) : Identification de la personne de contact. Défini par l'entrée de configuration contact
• 1.3.6.1.2.1.1.5 (sysName) : Nom du nœud
• 1.3.6.1.2.1.1.6 (sysLocation) : Emplacement physique du nœud. Défini par l'entrée de configuration location
• 1.3.6.1.2.1.1.7 (sysServices) : Ensemble de services. Toujours 64.
• 1.3.6.1.2.1.25.1.1 (hrSystemUptime) : Le temps écoulé depuis le démarrage

Pour que sysUptime fonctionne, vous devez utiliser le WiFi étendu. Voir plus ici : Disponibilité du réseau.

Stockage

Informations sur la FLASH et la RAM.

• 1.3.6.1.2.1.25.2.2 (hrMemorySize) : La quantité de mémoire RAM standard en ko

FLASH

• 1.3.6.1.2.1.25.2.3.1.1.1 : (hrStorageIndex) : Toujours 1
• 1.3.6.1.2.1.25.2.3.1.3.1 : (hrStorageDesc) : Description du stockage : FLASH
• 1.3.6.1.2.1.25.2.3.1.4.1 : (hrAllocationUnit) : Toujours 1
• 1.3.6.1.2.1.25.2.3.1.5.1 : (hrStorageSize) : Taille de la mémoire FLASH
• 1.3.6.1.2.1.25.2.3.1.6.1 : (hrStorageUsed) : Utilisation de la mémoire FLASH

SPI RAM

Pour ESP8266, il affiche 0 comme taille et utilisation.

• 1.3.6.1.2.1.25.2.3.1.1.2: (hrStorageIndex) : Toujours 2
• 1.3.6.1.2.1.25.2.3.1.3.2: (hrStorageDesc) : Description du stockage : PSI RAM
• 1.3.6.1.2.1.25.2.3.1.4.2: (hrAllocationUnit) : Toujours 1
• 1.3.6.1.2.1.25.2.3.1.5.2: (hrStorageSize) : Taille de la mémoire SPI RAM
• 1.3.6.1.2.1.25.2.3.1.6.2: (hrStorageUsed) : Utilisation de la mémoire SPI RAM

Wi-Fi

Détails du signal Wi-Fi.

• 1.3.9999.4.1.0: RSSI
• 1.3.9999.4.2.0: BSSI
• 1.3.9999.4.3.0: SSID
• 1.3.9999.4.4.0: Adresse IP

Tas ESP32

Disponible uniquement sur les puces basées sur ESP32.

• 1.3.9999.32.1.0: Taille du tas
• 1.3.9999.32.2.0: Tas libre
• 1.3.9999.32.3.0: Tas libre minimum
• 1.3.9999.32.4.0: Tas maximum alloué

Tas ESP8266

Disponible uniquement pour les puces ESP8266.

• 1.3.9999.8266.1.0: Tas libre
• 1.3.9999.8266.2.0: Fragmentation du tas en pourcentage
• 1.3.9999.8266.3.0: Taille maximale du bloc de tas libre

Puce

Détails du CPU.

• 1.3.9999.2.1.0: type de puce, 32 pour EPS32, 8266 pour ESP8266
• 1.3.9999.2.2.0: Horloge CPU
• 1.3.9999.2.3.0: Modèle de puce pour ESP32 ou version du cœur pour ESP8266
• 1.3.9999.2.4.0: Nombre de cœurs CPU
• 1.3.9999.2.5.0: Révision de la puce ESP32 ou 0 pour ESP8266

Tests

Des tests d'intégration sont disponibles pour ce composant : https://github.com/aquaticus/esphome_snmp_tests

Surveillance du réseau

Pour un guide pratique sur la façon de surveiller les appareils ESPHome, voir Surveillance du réseau ESPHome.