TRM Instrukcja obsługi

Transkrypt

TRM
Instrukcja obsługi
Spis treści
1. Wprowadzenie
4
1.1 O dokumencie_________________________________________________________________________________4
Organizacja dokumentu________________________________________________________________________4
Rozdział 1: Wprowadzenie _________________________________________________________________4
Rozdział 2: Uruchomienie urządzenia_______________________________________________________4
Rozdział 3: Konfiguracja_____________________________________________________________________4
Rozdział 4: iMod tutorial ___________________________________________________________________4
Rozdział 5: TRM tutorial_____________________________________________________________________4
Rozdział 6:Dodatki _________________________________________________________________________4
1.2 O urządzeniu___________________________________________________________________________________5
1.3 Wprowadzenie do platformy iMod____________________________________________________________5
Sposób działania_______________________________________________________________________________5
Struktura wewnętrzna__________________________________________________________________________6
1.4 O systemie NPE________________________________________________________________________________7
2. Uruchomienie urządzenia
8
2.1 Opis złącz i sposobu podłączenia______________________________________________________________8
2.2 Sygnalizacja parametrów pracy_______________________________________________________________11
Sprawdzenie poprawności pracy urządzenia__________________________________________________11
Status połączenia GPRS*______________________________________________________________________12
2.3 Sposób podłączenia urządzenia do do komputera___________________________________________14
Podłączenie za pomocą portu szeregowego__________________________________________________14
Podłączenie za pomocą portu Ethernet ______________________________________________________15
3. Konfiguracja
16
3.1 Jak konfigurujemy urządzenie________________________________________________________________16
3.2 Konfiguracja startowa________________________________________________________________________16
Format pliku __________________________________________________________________________________16
Położenie pliku _______________________________________________________________________________16
Przykładowy plik______________________________________________________________________________17
Opis parametrów______________________________________________________________________________18
Parametry określające start usług__________________________________________________________18
Konfiguracja interfejsu Ethernet ___________________________________________________________18
Konfiguracja modemu GSM*______________________________________________________________18
Pozostałe parametry_______________________________________________________________________19
3.3 Konfiguracja aplikacji_________________________________________________________________________19
Definicje kanałów komunikacyjnych__________________________________________________________19
Kanały źródła danych (source channel)____________________________________________________19
Kanały dostępu do danych (access channel)_______________________________________________20
Kanały komunikatów (message channel)__________________________________________________20
Definicje parametrów_________________________________________________________________________20
Przyporządkowanie kanałów do parametrów_________________________________________________21
Przyporządkowanie kanału źródła danych________________________________________________21
Przyporządkowanie kanału dostępu do danych___________________________________________21
2
Przyporządkowanie zdarzenia_____________________________________________________________21
4. iMod tutorial
22
4.1 Przykład 1: Dostęp do wewnętrznych zasobów systemowych________________________________22
4.2 Przykład 2: Komunikacja z innym urządzeniem______________________________________________23
4.3 Przykład 3: Definiowanie kanałów powiadamiania i zdarzeń_________________________________24
5. TRM tutorial
26
5.1 Opis struktury pliku konfiguracji aplikacji_____________________________________________________26
5.2 Dodatkowe informacje związane z konfiguracją______________________________________________27
Zmiana adresów ciepłomierzy________________________________________________________________27
6. Dodatki
28
6.1 Szczegółowy opis struktury pliku konfiguracji aplikacji_______________________________________28
Kanał dostępu do danych_____________________________________________________________________28
Kanał źródła danych__________________________________________________________________________28
Kanał komunikatów___________________________________________________________________________28
Definicja komunikatu_________________________________________________________________________29
Definicja parametru___________________________________________________________________________29
Definicja zdarzenia____________________________________________________________________________30
3
1. Wprowadzenie
1.1
O dokumencie
W niniejszej dokumentacji zawarto opis podstawowej funkcjonalności konwertera TRM konieczny
dla jego skonfigurowania i zainstalowania w miejscu przeznaczenia.
Konwerter TRM oparty jest o platformę iMod. Cechy specyficzne dla urządzenia TRM opisano w
rozdziale 5: TRM tutorial. Rozdział ten opisuje przykładową konfigurację komunikacji urządzenia
TRM z regulatorem węzłów cieplnych i ciepłomierzami MBUS.
W dalszej części dokumentacji kiedy używamy słowa urządzenie mamy na myśli konwerter TRM.
Niektóre zasoby sprzętowe urządzenia jak np. wbudowany modem GSM/GPRS występują tylko w
niektórych wersjach urządzenia – dlatego w tych miejscach użyto gwiazdki *. Oznacza to, że
opisywana funkcjonalność ma zastosowanie tylko w niektórych wersjach urządzania.
Szczegółowy opis wersji urządzeń TRM znajduje się w dodatku:
Organizacja dokumentu
Rozdział 1: Wprowadzenie
Zawiera podstawowe informacje o niniejszym dokumencie
Rozdział 2: Uruchomienie urządzenia
Opisuje rozmieszczenie i sposób podłączenia do poszczególnych zasobów sprzętowych urządzenia
Rozdział 3: Konfiguracja
Opis konfiguracji startowej urządzenia oraz podstawy konfiguracji aplikacji
Rozdział 4: iMod tutorial
Trzy proste przykłady konfiguracji aplikacji
Rozdział 5: TRM tutorial
Opis domyślnej konfiguracji urządzeń serii TRMX12
Rozdział 6:Dodatki
Zestawienie dodatkowych informacji o urządzeniu
4
1.2
O urządzeniu
Konwerter TRM oparty jest o platformę iMod. Platforma iMod definiuje wewnętrzne cechy
urządzenia, sposób konfiguracji oraz jego obsługę. Spora część niniejszego dokumentu opisuje
urządzenie w kontekście tej platformy.
Strukturę systemową serii TRM przedstawia następujący schemat:
Aplikacja TRM
Platforma iMod
System NPE - Linux
Rysunek 1: Struktura aplikacyjna urządzenia serii TRM
Aplikacja TRM jest bezpośrednio osadzona na platformie iMod. Poniżej w skrócie opisano główne
cechy tej platformy.
1.3
Wprowadzenie do platformy iMod
Sposób działania
Platforma iMod zdefiniowana jest o system niezależnych kanałów (channels). Wyróżniamy 3 typy
kanałów:
• kanał źródła danych (source channel)
• kanał dostępu do danych (access channel)
• kanał komunikatów (message channel)
Przepływ danych w kanałach prezentuje poniższy diagram:
Rysunek 2: Struktura kanałów w platformie iMod
Platforma iMod definiuje również spójny sposób konfiguracji. Dzięki temu za pomocą jednego pliku
w formacie xml można całkowicie zmienić sposób działania urządzenia. Plik ten definiuje cała logikę
aplikacji iMod. Szczegółowe informacje o sposobie konfiguracji opisane są w kolejnych rozdziałach.
Platforma iMod została zaprojektowana w taki sposób, aby można było dołączać dodatkowe kanały
5
(protokoły) w systemie plug-in. Dzięki tej właśnie funkcjonalności powstała seria urządzeń TRM.
Taki sposób implementacji dedykowanych protokołów gwarantuje to, że aplikacja działa w
uporządkowany sposób w oparciu o jeden spójny system.
Podstawowe funkcje realizowane przez iMod to:
•
pobieranie danych z interfejsów NPE lub urządzeń zewnętrznych z wykorzystaniem
protokołu Modbus, MBUS lub innych
•
buforowanie zgromadzonych danych z opcją ich archiwizacji – funkcja rejestratora
•
udostępnianie danych dla systemów monitorowania, np. typu SCADA, bądź też innych
sterowników iMod lub PLC, w sposób ciągły lub zdarzeniowo
Struktura wewnętrzna
Poniżej zamieszczono schemat funkcjonalny platformy iMod. Oprócz opisanych wyżej 3 grup
kanałów przedstawiono na nim wewnętrzna tablice parametrów. Jest to tablica zbuforowanych
wartości chwilowych reprezentujące przetwarzane dane (np. odczytane wartości wejść), które
następnie mogą być przekazane dalej za pomocą kanałów wyjściowych.
Rysunek 3: Schemat funkcjonalny platformy iMod
6
1.4
O systemie NPE
Jak wspomniano wcześniej urządzenie działa w oparciu o system NPE, który jest zgodny z
systemem Linux. Oznacza to, że za pomocą dostępu terminalowego możliwa jest administracja
urządzeniem w sposób zgodny z innymi urządzeniami , czy komputerami, opartymi o ten system.
Z poziomu systemu NPE możliwy jest dostęp do zasobów sprzętowych urządzenia.
Rysunek 4: Interfejsy sprzętowe systemu NPE
Poniższy rysunek prezentuje interfejsy sprzętowe, należy zaznaczyć iż niektóre z nich nie występują
we wszystkich wersjach urządzania.
Szczegółowy opis systemu NPE, a właściwie środowiska Linux wykracza poza zakres niniejszego
dokumentu.
7
2. Uruchomienie urządzenia
2.1
Opis złącz i sposobu podłączenia
Rysunek 5: Wygląd urządzenia
Urządzenie jest gotowe do pracy bezpośrednio po podłączeniu zasilania. Urządzenie potrzebuje
źródła zasilania napięciem stałym od 9V do 30V o mocy 12W. Rysunek 3 przedstawia wygląd
urządzenia i rozmieszczenie poszczególnych jego komponentów. Sposób podłączenia zasilania oraz
wykorzystanie pozostałych złącz przedstawiają rysunki 6 i 7.
8
Nazwa elementu
Oznaczenie
Opis
Connector 1
C1
Złącze zasilania i portów
szeregowych
Connector 2
C2
Złącze wejść analogowych i
portu RS485
SIM Card Slot*
SIM
Slot karty SIM
SD Card Slot
SD
Slot kart SD/MMC
Ethernet Port
ETH
Wejście Ethernetowe
Antenna*
ANT
Wejście antenowe modemu
Power LED
PWR
Dioda zasilania
User LED
USR
Dioda do dyspozycji
użytkownika
Status LED
RDY
Dioda statusu urządzenia
GPRS LED
GPRS
Dioda aktywnego połączenia
GPRS
Modem LED
GSM
Dioda modemu GSM
* - zależnie od wersji
Rysunek 6: Opis złącza C1
9
Numer
pinu
Oznaczenie
Opis
1
Vcc
Plus zasilania
2
GND
Minus zasilania (masa)
3
CWD
Zacisk diod zabezpieczających wyjścia tranzystorowe
4
PO4
Wyjście cyfrowe Open Collector lub wyjście przekaźnikowe
5
PO3
6
PO2
7
PO1
8
DO2
Wyjście cyfrowe Open Collector
9
DO1
Wyjście cyfrowe Open Collector
10
TX0
Port szeregowy RS232 - COM0 – Transmit Data
11
RX0
Port szeregowy RS232 - COM0 – ReceiveData
12
GND
13
TX0
Port szeregowy RS232 - COM2 – Transmit Data
14
RX0
Port szeregowy RS232 - COM2 – ReceiveData
Tabela 1: Opis pinów złącza C1
Rysunek 7: Opis złącza C2
10
Numer
pinu
Oznaczenie
Opis
1
A
Port szeregowy RS485 – COM3 - DATA-
2
B
Port szeregowy RS485 – COM3 - DATA+
3
GND
4-7
DI1 - DI4
Wejścia cyfrowe
8 - 10
DI5 - DI7
Wejścia cyfrowe z funkcją przerwaniową
11
DIW
12
GND
13 - 15
AI1 - AI3
Wejścia analogowe pomiaru napięcia stałego
16
AIV
Wejście analogowe pomiaru napięcia stałego lub przemiennego
Interfejs OneWire lub wejście cyfrowe z funkcją przerwaniową
Tabela 2: Opis pinów złącza C2
2.2
Sygnalizacja parametrów pracy
Sprawdzenie poprawności pracy urządzenia
Aktualny status pracy urządzenia sygnalizowany jest poprzez diodę Status LED znajdującą się z
przodu obudowy. Tabela 3 przedstawia zachowanie diody Status LED w zależności od stanu
urządzenia.
11
Lp.
Stan
Typ
1
Urządzenie nieaktywne
info
Dioda zgaszona
2
Inicjalizacja
info
Ciągłe świecenie
3
Błąd pliku konfiguracyjnego
error
Powtarzające się
dwa krótkie impulsy
4
Błąd inicjalizacji jednego z
kanałów
warning
Powtarzający się
pojedynczy impuls
5
Normalna praca
info
Powolne miganie
(około 1Hz)
info
Powolne miganie 0.5
Hz modulowane
szybkim miganiem
6
Wyłączanie
Prezentacja
Opis
Tabela 3: Zachowanie diody Status LED w zależności od stanu urządzenia
Stany pracy typu warning i error świadczą o niepoprawnej pracy urządzenia. Więcej informacji w
dodatku:
Status połączenia GPRS*
Proces nawiązywania połączenia GPRS sygnalizowany jest przed diodę LED oznaczoną na Rysunku
3 jako GPRS LED. Tabela 4 przedstawia znaczenie każdej z sekwencji migania diody LED.
Błąd numer 3 wskazuje na niepoprawny PIN zdefiniowany w pliku /mnt/mtd/syscfg. Należy go
zweryfikować i uruchomić ponownie konwerter. Po trzykrotnym uruchomieniu konwertera ze złym
PIN'em kod błędu zmieni się na 4. Należy wówczas skorzystać z narzędzia /mnt/mtd/setpuk w
następujący sposób:
/mnt/mtd/setpuk 12345678
12
Przy każdym uruchomieniu setpuk podaje ono pozostałą liczbę prób zmiany numeru PUK.
Standardowo wynosi ona 10. Należy uważać, aby nie wykorzystać wszystkich prób, gdyż wiąże się
to z zablokowaniem karty SIM.
Lp.
Stan
Typ
Prezentacja
Opis
1
Brak połączenia
info
Dioda zgaszona
2
Inicjalizacja
info
Ciągłe świecenie
3
Niepoprawny PIN
error
Powtarzające się
dwa krótkie impulsy
4
Wymagany PUK
error
Powtarzające się trzy
krótkie impulsy
5
Oczekiwanie na rejestrację
info
Szybkie miganie
6
Błąd odpowiedzi na ping
warning
Powtarzający się
pojedynczy impuls
7
Aktywne połączenie
info
Powolne miganie
(około 1Hz)
Tabela 4: Znaczenie stanu diody GPRS
Stany pracy typu warning i error świadczą o niepoprawnej pracy urządzenia. Więcej informacji w
dodatku:
13
2.3
Sposób podłączenia urządzenia do do komputera
Podłączenie za pomocą portu szeregowego
Ustawienie w konfiguracji startowej opcji START_CONSOLE=Y powoduje utworzenie szeregowego
interfejsu komunikacyjnego na porcie COM1 urządzenia (rysunek 8).
Rysunek 8: Podłączenie urządzenia do komputera poprzez port szeregowy
N komputerze należy uruchomić terminal portu szeregowego np. PuTTY. Ustawienia portu
szeregowego w tej aplikacji są przedstawione na rysunku 9:
Rysunek 9: Ustawienia portu szeregowego w aplikacji PuTTY
Numer portu na komputerze musi być odpowiednio ustawiony (np. COM1). Konfiguracja sesji w
programie PuTTY przedstawiono na rysunku 10.
14
Rysunek 10: Konfiguracja sesji w programie PuTTY
Po naciśnięciu na Open powinno pojawić się następujące okno:
Aby się zalogować należy podać login i hasło. Domyślne wartości to:
Login: user
Hasło: user
Podłączenie za pomocą portu Ethernet
Urządzenie należy podłączyć bezpośrednio do komputera za pomocą zwykłego kabla
Ethernetowego. Aby nawiązać połączenie należy znać adres IP i maskę podsieci urządzenia.
Domyślne wartości to:
Adres IP:
192.168.0.101
Maska podsieci:
255.255.255.0
Komputer musi posiadać tą samą maskę podsieci i adres IP równy 192.168.0.x
gdzie x oznacza dowolna wartości z przedziału 0-244 wyłączając 101
czyli adres IP komputera może przyjąć wartość 192.168.0.1 lub 192.168.0.102
15
16
3. Konfiguracja
3.1
Jak konfigurujemy urządzenie
Urządzenie TRM konfiguruje się za pomocą dwóch plików konfiguracyjnych.
3.2
1.
pilik syscfg odpowiada za opcje startowe urządzenia. Ta konfiguracja zwana jest dalej
Konfiguracją Startową.
2.
plik MainConfig.xml odpowiada natomiast za konfigurację aplikacji. W dalszej części zwanej
Konfiguracją Aplikacji
Konfiguracja startowa
Format pliku
Plik konfiguracji startowej ma postać pliku tekstowego o formacie typu:
Parametr=Wartość
Niedozwolone jest umieszczanie spacji pomiędzy znakiem '=' a tekstem.
Nie należy również stosować cudzysłowów np. "Wartość" .
Plik /mnt/mtd/syscfg jest jedynym plikiem, którego edycja jest dopuszczalna podczas konfiguracji.
Proszę nie edytować innych plików w tej lokalizacji.
Położenie pliku
Ścieżka: /mnt/mtd/
Nazwa: syscfg
17
Przykładowy plik
#
# Custom System configuration file
#
HOST_NAME=techbase
GW_IP=192.168.0.1
NET_MASK=255.255.0.0
HOST_IP=192.168.0.101
HOST_MAC=18:83:13:09:85:e7
RTC_RESTORE=Y
OUT_RESTORE=Y
START_CONSOLE=N
START_BLINK=N
START_DHCP=Y
START_FTP=Y
START_TELNET=Y
START_SNMP=N
START_NPESRV=N
GSM_BAUD=230400
PIN=0096
MUX=Y
GPRS_AUTOSTART=Y
GPRS_DNS=AUTO
DEFAULT_ROUTE=GPRS
GPRS_APN=m2m.plusgsm.pl
GPRS_RECONNECT=N
GPRS_PING_IP_1=208.67.222.222
GPRS_PING_IP_2=208.67.220.220
#
18
Opis parametrów
Parametry określające start usług
Nazwa parametru
Format wartości
Opis
START_CONSOLE
Y lub N
Uruchomienie konsoli systemowej
na porcie szeregowym COM1
(/dev/ttyS0)
START_BLINK
Y lub N
Sygnalizacja etapów uruchamiania
systemu operacyjnego
START_DHCP
Y lub N
Uruchomienie klienta DHCP
(dynamiczne IP)
START_FTP
Y lub N
Uruchomienie serwera FTP
START_TELNET
Y lub N
Uruchomienie usługi telnet
START_SNMP
Y lub N
Uruchomienie obsługi SNMP
START_NPESRV
Y lub N
Uruchomienie usługi „lookup”
Nazwa parametru
Format wartości
Opis
HOST_NAME
String
Nazwa hosta
GW_IP
XXX.XXX.XXX.XXX
Adres IP bramy sieciowej
NET_MASK
XXX.XXX.XXX.XXX
Maska podsieci
HOST_IP
XXX.XXX.XXX.XXX
Adres IP urządzenia
HOST_MAC
XX.XX.XX.XX.XX.XX
Adres MAC urządzenia
Konfiguracja interfejsu Ethernet
Konfiguracja modemu GSM*
19
Nazwa parametru
Format wartości
Opis
GSM_BAUD
Dozwolone dla portu
szeregowego prędkości w
bit/s
Prędkość komunikacji z modemem GSM
PIN
4 cyfry
Numer PIN karty SIM
MUX
Y lub N
Tryb multipleksacji modemu GSM
GPRS_AUTOSTART
Y lub N
Automatyczne nawiązywanie połączenia
GPRS podczas startu modemu
GPRS_DNS
AUTO
lub
XXX.XXX.XXX.XXX
Ustawienie automatycznej konfiguracji
serwera DNS przez APN lub ustawienie
własnego adresu IP serwera DNS
DEFAULT_ROUTE
GPRS lub ETH
Ustawienie trasy domyślnej na modem
GSM lub interfejs Ethernetowy
GPRS_APN
String
Nazwa APN
GPRS_RECONNECT
Y lub N
Uruchomienie procesu wznawiającego
połączenie GPRS po jego przerwaniu
GPRS_PING_IP_1
XXX.XXX.XXX.XXX
Pierwszy adres IP serwera służącego do
sprawdzania połączenia GPRS
GPRS_PING_IP_2
XXX.XXX.XXX.XXX
Drugi adres IP serwera służącego do
sprawdzania połączenia GPRS
Nawiązywanie połączenia GPRS jest domyślnie włączone. Wskazane jest także włączenie
ponawiania połączenia (GPRS_RECONNECT=Y) po uprzednim ustawieniu parametrów
GPRS_PING_IP_1 i GPRS_PING_IP_2.
Pozostałe parametry
3.3
Nazwa parametru
Format wartości
Opis
RTC_RESTORE
Y lub N
Odświeżanie daty systemowej z
RTC przy każdym starcie
OUT_RESTORE
Y lub N
Odświeżanie stanu wyjść cyfrowych
przy każdym starcie
Konfiguracja aplikacji
Niniejszy rozdział opisuje poszczególne struktury opisujące niezależne kanały oraz pozostałe
definicje stanowiące rdzeń platformy iMod.
Definicje kanałów komunikacyjnych
Kanały źródła danych (source channel)
20
Nazwa elementu: <source-channel>
Opis: Definicja kanału stanowiącego źródło danych wejściowych dla platformy iMod
Przykład definicji:
<source-channel name="NPE_io">
<protocol name="HARDWARE"/>
<gap>0</gap>
<cycle>2</cycle>
</source-channel>
Kanały dostępu do danych (access channel)
Nazwa elementu: <access-channel>
Opis: Definicja kanału umożliwiającego dostęp do danych poprzez platformę iMod
<access-channel name="Modbus_S1">
<protocol name="MODBUS"/>
<port>"ET-1502-TCP"</port>
<device-id>1</device-id>
</access-channel>
Kanały komunikatów (message channel)
Nazwa elementu: <message-channel>
Opis: Definicja kanału komunikatów wysyłanych przez platformę iMod w odpowiedzi na
zdefiniowane przez użytkownika zdarzenia
<message-channel name="Email_sender">
<protocol name="EMAIL">
<property name="user" value="npe"/>
<property name="password" value="npe"/>
</protocol>
<port>"mail.a2s.pl"</port>
<recipient>"[email protected]"</recipient>
</message-channel>
Definicje parametrów
Nazwa elementu: <parameter>
Opis: Definicja struktury opisującej format danych odczytywanych z kanału źródła danych i sposób
jego przyporządkowania do kanału dostępu. Może także zawierać definicje struktur opisujących
zdarzenia powiązane z kanałami komunikatów (patrz strona 22) .
<parameter>
<id>100</id>
<description>"Analog input 1"</description>
<source-channel channel-name="NPE_io"
parameter-id="adc1"
parameter-type="HOLD"/>
21
<access-channel channel-name="Modbus_S1"
parameter-id="100"
</parameter>
Przyporządkowanie kanałów do parametrów
Struktura definiująca parametr musi zawierać elementy określające powiązanie z kanałami źródła
danych oraz z kanałem dostępu do danych. Użytkownik może też przyporządkować do tej struktury
definicje zdarzeń.
Przyporządkowanie kanału źródła danych
Nazwa elementu: <source-channel>
Opis: Definicja przyporządkowuje do danego parametru jeden kanał źródła danych.
parameter-id="adc1"
Przyporządkowanie kanału dostępu do danych
Nazwa elementu: <access-channel>
Opis: Definicja przyporządkowuje do danego parametru jeden lub wiele kanałów dostępu do
danych.
parameter-id="100"
Przyporządkowanie zdarzenia
Nazwa elementu:<event>
Opis: Definicja przyporządkowuje do danego parametru jeden lub wiele zdarzeń związanych z
kanałami komunikatów i treściami komunikatów.
<event type="HiAlarm">
<message-channel name="Email_sender"/>
<message-id>"Mess_1"</message-id>
<hysteresis>0.0</hysteresis>
<property name="trigger" value="82.0"/>
</event>
Przykład definicji treści komunikatu:
22
<message id="Mess_1">
<![CDATA[
"TIME
The temperature is too high !!!
REG_NAME[11201] - REG_VALUE[11201] REG_UNIT[11201]"
]]>
</message>
23
4. iMod tutorial
Konfiguracja urządzenia TRM202-DW opiera się na platformie iMod. Niniejszy rozdział opisuje
proste przykładowe konfiguracje aplikacji iMod. Jeżeli chcesz możesz pominąć czytanie tego
rozdziału i przejść do kolejnego poświęconego konfiguracji urządzenia TRM.
4.1
Przykład 1: Dostęp do wewnętrznych zasobów systemowych
Przykład opisuje sposób konfiguracji aplikacji iMod umożliwiający odczyt sprzętowych zasobów
urządzenia i udostępnienie ich w sieci Ethernet poprzez protokół Modbus (Rysunek 12).
Rysunek 11: Ilustracja struktury opisanej w przykładzie 1
Pierwsza część pliku zawiera parametry kanałów komunikacyjnych dostępu do:
•
wejść cyfrowych
•
wyjść cyfrowych
•
wejść analogowych
Cykl odczytu odbywa się co 2 sekundy. Fragment pliku konfiguracyjnego odpowiadający tej
funkcjonalności ma następującą postać:
<source-channel name="NPE_io">
<protocol name="HARDWARE"/>
<gap>0</gap>
<cycle>2</cycle>
</source-channel>
Kolejna część pliku opisuje kanał komunikacyjny umożliwiający dostęp do danych poprzez protokół
Modbus TCP na porcie 1502:
</access-channel>
Dalsza struktura o nazwie <parameter> opisuje sposób przekazywanie danych pomiędzy
zdefiniowanymi kanałami. W tym przypadku jest to odczyt pierwszego wejścia analogowego i
24
udostępnienie jego wartości w Modbus'owym rejestrze o adresie 100:
<parameter>
<id>100</id>
<description>"Analog input 1"</description>
parameter-id="adc1"
parameter-id="100"
</parameter>
Element id to unikalny identyfikator struktury. Kolejna struktura ma budowę analogiczną do
poprzedniej, wiąże jednak stan pierwszego wyjścia cyfrowego z rejestrem Modbus'owym o adresie
101:
<parameter>
<id>101</id>
<description>"Digital output 1"</description>
parameter-id="out1"
parameter-type="WRITE"/>
parameter-id="101"
parameter-type="WRITE"/>
</parameter>
4.2
Przykład 2: Komunikacja z innym urządzeniem
Niniejszy przykład demonstruje sposób komunikacji urządzenia iMod z innym urządzeniem
obsługującym protokół Modbus RTU (Rysunek 12).
Rysunek 12: Ilustracja struktury opisanej w przykładzie 2
Struktura konfiguracyjna kanału obsługującego protokół Modbus RTU na porcie COM1 ma
następującą postać:
25
<source-channel name="Modbus_M1">
<port>"C1-19200-8E1-R"</port>
<gap>0</gap>
<cycle>20</cycle>
</source-channel>
Parametry portu szeregowego są następujące:
•
COM port: 1
•
baudrate: 19200 b/s
•
datatbits: 8
•
parity: Even
•
stop bits: 1
•
protocol type: Modbus RTU
Kolejna część pliku to struktura <parameter> związana z wyżej zdefiniowanym kanałem
komunikacyjnym:
<parameter>
<id>11201</id>
<scale>0.1</scale>
<comment>"Sensor S1"</comment>
<unit>"K"</unit>
<description>"Temperature 1"</description>
<source-channel channel-name="Modbus_M1"
parameter-id="11201"
</parameter>
Rejestr Modbus RTU o adresie 11201 , urządzenia podłączonego do portu COM1 zostanie
przekonwertowany na rejestr Modbus TCP o tym samym adresie.
4.3
Przykład 3: Definiowanie kanałów powiadamiania i zdarzeń
Każda struktura typu <parameter> może być związana ze strukturą <event> definiującą akcje jakie
zostaną wykonane gdy określone warunki zostaną spełnione.
Każda struktura <event> związana jest ze specjalnym rodzajem kanału powiadamiającego oraz
treścią komunikatu jaki ma być wysłany poprzez dany kanał. Przykładowa definicja takiego kanału
oraz treści komunikatu poniżej:
<message-channel name="Email_sender">
26
<protocol name="EMAIL">
<property name="user" value="npe"/>
<property name="password" value="npe"/>
</protocol>
<port>"mail.a2s.pl"</port>
<recipient>"[email protected]"</recipient>
</message-channel>
<message id="Mess_1">
<![CDATA[
"TIME
The temperature is too high !!!
REG_NAME[11201] - REG_VALUE[11201] REG_UNIT[11201]"
]]>
</message>
W treści wiadomości stosować można makra rozpoczynające się od „REG_”. Są one przetwarzane na
aktualne wartości atrybutów danego parametru takich jak jego wartość („REG_VALUE”), nazwa
(„REG_NAME”) czy symbol jednostki („REG_UNIT”). Wartość w nawisie kwadratowym to
identyfikator danego parametru.
Poniższa definicja to rozbudowana struktura <parameter> z poprzedniego podrozdziału:
<parameter>
<id>11201</id>
<scale>0.1</scale>
<comment>"Sensor S1"</comment>
<unit>"K"</unit>
<description>"Temperature 1"</description>
<source-channel channel-name="Modbus_M1"
<event type="HiAlarm">
<message-channel name="Email_sender"/>
<message-id>"Mess_1"</message-id>
<hysteresis>0.0</hysteresis>
<property name="trigger" value="82.0"/>
</event>
</parameter>
Struktura <event> opisuje w tym przypadku zdarzenie powodujące wysłanie komunikatu o
identyfikatorze „Mess_1” poprzez kanał „Email_sender” gdy wartość parametru przekroczy 82.
27
28
5. TRM tutorial
Niniejszy rozdział opisuje funkcjonalność wszystkich rodzajów urządzeń z serii TRMX12.
Na rysunku 13 przedstawiono uproszczony schemat strukturalny domyślnie skonfigurowanego
urządzenia.
Rysunek 13: Struktura domyślnie skonfigurowanego urządzenia z serii TRMX12
5.1
Opis struktury pliku konfiguracji aplikacji
Pierwszym elementem pliku jest struktura konfiguracyjna kanału komunikacji typu Modbus TCP:
</access-channel>
Kanał ten pełni rolę urządzenia Modbus TCP slave na porcie 1502 o adresie Modbus równym 1.
Kolejnym elementem jest struktura konfiguracyjna kanału komunikacji obsługującego protokół
serwisowy regulatora ECL300C66.
<source-channel name="Modbus_M1">
<protocol name="ECL300C66S"/>
<port>"C3-1200-8O1"</port>
<gap>0</gap>
<cycle>30</cycle>
</source-channel>
Kanał ten umożliwia komunikację z regulatorem na porcie szeregowym COM3. Parametry transmisji
to 12008O1. Odczyt wartości odbywa się co 30s bez dodatkowej przerwy pomiędzy odczytami.
Trzeci kanał komunikacyjny obsługuje protokół MBUS na porcie COM1:
<source-channel name="MBUS_HMeters">
<protocol name="MBUS"/>
<port>"C1-2400-8E1"</port>
<gap>0</gap>
<cycle>60</cycle>
</source-channel>
Parametry transmisji to 24008E1. Odczyt wartości odbywa się co minutę bez dodatkowej przerwy
29
pomiędzy odczytami.
Częstotliwość archiwizacji danych (w minutach) określa się ustawiając atrybut acquisition_period
głównego elementu pliku o nazwie <imod>:
<imod version="0.1.8" acquisition_period="10">
Elementy o nazwie <parameter> określają sposób konwersji danych odczytywanych z urządzeń
slave.
Zaleca się ostrożność podczas modyfikacji elementów <parameter>. Są one dostosowane do
wewnętrznej mapy rejestrów regulatora ECL300 i MBUS'owych liczników ciepła. Więcej informacji
w dodatku.
5.2
Dodatkowe informacje związane z konfiguracją
Pliki konfiguracyjne można edytować za pośrednictwem serwera FTP lub NFS. Sposób
nawiązywania połączenia z konwerterem jest identyczny jak w przypadku komputerów
przemysłowych serii NPE. Dokładny opis znajduje się w dokumencie
Zmiana adresów ciepłomierzy
Adresy MBUS ciepłomierzy należy ustawić w pliku /mnt/sd/TRM_GW/MBUSMap.xml.
Określają je znaczniki <a2s:Counter addr="XXX"> , gdzie XXX to adres licznika.
30
31
6. Dodatki
6.1
Szczegółowy opis struktury pliku konfiguracji aplikacji
Kanał dostępu do danych
<access-channel>
Atrybuty
Nazwa
Opis
name
Elementy
Nazwa
Liczność
Wartość domyślna
Opis
<protocol>
<port>
<device-id>
Kanał źródła danych
<source-channel>
Atrybuty
Nazwa
Opis
name
Elementy
Nazwa
<protocol>
<port>
<device-id>
<gap>
<cycle>
Kanał komunikatów
32
Liczność
Wartość domyślna
Opis
<message-channel>
Atrybuty
Nazwa
Opis
name
Elementy
Nazwa
Liczność
Wartość domyślna
Opis
Wartość domyślna
Opis
Wartość domyślna
Opis
<protocol>
<port>
<recipient>
Definicja komunikatu
<message>
Atrybuty
Nazwa
Opis
id
Elementy
Nazwa
Liczność
<![CDATA[ ]]>
Definicja parametru
<parameter>
Elementy
Nazwa
<id>
<scale>
<offset>
<name>
<description>
<comment>
<label>
<unit>
<data-logging>
<maxval>
<minval>
33
Liczność
<source-channel>
<access-channel>
<event>
Definicja zdarzenia
<event>
Atrybuty
Nazwa
Opis
id
Elementy
Nazwa
<message-channel>
<message-id>
<hysteresis>
<property>
34
Liczność
Wartość domyślna
Opis

TRM Instrukcja obsługi

Transkrypt

Podobne dokumenty

iMod - A2s.pl

iModHOST

Karta katalogowa

Konfiguracja połączenia programu InTouch ze sterownikiem GE

application form

Euro-Reklama OUTDOOR EXPO 2008 Międzynarodowe Targi

NPE M500

Hasło ps2

Appendix to „power of attorney” for oversea firms from the European