View source for TVT POST XML Version 01.00

= ANPR-CLOUD + TVT LPR Camera Integration Manual =

== 1. Introduction ==

'''ANPR-CLOUD''' is a cloud-based Automatic Number Plate Recognition (ANPR/LPR) platform that receives, processes, and analyses vehicle detection events from supported cameras.

The platform enables:
* Real-time vehicle detection and logging  
* Hotlist / alert notifications  
* Vehicle movement tracking across multiple locations  
* Integration with intelligence platforms such as SecureMIND  

By connecting your '''TVT LPR camera''' directly to ANPR-CLOUD via HTTP POST, detections are streamed in real-time to the cloud without requiring intermediate servers.

== 2. Requirements ==

Before starting, ensure you have:

* TVT LPR Camera (with HTTP POST / API support)  
* Camera accessible on your network  
* Camera username & password  
* Internet connectivity  
* ANPR-CLOUD ingestion URL and API key  

== 3. System Flow Overview ==

{{#mermaid:
flowchart LR
    CAM["TVT LPR Camera"] -->|"HTTP POST XML"| CLOUD["ANPR-CLOUD Ingestor"]
    CLOUD --> DB[(Database)]
    CLOUD --> ANALYTICS["Analytics Engine"]
    ANALYTICS --> DASH["Dashboard / UI"]
    DB --> DASH
}}

'''Flow Explanation:'''
* Camera detects vehicle
* Sends HTTP POST to ANPR-CLOUD
* Data is processed and stored
* Results visible in dashboard and alerts

== 4. Add Camera in ANPR-CLOUD ==

Before configuring your physical camera, you must first register it on the ANPR-CLOUD platform.

=== Step 1: Login ===

# Open your browser
# Navigate to your '''client-specific domain''' (provided in your setup email)
# Login with your credentials

[[File:anprcloud-login.png|600px|thumb|center|ANPR-CLOUD login screen]]
=== Step 2: Add New Camera ===

# Go to '''Dashboard'''
# Click on '''[+ Add Camera]'''

[[File:add-camera-button.png|600px|thumb|center|Add Camera]]

=== Step 3: Enter Camera Details ===

Fill in the following fields:

* '''Camera Name''' – Friendly name (e.g. Gate Entrance Camera)  
* '''Camera Ingestor''' – Select the applicable camera ingestor available for your account (Please contact us for list of available camera ingestors)  
* '''Location Description''' – Description of where the camera is installed  
* '''Address''' – Physical address of the camera  
* '''Location on Map''' – Click on the map to set the exact camera position  

[[File:add-camera-form.png|600px|thumb|center|Add Camera Form]]

=== Step 4: Create Camera Key ===

# Click '''[Add Camera]'''
# The system will generate a '''CAMERA_KEY''' for the camera.

[[File:camera-key.png|600px|thumb|center|Camera Setup]]

=== Step 5: Copy camera ingestor settings ===

# Click '''(i)''' button to show the setup instructions for the camera.
# Please copy the settings example '''IP, Port & Url''' and enter it into the camera.

[[File:camera-settings.png|600px|thumb|center|Camera Settings]]

== 5. Accessing the TVT Camera ==

=== Step 1: Open the Camera Web Interface ===

# Open a browser (Chrome recommended)
# Enter:
<pre>
http://<camera-ip>
</pre>
# Login using your credentials

[[File:camera-login.png|600px|thumb|center|Camera login screen]]

== 6. Configure Network ==

Navigate to:
<pre>
Settings → Network → TCP/IP
</pre>

Ensure:
* IP Address configured
* Gateway set
* DNS configured

[[File:network-settings.png|600px|thumb|center|Network settings]]

== 7. Enable LPR / ANPR ==

Navigate to:
<pre>
Settings → AI / Smart → LPR / ANPR
</pre>

Ensure:
* LPR Enabled
* Detection zones configured
* Plate recognition active

