.. _click-analyzer:

Click-analyzer
----------------

Podstawowy bloczek służący do analizowania czasu trwania sygnałów wejściowych.
    .. image:: _static/click-analyzer_ikona.png
      :width: 200
      :height: 100
      :alt: Click-analyzer


Dane możliwe do uzyskania z bloku
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Wartość logiczna true lub false (1 lub 0).


Opis parametrów ikony
~~~~~~~~~~~~~~~~~~~~~~~
    .. image:: _static/click-analyzer_opis.png
      :width: 200
      :height: 100
      :alt: Impulse-counter opis

  * **1** - Wejście sygnału sterującego.
  * **2** - Nazwa bloczka nadana przez użytkownika.
  * **3** - Wciśnięty.
  * **4** - Długie wciśnięcie.
  * **5** - Zwolniony.
  * **6** - Zwolniony po krótkim wciśnięciu.
  * **7** - Zwolniony po długim wciśnięciu.
  * **8** - Wartość z wejścia.
  * **9** - Stan bloczka: zielony – działa, czerwony - błąd.
  * **10** - Stan wyjścia bloku lub informacja o błędzie.


Wejście (1)
~~~~~~~~~~~~~~~~~~~~~~
Bloczek sterowany jest z elementów generujących sygnał true lub false (1 lub 0).
Podłącznie większej ilości sygnałów niż jeden, skutkować będzie reakcją bloczka na ostatni otrzymany sygnał. Przykładowo, gdy jeden z podłączonych przcisków jest wciśniety i zaczniemy wciskać kolejny bloczek wykryje tylko to odpuszczenie przycisku, które zdarzy się jako pierwsze. Odpuszczenie następnego przycisku nie zostanie zarejestrowane.


Wyjścia (3-8)
~~~~~~~~~~~~~~~~~~~~~~
Bloczek posiada sześć wyjść zwracających wartość 0 lub 1:

**3 - Wciśnięty**  - Krótki sygnał generowany podczas wykrycia na wejściu sygnału w stanie wysokim.

**4 - Długie wciśnięcie** - Sygnał generowany podczas wykrycia na wejściu sygnału wysokiego przez okres dłuższy niż "Czas graniczny" ustawiony w konfiguracji bloczka.

**5 - Zwolniony** - Sygnał generowany podczas wykrycia na wejściu zmiany sygnału z wysokiego na niski.

**6 - Zwolniony po krótkim wciśnięciu** - Sygnał generowany podczas wykrycia na wejściu zmiany sygnału z wysokiego na niski oraz czas trwania sygnału wysokiego nie był dłuższy niż "Czasu graniczny" ustawiony w konfiguracji bloczka.

**7 - Zwolniony po długim wciśnięciu** - Sygnał generowany podczas wykrycia na wejściu zmiany sygnału z wysokiego na niski oraz czas trwania sygnału wysokiego był dłuższy niż "Czas graniczny" ustawiony w konfiguracji bloczka.

**8 - Wartość z wejścia** - Sygnał generowany na wyjściu odzwierciedla sygnał wejściowy.


Komunikaty bloczka (10)
~~~~~~~~~~~~~~~~~~~~~~~~
Opis pod bloczkiem zawiera informację o stanie bloczka lub możliwym błędzie:
    * **Invalid time_limit.** - Błąd - Brak wartości "Czas graniczny".
    * **Input disconnected.** - Błąd - Brak podłączonego wejścia.
    * **ready** - System sprawny - Gotowy do działania.
    * **pressed** - System sprawny - Wykrycie sygnału wysokiego na wejściu - wciśnięcie.
    * **released (short)** - System sprawny - Wykrycie zbocza opadającego po krótkim przyciśnięciu.
    * **released (long)** - System sprawny - Wykrycie zbocza opadającego po długim przyciśnięciu.
    * **null** - System sprawny - Brak wartości generowanej - Komunikat po wykonaniu przebudowania programu lub uruchomieniu systemu.


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

    .. image:: _static/click-analyzer_properties.png
      :width: 511
      :height: 422
      :alt: Impulse-counter properties

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

   **Czas graniczny [ms]** - Wartość czasu, po której następuje wykrycie długiego wciśnięcia i jednocześnie maksymalny czas krótkiego wciśnięcia.


Przykładowe wykorzystanie
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Sterowanie oświetleniem w zależności od długości naciśnięcia przycisku

    .. image:: _static/click-analyzer_przyklad1.png
      :width: 600
      :height: 110
      :alt: Impulse-counter opis

Opis działania układu:

Po pojawieniu się krótkiego impulsu (krótkiego wciśnięcia - nie przekraczającego czasu granicznego) z bloczka "Przycisk" nastąpi włączenie za pomocą bloczka d-latch oświetlenia "Oświetlenie kuchnia". Ponowne wysłanie krótkiego impulsu z "przycisk" spowoduje wyłącznie d-latch, a to poskutkuje wyłączeniem oświetlenia "Oświetlenie kuchnia".
Po pojawieniu się długiego impulsu (długiego wciśnięcia - przekraczającego czas graniczny) z bloczka "Przycisk" nastąpi włączenie za pomocą bloczka d-latch oświetlenia w "Lampa2". Ponowne wysłanie długiego impulsu z "przycisk" spowoduje wyłącznie d-latch, a to poskutkuje wyłączeniem oświetlenia "Lampa2".

.. 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