Biatel S.A. Plac Piłsudskiego 1 00-078 Warszawa INSTRUKCJA UŻYTKOWNIKA PROGRAMU Konfigurator EasySMS wersja 0.9.8 Białystok 2008-08-25 Wersja dokumentu 1.13 Opracował: Joao Silva
Spis treści 1 Historia dokumentu... 3 2 Wstęp... 4 2.1 Funkcje programu... 4 2.2 Wymagania systemowe... 5 3 Obsługa programu... 6 3.1 Instalacja... 6 3.2 Uruchomienie... 6 3.2.1 Główne menu programu... 6 3.2.2 Pasek stanu... 7 3.3 Konfiguracja programu... 8 3.3.1 Zakładka Karta SIM... 8 3.3.2 Zakładka Treści SMS... 9 3.3.3 Zakładka Markery... 11 3.3.4 Zakładka Modem... 13 3.4 Przykładowa konfiguracja... 14 3.4.1 Zmiana parametrów urządzenia... 14 BIATEL S.A. 2
1 Historia dokumentu Data Wersja Autor Opis 2005-04-27 0.5 Andrzej Szczepura Utworzenie dokumentu 2005-05-06 0.9 Andrzej Szczepura Aktualizacja dokumentu 2005-05-23 0.9.1 Pajączkowski Marcin Aktualizacja dokumentu 2005-07-29 1.0 Piotr Grygorczuk Zmiana budowy komunikatów SMS (rozdział Zakładka Treści SMS ) 2005-09-07 1.1 Pajączkowski Marcin Dodanie informacji o zarządzaniu centrami SMS, poprawienie zrzutów 2005-09-22 1.11 Pajączkowski Marcin ekranu, usunięcie informacji o RTC Zmiana nazwy produktu na EasySMS, zmiana nazwy IDEA na ORANGE, usunięcie ostatniej wzmianki o zegarze RTC, dodanie informacji o instalacji programu 2008-08-20 1.12 Paweł Trzciński Usunięcie cudzysłowiów z przykładów treści SMS ów 2008-08-25 1.13 Joao Silva Aktualizacja dla wersji 0.9.8 BIATEL S.A. 3
2 Wstęp Program Konfigurator EasySMS służy do konfiguracji pracy urządzeń przeznaczonych do współpracy ze sterownikami Easy lub MFD. Zadaniem urządzenia EasySMS jest umożliwienie zdalnej obsługi sterownika Easy za pomocą wiadomości SMS. Urządzenie EasySMS umożliwia: Sprawdzenie wartości markerów za pomocą wiadomości SMS Ustawienie stanu markerów za pomocą wiadomości SMS Powiadamianie użytkownika o zmianach w urządzeniu o Możliwość ustalenia dynamicznej treści wiadomości o Możliwość wybrania kiedy i na jaki numer telefonu (max 4) ma być wysyłana wiadomość o Możliwość ustalenia do 16 wiadomości UWAGA przed włożeniem karty SIM do urządzenia należy zaprogramować numer PIN karty, w przeciwnym przypadku nastąpi zablokowanie karty w wyniku wprowadzenia niepoprawnego kodu!. 2.1 Funkcje programu Program służy do konfiguracji urządzenia EasySMS do współpracy ze sterownikami Moeller a. Możliwości konfiguracji: o karta SIM o numer PIN o numer centrum SMS o 8 numerów telefonów o wybór sterownika Moeller o ustalenie co jaki czas ma być odpytywany sterownik o ustalenie parametrów połączenia ze sterownikiem o czas odpytywania sterownika M o konfiguracja każdego z 16 pierwszych markerów bitowych o wybór zbocza markera, które nas interesuje o ustalenie treści wiadomości o wybór do czterech numerów telefonów, na które ma być wysyłana wiadomość o konfiguracja pozostałych markerów ze stałą wiadomością Zmiana wartości markerów za pomocą wiadomości SMS oraz ich odczyt zabezpieczona jest hasłem podawanym po udanej konfiguracji urządzenia. BIATEL S.A. 4
2.2 Wymagania systemowe komputer klasy PC z procesom Pentium II 500 lub nowszym system operacyjny Windows 95 lub nowszy 40 MB wolnej przestrzeni na dysku twardym karta graficzna wyświetlająca minimum 256 kolorów jeden port szeregowy do komunikacji z urządzeniem EasySMS BIATEL S.A. 5
3 Obsługa programu 3.1 Instalacja Aby zainstalować oprogramowanie należy uruchomić instalator i następnie postępować zgodnie z instrukcjami podawanymi na ekranie. 3.2 Uruchomienie Aby uruchomić program należy wybrać program z menu Start->Konfigurator EasySMS. Po uruchomieniu program wyświetla zakładkę z ustawieniami karty SIM. 3.2.1 Główne menu programu Pobierz polecenie pobrania konfiguracji z urządzenia poprzez port szeregowy. Po kliknięciu na przycisk Pobierz otwiera się okno wyboru portu szeregowego oraz prędkość komunikacji. Prędkość musi być taka sama jak skonfigurowana w urządzeniu, jeżeli urządzenie było skonfigurowane do pracy ze sterownikiem easy500/700 to prędkość powinna być ustawiona na 4800, w przeciwnym przypadku prędkość należy ustawić na 9600. Parametry połączenia uzależnione są od parametrów portu szeregowego ustawionych w urządzeniu. Parametry zazwyczaj są takie same jak w przykładzie, różnią się tylko prędkością transmisji. Następnie pojawia się okienko przedstawiające przebieg komunikacji z urządzeniem. W przypadku problemów z komunikacją, konfigurator restartuje urządzenie ( restart urządzenia trwa 5 sekund ) i spróbuje ponownie odczytać konfigurację. BIATEL S.A. 6
Wyślij polecenie wysłania konfiguracji do urządzenia. Po kliknięciu na przycisk Wyślij otwiera się okno wyboru portu szeregowego oraz prędkość komunikacji. Prędkość musi być taka sama jak skonfigurowana w urządzeniu, jeżeli urządzenie było skonfigurowane do pracy ze sterownikiem easy500/700 to prędkość powinna być ustawiona na 4800, w przeciwnym przypadku prędkość należy ustawić na 9600. Jeżeli urządzenie skonfigurowane zostało do pracy z sterownikiem easy500/700, w trakcie wysyłania konfiguracji zmieniana jest prędkość portu szeregowego, jeżeli następnie chcemy odczytać konfigurację ponownie, należy zmienić uwzględnić tą zmianę. Następnie pojawia się okienko przedstawiające przebieg komunikacji z urządzeniem. Po udanym zapisie pojawi się okienko informujące o haśle wpisanym do urządzenia, dodatkowo hasło, data oraz identyfikator urządzenia są zapisywane do pliku passwords.txt w katalogu z programem. Wczytaj - polecenie wczytania konfiguracji z pliku. Po kliknięciu na przycisk Wczytaj otwiera się okno wyboru pliku do wczytania, po wybraniu pliku dane zostaną wczytane do programu, które następnie można zmienić i wysłać do urządzenia. Zapisz - polecenie zapisania konfiguracji do pliku. Po kliknięciu na przycisk Zapisz otwiera się okno wyboru pliku do zapisu, po podaniu nazwy pliku informacje wprowadzone w programie, bądź odczytane z urządzenia zostaną zapisane do pliku. Jeżeli zastępujemy istniejący plik, pojawi się okienku proszące o potwierdzenie zapisu. Pomoc wyświetla pomoc programu. 3.2.2 Pasek stanu Na pasku stanu znajdują się kolejno: rodzaj zasilania urządzenia (bateria lub zasilacz) oraz jego stan (niski poziom baterii), jeżeli urządzenie nie posiada baterii wtedy rodzaj zasilania będzie zawsze wskazywał na zasilacz; poziom sygnału anteny GSM (sygnał ma wartość z przedziału 0 31). Jeżeli informacje te nie są dostępne oznacza to, że nie nawiązano jeszcze połączenia z urządzeniem. Na poniższym rysunku widzimy urządzenie zasilane z zasilacza, oraz poziom sygnału 14. BIATEL S.A. 7
3.3 Konfiguracja programu 3.3.1 Zakładka Karta SIM Na tej zakładce ustawia się numer pin karty, centra SMS oraz numery telefonów, na które mają być wysyłane wiadomości SMS. Numer PIN cztero-cyfrowy numer pin karty znajdującej się w urządzeniu UWAGA: podanie złego numeru pin karty, i zapisanie go w urządzeniu spowoduje zablokowanie karty Numer centrum SMS numer centrum SMS, na które będą wysyłane wiadomości SMS do wyboru są numery operatorów ORANGE, ERA i PLUS. Dodatkowo można zarządzać tymi numerami, po wciśnięciu Zarządzanie pojawi się okno: BIATEL S.A. 8
W oknie tym możemy dodawać nowe numery centrów SMS, a także po wciśnięciu prawego przycisku na danym numerze możemy go usunąć. Numer uprzywilejowany numer telefonu, na który będą wysyłane wiadomości SMS w przypadku wykrycia zmian markerów począwszy od trzeciego markera bajtowego. Pozostałe numery lista siedmiu numerów telefonów i ich opisów, na które mogą być wysyłane wiadomości ustawiane w zakładce Treści SMS. 3.3.2 Zakładka Treści SMS Na tej zakładce ustawia się treść wiadomości SMS dla każdego z pierwszych 16-tu markerów bitowych, oraz wybiera się numery telefonów, na które mają być wysyłane wiadomości. BIATEL S.A. 9
Marker bitowy numer markera bitowego z zakresu M1 do M16, wybór określa, dla którego markera ustawiamy wiadomość Treść wiadomości SMS treść wiadomości SMS dla wybranego markera bitowego, wiadomość może zawierać maksymalnie 64 znaki. Tekst wiadomości SMS jest maskowany. Wpisanie w treści odpowiednich ciągów znaków, opisujących markery typu BYTE, WORD i DOUBLE WORD (odpowiednio MB, MW i MD) spowoduje, że w wiadomości SMS zostaną one zastąpione wartościami podanych markerów. Na przykład Niech pole ma wartość: To jest wiadomość testowa, ^MB12, ^MW7 Jeżeli marker bajtowy (MB) o numerze 12 ma wartość 2, a marker typu word (MW) o numerze 7 ma wartość 345 to otrzymana wiadomość SMS będzie miała postać: To jest wiadomość testowa, 2, 345 Czyli treść ^MB12 zostanie zamieniona na treść 2, odpowiadającą wartości markera bajtowego, a treść ^MW7 zostanie zamieniona na treść 345, odpowiadającą wartości markera typu word. Maski mogą być ze sobą sklejane, np: ^MB12^MW7. Każdy znak ^ pojawiający się w treści wiadomości zostanie usunięty, np: a^2^^b zostanie zamienione na wiadomość o treści a2b. Treść wiadomości SMS treść wiadomości SMS dla wybranego markera bitowego, wiadomość może zawierać maksymalnie 64 znaki. Tekst wiadomości SMS jest maskowany. Wpisanie w treści odpowiednich ciągów znaków, opisujących markery typu MB, MW i MD (odpowiednio BYTE, WORD i DOUBLE WORD ) spowoduje, że w wiadomości SMS zostaną one zastąpione wartościami podanych markerów. Na przykład Niech pole ma wartość: To jest wiadomość testowa, MB12, MW7 Jeżeli marker bajtowy (MB) o numerze 12 ma wartość 2, a marker typu word (MW) o numerze 7 ma wartość 345 to otrzymana wiadomość SMS będzie miała postać: To jest wiadomość testowa, 2, 345 Czyli treść MB12 zostanie zamieniona na treść 2, odpowiadającą wartości markera bajtowego, a treść MW7 zostanie zamieniona na treść 345, odpowiadającą wartości markera typu word. Reakcja na zbocze opadające jeżeli pole jest zaznaczone, oznacza to że wiadomość zostanie wysłana gdy wartość wybranego markera zmieni wartość z 1 na 0 BIATEL S.A. 10
Reakcja na zbocze narastające jeżeli pole jest zaznaczone, oznacza to że wiadomość zostanie wysłana gdy wartość wybranego markera zmieni wartość z 0 na 1 Zaznaczenie obydwu pól oznacza że wiadomość będzie wysyłana przy każdej zmianie wartości markera Numery telefonów wiadomość SMS będzie wysyłana na wybrane numery telefonów. Maksymalnie można wybrać cztery numery. Pierwszy numer wyświetlany kolorem niebieskim jest numerem uprzywilejowanym, na który dodatkowo wysyłane są wiadomości o zmianach na pozostałych markerach wybieranych na zakładce Markery. Brak numeru telefonu oznacza ze numer ten nie został ustawiony. 3.3.3 Zakładka Markery Na tej zakładce konfiguruje się reakcje pozostałych markerów począwszy od trzeciego markera bajtowego (MB3), ilość dostępnych markerów zależna jest od typu sterownika Easy wybranego na zakładce Modem. Zmiana wartości tych markerów spowoduje wysłanie wiadomości na uprzywilejowany numer telefonu, jeżeli został on podany. Wiadomość ta jest taka sama dla wszystkich markerów i jest zdefiniowana na stałe jako: Input: <I>; State: <S> gdzie <I> to numer markera bitowego <S> to stan markera bitowego (0 lub 1) BIATEL S.A. 11
Numer markera bajtowego wybór markera bajtowego, który chcemy skonfigurować. Tabeli wyświetlana jest konfiguracja aktualnie wybranego markera bajtowego. Tabela zawiera dwa wiersze zawierające pola, pierwszy dla zbocza opadającego, a drugi dla narastającego. Kolejne pola w tabeli reprezentują kolejne bity wybranego markera bajtowego. Zaznaczenie odpowiednich pól spowoduje włączenie reakcji na zmianę danego bitu. BIATEL S.A. 12
3.3.4 Zakładka Modem Na tej zakładce konfiguruje się ustawienia urządzenia EasySMS. Wersja aplikacji wersja aplikacji znajdującej się w urządzeniu, wartość ta jest przedstawiana tylko w celach informacyjnych, nie można jej zmienić. Identyfikator urządzenia wewnętrzny identyfikator urządzenia, wartości tej nie można zmienić, jest ona unikalnym identyfikatorem urządzenia EasySMS. Typ sterownika wybór typu sterownika Easy, z którym będzie współpracowało urządzenie EasySMS. Wraz z wyborem sterownika, konfigurowany jest port wewnętrzny urządzenia EasySMS. Dla sterownika Easy500/700 prędkość portu ustawiana jest na 4800, w pozostałych przypadkach na 9600. Interwał odpytywania określa co ile czasu sterownik Easy ma być odpytywany, wartość podawana w sekundach z zakresu 1 do 3600 sekund (1 godzina). BIATEL S.A. 13
3.4 Przykładowa konfiguracja 3.4.1 Zmiana parametrów urządzenia Przykład: Sterownik Easy800 mierzy temperaturę w pomieszczeniu. Aktualna temperatura zapisywana jest w markerze bajtowym numer 12 (MB12), w przypadku, gdy temperatura przekroczy 40 stopni ustawiany jest marker bitowy numer 2 (M2), gdy temperatura spadnie poniżej 40 stopni marker jest gaszony, a zmieniana jest wartość markera bitowego numer 1. Dodatkowo urządzenie, co 30 minut zmienia wartość markera bitowego numer 1 na przeciwną, gdy marker bitowy numer 2 nie jest ustawiony. Chcemy skonfigurować urządzenie tak, aby informowało nas o bieżącej temperaturze w urządzeniu, oraz informowało nas o przekroczeniu wartości 40 stopni. W tym celu skonfigurujemy urządzenie, aby wysyłało wiadomość o aktualnej temperaturze, co 30 minut( czyli reakcja na marker bitowy numer 1), dodatkowo urządzenie będzie wysyłało wiadomość o stanie alarmowym przy zmianie markera bitowego numer 2 z 0 na 1 (zbocze narastające). Zmianę parametrów urządzania, rozpoczynamy od pobrania aktualnej konfiguracji. W tym celu wciskamy przycisk Pobierz i wybieramy parametry połączenia. Jeżeli nie wiemy, jaką prędkość ma port w urządzeniu najpierw wybieramy prędkość 4800 i w przypadku problemów z komunikacją, próbujemy pobrać konfigurację z prędkością 9600. Po udanym pobraniu konfiguracji zmieniamy żądane parametry. 3.4.1.1 Ustawiania telefonów i karty SIM. Wybieramy zakładkę Karta SIM Wpisujemy numer PIN karty Wybieramy numer centrum SMS owego, przez które mają być wysyłane SMS y, lub wpisujemy swoje własne Wpisujemy numery telefonów, na które będą wysyłane SMS y i ewentualnie ich opisy. 3.4.1.2 Reakcja na zmianę markera i treść SMS Wybieramy zakładkę Treści SMS Z rozwijanej listy wybieramy marker, który chcemy skonfigurować marker bitowy numer 1 (M1) W polu treść SMS wpisujemy wiadomość, jaką chcemy otrzymać przy reakcji na wybrany marker (M1) w treści mogą znajdować się specjalne maski, które spowodują umieszczenie w treści wiadomości wartości danego markera np.: Wiadomość Temperatura MB12 Spowoduje, że w treści wiadomości zamiast MB12 zostanie umieszczona wartość markera bajtowego numer 12. Przykładowa wiadomość może wyglądać tak: Temperatura 34 Dokładny opis wiadomości SMS znajduje się w rozdziale 3.2.2. BIATEL S.A. 14
Następnie wybieramy, kiedy wiadomość ma być wysłana. Jeżeli chcemy by wiadomość została wysłana, gdy marker zmieni wartość z 0 na 1 zaznaczmy pole Reakcja na zbocze narastające, w przeciwnym przypadku zaznaczamy pole Reakcja na zbocze opadające. Jeżeli chcemy by wiadomość została wysłana przy każdej zmianie wartości markera zaznaczamy obydwa pola. W naszym przypadku ustawiamy reakcję na obydwa zbocza czyli zaznaczamy obydwa pola. Wybieramy numery telefonów, na które ma być wysyłana wiadomość, na liście telefonów znajdujemy żądany telefon i zaznaczamy pole obok niego. Jeżeli numeru nie ma na liście należy wrócić na zakładkę Karta SIM i go dopisać. Następnie wybieramy marker bitowy numer 2 (M2) Jako treść wiadomości wpisujemy Alarm! Temperatura MB12. Jako reakcję wybieramy zbocze narastające. Zaznaczamy żądane numery telefonów. Upewniamy się, że pozostałe markery nie mają ustawionej reakcji. 3.4.1.3 Konfiguracja Modemu Wybieramy zakładkę Modem. Wybieramy typ sterownika w naszym przykładzie Easy800 Ustawiamy interwał odpytywania - w naszym przypadku 60 sekund Następnie przechodzimy do zakładki Markery i sprawdzamy czy nie jest zaznaczona reakcja na żaden z pozostałych markerów nie jest to konieczne jednak nie chcemy dostawać wiadomości, które nas nie interesują, alternatywnie można nie ustawiać numery telefonu uprzywilejowanego, dzięki temu reakcje na pozostałe markery nie będą wysyłane. 3.4.1.4 Zapis konfiguracji Wybieramy polecenie Wyślij Wybieramy port, do którego podłączone jest urządzenie oraz prędkość taką samą, z jaką odczytaliśmy urządzenie. Jeżeli wystąpią problemy z konfiguracją, zapisujemy bieżącą konfigurację do pliku wybierając polecenie Zapisz. Następnie wyłączmy konfigurator i uruchamiamy ponownie. Wczytujemy dane z pliku poleceniem Wczytaj i próbujemy ponownie wysłać konfigurację. Jeżeli mimo wszystko nie uda się zapisać konfiguracji próbujemy restartować urządzenie wyjmując wtyczkę z zasilaniem z urządzenia (zasilanie należy odłączyć od strony urządzenia, odłączenie urządzenia od prądu nic nie da). Po zapisaniu konfiguracji pojawi się okienko informujące o haśle ustawionym w urządzeniu. Hasło te jest potrzebne do odczytu danych za pomocą SMS ów oraz do ich ustawiania. Po poprawnym zapisie konfiguracji możemy włożyć kartę SIM do urządzenia i restartować urządzenie wyjmując wtyczkę zasilającą z urządzenia. Tak skonfigurowane urządzenie będzie powiadamiało nas, co 30 minut o aktualnej temperaturze oraz o zbyt wysokiej temperaturze. Po otrzymaniu wiadomości, że temperatura została przekroczona stan alarmowy utrzymuje się do czasu otrzymania wiadomości o normalnej temperaturze. BIATEL S.A. 15