Instrukcja montażu i eksploatacji sterownika komunikacyjnego CellBOX-C oraz oprogramowania konfiguracyjnego Cerber.

Biatel S.A. Plac Piłsudskiego 1 00-078 Warszawa Instrukcja montażu i eksploatacji sterownika komunikacyjnego CellBOX-C oraz oprogramowania konfiguracyjnego Cerber. Sierpień 2007 ver. 2.1 +48 85 7459760 Producent zastrzega sobie prawo wprowadzania zmian bez uprzedzenia.

Szanowni Państwo! Przekazujemy Państwu do użytkowania wyrób spełniający wysokie wymogi jakościowe technologii GSM, odpowiadające standardom światowym. Sądzimy, że spełni on Państwa oczekiwania. Jednakże warunkiem jest zaznajomienie się z treścią niniejszej instrukcji obsługi i eksploatacji oraz użytkowanie zgodnie z zawartymi w niej wskazówkami. Niniejsza instrukcja zawiera podstawowe informacje o module CellBOX-C, w przypadku potrzeby dodatkowych informacji technicznych należy zwrócić się do producenta Przedsiębiorstwa BIATEL S.A. Producent zastrzega sobie możliwość dokonywania zmian w konstrukcji i oprogramowaniu wewnętrznym modułu CellBOX-C mając na celu podwyższenie walorów technicznoeksploatacyjnych. 2

Spis treści: 1. Wstęp.... 5 2. Opis Techniczny.... 5 2.1. Skrócone dane techniczne.... 5 2.1.1. Zasilanie.... 5 2.1.2. Interfejsy sprzętowe.... 6 2.1.3. Warunki pracy.... 6 2.1.4. Rodzaj wykonania.... 6 2.1.5. Moduł GSM.... 6 2.1.6. Wejścia cyfrowe.... 7 2.1.7. Wyjścia cyfrowe.... 7 2.1.8. Port RS232.... 7 2.1.9. Pomiar temperatury... 7 2.1.10. Lampki sygnalizacyjne... 8 2.1.11. Pozostałe funkcje... 8 3. Instrukcja montażu.... 9 3.1. Zawartość pakietu... 9 3.2. Instalacja.... 9 3.2.1. Montaż... 9 3.2.2. Listwa zacisków montażowych... 10 3.2.3. Antena GSM... 11 3.2.4. Lokalizacja... 13 3.2.5. Urządzenia zewnętrzne... 13 3.2.6. Aparatura medyczna... 13 4. Program Cerber... 14 4.1. Zakładka: Hosty... 15 4.2. Zakładka: Konfiguracja wejść... 16 4.3. Zakładka Wejścia analogowe... 17 4.4. Zakładka Ustawienia ogólne :... 19 4.5. Zakładka Widok aktualny :... 20 5. Uruchomienie modułu CellBOX-C... 23 3

5.1. Pierwsze kroki... 23 5.2. Problemy sygnalizowane przez program.... 27 6. Komunikacja z modułem za pośrednictwem programu terminalowych.... 28 7. Komendy AT... 29 8. Komunikacja z modułem za pośrednictwem SMS.... 39 9. Sygnalizacja LED.... 42 10. Notatki użytkownika.... 45 11. Historia dokumentu.... 46 4

1. Wstęp. Niniejszy dokument zawiera informacje o sposobie montażu, eksploatacji i konfigurowaniu sterownika CellBOX-C. 2. Opis Techniczny. Moduł CellBOX-C jest urządzeniem służącym do zdalnego monitorowania obiektów, budynków i urządzeń oraz sterowania nimi. Zbieranie informacji o monitorowanym obiekcie przez moduł odbywa się za pomocą ośmiu wejść cyfrowych, dodatkowo ma on trzy wyjścia cyfrowe umożliwiające sterowanie urządzeniami zewnętrznymi. Konfiguracji układu dokonuje się za pomocą komputera PC wyposażonego w program Cerber. Program umożliwia konfigurowanie między innymi: stanów alarmowych; czasów opóźnień stanów alarmowych (zwłoka zadziałania alarmu); tekstów alarmów; użytkowników; PINu użytej w modemie karty SIM; nr telefonu, na jaki wysyłane są informacje w postaci SMS bądź dzwonków (RING) telefonu (możliwe jest ustawienie dwóch użytkowników). 2.1. Skrócone dane techniczne. 2.1.1. Zasilanie. - Napięcie zasilania pracy ciągłej: 8 15 V AC; - Zasilanie awaryjne: typowo akumulator 6V 1Ah; - Pobór mocy średni: 1,4W (GSM); - Pobór mocy impulsowy w czasie transmisji GSM 10 W.

2.1.2. Interfejsy sprzętowe. - Gniazdo antenowe GSM - MMCX; - Interfejs RTTL; - Gniazdo dla karty SIM 2.1.3. Warunki pracy. - Temperatura otoczenia 25 +70 o C. - Temperatura przechowywania -40 +85 o C. - Wilgotność 5-95%. - Ciśnienie atmosferyczne 70kPa do 106 kpa (-400 do 3000m) 2.1.4. Rodzaj wykonania. - Płytka z laminatu dwustronnego (114x65mm) z otworami montażowymi o średnicy 3,2mm. 2.1.5. Moduł GSM. - Dual-band EGSM 900 and GSM 1800; - Compliant to GSM phase 2/2+; - Moc wyjściowa: Class 4 (2W) at EGSM900; Class 1 (1W) at GSM1800; - SMS: Point-to-point MO and MT; SMS cell broadcast; Text and PDU mode; - DATA: CSD do 14.4 kbps; - SIM card 3V (small size GSM version); - Wymagana antena zewnętrzna o impedancji 50 Ω z wtykiem antenowym typu MMCX; - Obsługa poprzez komendy AT 6

