Newer
Older
smart-home / proj-ib-lighting-rs485-zarki.yaml
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: "<brak>"
    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.