PeakControl/ESP32-Hub
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
78fbb9acd9a6d4f6eff52179a9222768dbaa9502
ESP32-Hub/Kuba/dokumentacja.md

13 KiB
Raw Blame History

Main Hub — Dokumentacja

Wersja firmware: 1.1
Platforma: ESPHome (esp-idf)
Autor: Jan Kocoń / Peak Control

Sprzęt

Komponent Opis
MCU ESP32-PoE (board: esp32dev, rev 3+)
Łączność Ethernet LAN8720 (MDC: GPIO23, MDIO: GPIO18, CLK_OUT: GPIO17, Power: GPIO12)
Ekspandery wejść 3× MCP23017 (hub1_IN, hub2_IN, hub3_IN) — łącznie 48 wejść
Ekspandery wyjść 3× MCP23017 (hub1_OUT, hub2_OUT, hub3_OUT) — łącznie 48 wyjść
Sterowniki PWM 2× PCA9685 @ 1500 Hz (pca9685_hub1, pca9685_hub2)
Status LED RGB — GPIO5 (niebieski), GPIO14 (zielony), GPIO15 (czerwony)

Sieć

Parametr Wartość
Statyczne IP 10.10.0.5
Gateway 10.10.0.1
Subnet 255.255.255.0
Port API (HA) 6053
Web UI http://10.10.0.5 (login: admin)

Mapa I2C (SDA: GPIO13, SCL: GPIO16, 200 kHz)

Adres ID Rola
0x20 mcp23xxx_hub1_IN 16 wejść (hub1_in0..15)
0x21 mcp23xxx_hub1_OUT 16 wyjść (hub1_out0..15)
0x22 mcp23xxx_hub2_IN 16 wejść (hub2_in0..15)
0x23 mcp23xxx_hub2_OUT 16 wyjść (hub2_out0..15)
0x24 mcp23xxx_hub3_IN 16 wejść (hub3_in0..15)
0x25 mcp23xxx_hub3_OUT 16 wyjść (hub3_out0..15)
0x40 pca9685_hub1 16-kanałowy PWM
0x41 pca9685_hub2 16-kanałowy PWM

Status LED

Stan Kolor / Efekt
Boot Niebieski — Slow Pulse
Połączono z HA Zielony — stały (50% brightness)
Rozłączono z HA Czerwony — Slow Pulse (100% brightness)

Dostępne efekty: Fast Pulse, Slow Pulse, Random Effect

Wejścia — Binary Sensors

hub1_IN (mcp23xxx_hub1_IN)

ID Opis Debounce
hub1_in0 Wejście 1 50ms
hub1_in1 Wejście 3 50ms
hub1_in2 Wejście 2 50ms
hub1_in3 Sypialnia 3 50ms
hub1_in4 Sypialnia 1 50ms
hub1_in5 Sypialnia 2 100ms
hub1_in6 Sypialnia Łóżko Prawa Strona 50ms
hub1_in7 Sypialnia Łóżko Lewa Strona 50ms
hub1_in8 Pokój dla Gości Lewy 50ms
hub1_in9 Pokój dla Gości Prawy 50ms
hub1_in10..15 (niepodpięte) —

hub2_IN (mcp23xxx_hub2_IN)

ID Opis Debounce
hub2_in0 Korytarz 2 50ms
hub2_in1 Korytarz 3 50ms
hub2_in2 Korytarz 1 50ms
hub2_in3 Mały Korytarz 50ms
hub2_in4 Garderoba Mała 50ms
hub2_in5 Kuchnia 3_1 50ms
hub2_in6 Kuchnia 3_2 50ms
hub2_in7 Kuchnia 2_1 50ms
hub2_in8 Kuchnia 2_2 50ms
hub2_in9 Kuchnia 1_1 50ms
hub2_in10 Kuchnia 1_2 50ms
hub2_in11 Schody 3 50ms
hub2_in12 Schody 1 50ms
hub2_in13 Schody 2 50ms
hub2_in14..15 (niepodpięte) —

hub3_IN (mcp23xxx_hub3_IN)