2.1.6. Wejścia cyfrowe. - 8 izolowanych wejść cyfrowych ze wspólną masą - podanie sygnału zewnętrznego odbywa się poprzez zwarcie poszczególnych wejść do masy. Stan podawany na te wejścia sygnalizowany jest diodami LED umieszczonymi bezpośrednio nad każdym z tych wejść. - Prąd wpływający do wyjścia około 10mA; - Napięcie na wejściu w stanie jałowym 6V; 2.1.7. Wyjścia cyfrowe. - 3 wyjścia cyfrowe typu OC; Prąd obciążenia max 100mA; Maksymalne napięcie załączania 30V; 2.1.8. Port RS232. - Port w standardzie RS232 TTL służący do konfiguracji parametrów pracy sterownika, konfiguracja odbywa się poprzez komputer PC z zainstalowanym programem Cerber. Do komunikacji wymagany jest specjalny kabel komunikacyjny CER-RS. 2.1.9. Pomiar temperatury - Sterownik jest wyposażony w czujnik do pomiaru temperatury. Pomiar dokonywany jest za pomocą wewnętrznego portu analogowego, a zmierzona wartość jest odczytywana lokalnie poprzez interfejs RS i prezentowana w programie Cerber lub zdalnie poprzez zapytanie komendę wysyłaną SMSem. 7

Charakterystyka układu pomiarowego temperatury. 2.1.10. Lampki sygnalizacyjne - Zestaw kontrolek typu LED informujących o stanie urządzenia 3 diody LED (L1, L2, GSM) informujące o stanie sterownika i modemu GSM. - Zestaw ośmiu kontrolek typu LED informujących o stanie wejść cyfrowych, usytuowanych nad każdym z zacisków. 2.1.11. Pozostałe funkcje - Wewnętrzny zegar czasu rzeczywistego. - Zapis ustawień w nielotnej wewnętrznej pamięci procesora. - Pomiar wartości napięcia zasilania awaryjnego. - Układ ładowania akumulatora zewnętrznego. - Wybór rodzaju stanu alarmowego (wysoki lub niski). - Funkcja blokady poszczególnych wejść za pośrednictwem innego wejścia. - Pomiar wartości sygnału GSM doprowadzonego z anteny. 8

- Sygnalizacja stanem wysokim na wyjściu O0 stanu alarmowego. 3. Instrukcja montażu. 3.1. Zawartość pakietu - sterownik CellBOX-C - szt. 1 - przewód przejściówka RS232/rs232TTL - szt. 1 (opcja) - program Cerber 3.2. Instalacja. Urządzenie w warunkach normalnej eksploatacji powinno być zamontowane w obudowie zamkniętej w sposób zapewniający ochronę od czynników zewnętrznych. Do montażu można użyć otworów mocujących znajdujących się na płytce modułu (Φ3.2). Połączenia elektrycznego modułu dokonuje się poprzez zaciski montażowe znajdujące się na krawędzi płytki. Prawidłowo jest, gdy przewody dochodzące do zacisków modułu zakończone są tulejkami przewodowymi zaciśniętymi na ich końcach. 3.2.1. Montaż Montaż, instalacje antenowe, połączenia, itp. powinny być wykonywane przez osoby z doświadczeniem z zakresu pracy z urządzeniami elektronicznymi lub radiowymi (np. GSM). 9

Widok listwy: 3.2.2. Listwa zacisków montażowych Opis zacisków: Wyprowadzenia listwy zacisków montażowych. Nr zacisku* Oznaczenie Rodzaj zacisku Uwagi 1 Vin Zasilanie AC/DC 2 Vin Zasilanie AC/DC 3 +Aku (+) Akumulatora +6V 4 Aku- (-) Akumulatora GND 5 I1 Wejście cyfrowe 1 6 I2 Wejście cyfrowe 2 7 I3 Wejście cyfrowe 3 8 I4 Wejście cyfrowe 4 9 I5 Wejście cyfrowe 5 10 I6 Wejście cyfrowe 6 11 I7 Wejście cyfrowe 7 12 I8 Wejście cyfrowe 8 13 GND Masa układu 14 GND Masa układu 15 O0 Wyjście cyfrowe 1 Iomax 100mA 16 O1 Wyjście cyfrowe 2 Iomax 100mA 17 O2 Wyjście cyfrowe 3 Iomax 100mA * zaciski liczone są od lewej strony modułu 10

Możliwe są następujące układy połączeń sygnałów wejściowych z płytką modułu: Możliwe są następujące układy połączeń sygnałów wyjściowych z płytką modułu: 3.2.3. Antena GSM Moduł CellBOX-C współpracuje z dowolną anteną GSM o impedancji 50Ω na pasmo 900/1800MHz z wtykiem antenowym typu MMCX. 11

Miejsce podłączenia anteny pokazany jest na fotografii poniżej. Przykładowa antena GSM 12

