Skip to content

Componenta ESPHome SNMP

Aceasta este descrierea componentei externe ESPHome care permite suportul pentru protocolul SNMP. Protocolul este utilizat pe scară largă în managementul și monitorizarea rețelelor.

Această componentă necesită activarea Wi-Fi. Suportă versiunea 2c a protocolului. Toate elementele sunt doar pentru citire.

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

Variabile de configurare

  • contact (Opțional, șir de caractere): Valoare pentru OID-ul sysContact (1.3.6.1.2.1.1.4). Implicit este un șir gol.
  • location (Opțional, șir de caractere): Valoare pentru OID-ul sysLocation (1.3.6.1.2.1.1.6). Implicit este un șir gol.

WARNING

SNMP nu este suportat pentru Ethernet.

Instalare

Adăugați următoarea secțiune în fișierul de configurare YAML al ESPHome:

yaml
external_components:
    # Componenta SNMP
    - source: github://aquaticus/esphome-snmp

Lista OID

OID (Identificator de Obiect) este o adresă utilizată pentru a identifica unic stările.

Sistem

Informații generale despre sistem.

  • 1.3.6.1.2.1.1.1 (sysDescr): Descrierea sistemului, inclusiv versiunea firmware-ului și tipul plăcii
  • 1.3.6.1.2.1.1.2 (sysObjectId): ID-ul obiectului, diferit pentru ESP32 și ESP8266
  • 1.3.6.1.2.1.1.3 (sysUptime): Timpul (în sutimi de secundă) de la stabilirea conexiunii Wi-Fi. Dacă componenta standard WiFi este utilizată, întotdeauna 0.
  • 1.3.6.1.2.1.1.4 (sysContact): Identificarea persoanei de contact. Setat prin intrarea de configurare contact
  • 1.3.6.1.2.1.1.5 (sysName): Numele nodului
  • 1.3.6.1.2.1.1.6 (sysLocation): Locația fizică a nodului. Setat prin intrarea de configurare location
  • 1.3.6.1.2.1.1.7 (sysServices): Set de servicii. Întotdeauna 64.
  • 1.3.6.1.2.1.25.1.1 (hrSystemUptime): Timpul de la pornire

Pentru ca sysUptime să funcționeze, trebuie să utilizați WiFi extins. Vedeți mai multe aici: Timp de funcționare rețea.

Stocare

Informații despre FLASH și RAM.

  • 1.3.6.1.2.1.25.2.2 (hrMemorySize): Cantitatea de memorie RAM standard în kb

FLASH

  • 1.3.6.1.2.1.25.2.3.1.1.1: (hrStorageIndex): Întotdeauna 1
  • 1.3.6.1.2.1.25.2.3.1.3.1: (hrStorageDesc): Descrierea stocării: FLASH
  • 1.3.6.1.2.1.25.2.3.1.4.1: (hrAllocationUnit): Întotdeauna 1
  • 1.3.6.1.2.1.25.2.3.1.5.1: (hrStorageSize): Dimensiunea memoriei FLASH
  • 1.3.6.1.2.1.25.2.3.1.6.1: (hrStorageUsed): Utilizarea memoriei FLASH

SPI RAM

Pentru ESP8266, arată 0 ca dimensiune și utilizare.

  • 1.3.6.1.2.1.25.2.3.1.1.2: (hrStorageIndex): Întotdeauna 2
  • 1.3.6.1.2.1.25.2.3.1.3.2: (hrStorageDesc): Descrierea stocării: PSI RAM
  • 1.3.6.1.2.1.25.2.3.1.4.2: (hrAllocationUnit): Întotdeauna 1
  • 1.3.6.1.2.1.25.2.3.1.5.2: (hrStorageSize): Dimensiunea memoriei SPI RAM
  • 1.3.6.1.2.1.25.2.3.1.6.2: (hrStorageUsed): Utilizarea memoriei SPI RAM

Wi-Fi

Detalii despre semnalul 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: Adresa IP

ESP32 heap

Disponibil doar pe cipurile bazate pe ESP32.

  • 1.3.9999.32.1.0: Dimensiunea heap-ului
  • 1.3.9999.32.2.0: Heap liber
  • 1.3.9999.32.3.0: Heap liber minim
  • 1.3.9999.32.4.0: Heap maxim alocat

ESP8266 heap

Disponibil doar pentru cipurile ESP8266.

  • 1.3.9999.8266.1.0: Heap liber
  • 1.3.9999.8266.2.0: Fragmentarea heap-ului în procente
  • 1.3.9999.8266.3.0: Dimensiunea maximă a blocului de heap liber

Chip

Detalii despre CPU.

  • 1.3.9999.2.1.0: tipul cipului, 32 pentru EPS32, 8266 pentru ESP8266
  • 1.3.9999.2.2.0: Ceasul CPU
  • 1.3.9999.2.3.0: Modelul cipului pentru ESP32 sau versiunea nucleului pentru ESP8266
  • 1.3.9999.2.4.0: Numărul de nuclee CPU
  • 1.3.9999.2.5.0: Revizia cipului ESP32 sau 0 pentru ESP8266

Testare

Testele de integrare sunt disponibile pentru acest component: https://github.com/aquaticus/esphome_snmp_tests

Monitorizarea rețelei

Pentru un ghid practic despre cum să monitorizați dispozitivele ESPHome, vedeți Monitorizarea rețelei ESPHome.