Summary of Contents for Ganz ZN-AIBOX-STD/PRO
- Page 1 User Manual ZN-AIBOX-STD/PRO V.0.0.9 Caution: The contents of this manual are subject to change at any time without prior notice.
-
Page 2: Table Of Contents
Table of Contents ZN-AIBOX-STD/PRO Settings ..........................7 1. Device installation ..........................7 1.1 Installing the ZN-AIBOX-STD/PRO ..................... 7 2. Search for devices on the network ....................... 8 2.1 Download the Device Management Tool ..................8 2.2 Running screen ..........................8 2.3 Setting screen ........................... - Page 3 3.2.1 Counting Method ......................... 24 3.2.2 Counting Condition ........................25 3.2.3 Camera Installation Condition ..................... 25 3.2.4 ZN-AIBOX-STD/PRO Counter Setting ................... 26 3.2.5 Counting Zone Setting ......................... 27 3.2.7 Finishing the setup ........................28 3.3 Counter Action Rule Setting Example ..................... 28 3.3.1 Event Action Rule Preferences Setting ..................
- Page 4 3.1 Email Action using an SMTP Server Settings ................... 41 4. HTTP API............................. 43 4.1 URL Settings ............................ 43 4.2 Authentication ..........................44 4.3 Show event data ..........................44 4.4 Custom Header Settings ......................... 45 4.5 Query Settings ..........................45 4.6 Content-type ...........................
- Page 5 7.1.2 Learn about integration architecture ..................52 7.2 Configuration ..........................53 7.2.1 ZN-AIBOX-STD/PRO Configuration ....................53 7.2.2 ZN-AIBOX-STD/PRO Channel Mapping ..................56 7.2.3 Create Cortrol External Service ....................58 7.2.4 Create Cortrol Event & Rule ......................61 7.2.5 ZN-AIBOX-STD/PRO Rule Test ...................... 62 7.3 Demo ..............................
- Page 6 3. System I/O Combined Condition Settings ................... 79...
-
Page 7: Zn-Aibox-Std/Pro Settings
UI, and the setting method. 1. Device installation 1.1 Installing the ZN-AIBOX-STD/PRO 1. Install the ZN-AIBOX-STD/PRO on a network connected to the Internet and run a DHCP server. 2. Connect the network cable to the ETHERNET 1 port of ZN-AIBOX-STD/PRO. -
Page 8: Search For Devices On The Network
When the install file runs, the firewall setting window will appear as below. For smooth use, it is recommended to allow the entire network. 2.2 Running screen The ‘IPCameraTool_MDload’ allows for the discovery and configuration of the GANZ AI BOX in a network. ‘Ganz MDload’... -
Page 9: Setting Screen
When the ZN-AIBOX-STD/PRO is in “factory default or factory reset” status, “1234” is set as a temporary password for network settings in the tool • If the ZN-AIBOX-STD/PRO is not shown, please check the network cable is connected to ETHERNET 1 properly. 2.3 Setting screen To set the network type, select the device with port 8443 from the list, highlighting it. -
Page 10: Screen After Settings Applied
After setting the network, double-click the device information in the list to access the ZN-AIBOX- STD/PRO . The ZN-AIBOX-STD/PRO webpage will open in the default browser in Windows. 3. Initial access settings When accessing the AI Bridge for the first time, the initial setting wizard is displayed. -
Page 11: Device Language Settings
Adjust the time zone to your time zone. Set the DST to the required setting. Select Apply. 3.3 Initial password setting of Device When accessing the ZN-AIBOX-STD/PRO for the first time, the initial password setting UI is displayed. Set the password you want to use. -
Page 12: Accessing To Device And Setting The Remote Support Settings
4. Video source setup 4.1 Camera Video Input Setting To enable the ZN-AIBOX-STD/PRO to receive and analyze video from a camera, you must first set up the camera’s connecting information. Click the ‘Video Stream’ in the sidebar navigation menu displays the settings menu for receiving video from the camera. -
Page 13: Video Stream For Each Channel Setting
ZN-AIBOX-STD/PRO can receive and process from the camera. The ‘Video Resolution Resource’ shows the usage against the maximum resolution available on the ZN-AIBOX-STD/PRO . No item will exceed the limit. The ‘Video Stream’ settings allows you to set the video stream information accessible over the network. -
Page 14: Check The Video Stream Connection Setting
To use the discovery feature, click ‘Search Cameras’. Search for your camera in the ONVIF search pop-up, then enter your credentials to see a list of video streams supported by your camera. Assign the streams you wish to analyze to a channel on the ZN-AIBOX-STD/PRO. -
Page 16: Searching For Setting Onvif Cameras
4.6 Searching for setting ONVIF cameras Once the video stream is set up and connected, click the ‘Configure AI App’ button, select the appropriate app, and set the event action rule. 5. Remote support settings 5.1 Remote support Settings Enable the Remote Assistance function in the System > System Management > Technical Support menu. -
Page 17: Application Usage Guide
Application usage guide ZN-AIBOX-STD/PRO works by adding various applications in the form of add-ons. To add and use the application to the device, a license to use the application should be issued from the device dealer. 1. Application Activate To activate additional apps, you need a license for each application. -
Page 18: Event Action Setting Guide
2. Event Action Setting Guide Many of the various applications supported by ZN-AIBOX-STD/PRO have a structure that performs predefined actions for events detected based on AI. By defining events and setting related actions, notification on real-time events can be used for a variety of purposes. -
Page 19: Alarm Setting Example (Intrusion)
2.1 Alarm setting example (Intrusion) To set up an intrusion detection event action, click the ‘Explore AI Apps – Intrusion Detection’ in the sidebar navigation menu. To set a new detection rule, click the button in the intrusion detection settings. 2.1.1 Event Action Rules Setting 1. -
Page 20: Event Setting
2.1.2 Event Setting 1. Click the button to set up the event. 2. Select the video want to detect via the dropdown to the right of the Event Type. 3. The detection zone can be set using the functions below. Alternatively, you can select zone information generated from other event settings by importing zone information. - Page 21 4. After done, the video will look like below with the event zone and label set up above. 5. Click the button to save after setting for each option. • Event Name : Enter the name of the event zone you created above. •...
-
Page 22: Action Settings
2.1.3 Action Settings Define the event action to take when the event set occurs in Action Setting. 1. Click the button to add a new action item. 2. Set each action want to perform when an event occurs. Please refer to the Action setting Guide for the types of actions supported and how to set them up. - Page 23 2.1.5.1 Schedule settings Set up event action schedules that operate over a period to set the time for sending the notification whenever an event occurs. 1. Click the button to set the event action schedule. 2. Add a schedule to drive action when an event occurs. Please refer to the ‘Schedule Setting Guide’...
-
Page 24: Counter Setting Guide
3.1 Counter working process By setting up a counter application, ZN-AIBOX-STD/PRO counts objects internally and archives the counting data to internal storage at regular intervals. The stored data can be retrieved directly from the edge through the API. Edge storage has limitations in areas such as storage period, network configuration, and service delivery performance. -
Page 25: Counting Condition
3.2.2 Counting Condition To ensure that the count value is as accurate as possible, follow these guidelines. • Compliance with entrance and exit camera installation guide. • No one enters or leaves the target space other than the designated entrances and exits. •... -
Page 26: Zn-Aibox-Std/Pro Counter Setting
3.2.4 ZN-AIBOX-STD/PRO Counter Setting 1. To set up counting people in a space, click the ‘Explore AI Apps’ – ‘Occupancy Counting’ in the sidebar navigation menu. 2. Click the button to create a new counter in the upper-right corner of the Occupancy Counting list. -
Page 27: Counting Zone Setting
3.2.5 Counting Zone Setting 1. Select the video you want to count from the Select Video dropdown in the top right corner. 2. The counting area can be set using the functions below. • Drag the vertex to move it •... -
Page 28: Finishing The Setup
3.2.7 Finishing the setup 1. When you’ve finished setting up all the entry and exit people counters and reset schedules, click the button at the bottom of the page to submit your in-space people counter settings. 2. If everything is set up correctly, you can see what you’ve set up in the list of people counters in the space. -
Page 29: Event Setting
3.3.2 Event setting 1. Click the to set the event. 2. Select the channel on which you want the event widget to appear and specify the location of the widget. The channel on which the event occurs will also be set to the channel on which the widget will be displayed. -
Page 30: Action Settings
• Periodic – The count event occurs at regular time intervals. o Events occur at regular intervals based on the event cycle you set. o If you have added a range condition such as greater than/less than setting as a condition every cycle –... -
Page 31: Finish Setup
3.3.4 Finish setup 1. Click the button at the very bottom to save intrusion detection event settings after setting up the event, action in the event action rule set page. 2. If everything is set up correctly, you can see the new event in the list on the Intrusion Detection application screen. -
Page 32: Reduce False Detection Setting
Reduce False Detection Setting Deep learning object detection cannot be 100% accurate. There are several tools to reduce false detections and false alarms. Learn more about these features below and add settings to reduce false detection. • Object Size Filter •... -
Page 33: Object Maximum Size Filter
※ Notes The object minimum size filter is not applied to fire detection. The object minimum size filter is not applied to fallen detection. 1.2 Object Maximum Size Filter The Max Size Filter is a setting that only recognizes a detected object as an object if its bounding box is smaller than the specified box size. -
Page 34: Filters Set Up
1.2.2 Filters Set Up 1. Select the channel you want to set the Minimum Size Filter. 2. Select a Minimum Size Filter type. 3. Drag the filter area to move the filter position. 4. Drag the vertex of the filter box to change the size of the filter. -
Page 35: Filter Types
1.2.3 Filter Types 1. Not Used a. No use Minimum Size Filter for this channel. 2. Normal a. Use a Normal type of Minimum Size Filter. b. Typically used when the viewing angle is distant, and the screen area contains objects of approximately similar size. -
Page 36: Save, Load, And Reset The Settings
1.2.4 Save, Load, And Reset the Settings 1. Save : Click the button at the bottom of the screen to save the position and size information of the filter setting. 2. Load : Click the button to load the most recently saved information of the filter that is set on that channel. -
Page 37: Save, Load, And Reset The Settings
4. Drag the exclusion zone to move it. 5. Drag the vertex of the exclusion zone box to change the size of the zone. 6. Double-click or right-click the exclusion zone to delete it. ※Caution It is recommended that the exclusion area is as small as possible to prevent actual objects from being filtered out by the exclusion area settings. -
Page 38: Action Setting Guide
Action setting guide Various types of actions you want to trigger when an AI event occurs can send alarm notifications by defining the event actions in the event action settings. Users can send real-time events over the network to specific servers or clients, such as alarm output, voice audio through the camera speaker, as well as HTTP, FTP, etc. -
Page 39: Camera Speaker Output
2. Camera speaker Output If IP camera connected to the ZN-AIBOX-STD/PRO supports audio output through speakers, you can drive an event action to emit audio output. Camera speaker output operates based on the protocols defined by the ONVIF Audio Backchannel standard. -
Page 40: Action Settings
1. Select the Action Type to Camera Speaker, then, the relevant settings at the bottom. 2. Select a camera connected to the ZN-AIBOX-STD/PRO to output speaker sound 3. Select a sound source to send to the camera. Sound files can be uploaded on the “New”... -
Page 41: Email Alarm
3. Email Alarm You can email event snapshots and event metadata information when an event occurs. 3.1 Email Action using an SMTP Server Settings Email actions using an SMTP server can be added from the Action settings. 1. Select the Action Type to Email(SMTP), then, the relevant settings at the bottom. If you set up your own SMTP server and credentials, you can configure an email action using that SMTP server. - Page 42 • Name : Enter a SMTP name. • SMTP Server : Enter the address and SMTP server port. • Encryption: Select the encryption method used by the server, such as SSL/TLS. • Validate Server Certificate : If you set the Validate server certificate item to ON, the server includes a procedure to verify the certificate presented by the server with a certificate authority.
-
Page 43: Http Api
4. HTTP API HTTP API allows integration with diverse devices. Select the Action Type to HTTP API, then the relevant settings at the bottom. Click the button to add new HTTP Action. 4.1 URL Settings 1. Select the HTTP API URL and Method. 2. -
Page 44: Authentication
4.2 Authentication Authentication methods are available None, Basic, and Digest. 4.3 Show event data API request data can contain event information. 1. Enter event data values using predefined tokens. 2. Select the desired token value from the combo box. Click on the button. -
Page 45: Custom Header Settings
4.4 Custom Header Settings Click the button to set the header You can use event data tokens on the Custom Header settings page. To use a token, select the text field and add the token. It is only available for Value. 4.5 Query Settings The query string can be configured in the same way as the header. -
Page 46: From Field Settings
4.6.1.1 From Field Settings 1. Click the button to set the data. 2. Use the event data token to set the value. There’s also a simple template. -
Page 47: Snapshot Settings
4.6.1.2 Snapshot settings multipart/form-data allows snapshots to be appended. 4.6.2 Content-type: Application/Json Application/Json provides event data token functionality and template functionality. It also provides templates in the form of Json. 4.7 Message test You can test your setup data using the Test button at the bottom. Success is simply displayed at the top. -
Page 48: Ftp Upload
5. FTP Upload FTP upload allows you to upload an event snapshot to an FTP server when an application event occurs. The directory and file name to store the snapshot file can be set variably using the event’s metadata. The FTP Upload can be added from the Action settings. Select the Action Type to FTP, then, the relevant settings at the bottom. -
Page 49: Ftp Server Settings
• If you specify a snapshot file name, the Example shows an example path to the snapshot created by the directory and file name you specify. 5.3 FTP Server settings In the Server item, add the FTP server settings you want to transmit. Once added, the FTP server settings can be used to set up other rules or FTP uploading actions in other applications. -
Page 50: Aws S3 Upload
6. AWS S3 Upload AWS S3 Upload action uploads event snapshots to AWS S3 storage when an application event occurs. The passkey value for the storage storing the snapshot file can be set using event metadata. AWS S3 Upload Action can be added from the Action settings. Select the Action Type to AWS S3, then, the relevant settings at the bottom. -
Page 51: Aws S3 Storage Settings
6.3 AWS S3 Storage Settings Add AWS S3 storage settings to the Server item. Once added, AWS S3 storage settings can be used to set other rules or to set AWS S3 upload actions in other applications. 1. Click the button to add new server settings. -
Page 52: Cortrol Plug-In Integration Guide
Ganz Cortrol Premier VMS version 1.22 or greater. 7.1.2 Learn about integration architecture • IP Camera transmits video stream to Cortrol VMS and ZN-AIBOX-STD/PRO . • ZN-AIBOX-STD/PRO analyzes the received video stream by AI Apps and sends Metadata & Event to Cortrol VMS. -
Page 53: Configuration
7.2 Configuration 7.2.1 ZN-AIBOX-STD/PRO Configuration Add AI app settings. Add Event Setting. - Page 54 Zone or detailed setting of AI App. Add Control Plug-in Action Setting.
- Page 55 You can check if the Cortrol VMS settings are correct through the “Login” button. ※ Notes: When “Metadata Enable” is enabled, the ZN-AIBOX-STD/PRO transmits the object Metadata detected by the AI to the Cortrol VMS. Please note that performance issues...
-
Page 56: Zn-Aibox-Std/Pro Channel Mapping
7.2.2 ZN-AIBOX-STD/PRO Channel Mapping Set up the relationship between the ZN-AIBOX-STD/PRO channel and the channel of the Cortrol VMS. Press the “Mapping” button to open the settings pop-up window. Enter the Recording identifier (UUID) of the channel registered in Control VMS into ZN-... - Page 57 Recording identifier (UUID) can be obtained from the Details menu of Channel in Cortrol Management Console.
-
Page 58: Create Cortrol External Service
If the channel is connected successfully, green Connected is displayed. 7.2.3 Create Cortrol External Service Create an external service by clicking the “Create” button on ZN-AIBOX-STD/PRO ’s “Cortrol VMS Setup page”. Click the “Apply” button to save the Cortrol Server settings. - Page 59 If you see the device registered in the format “ZN-AIBOX-STD/PRO - MacAddress” in the External Service tab of the Cortrol Management Console, it’s OK. Next, Create an External Service Group.
- Page 60 Enter the name of the new External Service Group as “ZN-AIBOX-STD/PRO ”. Assign ZN-AIBOX-STD/PRO to the new External Service Group.
-
Page 61: Create Cortrol Event & Rule
7.2.4 Create Cortrol Event & Rule We need to configure the events, actions, and rules that will be sending notifications Click the “+New Event” button to add a new event. Select Event Type as External Event – External Service. -
Page 62: Zn-Aibox-Std/Pro Rule Test
Create a rule by combining the created event type and action. 7.2.5 ZN-AIBOX-STD/PRO Rule Test In ZN-AIBOX-STD/PRO ’s Cortrol Setup page, use the event “Test” button to test whether the setting is successful. -
Page 63: Demo
7.3 Demo 7.3.1 Live Set the Cortrol Client to display Metadata and Alarms to check if it works with ZN-AIBOX- STD/PRO . (Click the icon at the bottom of the video) -
Page 64: Search
7.3.2 Search Utilizing Event Meta Tokens & Creating Action Message Guide Action handlers that use the network can send messages using various event meta-information, such as the event name and the event occurring time. When you set up an action handler of the type that sends a message from a device, the action message you want to send is configured in a format that you edit yourself. -
Page 65: Edit Action Message Ui Components
This approach to action handlers allows users to write and use protocols with a high degree of freedom, depending on the protocols of the target device or server you want to interact with, without requiring additional development. 8.1 Edit Action Message UI Components The Edit Action Message UI consists of a template settings control, a token settings control, an edit box, an example box, and a test button. -
Page 66: Token Settings Controls
Select the template you want to set from the drop-down list. Click the button on the right. ※Caution When you use a template message, everything in the edit box is replaced with the template message. If you are working on something, you will lose your work if you replace it with the template message, so be careful when using it. -
Page 67: 1St Example Of Using An Object Token
OBJECTS[PARAM=COMMA]}} tokens, with the first LIST token signifying the start of the iteration and the second LIST token signifying the end of the iteration. • All {{::OBJ[XXX]}} tokens must be placed between two {{LIST OBJECTS}} or {{LIST OBJECTS[PARAM=COMMA]}} tokens, with the first LIST token signifying the start of the iteration and the second LIST token signifying the end of the iteration. -
Page 68: 2Nd Example Of Using An Object Token
8.2.2 2nd Example of using an object token It is an example message sending object information by adding the bounding box positions of two persons’ objects containing a fictional event. The plain text remains the same, and the OBJ token repeats the object information syntax twice the number of objects. 8.2.3 3rd Example of using an object token If you use the {{LIST OBJECTS[PARAM=COMMA]}} token to enclose the phrases of the list of object information, it will add a comma (,) between each phrase if there is more than one event... - Page 69 • {{CH}} o The channel number where the event occurred (1-8) {{CH NAME}} o Channel name where the event occurred o Video Source – the channel name specified in the video stream setup • {{MAC}} o Device MAC address • {{RULE NO}} o The action rule ID containing the event •...
- Page 70 • {{EVENT TYPE}} o Event type • {{# OF OBJECTS}} o Number of event objects Event time-related tokens For example, if the event was at 18:43:9.739 on 7 March 2023 in the GMT+9:00 time zone, each time token would be replaced as follows. •...
- Page 71 • {{TIME HH}} o Event occurrence hour on a 24-hour basis ex) 18 • {{TIME MM}} o Event occurrence minute with 2-digit ex) 43 • {{TIME SS}} o Event occurrence second with 2-digit ex) 09 • {{TIME MS}} o Event occurrence millisecond ex) 739 •...
- Page 72 • {{::OBJ[LP_TEXT_DETECTED}} o The plate number by License plate recognition • {{::OBJ[LP_TEXT_DB}} o The plate number registered to DB by the user o LP_TEXT_DETECTED and LP_TEXT_DB are usually the same. However, if you are using a loose matching policy, they may be matched even if they are not exact matches.
-
Page 73: Schedule Setting Guide
Schedule Setting Guide A schedule can be set in all event action settings to trigger actions when events occur. 1. Schedule Overview The schedule operates over a period of time to set the time for sending the notification whenever an event occurs. Depending on weekly, monthly, and yearly schedules can be set. Additionally, specific dates can be designated as exclusion schedules. -
Page 74: Weekly Schedule
Click the button to create a new schedule at the bottom. • Name : Enter a schedule name on “Name”(e.g. working hours, holidays). • Schedule Cycle : Set the “schedule cycle” for how often the schedule should repeat as weekly, monthly, or yearly. •... -
Page 75: Monthly Schedule
4. Monthly Schedule For monthly schedules that use the Day-based option, you can specify by a week of the month. For example, you can set a schedule for every second week of the month, Monday to Friday. For monthly schedules that use the Date-based option, you can specify the dates of the month for the schedule. -
Page 76: Time Schedule Setting
For yearly schedules that use the Date-based option, you can specify the dates for each target month. For example, you can set up a schedule on the 1st, 15th, and the last day of January to March. 6. Time Schedule Setting The time schedule is set to run on the specified date. -
Page 77: Combined Rule Setting Guide
Combined Rule Setting Guide You can set compound rule conditions to trigger actions when events occur in event action settings. 1. Overview of Compound Rule Conditions When setting up event action rules for each application, you can set conditions for triggering actions. - Page 78 Click the button to add a new condition on the event action setup screen. Click the button to save after set each options. UUID : Ender the UUID value assigned to a target event, rule, or system device. When setting up an event action in the application, both the event and rule receive a unique UUID.
- Page 79 NOT : If NOT is checked, the condition will be true if the UUID event or rule is false. For example, if you specify the UUID of “Event A” and check the NOT checkbox, the condition will be true if “Event A”...