3.2.4. Lokalizacja Przy wyborze miejsca pracy sterownika należy stosować się do obowiązujących na danym obszarze przepisów i oznakowań. Używanie w miejscach gdzie jest zabronione stosowanie urządzeń GSM lub urządzeń emitujących fale o częstotliwości radiowej (z powodu możliwych zakłóceń radiowych lub innych) jest niedozwolone! 3.2.5. Urządzenia zewnętrzne Przed instalacją sterownika należy upewnić się czy zewnętrzne urządzenia nie są podatne na sygnały o częstotliwości radiowej (RF zakres pracy GSM), ponieważ nie jest wykluczone, że na niektóre z urządzeń emitowane przez antenę sterownika fale radiowe mogą mieć wpływ niekorzystny. 3.2.6. Aparatura medyczna Zalecane jest, aby odległość pomiędzy anteną sterownika a stymulatorem serca była większa niż 20 cm. Jest to minimalna odległość zalecana przez producentów tych urządzeń zabezpieczająca stymulator przed potencjalnymi zakłóceniami. Niekiedy sygnał emitowany przez antenę zewnętrzną sterownika (urządzenie GSM) może powodować zakłócenia w pracy aparatów słuchowych lub w funkcjonowaniu medycznej aparatury elektronicznej. W przypadku stwierdzenia występowania takich zakłóceń należy zapoznać się ze szczegółowymi zaleceniami eksploatacyjnymi producenta aparatu słuchowego a w przypadku aparatury medycznej należy bezwzględnie skontaktować się z producentem w celu upewnienia się o fakcie odpowiedniego zabezpieczenia wyżej wymienionej aparatury przed niekorzystnym wpływem fal o częstotliwości radiowej (RF zakres GSM). 13

4. Program Cerber Program służy do konfiguracji modułu CellBOX-C. Możemy wyróżnić w nim trzy zasadnicze elementy: Górny pasek, w którym mamy dostępne menu: Plik, Ustawienia i O... Zakładki: Hosty, Konfiguracja wejść, Ustawienia główne i Widok aktualny. Przyciski Odczytaj konfigurację, AutoReset, Zapisz konfigurację. Pasek menu Zakładki przyciski Kontrolka sygnalizująca komunikację ze sterownikiem 14

Pierwszą rzeczą po uruchomieniu programu jest konfiguracja portu szeregowego za pomocą, którego będziemy komunikować się z modułem CellBOX-C. Możemy jej dokonać w zakładce menu Ustawienia - Wybór portu Dodatkowo w menu Plik mamy możliwość odczytu i zapisu pliku z konfiguracją modułu. Menu O... zawiera krótkie info o programie i producencie urządzenia i oprogramowania. 4.1. Zakładka: Hosty - Nr telefonu - numer, na który wysyłane będą komunikaty alarmowe. - Prefix tekst dodawany do każdej wiadomości na jej początku, i Sufix tekst dodawany do każdej wiadomości na jej końcu. Ustawienia te zwiększają czytelność przychodzących informacji. - Wyłączenie tekst wiadomości wysyłanej w chwili stwierdzenia przez urządzenie, że w wyniku rozładowania akumulatora nie będzie już w stanie wysłać więcej wiadomości - Host 0 i Host 1 - zakładki do definiowania numerów telefonów, na które będą wysyłane komunikaty. - Stan aktywny w to pole wpisujemy treść tekstu alarmowego w przypadku zaistnienia alarmu, Stan nieaktywny treść tekstu wysyłana w przypadku powrotu do stanu normalnego. Treść komunikatów alarmowych wysyłanych przez moduł jest unikatowa dla każdego z wejść cyfrowych. Dodatkowo istnieje pole przeznaczone na teksty dotyczącą obecności zasilania (ipower) i stanu akumulatora (apower). 15

Numer telefonu, na który będą wysyłane komunikaty Ustawienia tekstów komunikatów Prefix i sufix wiadomości Podgląd stanu I/O Informacja o poziomie sygnału GSM i rejestracji w sieci komórkowej 4.2. Zakładka: Konfiguracja wejść W zakładce Konfiguracja wejść definiujemy reakcje układu na sygnały podawane na wejść 1-4: Sformatowane: Punktory i numeracja - Opóźnienie - czas, przez który musi utrzymać się zdarzenie, aby ewentualny sygnał alarmowy mógł być wysłany, może on zawierać się pomiędzy 10 a 6000000ms. - Max il. zmian - maksymalna liczba sygnałów alarmowych na dowolnym z wejść cyfrowych, której przekroczenie powoduje zablokowanie wysyłania wiadomości na Czasokres autoresetu wejść. Po upływie tego czasu układ powraca do wysyłania wiadomości, gdy tylko pojawią się zdarzenia alarmowe. 16

- Blokada - wybór wejść, które zostają zablokowane po pojawieniu się sygnału alarmowego na wybranym wejściu (funkcja przydatna przy wykorzystaniu sterownika jako centralka alarmowa). - Rodzaj - wybór rodzaju stanu alarmowego ( standard to stan wysoki, inwersja to stan niski, zablokowany układ nie reaguje na zamiany sygnałów na tym wejściu). 4.3. Zakładka Wejścia analogowe Zakładka ta podzielona jest na dwie części: - definiujcja reakcji układu na sygnały podawane na wejścia 5-8 - konfiguracja progów alarmowych dla zmierzonych wartości: akumlatora jeden zakres progów temperatury trzy zakresy progrów 17

W pierwszej części parametry konfiguracyjne są identyczne jak w poprzednim rozdziale. - ipower czas, po którym wysyłana jest wiadomość o zaniku głównego napięcia zasilającego. - apower czas, po którym wysyłana jest wiadomość o osiągnięciu alarmowego stanu zasilania awaryjnego. - atempx czas, po którym wysyłana jest wiadomość o osiągnięciu alarmowego zakresu temperatury. W drugiej części użytkownik może skonfigurować progi alarmowe dla akumulatora i temperatury przekroczenie których powoduje powiadamianie wiadomościami SMS. W przypadku przekroczenia któregoś z progów wysyłana jest treści wiadomości akreślonych w zakładce Hosty dla wirtualnych wejść: apower, atemp0, atemp1, atemp2. Poniższy rysunek przedstawia sposób reakcji urządznenia na przykładowy sygnał analogowy dla jednego z zakresu progów. W przypadku limitów temperaturowych można przyjąć, że każdy z zakresów progów pełni rolę histerezy. 18

