input

Opis

Bloczek input służy do odczytywania wartości zwracanej przez wskazaną właściwość wybranego urządzenia i udostępniania jej dalej w logice projektu. Jest przeznaczony przede wszystkim do właściwości odczytowych, takich jak temperatura, stan wejścia, poziom natężenia światła, inny pomiar albo inna wartość raportowana przez urządzenie.

Bloczek nie ma żadnych wejść flow.

Bloczek udostępnia dwa wyjścia:

• aktualną wartość zwróconą z urządzenia
• informację, czy urządzenie jest aktualnie podłączone

Parametry konfiguracyjne

Nazwa parametru	Wartość
Identyfikator urządzenia (device_id)	Parametr obowiązkowy. Określa urządzenie, z którego ma być odczytywana wartość.
Nazwa właściwości urządzenia (device_property_name)	Parametr obowiązkowy. Określa właściwość urządzenia, z której ma być odczytywana wartość zwracana przez urządzenie, na przykład stan wejścia, temperatura, poziom natężenia światła albo inny pomiar.

Obsługa wejścia

Bloczek input nie ma wejść. Nie przyjmuje więc żadnych zdarzeń z innych bloczków.

Źródłem danych dla bloczka jest wyłącznie wybrane urządzenie i wskazana właściwość tego urządzenia. Za każdym razem, gdy urządzenie zgłosi zmianę tej właściwości, bloczek aktualizuje swoje wyjścia oraz opis widoczny pod bloczkiem.

Szczegółowe zasady działania:

• jeśli urządzenie jest podłączone, na pierwszym wyjściu pojawia się aktualna wartość zwrócona przez wskazaną właściwość urządzenia
• jeśli urządzenie jest podłączone, na drugim wyjściu pojawia się wartość logiczna true
• jeśli urządzenie jest odłączone, na drugim wyjściu pojawia się wartość logiczna false
• jeśli urządzenie udostępnia własny opis tekstowy aktualnej wartości, to taki opis jest pokazywany pod bloczkiem
• jeśli urządzenie nie udostępnia własnego opisu, bloczek próbuje pokazać standardową tekstową reprezentację aktualnej wartości
• jeśli urządzenie jest podłączone, ale bieżącej wartości nie da się przedstawić tekstowo, pod bloczkiem pojawia się opis unknown
• jeśli urządzenie jest odłączone, pod bloczkiem pojawia się opis detached

Bloczek nie filtruje ani nie przelicza wartości pochodzących z urządzenia. Na wyjściu 1 udostępnia tę samą wartość logic_value, którą zwróciła wskazana właściwość urządzenia.

Wyjścia bloczka

Bloczek posiada dwa wyjścia:

Numer i nazwa wyjścia	Opis wyjścia
1: Wartość zwrócona z urządzenia	Na tym wyjściu pojawia się aktualna wartość zwrócona przez wskazaną właściwość urządzenia. Dotyczy to przede wszystkim wartości odczytowych, takich jak stan wejścia, temperatura albo poziom zmierzonej jasności.
2: Status podłączenia	Na tym wyjściu pojawia się wartość logiczna true, gdy urządzenie jest podłączone, oraz false, gdy urządzenie jest odłączone.

Opis widoczny pod bloczkiem odzwierciedla bieżący stan:

• detached, gdy urządzenie jest odłączone
• tekstową reprezentację aktualnej wartości urządzenia, gdy jest ona dostępna
• unknown, gdy urządzenie jest podłączone, ale bieżącej wartości nie da się przedstawić tekstowo

Jeżeli kilka bloczków input odnosi się do tego samego urządzenia, opis może mieć prefiks liczbowy, na przykład 3(2): detached albo 2: true. Taki prefiks informuje, ile bloczków input jest powiązanych z tym samym urządzeniem oraz ile z nich dotyczy dokładnie tej samej właściwości.

Błędy zwracane przez bloczek

Bloczek może zwracać następujące błędy:

Kod błędu	Opis błędu
Missing device_id configuration.	Nie podano identyfikatora urządzenia albo parametr ma niepoprawną wartość.
Missing device_property_name configuration.	Nie podano nazwy właściwości urządzenia albo parametr ma niepoprawną wartość.
Init failed.	Bloczek nie zainicjalizował się poprawnie i nie może pracować.

Stan detached oznacza brak aktualnego połączenia z urządzeniem, a nie błąd konfiguracji bloczka.

Przykłady działania

• Jeśli bloczek input jest skonfigurowany do odczytu stanu wejścia binarnego i urządzenie zgłosi wartość true, to na wyjściu 1 pojawi się true, a na wyjściu 2 wartość true.
• Jeśli czujnik temperatury zwróci nowy pomiar, na przykład 23.5, to bloczek przekaże tę wartość bez zmian na wyjście 1.
• Gdy urządzenie zostanie odłączone, na wyjściu 2 pojawi się false, a opis pod bloczkiem zmieni się na detached.
• Jeśli urządzenie jest podłączone, ale jego bieżąca wartość nie ma dostępnego opisu tekstowego, pod bloczkiem pojawi się unknown.