diff --git a/proj-ib-lighting-rs485-zarki.yaml b/proj-ib-lighting-rs485-zarki.yaml new file mode 100644 index 0000000..c41d7a8 --- /dev/null +++ b/proj-ib-lighting-rs485-zarki.yaml @@ -0,0 +1,723 @@ +project: + # --- Metadane Projektu i Dokumentacji --- + id: "PROJ-IB-LIGHTING-RS485-ZARKI" # Unikalny identyfikator projektu + title: "Sterowanie Oświetleniem - Moduły I/O RS485" # Pełna nazwa projektu + project_version: "1.0.0" + project_type: "Custom" + based_on_projects: [] + + # --- Informacje o Dokumentacji (tego pliku YAML) --- + documentation_filename: "proj-ib-lighting-rs485-zarki.yaml" + documentation_version: "1.0.0" + status: "Szkic" + created_at: "2025-12-08" + updated_at: "2025-12-08" + standard_compliance: "CTRL-STD-001-2025-PL:1.0.0" + + # --- Autorzy i Weryfikacja --- + authorship: + author: "AI" + reviewer: "MG" + + # --- Klasyfikacja i Kategoryzacja --- + classification: + security_level: "Poufny" + language: "pl" + tags: ["oświetlenie", "sterowanie", "przełączniki", "rs485", "modbus", "dom"] + categories: + paths: + - "BUILDING/Oświetlenie" + - "CTRL/Sterowanie podstawowe" + standard_compliance: "CTRL-STD-002-2025-PL:1.0.0" + + # --- Lokalizacja Pliku --- + location: + repository: "" + relative_path: "zarki/lighting/proj-ib-lighting-rs485-zarki.yaml" + + # --- Opis Projektu --- + description: | + Implementacja systemu sterowania oświetleniem w poszczególnych strefach (pomieszczeniach) za pomocą modułów I/O RS485. + System opiera się na cyfrowych wejściach (przyciski) i cyfrowych wyjściach (oświetlenie ON/OFF) oraz opcjonalnie wyjściach PX (PWM/ściemnianie). + Każda strefa (ID 30-41) obsługiwana jest przez dedykowany moduł I/O. + + # --- Specyfikacja Sprzętowa --- + hardware_specification: + communication_buses: + - bus_id: "rs.0" + type: "RS485" + parameters: + baud_rate_bps: 9600 + parity: "NONE" + data_bits: 8 + stop_bits: 1 + description: | + Główna magistrala komunikacyjna RS485 dla modułów I/O oświetlenia. + + devices: + # Strefa 30: Wiatrołap + - device_id: "rs.0.id.30" + model_id: "IB-CTRL-IO-RS485" + location: "Wiatrołap" + description: | + Sterownik I/O oświetlenia wiatrołapu. + connections: + - bus_id: "rs.0" + address: "id.30" + io: + - io_id: "input.t.0" + status: "ok" + mapping: "" + description: "Przycisk H1 - sterowanie Led bar AP" + - io_id: "input.t.1" + status: "ok" + mapping: "" + description: "Przycisk H2" + - io_id: "input.t.2" + status: "ok" + mapping: "" + description: "Przycisk K1" + - io_id: "input.t.3" + status: "ok" + mapping: "" + description: "Przycisk K2" + - io_id: "output.do.0" + status: "ok" + mapping: "" + description: "Oświetlenie H1 (Led bar AP)" + - io_id: "output.do.1" + status: "ok" + mapping: "" + description: "Oświetlenie H2 led" + - io_id: "output.do.2" + status: "ok" + mapping: "" + description: "Oświetlenie K1 szynoprzewód nowodworski" + - io_id: "output.do.3" + status: "ok" + mapping: "" + description: "Oświetlenie K2 szynoprzewód nowodworski" + - io_id: "output.px.0" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.30.px0" + - io_id: "output.px.1" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.30.px1" + extension_modules: [] + + # Strefa 31: Kuchnia + - device_id: "rs.0.id.31" + model_id: "IB-CTRL-IO-RS485" + location: "Kuchnia" + description: | + Sterownik I/O oświetlenia kuchni. + connections: + - bus_id: "rs.0" + address: "id.31" + io: + - io_id: "input.t.0" + status: "ok" + mapping: "" + description: "Przycisk K3" + - io_id: "input.t.1" + status: "ok" + mapping: "" + description: "Przycisk K4" + - io_id: "input.t.2" + status: "ok" + mapping: "" + description: "Przycisk K5" + - io_id: "input.t.3" + status: "ok" + mapping: "" + description: "Przycisk K6" + - io_id: "output.do.0" + status: "ok" + mapping: "" + description: "Oświetlenie K3 halogeny okno" + - io_id: "output.do.1" + status: "ok" + mapping: "" + description: "Oświetlenie K4 lampy nad barem" + - io_id: "output.do.2" + status: "ok" + mapping: "" + description: "Oświetlenie K5 półki led" + - io_id: "output.do.3" + status: "ok" + mapping: "" + description: "Oświetlenie K6 led okno" + - io_id: "output.px.0" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.31.px0" + - io_id: "output.px.1" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.31.px1" + extension_modules: [] + + # Strefa 32: Jadalnia / Salon + - device_id: "rs.0.id.32" + model_id: "IB-CTRL-IO-RS485" + location: "Jadalnia / Salon" + description: | + Sterownik I/O oświetlenia jadalni/salonu. + connections: + - bus_id: "rs.0" + address: "id.32" + io: + - io_id: "input.t.0" + status: "ok" + mapping: "" + description: "Przycisk J1" + - io_id: "input.t.1" + status: "ok" + mapping: "" + description: "Przycisk J2" + - io_id: "input.t.2" + status: "ok" + mapping: "" + description: "Przycisk S1" + - io_id: "input.t.3" + status: "ok" + mapping: "" + description: "Przycisk S2" + - io_id: "output.do.0" + status: "ok" + mapping: "" + description: "Oświetlenie J1" + - io_id: "output.do.1" + status: "ok" + mapping: "" + description: "Oświetlenie J2" + - io_id: "output.do.2" + status: "ok" + mapping: "" + description: "Oświetlenie S1 Ring" + - io_id: "output.do.3" + status: "ok" + mapping: "" + description: "Oświetlenie S2 lampy za kanapą" + - io_id: "output.px.0" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.32.px0" + - io_id: "output.px.1" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.32.px1" + extension_modules: [] + + # Strefa 33: Salon + - device_id: "rs.0.id.33" + model_id: "IB-CTRL-IO-RS485" + location: "Salon" + description: | + Sterownik I/O oświetlenia salonu. + connections: + - bus_id: "rs.0" + address: "id.33" + io: + - io_id: "input.t.0" + status: "ok" + mapping: "" + description: "Przycisk S3" + - io_id: "input.t.1" + status: "ok" + mapping: "" + description: "Przycisk S4" + - io_id: "input.t.2" + status: "ok" + mapping: "" + description: "Przycisk S5" + - io_id: "input.t.3" + status: "ok" + mapping: "" + description: "Przycisk S6" + - io_id: "output.do.0" + status: "ok" + mapping: "" + description: "Oświetlenie lampa przed tv" + - io_id: "output.do.1" + status: "ok" + mapping: "" + description: "Oświetlenie led" + - io_id: "output.do.2" + status: "ok" + mapping: "" + description: "Oświetlenie dekoracyjne koło lampy" + - io_id: "output.do.3" + status: "ok" + mapping: "" + description: "Oświetlenie led sufit wnęka" + - io_id: "output.px.0" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.33.px0" + - io_id: "output.px.1" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.33.px1" + extension_modules: [] + + # Strefa 34: Korytarz + - device_id: "rs.0.id.34" + model_id: "IB-CTRL-IO-RS485" + location: "Korytarz" + description: | + Sterownik I/O oświetlenia korytarza. + connections: + - bus_id: "rs.0" + address: "id.34" + io: + - io_id: "input.t.0" + status: "ok" + mapping: "" + description: "Przycisk H3" + - io_id: "input.t.1" + status: "ok" + mapping: "" + description: "Przycisk H4" + - io_id: "input.t.2" + status: "ok" + mapping: "" + description: "Przycisk H5" + - io_id: "input.t.3" + status: "ok" + mapping: "" + description: "Przycisk H6" + - io_id: "output.do.0" + status: "ok" + mapping: "" + description: "Oświetlenie H3 szynoprzewód nowodworski" + - io_id: "output.do.1" + status: "ok" + mapping: "" + description: "Oświetlenie H4 szynoprzewód nowodworski" + - io_id: "output.do.2" + status: "ok" + mapping: "" + description: "Oświetlenie H5 ledy pionowe" + - io_id: "output.do.3" + status: "ok" + mapping: "" + description: "Oświetlenie H6 led kominek" + - io_id: "output.px.0" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.34.px0" + - io_id: "output.px.1" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.34.px1" + extension_modules: [] + + # Strefa 35: Biuro W/ Garderoba + - device_id: "rs.0.id.35" + model_id: "IB-CTRL-IO-RS485" + location: "Biuro W/ Garderoba" + description: | + Sterownik I/O oświetlenia biura/garderoby. + connections: + - bus_id: "rs.0" + address: "id.35" + io: + - io_id: "input.t.0" + status: "ok" + mapping: "" + description: "Przycisk BW1" + - io_id: "input.t.1" + status: "ok" + mapping: "" + description: "Przycisk BW2" + - io_id: "input.t.2" + status: "ok" + mapping: "" + description: "Przycisk G1" + - io_id: "input.t.3" + status: "ok" + mapping: "" + description: "Przycisk G2" + - io_id: "output.do.0" + status: "ok" + mapping: "" + description: "Oświetlenie BW1" + - io_id: "output.do.1" + status: "ok" + mapping: "" + description: "Oświetlenie BW2" + - io_id: "output.do.2" + status: "ok" + mapping: "" + description: "Oświetlenie G1" + - io_id: "output.do.3" + status: "ok" + mapping: "" + description: "Oświetlenie G2 led nad szafami i koło lustra" + - io_id: "output.px.0" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.35.px0" + - io_id: "output.px.1" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.35.px1" + extension_modules: [] + + # Strefa 36: Sypialnia + - device_id: "rs.0.id.36" + model_id: "IB-CTRL-IO-RS485" + location: "Sypialnia" + description: | + Sterownik I/O oświetlenia sypialni. + connections: + - bus_id: "rs.0" + address: "id.36" + io: + - io_id: "input.t.0" + status: "ok" + mapping: "" + description: "Przycisk R1" + - io_id: "input.t.1" + status: "ok" + mapping: "" + description: "Przycisk R2" + - io_id: "input.t.2" + status: "ok" + mapping: "" + description: "Przycisk R3" + - io_id: "input.t.3" + status: "ok" + mapping: "" + description: "Przycisk R4" + - io_id: "output.do.0" + status: "ok" + mapping: "" + description: "Oświetlenie R1 główne" + - io_id: "output.do.1" + status: "ok" + mapping: "" + description: "Oświetlenie R2 nakastlik P" + - io_id: "output.do.2" + status: "ok" + mapping: "" + description: "Oświetlenie R3 nakastlik L" + - io_id: "output.do.3" + status: "ok" + mapping: "" + description: "Oświetlenie R4 led na suficie" + - io_id: "output.px.0" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.36.px0" + - io_id: "output.px.1" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.36.px1" + extension_modules: [] + + # Strefa 37: Łazienka + - device_id: "rs.0.id.37" + model_id: "IB-CTRL-IO-RS485" + location: "Łazienka" + description: | + Sterownik I/O oświetlenia łazienki. + connections: + - bus_id: "rs.0" + address: "id.37" + io: + - io_id: "input.t.0" + status: "ok" + mapping: "" + description: "Przycisk L1" + - io_id: "input.t.1" + status: "ok" + mapping: "" + description: "Przycisk L2" + - io_id: "input.t.2" + status: "ok" + mapping: "" + description: "Przycisk L3" + - io_id: "input.t.3" + status: "ok" + mapping: "" + description: "Przycisk L4" + - io_id: "output.do.0" + status: "ok" + mapping: "" + description: "Oświetlenie L1" + - io_id: "output.do.1" + status: "ok" + mapping: "" + description: "Oświetlenie L2" + - io_id: "output.do.2" + status: "ok" + mapping: "" + description: "Oświetlenie L3" + - io_id: "output.do.3" + status: "ok" + mapping: "" + description: "Oświetlenie L4" + - io_id: "output.px.0" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.37.px0" + - io_id: "output.px.1" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.37.px1" + extension_modules: [] + + # Strefa 38: Łazienka/WC + - device_id: "rs.0.id.38" + model_id: "IB-CTRL-IO-RS485" + location: "Łazienka/WC" + description: | + Sterownik I/O oświetlenia łazienki/WC. + connections: + - bus_id: "rs.0" + address: "id.38" + io: + - io_id: "input.t.0" + status: "nc" + mapping: "" + description: "Wolne wejście" + - io_id: "input.t.1" + status: "ok" + mapping: "" + description: "Przycisk L6" + - io_id: "input.t.2" + status: "ok" + mapping: "" + description: "Przycisk W1" + - io_id: "input.t.3" + status: "ok" + mapping: "" + description: "Przycisk W2" + - io_id: "output.do.0" + status: "ok" + mapping: "" + description: "Oświetlenie L5" + - io_id: "output.do.1" + status: "ok" + mapping: "" + description: "Oświetlenie L6" + - io_id: "output.do.2" + status: "ok" + mapping: "" + description: "Oświetlenie W1" + - io_id: "output.do.3" + status: "ok" + mapping: "" + description: "Oświetlenie W2" + - io_id: "output.px.0" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.38.px0" + - io_id: "output.px.1" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.38.px1" + extension_modules: [] + + # Strefa 39: Basia (Pokój) + - device_id: "rs.0.id.39" + model_id: "IB-CTRL-IO-RS485" + location: "Basia" + description: | + Sterownik I/O oświetlenia pokoju Basi. + connections: + - bus_id: "rs.0" + address: "id.39" + io: + - io_id: "input.t.0" + status: "ok" + mapping: "" + description: "Przycisk D1" + - io_id: "input.t.1" + status: "ok" + mapping: "" + description: "Przycisk D2" + - io_id: "input.t.2" + status: "ok" + mapping: "" + description: "Przycisk D3" + - io_id: "input.t.3" + status: "ok" + mapping: "" + description: "Przycisk D4" + - io_id: "output.do.0" + status: "ok" + mapping: "" + description: "Oświetlenie D1 główne" + - io_id: "output.do.1" + status: "ok" + mapping: "" + description: "Oświetlenie D2 nad biurkiem" + - io_id: "output.do.2" + status: "ok" + mapping: "" + description: "Oświetlenie D3 chmurka" + - io_id: "output.do.3" + status: "ok" + mapping: "" + description: "Oświetlenie D4 łóżko" + - io_id: "output.px.0" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.39.px0" + - io_id: "output.px.1" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.39.px1" + extension_modules: [] + + # Strefa 40: Biuro A + - device_id: "rs.0.id.40" + model_id: "IB-CTRL-IO-RS485" + location: "Biuro A" + description: | + Sterownik I/O oświetlenia biura A. + connections: + - bus_id: "rs.0" + address: "id.40" + io: + - io_id: "input.t.0" + status: "ok" + mapping: "" + description: "Przycisk B1" + - io_id: "input.t.1" + status: "ok" + mapping: "" + description: "Przycisk B2" + - io_id: "input.t.2" + status: "nc" + mapping: "" + description: "Wolne wejście" + - io_id: "input.t.3" + status: "ok" + mapping: "" + description: "Przycisk B4" + - io_id: "output.do.0" + status: "ok" + mapping: "" + description: "Oświetlenie B1 główne" + - io_id: "output.do.1" + status: "ok" + mapping: "" + description: "Oświetlenie B2 nad biurkiem" + - io_id: "output.do.2" + status: "ok" + mapping: "" + description: "Oświetlenie B3 biurko lampa" + - io_id: "output.do.3" + status: "ok" + mapping: "" + description: "Oświetlenie B4 dla ledów" + - io_id: "output.px.0" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.40.px0" + - io_id: "output.px.1" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.40.px1" + extension_modules: [] + + # Strefa 41: WC/Poddasze + - device_id: "rs.0.id.41" + model_id: "IB-CTRL-IO-RS485" + location: "WC/Poddasze" + description: | + Sterownik I/O oświetlenia WC/poddasze. + connections: + - bus_id: "rs.0" + address: "id.41" + io: + - io_id: "input.t.0" + status: "ok" + mapping: "" + description: "Przycisk W2 góra halogeny" + - io_id: "input.t.1" + status: "ok" + mapping: "" + description: "Przycisk W3 halogen prysznic" + - io_id: "input.t.2" + status: "ok" + mapping: "" + description: "Przycisk P1 poddasze 1" + - io_id: "input.t.3" + status: "ok" + mapping: "" + description: "Przycisk P2 Poddasze 2" + - io_id: "output.do.0" + status: "ok" + mapping: "" + description: "Oświetlenie W2 góra halogeny" + - io_id: "output.do.1" + status: "ok" + mapping: "" + description: "Oświetlenie W3 halogen prysznic + led" + - io_id: "output.do.2" + status: "ok" + mapping: "" + description: "Oświetlenie P1 Poddasze 1" + - io_id: "output.do.3" + status: "ok" + mapping: "" + description: "Oświetlenie P2 Poddasze 2" + - io_id: "output.px.0" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX. Adres rs.0.id.41.px0" + - io_id: "output.px.1" + status: "nc" + mapping: "" + description: "Opcjonalne wyjście PWM/PX." + extension_modules: [] + + # --- Notatki Projektowe --- + notes: + - note_id: "TODO" + title: "Lista zadań do wykonania" + content: | + - Potwierdzić model urządzenia I/O (`IB-CTRL-IO-RS485`) dla wszystkich stref (30-41). + - Sprawdzić, które wyjścia DO powinny być mapowane na wyjścia PX (PWM) dla ściemniania. + - Zaprojektować logikę przełączania (np. pojedyncze kliknięcie, podwójne kliknięcie) dla przycisków monostabilnych. + + - note_id: "LEGEND" + title: "Legenda oznaczeń statusu I/O" + content: | + | Symbol YAML | Opis | + |-------------|-----------------------------------------------------------------------------------------| + | `ok` | Wszystko działa poprawnie, punkt I/O jest podłączony i działa / Odczyt jest poprawny | + | `err` | Uszkodzenie wyjścia/wejścia lub błąd odczytu | + | `!` | Wymaga uwagi (szczegóły w description) | + | `nc` | Brak podłączenia i obsługi (celowo) | + | `??` | Status nieznany | + + # --- Powiązane Dokumenty --- + referenced_documents: [] + + # --- Powiązane Załączniki --- + referenced_attachments: [] + + # --- Historia Zmian Projektu --- + project_change_log: + - version: "1.0.0" + date: "2025-12-08" + author: "AI" + description: | + - Utworzenie projektu na podstawie listy punktów oświetleniowych. + - Przyjęcie założenia, że każda strefa 30-41 to oddzielny moduł I/O RS485. + + # --- Historia Zmian Dokumentacji --- + documentation_change_log: + - version: "1.0.0" + date: "2025-12-08" + author: "AI" + description: | + - Utworzenie dokumentacji projektowej na podstawie wytycznych i struktury wzorcowej. \ No newline at end of file