Protokol Teltonika Codec14

Podporované typy a verzie zariadení 
Konfigurácia komunikačnej linky
Konfigurácia komunikačnej stanice
Konfigurácia meraných bodov
Literatúra
Zmeny a úpravy
Revízie dokumentu

Podporované typy a verzie zariadení


Protokol Teltonika Codec14 podporuje zber údajov zo zariadení "Fleet Management Systems Unit" Teltonika typu FM4200 s firmware Movys. Protokol je realizovaný ako TCP server, ku ktorému sa online pripájajú zariadenia (units). Odovzdávanie údajov do systému sa realizuje cez konfiguráciu tzv. "master" stanice a meraných bodov. Čiže, akýkoľvek počet pripojených zariadení odovzdáva údaje do systému cez jednu vzorovú konfiguráciu zariadenia. Údaje z jednotlivých zariadení identifikuje unikátny IMEI kód zariadenia.

Konfigurácia komunikačnej linky


  • Kategória komunikačnej linky: TCP/IP TCP.
  • Server host: all alebo (TCP server), server port: well-known port podľa nastavenia zariadení.

Konfigurácia komunikačnej stanice


Komunikačný protokol: Teltonika Codec14.

Odporúčané nastavenie časových parametrov stanice: delay 1 sec.

Parametre protokolu stanice

Môžu sa konfigurovať nasledovné parametre protokolu stanice:

Tab. č. 1

NázovPopisJednotkaNáhradná hodnota
Clients per Thread
Počet pripojených zariadení, ktoré sú obsluhované jedným exekučným vláknom (threadom). Slúži na vyváženie výkonu a odozvy komunikačného procesu v závislosti od počtu pripojených zariadení.1 až 20050
Send Async Message Request After Connect
Poslanie správy 'Asynchronous Message Request' po pripojení zariadenia. Zariadenie následne odpovie správou 'Asynchronous Message Response', ktorá obsahuje dáta (AVL record).YES/NOYES
Debug Packet Analyse
Zapnutie ladiacich výpisov typu prijatých a odoslaných datagramov.YES/NOYES
Debug Values
Povolenie detailných ladiacich výpisov o prijatých údajoch.YES/NONO
Debug Packet Queue Flow
Povolenie ladiacich výpisov o stave spracovania prijatých dát systémom D2000.YES/NONO
Debug Packet Binary Contents
Povolenie ladiacich výpisov s binárnym obsahom prijatých/odoslaných datagramov.YES/NOYES
Unit Debug File

Povolenie špeciálnej úrovne sledovania zariadení, kedy sa ladiace informácie ukladajú do špeciálneho súboru s názvom odvodeným od IP adresy zariadenia (IP1_IP2_IP3_IP4.log) v podadresári "trace" aplikačného adresára, čo uľahčuje identifikáciu ladiacich výpisov od konkrétneho zariadenia.

Možné nastavenia:

Not_Allowed- tento súbor sa nevytvára
Both Line & Station- súbor vytvára paralelne s klasickým .log súborom sledovania komunikačnej linky.
Station Only- vytvárajú sa iba špeciálne log súbory, nie logy linky
POZOR! Toto nastavenie preťažuje nastavenie úrovne sledovania komunikácie v konfigurácii linky (viď tiež informácie v dokumente "Komunikačné linky - položky konfiguračného okna" kapitola "Sledovanie komunikácie").
Not Allowed
Both Line & Station
Station Only
Not Allowed
Unit Debug File Size
Maximálna veľkosť špeciálneho ladiaceho súboru (Debug Info) zariadenia. Po nadobudnutí tejto veľkosti sa súbor premenuje a odloží podobne, ako súbor sledovania komunikačnej linky.1 až 50 MBytes10

Konfigurácia meraných bodov


Možné typy hodnôt bodov: Ai, Ao, Ci, Co, Di, Dout, TiA, ToA, TxtI, TxtO.

Zoznam adries meraných bodov

Tab. č. 2