4.3.4.4. Zakładka Ustawienia ogólne : Sformatowane: Punktory i numeracja - PIN numer PIN stosowanej karty SIM. - Nr telefonu test numer telefonu, na jaki wysyłana jest cyklicznie informacja o poprawnej pracy modułu, informacja ta może mieć formę: SMSa, dzwonka telefonu lub być nieaktywna. - Maksymalna ilość danych w treści definicja ilości zdarzeń, jakie mogą być przesłane naraz w jednej wiadomości SMS (oszczędność kosztów dzięki przesłaniu informacji o paru jednoczesnych zdarzeniach w jednym SMSie). - Maksymalna liczba prób wysłania - ilość prób wysłania SMSa. - Czasookres autoresetu - czas, po którym urządzenie ponownie zaczyna analizować sygnały doprowadzane do wejść cyfrowych modułu po ich wcześniejszym zablokowaniu (wystąpienie zbyt dużej ilości zmian na wejściu - Max il. zmian przekroczona). 19

- Czasokres testu - odstęp czasowy, w jakim odbywa się autotest modułu, a co za tym idzie wysłanie informacji testowej na numer telefonu ustawiony parametrem Nr telefonu test. - Czas dzwonienia czas, przez który moduł dzwoni na nr telefonu test. - Rodzaj ustawienie sposobu powiadamiania podczas testu (SMS, RING, NIEAKTYWNY). - SMSC numer centrum SMS. Numer ten jest inny dla każdego operatora kart SIM. W dolnej części zakładki Ustawienia ogólne wyświetlane jest okno rejestratora. Wizualizuje ono: Wartość napięcia zasilania (wykres liniowy w kolorze czerwonym). Poziom sygnału CSQ (słupkowy wykres w kolorze niebieskim). 4.4.4.5. Zakładka Widok aktualny : Sformatowane: Punktory i numeracja W tej zakładce w sposób graficzny pokazywane są stany wejść i wyjść cyfrowych modułu. Zakładka ta podzielona jest na: Stan chwilowy pokazanie aktualnego stanu wejść bez uwzględnienia opóźnienia 20

czasowego i Stan alarmowy wizualizacja z uwzględnieniem opóźnień reakcji wejść. Należy pamiętać, że wyjście cyfrowe nr 0 jest używane do sygnalizowania sytuacji alarmowych i nie ma możliwości ustawienia jego wartości a odczytywana wartość tego wyjścia jest zależna od stanu urządzenia. Stosowana jest następująca kolorystyka: Zielony - stan normalny logiczne zero podane na wejście, bądź wejście niepodłączone. Czerwony to stan wysoki - logiczna jedynka podana na wejście. Szary przedstawia wejście zablokowane za pomocą innego wejścia, w takiej sytuacji zmiana stanu na nim nie wywoła jakichkolwiek reakcji. Czarny to wejście zablokowane programowo w Konfiguracji wejść Kontrolki stanu chwilowego niemal natychmiast reagują na zmianę sygnału wejściowego. 21

Stan alarmowy pojawia się po upływie zadanego czasu opóźnienia i pod warunkiem, że sygnał ten utrzymał się przez cały ten czas, w przypadku nawet krótkiego jego zaniku czas opóźnienia liczony jest od jego powrotu. Dodatkowo w zakładce tej pokazywane są: BAT - aktualne napięcie na awaryjnym źródle zasilania. TEMP - zmierzona przez moduł temperatura otoczenia. Rysunek poniżej przedstawia następujące stany wejść: 1-stan alarmowy, 2-6 stan normalny, 7 zablokowane przez we 1, 8 zablokowane na stałe. 22

5. Uruchomienie modułu CellBOX-C 5.1. Pierwsze kroki Przy pierwszym uruchomieniu urządzenia (od momentu zakupu) należy je skonfigurować do poprawnej pracy posługując się oprogramowaniem Cerber dołączonym w zestawie. Dokonać możemy tego poprzez port szeregowy RS-232 za pomocą dedykowanego programatoraprzejściówki dołączonego do zestawu. Przewód przejściówka RS232/rs232TTL: UWAGA: Sterownik jest przystosowany do obsługi kart zabezpieczonych, jak i niezabezpieczonych kodem PIN. W przypadku karty posiadającej kod PIN należy go wprowadzić przed umieszczeniem karty w gnieździe (patrz opis programu Cerber). W przypadku podania niewłaściwego kodu PIN i uruchomieniu sterownika z włożoną kartą SIM dojdzie do zablokowania karty. Należy ją wtedy odblokować przy pomocy kodu PUK, przy użyciu dowolnego telefonu komórkowego. Poniżej znajdują się zalecenia dotyczące podłączenie i pierwszej konfiguracji sterownika: Krok 1: 23

Podłączyć kabel komunikacyjny RS232/rs232TTL do portu szeregowego komputera PC i sterownika CellBOX-C. Krok 2: Podłączyć przewody zasilające (zaciski 1 i 2), oraz wykorzystywane sygnały wejściowe, wyjściowe oraz antenę GSM. UWAGA: W tym kroku nie podłączać jeszcze zasilania awaryjnego modułu! Krok 3: Upewnić się czy w gnieździe na pewno nie ma karty. Włączyć zasilanie modułu i dokonać wstępnej konfiguracji modułu. Kolejność wykonywanych czynności: - włączyć zasilanie, - korzystając z programu Cerber, w oknie PIN wpisać PIN karty, następnie zapisać zmianę w pamięci modułu poprzez wciśniecie klawisza zmień PIN. - odłączyć zasilanie modułu CellBOX-C. Krok 4: - Włożyć kartę SIM w gniazdo znajdujące się na module ENFORA 24

