Componente ESPHome SNMP

Questa è la descrizione del componente esterno ESPHome che abilita il supporto per il protocollo SNMP. Il protocollo è ampiamente utilizzato nella gestione e nel monitoraggio delle reti.

Questo componente richiede il Wi-Fi abilitato. Supporta la versione 2c del protocollo. Tutti gli elementi sono di sola lettura.

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

Variabili di configurazione

• contact (Opzionale, stringa): Valore per l'OID sysContact (1.3.6.1.2.1.1.4). Predefinito a una stringa vuota.
• location (Opzionale, stringa): Valore per l'OID sysLocation (1.3.6.1.2.1.1.6). Predefinito a una stringa vuota.

WARNING

SNMP non è supportato per Ethernet.

Installazione

Aggiungi la seguente sezione al tuo file di configurazione YAML di ESPHome:

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

Elenco OID

OID (Object Identifier) è un indirizzo utilizzato per identificare univocamente gli stati.

Sistema

Informazioni generali sul sistema.

• 1.3.6.1.2.1.1.1 (sysDescr): Descrizione del sistema inclusa la versione del firmware e il tipo di scheda
• 1.3.6.1.2.1.1.2 (sysObjectId): ID oggetto, diverso per ESP32 e ESP8266
• 1.3.6.1.2.1.1.3 (sysUptime): Il tempo (in centesimi di secondo) dalla connessione Wi-Fi stabilita. Se viene utilizzato il componente WiFi standard è sempre 0.
• 1.3.6.1.2.1.1.4 (sysContact): Identificazione della persona di contatto. Impostato tramite l'entry di configurazione contact
• 1.3.6.1.2.1.1.5 (sysName): Nome del nodo
• 1.3.6.1.2.1.1.6 (sysLocation): Posizione fisica del nodo. Impostato tramite l'entry di configurazione location
• 1.3.6.1.2.1.1.7 (sysServices): Set di servizi. Sempre 64.
• 1.3.6.1.2.1.25.1.1 (hrSystemUptime): Il tempo trascorso dall'avvio

Per far funzionare sysUptime devi usare il WiFi esteso. Vedi maggiori informazioni qui: Network uptime.

Memoria

Informazioni su FLASH e RAM.

• 1.3.6.1.2.1.25.2.2 (hrMemorySize): La quantità di memoria RAM standard in kb

FLASH

• 1.3.6.1.2.1.25.2.3.1.1.1: (hrStorageIndex): Sempre 1
• 1.3.6.1.2.1.25.2.3.1.3.1: (hrStorageDesc): Descrizione della memoria: FLASH
• 1.3.6.1.2.1.25.2.3.1.4.1: (hrAllocationUnit): Sempre 1
• 1.3.6.1.2.1.25.2.3.1.5.1: (hrStorageSize): Dimensione della memoria FLASH
• 1.3.6.1.2.1.25.2.3.1.6.1: (hrStorageUsed): Utilizzo della memoria FLASH

SPI RAM

Per ESP8266 mostra 0 come dimensione e utilizzo.

• 1.3.6.1.2.1.25.2.3.1.1.2: (hrStorageIndex): Sempre 2
• 1.3.6.1.2.1.25.2.3.1.3.2: (hrStorageDesc): Descrizione dello storage: PSI RAM
• 1.3.6.1.2.1.25.2.3.1.4.2: (hrAllocationUnit): Sempre 1
• 1.3.6.1.2.1.25.2.3.1.5.2: (hrStorageSize): Dimensione della memoria SPI RAM
• 1.3.6.1.2.1.25.2.3.1.6.2: (hrStorageUsed): Utilizzo della memoria SPI RAM

Wi-Fi

Dettagli del segnale 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: Indirizzo IP

Heap ESP32

Disponibile solo su chip basati su ESP32.

• 1.3.9999.32.1.0: Dimensione dell'heap
• 1.3.9999.32.2.0: Heap libero
• 1.3.9999.32.3.0: Heap libero minimo
• 1.3.9999.32.4.0: Heap massimo allocato

Heap ESP8266

Disponibile solo per chip ESP8266.

• 1.3.9999.8266.1.0: Heap libero
• 1.3.9999.8266.2.0: Frammentazione dell'heap in percentuale
• 1.3.9999.8266.3.0: Dimensione massima del blocco di heap libero

Chip

Dettagli della CPU.

• 1.3.9999.2.1.0: tipo di chip, 32 per EPS32, 8266 per ESP8266
• 1.3.9999.2.2.0: Clock della CPU
• 1.3.9999.2.3.0: Modello del chip per ESP32 o versione del core per ESP8266
• 1.3.9999.2.4.0: Numero di core della CPU
• 1.3.9999.2.5.0: Revisione del chip ESP32 o 0 per ESP8266

Testing

Sono disponibili test di integrazione per questo componente: https://github.com/aquaticus/esphome_snmp_tests

Monitoraggio della rete

Per una guida pratica su come monitorare i dispositivi ESPHome, vedere Monitoraggio della rete ESPHome.