Komunikační rozhraní Programátorská příručka Verze 1.01 ks-variolf_ms_cz_101
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) 2011, 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-variolf_ms_cz_101 2/13
Obsah Historie revizí... 4 Související dokumentace... 4 1. Úvod... 5 2. Popis funkce... 6 3. Konfigurace ethernetové sítě... 8 3.1. Vario LF+... 8 3.2. Vario LFR.S... 8 4. Komunikace... 10 4.1. Komunikace DISPLEJ-RRCPU... 10 4.1.1 Data přijímaná z DISPLEJE (DISPLEJ vysílá do RRCPU)... 10 4.1.2 Data posílaná do DISPLEJE (RRCPU vysílá do DISPLEJ)... 10 4.1.3 Pole D_ErrKod... 11 4.2. Komunikace RRCPU-AIPML... 11 4.2.1 Data přijímaná z RRCPU (RRCPU vysílá do AIPML)... 11 4.2.2 Data posílaná do RRCPU (AIPML vysílá do RRCPU)... 12 4.2.3 Pole A_ErrKod... 12 5. ID scén... 13 3/13 ks-variolf_ms_cz_101
Historie revizí Jméno dokumentu: ks-variolf_ms_cz_101.pdf Autor: Václav Krčmář Verze Datum Změny 100 12. 02. 2013 Nový dokument 101 21. 03. 2013 Doplněna: konfigurace sítě, rezervovaní hostname, id scén. Související dokumentace 1. Montážní příručka KS-VARIOLF soubor: ks-variolf_mm_xxx.pdf ks-variolf_ms_cz_101 4/13
1. Úvod Dokument popisuje komunikační rozhraní kamerového systému vozů Vario LFR.S/LF+. 5/13 ks-variolf_ms_cz_101
2. Popis funkce Kamerový systém se skládá z: IP kamer Levého IP monitoru master monitor (AIMPL) Pravého IP monitoru (AIPMP) Řídicí jednotky kamerového systému (RRCPU) Záznamová jednotka (PPM) PoE switche Ovládání kamerového systému je závislé na typu vozu. Ve vozech Vario LF+ je k ovládání využit displej APT8000 (DISPLEJ). Naopak ve vozech Vario LFR.S jsou k ovládání využita tlačítka připojená na DI vstupy RRCPU. Mezi monitorem AIPML a AIPMP probíhá periodická komunikace. Monitor AI- PML plní funkci master monitoru komunikuje s řídicí jednotkou kamerového systému (RRCPU) a řídí činnost slave monitoru AIPMP. Volba scény a podsvitu probíhá z Ovládacích tlačítek (Vario LFR.S) nebo DIS- PLEJE (Vario LF+). RRCPU informace o volbě scény a podsvitu pouze přijme a předává master monitoru AIPML. Vyšší prioritu má ovládání z DISPLEJE, tlačítka jsou čtena až při chybějící komunikaci RRCPU-DISPLEJ. Obr. 1 - Ovládání systému RRCPU zároveň slouží jako DHCP server vozu. Záznamová jednotka v tomto kamerovém systému není vybavena komunikací, pouze zaznamenává obraz z kamer vozu, na kterém je instalována. ks-variolf_ms_cz_101 6/13
Spojování vozů Oba typy vozů mohou být provozovány samostatně nebo ve spřaženém režimu (dva vozy). První nebo samostatný vůz označujeme jako tažný vůz. Druhý vůz soupravy pak jako vlečený. Ve vlečeném voze jsou deaktivovány IP monitory a RRCPU vlečeného vozu přechází do slave režimu (volba vstupem AI01). 7/13 ks-variolf_ms_cz_101
3. Konfigurace ethernetové sítě 3.1. Vario LF+ Tažný vůz Oba typy vozů jsou vybaveny DHCP serverem, který je součástí Řídicí jednotky kamerového systému a na základě tabulky přiděluje IP adresy ostatním zařízením. Konfigurace sítě se liší pro tažný vůz a vlečený vůz. Zařízení IP adresa Palubní počítač 192.198.1.50 Displej 192.168.1.52 Řídicí jednotka kamerového systému 192.168.1.250 Záznamová jednotka 192.168.1.10 Levý monitor (master) 192.168.1.11 Pravý monitor (slave) 192.168.1.12 Kamera (1. dveře) 192.168.1.1 Kamera (2. dveře) 192.168.1.2 Kamera (3. dveře) 192.168.1.3 Kamera (salón) 192.168.1.4 Vlečený vůz Zařízení IP adresa Palubní počítač 192.198.1.66 Displej 192.168.1.68 Řídicí jednotka kamerového systému 192.168.1.31 Záznamová jednotka 192.168.1.26 Levý monitor (master) Vypnuto napájení Pravý monitor (slave) Vypnuto napájení Kamera (1. dveře) 192.168.1.17 Kamera (2. dveře) 192.168.1.18 Kamera (3. dveře) 192.168.1.19 Kamera (salón) 192.168.1.20 3.2. Vario LFR.S Tažný vůz Vlečený vůz Zařízení IP adresa Řídicí jednotka kamerového systému 192.168.1.250 Záznamová jednotka 192.168.1.10 Levý monitor (master) 192.168.1.11 Pravý monitor (slave) 192.168.1.12 Kamera (1. dveře) 192.168.1.1 Kamera (2. dveře) 192.168.1.2 Kamera (3. dveře) 192.168.1.3 Kamera (salón) 192.168.1.4 Zařízení IP adresa Řídicí jednotka kamerového systému 192.168.1.31 Záznamová jednotka 192.168.1.26 Levý monitor (master) Vypnuto napájení Pravý monitor (slave) Vypnuto napájení ks-variolf_ms_cz_101 8/13
Kamera (1. dveře) 192.168.1.17 Kamera (2. dveře) 192.168.1.18 Kamera (3. dveře) 192.168.1.19 Kamera (salón) 192.168.1.20 3.3. Rezervované hostname DHCP serveru Seznam rezervovaných hostname pro konfiguraci DHCP serveru RRCPU4-901. Tažný vůz Vlečený vůz Zařízení IP adresa Hostname Palubní počítač 192.198.1.50 FFFFFFDM1 Displej A 192.168.1.52 FFFFFFDA1 Displej B 192.168.1.53 FFFFFFDB1 Řídicí jednotka kamerového systému 192.168.1.250 FFFFFFRRC Záznamová jednotka 192.168.1.10 FFFFFFPPM Levý monitor (master) 192.168.1.11 FFFFFFAP1 Pravý monitor (slave) 192.168.1.12 FFFFFFAP2 Kamera (1. dveře) 192.168.1.1 FFFFFFC01 Kamera (2. dveře) 192.168.1.2 FFFFFFC02 Kamera (3. dveře) 192.168.1.3 FFFFFFC03 Kamera (salón) 192.168.1.4 FFFFFFC04 Zařízení IP adresa Hostname Palubní počítač 192.198.1.66 000000DM1 Displej A 192.168.1.68 000000DA1 Displej B 192.168.1.69 000000DB1 Řídicí jednotka kamerového systému 192.168.1.31 000000RRC Záznamová jednotka 192.168.1.26 000000PPM Levý monitor (master) Vypnuto napájení Pravý monitor (slave) Vypnuto napájení Kamera (1. dveře) 192.168.1.17 000000C01 Kamera (2. dveře) 192.168.1.18 000000C02 Kamera (3. dveře) 192.168.1.19 000000C03 Kamera (salón) 192.168.1.20 000000C04 9/13 ks-variolf_ms_cz_101
4. Komunikace V kamerovém systému probíhá následující ethernetová komunikace: DISPLEJ-RRCPU RRCPU-AIPM Porty 61500-61999 jsou vyhrazeny pro vnitřní účely kamerového systému. Komunikace probíhá protokolem UDP. Datové pole UDP je popsáno v následujících dvou kapitolách. Komunikace probíhá periodicky z obou stran, nejde tedy o typ dotaz-odpověď. Perioda je 500 ms. V případě, že je nutné interpretovat vícebajtové číslo, pak je uloženo ve formátu Little Endian. 4.1. Komunikace DISPLEJ-RRCPU DISPLEJ komunikuje s RRCPU. Komunikace obsahuje volbu scény obou monitorů a nastavení jejich podsvitu. Komunikace probíhá na portu 60556. 4.1.1 Data přijímaná z DISPLEJE (DISPLEJ vysílá do RRCPU) Název proměnné Délka (bit) Popis D_Lifetime 8 Čítač (0 255). Byte v každé zprávě je inkrementován. D_Monitor1_Podsvit 8 Stupeň intenzity podsvitu na Levém monitoru (v procentech). typ unsigned, povolené hodnoty: 0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100 D_Monitor2_Podsvit 8 Stupeň intenzity podsvitu na Pravém monitoru (v procentech). typ unsigned, povolené hodnoty: 0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100 D_KameraMonitor1 8 ID scény, kterou zobrazí Levý monitor. D_KameraMonitor2 8 ID scény, kterou zobrazí Pravý monitor. B_Servis 1 Aktivace (1) / deaktivace (0) diagnostiky na straně RRCPU. Rezerva 7 Rezerva 4.1.2 Data posílaná do DISPLEJE (RRCPU vysílá do DISPLEJ) Název proměnné Délka (bit) Popis D_Lifetime 8 Čítač (0 255). Byte v každé zprávě je inkrementován. Posílá se vždy. D_KameraMonitor1_Ind 8 ID scény, kterou zobrazuje Levý monitor. Posílá se vždy. D_KameraMonitor2_Ind 8 ID scény, kterou zobrazuje Pravý monitor. ks-variolf_ms_cz_101 10/13
4.1.3 Pole D_ErrKod Posílá se vždy. Rezerva 24 Rezerva D_VerzeSW 16 Verze SW - KS Posílá se, když B_Servis=1. D_ErrKod 32 Chybový kód. Posílá se, když B_Servis=1. Název proměnné Délka (bit) Popis B_Vystr 1 bit 0 (LSB) (první bit chybového kódu) Výstraha KS B_Err 1 Porucha KS B_Monitor1_TeplErr 1 Teplota levého monitoru mimo rozsah B_Monitor2_TeplErr 1 Teplota pravého monitoru mimo rozsah B_Monitor1_Err 1 Porucha levého monitoru B_Monitor2_Err 1 Porucha pravého monitoru B_SW_Err 1 Nesoulad SW v levém a pravém monitoru Rezerva 9 Rezerva B_Kam1_Err 1 Porucha kamery 1 B_Kam2_Err 1 Porucha kamery 2 B_Kam3_Err 1 Porucha kamery 3 B_Kam4_Err 1 Porucha kamery 4 B_Kam5_Err 1 Porucha kamery 5 B_Kam6_Err 1 Porucha kamery 6 B_Kam7_Err 1 Porucha kamery 7 B_Kam8_Err 1 Porucha kamery 8 Rezerva 8 Rezerva Bit B_Vystr se nastavuje v případě teploty mimo rozsah, ve všech ostatních případech chyby se nastavuje bit B_Err. 4.2. Komunikace RRCPU-AIPML RRCPU komunikuje s AIPML. Komunikace obsahuje volbu scény obou monitorů a nastavení jejich podsvitu. Komunikace probíhá na portu 60555. 4.2.1 Data přijímaná z RRCPU (RRCPU vysílá do AIPML) Název proměnné Délka (bit) Popis A_Lifetime 8 Čítač (0 255). Byte v každé zprávě je inkrementován. A_Monitor1_Podsvit 8 Stupeň intenzity podsvitu na Levém monitoru (v procentech). typ unsigned, povolené hodnoty: 0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100 A_Monitor2_Podsvit 8 Stupeň intenzity podsvitu na Pravém monitoru (v procentech). typ unsigned, povolené hodnoty: 11/13 ks-variolf_ms_cz_101
0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100 A_KameraMonitor1 8 ID scény, kterou zobrazí Levý monitor. A_KameraMonitor2 8 ID scény, kterou zobrazí Pravý monitor. B_Servis 1 Aktivace (1) / deaktivace (0) diagnostiky na straně AIPML. Rezerva 7 Rezerva 4.2.2 Data posílaná do RRCPU (AIPML vysílá do RRCPU) 4.2.3 Pole A_ErrKod Název proměnné Délka (bit) Popis A_Lifetime 8 Čítač (0 255). Byte v každé zprávě je inkrementován. Posílá se vždy. A_KameraMonitor1_Ind 8 ID scény, kterou zobrazuje Levý monitor. Posílá se vždy. A_KameraMonitor2_Ind 8 ID scény, kterou zobrazuje Pravý monitor. Posílá se vždy. Rezerva 24 Rezerva. A_VerzeSW 16 Verze SW - KS Posílá se, když B_Servis=1. A_ErrKod 32 Chybový kód. Posílá se, když B_Servis=1. Název proměnné Délka (bit) Popis B_Vystr 1 bit 0 (LSB) (první bit chybového kódu) Výstraha KS B_Err 1 Porucha KS B_Monitor1_TeplErr 1 Teplota levého monitoru mimo rozsah B_Monitor2_TeplErr 1 Teplota pravého monitoru mimo rozsah B_Monitor1_Err 1 Porucha levého monitoru B_Monitor2_Err 1 Porucha pravého monitoru B_SW_Err 1 Nesoulad SW v levém a pravém monitoru Rezerva 9 Rezerva B_Kam1_Err 1 Porucha kamery 1 B_Kam2_Err 1 Porucha kamery 2 B_Kam3_Err 1 Porucha kamery 3 B_Kam4_Err 1 Porucha kamery 4 B_Kam5_Err 1 Porucha kamery 5 B_Kam6_Err 1 Porucha kamery 6 B_Kam7_Err 1 Porucha kamery 7 B_Kam8_Err 1 Porucha kamery 8 Rezerva 8 Rezerva Bit B_Vystr se nastavuje v případě teploty mimo rozsah, ve všech ostatních případech chyby se nastavuje bit B_Err. ks-variolf_ms_cz_101 12/13
5. ID scén ID scény, které je hodnotou proměnných A_KameraMonitorX, D_KameraMonitorX, A_KameraMonitorX_Ind, D_KameraMonitor1. ID Scény Kamera Symbol zobrazený na IP monitoru 0 - Černá obrazovka, bez symbolu. 1 Kamera 1, vůz 1 1 2 Kamera 2, vůz 1 2 3 Kamera 3, vůz 1 3 4 Kamera 4, vůz 1 4 5 Kamera 1, vůz 2 5 6 Kamera 2, vůz 2 6 7 Kamera 3, vůz 2 7 8 Kamera 4, vůz 2 8 9 1, 2, 0, 0 Mozaika 4x4: 1, 2, černá, černá 10 3, 4, 0, 0 Mozaika 4x4: 3, 4, černá, černá 11 1, 2, 5, 6 Mozaika 4x4: 1, 2, 5, 6 12 3, 4, 7, 8 Mozaika 4x4: 3, 4, 7, 8 13/13 ks-variolf_ms_cz_101