.. _input:

Input
----------
Input – Podstawowy bloczek służący do pobierania informacji z modułów podłączonych w systemie. Pobrane wartości są tylko do odczytu.
    .. image:: _static/ikona_input.png
      :width: 200
      :height: 100
      :alt: Input


Dane możliwe do uzyskania z bloku
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Informacje z wejść cyfrowych - ON/OFF.
* Informacje pobierane z czujników np. temperatura, poziom natężenia światła, kontaktron, czujnik ruchu.
* Inne wartości raportowane przez urządzenie np. poziom naładowania baterii.


Opis parametrów ikony
~~~~~~~~~~~~~~~~~~~~~~
    .. image:: _static/input_opis.png
      :width: 200
      :height: 100
      :alt: Input opis

* **1** - Nazwa bloczka nadana przez użytkownika.
* **2** - Powiadomienie o błędnej lub niewystarczającej konfiguracji.
* **3** - Niebieski znacznik informujący o wprowadzeniu nowych ustawień przy braku zapisu zmian w systemie.
* **4** - Wybrana wartość zwracana przez urządzenie.
* **5** - Status urządzenia: "true" - podłączone, "false" - niepodłączone.
* **6** - Stan bloczka: zielony – działa, czerwony - błąd.
* **7** - A(B), gdzie A - krotność użytego wejścia urządzenia w projekcie, B - krotność użytego parametru urządzenia (jasność, kolor).
* **8** - Dane odebrane z wybranego wejścia lub wartość błędu zwracana z bloczka.


Wyjście (4)
~~~~~~~~~~~~~~~~~~~~~~
Wyjście zwraca wartości wysyłane przez urządzenie - tylko do odczytu.
Typ zwracanej wartości uzależniony jest od wybranego urządzenia.

Możliwe sygnały:
    * True - Prawda (1)
    * False - Fałsz (0)
    * Null - Brak wartości
    * Wartość numeryczna (temperatura/napięcie/jasność)


Komunikaty bloczka (8)
~~~~~~~~~~~~~~~~~~~~~~~
Opis pod bloczkiem zawiera informacje zwracane przez urządzenie lub jeden z poniższych komunikatów:
      * **Missing device_id** - Nie wybrano urządzenia lub wybrane urządzenie jest nieprawidłowe.
      * **Missing device_property_name** - Nie wybrano parametru urządzenia.
      * **detached** - Urządzenie niepodłączone do systemu, brak komunikacji z modułem.
      * **null** - Brak wartości, stan początkowy.


Konfiguracja bloczka
~~~~~~~~~~~~~~~~~~~~~~
Ustawienia dostępne po podwójnym kliknięciu lewym przyciskiem myszy.

    .. image:: _static/input_properties.png
      :width: 440
      :height: 300
      :alt: Input properties

   **Nazwa** - Nazwa bloczka nadana przez użytkownika.

   **Urządzenie** - Wybór urządzenia (wejścia) z dostępnej listy urządzeń.

   **Właściwość** - Wybór parametru odczytywanego z urządzenia.

   **Włączony/Wyłączony** - Włączenie/wyłączenie działania bloczka.


Przykładowe wykorzystanie bloku
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Sterowanie klimatyzacją w zależności od temperatury w pomieszczeniu

.. image:: _static/input_przyklad1.png
      :width: 845
      :height: 145
      :alt: Input opis

Opis działania układu:

Za pomocą bloczka input nazwanego "Klimatyzator" pobierana jest wartość temperatury z wejścia s9_1.
Sygnał z bloczka wysyłany jest za pomocą pierwszego wyjścia, a następnie za pomocą bloczka tag nadawany jest numer parametru.
Bloczek const zwraca stałą wartość (w tym przypadku 25), która jest przekazywana poprzez bloczek tag jako drugi parametr do bloczka comparator.
Na wyjściu bloczka comparator generowany jest stan wysoki lub niski w zależności od poprawności warunku między tag: 1, a tag: 2.

.. toctree::
      :maxdepth: 2 
      :hidden:
      :caption: Interfejs użytkownika

      oprogramowanie/foldery
      oprogramowanie/konfigurator
      oprogramowanie/devices
      oprogramowanie/gate
      oprogramowanie/przeglad
      oprogramowanie/zdalny_dostep


.. toctree::
      :maxdepth: 2 
      :hidden:
      :caption: Urządzenia

      oprogramowanie/input
      oprogramowanie/output


.. toctree::
      :maxdepth: 2 
      :hidden:
      :caption: Moduły

      oprogramowanie/dimmer
      oprogramowanie/command
      oprogramowanie/d-latch
      oprogramowanie/impulse-generator
      oprogramowanie/impulse-counter
      oprogramowanie/click-analyzer
      oprogramowanie/astro-timer
      oprogramowanie/clock-timer


.. toctree::
      :maxdepth: 2 
      :hidden:
      :caption: Bramki logiczne

      oprogramowanie/and
      oprogramowanie/or
      oprogramowanie/not


.. toctree::
      :maxdepth: 2 
      :hidden:
      :caption: Narzędzia

      oprogramowanie/math
      oprogramowanie/tag
      oprogramowanie/comparator 
      oprogramowanie/const
      oprogramowanie/inject
      oprogramowanie/switch
      oprogramowanie/comment


.. toctree::
      :maxdepth: 2 
      :hidden:
      :caption: Modbus

      oprogramowanie/modbus-read copy
      oprogramowanie/modbus-write
      oprogramowanie/ac


.. toctree::
      :maxdepth: 2 
      :hidden:
      :caption: Mobile

      oprogramowanie/app_value
      oprogramowanie/app_button
      oprogramowanie/app_label


.. toctree::
      :maxdepth: 2 
      :hidden:
      :caption: Inne

      oprogramowanie/dane