ESPHome SNMP-komponent

Detta är en beskrivning av den externa ESPHome-komponenten som möjliggör stöd för SNMP-protokollet. Protokollet används i stor utsträckning inom nätverkshantering och nätverksövervakning.

Denna komponent kräver aktiverat Wi-Fi. Den stöder version 2c av protokollet. Alla objekt är skrivskyddade.

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

Konfigurationsvariabler

• contact (Valfritt, sträng): Värde för sysContact (1.3.6.1.2.1.1.4) OID. Standardvärdet är en tom sträng.
• location (Valfritt, sträng): Värde för sysLocation (1.3.6.1.2.1.1.6) OID. Standardvärdet är en tom sträng.

WARNING

SNMP stöds inte för Ethernet.

Installation

Lägg till följande avsnitt i din ESPHome YAML-konfigurationsfil:

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

OID-lista

OID (Object Identifier) är en adress som används för att unikt identifiera statusar.

System

Allmän systeminformation.

• 1.3.6.1.2.1.1.1 (sysDescr): Systembeskrivning inklusive firmware version och korttyp
• 1.3.6.1.2.1.1.2 (sysObjectId): Objekt-id, olika för ESP32 och ESP8266
• 1.3.6.1.2.1.1.3 (sysUptime): Tiden (i hundradels sekunder) sedan Wi-Fi upprättade anslutning. Om standard WiFi-komponenten används alltid 0.
• 1.3.6.1.2.1.1.4 (sysContact): Identifiering av kontaktpersonen. Ställs in av contact konfigurationspost
• 1.3.6.1.2.1.1.5 (sysName): Namn på noden
• 1.3.6.1.2.1.1.6 (sysLocation): Fysisk plats för noden. Ställs in av location konfigurationspost
• 1.3.6.1.2.1.1.7 (sysServices): Uppsättning av tjänster. Alltid 64.
• 1.3.6.1.2.1.25.1.1 (hrSystemUptime): Tiden sedan uppstart

För att få sysUptime att fungera måste du använda utökat WiFi. Se mer här: Nätverksdrifttid.

Lagring

Information om FLASH och RAM.

• 1.3.6.1.2.1.25.2.2 (hrMemorySize): Mängden standard RAM-minne i kb

FLASH

• 1.3.6.1.2.1.25.2.3.1.1.1: (hrStorageIndex): Alltid 1
• 1.3.6.1.2.1.25.2.3.1.3.1: (hrStorageDesc): Beskrivning av lagringen: FLASH
• 1.3.6.1.2.1.25.2.3.1.4.1: (hrAllocationUnit): Alltid 1
• 1.3.6.1.2.1.25.2.3.1.5.1: (hrStorageSize): FLASH-minnesstorlek
• 1.3.6.1.2.1.25.2.3.1.6.1: (hrStorageUsed): FLASH-minnesanvändning

SPI RAM

För ESP8266 visar den 0 som storlek och användning.

• 1.3.6.1.2.1.25.2.3.1.1.2: (hrStorageIndex): Alltid 2
• 1.3.6.1.2.1.25.2.3.1.3.2: (hrStorageDesc): Beskrivning av lagringen: PSI RAM
• 1.3.6.1.2.1.25.2.3.1.4.2: (hrAllocationUnit): Alltid 1
• 1.3.6.1.2.1.25.2.3.1.5.2: (hrStorageSize): SPI RAM-minnesstorlek
• 1.3.6.1.2.1.25.2.3.1.6.2: (hrStorageUsed): SPI RAM-minnesanvändning

Wi-Fi

Wi-Fi-signalens detaljer.

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

ESP32 heap

Tillgänglig endast på ESP32-baserade chips.

• 1.3.9999.32.1.0: Heap-storlek
• 1.3.9999.32.2.0: Fri heap
• 1.3.9999.32.3.0: Minsta fria heap
• 1.3.9999.32.4.0: Maximalt allokerad heap

ESP8266 heap

Tillgänglig endast för ESP8266-chips.

• 1.3.9999.8266.1.0: Fri heap
• 1.3.9999.8266.2.0: Heap-fragmentering i procent
• 1.3.9999.8266.3.0: Maximal storlek på den fria heap-blocket

Chip

CPU-detaljer.

• 1.3.9999.2.1.0: chiptyp, 32 för EPS32, 8266 för ESP8266
• 1.3.9999.2.2.0: CPU-klocka
• 1.3.9999.2.3.0: Chipmodell för ESP32 eller kärnversion för ESP8266
• 1.3.9999.2.4.0: Antal CPU-kärnor
• 1.3.9999.2.5.0: ESP32-chiprevision eller 0 för ESP8266

Testning

Integrationstester är tillgängliga för denna komponent: https://github.com/aquaticus/esphome_snmp_tests

Nätverksövervakning

För en praktisk guide om hur man övervakar ESPHome-enheter, se ESPHome nätverksövervakning.