ESPHome SNMP-komponent

Dette er en beskrivelse af den eksterne ESPHome-komponent, der muliggør understøttelse af SNMP-protokollen. Protokollen er bredt anvendt i netværksstyring og netværksovervågning.

Denne komponent kræver Wi-Fi aktiveret. Den understøtter version 2c af protokollen. Alle elementer er skrivebeskyttede.

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

Konfigurationsvariabler

• contact (Valgfri, string): Værdi for sysContact (1.3.6.1.2.1.1.4) OID. Standard er en tom streng.
• location (Valgfri, string): Værdi for sysLocation (1.3.6.1.2.1.1.6) OID. Standard er en tom streng.

WARNING

SNMP understøttes ikke for Ethernet.

Installation

Tilføj følgende sektion til din ESPHome YAML-konfigurationsfil:

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

OID-liste

OID (Object Identifier) er en adresse, der bruges til entydigt at identificere statusser.

System

Generel systeminformation.

• 1.3.6.1.2.1.1.1 (sysDescr): Systembeskrivelse inklusive firmware version og korttype
• 1.3.6.1.2.1.1.2 (sysObjectId): Objekt-id, forskellig for ESP32 og ESP8266
• 1.3.6.1.2.1.1.3 (sysUptime): Tiden (i hundrededele af et sekund) siden Wi-Fi etablerede forbindelse. Hvis standard WiFi-komponenten bruges, altid 0.
• 1.3.6.1.2.1.1.4 (sysContact): Identifikation af kontaktpersonen. Indstillet af contact konfigurationsindgang
• 1.3.6.1.2.1.1.5 (sysName): Navn på noden
• 1.3.6.1.2.1.1.6 (sysLocation): Fysisk placering af noden. Indstillet af location konfigurationsindgang
• 1.3.6.1.2.1.1.7 (sysServices): Sæt af tjenester. Altid 64.
• 1.3.6.1.2.1.25.1.1 (hrSystemUptime): Tiden siden opstart

For at få sysUptime til at fungere skal du bruge udvidet WiFi. Se mere her: Netværksoppetid.

Lager

Information om FLASH og RAM.

• 1.3.6.1.2.1.25.2.2 (hrMemorySize): Mængden af standard RAM-hukommelse i kb

FLASH

• 1.3.6.1.2.1.25.2.3.1.1.1: (hrStorageIndex): Altid 1
• 1.3.6.1.2.1.25.2.3.1.3.1: (hrStorageDesc): Beskrivelse af lageret: FLASH
• 1.3.6.1.2.1.25.2.3.1.4.1: (hrAllocationUnit): Altid 1
• 1.3.6.1.2.1.25.2.3.1.5.1: (hrStorageSize): FLASH-hukommelsesstørrelse
• 1.3.6.1.2.1.25.2.3.1.6.1: (hrStorageUsed): FLASH-hukommelsesbrug

SPI RAM

For ESP8266 viser den 0 som størrelse og brug.

• 1.3.6.1.2.1.25.2.3.1.1.2: (hrStorageIndex): Altid 2
• 1.3.6.1.2.1.25.2.3.1.3.2: (hrStorageDesc): Beskrivelse af lageret: PSI RAM
• 1.3.6.1.2.1.25.2.3.1.4.2: (hrAllocationUnit): Altid 1
• 1.3.6.1.2.1.25.2.3.1.5.2: (hrStorageSize): SPI RAM hukommelsesstørrelse
• 1.3.6.1.2.1.25.2.3.1.6.2: (hrStorageUsed): SPI RAM hukommelsesbrug

Wi-Fi

Wi-Fi signal 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 adresse

ESP32 heap

Kun tilgængelig på ESP32-baserede chips.

• 1.3.9999.32.1.0: Heap størrelse
• 1.3.9999.32.2.0: Fri heap
• 1.3.9999.32.3.0: Minimum fri heap
• 1.3.9999.32.4.0: Maksimalt allokeret heap

ESP8266 heap

Kun tilgængelig for 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: Maksimal størrelse på den frie heap blok

Chip

CPU detaljer.

• 1.3.9999.2.1.0: chip type, 32 for EPS32, 8266 for ESP8266
• 1.3.9999.2.2.0: CPU Clock
• 1.3.9999.2.3.0: Chip model for ESP32 eller kerneversion for ESP8266
• 1.3.9999.2.4.0: Antal CPU kerner
• 1.3.9999.2.5.0: ESP32 chip revision eller 0 for ESP8266

Testning

Integrationstests er tilgængelige for denne komponent: https://github.com/aquaticus/esphome_snmp_tests

Netværksovervågning

For en praktisk guide til, hvordan man overvåger ESPHome-enheder, se ESPHome netværksovervågning.