Codec14

Codec14

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 (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ázov

Popis

Jednotka

Ná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ž 200

50

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/NO

YES

Debug Packet Analyse

Zapnutie ladiacich výpisov typu prijatých a odoslaných datagramov.

YES/NO

YES

Debug Values

Povolenie detailných ladiacich výpisov o prijatých údajoch.

YES/NO

NO

Debug Packet Queue Flow

Povolenie ladiacich výpisov o stave spracovania prijatých dát systémom D2000.

YES/NO

NO

Debug Packet Binary Contents

Povolenie ladiacich výpisov s binárnym obsahom prijatých/odoslaných datagramov.

YES/NO

YES

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 MBytes

10

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

Adresa

Popis

Typ hodnoty

HND.TRIG

Message 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_ACC

Message 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_NR

Global Statistic - aktuálny počet obsluhovaných TCP pripojení.

Ci

STAT.IN_QUEUE_LEN

Global Statistic - počet prijatých a zatiaľ do systému neodovzdaných datových záznamov.

Ci

STAT.RD_TASKS_NR

Global Statistic - počet prijimacích vlákien (threads).

 

STAT.VIRT_ST_NR

Global Statistic - aktuálny počet pripojených zariadení s unikátnym IMEI.

 

UNIT_DATA.IMEI

Unit data - IMEI zariadenie, od ktorého boli prijaté údaje.

TxtI

UNIT_DATA.DTIME

Unit 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.LAT

Unit data - latitude.

Ai

UNIT_DATA.LON

Unit data - longitude.

Ai

UNIT_DATA.ALT

Unit data - altitude (m).

Ai

UNIT_DATA.PRIO

Unit data - data priority (0/1).

Ci

UNIT_DATA.SAT

Unit data - počet viditeľných satelitov.

Ci

UNIT_DATA.SPEED

Unit data - rýchlosť (km/h).

Ci

UNIT_EVENT.EvNr

Unit 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.DbgNr

Unit 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_IN

Unit statistic & info - počet prijatých bytov zo zariadenia od štartu KOM procesu.

Ci

UNIT_STAT.ST_BYTES_OUT

Unit statistic & info - počet odoslaných bytov do zariadenia od štartu KOM procesu.

Ci

UNIT_STAT.ST_CONFIG_TIMESTAMP

Unit statistic & info - tzv. config timestamp zariadenia.

TiA

UNIT_STAT.ST_CONNECTED

Unit statistic & info - stav pripojenia (1-connected, 0-disconnected), len pri zmene stavu.

Ci

UNIT_STAT.ST_CONNECTS

Unit statistic & info - celkový počet prihlásení zariadenia od štartu KOM procesu.

Ci

UNIT_STAT.ST_FW_VER

Unit statistic & info - verzia firmware zariadenia.

TxtI

UNIT_STAT.ST_PACKETS_IN

Unit statistic & info - počet prijatých datagramov zo zariadenia od štartu KOM procesu.

Ci

UNIT_STAT.ST_PACKETS_OUT

Unit statistic & info - počet odoslaných datagramov do zariadenia od štartu KOM procesu.

Ci

UNIT_RESTART.IMEI

Unit 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.IMEI

Unit 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.IMEI

Async 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.IMEI

Unit 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.PARAMS

Firmware 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.IMEI

Unit parameters write messaging - IMEI zariadenia, do ktorého sa odosielajú zmeny konfiguračných parametrov.

TxtO

UNIT_PARAMS_OUT.ADDR

Unit parameters write messaging - adresa zapisovaného parametra (parameter ID).

Co

UNIT_PARAMS_OUT.VALUE

Unit parameters write messaging - hodnota zapisovaného parametra.

TxtO

UNIT_PARAMS_OUT.VALUE_TYPE

Unit parameters write messaging - typ hodnoty zapisovaného parametra.

Co