- Zamknąć ramkę SIM holdera. - Podłączyć zasilanie (od tej chwili można też podłączyć zasilanie awaryjne). Po tych czynnościach moduł uruchamia się i loguje do sieci GSM, miganie diody LED oznaczonej jako GSM (sposoby sygnalizacji diod LED umieszczone są w rozdziale 6). W programie w zakładce Ustawienia ogólne na rejestratorze wizualizowany jest poziom napięcia zasilania oraz poziom sygnału GSM CSQ (może to nastąpić z kilkusekundowym opóźnieniem). Komunikacja z CellBOXem sygnalizowana jest poprzez animację kolorowego znaczka CellBOX w dolnej, środkowej części okna programu. 25

Chwila uruchomienia modułu (podania zasilania). Znaczek CellBOX Moment dostania się do sieci GSM Krok 5: Od tej chwili można przeprowadzić dalszą konfigurację urządzenia. W poszczególnych zakładkach programu, zgodnie z opisem programu Cerber (patrz pkt. 3.3) wpisać dane niezbędne do tego, aby moduł mógł przesłać odbiorcy odpowiednią informację o monitorowanym obiekcie bądź urządzeniu. Po ustawieniu wszystkich opisów i parametrów można dokonać ich zapisu w pamięci modułu poprzez przycisk Zapisz konfigurację, poprawny zapis jest potwierdzany wyświetleniem okna dialogowego: Odczytu ustawień w module dokonuje się za pomocą przycisku Odczytaj konfigurację. Funkcja ta odczytuje wszystkie ustawienia z wyjątkiem numeru PIN. 26

5.2. Problemy sygnalizowane przez program. W przypadku wystąpienia kłopotów z komunikacją pomiędzy sterownikiem a programem Cerber, pomimo sygnalizacji działania urządzenia diodami LED, wyświetlane jest okno o treści: błąd odczytu konfiguracji. A następnie komunikat Nie można przeczytać aktualnego stanu urządzenia W takiej sytuacji należy dokładnie sprawdzić: podłączenie przewodu RS232 komputer PC - CellBOX-C (mogło nastąpić poluzowanie połączenia sterownika z komputerem). konfigurację portu COM w programie Cerber. 27

6. Komunikacja z modułem za pośrednictwem programu terminalowych. Innym sposobem konfiguracji modułu jest użycie komend konfiguracyjnych (rozszerzone komendy AT protokół własny firmy Biatel). W celu konfiguracji możemy użyć dowolnego programu komunikacyjnego typu Hyperterminal lub programu firmy Biatel Monitor. Program Monitor jest uniwersalnym programem do komunikacji poprzez port szeregowy RS232 z urządzeniami zewnętrznymi za pomocą komend tekstowych. Wygląd programu po uruchomieniu modułu CellBOX-C: 4.1. Konfiguracja programu Monitor do współpracy z modułem CellBOX-C. Wciskając przycisk Settings otwiera się okno konfiguracji portu szeregowego. - Port szeregowy Port -(używany COM) - Prędkość transmisji Baud rate -9600 28

- Data bits -8 - Stop bits -1 - Party -None - Flow control -None Od tej pory możemy komunikować się z podłączonym modułem. 7. Komendy AT Do komunikacji z modułem wykorzystujemy rozszerzone komendy AT, możemy nimi: Odczytywać stan bądź ustawienia modułu. Dokonywać zmian w jego konfiguracji programowej. Składnia komendy powinna wyglądać następująco: at+komenda(parametry) gdzie: komenda Dowolna komenda z opisanych wcześniej (parametry) Opcjonalne parametry występujące w przypadku niektórych komend; Ustawienia wewnętrznego zegara RTC dokonujemy komendą: at+time=dd/mm/yyyy hh:mm:ss:msmsms gdzie: dd mm Miesiąc yyyy Rok hh Godziny mm Minuty ss Sekundy msmsms milisekundy Odczytu czasu możemy dokonać komendą: Dzień miesiaca 29

at+time? Przykład Chcemy następującą datę i czas: 1kwietnia 2004, godzina 10:12 Komenda: at+time=01/04/2004 10:12:00:000 Odpowiedź: +TMS1/4/2004 10:12:0:1; Dla sprawdzenia poprawności wpisów wydajemy następujące polecenia: Komenda: at+time? Odpowiedź: +TMG1/4/2004 10:12:02:59; Zapytanie o aktualny stan wejść cyfrowych ma postać: at+di? Przykład Chcemy odczytać stan wejść sterownika Komenda: at+di? Odpowiedź: +DIG0,1,0,1,0,0,0,0,0,0,0; Gdzie Znaczenie pozycje nr: 1 1 niski stan akumulatora U<5,7V (praca na zasilaniu awaryjnym) 0- akumulator jest ładowany (obecność zewnętrznego napięcia zasilania) 2 1- praca na zasilaniu bateryjnym (brak zewnętrznego zasilania) 0- stan normalny, prawidłowe zewnętrzne zasilanie 3 do 10 Stan wejść cyfrowych począwszy od I8 do I1 Sformatowana tabela Sformatowane: Punktory i numeracja Sformatowano: Wcięcie: Pierwszy wiersz: 0,32 cm 30

