VAIZDO KAMERŲ PRIEŽIŪROS, VAIZDO ĮRAŠŲ UŽSAKYMO
PROGRAMINĖ ĮRANGA
V0.0.1
Objektai ................................................................................................................................................... 3
Duomenų laukai .................................................................................................................................. 3
Informacijos lentelė ............................................................................................................................ 4
Pranešimai........................................................................................................................................... 4
Pranešimų nustatymai .................................................................................................................... 5
Kameros .................................................................................................................................................. 6
Duomenų laukai .................................................................................................................................. 7
Konfigūravimas ................................................................................................................................... 7
Informacinės žinutės ........................................................................................................................... 9
Sistemos klaidų informacija .............................................................................................................. 10
Įrašo užsakymo užklausos ................................................................................................................. 11
Ištrynimas .......................................................................................................................................... 12
Vaizdo įrašų užsakymas......................................................................................................................... 13
Duomenų laukai ................................................................................................................................ 13
Užsakymo būsenos ............................................................................................................................ 14
Įrašo atsisiuntimas ............................................................................................................................ 15
Kamerų klaidos ...................................................................................................................................... 16
Vartotojai .............................................................................................................................................. 17
Duomenų laukai ................................................................................................................................ 17
Nustatymai ............................................................................................................................................ 18
Duomenų laukai ................................................................................................................................ 18
Objektai
Norint prie sistemos pridėti naują objektą, reikia atlikti šiuos žingsnius:
1) Web sąsajoje, kairiame meniu lauke pasirinkti „Objects“ opciją.
2) Atsidariusiame lange paspausti ant mygtuko „Create Object“.
3) Užpildyti formos duomenų laukus ir spustelti „Create“ mygtuką.
Duomenų laukai
Label Objekto pavadinimas
Reference ID Objekto numeris, naudojamas susiejimui su
išorinėmis sistemomis
Informacijos lentelė
Has Trip Nurodoma ar objektui yra priskirtas reisas
Trip Start Reiso pradžios laikas
Trip End Reiso pabaigos laikas
Currently Sending Aktyvių (siunčiančių informacines žinutes)
kamerų skaičius
Last Message Pasukinės žinutės, gautos iš objekto kamerų,
laikas
Pranešimai
Pranešimai – el. laiškai, kurie siunčiami esant galimiems vaizdo sistemos sutrikimams. Sutrikimu
laikoma tuomet, kai objekto kameros, per “Threshold” laukelyje nurodytą laiką nuo objekto reiso
pradžios, neatsiunčia nė vienos informacinės žinutės į serverį.
Norint įjungti/išjungti pranešimus, “Objects” puslapyje reikia paspausti ant mygtuko “Notifications”.
Pranešimų nustatymai
Enabled Pranešimai aktyvuoti/išjungti
Threshold Laiko slenkstis (minutėmis) nuo reiso pradžios,
kuomet pradedama tikrinti ar nėra sutrikimų.
Minimali reikšmė – 10 minučių (nes informacinių
žinučių siuntimo intervalas yra 10 minučių).
Receivers Pranešimų gavėjų el. pašto adresai (atskirti
kableliu).
Subject El. laiško tema, kuri bus rodoma siunčiant
pranešimus.
Message Žinutė, kuri bus serverio užpildoma duomenimis
ir siunčiama visiems nurodytiems gavėjams.
Host SMTP serverio IP adresas.
Port SMTP serverio prievadas.
Sender El. pašto adresas, iš kurio bus siunčiami
pranešimai.
Password SMTP serverio slaptažodis.
Kameros
Norint prie sistemos pridėti naują kamerą, reikia atlikti šiuos žingsnius:
1) Web sąsajoje, kairiame meniu lauke pasirinkti „Cameras“ opciją.
2) Atsidariusiame lange paspausti ant mygtuko „Create Camera“.
3) Užpildyti formos duomenų laukus su kameros informacija ir spustelti „Create“ mygtuką.
Duomenų laukai
Label Kameros pavadinimas
Object Objektas, kuriam bus priskirta kamera
Host IP adresas, kuriuo būtų pasiekiama kamera
Port Prievadas, kuriuo būtų pasiekiama kameros WEB
sąsaja
GSM Host GSM IP adresas, kuriuo būtų pasiekiama kamera
GSM Port GSM prievadas, kuriuo būtų pasiekiama kameros
WEB sąsaja
Username Kameros prisijungimo vardas
Password Kameros prisijungimo slaptažodis
Before Offset (min.) Vaizdo įrašo pradžios laiko poslinkis (minutėmis)
nuo tada, kada buvo atsiųstas kameros
automatiškai sugeneruotas įrašo užsakymas
After Offset (min.) Vaizdo įrašo pabaigos laiko poslinkis (minutėmis)
nuo tada, kada buvo atsiųstas kameros
automatiškai sugeneruotas įrašo užsakymas
Use GSM on jobs triggered by the camera Naudoti GSM prisijungimo duomenis vaizdo
įrašui atsisiųsti, kuomet įrašo užsakymą
automatiškai sugeneruoja pati kamera
Use HTTPS Naudoti HTTPS protokolą siunčiant užklausas į
kamerą
Konfigūravimas
Kiekviena, per vartotojo sąsają pridėta kamera, yra automatiškai sukonfigūruojama iš serverio pusės.
Konfigūracija atliekama keliais žingsniais:
1) Patikrinami prisijungimo duomenys
2) Nuskaitoma kameros informacija (kameros tipas, serijos nr., programinės įrangos versija,
laiko juosta ir pan.)
3) Sugeneruojamas unikalus slaptažodis, leidžiantis kamerai atlikti užklausas į serverį
4) Atliekant HTTP/HTTPS POST užklausą į kamerą (/admin/remoteconfig), perduodami nauji
konfigūracijos duomenys:
helo
write params
ipnotify/ip_health/profile=ip_health:_profilename=cam-
info:preset=custom:ackn_time=60:pushprofile=:pushmessage=$(ID.NAM)%3A
$(TMS):ipnotifyaddress=192.168.2.101%3A9090:send=parallel:protocol=http10:boundary=--
next-image--
:httppath=/camera/info/$(ID.FIP):httpauth=10.1.1.223%3A95ee4e2458e8651c54238507b9f
88d12:data=msg:ipnotifymessage=factory_ip%3D%24(ID.FIP)%0Ahostname%3D%24(ID.NA
M)%0Afirmware%3D%24(ID.SWV)%0Amodel%3D%24(IMG.CTY)%0Acurrent_time%3D%24(F
PR.TIMESTAMP)%0Atime_zone%3D%24(TMS.ZONE)%0Auptime%3D%24(ID.UPT)%0Aint_te
mp%3D%24(SEN.TIN.CELSIUS)%0Abuffer_fill%3D%24(STORAGE.BUFFERFILL.CURRENT)%0As
ensors%3D%24(IMG.CAM)%0Aillumination_r%3D%24(SEN.LXR)%0Aillumination_l%3D%24(S
EN.LXL)%0Aevent_number%3D%24(FINGERPRINT.EVENT):filetype=mxg:rate100=100:anteti
me=1:posttime=1:systime=0:statprof=:heatprof=:ipnotifyport=0
ipnotify/ip_schedule_job/profile=ip_schedule_job:_profilename=cam-schedule-
job:preset=custom:ackn_time=60:pushprofile=:pushmessage=$(ID.NAM)%3A
$(TMS):ipnotifyaddress=192.168.2.101%3A8001:send=parallel:protocol=http10:boundary=--
next-image--
:httppath=/camera/input/$(ID.FIP):httpauth=10.1.1.223%3A95ee4e2458e8651c54238507b9
f88d12:data=msg:ipnotifymessage=time%3D$(FPR.TIT)%0Afactory_ip%3D$(ID.FIP):filetype=
mxg:rate100=100:antetime=1:posttime=1:systime=0:statprof=:heatprof=:ipnotifyport=0
ipnotify/ip_errors/profile=ip_errors:_profilename=cam-
errors:preset=custom:ackn_time=60:pushprofile=:pushmessage=$(ID.NAM)%3A
$(TMS):ipnotifyaddress=192.168.2.101%3A9091:send=parallel:protocol=http10:boundary=--
next-image--
:httppath=/camera/errors/$(ID.FIP):httpauth=10.1.1.223%3A95ee4e2458e8651c54238507b
9f88d12:data=sysmsg:ipnotifymessage=:filetype=mxg:rate100=100:antetime=1:posttime=1:
systime=5:statprof=:heatprof=:ipnotifyport=0
systemalarm/logscan_alarm_notify_ip=ip_errors
ipnotify/ip_ams/profile=ip_ams:_profilename=cam-
ams:preset=custom:ackn_time=60:pushprofile=:pushmessage=:ipnotifyaddress=192.168.2.1
01%3A9092:send=parallel:protocol=http10:boundary=--next-image--
:httppath=/camera/alarms/$(ID.FIP):httpauth=10.1.1.223%3A95ee4e2458e8651c54238507b
9f88d12:data=clip:ipnotifymessage=Hello World! I'm $(ID.NAM) with event
$(FPR.ENO).:filetype=mxg:rate100=100:antetime=2:posttime=2:imgprof=:systime=0:statprof
=:heatprof=:ipnotifyport=0
write
SECTION timetasks
CRON=0:1:*:*:0:RandomReboot:
CRON=5,15,25,35,45,55:*:*:*:*:IPNOTIFY-ip_health:
ENDSECTION timetasks
update
store
quit
Informacinės žinutės
Kiekviena sukonfigūruota kamera, kas 10 minučių, privalo pranešti serveriui apie savo veikimo
būseną. Visose siunčiamose žinutėse turi būti pateikti šie laukai:
- Serijos numeris (factory_ip)
- Kameros pavadinimas (hostname)
- Programinės įrangos versija (firmware)
- Kameros tipas (model) – galimos reikšmės: MONO, DUAL
- Kameros laikas (current_time)
- Laiko juosta (time_zone)
- Veikimo laikas (uptime)
- Vidinė temperatūra (int_temp)
- Buferio užpildymas (buffer_fill)
- Naudojamas sensorius (sensors) – galimos reikšmės: RIGHT, LEFT, BOTH
- Kairio sensoriaus apšvietimo lygis (illumination_r) – jei naudojamas tik dešinysis sensorius,
reikšmė paliekama tuščia
- Dešinio sensoriaus apšvietimo lygis (illumination_l) – jei naudojamas tik kairysis sensorius,
reikšmė paliekama tuščia
- Paskutinio įvykio numeris (event_number)
Duomenų pateikimo formatas:
<parametras>=<reikšmė>%0A<paramertras>=<reikšmė>%0A...
Žinutė persiunčiama atliekant HTTP GET užklausą į:
http://{serverio_ip}:{informacijos_ivesties_prievadas}/camera/info/{serijos_nr}?{duomenys}
Pastaba: informacijos įvesties prievadas priklauso nuo pačio serverio nustatymų, numatytasis
prievadas yra 9090
Atliekant užklausą, privaloma pateikti „Authorization“ HTTP antraštę su kameros prisijungimo
duomenimis. Užklausos pavyzdys:
GET
/camera/info/10.1.1.223?factory_ip=10.1.1.223%0Ahostname=OUTDOOR_CAM%0Afirmware=MX-
V5.2.4.15%0Amodel=MONO%0Acurrent_time=2018-06-
11%2011:12:53.168%0Atime_zone=EEST%0Auptime=294853%0Aint_temp=+18.3%0Abuffer_fill=%2
0%200%0Asensors=RIGHT%0Aillumination_r=%20%20%2071.6%0Aillumination_l=%0Aevent_numbe
r=001182 HTTP/1.0
Authorization: Basic
MTAuMS4xLjIyMzo5NWVlNGUyNDU4ZTg2NTFjNTQyMzg1MDdiOWY4OGQxMg==
Host: 192.168.2.101:9090
User-Agent: mxmsg/2.2 (OUTDOOR_CAM; 10.1.1.223; MX-V5.2.4.15)
Accept: */*
Sistemos klaidų informacija
Esant tinkamoms sąlygoms, kiekviena sukonfigūruota kamera, privalo persiųsti vidines kritines
klaidas į centrinį serverį.
Informacija įkeliama atliekant HTTP POST užklausą į:
http://{serverio_ip}:{klaidu_ivesties_prievadas}/camera/errors/{serijos_nr}
Pastaba: klaidų įvesties prievadas priklauso nuo pačio serverio nustatymų. Numatytasis prievadas:
9091
Visa informacija turi būti peteikiama kaip „multipart/form-data“
(https://www.ietf.org/rfc/rfc2388.txt).
Klaidos eilutės formatas:
{tipas} {data} {laikas} {klaidos_kodas} {zinute}<CRLF>
Klaidų tipai E – nekritinė klaida
C – kritinė klaida
Datos formatas YYYY-MM-DD
Laiko formatas hh:mm:ss
Klaidų kodai BOOT, CONCIERGE, CONFIG, DOT1X, DYNDNS,
EMAIL, EVENT, FTP, IPMSG, IMG-LNK, MXBUS,
MXM, STATUS, STORAGE, STREAM, VOIP
Atliekant užklausą, privaloma pateikti „Authorization“ HTTP antraštę su kameros prisijungimo
duomenimis. Užklausos pavyzdys:
POST /camera/errors/10.1.1.223 HTTP/1.0
Authorization: Basic
MTAuMS4xLjIyMzo5NWVlNGUyNDU4ZTg2NTFjNTQyMzg1MDdiOWY4OGQxMg==
Host: 192.168.2.101:9091
User-Agent: mxmsg/2.2 (OUTDOOR_CAM; 10.1.1.223; MX-V5.2.4.15)
Accept: */*
Content-Type: multipart/form-data; boundary="mxmsg_qswteervteuliaodpj9a7b5i3_20050405"
--mxmsg_qswteervteuliaodpj9a7b5i3_20050405
Content-Disposition: form-data; name="file"; filename="/tmp2/sysmsg13423.txt"
Content-Type: text/plain
Content-Length: 450
E 2018-06-11 06:55:19 IPMSG cam-info[8796] No route to host 192.168.2.101!
E 2018-06-11 07:05:19 IPMSG cam-info[8953] No route to host 192.168.2.101!
E 2018-06-11 07:15:20 IPMSG cam-info[9092] No route to host 192.168.2.101!
E 2018-06-11 07:25:20 IPMSG cam-info[9233] No route to host 192.168.2.101!
E 2018-06-11 07:35:20 IPMSG cam-info[9381] No route to host 192.168.2.101!
E 2018-06-11 07:45:20 IPMSG cam-info[9522] No route to host 192.168.2.101!
--mxmsg_qswteervteuliaodpj9a7b5i3_20050405--
Įrašo užsakymo užklausos
Priklausomai nuo kameros nustatymų, egzistuoja galimybė atlikti vaizdo įrašo užsakymą iš pačio
įrenginio. Tam atlikti, turi būti atliekama HTTP GET užklausa adresu:
http://{serverio_ip}:{uzklausos_ivesties_prievadas}/camera/input/{serijos_nr}?time={unix_laikas}
%0Afactory_ip={serijos_nr}
Pastaba: užklausos įvesties prievadas priklauso nuo pačio serverio nustatymo. Numatytasis
prievadas: 8001
Atliekant užklausą, privaloma pateikti „Authorization“ HTTP antraštę su kameros prisijungimo
duomenimis. Užklausos pavyzdys:
GET /camera/input/10.1.1.223?time=1528727346%0Afactory_ip= 10.1.1.223 HTTP/1.0
Authorization: Basic
MTAuMS4xLjIyMzo5NWVlNGUyNDU4ZTg2NTFjNTQyMzg1MDdiOWY4OGQxMg==
Host: 192.168.2.101:8001
User-Agent: mxmsg/2.2 (OUTDOOR_CAM; 10.1.1.223; MX-V5.2.4.15)
Accept: */*
Ištrynimas
Ištrinant kamerą per vartotojo sąsają, serveris lygiagrečiai atlieka nustatymų pašalinimą iš pačio
įrenginio. Vykdoma HTTP/HTTPS POST užklausa į kamerą(/admin/remoteconfig), perduodant
duomenis:
helo
delete params
ipnotify/ip_errors/profile
ipnotify/ip_health/profile
ipnotify/ip_ams/profile
systemalarm/logscan_alarm_notify_ip
ipnotify/ip_schedule_job/profile
update
store
quit
Vaizdo įrašų užsakymas
Norint sistemoje sukurti naują vaizdo įrašo užsakymą, reikia atlikti šiuos žingsnius:
1) Web sąsajoje, kairiame meniu lauke pasirinkti “Video Requests” opciją.
2) Atsidariusiame lange paspausti ant mygtuko “Create Video Request”.
3) Užpildyti formos duomenų laukus ir spustelėti “Create” mygtuką.
Duomenų laukai
Object Objektas
Cameras Objekto kameros, iš kurių norima atsisiųsti
vaizdo įrašus
Start Įrašo pradžios laikas
End Įrašo pabaigos laikas
Details Trumpas vaizdo įrašo užsakymo aprašymas
Use GSM if needed Leisti serveriui naudoti GSM prisijungimo
duomenis, jei kameros nepasiekiamos
numatytais prisijungimais
Užsakymo būsenos
Pastaba: po kiekvieno mėlynai pažymėtos klaidos būsenos atnaujinomo, serveryje nustatomas 15
minučių uždelsimas prieš bandant atsisiųsti įrašą iš naujo. Kiekviena užklausa yra vykdoma tol, kol
pavyksta arba yra ištrinama.
Įrašo užsakymas sukurtas, naujų duomenų nėra:
Objektas nepasiekiamas:
Įvyko klaida bandant atsisiųsti vaizdo įrašą:
Gautas nenumatytas atsakas iš kameros:
Nenumatyta serverio klaida:
Nerasta įvykių atitinkančių nurodytą laiko tarpą:
Kameroje nurodyti tik GSM prisijungimai, bet pildant vaizdo įrašo užsakymo formą, nebuvo
pažymėta varnelė ant “Use GSM if needed”:
Nurodyti neteisingi kameros prisijungimo duomenys:
Įrašo atsisiuntimas
Įrašo atsisiuntimas vykdomas trim žingsniais:
1) Užklausiamas įvykio numeris atitinkantis pradžios laiką:
/control/event.jpg?output=evtinfo_d&searchbytime_start={pradžios_laikas}
2) Užklausiamas įvykio numeris atitinkantis pabaigos laiką:
/control/event.jpg?output=evtinfo_d&searchbytime_start={pabaigos_laikas}
3) Pradedamas siuntimas nurodžius pradžios ir pabaigos įvykius:
/control/events.tar?download&action_download&TailEvent={pradzios_ivykis}&HeadEvent={
pabaigos_ivykis}
Kamerų klaidos
Norint sistemoje peržvelgti kamerų atsiųstus klaidų duomenis, reikia atlikti šiuos žingsnius:
1) Web sąsajoje, kairiame meniu lauke pasirinkti “Errors” opciją.
2) Atsidariusiame lange paspausti ant eilutės su ieškomos kameros pavadinimu.
Vartotojai
Norint sistemoje sukurti naują vartotoją, reikia atlikti šiuos žingsnius:
1) Web sąsajoje, kairiame meniu lauke pasirinkti “Users” opciją.
2) Atsidariusiame lange paspausti ant mygtuko “Create User”.
3) Užpildyti formos duomenų laukus ir spustelėti “Create” mygtuką.
Duomenų laukai
Username Vartotojo prisijungimo vardas
Full Name Pilnas vartotojo vardas
Password Vartotojo prisijungimo slaptažodis
Confirm Password Pakartotas vartotojo prisijungimo slaptažodis
Admin Ar priskirti vartotojui administratoriaus teises
leisiančias redaguoti objektų, kamerų, vartotojų
sąrašus bei keisti sistemos nustatymus
Nustatymai
Norint pakeisti sistemos nustatymus, reikia atlikti šiuos žingsnius:
1) Web sąsajoje, kairiame meniu lauke pasirinkti “Settings” opciją.
2) Užpildyti formos duomenų laukus norimomis reikšmėmis ir spustelėti “Save Settings”
mygtuką.
Duomenų laukai
Remove video requests after Dienų skaičius, po kurio turėtų būti ištrinami
baigti siųsti vaizdo įrašų užsakymai
Remove information messages after Dienų skaičius, po kurio turėtų būti ištrinamos
informacinės žinutės gautos iš kamerų
Remove error messages after Dienų skaičius, po kurio turėtų būti ištrinami
kamerų sisteminių klaidų duomenys
Mark alarms as “cleared” after Dienų skaičius, po kurio neperžvelgti aliarmai
būtų pažymimi kaip “išvalyti”
Remove alarms after Dienų skaičius, po kurio turėtų būti ištrinami
peržvelgti aliarmai