ESPHome SNMP-component

Dit is de beschrijving van de externe ESPHome-component die ondersteuning biedt voor het SNMP-protocol. Het protocol wordt veel gebruikt in netwerkbeheer en netwerkmonitoring.

Deze component vereist ingeschakelde Wi-Fi. Het ondersteunt versie 2c van het protocol. Alle items zijn alleen-lezen.

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

Configuratievariabelen

• contact (Optioneel, string): Waarde voor sysContact (1.3.6.1.2.1.1.4) OID. Standaard een lege string.
• location (Optioneel, string): Waarde voor sysLocation (1.3.6.1.2.1.1.6) OID. Standaard een lege string.

WARNING

SNMP wordt niet ondersteund voor Ethernet.

Installatie

Voeg het volgende gedeelte toe aan je ESPHome YAML-configuratiebestand:

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

OID-lijst

OID (Object Identifier) is een adres dat wordt gebruikt om statussen uniek te identificeren.

Systeem

Algemene systeeminformatie.

• 1.3.6.1.2.1.1.1 (sysDescr): Systeemomschrijving inclusief firmwareversie en boardtype
• 1.3.6.1.2.1.1.2 (sysObjectId): Object-id, verschillend voor ESP32 en ESP8266
• 1.3.6.1.2.1.1.3 (sysUptime): De tijd (in honderdsten van een seconde) sinds Wi-Fi verbinding heeft gemaakt. Als de standaard WiFi-component wordt gebruikt, altijd 0.
• 1.3.6.1.2.1.1.4 (sysContact): Identificatie van de contactpersoon. Ingesteld door contact configuratie-invoer
• 1.3.6.1.2.1.1.5 (sysName): Naam van de node
• 1.3.6.1.2.1.1.6 (sysLocation): Fysieke locatie van de node. Ingesteld door location configuratie-invoer
• 1.3.6.1.2.1.1.7 (sysServices): Set van services. Altijd 64.
• 1.3.6.1.2.1.25.1.1 (hrSystemUptime): De tijd sinds het opstarten

Om sysUptime te laten werken, moet je uitgebreide WiFi gebruiken. Zie meer hier: Netwerk uptime.

Opslag

Informatie over FLASH en RAM.

• 1.3.6.1.2.1.25.2.2 (hrMemorySize): De hoeveelheid standaard RAM-geheugen in kb

FLASH

• 1.3.6.1.2.1.25.2.3.1.1.1: (hrStorageIndex): Altijd 1
• 1.3.6.1.2.1.25.2.3.1.3.1: (hrStorageDesc): Beschrijving van de opslag: FLASH
• 1.3.6.1.2.1.25.2.3.1.4.1: (hrAllocationUnit): Altijd 1
• 1.3.6.1.2.1.25.2.3.1.5.1: (hrStorageSize): FLASH-geheugengrootte
• 1.3.6.1.2.1.25.2.3.1.6.1: (hrStorageUsed): FLASH-geheugengebruik

SPI RAM

Voor ESP8266 toont het 0 als grootte en gebruik.

• 1.3.6.1.2.1.25.2.3.1.1.2: (hrStorageIndex): Altijd 2
• 1.3.6.1.2.1.25.2.3.1.3.2: (hrStorageDesc): Beschrijving van de opslag: PSI RAM
• 1.3.6.1.2.1.25.2.3.1.4.2: (hrAllocationUnit): Altijd 1
• 1.3.6.1.2.1.25.2.3.1.5.2: (hrStorageSize): SPI RAM-geheugengrootte
• 1.3.6.1.2.1.25.2.3.1.6.2: (hrStorageUsed): SPI RAM-geheugengebruik

Wi-Fi

Wi-Fi signaaldetails.

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

ESP32 heap

Alleen beschikbaar op ESP32-gebaseerde chips.

• 1.3.9999.32.1.0: Heap-grootte
• 1.3.9999.32.2.0: Vrije heap
• 1.3.9999.32.3.0: Minimale vrije heap
• 1.3.9999.32.4.0: Maximale toegewezen heap

ESP8266 heap

Alleen beschikbaar voor ESP8266-chips.

• 1.3.9999.8266.1.0: Vrije heap
• 1.3.9999.8266.2.0: Heap-fragmentatie in procenten
• 1.3.9999.8266.3.0: Maximale grootte van het vrije heap-blok

Chip

CPU-details.

• 1.3.9999.2.1.0: chiptype, 32 voor EPS32, 8266 voor ESP8266
• 1.3.9999.2.2.0: CPU-klok
• 1.3.9999.2.3.0: Chipmodel voor ESP32 of kernversie voor ESP8266
• 1.3.9999.2.4.0: Aantal CPU-kernen
• 1.3.9999.2.5.0: ESP32-chiprevisie of 0 voor ESP8266

Testen

Integratietests zijn beschikbaar voor deze component: https://github.com/aquaticus/esphome_snmp_tests

Netwerkmonitoring

Voor een praktische gids over hoe je ESPHome-apparaten kunt monitoren, zie ESPHome netwerkmonitoring.