ID Opis Debounce
hub3_in0 Garderoba Duża Lewy 50ms
hub3_in1 Garderoba Duża Prawy 50ms
hub3_in2 SPA Lewy 50ms
hub3_in3 SPA Prawy 50ms
hub3_in4 Biała Łazienka Ściana 50ms
hub3_in5 Małe WC Lustro Prawy 50ms
hub3_in6 Małe WC Lustro Lewy 50ms
hub3_in7 Biała Łazienka Skos 50ms
hub3_in8 SPA Lustro Lewy 50ms
hub3_in9 SPA Lustro Prawy 50ms
hub3_in10 Biuro Skos 50ms
hub3_in11 Serwer Prawy 50ms
hub3_in12 Serwer Lewy 50ms
hub3_in13..15 (niepodpięte) —

Wyjścia — Switches

hub1_OUT (mcp23xxx_hub1_OUT)

ID Opis
hub1_out0 (wolne)
hub1_out1 SPA Kinkiet Lustro
hub1_out2 Biuro
hub1_out3 Kuchnia Halogen
hub1_out4 SPA Wentylator
hub1_out5 Kanciapa pod schodami
hub1_out6 (wolne)
hub1_out7 Garderoba Duża
hub1_out8 Jadalnia
hub1_out9 WC Lustro
hub1_out10 SPA Halogeny
hub1_out11 (wolne)
hub1_out12 (wolne)
hub1_out13 Mały Korytarz Kinkiet
hub1_out14 Korytarz Halogeny
hub1_out15 Wejście Halogeny

hub2_OUT (mcp23xxx_hub2_OUT)

ID Opis
hub2_out0 Łazienka Sufit
hub2_out1 Sypialnia Łóżko Prawa strona
hub2_out2 WC Sufit
hub2_out3 Mały Korytarz Sufit
hub2_out4 Łazienka Skos
hub2_out5 WC Wentylator
hub2_out6 (wolne)
hub2_out7 Sypialnia Halogen
hub2_out8 Biała Łazienka Wentylator
hub2_out9 (wolne)
hub2_out10 Pokój Gościnny Sufit
hub2_out11 Salon Plafon
hub2_out12 Sypialnia Łóżko Lewa strona
hub2_out13 SPA Zwisy
hub2_out14 Mała Garderoba
hub2_out15 (wolne)

hub3_OUT (mcp23xxx_hub3_OUT)

ID Opis
hub3_out0 (wolne)
hub3_out1 (wolne)
hub3_out2 Wentylator Główny Obieg
hub3_out3 Ogrzewanie Kuchnia
hub3_out4 Ogrzewanie Jadalnia/Salon
hub3_out5 Ogrzewanie Salon kanapa
hub3_out6 Ogrzewanie SPA
hub3_out7 Ogrzewanie Korytarz
hub3_out8 Ogrzewanie Pokój Dziecka 2
hub3_out9 Ogrzewanie Biuro/Serwer
hub3_out10 Ogrzewanie Biuro
hub3_out11 Ogrzewanie Pokój Dziecka 1
hub3_out12 Ogrzewanie Garderoba
hub3_out13 Ogrzewanie Sypialnia 2
hub3_out14 Ogrzewanie Biała Łazienka/WC
hub3_out15 Ogrzewanie Sypialnia 1

Wszystkie wyjścia: restore_mode: ALWAYS_OFF

Światła PWM (PCA9685)

ID Nazwa Typ Kanały PCA9685
status_led Status LED rgb GPIO5/14/15 (LEDC)
sypialnia_led Sypialnia LED rgbww PWM1_1_Hub1, PWM1_2_Hub1, PWM3_1_Hub1, PWM3_2_Hub1, PWM1_1_Hub2
serwer_led Serwer LED cwww PWM2_1_Hub1, PWM2_2_Hub1
jadalnia_led Jadalnia LED cwww PWM4_2_Hub1, PWM4_1_Hub1
biala_lazienka_wanna_led Biała Łazienka wanna LED cwww PWM5_2_Hub1, PWM5_1_Hub1
kuchnia_lezka_led Kuchnia Łezka LED monochromatic PWM2_1_Hub2
SPA_Ledy SPA Ledy cwww PWM5_2_Hub2, PWM5_1_Hub2
pokoj_dla_gosci_led Pokój dla gości LED cwww PWM3_2_Hub2, PWM4_1_Hub2
(brak id) TEST LED 1 monochromatic PWM1_2_Hub2
test_led_2 TEST LED 2 monochromatic PWM3_1_Hub2

Wszystkie LED: default_transition_length: 2.0s
PWM3_2_Hub2 (ch5): max_power: 95% — pozostałe: 100%

