English Română
Start rapid: Acest manual explică cum să configurați și să utilizați sistemul Parking Place Detector. Aplicația monitorizează fluxurile camerelor, detectează vehiculele în locurile de parcare și raportează starea ocupării către sistemul dvs. de administrare.

Cuprins

  1. Introducere
  2. Fereastra Principală
  3. Setări de Configurare
  4. Configurare Flux Cameră
  5. Setări Detecție
  6. Configurare Raportare
  7. Gestionarea Locurilor de Parcare
  8. Depanare
  9. Fișier Configurare INI

1. Introducere

Ce face această aplicație

Sistemul Parking Place Detector este o soluție automată de supraveghere care:

Concepte Cheie

2. Fereastra Principală

Când lansați aplicația, veți vedea fereastra principală care conține mai multe zone importante:

Captură de ecran
Fig.1 Main Interface

2.1 Zona de Afișare Video

Partea principală a ferestrei arată fluxul live al camerei. Aici puteți:

2.2 Indicatoare de Stare Conexiune

Situate sub afișajul video, aceste indicatoare arată:

2.3 Tabelul Locurilor de Parcare

Un tabel care afișează toate locurile de parcare configurate cu — vezi Fig.1 Main Interface (7):

2.4 Rezumat Contoare

În partea de jos, veți vedea trei contoare care afișează — vezi Fig.1 Main Interface (8):

2.5 Butoane de Control

Fereastra principală include aceste butoane de control:

3. Setări de Configurare

Apăsați butonul Settings pentru a deschide panoul de configurare — vezi Fig.1 Main Interface (12).

Captură de ecran
Fig.2 Engine Working Mode & External Trigger

3.1 Engine Working Mode & External Trigger

Această filă controlează modul în care funcționează sistemul de detecție.

Engine Working Mode

Alegeți cum ar trebui să funcționeze motorul de detecție — vezi Fig.2 Engine Working Mode & External Trigger (1):

Trigger Device and Type

Dacă ați selectat modul „Started by TRIGGER", configurați sursa de declanșare — vezi Fig.2 Engine Working Mode & External Trigger (2):

Notă: Când utilizați declanșatoare externe, sistemul ascultă pe portul UDP 3500. Dacă trebuie să rulați mai multe instanțe ale aplicației, fiecare instanță suplimentară utilizează următorul număr de port (3501, 3502 etc.). Numărul portului se calculează astfel: 3500 + App ID-ul dvs.

How Many Seconds to Analyze After Trigger

Când se primește un semnal de declanșare, sistemul va continua să analizeze pentru acest număr de secunde înainte de a se opri. Aceasta permite sistemului să captureze mai multe cadre după evenimentul inițial de declanșare. Această setare apare doar când un dispozitiv și un tip de declanșare sunt selectate. — vezi Fig.3 Seconds.

Captură de ecran
Fig.3 Seconds

Interval valid: 1 până la 65535 secunde

Objects Type

Selectați ce tipuri de obiecte ar trebui să detecteze sistemul — vezi Fig.2 Engine Working Mode & External Trigger (3):

Recognition Enhancement

Această setare controlează cât de amănunțit analizează sistemul fiecare cadru. Setările mai mari înseamnă detecție mai precisă, dar necesită mai mult timp de procesare și resurse de calcul — vezi Fig.2 Engine Working Mode & External Trigger (2):

Bounding Boxes Reduction

Casetele de detecție din jurul obiectelor se pot suprapune uneori. Această setare micșorează casetele pentru a evita suprapunerile false care ar putea cauza citiri incorecte ale ocupării — vezi Fig.2 Engine Working Mode & External Trigger (5):

Bounding Boxes Visible

Alegeți dacă să afișați suprapunerea casetelor de detecție pe videoul live — vezi Fig.2 Engine Working Mode & External Trigger (6):

4. Configurare Flux Cameră

4.1 Input Stream (Camera Principală)

Fila Input Stream configurează camera principală de parcare.

Captură de ecran
Fig.4 Input Stream

Input Stream Type

Selectați tipul de cameră sau sursă video pe care o utilizați. Aplicația suportă multe mărci de camere și protocoale:

