ha-c14

ESP32 jako master/bridge/slave na magistrali C14 (COMPIT/PRO-VENT) do rekuperatora AERO3Bv2 z panelem pokojowym Nano Color CTP PRO5v10.

Pliki

• PROTOCOL.md — pełna dokumentacja reverse engineering protokołu C14 (mapa ramek, kodowanie, checksum, timing)
• c14.example.yaml — przykładowy user-template. Skopiuj, dostosuj substitutions + piny UART + secrets, gotowe.
• packages/c14_core.yaml — silnik C14: globals, scripts, cykl Mastera, parser ramek 30B, encje HA (switch/select/number/sensor). User nie kopiuje — ściąga się sam przez github-package.

Hardware

• ESP32-WROOM-32 (lub kompatybilny)
• 1× RS485 HW-0519 (3.3V, auto-direction), wpięty równolegle do A1/B1 magistrali Nano↔AERO (single-bus tap — ESP słucha cały ruch i może nadawać własne ramki)
• Domyślnie RX/TX = GPIO16/17 (zmienisz w swoim *.yaml jeśli inne piny)

Instalacja

1. Skopiuj c14.example.yaml z tego repo do swojego /config/esphome/ jako np. c14.yaml
2. Edytuj swój plik:
   • substitutions: — device_name, friendly_name
   • uart: — sprawdź piny rx_pin/tx_pin. NIE zmieniaj id: uart_bus — c14_core.yaml używa tego ID jako kontraktu.
3. secrets.yaml w /config/esphome/:

   wifi_ssid: "twoje_ssid"
   wifi_password: "haslo"
   api_key: "wygenerowany_klucz_esphome"
   ota_password: "haslo_ota"

4. esphome run c14.yaml (compile + upload + log w jednym)
   • Pierwsze uruchomienie: ESPHome sklonuje to repo do .esphome/packages/<hash>/ i wczyta c14_core.yaml
   • Kolejne uruchomienia: cache lokalny, refresh co 1d (patrz refresh: w packages:)
   • Jeśli używasz ESPHome przez HA addon, możesz też kliknąć Install w dashboardzie
5. Po podłączeniu do HA encje pojawią się jako switch.<device>_master_on, select.<device>_termostat, select.<device>_wentylacja itd.

Wersjonowanie i powiadomienia o aktualizacjach

c14.example.yaml domyślnie pinuje do konkretnego tagu (np. ref: v1.3). Lista wersji: https://github.com/Pioszym/ha-c14/releases

Update notifications:

• Na GitHubie: kliknij Watch (góra repo) → Custom → zaznacz Releases. Dostajesz email + powiadomienie GitHub przy każdym nowym release.
• W HA: opcjonalnie dodaj REST sensor który pulluje GitHub API i triggeruje notyfikację:

  # configuration.yaml
  sensor:
    - platform: rest
      name: C14 Core Latest
      resource: https://api.github.com/repos/Pioszym/ha-c14/releases/latest
      value_template: "{{ value_json.tag_name }}"
      scan_interval: 21600   # 6h

  Potem automatyzacja na zmianę stanu tego sensora → notify mobile.

Bleeding-edge? Zmień ref: vX.Y → ref: main. Pamiętaj że main bywa eksperymentalny.

Status

Reverse engineering w toku. Większość kluczowych pól rozszyfrowana — ESP-master działa i steruje centralą. Szczegóły w PROTOCOL.md.

Disclaimer

Ten projekt to niezależny reverse-engineering w celu integracji rekuperatora COMPIT C14 / Prodmax z Home Assistant. Wszystkie obserwacje techniczne wykonane na sprzęcie będącym własnością autora.

• Projekt nie jest powiązany, sponsorowany ani autoryzowany przez COMPIT Sp. z o.o. ani Prodmax
• "COMPIT", "C14", "Nano CTP", "AERO", "Prodmax" są znakami towarowymi ich właścicieli — używane wyłącznie opisowo (nominative fair use) dla wskazania kompatybilności sprzętu
• Publikacja w oparciu o:
  • Dyrektywę UE 2009/24/WE (prawo do reverse engineering w celu interoperabilności)
  • Art. 75 polskiej Ustawy o prawie autorskim i prawach pokrewnych
  • Wyrok TSUE SAS Institute v. WPL (C-406/10) — RE dla interoperabilności jest dozwolony
• Format ramek RS-485 to fakty techniczne (nie utwór chroniony) — opisalność na równi z formatami JSON, MIDI, ASCII
• Kod firmware ESP32 to oryginalny utwór autora (lambdy ESPHome), nie kopia firmware COMPIT
• Użycie na własne ryzyko — autor nie ponosi odpowiedzialności za ewentualne uszkodzenia sprzętu lub awarię systemu wentylacji

Licencje

• Dokumentacja (PROTOCOL.md, README.md): CC-BY-SA 4.0
• Kod firmware (c14.example.yaml, packages/c14_core.yaml, ESPHome lambdy): MIT

Uwaga dla użytkowników

Modyfikacja sterownika rekuperatora może spowodować utratę gwarancji producenta. Sprawdź warunki gwarancji przed podłączeniem ESP32 do magistrali C14.