[[File:lpr-settings.png|600px|thumb|center|LPR settings]]

== 8. Configure HTTP POST Integration ==

=== Step 1: Navigate to Settings ===

<pre>
Settings → Network → Advanced → HTTP / Alarm / API
</pre>

[[File:http-settings.png|600px|thumb|center|HTTP settings]]

=== Step 2: Enable HTTP POST ===

Enable:
* HTTP POST / Alarm Upload  
* Event Upload  

=== Step 3: Configure POST Parameters ===

{| class="wikitable"
! Setting !! Value
|-
| Protocol || HTTP
|-
| Method || POST
|-
| Server IP / Host || {Server IP}
|-
| Port || {Server Port}
|-
| URL || ?key={KEY}
|-
| Trigger Event || LPR Detection
|}

'''Note:''' Replace <code>Server IP, Port and URL</code> with the info from the Camera Setup Instructions on ANPR-CLOUD in Section 4, Step 5 above.

[[File:http-post-config.png|600px|thumb|center|HTTP POST config]]

=== Step 4: Keepalive (Optional) ===

{| class="wikitable"
! Setting !! Value
|-
| Enable || Yes
|-
| Interval || 30–60 seconds
|-
| URL || /keepalive/?key=YOUR_CAMERA_KEY
|}

[[File:keepalive-settings.png|600px|thumb|center|Keepalive settings]]

== 9. Save and Test ==

# Click '''Save / Apply'''
# Trigger a vehicle detection
# Confirm data is received

== 10. Verify on ANPR-CLOUD ==

# Login to your client domain
# On the Dashboard page, verify that the badge counter increases as new plates are detected by the camera. Refresh the page before each check.

[[File:camera-checks.png|600px|thumb|center|Camera checks]]

== 11. Troubleshooting ==

=== No Data Received ===
* Check internet connectivity  
* Verify CAMERA_KEY  
* Confirm port (80/443)  
* Check firewall  

=== Only Keepalive Received ===
* Ensure camera can reach server  
* Verify correct endpoint  

=== Empty Plate Field ===
Check XML fields such as:
* <code>&lt;licensePlate&gt;</code>  
* <code>&lt;plate&gt;</code>  
* <code>&lt;text&gt;</code>  

== 12. Recommended Configuration ==

* Use HTTP POST (not FTP)  
* Use unique keys per camera  
* Enable NTP time sync  
* Use static IP or DHCP reservation  

== 13. Tested TVT Models ==

{| class="wikitable"
! Model Part Number !! Software Version !! Hardware Version !! Notes
|-
| TD-9423A3BH-A-LR || 5.1.1.0(61898) || 1.5 || -
|-
| TD-9423A3-LR || T1.5-1422322 || 5.1.1.0(64616) || -
|-
| TD-9443A3BH-LR || 5.3.1.12288B260327.IC4.U1(13A10).beta || 1.5 || -
|}

== 14. Network Architecture Diagram ==

{{#mermaid:
flowchart TB
    subgraph FIELD["Field Layer"]
        CAM1["Camera 1"]
        CAM2["Camera 2"]
    end

    subgraph CLOUD["ANPR-CLOUD"]
        INGEST["Ingest API"]
        PROC["Processing Engine"]
        DB["(Database)"]
    end

    subgraph USERS["Users"]
        DASH["Dashboard"]
        API["API Access"]
        ALERTS["Telegram Alerts"]
    end

    CAM1 --> INGEST
    CAM2 --> INGEST
    INGEST --> PROC
    PROC --> DB
    DB --> DASH
    PROC --> ALERTS
    PROC --> API
}}

== 15. Support ==

* Email: info@anprcloud.co.za  
* Website: https://www.anprcloud.co.za  

== 16. Summary ==

By completing this setup:

* Cameras send detections directly to ANPR-CLOUD  
* Real-time intelligence and alerts enabled  

'''ANPR-CLOUD transforms raw camera data into actionable intelligence.'''