Logika przycisków

Granica single/multi-click: 350ms

Gest Timing
1× ON ≤350ms, OFF ≥350ms
2× dwa krótkie impulsy
3× trzy krótkie impulsy
Długi ON ≥350ms

Legenda

  • [HA] — akcja przez homeassistant.service (WLED, wentylator salon)
  • off_all — skrypt wyłączający wszystkie switche i LED-y

hub1_IN

ID / Opis 1× 2× 3× Długi
hub1_in0 / Wejście 1 hub1_out15 (Wejście Halogeny) — — off_all
hub1_in1 / Wejście 3 — — — —
hub1_in2 / Wejście 2 [HA] light.korytarz_kinkiety — — off_all
hub1_in3 / Sypialnia 3 hub2_out12 + hub2_out1 (smart toggle¹) hub2_out12 + hub2_out1 off — —
hub1_in4 / Sypialnia 1 sypialnia_led — — —
hub1_in5 / Sypialnia 2 hub2_out7 (Sypialnia Halogen) — — —
hub1_in6 / Sypialnia Łóżko Prawo hub2_out1 hub2_out12 + hub2_out1 — off_all
hub1_in7 / Sypialnia Łóżko Lewo hub2_out12 hub2_out12 + hub2_out1 — off_all
hub1_in8 / Pokój Gości Lewy hub2_out10 (Pokój Gościnny Sufit) hub1_out7 (Garderoba Duża) — —
hub1_in9 / Pokój Gości Prawy pokoj_dla_gosci_led — — —

¹ Smart toggle hub1_in3 1×: jeśli oba (hub2_out12 i hub2_out1) są ON → oba OFF; w przeciwnym razie → oba ON.

hub2_IN

ID / Opis 1× 2× 3× Długi
hub2_in0 / Korytarz 2 hub1_out15 (Wejście Halogeny) — — —
hub2_in1 / Korytarz 3 [HA] light.korytarz_kinkiety — — off_all
hub2_in2 / Korytarz 1 hub1_out14 (Korytarz Halogeny) — — off_all
hub2_in3 / Mały Korytarz hub1_out13 + hub2_out3 — — —
hub2_in4 / Garderoba Mała hub2_out14 (Mała Garderoba) hub3_out2 (Wentylator Główny Obieg) — —
hub2_in5 / Kuchnia 3_1 hub1_out8 (Jadalnia) — — —
hub2_in6 / Kuchnia 3_2 jadalnia_led — — —
hub2_in7 / Kuchnia 2_1 hub1_out3 (Kuchnia Halogen) — — off_all
hub2_in8 / Kuchnia 2_2 kuchnia_lezka_led — — —
hub2_in9 / Kuchnia 1_1 hub2_out11 (Salon Plafon) [HA] switch.salon_wentylator — —
hub2_in10 / Kuchnia 1_2 [HA] light.komin_led + light.salon_kinkiety_led [HA] light.komin_led — [HA] light.komin_led
hub2_in11 / Schody 3 [HA] light.oczka_taras_2 + light.skrzynia_2 + light.tunel_2 + light.zwis_schody_2 — — —
hub2_in12 / Schody 1 hub2_out11 (Salon Plafon) — — —
hub2_in13 / Schody 2 [HA] light.salon_kinkiet_1_led + light.salon_kinkiet_2_led + light.salon_kinkiet_3_led [HA] light.salon_kinkiety_led + 1/2/3 — [HA] light.komin_led

hub3_IN

ID / Opis 1× 2× 3× Długi
hub3_in0 / Garderoba Duża Lewy hub1_out7 (Garderoba Duża) — — —
hub3_in1 / Garderoba Duża Prawy — — — —
hub3_in2 / SPA Lewy hub2_out13 (SPA Zwisy) — — hub1_out4 (SPA Wentylator)
hub3_in3 / SPA Prawy hub1_out4 + hub1_out10 (SPA Wentylator + Halogeny) — — SPA_Ledy
hub3_in4 / Biała Łazienka Ściana hub2_out0 (Łazienka Sufit) biala_lazienka_wanna_led — hub2_out8 (Łazienka Wentylator)
hub3_in5 / Małe WC Lustro Prawy hub2_out5 + hub2_out2 + [HA] light.wc_led — — —
hub3_in6 / Małe WC Lustro Lewy hub1_out9 (WC Lustro) — — —
hub3_in7 / Biała Łazienka Skos hub2_out4 (Łazienka Skos) — — —
hub3_in8 / SPA Lustro Lewy hub1_out5 (Kanciapa pod schodami) — — —
hub3_in9 / SPA Lustro Prawy hub1_out1 (SPA Kinkiet Lustro) — — —
hub3_in10 / Biuro Skos hub1_out2 (Biuro) serwer_led — —
hub3_in11 / Serwer Prawy serwer_led test_led_2 hub3_out2 (Wentylator Główny Obieg) —
hub3_in12 / Serwer Lewy hub1_out14 (Korytarz Halogeny) hub1_out14 + hub1_out2 (Korytarz + Biuro) — off_all