Ustawienia hosta (numer telefonu, na, który wysyłane są wiadomości SMS) dokonuje się komendą: at+hphone=nr,"phone" gdzie: nr Numer hosta 0 lub 1 (dwa niezależne numery na które może być wysyłana informacja) "phone" Numer telefonu, na który maja być wysyłane, SMSy (wpisanie "" wyłącza wysyłanie SMSa) Odczytu hostów możemy dokonać komendą: at+hphost?nr gdzie: nr Numer hosta 0 lub 1 (dwa niezależne numery na które może być wysyłana informacja) Przykład Chcemy zdefiniować w sterowniku z pinem 1324 następujące numery telefonów, na które mają być wysyłane informacje host 1 numer telefonu 601234567 host 2 numer telefonu 609876543 Komenda: 1324 at+hphost=0,"601234567" Odpowiedź: +HPS0,"601234567"; Komenda: 1324 at+hphost=1,"609876543" Odpowiedź: +HPS1," 609876543"; Dla sprawdzenia poprawności wpisów wydajemy następujące polecenia: Komenda: 1324 at+hphone?0 Odpowiedź: +HPS0,"601234567"; Komenda: 1324 at+hphone?1 Odpowiedź: +HPS1," 609876543"; Ustawienia Prefixów i Sufixów przesyłanych wiadomości robimy komendą: at+hpresu=nr,"prefix","sufix" 31

gdzie: nr Numer hosta 0 lub 1 "prefix" Prefix wiadomości "sufix" Sufix wiadomości Odczytu ustawionych prefixów i sufixów: at+hpresu?nr gdzie: nr Numer hosta 0 lub 1 Przykład Chcemy ustawić następujące sufixy i prefixy przesyłanych wiadmości: Host 0-601123456 obiekt nr23, Gdańsk Host 1-601123456 Chłodnia, Komenda: at+hpresu=0,"obiekt nr23","gdańsk Odpowiedź: +PXS0,"obiekt nr23","gdańsk"; Komenda: at+hpresu=1,"chłodnia"," Odpowiedź: +PXS1,"chłodnia",""; Dla sprawdzenia poprawności wpisów wydajemy następujące polecenia: Komenda: at+hpresu?0 Odpowiedź: +PXG0,"obiekt nr23","gdańsk"; Komenda: at+hpresu?1 Odpowiedź: +PXG1,"chłodnia",""; Konfiguracji poszczególnych wejść cyfrowych dokonujemy komendą: at+incfg=nr,delay,mode,block_max,max_count gdzie: nr Numer ustawianego wejscia od 0 do 9 delay opóźnienie sygnału wejściowego 10-6000000 ms mode block_max bitowa maska blokowania wejść - 8 bitów max_count maksymalna liczba zmian sygnałów na wejściu 32

Odczyt konfiguracji poszczególnych wejść cyfrowych: at+incfg?nr gdzie: nr Numer sprawdzanego wejścia (od 0 do 9) Przykład Chcemy ustawić konfiguracje 4 wejścia sterownika następującymi parametrami: Delay=100, Mode=192, Block_max=0, Max_count=10 Komenda: at+incfg=4,100,192,0,10 Odpowiedź: +INS4,100,192,0,10; Dla sprawdzenia poprawności wpisów wydajemy następujące polecenia: Komenda: at+incfg?4 Odpowiedź: +ING4,100,192,0,10; Zapytanie o poziom sygnału GSM: at+csq? Przykład Chcemy odczytać poziom sygnaługsm Komenda: at+csq? Odpowiedź: +CSQ23,99; Zapytanie o status rejestracji w sieci: at+creg? Przykład Chcemy odczytać status rejestracji w sieci Komenda: at+creg? Odpowiedź: +creg0,1; Zapytanie o poziom napięcia akumulatora: at+power? 33

Przykład Chcemy odczytać poziom napięcia akumulatora Komenda: at+power? Odpowiedź: +PWG41460; Konfiguracja progów do wysyłaniaa informacji o naładowaniu i słabym stanie akumulatora. at+limp=l1,l2 gdzie: l1 próg, w którym urządzenie wysyła SMS informującego o tym, że akumulator został naładowany. l2 próg, w którym urządzenie wysyła SMS informujący o alarmowym stanie rozładowania akumulatora. Sprawdzanie bieżących ustawień: at+limp? Przykład Chcemy ustawić następujące progi wysyłania informacji o naładowanym i słabym akumulatorze: I1=47400 i I2=43400 Komenda: at+limp=47400,43400 Odpowiedź: +LPS47400,43400; Dla sprawdzenia poprawności wpisów wydajemy następujące polecenia: Komenda: at+limp? Odpowiedź: +LPG47400,43400; Konfiguracja progów do odcięcia zasilania modułu Efora przy słabym stanie akumulatora w celu utrzymania go w lepszej kondycji. at+modp=l1,l2 gdzie: l1 próg, w którym urządzenie powraca do normalnej pracy (przywrócone zostaje zasilanie modułu Enfora). 34

l2 próg, w którym urządzenie odcina zasilanie modułu Enfora. Sprawdzanie bieżących ustawień: at+modp? Przykład Chcemy ustawić następujące progi wysyłania informacji o naładowanym i słabym akumulatorze: I1=44000 i I2=40000 Komenda: at+limp=44000,40000 Odpowiedź: +LPS44000,40000; Dla sprawdzenia poprawności wpisów wydajemy następujące polecenia: Komenda: at+limp? Odpowiedź: +MPG44000,40000; Do spawdzenia stanu wyjścia cyfrowego służy polecenie: at+do? Jako odpowiedź urządzenie wyśle stan wszystkich trzech wyjść: +DOGstanWY2, tanwy1, tanwy0; Przykład: Komenda: at+do? Odpowiedź: +DOG0,1,0; Ustawianie wyjść cyfrowych: at+do=nr_we,stan gdzie: nr_we oznacza numer wyjścia i może przyjmmować wartości 1 oraz 2 stan stan wyjścia, może przyjmować warotości 0(wyłączone) oraz 1 włączone 35

