.. _const:

Const
---------

Podstawowy bloczek systemu służący do generowania sygnału o stałej wartości.

    .. image:: _static/const_ikona.png
      :width: 212
      :height: 92
      :alt: Const

Dane możliwe do uzyskania z bloku
~~~~~~~~~~~~~~~~~~~~~~
Wartość sygnału o różnym typie danych: string, number, boolen.


Opis parametrów ikony
~~~~~~~~~~~~~~~~~~~~~~~
    .. image:: _static/const_opis.png
      :width: 212
      :height: 92
      :alt: Const_opis

  * **1** - Wejście sygnału sterującego.
  * **2** - Nazwa bloczka nadana przez użytkownika.
  * **3** - Wyjście sygnałowe.
  * **4** - Stan bloczka: zielony – działa, czerwony - błąd.
  * **5** - Komunikaty bloczka.


Wejście (1)
~~~~~~~~~~~~~~~~~~~~~~
Wejście dla danych sterujących.
Bloczek sterowany jest z elementów generujących sygnał true lub false (1 lub 0), sygnałem null, bądź za pomocą zbocza opadającego i/lub rosnącego.

Jeśli do wejścia nie jest nic podłączone, sygnał jest generowany jednorazowo podczas kompilacji programu.
Gdy podłączymy bloczek generujący impuls np. inject, daje nam to możliwość wyzwolenia wartości w bloczku const podczas działania programu.


Wyjście (3)
~~~~~~~~~~~~~~~~~~~~~~
Wyjście zwraca wartość ustawioną w bloczku.
Typ danych oraz ich wartość jest deklarowana w ustawieniach bloczka. 

**Bloczek generuje tylko jedną z opcji - kolor lub wartość.**


Komunikaty bloczka (5)
~~~~~~~~~~~~~~~~~~~~~~
Bloczek wyświetla informację o generowanej danej:
  * Wartość numeryczna.
  * Kolor wraz z poziomem jasności. 
  * Napis.
  * Sygnał true, false lub null.

Sygnał null generowany jest automatycznie, gdy do bloczka podłączone jest wejście, które nie aktywuje bloczka (sygnał wejścia nie jest zgodny z ustawionym zboczem wyzwalającym).


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

    .. image:: _static/const_properties.png
      :width: 316
      :height: 190
      :alt: Const_properties

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

  **Wartość** - Wartość zwracana przez bloczek o wybranym typie danych:
    * **String** - Napis.
    * **Number** - Wartość liczbowa.
    * **Boolen** - Wartość logiczna.

  **Użyj koloru** - Zaznaczanie tej opcji pozwala na generowanie sygnału o konkretnych danych:
    * **Kolor** - Wybór koloru.
    * **Jasność** - Ustawienie poziomu jasności generowanego koloru za pomocą suwaka.
  
  **Zbocze wyzwalające** - Rodzaj sygnału powodującego wyzwolenie:
    * Zbocze opadające (Falling) - Zmiana z 1 na 0.
    * Zbocze narastające (Rising) - Zmiana z 0 na 1.
    * Zbocze narastające lub opadające (Rising or Falling) - Zmiana z 1 na 0 lub z 0 na 1.
    * True - Prawda (1).
    * False - Fałsz (0).
    * Null - Brak sygnału.


Przykładowe wykorzystanie bloku
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Zapis stałej wartość porównywanej z wartością odczytaną z czujnika

    .. image:: _static/const_przyklad1.png
      :width: 575
      :height: 155
      :alt: Const_przyklad1

Opis działania układu:

W bloczku const o nazwie "Jasność" zapisany jest poziom stałej jasności, a następnie przekazany do bloczka tag: 1. Za pomocą bloczka comparator porównywany jest zapisany poziom jasności z odczytem pochodzącym z czujnika zewnętrznego.
Gdy wartość odczytana z czujnika jest niższa niż ustawiona w bloczku const to uzyskujemy sygnał wysoki na wyjściu bloczka comparator.

Zadanie wartości koloru oraz jasności dla dimmera w zależności od godziny.
    .. image:: _static/const_przyklad2.png
      :width: 605
      :height: 141
      :alt: Const_przyklad2

Opis działania układu:

Bloczki clock-timer zawierają konfigurację godzinową (górny bloczek) 12-16 (dolny bloczek) 16-20, czyli górny bloczek zwróci wartość True między 12-16, a dolny między 16-20. W bloczkach const wybrane zostały kolory oraz jasności jakie ma przyjąć urządzenie podłączone do bloczka output w danych godzinach.
Gdy górny bloczek clock-timer wygeneruje sygnał True to "pwm3_4: Led salon" przyjmie ustawienia podane przez podłączony do niego bloczek const. Gdy dolny bloczek clock-timer wygeneruje sygnał True system zadziała analogicznie.

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

      oprogramowanie/foldery
      oprogramowanie/konfigurator
      oprogramowanie/urzadzenia
      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