Bloczek FIAS_CONTROL
Bardzo ciekawa i użyteczna biblioteka. Jako pierwsza została zainstalowana i użyta z powodzeniem w systemie zarządzania automatyka budynkową w hotelu Puro we Wrocławiu na ulicy Włodkowica.
Bloczek komunikuje się z bramą FIAS (po sieci Ethernet) i zbiera informację na temat zajętych pokoi hotelowych. Wykorzystuje kilka bloczków z biblioteki OSCAT.
Na początku jedna ważna informacja wzięta „z życia”. Wtyczka FIAS udostępniana przez system hotelowy jest z reguły licencjonowana w ten sposób, że za każdy użyty kanał komunikacji płaci się oddzielnie dla producenta systemu hotelowego. Dlatego tej biblioteki najlepiej jest użyć na jednym kontrolerze WAGO, zebrać informację o wszystkich pokojach i potem przesłać ją po odpowiednich protokołach użytych w całym systemie do poszczególnych pokoi. W hotelu Puro we Wrocławiu komunikacja między kontrolerami WAGO I/O odbywała się po ethernecie i protokole Network Variables.
Posiada dwa tryby śledzenia, które mogą być wykorzystane jednocześnie:
- Śledzenie stanu pokoju o zdanym numerze – ustawiamy wskaźnik ROOM_OF_INTEREST na strukturę pokoju 'RoomData’ z ustawionym numerem pokoju, którego stan chcemy sledzić. Gdy zostanie odebrany check-in do pokoju dane gości zostaną uzupełnione w tablicy 'guests’ struktury 'RoomData’. Check-out spowoduje wyczyszczenie struktur gości.
- Śledzenie stanu wszystkich pokoi hotelowych – należy gdzieś w programie zadeklarować tablicę typu RoomData. Następnie ustawić wskaźnik ROOMS na tablicę(ADR(nazwa_tablicy)) oraz wprowadzić jej rozmiar w zmiennej MAX_ROOMS. Bloczek będzie uzupełniał poszczególne pokoje danymi na temat rezerwacji. Jeżeli ustawimy numery pokojów w tablicy bloczek odpowiednio je rozpozna. Jeżeli pozostawimy numery pokojów w tablicy puste to bloczek uzupełni je w miarę napływania danych z bramy FIAS.
Przed rozpoczęciem konfigurujemy zdalny adres IP(REMOTE_HOST) oraz port bramy FIAS(REMOTE_PORT). Uruchamiamy bloczek ustawiając ENABLE na TRUE. Bloczek powinien połączyć się z bramą i odebrać początkowy stan bazy danych co spowoduje ustawienie zmiennych wyjściowych CONNECTED oraz LINK_ACTIVE na TRUE. W celu zamknięcia połączenia ustawiamy ENABLE na FALSE.
| Nazwa: | FIAS_CONTROL | |
| Typ: | Blok funkcyjny | |
| Wejściowe parametry: | Typ: | Komentarz: |
| ENABLE | BOOL | Włącza/wyłącza bloczek co jest równoznaczne z otwarciem/zamknięciem połączenia z bramą FIAS. |
| REMOTE_HOST | STRING | Adres IP bramy FIAS. |
| REMOTE_PORT | INT | Port TCP/IP bramy FIAS. |
| ROOM_OF_INTEREST | POINTER TO RoomData | Wskaźnik na strukturę obserwowanego pokoju. Struktura musi mieć uzupełniony numer. Ustawiony na 0 wyłącza funkcję śledzenia pokoju. |
| ROOMS | POINTER TO RoomData | Wskaźnik na początek tablicy pokojów. Do tej tablicy bedą zapisywane dane na temat okupacji pokojów hotelowych. Ustawiony na 0 wyłącza śledzenie stanu wszystkich pokojów. |
| MAX_ROOMS | INT | Rozmiar tablicy pokojów ROOMS(-1, gdy nie wykorzystywana). |
| WDT_INTERVAL | TIME | Maksymalny czas bezczynności po którym połączenie zostanie zamknięte. W normalnych warunkach bramka FIAS wysyła sygnał podtrzymujący połączenie co kilkadziesiąt sekund. Jeżeli sygnał przestanie być odbierany i upłynie okres WDT_INTERVAL połączenie zostanie zamknięte, a bloczek będzie próbował otworzyć nowe połączenie. |
| Wyjściowe parametry: | Typ: | Komentarz: |
| CONNECTED | BOOL | TRUE jeżeli udało się ustanowić połączenie TCP z bramą FIAS. |
| LINK_ACTIVE | BOOL | TRUE jeżeli została odebrana początkowa baza danych i rozpoczęła się normalna komunikacja FIAS. |
| PMS_DATE | STRING | Data z systemu PMS w formacie YYMMDD |
| PMS_TIME | STRING | Czas z systemu PMS w formacie HHMMSS |
| PMS_DT | DT | Data i czas z systemu PMS w formacie WAGO DATE_AND_TIME |
STRUKTURY DANYCH
GuestData
Struktura przechowuje informacje na temat gościa pokoju hotelowego. Struktura danych pokoju zaweira tablicę gości, która odzwierciedla aktualny stan zapełnienia pokojów. Puste wartości oznaczają brak gościa. Wszelkie dane są tylko do odczytu. Więcej informacji na temat poszczególnych pól można znaleźć w opisie protokołu FIAS_2.11.chm.
| Nazwa: | GuestData | |
| Typ: | Struktura | |
| Zmienna: | Typ: | Komentarz: |
| RoomNumber | STRING(8) | Numer pokoju. |
| ReservNumber | INT | Numer reserwacji. |
| FirstName | STRING(20) | Imię gościa. |
| LastName | STRING(40) | Nazwisko. |
| Title | STRING(20) | Tytuł. |
| ArrivalDate | STRING | Data zameldowania YYMMDD. |
| DepartureDate | STRING | Data wymeldowania YYMMDD. |
| GroupNumber | STRING(10) | Numer grupy. |
| Language | STRING(2) | Język (kod dwuliterowy). |
| VipStatus | STRING(20) | Status VIP. |
| MiniBar | STRING(2) | 2 znakowy kod uprawnień mini baru. |
| NoPost | STRING(1) | Status „No post” |
| TVRights | STRING(2) | 2 znakowy kod uprawnień TV. |
| VideoRights | STRING(2) | 2 znakowy kod uprawnień wideo. |
RoomData
Struktura przechowuje informacje na temat pokoju hotelowego.
| Nazwa: | RoomData | |
| Typ: | Struktura | |
| Zmienna: | Typ: | Komentarz: |
| roomNumber | STRING | Numer pokoju. Jeżeli w tablicy pokojów nadamy numery odpowiednim pozycjom to bloczek będzie umieszczał dane na temat pokoju w pozycji z odpowiednim numerem. Jeżeli zostawimy numery puste to bloczek będzie nadawał numer w kolejności zgodnej z napływającymi danymi z bramki FIAS. |
| guests | ARRAY[0..1] OF GuestData | Tablica gości przebywających w pokoju. |