AdresaPopisTyp hodnoty
HND.TRIGMessage handshaking - vystavenie novej inkrementálnej hodnoty signalizuje nastavenie všetkých hodnôt meraných bodov s hodnotami prijatého záznamu a ich pripravenosť na spracovanie.Ci
HND.TRIG_ACCMessage handshaking - potvrdenie spracovania údajov aplikáciou. Vykoná sa zápisom hodnoty HND.TRIG, čo signalizuje KOM procesu, že môže vystaviť ďalší záznam.Co
STAT.CONN_NRGlobal Statistic - aktuálny počet obsluhovaných TCP pripojení.Ci
STAT.IN_QUEUE_LENGlobal Statistic - počet prijatých a zatiaľ do systému neodovzdaných datových záznamov.Ci
STAT.RD_TASKS_NRGlobal Statistic - počet prijimacích vlákien (threads).
STAT.VIRT_ST_NRGlobal Statistic - aktuálny počet pripojených zariadení s unikátnym IMEI.
UNIT_DATA.IMEIUnit data - IMEI zariadenie, od ktorého boli prijaté údaje.TxtI
UNIT_DATA.DTIMEUnit data - časová značka prijatých údajov. Všetky merané body UNIT_DATA.xxx majú nastavenú časovú značku hodnoty na identickú hodnotu.TiA
UNIT_DATA.LATUnit data - latitude.Ai
UNIT_DATA.LONUnit data - longitude.Ai
UNIT_DATA.ALTUnit data - altitude (m).Ai
UNIT_DATA.PRIOUnit data - data priority (0/1).Ci
UNIT_DATA.SATUnit data - počet viditeľných satelitov.Ci
UNIT_DATA.SPEEDUnit data - rýchlosť (km/h).Ci
UNIT_EVENT.EvNrUnit event - hodnota prijatého eventu číslo EvNr. Bližšie informácie o jednotlivých eventoch viď dokumentáciu protokolu Codec14.Ai/Di/Ci/TxtI
UNIT_DEBUG.DbgNrUnit debug - debug informácia s indexom DbgNr. Bližšie informácie o jednotlivých debug informáciach viď dokumentáciu protokolu Codec14.Ai/Di/Ci/TxtI
UNIT_STAT.ST_BYTES_INUnit statistic & info - počet prijatých bytov zo zariadenia od štartu KOM procesu.Ci
UNIT_STAT.ST_BYTES_OUTUnit statistic & info - počet odoslaných bytov do zariadenia od štartu KOM procesu.Ci
UNIT_STAT.ST_CONFIG_TIMESTAMPUnit statistic & info - tzv. config timestamp zariadenia.TiA
UNIT_STAT.ST_CONNECTEDUnit statistic & info - stav pripojenia (1-connected, 0-disconnected), len pri zmene stavu.Ci
UNIT_STAT.ST_CONNECTSUnit statistic & info - celkový počet prihlásení zariadenia od štartu KOM procesu.Ci
UNIT_STAT.ST_FW_VERUnit statistic & info - verzia firmware zariadenia.TxtI
UNIT_STAT.ST_PACKETS_INUnit statistic & info - počet prijatých datagramov zo zariadenia od štartu KOM procesu.Ci
UNIT_STAT.ST_PACKETS_OUTUnit statistic & info - počet odoslaných datagramov do zariadenia od štartu KOM procesu.Ci
UNIT_RESTART.IMEIUnit restart request - zápisom hodnoty IMEI do tohto meraného bodu sa odošle žiadosť na reštart zariadenia s daným IMEI. Ak zápis skončí chybou, zariadenie nie je pripojené.TxtO
UNIT_MONITORING.IMEIUnit monitoring request - zápisom hodnoty IMEI do tohto meraného bodu sa odošle žiadosť na monitorovanie zariadenia s daným IMEI. Ak zápis skončí chybou, zariadenie nie je pripojené.TxtO
UNIT_ASYNCMESS.IMEIAsync message request - zápisom hodnoty IMEI do tohto meraného bodu sa odošle žiadosť o asynchrónnu správu zo zariadenia s daným IMEI. Ak zápis skončí chybou, zariadenie nie je pripojené.TxtO
UNIT_DEBUG.IMEIUnit debug request - zápisom hodnoty IMEI do tohto meraného bodu sa odošle žiadosť o debug správu zariadenia s daným IMEI. Zariadenie odpovedá UNIT_DEBUG.DbgNr hodnotami. Ak zápis skončí chybou, zariadenie nie je pripojené.TxtO
UNIT_FW_UPD.PARAMSFirmware update request - zápisom požadovaných informácii sa inicializuje proces aktualizácie firmware pre zariadenie s daným IMEI. Formát údajov: IMEI,APN,APNuser,APNpasswd,server:port,fw_filename. Bližšie informácie viď dokumentáciu protokolu Codec14.TxtO
UNIT_PARAMS_OUT.IMEIUnit parameters write messaging - IMEI zariadenia, do ktorého sa odosielajú zmeny konfiguračných parametrov.TxtO
UNIT_PARAMS_OUT.ADDRUnit parameters write messaging - adresa zapisovaného parametra (parameter ID).Co
UNIT_PARAMS_OUT.VALUEUnit parameters write messaging - hodnota zapisovaného parametra.TxtO
UNIT_PARAMS_OUT.VALUE_TYPEUnit parameters write messaging - typ hodnoty zapisovaného parametra.Co


