ESPHome SNMP-Komponente

Dies ist die Beschreibung der externen ESPHome-Komponente, die die Unterstützung für das SNMP-Protokoll ermöglicht. Das Protokoll wird häufig in der Netzwerkverwaltung und Netzwerküberwachung verwendet.

Diese Komponente erfordert aktiviertes WLAN. Sie unterstützt die Version 2c des Protokolls. Alle Elemente sind nur lesbar.

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

Konfigurationsvariablen

• contact (Optional, string): Wert für sysContact (1.3.6.1.2.1.1.4) OID. Standardmäßig ein leerer String.
• location (Optional, string): Wert für sysLocation (1.3.6.1.2.1.1.6) OID. Standardmäßig ein leerer String.

WARNING

SNMP wird für Ethernet nicht unterstützt.

Installation

Fügen Sie den folgenden Abschnitt zu Ihrer ESPHome YAML-Konfigurationsdatei hinzu:

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

OID-Liste

OID (Object Identifier) ist eine Adresse, die zur eindeutigen Identifizierung von Status verwendet wird.

System

Allgemeine Systeminformationen.

• 1.3.6.1.2.1.1.1 (sysDescr): Systembeschreibung einschließlich Firmware-Version und Board-Typ
• 1.3.6.1.2.1.1.2 (sysObjectId): Objekt-ID, unterschiedlich für ESP32 und ESP8266
• 1.3.6.1.2.1.1.3 (sysUptime): Die Zeit (in Hundertstelsekunden) seit der WLAN-Verbindung. Wenn die Standard-WiFi-Komponente verwendet wird, immer 0.
• 1.3.6.1.2.1.1.4 (sysContact): Identifikation der Kontaktperson. Festgelegt durch den contact-Konfigurationseintrag
• 1.3.6.1.2.1.1.5 (sysName): Name des Knotens
• 1.3.6.1.2.1.1.6 (sysLocation): Physischer Standort des Knotens. Festgelegt durch den location-Konfigurationseintrag
• 1.3.6.1.2.1.1.7 (sysServices): Satz von Diensten. Immer 64.
• 1.3.6.1.2.1.25.1.1 (hrSystemUptime): Die Zeit seit dem Hochfahren

Um sysUptime zum Laufen zu bringen, müssen Sie erweitertes WLAN verwenden. Weitere Informationen finden Sie hier: Netzwerk-Betriebszeit.

Speicher

Informationen über FLASH und RAM.

• 1.3.6.1.2.1.25.2.2 (hrMemorySize): Die Menge an Standard-RAM-Speicher in kb

FLASH

• 1.3.6.1.2.1.25.2.3.1.1.1: (hrStorageIndex): Immer 1
• 1.3.6.1.2.1.25.2.3.1.3.1: (hrStorageDesc): Beschreibung des Speichers: FLASH
• 1.3.6.1.2.1.25.2.3.1.4.1: (hrAllocationUnit): Immer 1
• 1.3.6.1.2.1.25.2.3.1.5.1: (hrStorageSize): FLASH-Speichergröße
• 1.3.6.1.2.1.25.2.3.1.6.1: (hrStorageUsed): FLASH-Speichernutzung

SPI-RAM

Für ESP8266 zeigt es 0 als Größe und Nutzung an.

• 1.3.6.1.2.1.25.2.3.1.1.2: (hrStorageIndex): Immer 2
• 1.3.6.1.2.1.25.2.3.1.3.2: (hrStorageDesc): Beschreibung des Speichers: PSI RAM
• 1.3.6.1.2.1.25.2.3.1.4.2: (hrAllocationUnit): Immer 1
• 1.3.6.1.2.1.25.2.3.1.5.2: (hrStorageSize): SPI-RAM-Speichergröße
• 1.3.6.1.2.1.25.2.3.1.6.2: (hrStorageUsed): SPI-RAM-Speichernutzung

Wi-Fi

Wi-Fi-Signaldetails.

• 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-Adresse

ESP32-Heap

Nur auf ESP32-basierten Chips verfügbar.

• 1.3.9999.32.1.0: Heap-Größe
• 1.3.9999.32.2.0: Freier Heap
• 1.3.9999.32.3.0: Minimaler freier Heap
• 1.3.9999.32.4.0: Maximal zugewiesener Heap

ESP8266-Heap

Nur für ESP8266-Chips verfügbar.

• 1.3.9999.8266.1.0: Freier Heap
• 1.3.9999.8266.2.0: Heap-Fragmentierung in Prozent
• 1.3.9999.8266.3.0: Maximale Größe des freien Heap-Blocks

Chip

CPU-Details.

• 1.3.9999.2.1.0: Chip-Typ, 32 für EPS32, 8266 für ESP8266
• 1.3.9999.2.2.0: CPU-Takt
• 1.3.9999.2.3.0: Chip-Modell für ESP32 oder Kernversion für ESP8266
• 1.3.9999.2.4.0: Anzahl der CPU-Kerne
• 1.3.9999.2.5.0: ESP32-Chip-Revision oder 0 für ESP8266

Tests

Integrationstests sind für diese Komponente verfügbar: https://github.com/aquaticus/esphome_snmp_tests

Netzwerküberwachung

Für eine praktische Anleitung zur Überwachung von ESPHome-Geräten siehe ESPHome Netzwerküberwachung.