Przykład: ustawienie wyjścia nr 1 na wartość 1: Komenda: at+do=1,1 Odpowiedź: +DOS0,1,0; Konfiguracja progów do wysyłaniaa informacji o przekroczeniu zakresu progów temperatury. at+limt=n,l1,l2 gdzie: n Numer zakresówprogów (0,1,2) l1 próg, w którym urządzenie wysyła SMS informującego o przekroczeniu wartości temperatury. l2 próg, w którym urządzenie wysyła SMS informujący o przekroczeniu wartości temperatury Sprawdzanie bieżących ustawień: at+limt?n Przykład Chcemy ustawić prog pierwszy (zerowy) wysyłania informacji o prograch temperatury: I1=5 st.c i I2=15 st.c Komenda: at+limt=0,5,15 Odpowiedź: +LTS0,5,15; Dla sprawdzenia poprawności wpisów wydajemy następujące polecenia: Komenda: at+limt?0 Odpowiedź: +LTG0,5,15; Ustawienie numeru PIN (używać jedynie przy wyjętej karcie SIM z gniazda) at+cpin="pin" Przy tej komendzie brak jest możliwości odczytu PINu. 36

Przykład Chcemy ustawić PIN 0000 Komenda: at+cpin= 0000 Odpowiedź: +PNS0000; Konfiguracja wysyłania wiadomości SMS: at+smscfg=sms_cnt,max_single_send,max_alarm_send gdzie: sms_cnt liczba prób wysłania SMSa. max_single_send maksymalna liczba zdarzeń wysyłanych jednocześnie max_alarm_send maksymalna liczba wysłań sms'a nieużywane Sprawdzanie bieżących ustawień: at+smscfg? Przykład Chcemy ustawić następujące parametry wysyłania wiadomości SMS: SMS_cnt=2, max_single_send=3, max_alarm_send=0 Komenda: at+smscfg=2,3,0 Odpowiedź: +SCS0,3,0; Dla sprawdzenia poprawności wpisów wydajemy następujące polecenia: Komenda: at+limp? Odpowiedź: +SCG0,3,0; Test modułu (informacja o funkcjonowaniu modułu): at+testcfg="phone",mode,time_ring,"string" gdzie: "phone" numer telefonu, na który cyklicznie wysyłane mogą być informacje potwierdzające działanie modułu. mode tryb pracy. time_ring czas, w jakim wysyłany jest sygnał ring. "string" treść wiadomości SMS dla testu. 37

Sprawdzenie bieżących ustawień testu: at+testcfg? Przykład Chcemy ustawić następujące parametry wysyłania wiadomości testowej: phone= 605171123, mode=1, time_ring=1000, string= obiekt OK Komenda: at+testcfg="605171123",1,1000,"obiekt OK" Odpowiedź: +TTS"605171123",1,1000,"obiekt OK"; Dla sprawdzenia poprawności wpisów wydajemy następujące polecenia: Komenda: at+testcfg? Odpowiedź: +TTG"605171123",1,1000,"obiekt OK"; Odczyt wartości z wejść analogowych procesora: at+ai?nr,fmt gdzie: nr numer wejścia analogowego (możliwe 0-7) 0 pomiar napięcia na akumulatorze 1 pomiar temperatury zewnętrznym czujnikiem 2 pomiar temperatury procesora fmt format danych (3,4,5) 3 postać użytkowa prezentowanej liczby np.: ºC, Volty 4 wartość liczbowa po kalibracji 5 wartość zmierzona przez przetwornik Przykład Chcemy odczytać temperaturę w stopniach Komenda: at+ai?1,3 Odpowiedź: +AIG1,3,17.8685536000; 38

8. Komunikacja z modułem za pośrednictwem SMS. Oprócz konfiguracji i kontroli urządzenia poprzez program Cerber lub komendy AT wydawane przez port lokalny istnieje możliwość zdalnego dostępu do urządzenia poprzez komendy wysyłane SMSem. Aby zabezpieczyć moduł przed niepowołanym dostępem osób nieuprawnionych każda komenda musi zawierać w swojej składni hasło, którym jest numer PIN karty zastosowanej w urządzeniu (niepodanie lub podanie niewłaściwego PINu powoduje, że sterownik ignoruje zapytanie). Składnia komendy wysłanej SMSem powinna wyglądać następująco (różni się ona od komend omówionych w paragrafie wcześniejszym podawaniem na początku każdej komendy numeru PIN): XXXX at+komenda(parametry) gdzie: XXXX Numer PIN karty konfigurowanego sterownika komenda Dowolna komenda z opisanych wcześniej (parametry) Opcjonalne parametry występujące w przypadku niektórych komend; Ważne jest, aby w telefonie, którym się posługujemy wyłączony był automatyczny podpis wiadomości i wszelkie inne funkcje dołączające jakiekolwiek znaki do wysyłanej wiadomości w przeciwnym razie polecenia będą ignorowane. Sterownik odpowiada na wszystkie komendy opisane w poprzednim rozdziale, co daje nam możliwość pełnej zdalnej kontroli nad urządzeniem. Dodatkowo dostępne są 4 specjalizowane komendy działające tylko z poziomu SMSa. 39