Czujniki BLE (ATC Mithermometer)

Nazwa MAC
Biuro A4:C1:38:C5:11:58
Serwer A4:C1:38:5C:4F:38
Kuchnia A4:C1:38:67:6B:94
WC A4:C1:38:C9:FE:CA
Łazienka A4:C1:38:63:6D:DB

Każdy czujnik raportuje: temperatura, wilgotność, poziom baterii.

Czujniki diagnostyczne

Encja Opis Interwał
sensor.main_hub_uptime Czas pracy (sekundy) 300s
sensor.main_hub_esp32_temperatura Temperatura chipu ESP32 60s
text_sensor.main_hub_ip_address Adres IP przy zmianie
text_sensor.main_hub_firmware_version Wersja firmware przy zmianie
text_sensor.main_hub_esphome_version Wersja ESPHome przy zmianie

Skrypty

ID Opis
off_all Wyłącza wszystkie switche (hub1/2/3_out) oraz wszystkie LED (PCA9685 + status_led)

Skrypt off_all jest wywoływany przez długie naciśnięcie wybranych wejść (patrz tabela logiki przycisków).

Logi

Poziom globalny: INFO — widoczne są tylko [I], [W], [E]

Filtry per-komponent (wyciszenie INFO z BLE):

logs:
  atc_mithermometer: WARN
  esp32_ble_tracker: WARN
  ble_advertise: WARN

Format komunikatu przy naciśnięciu przycisku:

[I][main:XXXX]: Nazwa Przycisku [gest] → Co zostało włączone

Przykład:

[I][main:1775]: Schody 3 [1×] → Oczka Taras, Skrzynia, Tunel, Zwis Schody
[I][main:1643]: Kuchnia Filar 1_1 [1×] → Salon Plafon
[I][main:1138]: Sypialnia Łóżko Prawo [długi] → off_all

Zdarzenia połączenia z HA:

[I]: HA client connected
[W]: HA client disconnected

Konfiguracja API

Parametr Wartość
Szyfrowanie Noise (klucz w secrets.yaml)
reboot_timeout 0s (nie restartuje się przy braku HA)

OTA / Flashowanie

# Tylko kompilacja
esphome compile main-hub_do\ zrobienia.yaml

# Wgranie OTA
esphome upload main-hub_do\ zrobienia.yaml

# Kompilacja + wgranie + logi
esphome run main-hub_do\ zrobienia.yaml

# Podgląd logów
esphome logs main-hub_do\ zrobienia.yaml

# Walidacja configu
esphome config main-hub_do\ zrobienia.yaml

Wymagany plik secrets.yaml w tym samym katalogu:

api_key: "<32-byte-base64>"
ota_key: "<hasło>"
web_password: "<hasło>"

Encje sterowane przez Home Assistant

Poniższe encje są sterowane przez homeassistant.service (wymagają działającego HA):

Encja HA Opis
light.korytarz_kinkiety WLED — Korytarz kinkiety
light.komin_led WLED — Komin LED
light.salon_kinkiety_led WLED — Salon kinkiety (grupa)
light.salon_kinkiet_1_led WLED — Salon kinkiet 1
light.salon_kinkiet_2_led WLED — Salon kinkiet 2
light.salon_kinkiet_3_led WLED — Salon kinkiet 3
light.wc_led WLED — WC LED
light.oczka_taras_2 WLED — Oczka taras
light.skrzynia_2 WLED — Skrzynia
light.tunel_2 WLED — Tunel
light.zwis_schody_2 WLED — Zwis schody
switch.salon_wentylator Wentylator salon
Reference in New Issue View Git Blame Copy Permalink