Integration with the Axxxon One cameras
- Karyna Kompaniiets
- yuri.shatnii (Unlicensed)
Integration with the Axxxon One cameras allows to activate the license plate recognition and use it for entering the premises. For this, a working camera server along with enabled macros required to open a barrier must be set.
This article contains the information on connecting the Axxxon module to the Link server system.
Full information about the features and capabilities of the Axxxon One software can be found here.
Preparation of Axxxon One Software Suite
First, Axxxon One software package must be installed and configured:
After the software package is installed, the license must be activated:
After the software suite is activated, you need to connect the suite to the server:
IP Device Discovery Wizard
After the software suite setup is completed, you need to add the camera device using the device discovery wizard.
To open the IP Device Discovery Wizard, click on the Add device link at the end of the Server device list:
The IP Device Discovery Wizard interface includes:
Automatic search for IP devices.
Manual input of device data.
Adding devices to the configuration.
Bulk adding devices using .CSV files (see Bulk creation of IP devices).
Automatic search for IP devices
To start searching for devices, click the Search button. While searching, a progress bar will be displayed.
To stop devices search at any time, click the Stop button.
The search results are color-coded based on the status of the device:
Color of video camera icon | Description |
|---|---|
Fully supported device | |
Manual configuration required | |
Axxon One compatibility not guaranteed |
Search results can be filtered in two ways:
By status. To hide devices with a certain status, deselect the relevant checkbox.
By vendor, model or IP address. To do this, use the Filter field. For example, this filters the Sony devices.
In addition, you can filter cameras from a subnet.
Manual input of device data
If an IP device is not shown in the search results (because it is located on a different subnet or the connection with it is temporarily lost), you can add it manually. To do this, you need to select the type of device to be added, specify the IP address and connection port of the device, and select the vendor and model in the area with a neutral background located under the list with automatic search results.
You can also specify the vendor and model of the device using the search in the input field.
If the device's IP address, Port, Vendor, Username and Password are set, the device Model can be automatically detected by clicking the Search button next to the Model window:
Adding devices to the configuration
You can add the devices in bulk, using one of three modes are available:
Start with default settings: The device is added to the configuration with the default settings (the default settings are determined by Axxon One itself). Adding a device in this mode will change the current settings of the device specified in the web interface
Keep current settings: The device will be added using the settings specified in the web interface
Start with parameters: The device is added to the configuration with the settings that have been previously specified for a device of the same model in the configuration. Select a device of the same model (the "template device") in the list. Only devices of the same model are shown in the list of search results for choosing the template device. Parameters that will be set according to the template device: firmware, video stream settings, buffering settings, Other settings (see The Camera object), and Other settings for Microphone and Speaker objects, if these are configured for the template device.
This mode is best when multiple cameras of the same model are in use at a site. If this is the case, we advise to:
Add and configure one device.
Add the remaining devices, copying settings from the "template device" as described previously
You can also add a single device using the Plus button located on the right to the device number.
Configuring Web Server
The web server allows remote access to the Axxxon One suite over the internet.
The detailed information on the web server configuration is available here.
To configure the web server in Axxon One, do the following:
Select a Server object.
By default, the web server starts automatically together with the server. If you want to disable the web server, set the value of the Enable parameter to No (1).
In the Port field, enter the port number on which the web server will be located (2).
To connect to the web server via the SSL port only, do the following:
Enter the SSL port number to connect to the Web-Server (7).
Specify a path to the private key file (6).
Specify a path to the certificate file (3).
If the Web-Server should use the CORS mechanism, enable the corresponding parameter (4).
Axxon One supports the following:CORS HTTP-headers for GET and POST requests.
Preflight requests.
If the web server must transcode the stream, enable the corresponding parameter (5). By default, the web server doesn’t transcode the stream, which helps to avoid unpredictable CPU load on the server. For example, if the browser cannot playback a video in H.265 format, you must switch to a browser-supported video codec (see Real-time video surveillance in the Web-Client) or change the video codec of the camera to the video codec supported by the browser (see The Camera object).
In the URL path field, enter the prefix that is added to the Server address (8).
Click the Apply button to apply the configured parameters and restart the web server.
The web server is now configured and available online at the following address:
http://<IP address of Axxon One Server>:<Port>/<Prefix>.
For example, if the server’s IP-address is 10.0.11.1, the port is 8000, and the prefix is /asip-api, then the web server can be accessed at the following address: http://10.0.11.1:8000/asip-api.
On the local computer that has the web server running, ports from the range [9001; 9001 + number of logical cores of the processor] must be open.
Except for H.264 format, the web server transcodes the incoming video image using the MJPEG compression algorithm, which can result in high levels of incoming traffic.
Axxon One supports SSL certificates in PEM format with TLS encryption v 1.2 and 1.3 and AES GCM, AES CCM and AES CBC algorithms.
The public key must be in CRT format, the private key must be in KEY format.If the private key file and certificate file are not specified in the web server settings, the connection to the Web-Server will be made via HTTP Port only.
Configuring License Plate Recognition
After the cameras and servers are set, you need to сonfigure the license plate detection tools.
To do so, in the Axxxon One software suite, go to the Detection Tools tab.
Below the designated camera, click Create… → Category: Vehicle → License Plate Recognition VT.
By default, the detection tool is enabled and set to recognize vehicle license plates. If necessary, you can change the detection tool parameters. The detailed information on the parameters is found here.
Configuring Macros
Macro is a tool used to configure system responses to certain events. System response may include one or several different actions.
In case of the integration with the Link software, the event driven macros, or Event rules should be created for the license plates recognition and subsequent barrier opening. These macros can run automatically on detecting the specified events or initiated manually by the operator. When triggered, the actions in the macro are executed once.
To create the macros for the license plate recognition, visit the Programming tab in the Axxxon software suite:
The full information on how to create the macros for the license plate recognition is provided in the following articles:
Configuring start conditions for event-driven macros
Configuring macros when working with vehicles lists
Integration with Link Server
After you have set up all the components of Axxxon One within their suite, you can set up the integration within the Link app.
In the Licenses tab, ensure that you integrate with the Axxon One server and its cameras in your license. In addition, this option is enabled for the server.
Go to the General tab > the Integration section.
Click the plus icon in the low left corner to add the integration with the Axxon One server. You can add as many integrations as you need.
Enter the following information for the integration:
integration type: Axxon One
its name
AxxonOne server URL and port
login and password for the server
self-singed encryption certificate
All requirements for the Axxon One software package are described in the corresponding article.
Be aware that ports for the BAS-IP Link and the Axxon One software must not coincide.
Click the Save button in the left low corner when all required data will be entered.
Go to the Devices tab of the Device management section.
Click the plus icon in the left low corner.
Enter the device name.
Select the Barrier type for the Axxon One cameras.
Select the AXXONONE model.
Select a group/subgroup where the device is functioning.
Add a description, if necessary.
Select the integration (created in Step 3,4).
Select the camera from the list of added to the Axxon One server.
Set the checkpoint direction that this camera is used for entry or exit. So that the records of used guest passes are kept correctly. For example, if the barrier is used for exits, the number of passes will not be subtracted.
Select the macro(s) (commands) from the Axxon One system used to open the barrier.
The integration works through the BAS-IP server subscribing to events from macros on the AxxonOne server.
Click the Save button in the left low corner when all required data will be entered.
Add license plate identifier as described here.
As a result, a camera and server can interact with license plates.
Using license plates for guest access
You can use a license plate number as a guest identifier automating the process of entry for guest vehicles.
Only a user that has at least 1 access restriction and at least 1 device associated with this restriction can create a guest identifier.
To set up the guest identifier for the plates do the following:
Go to the Guest access tab in the Access management section.
Click plus icon in the left low corner.
Select ID type: in this case, select License plate (available for panels and installed Axis camera with Axis License Plate Verifier software).
Select guest type: Courier or Guest.
Select the access restrictions you want to apply for the ID. Selected access restrictions must coincide with restrictions applied to the user is creates the ID.
Tick the restriction period field if it is necessary to limit the ID validity period.
Indicate the beginning and the ending of the ID active period. By default, the pass works for 1 day.
If necessary, tick the limit the number of passes field.
Enter the available number of passes for this ID. By default, 1 pass is available.
You may enable and set either a restriction period or a number of passes parameters.
Enter a guest message if required.
Click confirm when all data is entered.