Komenda testu urządzenia TST. W odpowiedzi na tę komendę moduł odsyła treść tekstu testowego wpisanego w jego konfiguracji. Składnia komendy: XXXX TST gdzie: XXXX Numer PIN karty konfigurowanego sterownika Przykład Chcemy sprawdzić czy sterownik z pinem 1324 pracuje. Komenda: 1324 TST Odpowiedź: obiekt 25; ->(przykładowy test ustawiony w konfiguracji sterownika) Komenda sprawdzenia statusu urządzenia STA. W odpowiedzi na tę komendę moduł odsyła wiadomość o nast. zawartości: - stany wejść 1-8 - stany wyjść cyfrowych - poziom sygnału GSM (CSQ) - temperatura modułu prezentowana w ºC - poziom napięcia baterii prezentowany w Voltach Składnia komendy: XXXX STA gdzie: XXXX Numer PIN karty konfigurowanego sterownika Przykład Chcemy sprawdzić stan sterownika z pinem 1324 Komenda: 1324 STA Odpowiedź: +STG DI=1010000000,DO=000,CSQ=20,99,TEMP=15.48,BAT=6.93; 40

Komenda zablokowania jednego z wejść urządzenia BLKy. W odpowiedzi na tę komendę moduł odsyła wiadomość o zablokowaniu danego wejścia. Składnia komendy: XXXX BLKy gdzie: XXXX Numer PIN karty konfigurowanego sterownika Y Numer blokowanego wejścia Przykład Chcemy zablokować 3 wejście sterownika z pinem 1324 Komenda: 1324 BLK3 Odpowiedź:+BLK3; Komenda odblokowania jednego z wejść urządzenia UBLKx. W odpowiedzi na tę komendę moduł odsyła wiadomość o zablokowaniu danego wejścia. Składnia komendy: XXXX UBLKy gdzie: XXXX Numer PIN karty konfigurowanego sterownika y Numer odblokowywanego wejścia Przykład Chcemy odblokować 3 wejście sterownika z pinem 1324 Komenda: 1324 UBLK3 Odpowiedź:+UBLK3; 41

9. Sygnalizacja LED. Stan urządzenia sygnalizowany jest poprzez miganie dwóch diod LED umieszczonych na płytce komunikatora i oznaczonych jako L1 i L2, dioda GSM sygnalizuje działanie modułu GSM niezależnie od pracy procesora całego urządzenia. Informacja DIODA L1 DIODA L2 Czas świecenia (on, off) dioda L1 zapala się, stan poprawnej pracy przez 0,5 s. z 1s urządzenia: odstępu pomiędzy nie świeci. on 500ms, off 500ms błyskami wysłanie SMSa: dioda L1 zapala się 2 razy na sekundę nie świeci. on 250ms, of 250ms, odebranie SMSa obie diody zapala się obie diody zapala się 2 razy na sekundę 2 razy na sekundę on 250ms, off 250ms, dioda L1 zapala się 2 praca na zasilaniu on 500ms, off 500ms, razy na 0.5 s. w nie świeci. rezerwowym on 500ms, off 3000ms odstępach 3s. dioda L1 zapala się alarmowy stan raz na 0.5 s. w akumulatora odstępach 3 s nie świeci. on 500ms, off 3000 wskazanie wartości cykl błysków patrz po wciśnięciu guzika nie świeci. CSQ: pod tabelą. S2 jest cykl błysków. cykl błysków taki sam jak wskazanie Test baterii nie świeci. CSQ.dioda pali się świeci, gdy U (AI0) do czasu <5,7V naładowania sięakumulatora dioda L2 zapala się brak komunikacji z nie świeci. na 0.5 s. w modemem odstępach 1s. on 500ms, off 1000ms 42

brak lub uszkodzenie karty SIM zły PIN lub (niewłaściwa karta SIM) brak zasięgu wejście urządzenia w stan auto-resetu dioda L2 zapala się 2 nie świeci. razy na 0.5 s. w on 500ms, off 500ms, odstępach 2 s. czas on 500ms, off 2000ms pomiędzy błyskami 0.5 s nie świeci. dioda szybko miga on 200ms, off 200ms nie świeci. dioda L2 pali się 2s gaśnie na 0.5 s. on 500ms, off 500ms nie świeci. diody świecą przez on 2000ms, 2s gasną na 1s. off 1000ms Wskazanie wartości CSQ odbywa się po wciśnięciu przycisku TEST. Od tej chwili dioda L1 w cyklu pięciu powtórzeń wskaże wartość CSQ poprzez ilość mignięć. Wartości poziomu CSQ dla każdego przypadku przedstawia tabela poniżej: Ilość mignięć Poziom CSQ Od: Do: 1 0 7 2 8 12 3 13 18 4 19 23 5 28 Max Alarmowy stan akumulatora sygnalizowany jest diodą L2 poprzez powtórzenie sekwencji diody L1 wskazującej CSQ, Odbywa się to po wciśnięciu przycisku test, jeżeli akumulator jest naładowany dioda ta nie miga podczas testu. Kontrola stanu wejść W układzie zastosowano sygnalizację stanu wejść cyfrowych oddzielnie dla każdego z wejść. W celu sprawdzenia stanu wejść należy 43

wcisnąć przycisk LED. Stan wysoki wejścia sygnalizowany jest zapaleniem się diody umieszczonej nad jego zaciskiem. Port komunikacyjny modułu Przycisk testu CSU i poziomu akumulatora test Przycisk kontroli stanu wejść cyfrowych LED Diody sygnalizacyjne L1 i L2 Dioda sygnalizująca stan modemu GSM 44

10. Notatki użytkownika. Sformatowane: Punktory i numeracja 45

10.11. Historia dokumentu. Data Wersja Autor Opis marzec.2004 1.0 Grzegorz Modzelewski Utworzenie dokumentu Lipiec 2007 2.0 Andrzej Jemielity Dodanie opisu dodatkowych funkcji urządzenia - sterowanie wyjściami cyfrowymi - progi alarmowe temperatury Sierpień 2007 2.1 Andrzej Jemielity Dodany opis funkcji wyłączenie na str. 15 Uaktualniony opis polecenia STA na str. 40 46

47