ESPHome SNMP Компонент

Това е описание на външния ESPHome компонент, който позволява поддръжка на SNMP протокола. Протоколът е широко използван в управлението и мониторинга на мрежи.

Този компонент изисква активиран Wi-Fi. Поддържа версия 2c на протокола. Всички елементи са само за четене.

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

Конфигурационни променливи

• contact (По избор, низ): Стойност за sysContact (1.3.6.1.2.1.1.4) OID. По подразбиране е празен низ.
• location (По избор, низ): Стойност за sysLocation (1.3.6.1.2.1.1.6) OID. По подразбиране е празен низ.

WARNING

SNMP не се поддържа за Ethernet.

Инсталация

Добавете следния раздел към вашия ESPHome YAML конфигурационен файл:

external_components:
    # SNMP компонент
    - source: github://aquaticus/esphome-snmp

OID Списък

OID (Object Identifier) е адрес, използван за уникално идентифициране на статуси.

Система

Обща информация за системата.

• 1.3.6.1.2.1.1.1 (sysDescr): Описание на системата, включително версия на фърмуера и тип на платката
• 1.3.6.1.2.1.1.2 (sysObjectId): Обектен идентификатор, различен за ESP32 и ESP8266
• 1.3.6.1.2.1.1.3 (sysUptime): Времето (в стотни от секундата) откакто Wi-Fi е установил връзка. Ако се използва стандартният WiFi компонент, винаги е 0.
• 1.3.6.1.2.1.1.4 (sysContact): Идентификация на контактното лице. Задава се чрез contact конфигурационен запис
• 1.3.6.1.2.1.1.5 (sysName): Име на възела
• 1.3.6.1.2.1.1.6 (sysLocation): Физическо местоположение на възела. Задава се чрез location конфигурационен запис
• 1.3.6.1.2.1.1.7 (sysServices): Комплект от услуги. Винаги 64.
• 1.3.6.1.2.1.25.1.1 (hrSystemUptime): Времето от стартирането на системата

За да работи sysUptime, трябва да използвате разширен WiFi. Вижте повече тук: Мрежово време на работа.

Съхранение

Информация за FLASH и RAM.

• 1.3.6.1.2.1.25.2.2 (hrMemorySize): Количеството стандартна RAM памет в kb

FLASH

• 1.3.6.1.2.1.25.2.3.1.1.1: (hrStorageIndex): Винаги 1
• 1.3.6.1.2.1.25.2.3.1.3.1: (hrStorageDesc): Описание на съхранението: FLASH
• 1.3.6.1.2.1.25.2.3.1.4.1: (hrAllocationUnit): Винаги 1
• 1.3.6.1.2.1.25.2.3.1.5.1: (hrStorageSize): Размер на FLASH паметта
• 1.3.6.1.2.1.25.2.3.1.6.1: (hrStorageUsed): Използване на FLASH паметта

SPI RAM

За ESP8266 показва 0 като размер и използване.

• 1.3.6.1.2.1.25.2.3.1.1.2: (hrStorageIndex): Винаги 2
• 1.3.6.1.2.1.25.2.3.1.3.2: (hrStorageDesc): Описание на паметта: PSI RAM
• 1.3.6.1.2.1.25.2.3.1.4.2: (hrAllocationUnit): Винаги 1
• 1.3.6.1.2.1.25.2.3.1.5.2: (hrStorageSize): Размер на SPI RAM паметта
• 1.3.6.1.2.1.25.2.3.1.6.2: (hrStorageUsed): Използване на SPI RAM паметта

Wi-Fi

Детайли за 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: IP адрес

ESP32 heap

Налично само за чипове базирани на ESP32.

• 1.3.9999.32.1.0: Размер на heap
• 1.3.9999.32.2.0: Свободен heap
• 1.3.9999.32.3.0: Минимален свободен heap
• 1.3.9999.32.4.0: Максимално заделен heap

ESP8266 heap

Налично само за чипове ESP8266.

• 1.3.9999.8266.1.0: Свободен heap
• 1.3.9999.8266.2.0: Фрагментация на heap в проценти
• 1.3.9999.8266.3.0: Максимален размер на свободния heap блок

Чип

Детайли за CPU.

• 1.3.9999.2.1.0: тип чип, 32 за EPS32, 8266 за ESP8266
• 1.3.9999.2.2.0: Часовник на CPU
• 1.3.9999.2.3.0: Модел на чип за ESP32 или версия на ядрото за ESP8266
• 1.3.9999.2.4.0: Брой на CPU ядра
• 1.3.9999.2.5.0: Ревизия на ESP32 чип или 0 за ESP8266

Тестване

Интеграционни тестове са налични за този компонент: https://github.com/aquaticus/esphome_snmp_tests

Мрежов мониторинг

За практическо ръководство как да наблюдавате ESPHome устройства вижте ESPHome мрежов мониторинг.