Komponent ESPHome SNMP

To jest opis zewnętrznego komponentu ESPHome, który umożliwia obsługę protokołu SNMP. Protokół jest szeroko stosowany w zarządzaniu i monitorowaniu sieci.

Ten komponent wymaga włączonego Wi-Fi. Obsługuje wersję 2c protokołu. Wszystkie elementy są tylko do odczytu.

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

Zmienne konfiguracyjne

• contact (Opcjonalne, string): Wartość dla sysContact (1.3.6.1.2.1.1.4) OID. Domyślnie pusty ciąg znaków.
• location (Opcjonalne, string): Wartość dla sysLocation (1.3.6.1.2.1.1.6) OID. Domyślnie pusty ciąg znaków.

WARNING

SNMP nie jest obsługiwany dla Ethernetu.

Instalacja

Dodaj następującą sekcję do pliku konfiguracyjnego YAML ESPHome:

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

Lista OID

OID (Object Identifier) to adres używany do unikalnej identyfikacji statusów.

System

Ogólne informacje o systemie.

• 1.3.6.1.2.1.1.1 (sysDescr): Opis systemu, w tym wersja oprogramowania i typ płyty
• 1.3.6.1.2.1.1.2 (sysObjectId): Identyfikator obiektu, różny dla ESP32 i ESP8266
• 1.3.6.1.2.1.1.3 (sysUptime): Czas (w setnych częściach sekundy) od nawiązania połączenia Wi-Fi. Jeśli używany jest standardowy komponent WiFi, zawsze 0.
• 1.3.6.1.2.1.1.4 (sysContact): Identyfikacja osoby kontaktowej. Ustawiane przez wpis konfiguracyjny contact
• 1.3.6.1.2.1.1.5 (sysName): Nazwa węzła
• 1.3.6.1.2.1.1.6 (sysLocation): Fizyczna lokalizacja węzła. Ustawiane przez wpis konfiguracyjny location
• 1.3.6.1.2.1.1.7 (sysServices): Zestaw usług. Zawsze 64.
• 1.3.6.1.2.1.25.1.1 (hrSystemUptime): Czas od uruchomienia systemu

Aby sysUptime działało, musisz użyć rozszerzonego WiFi. Zobacz więcej tutaj: Czas działania sieci.

Pamięć

Informacje o pamięci FLASH i RAM.

• 1.3.6.1.2.1.25.2.2 (hrMemorySize): Ilość standardowej pamięci RAM w kb

FLASH

• 1.3.6.1.2.1.25.2.3.1.1.1: (hrStorageIndex): Zawsze 1
• 1.3.6.1.2.1.25.2.3.1.3.1: (hrStorageDesc): Opis pamięci: FLASH
• 1.3.6.1.2.1.25.2.3.1.4.1: (hrAllocationUnit): Zawsze 1
• 1.3.6.1.2.1.25.2.3.1.5.1: (hrStorageSize): Rozmiar pamięci FLASH
• 1.3.6.1.2.1.25.2.3.1.6.1: (hrStorageUsed): Zużycie pamięci FLASH

SPI RAM

Dla ESP8266 pokazuje 0 jako rozmiar i użycie.

• 1.3.6.1.2.1.25.2.3.1.1.2: (hrStorageIndex): Zawsze 2
• 1.3.6.1.2.1.25.2.3.1.3.2: (hrStorageDesc): Opis pamięci: PSI RAM
• 1.3.6.1.2.1.25.2.3.1.4.2: (hrAllocationUnit): Zawsze 1
• 1.3.6.1.2.1.25.2.3.1.5.2: (hrStorageSize): Rozmiar pamięci SPI RAM
• 1.3.6.1.2.1.25.2.3.1.6.2: (hrStorageUsed): Użycie pamięci SPI RAM

Wi-Fi

Szczegóły sygnału 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: Adres IP

Stos ESP32

Dostępne tylko na układach opartych na ESP32.

• 1.3.9999.32.1.0: Rozmiar stosu
• 1.3.9999.32.2.0: Wolny stos
• 1.3.9999.32.3.0: Minimalny wolny stos
• 1.3.9999.32.4.0: Maksymalnie przydzielony stos

Stos ESP8266

Dostępne tylko dla układów ESP8266.

• 1.3.9999.8266.1.0: Wolny stos
• 1.3.9999.8266.2.0: Fragmentacja stosu w procentach
• 1.3.9999.8266.3.0: Maksymalny rozmiar wolnego bloku stosu

Chip

Szczegóły CPU.

• 1.3.9999.2.1.0: typ chipa, 32 dla EPS32, 8266 dla ESP8266
• 1.3.9999.2.2.0: Zegar CPU
• 1.3.9999.2.3.0: Model chipa dla ESP32 lub wersja rdzenia dla ESP8266
• 1.3.9999.2.4.0: Liczba rdzeni CPU
• 1.3.9999.2.5.0: Rewizja chipa ESP32 lub 0 dla ESP8266

Testowanie

Dostępne są testy integracyjne dla tego komponentu: https://github.com/aquaticus/esphome_snmp_tests

Monitorowanie sieci

Praktyczny przewodnik dotyczący monitorowania urządzeń ESPHome można znaleźć w Monitorowanie sieci ESPHome.