Configurare pas cu pas:

  1. Apăsați butonul Settings pe interfața principală — vezi Fig.1 Main Interface (12).
  2. Selectați „Input stream" din categoriile de setări — vezi Fig.4 Input Stream .
  3. Stream Type: Selectați protocolul camerei din lista derulantă — vezi Fig.4 Input Stream (1).
  4. IP Address: Introduceți adresa IP sau hostname-ul camerei (cu sau fără http://) — vezi Fig.4 Input Stream (2).
  5. Port: Introduceți portul HTTP (portul HTTP implicit este de obicei 80), alte protocoale au porturi diferite — vezi Fig.4 Input Stream (3).
  6. Use SSL: Activați dacă camera necesită conexiune securizată — vezi Fig.4 Input Stream (4).
  7. Username/Password: Introduceți datele de autentificare dacă camera este protejată cu parolă — vezi Fig.4 Input Stream (5).
  8. Limit FPS: Setați la 0 pentru nelimitat, sau specificați o rată maximă de cadre — vezi Fig.4 Input Stream (7).

Utilizați fila Companion Stream și completați datele doar dacă o cameră (diferită de cea PPD) este disponibilă în acest scop. Altfel, lăsați câmpurile goale.

Sfat: Ratele mai mari de cadre oferă mai multe oportunități de a captura imagini clare ale vehiculelor care trec. În parcări, 1 FPS sau mai puțin este suficient.

Testarea Configurării Camerei

După configurarea camerei, indicatorul de stare a conexiunii din interfața principală va arăta:

4.2 Companion Stream (Cameră Secundară)

Fila Companion Stream configurează o a doua cameră opțională. Aceasta poate fi utilă pentru:

Opțiunile de configurare sunt identice cu cele din fila Input Stream.

5. Setări Detecție

5.1 Live View

Live View Active

Activați această casetă de bifare pentru a permite transmiterea fluxului către server — vezi Fig.5 Live view (1).

Captură de ecran
Fig.5 Live view

Live View URL

Introduceți adresa web unde ar trebui trimis fluxul. — vezi Fig.5 Live view (2).

Exemplu: http://yourserver.com/io/ppd/live_view.php

6. Configurare Raportare

Fila Reporting configurează modul în care sistemul trimite datele de ocupare către software-ul dvs. de administrare.

Captură de ecran
Fig.6 Reporting

Reporting URL

Introduceți adresa web unde sistemul ar trebui să trimită actualizările de stare a parcării. Acesta este de obicei endpoint-ul API al sistemului dvs. de gestionare a parcării — vezi Fig.6 Reporting (1).

Exemplu: http://your_server.com/io/ppd/new_parking_place_event.php

Reporting - Authkey / ID

Aceste câmpuri identifică instalarea dvs. pe serverul de raportare — vezi Fig.6 Reporting (1).

Aceste valori sunt furnizate de Interfața web Metrici.

Status Change Delay

Această setare previne citirile false când vehiculele trec temporar printr-un loc de parcare — vezi Fig.6 Rep... (3):

Interval valid: 1 până la 65535 secunde

7. Gestionarea Locurilor de Parcare

Locurile de parcare sunt zonele specifice din câmpul vizual al camerei pe care doriți să le monitorizați. Iată cum să le configurați:

Captură de ecran
Fig.7 Add Space

7.1 Adăugarea unui Loc de Parcare Nou

  1. În fereastra principală, găsiți tabelul locurilor de parcare.
  2. Apăsați butonul Add — vezi Fig.1 Main Interface (9).
  3. Un rând nou apare în tabel cu valori implicite — vezi Fig.7 Add Space (4).
  4. Noul loc este selectat automat pentru editare — vezi Fig.7 Add Space (1).
  5. Mutați cercul cu numărul din interior peste zona pe care o considerați loc de parcare.
  6. Apăsați Save după ce ați terminat — vezi Fig.7 Add Space (2).
  7. Repetați pentru câte locuri de parcare aveți sau trebuie verificate.

7.2 Editarea unui Loc de Parcare

Pentru a modifica un loc de parcare existent:

  1. Apăsați pe rândul locului de parcare pentru a-l selecta — vezi Fig.7 Add Space (4). Folosim aceeași figură (Fig.7) deoarece meniul arată la fel.
  2. Apăsați butonul Edit — vezi Fig.1 Main Interface (10).
  3. Faceți modificările apăsând pe afișajul video.
  4. Apăsați Save pentru a confirma — vezi Fig.2 Add Space (2).

7.3 Ștergerea unui Loc de Parcare

Pentru a elimina un loc de parcare:

  1. Apăsați pe rândul locului de parcare pentru a-l selecta — vezi Fig.7 Add Space (4).
  2. Apăsați butonul Delete — vezi Fig.1 Main Interface (11).
  3. Confirmați ștergerea când vi se solicită.

7.5 Mod Plasare

Când plasați locuri de parcare, puteți alege între — vezi Fig.7 Add Space (3):

8. Depanare

8.1 Probleme de Conexiune la Cameră

Camera nu se conectează:

8.2 Probleme de Acuratețe a Detecției

Vehicule nedetectate sau detecții false:

8.3 Performanța Aplicației

Aplicația rulează lent sau utilizează prea mult CPU:

8.4 Probleme de Raportare

Actualizările de stare nu ajung la server:

8.5 Probleme cu Declanșatorul Extern

Declanșatoarele externe nu funcționează:

9. Fișier Configurare INI

Toate setările aplicației sunt stocate într-un fișier de configurare numit <app_id>.ini. Acest fișier INI vă permite să configurați aplicația manual sau prin scripturi de automatizare fără a utiliza interfața grafică.

9.1 Locația și Numele Fișierului

Notă: Dacă rulați mai multe instanțe ale aplicației, fiecare instanță trebuie să aibă un app_id unic pentru a genera un nume de fișier INI unic (ex. 1.ini, 2.ini, 3.ini).

9.2 Referință Chei de Configurare

Tabelul următor listează toate cheile de configurare disponibile, tipurile lor de date, valorile implicite și descrierile. Cheile sunt sensibile la majuscule.

Cheie Tip Implicit Descriere
input_stream_type int 0 Tipul fluxului de intrare (vezi Secțiunea 4 pentru valori valide)
input_stream_address string (gol) Adresa IP sau URL-ul camerei de intrare
input_stream_tcp_port int 80 Portul de rețea pentru fluxul de intrare
input_stream_use_ssl int 0 Activare SSL/TLS pentru fluxul de intrare (0=Nu, 1=Da)
input_stream_username string (gol) Nume utilizator pentru autentificarea camerei
input_stream_password string (gol) Parolă pentru autentificarea camerei
input_stream_fps_limit float 0 FPS maxim de procesat (0=nelimitat)
companion_stream_type int 0 Tipul fluxului companion (vezi Secțiunea 4 pentru valori valide)
companion_stream_address string (gol) Adresa IP sau URL-ul camerei companion
companion_stream_tcp_port int 80 Portul de rețea pentru fluxul companion
companion_stream_use_ssl int 0 Activare SSL/TLS pentru fluxul companion (0=Nu, 1=Da)
companion_stream_username string (gol) Nume utilizator pentru autentificarea camerei companion
companion_stream_password string (gol) Parolă pentru autentificarea camerei companion
rtsp_stream_latency int 100 Latența fluxului RTSP în milisecunde
rtsp_stream_protocols string tcp Protocol de transport RTSP (tcp, udp sau multicast)
reporting_url string Definit de constanta REPORTING_URL Endpoint URL pentru raportarea stării parcării
reporting_duplicate_url string (gol) URL secundar pentru raportare redundantă
reporting_check_action_id int 0 ID cameră/instanță pentru raportare
reporting_check_action_authkey string (gol) Cheie de autentificare pentru serverul de raportare
input_stream_resx int 640 Rezoluția orizontală a fluxului de intrare (lățime)
input_stream_resy int 480 Rezoluția verticală a fluxului de intrare (înălțime)
companion_stream_resx int 640 Rezoluția orizontală a fluxului companion (lățime)
companion_stream_resy int 480 Rezoluția verticală a fluxului companion (înălțime)
live_view_active int 1 Activare capturi live view (0=Dezactivat, 1=Activat)
live_view_url string Definit de constanta LIVE_VIEW_URL Endpoint URL pentru capturile live view
external_trigger_type int 0 Tipul declanșatorului extern (vezi Secțiunea 3.1 pentru valori valide)
external_trigger_seconds int 1 Secunde de analiză după primirea semnalului de declanșare
engine_working_mode int 0 Modul de funcționare al motorului (0=Continuu, 1=Declanșat)
recognition_enhancement int 2 Nivelul de îmbunătățire a recunoașterii (0-5, mai mare = mai amănunțit)
bounding_boxes_reduction int 0 Modul de reducere a casetelor de delimitare (vezi Secțiunea 3.1)
bounding_boxes_visible int 0 Afișare suprapunere casete de delimitare (0=Ascuns, 1=Vizibil)
objects_type int 0 Tipul obiectelor de detectat (0=Vehicule, 1=Ambarcațiuni, 2=Persoane)
status_change_delay int 5 Întârziere în secunde înainte de schimbarea stării locului de parcare
parking_spaces_list string (gol) Lista separată prin virgulă a ID-urilor locurilor de parcare definite

9.3 Exemplu Fișier INI

Mai jos este un exemplu de fișier 1.ini cu setări comune configurate:

[General]
input_stream_type=4
input_stream_address=192.168.1.100
input_stream_tcp_port=80
input_stream_use_ssl=0
input_stream_username=admin
input_stream_password=secret123
input_stream_fps_limit=10
companion_stream_type=0
companion_stream_address=
companion_stream_tcp_port=80
companion_stream_use_ssl=0
companion_stream_username=
companion_stream_password=
rtsp_stream_latency=100
rtsp_stream_protocols=tcp
reporting_check_action_id=1
reporting_check_action_authkey=your-auth-key-here
reporting_url=http://yourserver.com/io/ppd/new_parking_place_event.php
reporting_duplicate_url=
input_stream_resx=1280
input_stream_resy=720
companion_stream_resx=640
companion_stream_resy=480
status_change_delay=5
live_view_active=1
live_view_url=http://yourserver.com/io/ppd/live_view.php>
external_trigger_type=0
external_trigger_seconds=1
engine_working_mode=0
recognition_enhancement=2
bounding_boxes_reduction=0
bounding_boxes_visible=0
objects_type=0
parking_spaces_list=1,2,3,4,5,6,7,8

9.4 Editarea Manuală a Fișierului INI

Puteți edita manual fișierul INI pentru a configura aplicația:

  1. Deschideți <app_id>.ini într-un editor de text
  2. Modificați cheile de configurare dorite
  3. Salvați fișierul
Important: Aplicația actualizează automat fișierul INI când salvați setările prin interfața grafică. Dacă editați fișierul INI manual, aveți grijă să mențineți formatul INI corect. Formatarea incorectă poate cauza ca aplicația să ignore setările sau să nu pornească.

9.5 Exemplu Script de Automatizare

Iată un exemplu de script bash care creează un fișier de configurare pentru implementări automatizate:

#!/bin/bash
APP_ID=1
INI_FILE="${APP_ID}.ini"

cat > "${INI_FILE}" << 'EOF'
[General]
input_stream_type=4
input_stream_address=CAMERA_IP_ADDRESS
input_stream_tcp_port=80
input_stream_use_ssl=0
input_stream_username=CAMERA_USER
input_stream_password=CAMERA_PASS
input_stream_fps_limit=10
reporting_url=http://yourserver.com/io/ppd/new_parking_place_event.php
reporting_check_action_id=1
reporting_check_action_authkey=AUTH_KEY
reporting_duplicate_url=
input_stream_resx=1280
input_stream_resy=720
companion_stream_resx=640
companion_stream_resy=480
status_change_delay=5
live_view_active=1
live_view_url=http://yourserver.com/io/ppd/live_view.php>
external_trigger_type=0
external_trigger_seconds=1
engine_working_mode=0
recognition_enhancement=2
bounding_boxes_reduction=0
bounding_boxes_visible=0
objects_type=0
parking_spaces_list=1,2,3,4,5
EOF

echo "Configuration file ${INI_FILE} created successfully"

9.6 Migrarea Configurației

Când migrați configurații între sisteme sau actualizați aplicația:

Sfat: Aplicația monitorizează fișierul INI pentru modificări în timp ce rulează. Dacă modificați fișierul extern și salvați, aplicația va detecta modificarea și va reîncărca setările automat

10. Opțiuni Linie de Comandă

Când porniți aplicația din linia de comandă, puteți utiliza aceste opțiuni:

Opțiune Descriere
-nogui Rulare fără afișarea interfeței grafice (mod headless)
-debug Activare mod debug cu logare suplimentară
-disable_gpu Dezactivare accelerare GPU chiar dacă este disponibilă
-use_gpu <n> Utilizare GPU numărul n pentru procesare (dacă există mai multe GPU-uri)
-detection_threads <n> Număr de fire de procesare (1-8, implicit este 1)
-log_level <n> Nivel de logare: 0 (niciuna), 1 (redus), 2 (mediu), 3 (ridicat)
-app_id <n> ID-ul aplicației pentru implementări cu mai multe instanțe
-v Afișare informații despre versiune

11. Glosar

Termen Definiție
API Application Programming Interface - modul în care aplicația comunică cu serverul dvs.
Bounding Box Un dreptunghi desenat în jurul unui obiect detectat în video
Double Parking Un vehicul care ocupă mai mult de un loc de parcare
FPS Frames Per Second - câte cadre video sunt procesate în fiecare secundă
GPU Graphics Processing Unit - poate accelera analiza video
H.264/H.265 Formate de compresie video utilizate de camerele moderne
HTTP HyperText Transfer Protocol - comunicare web standard
IP Address Adresa de rețea a unui dispozitiv (ex. 192.168.1.100)
MJPEG Motion JPEG - un format video unde fiecare cadru este o imagine JPEG separată
RTSP Real Time Streaming Protocol - standard pentru transmiterea video prin rețele
SSL/TLS Protocoale de securitate pentru comunicare criptată
UDP User Datagram Protocol - un protocol de rețea rapid pentru trimiterea semnalelor de declanșare

12. Obținerea Ajutorului

Dacă întâmpinați probleme neacoperite în acest manual: