KS-26T Kamerový systém
Programátorská příručka
Verze 1.03
ks-26t_ms_cz_103
KS-26T
AMiT, spol. s r. o. nepřejímá žádné záruky, pokud se týče obsahu této publikace a vyhrazuje si právo měnit obsah dokumentace bez závazku tyto změny oznámit jakékoli osobě či organizaci. Tento dokument může být kopírován a rozšiřován za následujících podmínek: 1. Celý text musí být kopírován bez úprav a se zahrnutím všech stránek. 2. Všechny kopie musí obsahovat označení autorského práva společnosti AMiT, spol. s r. o. a veškerá další upozornění v dokumentu uvedená. 3. Tento dokument nesmí být distribuován za účelem dosažení zisku. V publikaci použité názvy produktů, firem apod. mohou být ochrannými známkami nebo registrovanými ochrannými známkami příslušných vlastníků. AMiT je registrovaná ochranná známka.
Copyright (c) 2013, AMiT, spol. s r. o. Výrobce: AMiT, spol. s r. o. Naskové 3/1100, 150 00 Praha www.amit.cz Technická podpora:
[email protected]
ks-26t_ms_cz_103
2/14
KS-26T
Obsah Historie revizí .................................................................................................. 4 Související dokumentace ................................................................................ 4
1.
Úvod ...................................................................................................... 5
2.
Konfigurace systému .......................................................................... 6
3.
Konfigurace kamer .............................................................................. 7
3.1. 3.2.
Moxa VPort P06 ............................................................................................. 7 Vivotek MD8562 ............................................................................................. 7
4.
Orientace kamer při volbě aktivního stanoviště ............................... 8
4.1. 4.2.
Moxa VPort P06 ............................................................................................. 8 Vivotek MD8562 ............................................................................................. 8
5.
Bezpečnostní funkce ........................................................................... 9
5.1. 5.2. 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6
Základní informace ......................................................................................... 9 Implementované bezpečnostní funkce ........................................................... 9 Signalizace neplatného obrazu na LCD displeji ........................................... 10 Detekce statického obrazu – kontrolní součet .............................................. 10 Detekce statického/zpožděného obrazu ....................................................... 10 Kontrola časování synchronizačních signálů LCD displeje ........................... 11 Detekce chybného chování video procesoru ................................................ 11 Detekce chybného chování dohledového procesoru .................................... 11
6.
Záznamové jednotka - chybové kódy .............................................. 12
6.1.
TxRU-RxCU Frame ...................................................................................... 12
7.
Přiřazení streamů ............................................................................... 14
7.1. 7.2.
Moxa VPort P06 ........................................................................................... 14 Vivotek MD8562 ........................................................................................... 14
3/14
ks-26t_ms_cz_103
KS-26T Historie revizí Jméno dokumentu: ks-26t_ms_cz_103.pdf Autor: Václav Krčmář Verze 100 101 102 103
Datum Změny 07. 10. 2013 Nový dokument 28. 04. 2014 Popis bezpečnostní funkce monitoru KS pro verzi FW DP V1.20 27. 01. 2015 Doplnění popisu chybových kódů záznamové jednotky. Doplnění přiřazení streamů z kamer v rámci projektu. 02. 03. 2015 Změna přiřazení streamů z kamer v rámci projektu.
Související dokumentace 1.
ACASYS-KS, Komunikace v systému ACASYS – Programátorská příručka soubor: acasys-ks_ms_cz_xxx.pdf
2.
KS-26T – Montážní příručka soubor: ks-26t_mm_cz_xxx.pdf
ks-26t_ms_cz_103
4/14
KS-26T
1.
Úvod Dokument je specifikací nutnou pro ovládání kamerového systému z nadřazeného systému.
5/14
ks-26t_ms_cz_103
KS-26T
2.
Konfigurace systému Komponenta Monitor A levý Monitor A pravý Displej NŘ A Monitor B levý Monitor B pravý Displej NŘ B Záznamová jednotka Kamera 1 Kamera 2 REZERVA REZERVA Kamera 3 Kamera 4 Kamera 5 Kamera 6 Kamera 7 Kamera 8 Kamera 9 Kamera 10 Kamera 11 REZERVA** REZERVA**
IP adresa 192.168.53.201 192.168.53.202 192.168.53.2 192.168.53.203 192.168.53.204 192.168.53.3 192.168.53.205 192.168.53.211 192.168.53.213 192.168.53.212 192.168.53.214 192.168.53.219 192.168.53.220 192.168.53.221 192.168.53.222 192.168.53.225 192.168.53.224 192.168.53.223 192.168.53.217 192.168.53.215 192.168.53.218 192.168.53.216
Obr. 1 - Rozmístěná kamer na voze
ks-26t_ms_cz_103
6/14
KS-26T
3.
Konfigurace kamer Kamery v sobě nesou informaci o verzi skriptu, který byl jako poslední použit pro jejich konfiguraci. Jedná se pouze o textovou informaci. Vlastní konfigurace kamery se může lišit (pokud došlo k neoprávněnému ručnímu zásahu), není k dispozici prostředek, kterým by kamera mohla hlídat vlastní konfiguraci.
3.1. Moxa VPort P06 Dotaz na verzi ve formátu: http://
/moxa-cgi/getParam.cgi?video_text Odpověď ve formátu: video_text=ks-26t_vportp06_cfg_217_105 kde ks-26t
identifikace projektu
vportp06 typ kamery cfg
označuje konfiguraci
217
poslední oktet IP adresy
105
verze konfiguračního souboru
3.2. Vivotek MD8562 Dotaz na verzi ve formátu: http:///cgi-bin/admin/getparam.cgi?videoin_text Odpověď ve formátu: videoin_text='ks-26t_md8562_cfg_105' kde ks-26t
identifikace projektu
md8562
typ kamery
cfg
označuje konfiguraci
105
verze konfiguračního souboru
7/14
ks-26t_ms_cz_103
KS-26T
4.
Orientace kamer při volbě aktivního stanoviště Vzhledem k definici scén a současné koncepci volby zobrazení v IP monitorech je nutné při změně stanoviště změnit orientaci obrazu některých kamer vozu tak, aby byly vzhledem ke směru jízdy zobrazeny správně.
4.1. Moxa VPort P06 Příkaz sloužící ke změně orientace obrazu: http:///moxa-cgi/setParam.cgi?imagetuning_appearance=0 kde 0
základní obraz
1
obraz zrcadlený podle osy y (mirror)
2
obraz zrcadlený podle osy x (flip)
3
obraz zrcadlený podle osy x i y (flip i mirror)
4.2. Vivotek MD8562 Příkaz sloužící ke změně orientace obrazu: http:///cgi-bin/admin/setparam.cgi?videoin_flip=0&videoin_mirror=0
kde videoin_flip videoin_mirror
ks-26t_ms_cz_103
zrcadlení podle osy x (0=ne, 1=ano) zrcadlení podle osy y (0=ne, 1=ano)
8/14
KS-26T
5.
Bezpečnostní funkce
5.1. Základní informace Monitor KS ASPM1203 je řešen jako dvouprocesorový. Bezpečnostní funkce monitoru jsou implementovány v dohledovém procesoru (DP) STM32F407 ST Microelectronics. Dohledový procesor sleduje data zobrazována na LCD displeji a současně kontroluje správnost chování části systému zodpovědné za příjem obrazu z kamery a jeho zobrazení na LCD displeji. Operátor (lidská obsluha) musí dostávat na LCD monitoru reálný obraz z kamery a v případě poruchy v řetězci kamera-sběrnice-zařízení nesmí LCD displej poskytovat falešný obraz scény. Falešným obrazem se rozumí statický obraz nebo obraz zpožděný o více než je maximální dovolená latence systému. V okamžiku detekce chybového stavu se musí LCD displej ztmavit na nejvyšší úroveň černé a tak operátorovi signalizovat neplatnost poskytovaných vizuálních dat. Bezpečnostní funkce je aktivní pouze v režimu jedno-kvadrant.
NS provozní stav systému
řídicí parametry ASPM1203 plná černá
obraz kamery, čas kamery
přepínač
LCD
VP
Zobrazení
Kamera
obraz kamery nastav čas kamery
hlášení DP
DP
self-test
hlášení VP
Obr. 2 - Blokové schéma systému
5.2. Implementované bezpečnostní funkce V programovém vybavení DP jsou implementovány následující bezpečnostní funkce: Signalizace neplatného obrazu na LCD displeji
9/14
ks-26t_ms_cz_103
KS-26T
5.2.1
Detekce statického obrazu – kontrolní součet Detekce statického/zpožděného obrazu Kontrola časování synchronizačních signálů LCD displeje Detekce chybného chování video procesoru Detekce chybného chování dohledového procesoru
Signalizace neplatného obrazu na LCD displeji V případě detekce chyby některým z níže popsaných způsobů musí dohledový procesor zajistit na LCD displeji zobrazení obrazu signalizujícího chybový stav systému. Tento obraz je generován hardwarem a zobrazuje ve všech bodech nejvyšší úroveň černé. O tomto stavu informuje nadřazené řízení.
5.2.2
Detekce statického obrazu – kontrolní součet Dohledový procesor porovnává po sobě jsoucí snímky. Na těchto snímcích určuje statický obraz pomocí kontrolního součtu CRC32 načtených bodů obrazu. Zpracovávaná data jsou tvořena šachovnicí bodů o velikosti 8x8 bodů, viz následující obrázek.
Body z videosignálu, které načítá a zpracovává DP
Obr. 3 - Šachovnice bodů obrazu zpracovávaná v dohledovém procesoru Podvzorkování obrazu nemá vliv úroveň zabezpečení příslušnou k danému požadavku, jelikož se v tomto případě nezvyšuje pravděpodobnost nedetekování chybného obrazu, ale pouze se zvyšuje pravděpodobnost blokace platného obrazu.
5.2.3
Detekce statického/zpožděného obrazu Dohledový procesor zpracovává definovaný úsek dat obrazové informace mimo část zobrazovanou na LCD displeji. Tyto data obsahují informaci o času generace daného obrazu v kameře. Dohledový procesor zjišťuje zpoždění snímku srovnáním času snímku s aktuálním časem systému. Pokud je snímek starší než 600 ms, považuje se snímek za neplatný. Pokud není do 200 ms poslán alespoň jeden platný snímek, je obraz zablokován.
ks-26t_ms_cz_103
10/14
KS-26T 5.2.4
Kontrola časování synchronizačních signálů LCD displeje Dohledový procesor kontroluje časování signálů LCD displeje. Tato vlastnost plyne z použití DCMI periferie procesoru STM32F407.
5.2.5
Detekce chybného chování video procesoru Dohledový procesor zjišťuje stav video procesoru, a v případě detekce chybného chování video procesoru blokuje obrazu.
5.2.6
Detekce chybného chování dohledového procesoru Běh dohledového procesoru je kontrolován pomocí nezávislého watchdogu.
11/14
ks-26t_ms_cz_103
KS-26T
6.
Záznamové jednotka - chybové kódy Následující kapitola rozšiřuje informace uvedené ve specifikaci komunikačního protokolu kamerového systému acasys-ks_ms_en_107, který je platný pro aplikaci záznamové jednotky 30r49cXX využívanou v tomto projektu. Nedochází ke změně struktury rámce, ale k upřesnění významu pole ERROR, kterým záznamová jednotka signalizuje svůj chybový stav.
6.1. TxRU-RxCU Frame This frame is transmitted by RU and received by CU. Ofs 0 2 4 6 8
11 12
RESERVED CAMS
U8 U32
16
CAMS_MASK
U32
22
TIME
U32
26 28
IS_COUNTER FIRMWARE_ MAJOR FIRMWARE_ MINOR FIRMWARE_ REVISION
U32 U8
Meaning Frame type Payload length in bytes TxRU-RxCU frame type identifier Ignored. Incrementing counter, indication of IPM activity. Bit-coded report. SOS event activation. Recording is ON Recording is OFF due to CU request. Reserved Indication of RU internal error. General error (0-no error, 1-error) Device temperature out of range Fatal disk error (disk does not exist, error in mounting) Reserved for future use. Individual camera record bit-array. 0 – recording is OFF 1 – recording is ON Connected camera bit-array. 0 – camera is not connected 1 – camera is connected Actual unit time in Unix time format (number of seconds elapsed since 1970-01-01 midnight) Counter of reports from IS. Firmware version (major).
U8
Firmware version (minor).
U16
Firmware revision
9
10
Item FLG LEN ID SEQ LIFETIME
Type U16 U16 U16 U16 U8
STATE
U8 bit#0 bit#1
ERROR
Value 0x0000 24 0x0703 0 to 255
1 0 1
bit#2 to 7 U8 0.bit 1.bit 2.bit
29 30
Při výskytu chyby dojde k nastavení bitu příslušné chyby (Device temperature out of range nebo Fatal disk error) a zároveň vždy k nastavení General error.
ks-26t_ms_cz_103
12/14
KS-26T Příklad 101b (0x5h) - Fatal disk error
011b (0x3h) - Device temperature out of range 111b (0x7h) - Fatal disk error a Device temperature out of range
13/14
ks-26t_ms_cz_103
KS-26T
7.
Přiřazení streamů Přiřazení streamů k zařízení, které ho zpracovává, a jeho parametry jsou uvedeny níže. Přiražení platí pro programovou sadu 150320_KS-26T a vyšší. Změna může být provedena novější verzí dokumentu.
7.1. Moxa VPort P06 Profil 1 - 640x400@3fps - záznamová jednotka. Profil 2 - 640x400@20fps - IP monitor a displej nadřazeného řízení1 (zobrazení 1x1). Profil 3 - 400x300@16fps - IP monitor (zobrazení 2x1).
7.2. Vivotek MD8562 Profil 1 - 512x320@15fps - IP monitor (zobrazení 1x1 + 2x1). Profil 2 - Nevyužívá se. Profil 3 - 640x480@3fps - záznamová jednotka. Profil 4 - 640x360@25fps - displej nadřazeného řízení.
1
Profil nesmí být současně zobrazen na Displeji nadřazeného řízení a IP monitoru. Logika zajišťující, že k současnému zobrazení nedojde, je součástí programového vybavení Displeje nadřazeného řízení.
ks-26t_ms_cz_103
14/14
