.. _astro-timer:

Astro-timer
-------------

Podstawowy bloczek służący do generowania impulsu sterującego w zależności od danych astronomicznych.

    .. image:: _static/astro-timer_ikona.png
      :width: 190
      :height: 70
      :alt: Astro-timer


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


Opis parametrów ikony
~~~~~~~~~~~~~~~~~~~~~~
    .. image:: _static/astro-timer_opis.png
      :width: 190
      :height: 70
      :alt: Astro-timer_opis

 * **1** - Nazwa bloczka nadana przez użytkownika.
 * **2** - W czasie pracy (wyjście aktywne w czasie pracy).
 * **3** - W czasie przerwy (wyjście aktywne w czasie przerwy).
 * **4** - Stan bloczka: zielony – działa, czerwony - błąd.
 * **5** - Komunikaty bloczka.


Wyjścia (2-3)
~~~~~~~~~~~~~~~~~~~~~~
Bloczek posiada dwa wyjścia zwracające wartość 1 lub 0:

  **2 - W czasie pracy** - Zwraca wartość 1, gdy warunek w zegarze jest spełniony. W przeciwnym wypadku zwraca wartość 0.

  **3 - W czasie przerwy** - Zwraca wartość 1, gdy warunek w zegarze nie jest spełniony. W przeciwnym wypadku zwraca wartość 0.


Komunikaty bloczka (5)
~~~~~~~~~~~~~~~~~~~~~~
Opis pod bloczkiem zawiera informację o stanie bloczka lub możliwym błędzie:
    * **Active until XX:XX:XX** - Godzina do której warunki ustawione w bloczku pozostaną spełnione.
    * **Inactive until XX:XX:XX** - Godzina do której warunki ustawione w bloczku pozostaną nie spełnione.
    * **Invalid start event configuration.** - Błąd - Ustawiona wartość zdarzenia początkowego nieprawidłowa.
    * **Invalid start event offset configuration.** - Błąd - Wartość "Offset (-) (+) od zdarzenia" zdarzenia początkowego nieprawidłowa.
    * **Invalid end event configurcleation.** - Błąd - Ustawiona wartość zdarzenia końcowego nieprawidłowa.
    * **Invalid end event offset configuration.** - Błąd - Wartość "Offset (-) (+) od zdarzenia" zdarzenia końcowego nieprawidłowa.
    * **Start time equals end time.** - Błąd - Czas zdarzenia początkowego i końcowego jest taki sam.
    * **idle** - System sprawny - Zegar nie pracuje.
    * **Astro timer error** - Błąd:
       *  Niepoprawne odczyty czasu z zegara RTC.
       *  Brak zdarzeń astronomicznych na przestrzeni 5 kolejnych dni (przedwczoraj, wczoraj, dzisiaj, jutro i pojutrze). Taka sytuacja może mieć miejsce, gdy lokalizacja wskazuje na okolice koła podbiegunowego, gdzie właśnie trwa noc lub dzień polarny.


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

    .. image:: _static/astro-timer_properties.png
      :width: 420
      :height: 600
      :alt: Astro-timer_properties

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

   **Zdarzenie początkowe** - Pora dnia rozpoczynająca zdarzenie.

   **Offset (-) (+) od zdarzenia** - Korekcja czasu rozpoczęcia zdarzenia uzależnionego od pory dnia.

   **Zdarzenie końcowe** - Pora dnia kończąca zdarzenie.

   **Dostępne zdarzenia do wybrania:**

    * **Wschód słońca** – Moment w którym górny punkt tarczy słonecznej przekracza linię horyzontu.

    * **Zachód słońca** - Moment zniknięcia słońca poniżej linii horyzontu.

    * **Zmierzch** - Okres po zachodzie Słońca, w którym Ziemia oświetlona jest światłem słonecznym rozproszonym w atmosferze (zmierzch cywilny).

    * **Świt** - Okres przed wschodem Słońca, kiedy środek tarczy Słońca znajduje się już wyżej niż 6° poniżej linii horyzontu (świt cywilny).


Przykładowe wykorzystanie
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Sterowanie oświetleniem w zależności od danych astronomicznych

    .. image:: _static/astro-timer_przyklad1.png
      :width: 600
      :height: 100
      :alt: Impulse-counter opis

Opis działania układu:

Oświetlenie "Oświetlenie kuchnia" będzie włączone od 1 godziny po zmierzchu do 30 minut przed zachodem słońca.

Astro-timer konfiguracja:

.. image:: _static/astro-timer_config.png
  :width: 500
  :height: 600
  :alt: Astro-timer konfiguracja

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