ESPHome SNMP Komponenta

Toto je popis externí komponenty ESPHome, která umožňuje podporu protokolu SNMP. Tento protokol je široce používán v oblasti správy a monitorování sítí.

Tato komponenta vyžaduje povolenou Wi-Fi. Podporuje verzi 2c protokolu. Všechny položky jsou pouze pro čtení.

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

Konfigurační proměnné

• contact (Volitelné, řetězec): Hodnota pro sysContact (1.3.6.1.2.1.1.4) OID. Výchozí hodnota je prázdný řetězec.
• location (Volitelné, řetězec): Hodnota pro sysLocation (1.3.6.1.2.1.1.6) OID. Výchozí hodnota je prázdný řetězec.

WARNING

SNMP není podporováno pro Ethernet.

Instalace

Přidejte následující sekci do vašeho ESPHome YAML konfiguračního souboru:

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

Seznam OID

OID (Object Identifier) je adresa používaná k jednoznačné identifikaci stavů.

Systém

Obecné systémové informace.

• 1.3.6.1.2.1.1.1 (sysDescr): Popis systému včetně verze firmwaru a typu desky
• 1.3.6.1.2.1.1.2 (sysObjectId): ID objektu, odlišné pro ESP32 a ESP8266
• 1.3.6.1.2.1.1.3 (sysUptime): Čas (ve stotinách sekundy) od navázání Wi-Fi připojení. Pokud je použit standardní WiFi komponent, vždy 0.
• 1.3.6.1.2.1.1.4 (sysContact): Identifikace kontaktní osoby. Nastaveno konfigurační položkou contact
• 1.3.6.1.2.1.1.5 (sysName): Název uzlu
• 1.3.6.1.2.1.1.6 (sysLocation): Fyzická poloha uzlu. Nastaveno konfigurační položkou location
• 1.3.6.1.2.1.1.7 (sysServices): Sada služeb. Vždy 64.
• 1.3.6.1.2.1.25.1.1 (hrSystemUptime): Doba od spuštění systému

Aby sysUptime fungovalo, musíte použít rozšířenou WiFi. Více informací zde: Síťový uptime.

Úložiště

Informace o FLASH a RAM.

• 1.3.6.1.2.1.25.2.2 (hrMemorySize): Množství standardní RAM paměti v kb

FLASH

• 1.3.6.1.2.1.25.2.3.1.1.1: (hrStorageIndex): Vždy 1
• 1.3.6.1.2.1.25.2.3.1.3.1: (hrStorageDesc): Popis úložiště: FLASH
• 1.3.6.1.2.1.25.2.3.1.4.1: (hrAllocationUnit): Vždy 1
• 1.3.6.1.2.1.25.2.3.1.5.1: (hrStorageSize): Velikost FLASH paměti
• 1.3.6.1.2.1.25.2.3.1.6.1: (hrStorageUsed): Využití FLASH paměti

SPI RAM

Pro ESP8266 ukazuje 0 jako velikost a využití.

• 1.3.6.1.2.1.25.2.3.1.1.2: (hrStorageIndex): Vždy 2
• 1.3.6.1.2.1.25.2.3.1.3.2: (hrStorageDesc): Popis úložiště: PSI RAM
• 1.3.6.1.2.1.25.2.3.1.4.2: (hrAllocationUnit): Vždy 1
• 1.3.6.1.2.1.25.2.3.1.5.2: (hrStorageSize): Velikost paměti SPI RAM
• 1.3.6.1.2.1.25.2.3.1.6.2: (hrStorageUsed): Využití paměti SPI RAM

Wi-Fi

Detaily Wi-Fi signálu.

• 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: IP adresa

ESP32 heap

Dostupné pouze na čipech založených na ESP32.

• 1.3.9999.32.1.0: Velikost heapu
• 1.3.9999.32.2.0: Volný heap
• 1.3.9999.32.3.0: Minimální volný heap
• 1.3.9999.32.4.0: Maximálně alokovaný heap

ESP8266 heap

Dostupné pouze pro čipy ESP8266.

• 1.3.9999.8266.1.0: Volný heap
• 1.3.9999.8266.2.0: Fragmentace heapu v procentech
• 1.3.9999.8266.3.0: Maximální velikost volného bloku heapu

Chip

Detaily CPU.

• 1.3.9999.2.1.0: typ čipu, 32 pro EPS32, 8266 pro ESP8266
• 1.3.9999.2.2.0: Takt CPU
• 1.3.9999.2.3.0: Model čipu pro ESP32 nebo verze jádra pro ESP8266
• 1.3.9999.2.4.0: Počet jader CPU
• 1.3.9999.2.5.0: Revize čipu ESP32 nebo 0 pro ESP8266

Testing

Pro tento komponent jsou dostupné integrační testy: https://github.com/aquaticus/esphome_snmp_tests

Network monitoring

Praktický průvodce, jak monitorovat zařízení ESPHome, naleznete v ESPHome network monitoring.