Biatel S.A. Plac Piłsudskiego 1 00-078 Warszawa INSTRUKCJA UŻYTKOWNIKA PROGRAMU Konfigurator CellBOX-UxR telemetryczny Białystok 2007-03-22 Wersja dokumentu 1.3 Opracował: Kozłowski Marcin
1 HISTORIA DOKUMENTU 4 2 WSTĘP 5 2.1 WYMAGANIA SYSTEMOWE 5 2.2 INSTALACJA I URUCHOMIENIE 5 2.3 TRYBY PRACY 5 2.4 FUNKCJE PROGRAMU 6 3 OBSŁUGA PROGRAMU 7 3.1 NAWIĄZYWANIE POŁĄCZENIA 8 3.2 POBIERANIE I WYSYŁANIE KONFIGURACJI 11 3.3 USTAWIANIE ZEGARA RTC 12 3.4 ZAPIS I ODCZYT KONFIGURACJI Z PLIKU 12 4 PARAMETRY URZĄDZENIA 13 4.1 USTAWIENIA PORTÓW SZEREGOWYCH 13 4.1.1 SZYBKOŚĆ TRANSMISJI 13 4.1.2 PARAMETRY TRANSMISJI 13 4.1.3 PORT NASŁUCHU 13 4.2 USTAWIENIA MODUŁU GPRS 14 4.2.1 USTAWIENIA DLA KART SIM 14 4.2.2 DIAGNOSTYKA GPRS 14 4.2.3 TRYB WYBORU KARTY SIM 15 4.2.4 WYBÓR WAŻNIEJSZEJ KARTY SIM 15 4.2.5 AKTUALNA KARTA SIM I AKTUALNY ADRES IP 15 4.3 KONFIGURACJA POŁĄCZEŃ DO HOSTÓW 16 4.3.1 NUMER TELEFONU 16 4.3.2 NUMER PORTU DOCELOWEGO 16 4.3.3 ADRES IP 16 4.4 CZAS OCZEKIWANIA NA POŁĄCZENIE 16 4.5 TRYB PRACY URZĄDZENIA 17 4.6 PARAMETRY PRACY W TRYBIE TRANSMISJI 17 4.6.1 ROZMIAR BUFORA TRANSMISYJNEGO 17 4.6.2 INTERWAŁ CZASOWY POMIĘDZY ZNAKAMI 17 4.6.3 CZAS BLOKOWANIA KANAŁU UDP 17 4.7 REJESTRY DOWOLNEGO PRZEZNACZENIA 18
1 Historia dokumentu Data Wersja Autor Opis 2005-06-07 1.0 Pajączkowski Marcin Utworzenie dokumentu 2005-06-09 1.0.1 Pajączkowski Marcin Opisanie parametrów trybu transmisyjnego 2005-06-30 1.0.2 Pajączkowski Marcin Poprawka w opisie 2005-07-12 1.0.3 Pajączkowski Marcin Naniesione zmiany dotyczące trybu automatycznego w autodiagnostyce, a przeniesienie portów źródłowych z hostów do ustawień RS. 2005-09-13 1.1 Pajączkowski Marcin Naniesione zmiany dotyczące nazw portów RS, dodane opisy mapy modbus oraz trybu pracy mapowania adresów modbus 2006-03-09 1.2 Pajączkowski Marcin Dodano punkt opisujący tryb pracy modułu diagnostycznego 2007-03-22 1.3 Kozłowski Marcin Przebudowanie rozdziału trzeciego, w związku z gruntowną zmianą oprogramowania interfejsu użytkownika
2 Wstęp 2.1 Wymagania systemowe komputer klasy PC system operacyjny Windows 98 lub nowszy Microsoft.Net Framework 2.0 5 MB wolnej przestrzeni na dysku twardym karta graficzna wyświetlająca minimum 256 kolorów przy rozdzielczości minimum 800x600 jeden port szeregowy do komunikacji z urządzeniem lub możliwość połączenia z wybranym urządzeniem za pomocą UDP/IP. 2.2 Instalacja i uruchomienie Program jest dostarczany w dwóch postaciach: archiwum zip oraz automatyczny instalator. W wypadku wersji dostarczonej z instalatorem wystarczy go uruchomić i wykonać wszystkie kroki instalacji podane nam przez program. Jeżeli posiadany program został dostarczony w archiwum zip należy rozpakować archiwum do dowolnego katalogu. 2.3 Tryby pracy Oprogramowanie umożliwia konfigurację urządzenia o sterowniku określonej wyżej wersji. Do wyboru mamy dwa sposoby komunikacji z urządzeniem: UDP/IP i przez port szeregowy. W pierwszym przypadku urządzenie jak i komputer na którym jest uruchomiony konfigurator powinny być połączone z APN em, do którego jest podłączone urządzenie. Natomiast konfiguracja przez port szeregowy wymaga połączenia komputera i sterownika kablem szeregowym przez port RS-232. Możemy też pracować z oprogramowaniem bez połączenia z urządzeniem. W tym trybie, dostępna jest możliwość zapisu i odczytu do i z pliku, natomiast niemożliwy jest zapis i odczyt do i z urządzenia. Dzięki temu możemy przygotować konfigurację do późniejszego użycia.
2.4 Funkcje programu Konfigurator służy do odczytywania i modyfikowania parametrów urządzenia CellBOX UxR. Umożliwia także zapisanie konfiguracji na dysku lokalnym i późniejsze jej odczytanie. Dzięki temu możliwe jest posiadanie wielu różnych ustawień parametrów lub skonfigurowanie urządzenia w dowolnym czasie i miejscu. Konfigurator zapewnia komunikację przez dwa różne media: złącze szeregowe RS-232 i połączenie UDP/IP.
3 Obsługa programu Po uruchomieniu programu pojawi się następujące okno:
3.1 Nawiązywanie połączenia Aby nawiązać połączenie z urządzeniem należy przycisnąć przycisk nawiązania połączenia na pasku narzędzi. Po jego naciśnięciu pojawi się okno wyboru medium i jego konfiguracji: Gdy jako medium transmisyjne wybierzemy połączenie UDP zamiast wyboru numeru portu COM i jego parametrów pojawi się wybór parametrów transmisji UDP (adres IP oraz numer portu konfiguracyjnego):
Do konfiguracji parametrów połączenia za pomocą RS232, na wybranym porcie COM, służy okno, które pojawi się po wciśnięciu przycisku Właściwości : Po wybraniu medium transmisyjnego i konfiguracji parametrów pojawi się okno połączenia z urządzeniem: Okno te będzie się pojawiać także w innych wypadkach, gdy operacja wykonywana przez konfigurator będzie długotrwała.
Jeżeli konfigurator nawiąże połączenie z urządzeniem poinformuje o tym użytkownika, w przeciwnym wypadku użytkownik dostanie informację o nieudanej próbie. Jeżeli uda się nawiązać połączenie w pasku stanu programu (na samym dole głównego okna) pojawi się opis połączenia: Przy nawiązanym połączeniu konfigurator co 3 sekundy sprawdza aktualny stan urządzenia. Stan ten wyświetlany jest na dole głównego okna programu: W przypadku, gdy pojawią się błędy transmisji, są one sygnalizowane stosownym komunikatem. Komunikat ten znika, gdy kolejny odczyt stanu urządzenia przebiegnie bez błędów. Urządzenie podaje poziom sygnału dla obydwu kart SIM chociaż w danym momencie może używać tylko jednej z nich. Poziom podawany dla karty właśnie używanej jest poziomem aktualnym, a wskaźnik jest całkowicie wypełniony. Poziom sygnału dla karty aktualnie nieużywanej jest ostatnim poziomem zmierzonym na tej karcie i pokazany jest przerywanym paskiem. Tryb zasilania urządzenia może przyjąć następujące wartości: Bateria, Zasilacz, Niski poziom baterii, Ładowanie akumulatora.
3.2 Pobieranie i wysyłanie konfiguracji Konfiguracja urządzenia pobierana jest automatycznie po nawiązaniu połączenia z urządzeniem. Jeżeli chcemy pobrać konfigurację samodzielnie wystarczy nacisnąć przycisk pobrania konfiguracji i poczekać dłuższą chwilę. Pojawi się okno z podaniem zakresu adresów ModBUS dla których chcemy odczytać mapę: Każdy parametr, który uda się odczytać zostanie podświetlony na niebiesko na drzewie z parametrami. Aby wysłać konfigurację do urządzenia należy wcisnąć przycisk wysyłania konfiguracji. Możemy wysłać pełną konfigurację lub tylko parametry, które uległy zmianie w wyniku edycji przez użytkownika (zostają one podświetlone na czerwono na drzewie parametrów). W przypadku, gdy korzystamy z połączenia za pomocą portu szeregowego RS232, zmieniając ustawienia portów szeregowych CellBOXa pojawi się okno informujące nas, że zmianę tą możemy automatycznie wprowadzić dla portu konfiguracyjnego komputera. Należy wówczas zaznaczyć odpowiedniego checkboxa oraz podać numer portu CellBOXa, do którego podłączony jest komputer.
3.3 Ustawianie zegara RTC Aby ustawić zegar w urządzeniu należy pamiętać o tym, że urządzenie musi posiadać przynajmniej jedną kartę SIM i musi być załogowanie do GPRS. Możemy ustawić w urządzeniu czas aktualny naszego komputera, lub czas UTC naszego komputera. W wypadku połączenia UDP konfigurator za każdą próbą ustawienia czasu będzie zwracał błąd, jednak czas powinien zostać ustawiony, aby to sprawdzić najlepiej odczekać chwilę i zobaczyć czy zwracany jako stan urządzenia czas jest tym, którego oczekujemy. 3.4 Zapis i odczyt konfiguracji z pliku Aby zapisać konfigurację do pliku należy z menu plik wybrać odpowiednią opcję, a następnie podać ścieżkę i nazwę pliku, w którym ma być zapisana konfiguracja. Jeżeli chcemy odczytać konfigurację z wcześniej zapisanego pliku, należy wybrać odpowiednią opcję z menu plik i wybrać plik, który chcemy otworzyć. Program wczyta konfigurację i zaznaczy na zielono każdy parametr, który uda mu się wczytać.
4 Parametry urządzenia 4.1 Ustawienia portów szeregowych Ustawienia dotyczące portów szeregowych zainstalowanych w urządzeniu. 4.1.1 Szybkość transmisji Szybkość transmisji na wybranym porcie RS. 4.1.2 Parametry transmisji Parametry transmisji na danym porcie RS. 4.1.3 Port nasłuchu Numer portu, na którym urządzenie będzie nasłuchiwać i z którego będzie wysyłać odpowiedzi. Port ten jest skojarzony z danym portem szeregowym. 4.1.3.1 Kontrola przepływu Rodzaj kontroli przepływu do wyboru mamy kontrolę sprzętową i brak kontroli. 4.1.3.2 Bity danych Ilość bitów danych: 5 bitów 6 bitów 7 bitów 8 bitów 4.1.3.3 Kontrola parzystości Kontrola parzystości w czasie transmisji do wyboru mamy: parzyste nieparzyste przerwa
znacznik brak kontroli 4.1.3.4 Bity stopu Ilość bitów stopu: 1 bit 1,5 bitu 2 bity 4.2 Ustawienia modułu GPRS 4.2.1 Ustawienia dla kart SIM Możliwe jest ustawienie parametrów oddzielnie dla dwóch kart SIM. 4.2.1.1 Kod PIN Kod PIN danej karty, należy go wprowadzić przed włożeniem karty do urządzenia. 4.2.1.2 Adres APN Adres APN, do którego będzie się logować wybrana karta. 4.2.2 Diagnostyka GPRS Funkcja diagnostyki GPRS pozwala na wykrycie utraty komunikacji GPRS i zestawienie nowego połączenia.
4.2.2.1 Tryb pracy modułu diagnostyki Tryb pracy diagnostyki GPRS, możliwe są dwa tryby: Ramki diagnostyczne wysyłane zawsze także, gdy w tym samym czasie trwa transmisja danych, Ramki diagnostyczne wysyłane tylko gdy nie ma transmisji danych. 4.2.2.2 Adres IP, na który będą wysyłane ramki statusowe Adres IP, który będzie używany w diagnostyce GPRS, jeżeli nie wiemy jaki adres podać wystarczy zaznaczyć ptaszek obok pola z numerem IP, co włączy tryb automatyczny autodiagnostyki. 4.2.2.3 Czas bez ramki, po którym zostanie zestawione nowe połączenie Parametr ten określa maksymalny czas bez otrzymania ramki diagnostycznej przez urządzenie. Jeżeli ten czas zostanie przekroczony to urządzenie nawiąże nową sesję GPRS. 4.2.2.4 Interwał pomiędzy ramkami statusowymi Parametr ten określa czasokres pomiędzy wysyłaniem kolejnych ramek diagnostycznych. 4.2.3 Tryb wyboru karty SIM Urządzenie może pracować w trzech trybach wyboru karty SIM: tryb automatyczny, zawsze wybrana karta SIM 0, zawsze wybrana karta SIM 1. 4.2.4 Wybór ważniejszej karty SIM Możemy wybrać kartę SIM o wyższym priorytecie, urządzenie po restarcie zacznie się logować na początku na karcie o wyższym priorytecie. 4.2.5 Aktualna karta SIM i aktualny adres IP Obydwa parametry są tylko do odczytu, pierwszy wskazuje, na której karcie SIM pracuje obecnie urządzenie, drugi podaje adres IP urządzenia. Jeżeli stan połączenia na aktualnej
karcie jest inny, niż GPRS OK. to parametr ten będzie przyjmował wartość 0.0.0.0 lub wartość błędną. 4.3 Konfiguracja połączeń do hostów Urządzenie może przechowywać cztery numery traktowane jako numery telefonów. W rzeczywistości należy traktować je jako identyfikatory czterech hostów/serwerów, których namiary może przechowywać sterownik. 4.3.1 Numer telefonu Wirtualny numer telefonu, dla którego ustawimy hosta. 4.3.2 Numer portu docelowego Numer portu, na który będą wysyłane dane. 4.3.3 Adres IP Adres IP hosta, na który będą wysyłane dane. Jeżeli adres IP zostanie ustawiony na 0.0.0.0 urządzenie nie będzie mogło przesyłać danych z RS a bez zapytania po UDP. 4.4 Czas oczekiwania na połączenie Po wydaniu dla sterownika polecenia ATDT sterownik odpowie CONNECT (o ile wszystko jest jak należy). Niektóre systemy wymagają, by odpowiedź nie była natychmiastowa. Parametr oznacza zwłokę (w sekundach) do wysłania odpowiedzi.
4.5 Tryb pracy urządzenia Tryb pracy urządzenia po restarcie. Urządzenie może startować w trzech trybach: transmisji interpretera poleceń tryb mapowania protokołu ModBUS Jeżeli wybrany zostanie tryb transmisji to port RS A po restarcie będzie działał w trybie transmisji i będzie używał ustawień hosta dla RS a A. Jeżeli wybierzemy tryb interpretera poleceń to możemy w czasie pracy przejść w tryb transmisji na dwa sposoby: możemy wydać komendę atdt<numer telefonu> za pomocą Hyperterminala, możemy wydać komendę atdt<numer ip:port docelowy> za pomocą Hyperterminala. 4.6 Parametry pracy w trybie transmisji Sterownik w trybie transmisji danych, każdy znak odebrany z portu szeregowego wrzuca do bufora tymczasowego. W tym momencie zaczyna odmierzać czas. Każdy kolejny znak odebrany na porcie szeregowym resetuje licznik. Jeżeli upłynie określony parametrem czas lub bufor całkowicie napełni się, wówczas dane z bufora wysyłane są w jednej paczce UDP. 4.6.1 Rozmiar bufora transmisyjnego Maksymalny rozmiar (w bajtach) danych przesyłanych przez urządzenie w jednej ramce. 4.6.2 Interwał czasowy pomiędzy znakami Czas pomiędzy kolejnymi znakami przesyłanymi przez port RS, wartość podana w milisekundach. 4.6.3 Czas blokowania kanału UDP
Sterownik, po otrzymaniu pakietu UDP od określonego nadawcy, zapamiętuje jego adres IP oraz port. Następnie, przez pewien, ustalony czas, przepuszcza tylko i wyłącznie dane od tego nadawcy. Każdy kolejny pakiet od niego resetuje licznik czasu. W tym czasie, wszystkie dane odbierane z portu szeregowego trafiają do tego nadawcy. Czas, przez jaki następuje zablokowanie nadawcy odmierzany jest w sekundach. 4.7 Rejestry dowolnego przeznaczenia Urządzenie posiada dwa 32bitowe rejestry dowolnego przeznaczenia. 4.8 Mapowanie ModBUS Mapa zawiera 256 przemapowań adresów ModBUS na adres IP i port.