Kamerový systém Programátorská příručka Verze 1.03 ks-26t_ms_cz_103
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: support@amit.cz ks-26t_ms_cz_103 2/14
Obsah Historie revizí... 4 Související dokumentace... 4 1. Úvod... 5 2. Konfigurace systému... 6 3. Konfigurace kamer... 7 3.1. Moxa VPort P06... 7 3.2. Vivotek MD8562... 7 4. Orientace kamer při volbě aktivního stanoviště... 8 4.1. Moxa VPort P06... 8 4.2. Vivotek MD8562... 8 5. Bezpečnostní funkce... 9 5.1. Základní informace... 9 5.2. Implementované bezpečnostní funkce... 9 5.2.1 Signalizace neplatného obrazu na LCD displeji... 10 5.2.2 Detekce statického obrazu kontrolní součet... 10 5.2.3 Detekce statického/zpožděného obrazu... 10 5.2.4 Kontrola časování synchronizačních signálů LCD displeje... 11 5.2.5 Detekce chybného chování video procesoru... 11 5.2.6 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. Moxa VPort P06... 14 7.2. Vivotek MD8562... 14 3/14 ks-26t_ms_cz_103
Historie revizí Jméno dokumentu: ks-26t_ms_cz_103.pdf Autor: Václav Krčmář Verze Datum Změny 100 07. 10. 2013 Nový dokument 101 28. 04. 2014 Popis bezpečnostní funkce monitoru KS pro verzi FW DP V1.20 102 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. 103 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
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
2. Konfigurace systému Komponenta IP adresa Monitor A levý 192.168.53.201 Monitor A pravý 192.168.53.202 Displej NŘ A 192.168.53.2 Monitor B levý 192.168.53.203 Monitor B pravý 192.168.53.204 Displej NŘ B 192.168.53.3 Záznamová jednotka 192.168.53.205 Kamera 1 192.168.53.211 Kamera 2 192.168.53.213 REZERVA 192.168.53.212 REZERVA 192.168.53.214 Kamera 3 192.168.53.219 Kamera 4 192.168.53.220 Kamera 5 192.168.53.221 Kamera 6 192.168.53.222 Kamera 7 192.168.53.225 Kamera 8 192.168.53.224 Kamera 9 192.168.53.223 Kamera 10 192.168.53.217 Kamera 11 192.168.53.215 REZERVA** 192.168.53.218 REZERVA** 192.168.53.216 Obr. 1 - Rozmístěná kamer na voze ks-26t_ms_cz_103 6/14
3. Konfigurace kamer 3.1. Moxa VPort P06 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. Dotaz na verzi ve formátu: http://<ip_address>/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 3.2. Vivotek MD8562 označuje konfiguraci 217 poslední oktet IP adresy 105 verze konfiguračního souboru Dotaz na verzi ve formátu: http://<ip_address>/cgi-bin/admin/getparam.cgi?videoin_text Odpověď ve formátu: videoin_text='ks-26t_md8562_cfg_105' kde ks-26t md8562 cfg identifikace projektu typ kamery označuje konfiguraci 105 verze konfiguračního souboru 7/14 ks-26t_ms_cz_103
4. Orientace kamer při volbě aktivního stanoviště 4.1. Moxa VPort P06 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ě. Příkaz sloužící ke změně orientace obrazu: kde 0 4.2. Vivotek MD8562 http://<ip_address>/moxa-cgi/setparam.cgi?imagetuning_appearance=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) Příkaz sloužící ke změně orientace obrazu: http://<ip_address>/cgi-bin/admin/setparam.cgi?videoin_flip=0&videoin_mirror=0 kde videoin_flip videoin_mirror zrcadlení podle osy x (0=ne, 1=ano) zrcadlení podle osy y (0=ne, 1=ano) ks-26t_ms_cz_103 8/14
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 obraz kamery, čas kamery VP plná černá přepínač LCD 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
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 5.2.1 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
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
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 Item Type Value Meaning 0 FLG U16 0x0000 Frame type 2 LEN U16 24 Payload length in bytes 4 ID U16 0x0703 TxRU-RxCU frame type identifier 6 SEQ U16 Ignored. 8 LIFETIME U8 0 to 255 Incrementing counter, indication of IPM activity. 9 STATE U8 Bit-coded report. bit#0 1 SOS event activation. bit#1 0 Recording is ON 1 Recording is OFF due to CU request. bit#2 to 7 Reserved 10 ERROR U8 Indication of RU internal error. 0.bit General error (0-no error, 1-error) 1.bit 2.bit Device temperature out of range Fatal disk error (disk does not exist, error in mounting) 11 RESERVED U8 Reserved for future use. 12 CAMS U32 Individual camera record bit-array. 0 recording is OFF 1 recording is ON 16 CAMS_MASK U32 Connected camera bit-array. 0 camera is not connected 1 camera is connected 22 TIME U32 Actual unit time in Unix time format (number of seconds elapsed since 1970-01-01 midnight) 26 IS_COUNTER U32 Counter of reports from IS. 28 FIRMWARE_ MAJOR 29 FIRMWARE_ MINOR 30 FIRMWARE_ REVISION U8 U8 U16 Firmware version (major). Firmware version (minor). Firmware revision 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
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
7. Přiřazení streamů 7.1. Moxa VPort P06 7.2. Vivotek MD8562 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. 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). 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