Zápis parametrov

Platia nasledovné pravidlá:

  1. Hodnoty parametrov sa nedajú prečítať, dajú sa iba zapisovať.
  2. Kontrola, či prebehol zápis v poriadku, prebieha cez tzv. Configuration Timestamp (meraný bod s adresou UNIT_STAT.ST_CONFIG_TIMESTAMP). Hodnotu "Config Timestamp" nastav pri zápise parametrov - je to parameter s parameter ID = 0 (Profile Timestamp). Hodnota by mala byť unikátnym absolutným časom, najlepšie časom okamžiku začiatku konfigurácie. Po zápise parametrov musí byť hodnota UNIT_STAT.ST_CONFIG_TIMESTAMP nastavená na užívateľom odosielanú hodnotu parametra s ID=0.
  3. Priebeh zápisu:
    • Nastav IMEI do meraného bodu UNIT_PARAMS_OUT.IMEI, ak skončí s chybou (na akcii WAIT), tak KOM proces zariadenie s takýmto IMEI nepozná alebo nie je online.
    • Nastav typ hodnoty parametra do UNIT_PARAMS_OUT.VALUE_TYPE (viď tabuľku č.3).
    • Nastav UNIT_PARAMS_OUT.VALUE s hodnotou parametra (ako text).
    • Nastav UNIT_PARAMS_OUT.ADDR s parameter ID. Ako prvý parameter v poradí je najvhodnejší ID=0 "Profile Timestamp".
    • Nastav UNIT_PARAMS_OUT.VALUE_TYPE ďalšieho parametra v poradí.
    • Nastav UNIT_PARAMS_OUT.VALUE s hodnotou ďalšieho parametra v poradí.
    • Nastav UNIT_PARAMS_OUT.ADDR s parameter ID ďalšieho parametra v poradí.

      ... opakuj toľkokrát, koľko parametrov zapisuješ. Nemusia sa zapisovať všetky parametre, ale napr. iba tie, ktoré boli zmenené ....
    • Nastav UNIT_PARAMS_OUT.VALUE_TYPE na hodnotu 1 pre ukončenie konfigurácie.
    • Nastav UNIT_PARAMS_OUT.VALUE - prázdny text pre ukončenie konfigurácie.
    • Nastav UNIT_PARAMS_OUT.ADDR na hodnotu 0. To je signál na fyzické odoslanie parametrov do zariadenia.

Tab. č. 3

Typ hodnoty
"UNIT_PARAMS_OUT.VALUE_TYPE"
Parameter ID
"UNIT_PARAMS_OUT.ADDR"
Popis
10Koniec konfigurácie.
2xParameter typu U8.
3xParameter typu I32.
4xParameter typu String. V praxi je možné použiť pre všetky parametre okrem parametra s ID=0. Za správnosť textu s hodnotou zodpovedá užívateľ, KOM proces nevykonáva kontrolu.
6xParameter typu U16.
8xParameter typu Float.
10xParameter typu U32.
110Parameter "Profile Timestamp" - text s absolútnym časom vo formáte: "dd-mm-rrrr hh:mi:ss".

Literatúra


  • Teltonika Codec.14 Communication Protocol Description, Rev.11.

Zmeny a úpravy


  • sept. 2009 - Vytvorenie dokumentu

Revízie dokumentu


  • Ver. 1.0 – 30. sept. 2009

Súvisiace stránky:

Write a comment...