Axis thermal cameras provide heat-based detection for monitoring property or detecting thermal anomalies which could lead to incidents involving smoke or fire. This guide is intended to introduce the use of these devices with your exacqVision VMS software.
Requirements
Axis Q19 Series Camera
Camera firmware 11.8 or higher
exacqVision Server/Client 24.09 or higher
At the time of writing this article, these instructions pertain to the Axis Q19 Series of cameras and assume you have already located the device on your network and logged into the web browser interface.<br><br>
Thermometry Configuration
Detecting a Temperature Change (Temperature Tripwire)
Expand the Thermometry menu from the left-hand side, then select Temperature Reading. <br><br>
Select a color palette of your choice from the Palette menu on the right.<br><br>
Set the Temperature unit you intend to use, either Celsius or Fahrenheit. <br><br>
Select Temperature detection, beneath the Thermometry menu on the left. <br><br>
Back on the right, select Add detection area. <br><br>
Use the handles to drag out the bounding area on the video panel to highlight the polygonal area of interest.<br><br>
Provide a descriptive name in the Name field, such as “High Temperature” or “Low Temperature” depending on what you may be concerned about sensing.<br><br>
Enable the Use area control to enable monitoring this detection area.<br><br>
Set Temperature in area choice.
If detecting a high temperature is desired, choose ‘Warmest Spot’ from the Temperature in area options. Then select ‘Above’ and enter the temperature degrees you wish to be alerted at.
If detecting a low temperature is desired, choose ‘Coolest Spot’ from the Temperature in area options. Then select ‘Below’ and enter the temperature in degrees you wish to be alerted at.<br><br>
You may wish to adjust the Delay field time if some fluctuation is expected in the region. This setting will allow the event to trigger only after remaining above/below the set temperature threshold for a given amount of time.<br><br>
The Include detection area in video stream selector determines if, or when, the bounding area is included in the video stream as it will be sent to exacqVision.<br><br>
Checking the Include temperature checkbox will display the detected temperature.<br><br>
Detecting Smoldering Fire
The Thermometry functionality of the camera combined with the Early Fire Detection app may be used to sense if a fire could ignite in a designated area. The early fire detection app filters uninteresting moving objects, to minimize false alarms.
Expand the Thermometry menu from the left-hand side, then select Temperature Reading. <br><br>
Select a color palette of your choice from the Palette menu on the right.
NOTE: Axis recommends avoiding the use of palettes beginning with ‘Iso’ for best performance, preferably using the ‘White-hot’ option.<br><br>
Set the Temperature unit you intend to use, either Celsius or Fahrenheit.<br><br>
Select Temperature detection, beneath the Thermometry menu on the left. <br><br>
Back on the right, select Add detection area. <br><br>
Use the handles to drag out the bounding area on the video panel to highlight the polygonal area of interest.<br><br>
Provide a descriptive name in the Name field. If you were monitoring a waste disposal area for the potential of a fire, you might name this “Waste Bin”.<br><br>
Enable the Use area control to enable monitoring this detection area.<br><br>
Use the Temperature in area control to select ‘Warmest Spot’ and ‘Above’.<br><br>
Within the temperature field, enter 50°C (122°F)<br><br>
Open the Apps menu from the left-hand side of the screen.<br><br>
Enable the Early Fire Detection app.
NOTE: At the time of this writing, this app is a beta release, version 1.2.0.<br><br>
Select the Open button for the Early Fire Detection app. <br><br>
Examine each of the defined detection areas on the right-side of the screen to ensure they are active for early fire detection.<br><br>
exacqVision Use
Add the camera to your exacqVision Server, using the AXIS VAPIX Device Type, following the steps shown in How to Add IP Cameras – Manual Method.<br><br>
Select the camera from the left-hand navigation tree to reach the camera settings page.<br><br>
Select the Analytics tab from the bottom half of the page <br><br>
A panel lists each analytic from the camera, including each detection region you defined on the camera as well as an ‘AnyArea’ option which acts as an alert when any of the regions have been triggered. Users may define the appearance of bounding areas for each analytic separately.<br><br>
Users may also configure Event Linking or Event Monitoring actions to occur when any of these analytics are triggered. Use these to perform actions such as sending SMTP email notifications or change views for live viewers. More details on configuring Event Linking and Event Monitoring can be found in the exacqVision Client User Manual or the video links at the bottom of this page. <br><br>
This video reviews the Illustra IQ LPR model cameras for edge-based license plate recognition, covering installation best practices for reliable results and the camera’s use with the exacqVision VMS software.<br><br>
Chapters:<br>
00:00 Intro<br>
00:35 exacqVision Advantage<br>
00:47 Requirements & Hardware<br>
01:27 Installation Best Practices<br>
03:48 Camera Configuration<br>
08:54 Use with exacqVision<br>
<br>
When configured properly, exacqVision may be configured to react to Elgato Stream Deck to take actions, such as changing camera views or activating output alarms. This is made possible by exacqVision’s Serial Profile settings combined with Event Monitoring or Event Linking. This guide provides the steps needed to get started, which you may customize to suit your needs.
IMPORTANT: This guide is provided for user benefit, but Exacq Support will not provide assistance or troubleshooting for Stream Deck devices or Stream Deck software.
<br>
Stream Deck Configuration
Download and install the Stream Deck software, which includes drivers needed to recognize the device when plugged into your workstation as well as software used to customize its behavior.<br><br>
Open the Stream Deck software from the Start menu or system tray on the taskbar. Stream Deck has limited capabilities out of the box, but provides a marketplace where developers offer plugins to expand its functions, similar to adding apps to your mobile phone or tablet.<br><br>
With the Stream Deck software window open, access the Marketplace by selecting the Marketplace icon, which will open a web browser to the Marketplace page.<br><br>
Use the search field to find CommandSender, which at the time of this writing was the most capable plugin available for this purpose and free to download and install.<br><br>
Click on CommandSender in the search results, then select the Get button. Once installed, return to the Stream Deck software.<br><br>
Locate and expand the Custom section from your actions panel on the right, then expand the CommandSender item. Drag an instance of the Send Command action from the panel onto a button in your layout. This button is customized in the lower part of the window.<br><br>
Set the Communication Type to ‘TCP’.<br><br>
Enter the IP address of the system running your exacqVision Server into the IP Address field. The Port number defaults to ‘45671’, but you may customize this if that port is already being used on your system.<br><br>
In the Command Pressed field, enter something unique and descriptive to the action you want to take. In the pictured example we enter GoToCamera 09 because in later steps we will configure a camera panel to change when pressed. This text can be anything you’d like because you will pair it to an action in later steps.<br><br>
Next, add the code for a line feed, \x0a, to the end of your command. This is used to help separate commands when received by exacqVision.<br><br>
You will not use the Command Released field for use with exacqVision.<br><br>
Finally, you can choose to customize the icon using icons from Stream Deck, import icon packs from the Marketplace, or upload custom icons you’ve created. You also have an optional Title field.<br><br>
You may add as many instances of the CommandSender plugin to your button layout as you wish, but the Command Pressed field should be unique for each one. The IP Address and Port fields should be the same unless you are sending commands to different NVRs.<br><br>
<br>
exacqVision Serial Port Configuration
You will need Full Admin or Power User privileges on the system to perform the following steps. The steps in this section are performed only once on each NVR you are sending commands to.
Open the exacqVision Desktop Client application and enter Configuration mode by selecting the cog wheel icon in the upper-left corner.<br><br>
From the left-hand navigation panel, expand the system name, then select the Serial Ports node on the tree.<br><br>
Under the IP section, press the New button.<br><br>
In the new row that appears, enter something in the Name field, such as “Stream Deck”.<br><br>
Change the Use column to ‘POS’.<br><br>
Change the Profile field to ‘New…’.<br><br>
Change the Type field to ‘TCP Listener’.<br><br>
In the Address column field, enter the IP address of the workstation you have plugged your Stream Deck into.<br> NOTE: It is expected that you will connect the Stream Deck to a Client workstation, but if you are connecting it directly to the system running the exacqVision Server application, the IP Address used here and in CommandSender will be 127.0.0.1.<br><br>
In the Port field, enter the port number displayed in CommandSender, which by default is ‘45671’.<br><br>
The remaining fields are left as is.<br><br>
Because ‘New…’ was selected in the Profile column, when you press the Apply button you will be automatically taken to the Serial Profiles page to configure the profile described in the next section.<br><br>
<br>
exacqVision Serial Profiles Configuration
Begin by providing a descriptive Name to your Serial Profile.<br><br>
Test the ability to receive commands from the Stream Deck by pressing the configured CommandSender button on the panel. You should see the commands you configured on the button appear in the data window.<br><br>
For this use case you do not need to enter anything into the fields for SOT marker or EOT marker.<br><br>
Select the Event Keywords tab.<br><br>
Press the New button.<br><br>
In the String field, enter the text exactly as you entered when configuring the button in CommandSender, without the line feed code.<br><br>
Press Apply to save your changes.<br><br>
<br>
NOTE: If you need additional help with the configuration of Serial Ports or Serial Profiles, please see the exacqVision User Manual or refer to our User Training Videos on the Exacq Support Portal covering these features.
<br>
Event Monitoring and Event Linking
As this document is not intended to be a complete training guide on the use of exacqVision’s Event Monitoring and Event Linking features, we will provide a single example of changing a camera panel to display another camera when the button is pressed. Keep in mind that Event Monitoring provides client-side actions visible to the user of the workstation, such as changing camera panels, live Views, enabling audio, or digital PTZ presets, while Event Linking performs server-side actions, such as recording video, mechanical PTZ presets, auto exports, sending notifications, or triggering webhooks.
NOTE: For additional help with the configuration of Event Monitoring or Event Linking, please see the exacqVision User Manual or refer to our User Training Videos on the Exacq Support Portal on these features.
For this example:
Select the Event Monitoring node on the navigation tree, located near the top of the left-hand panel.<br><br>
Press the New button under the Profiles panel and enter a descriptive Name in the Profile Configuration area to the right.<br><br>
Change the Show Event List field to ‘On Event’.<br><br>
Check the Show Newest Event box.<br><br>
Set the Type selection to ‘Video Panel’.<br><br>
The first Client Action is added for you. Configure the default action by selecting ‘Default’ from the Event Type panel. Default events do not have an Event Source to select.<br><br>
From the Action Type panel, select ‘Switch Video’.<br><br>
Select a camera from the Action Target panel to display when nothing else is being triggered.<br><br>
Press the New button under the Client Actions panel in the middle of the window.<br><br>
From the Event Type panel, highlight ‘Serial Profile’.<br><br>
You may have many items listed on your system, or several systems to select from. The drop-down menu will filter to specific systems or show them all. Select the item displaying the name of the Serial Profile you created earlier with the Keyword you configured. The profile is monitoring the incoming data being sent from CommandSender on your Stream Deck for this Keyword.<br><br>
Select ‘Switch Video’ from the Action Type panel.<br><br>
Choose a camera from the Action Target panel that you want to display when the Stream Deck button is pressed.<br><br>
Next, you’ll set exacqVision to return to the Default camera after a set number of seconds rather than forcing a user to click in the Event List panel to acknowledge it each time.<br><br>
Uncheck the Confirm checkbox near the bottom of the window.<br><br>
Change the Timeout field to “5”.<br><br>
Press the Apply button to save your changes.<br><br>
<br>
Use the same Event Monitoring profile you just created to continue adding additional Client Actions for each CommandSender button you have configured on the Stream Deck.
Navigate to the Live view in the Client window to test your setup.
Drag several different cameras to the layout.<br><br>
Right-click one of the panels. In the menu that appears, expand Event Monitor, and select the name of the Event Monitoring profile you just created. The camera you configured as the Default should display. <br><br>
Press the CommandSender button you created on the Stream Deck. This camera panel should now change from the default camera to the camera you configured in your Event Monitoring profile with the Event Keyword.<br><br>
After the 5 second timeout period you set, the camera panel should return to the Default camera.
<br>
Opening the exacqVision Client
If you’d like to create a button on your Stream Deck to automatically open an instance of the exacqVision Client, this can be done without additional plugins or serial data configuration using the built-in Open action.
Within Stream Deck, perform the following:
Expand the System menu from the actions panel.<br><br>
Drag an instance of the Open action from the panel onto an empty button in the layout.<br><br>
Customize this instance near the bottom of the window.<br><br>
Provide an optional Title and/or customize the button’s icon.<br><br>
In the App/File field, either navigate to the edvrclient.exe file on your machine, or enter the path manually. The default path is C:\Program Files\exacqVision\Client\edvrclient.exe
Users of customized Client .XDV files may open instruct the Open action to open the client using their desired .XDV file by adding the file path to the file. e.g.- C:\Program Files\exacqVision\Client\edvrclient.exe -F"C:\Users\myUserName\Documents\myCustomFile.xdv"
Please do not direct customers to the ‘Can’t find Camera?’ or ‘Can’t find firmware?’ links on the IP Camera Integrations database page. L3 Support has a weekly meeting with Product Management to drive progress on enhancements, including camera test record updates and camera/firmware testing.
Troubleshooting
Verify network connectivity with the camera.
Can the device be pinged from the NVR?
Can the device be access from the NVR’s web browser?
Verify whether the device is on the tested firmware version.
Verify the use of the correct Device Type.
Check that the exacqVision Server instance is on the latest version.
Repeat Steps 3 & 4 after updating.
If the device is on a newer firmware version than test records indicate, do not assume that this is the cause of the issue.
If the device is capable of firmware downgrades, ask the customer to downgrade to an older version or to the tested version of exacqVision.
If the device has never been tested, does it work with the Onvif Device Type?
If the customer is satisfied with using Onvif, there is no need to escalate.
What issues require escalation?
If customer issues meet one or more of the following requirements, a Support ticket escalation is warranted:
An already supported camera model needs newer firmware tested due to issues found.
The camera has never been tested and a customer is requesting it to be listed as supported.
Incorrect information is found in the test record database or the records requires updating.
Escalation Requirements
Latest version of exacqVision Server.
Device is running the untested firmware version.
If device was previously tested, it must be added with the proper plugin.
If device has not been previously tested, add with Onvif.
Exported Support Diagnostics.
Perform a Wireshark capture and limit to a single device. Use a capture filter to limit the capture to data from the affected device IP and minimize the capture file size. (e.g.- ‘host 192.168.1.9’)
Disable the device
Start the capture
Re-enable the device and wait for connection attempt or issue to reappear
Axis offers a camera-based License Plate Verifier application for detecting and reading vehicle license plates. The data from the license plate captures may be viewed within the exacqVision Client as text, sent as serial over IP data. This document provides the steps to set up the integration with exacqVision.
NOTE: This guide is not meant to be a comprehensive guide for the Axis application itself. For greater details on licensing and configuration settings of the Axis License Plate Verifier, please refer to Axis support and documentation.
<br>
Requirements
Axis License Plate Verifier is currently supported on specific Axis camera models, using firmware 8.40 and higher. Visit Axis for a list of cameras compatible with this application.
<br>
Installing Axis License Plate Verifier
Mount the camera at the best viewing angle for license plate reading. (See User Manual for more information)<br><br>
Login to the camera’s web interface and access the Settings page.<br><br>
Depending on the camera firmware version, you may find the menu options along the bottom of the page or the side. Navigate to the Apps menu page.<br><br>
Select the Add or Add App option.<br><br>
Select the downloaded Axis License Plate Verifier application file.<br><br>
After successful upload, the Axis License Plate Verifier application will be shown in the list of installed apps.
<br>
Licensing
The Axis License Plate Verifier application requires licensing from Axis, purchased separately. Please contact Axis for license orders.
When purchasing, you may be provided with a license code. This code must be used to generate a license key and may be done in one of two ways.
Use the Axis License Key Registration page, to enter the serial number and license code. Download the generated license key file.
Use the automatic key generation feature of the application. This requires that the camera have direct internet connectivity to communicate with Axis.
Firmware 11.x
Select the vertical ellipses on the far-right side of the License Plate Verifier ribbon.
Choose either:
Activate with a license key to upload a key file
Activate license automatically to download from Axis
Enter the license code into the text field provided.
Press the Activate button
Firmware 10.x
Select the License Plate Verifier app
Choose either:
Use the center Install button to upload a key file
Enter the license code into the text field provided, and press the Install button beside it
<br>
Configuring the Application
Use the toggle switch to enable the application.
Wait for the Status to indicate the application is Running. Shown below are the indicators for firmware 11.x and 10.x.
Press the Open button to configure the application.
If presented with a setup wizard, select Skip.
<br>
The main menu for the application displays tabs for various configuration settings, as follows:
Event log – displays live video from the camera as well as a searchable history of detected plates. Press the Live button to display live video and live updates to the log.
List management – provides the ability to add plate numbers to Allow and Block lists for access control purposes.
Settings – camera image, event, and access control settings.
Integration – configuration settings to send license plate information to external systems.
Refer to the Axis License Plate Verifier documentation for greater details on each setting and optimization for best performance. Each installation site is unique, but a general order of steps to follow will likely include:
Select the Settings tab.<br><br>
exacqVision integration will not utilize the settings within the Access control section. These settings affect utilization of relays or the camera’s I/O ports to communicate directly with access control devices or compatible access control software.<br><br>
Within the Image panel, set the Resolution as needed.<br><br>
The Save full frame setting only affects images saved to the camera’s local storage and does not affect the streaming video received by exacqVision.<br><br>
Set the Region and Camera location based on the camera’s physical location to help optimize detection of plates expected to be read by the device.<br><br>
Use the Edit area of interest button to adjust the area the camera will look for license plates. Keep the area as small as possible, while permitting room for vehicles of various sizes and alignment to the entry/exit path.<br><br>
The Events section configures retention of events saved locally to the camera and does not affect the retention of data saved by exacqVision.<br><br>
The Detection parameters section allows users to determine how strict the device will be with regard to matching plates listed in the Allow and Block lists.<br><br>IMPORTANT: License plate character recognition accuracy may vary based on angle to camera, lighting and weather conditions, plate size, etc. These may be important considerations when used for access control.<br><br>
An Additional DataBETA is provided in License Plate Verifier versions 2.7.1 and higher to provide Country and Region of the plate. Enhancements in 2.9.19 and higher added Vehicle Type and Color. This data is included in the serial data regardless of being disabled and only controls the display of this data within Axis software.<br><br>
Utilize the Event log tab to monitor how changes to settings affect the ability to consistently match the license plates seen.
<br>
Sending Data to exacqVision
After configuring the License Plate Verifier application for best results, you must configure the application to send data to the exacqVision Server.
Within the License Plate Verifier application, select the Integration tab.<br><br>
Within the Push event panel, you will configure an active profile.<br><br>
Ensure the Protocol field is set to TCP.<br><br>
The Server URL field will be set to the IP address of your exacqVision Server, followed by a port number of your choosing to communicate with exacqVision. Example: 192.168.0.25:9080<br> NOTE: You will enter this port number later when configuring your exacqVision Server to receive communications from the app, and must be a port number unused by other applications or devices communicating with the server.<br><br>
You may choose to disregard the Device location settings if you’d like but the data entered here will be available in the data feed sent to exacqVision if you need to use it.<br><br>
The Device ID field may be disregarded as well, but may be helpful if multiple devices are in use. This data will also be available in the data feed sent to exacqVision.<br><br>
Under Event types, multiple options provide the ability to choose which data points are sent to exacqVision. New – first detection of a license plate Update – either a correction of a character on a previously detected license plate, or when a direction is detected as the plate moves and is tracked across the image. Lost – the last tracked event of the license plate before exiting the camera image, also contains the direction of the license plate.<br><br>
Depending on the version of License Plate Verifier you are using, enable the Do not send images or Do not send images through HTTP POST toggle control.<br><br>
Enable START to send event data to server.
<br>
exacqVision Serial Port Configuration
Configure the exacqVision Server software to receive the data sent from the License Plate Verifier app.
Open the exacqVision Client software and select the Configuration button (cog wheel icon).<br><br>
From the navigation tree along the left-hand side, expand the options shown beneath the name of the server.<br><br>
Select Serial Ports from the tree.<br><br>
Locate the IP connections panel and select the New button below it.<br><br>
Enter a helpful name to identify the connection. This example has named this “AxisLPR”.<br><br>
Select POS from the options in the Use column.<br><br>
Skip to the Type column and select TCP Listener.<br><br>NOTE: The TCP Listener type may never show ‘Connected’ in the Status column. This is normal. A TCP Listener sits and waits for data to be received and will only ever show ‘Connected’ while receiving data. However, the incoming data is often so fast as to be imperceptible. In between each burst of data received it returns to a waiting state of ‘Disconnected’.<br><br>
In the Address field, enter the IP address of the Axis camera you configured with the Axis License Plate Verifier in the steps above.<br><br>
Change the Max Line Length field to ‘250’. Some of the data sent by the application is rather long, providing file paths to files locally stored on the camera. The Max Line Length forces a new line when the specified number of characters is met. Making this large enough to accommodate long lines will make your job setting Line Masks easier in a later step.<br><br>
Return to the Profile column and select New. This will begin a new Serial Profile for you, configured in the next section. If you have a pre-existing profile for Axis License Plate Verifier, you may opt to select this instead.<br><br>
Press Apply.
<br>
exacqVision Serial Profile Configuration
The Serial Profile configuration determines how the incoming data is displayed or recorded and provides additional options for events, if needed.
Because New was selected from the Profile field in Serial Ports, a new profile is created automatically for you. Begin by changing the Name field to something descriptive for easy identification. The example shown has chosen to name this “AxisLPR”.<br> IMPORTANT: One of the most vital steps in getting Serial Profiles configured correctly is setting the SOT and EOT marker fields. These determine the beginning and end of each “transaction”. In the case of LPR these mark the start and end points of the data for each license plate detected by the camera.<br><br>
When configuring the SOT and EOT markers it can be helpful to enable the Show Raw Data checkbox to view hidden formatting characters. At the time of publishing this guide we are using Axis License Plate Verifier version 2.3-1 through 2.10.13. The data points provided by the License Plate Verifier may change with versions, as noted previously in Configuring the Application, Step 9. Below is a sample of the raw data provided from a single plate read using version 2.10.13 of the app.
Use the first line of the transaction to find a suitable SOT marker. In this case, the first line is {"packetCounter":"24947",\x0d\x0a. Watching the serial data, the packetCounter number changes with each transaction, so you should not use the entire line as the SOT. Instead enter just {"packetCounter" as the SOT to ensure that all transactions beginning with this string will be captured.<br><br>
Now find a suitable EOT marker. Note how each line is terminated with \x0d\x0a, these are invisible formatting characters to perform a line feed and return. This would make a poor EOT marker as it would separate every line as a new transaction. However, the last data point works well, "sensorProviderID":"defaultID"\x0d\x0a. Adding this to the EOT marker field properly marks the end of the transaction.<br><br>NOTE: Using Steps 3 and 4 will help you to correctly bracket serial transactions of any type or adapt to any changes in formatting from different versions of Axis License Plate Verifier.<br><br>
Leave the Parser and Marker Type fields as their default settings.<br><br>
Press the Apply button to save your changes.<br><br>
The Live Display tab allows you to view how the serial data overlay will appear on top of a live camera image or on an empty background and permits you to change the text formatting.
<br>
Line Masks
The Axis License Plate Verifier app sends several data points for each plate, some of which you may not wish to record or display to users of the exacqVision software. Line Masks hide all the text on any row with a matching string.
As an example, referring to the sample block of serial data in the previous section, one row begins with "imagesURI", listing the file path on the camera to the locally stored image. Most exacqVision users are unlikely to need this information. it may be hidden with the following steps.
Within the Serial Profile, select the Line Masks tab.<br><br>
Select the New button.<br><br>
In the empty row that is added, enter the text in the String column. In this example, the text entered is "imagesURI".<br><br>
The check boxes in the Live and Search columns for each text string determine where to apply the mask. If the box is checked for Live, the row will be hidden in Live view. If unchecked for Search, the row will still be displayed in serial search results. Checking both boxes will hide the row from both locations. In some cases it may be useful to hide data in Live, but leave it available in Search to perform forensic searches.<br><br>
Press Apply to save your changes.<br><br>
Repeat these steps as necessary for each line you wish to hide from Live or Search, using the Configuration or Live Display tabs to view your changes taking place.
<br>
String Replacements
In some cases you may find some text less human friendly. Selected text strings may be replaced to be more legible to users. Referring to the sample serial data block again, one of the data points provided is "plateRegion", which in the United States correlates with the State. This can be updated using the following steps:
Within the Serial Profile, select the String Replacements tab.<br><br>
Select the New button.<br><br>
In the empty row that appears, enter the text to be replaced in the String column. In this example it is "plateRegion". Including or excluding the surrounding parenthesis is your choice.<br><br>
In the Replace column, you will enter the text you wish to show instead. In this example is has been replaced with State.<br><br>
Just as with Line Masks, each entry has the option of being applied to Live or Search as you choose.<br><br>
Press Apply to save your changes.<br><br>
Repeat as necessary for each string of text you wish to replace in Live or Search, using the Configuration or Live Display tabs to view your changes taking place.<br>
NOTE: Line Masks and String Replacements do not support wildcard characters or regex expressions at this time. This means that you cannot reformat types of data which are different in every transaction, such as the date and time parameters. They will appear in the format send from the License Plate Verifier application.
<br>
Event Keywords
Keywords may be configured within exacqVision Serial Profiles to trigger user configured actions when the selected keyword is detected in the serial data feed. Example actions include recording video on detection of plates on the Block list, or sending a notification when a specific vehicle’s plate arrives. This guide provides two such examples below, each of which will then be configured with Event Linking in the following section.<br><br>
Example 1
In this example, there is more than one Axis camera running License Plate Verifier sending data to the exacqVision Server. You want to perform an action when activity is detected by one of the cameras. In this example the steps will record video.
Locate the "camera_info" field in the raw serial data, which contains the camera “SerialNumber” value. Make note of this value. <br><br>
Within the Serial Profile, select the Event Keywords tab.<br><br>
Select the New button.<br><br>
In the empty row that appears, enter the serial number value into the String column, and ensure the Enable checkbox is marked.<br><br>
Press the Apply button.<br><br>
Continue to the Event Linking or Event Monitoring sections below, for Example 1.
<br>
Example 2
Newer versions of the License Plate Verifier provide the "plateList" data point, which can tell you if the plate is on the Allow or Block list. However, older versions did not provide this. The steps in this example will use a workaround for this on older versions, then use this in Event Linking to send a notification.
Within the License Plate Verifier application, navigate to the List management page.<br><br>
Add a license plate number of interest to either the Allow or Block list. Leave the Description field empty for now. <br><br>
Return to the exacqVision Client and examine the raw serial data on the Serial Profiles page by checking the Show Raw Data checkbox.<br><br>
Locate the data property for “plateListDescription” and note that the value is empty. <br><br>
While the "plateListDescription" does not automatically contain any data, you can use the Description field to provide information for this or similar keyword uses.<br><br>
Return to the camera app on the List management page. Select the Edit icon for the previously entered license plate from Step 2 above. In the image below we have entered Deny beside the entry in the Block list. Save your change.<br><br>
Examine the raw data again in the exacqVision Serial Profile. The "plateListDescription" value will now display the description entered on the List management settings. You can now use this as an Event Keyword. <br><br>
Navigate to the Event Keywords tab in the Serial Profile.<br><br>
Select the New button.<br><br>
In the empty row that appears, enter the description used in the app in Step 6 above. In the image below, we have entered Allow and Deny as separate keywords. <br><br>
Select Apply.<br><br>
Continue to the Event Linking section below, for Example 2.
<br>
Event Linking
The Event Linking page provides the capability to automate server-side actions triggered by a wide range of events. Refer to the exacqVision Client User Manual or our Video Library for further details on configuring Event Linking beyond these examples.
The examples below continue from the numbered examples in the Event Keywords section above.
Example 1
This example continues from Event Keywords – Example 1 above to record from one of several Axis LPR cameras connected to the same exacqVision NVR.
Navigate to the Event Linking page within the exacqVision Client software.<br><br>
Select the New button near the bottom of the page.<br><br>
From the Event Type list, select Serial Profile.<br><br>
The Event Source list will display all Serial Profiles followed by the configured keywords available. Select the profile you intend to use as a trigger. In this example, we selected “AxisLPR – Keyword B8A44F0ADBE2”, where the keyword is the serial number.<br><br>
Select the Action Type from the next panel. In this example Record Video is selected.<br><br>
From the Action Target list, you will select the target, which in this example is the camera to be recorded when the keyword is detected in the serial data.<br> NOTE: Notice that we did not use the term “seen in the serial data”. The keywords may still be detected within the raw serial data, even if hidden from view by Line Masks or String Replacements.<br><br>
Press Apply to save your changes.
<br>
Example 2
This example continues from Event Keywords – Example 2 above with an example of sending a notification when a plate on the Block list is detected.
Navigate to the Event Linking page within the exacqVision Client software.<br><br>
Select the New button near the bottom of the page.<br><br>
From the Event Type list, select Serial Profile.<br><br>
The Event Source list will display all Serial Profiles followed by the configured keywords available. Select the profile you intend to use as a trigger. In this example, we selected “AxisLPR – Keyword Deny”, where Deny was previously entered as a keyword.<br><br>
Select the Action Type from the next panel. In this example, we have selected Notify.<br><br>
From the Action Target list, you will select the target, which in this example is a previously created Email Message Profile. NOTE: Sending a notification requires a successfully configured Email Server.<br><br>
Press Apply to save your changes.
<br>
Event Monitoring
Event Monitoring will not be covered in detail in this guide, but provides the ability to trigger client-side actions such as changing views on events. Refer to the exacqVision Client User Manual or our Video Library for further details on configuring Event Monitoring.
Example 1
This example continues from Event Keywords – Example 1 above as an illustration of changing the view displayed to the user when any license plate is read by the License Plate Verifier app.
This example requires at least two previously saved Views. One will display multiple camera panels to be shown to the user when no other activity is present. The second contain only the video from the Axis camera running the License Plate Verifier with the serial number entered as an Event Keyword in previous steps.
Navigate to the Event Monitoring page within the exacqVision Client software.<br><br>
Select the New button to create a new Event Monitoring profile.<br><br>
Enter a descriptive profile Name.<br><br>
Select On Event from the Show Event List setting.<br><br>
Check the Show Newest Event box.<br><br>
Select the View button from the Type field.<br><br>
Skip to the Event Type list near the bottom of the page and select Default.<br><br>
The Default type has no source option. Skip to the the Action Type panel and select Switch View.<br><br>
From the Action Target list, highlight the multi-camera view to be displayed when there is no activity.<br><br>
Uncheck the Confirm checkbox near the bottom of the screen.
Near the middle of the screen, under the Client Actions panel, press the New button.<br><br>
From the Event Type list, select Serial Profile.<br><br>
This example uses the serial number unique to the camera as the keyword to change Views. From the Event Source panel, locate the Serial Profile name followed by the camera’s serial number keyword and select it.<br><br>
Leave the Lasts at Least box unchecked.<br><br>
From the Action Type list, select Switch View.<br><br>
Use the Action Target list to select the view to change to. In the image below, this is our single camera view showing the Axis License Plate Verifier camera.<br><br>
If your Event Monitoring profile includes multiple view changes or LPR cameras, utilize the Priority setting to define which views take precedence.<br><br>
If the Confirm box is left checked, the view will not return to the Default view until the exacqVision user confirms they’ve taken note of the event. If unchecked, the Timeout setting determines how many seconds must elapse before automatically returning to the Default view.<br><br>
Press the Apply button at the bottom of the screen to save your changes.
Navigate to the Live view of the exacqVision Client.<br><br>
Activate the Event Monitoring profile by changing the left-hand navigation tree to Views. Scroll to the list of Event Monitors and drag the profile name to the live display panel. When data is received from the camera with that serial number, the view will automatically change to show that camera. Clearing events from the Event Monitor List that appears returns to the Default view.
<br>
Disable Client Indicator (optional)
Due to the nature of TCP Listeners only remaining periodically connected, as mentioned above in exacqVision Serial Port Configuration, Step 7, you may choose to disable the exacqVision Client Indicator message warning users of a loss in connection on the serial port.
Select Indicators from the left-hand navigation tree.<br><br>
If connected to multiple exacqVision Servers, select the system for which the Axis camera is sending license plate data.<br><br>
Locate the line item under Error that reads, “Serial port {Source Name} not connected on system {System Name}”, and uncheck the Enabled box for this item.
<br>
Serial Live View
After careful application of several Line Masks and a couple of String Replacements, the Live view provides just the information desired for the user. In this case, the Date/Time, license plate number, and State. Recall that the text may be formatted on the Live Display tab of the Serial Profiles page.
Navigate to Live view.<br><br>
Change the device list shown to Cameras.<br><br>
Find the name given to the Serial Port, then drag and drop it into a live camera panel to display serial data as it arrives. This can be done in an empty panel or as an overlay to live video.
<br>
Forensic Search
In the event you must search for a specific plate number, state, or other data, exacqVision provides the ability to search for serial data to expediate the process of locating events of interest.
Navigate to the Search page<br><br>
Checkmark the Serial Port providing the data you wish to search from the device tree on the left.<br><br>
Select the device(s) you intend to search. You may include more than one camera, in the pictured example we have only selected one.<br><br>
If you intend to search for specific terms in the serial data, enter this into the Search Serial text field provided. The drop-down allows you to select from previously used terms. This field is only provided when serial data devices are check marked for searching.<br><br>
Enter the dates and times of your Search Range into the provided fields.<br><br>
Press the Search button to populate the timeline with results.<br><br>
If you wish to see the serial data recorded, toggle the Show/Hide Keywords and Serial Data button.<br><br>
In the serial data explorer panel that appears note that the SOT and EOT markers configured in the Serial Profile affect the beginning and end of each transaction.<br><br>
Clicking on any of the transactions listed will move the playhead on the timeline to that event.<br><br>
Matches to serial data searched from Step 4 above, are highlighted.<br><br>
Matches to serial data searched will also thin the results of the serial data events displayed on the timeline.
<br>
Troubleshooting
Serial data includes massive block of random characters
Cause: The “ImageArray” block appears within the serial data feed when the camera is sending image data through the HTTP POST method.
Solution: Return to the Integration settings page of the License Plate Verifier app. Enable the Do not send images or Do not send images through HTTP POST setting.
On occasion, Exacq Support is asked about using a USB network interface (NIC) on their system. This is more frequently asked by those with smaller units which may have only one network interface and a user is attempting to add additional network interfaces to span networks or attempt to increase network throughput by bonding/teaming multiple NICs.
Regardless of the system model or size, Exacq does not support or test USB NICs.
Exacq Support will also not recommend any specific NICs for this usage. Even NICs connected externally using USB 3.0 or USB-C may encounter issues, therefore Exacq only supports internally connected network interface cards and does not troubleshoot issues with third-party devices added by users.
This document will guide you through step-by-step procedures for keyboard use and suggested button mappings.
Product
Axis TU9001 Control Board
TU9002 Joystick
TU9003 Keypad
The Axis TU9001 Control Board consists of the combination of the TU9002 Joystick and the TU9003 Keypad.
IMPORTANT: The TU9002 and TU9003 appear to the operating system as separate devices. As of Client version 24.03 only one Joystick device may be enabled on a workstation at a time. This article will be updated in the case of further enhancements.
<br>
Setup
Follow the Installation Guide from Axis for the steps to attach the two devices and connect the corresponding USB cables.<br><br>
Plug the keyboard’s USB cable into the USB port on the Client viewing machine, where the keyboard will be operated from.<br><br>
Navigate to the Joystick configuration page within the exacqVision Client.
Select the cog wheel icon in the top left-hand corner of the Client window to enter Configuration settings.
Expand Client from the navigation tree on the left-hand side.
Select Joystick from the tree to load the Joystick configuration page.<br><br>
Select the joystick that appears from the drop-down menu. If the device fails to appear, close and re-open the exacqVision Client instance. <br><br>
Select the Calibrate button to zero out the joystick positioning.<br><br>
Adjust the sensitivity to your liking.
X/Y Axis controls camera Pan/Tilt, while Z Axis controls zoom.
Suggested settings include increasing the sensitivity on the X/Y Axis and Z Axis.
<br><br>
Pressing any of the buttons on the keyboard will highlight that number in the button menu to help you find the corresponding mapping. You may need to scroll the window if you do not see the button highlighted when pressed. <br><br>
Once you have located the button, you may use the drop-down menu to select the action you wish to assign to the button.<br><br>
After applying changes to the keyboard configuration, return to the Live camera view and the controls will be available for use.
<br>
Buttons on the TU9002 Joystick
The TU9002 features 7 buttons across the top of the device and 2 buttons on top of the joystick. The center Toggle button along the top acts as a Function Key. When pressed this will highlight button 17 in the button map, but you should notice the illuminated LEDs shift on the device. This toggles the ability to assign additional actions to each of the other buttons on the device.
For example, when the buttons are illuminated above, pressing J1 will highlight button 1 in exacqVision. If the center button is pressed, the illumination shifts below the buttons. Pressing the same button now highlights button 9 in exacqVision. The actions available in exacqVision Joystick settings do not align with the rewind, play/pause, forward symbols indicated on the device.
The TU9002 Joystick also features the ability to switch between joystick and mouse modes. The default mode is set to act as a joystick. Switch to mouse mode by pressing and holding the center Toggle button then press the J1 button. Moving the joystick now moves the mouse cursor. While in mouse mode the J1, J5, and left joystick button act as a left-click. The J2, J6, and right joystick button act as a right-click. Press and hold the Toggle button then press the J1 button again to revert back to joystick mode.<br><br>
<br>
Troubleshooting
Check that the device is recognized by the operating system.
Windows – Navigate to Start > Control Panel > Game Controllers
Ubuntu/Linux – Open Terminal and run ‘lsusb’ to see if the devices are listed
Illustra Flex4 Indoor PTZ with bubble showing distorated images on zoom.
Product
Illustra Flex 4 PTZ all firmware
Steps to Reproduce
Turn off the Tilt Limit in the camera PTZ settings
Expected Results
Camera zoom shows in focus and sharp
Actual Results
Camera zoom is slightly disorted and out of focus
Solution
This is working as designed.
The camera datasheet indicate the tilt range is -15 to -90.
When you disable the tilt limit and move above -15 degree, you will see image distortion at zoon due to the camera looking through the ‘transition region’ of the bubble.
This article applies to the Axis I8116-E Network Video Intercom using firmware 11.8.66.
ExacqVision does not currently support SIP calling functions. However, this device can be integrated for interactive operation with ExacqVision as detailed here.
In the example that follows we will step through an example scenario wherein pressing the door station call button brings the door station camera to the attention of the ExacqVision operator to trigger a door lock.
The following topics are discussed:
Wiring an electric door strike to the door station
Adding the device to ExacqVision
Enabling Two-Way Audio
Adding Associations
Creating custom Views
Creating an Event Monitoring profile
You will combine several features and functions within the ExacqVision Client. It is recommended that users acquaint themselves with the ExacqVision Client prior to use. We provide User Training Videos on these topics.<br><br>
Wire a Door Strike
The simplest configuration is that of a single electric door strike, or maglock, wired directly to the door controller.
The Axis I8116-E can be wired in a number of different ways, using PoE, external power sources, A9801 Relay, A9161 Network I/O Relay, or an Axis access control system. For more information on the many wiring and hardware configurations please refer to the manufacturer’s website or documentation. <br><br>
Add the Device
You will want to use a web browser to log into the device and perform the initial setup, which at this state usually means setting a non-default username/password, and possibly setting a static IP address.<br><br>
The call button should be enabled by default. <br><br>
The device’s default settings create a ‘VMS’ entry under the Contact List menu. This ‘VMS’ contact will already be listed in the Recipients field. If you do not see this, enter it now.<br><br>
If you do not already know the IP address of the door station, you will need to discover it on the network.<br>
If using the Find IP Cameras tab on the Add IP Cameras page, note that you may find the device listed twice. Ignore results with a 169.254.x.x address. You will ant to use the IP address in the same range as your ExacqVision VMS, however this result may be discovered with ‘Onvif’ displayed in the ‘Type’ column. Access the discovered IP address in your web browser to set the username and password. <br><br>
Add the device manually by clicking the New button under the IP Camera List in the top half of the page. Select AXIS VAPIX from the Device Type Selector. Enter the IP address in the same range as your ExacqVision VMS, then enter the username and password credentials before clicking Apply to add the device. The device should display a ‘Connected’ status in the IP Camera List before continuing. <br><br>
Enable Two-Way Audio
Expand the Add IP Cameras node from the navigation tree.<br><br>
Select the Audio Inputs/Outputs node nested beneath the Add IP Cameras node.<br><br>
The resulting list displayed will show each door station device listed twice. Note the column, titled Audio. One of these rows shows ‘Audio,’ while the other displays ‘Audio Output.’ For easier identification we can apply our own labels here. We change ‘Audio Output’ to ‘Talk’ and change ‘Audio’ to ‘Listen.’ <br><br>
Find the Record Enable column. Place a check in the box for both of these rows for the device. This enables two-way audio functions within ExacqVision<br><br>
Press the Apply button to save your changes. Use the Talk and Listen buttons to verify audio is functioning and adjust the audio gain as desired in the door station’s web browser interface.<br><br>
IMPORTANT: Client workstations intended for use with two-way audio devices MUST have a microphone enabled. Two-way audio menus and controls are disabled or hidden until a microphone is recognized by the operating system. Each client workstation used for two-way audio must have its own microphone.<br><br>
Add Associations
You have the option of using soft triggers and audio controls from the top toolbar in live view, but these will open dialogues showing all system options. Controls that are used frequently and directly related to the specific camera being displayed in a panel may be easier for operators to use when added as Association buttons within the camera panel.
Select the Associations node from the navigation tree.<br><br>
The panel along the left lists existing cameras. Find and click to select the door station.<br><br>
From the Available Controls panel, we select the ‘Listen’ option we relabeled earlier and click Add. There will be two controls labeled ‘Talk’ that we relabeled earlier. Select and add the one showing the microphone icon.<br><br>
So that your ExacqVision operators can unlock the door remotely, find and add the control labeled ‘Door.’ Note: This control may be relabeled from within the door station’s web browser interface, but is labeled ‘Door’ by default for us.<br><br>
You should now have three Associated Controls listed. You may wish to edit the Button Style listed. ‘Sustained’ requires a click on, and another click to turn off. ‘Momentary’ functions only while a user is pressing down the button which will also prevent a user from accidentally forgetting to lock the door or leaving a microphone on. You may refer to the User Manual or Associations training video for more information on customizing your Associations.<br><br>
Click Apply to save your changes when done.
<br><br>
Create Custom Views
In our example we will create a View to display when triggered, rather than changing a single video panel. Learn more about these two options in the Event Monitoring training video. To make this work, we will create two custom Views to use later when creating an Event Monitoring profile. Refer to the Views training video if you need more details on performing these steps.
Select the Views node from the navigation tree.<br><br>
Click the New View button, then enter a descriptive name. In this example, we name our view ‘East Entry.'<br><br>
Select a layout for the view from the layout toolbar above. This view may have a single panel layout showing only the camera view from the door station, or you may use a multi-panel layout displaying the door station and other cameras showing the entry from different angles.<br><br>
Use the Available Items panel to find your door station camera and drag it to the empty panel in the layout. If using a multi-panel layout, fill the other panels as you like. <br><br>
Because the Associations are already displayed, an ExacqVision operator may easily enable/disable each when viewing in Live mode. However, if you’d like the Microphone or Speaker to be on automatically upon the view changing, you may also drag one of these onto the layout as well. Only one may be active.<br><br>
Click Apply to save you changes when done.<br><br>
Since we are changing the entire view displayed in Live mode, we will also want to create a view that is displayed when the door station is not in use. Repeat the steps above to create another view titled ‘Default View.’
<br><br>
Create an Event Monitoring Profile
Next you will create the Event Monitoring profile that changes the view displayed while in Live mode.
Select the Event Monitoring node from the navigation tree.<br><br>
Click the New button under the Profiles panel to begin creating a new profile.<br><br>
Enter a descriptive Name under the Profile Configuration panel. Our example will name this ‘East Entry’ for the door where it is being placed.<br><br>
The option you select for the Show Event List menu will depend on your intended use.
Never is the less obtrusive option as it hides the Event List from popping up in our view. The trade off for this is you will probably want to set Timeout later so the View changes back to the default display after a given amount of time. Without this, the displayed View will remain on the door station camera.
On Event will pop open the Event List window which some users do not like. However, the benefit of this is the ExacqVision user can decide when to return to the default View and the View will not change in the middle of being used simply because a timer ended. When the event is cleared the Event List window will disappear.
Always will always be displayed whether or not the door station is being utilized.<br><br>
Checking the Show Newest Event box is optional. This feature is most useful when many possible events are included in an Event Monitoring profile. An example may be a site with multiple door stations, in which case checking this box will change the view to display the station with the most recently pressed Call Button.<br><br>
As mentioned previously, this example will use ‘View’ from the Type field. Refer to the Event Monitoring training video for more on the ‘Video Panel’ option, which does not require creating custom Views.<br><br>
Under Client Actions in the middle of the window is where you will create the actions that occur when triggered by various events. Our first row, currently labeled ‘Unknown’ should already be highlighted because we are creating a new profile.<br><br>
From the Event Type panel list below, select ‘Default’.<br><br>
From the Action Type panel list, select Switch View. Note that you could also opt to make your default display a Tour, which is covered in the Tours training video.<br><br>
From the Action Target panel list, select the default View you created earlier.<br><br>
Click the New button under the Client Actions panel in the middle of the window. This adds a new row to configure.<br><br>
With the newly created row highlighted, select Input Trigger from the Event Type list.<br><br>
The door station has already named the input for you. Locate the door station in the list. It has several inputs, select the one labeled ‘Call button’. Do not enable the ‘Lasts at Least’ checkbox.<br><br>
From the Action Type list, select Switch View.<br><br>
From the Action Target list, select the door station View you created earlier. In our example we named this ‘East Entry’.<br><br>
Your next choice will depend on the option you selected from the Show Event List, in step 4, above.
If you chose Never and want the Live view to return to your default view after a set number of seconds, uncheck the Confirm box and set your Timeout as desired.
If you chose On Event or Always and want to allow your ExacqVision users to acknowledge the event to return to the default view, leave the Confirm box checked.<br><br>
Click the Apply button to save your changes when done.
<br><br>
Handling Calls From ExacqVision
Using the ExacqVision Client software, browse to Live mode.<br><br>
By default, the panel along the left side of the window displays a list of Live Cameras. Using the options at the bottom select Views to update this panel to Live Views.<br><br>
The Live navigation panel lists System Views, User Role Views, User Views, and System Tours, which includes any Views created earlier in the process of configuring our profile. Towards the bottom is a list of Event Monitors. <br><br>
Find the name of the Event Monitoring profile you created. Again, our example was named ‘East Entry’. Drag this profile to the cameras panel to the right.<br><br>
You should now be viewing your default View. When the Call Button on the door station is pressed the View will change to display the door station camera view you created earlier.<br><br>
The Association icons we added earlier can be seen at the bottom corner. The door station will continue to ring until an ExacqVision user presses the Talk button or the configured ring timeout is reached. <br><br>
Press the Talk button to transmit audio from your client workstation microphone to speak to door station users. Press the Listen button to hear door station users speaking.
Note: Audio from Talk and Listen actions may be buffered, presenting a delay. Practice with the system to gain a feel for this on your network.<br><br>
If you have correctly wired a door strike, maglock, or other electronic locking mechanism to the door station, pressing the icon for the output will unlock the door.
Note: Door controls may be customized within the door station’s web browser interface.<br><br
Door Station Visitor Operation
A visitor using the door station may simply press the Call Button to activate the Event Monitoring profile, as created above.<br><br>
The use case detailed in this article does not prevent the door station from being used for SIP calls.
Once a SIP server has been configured within the door station’s web browser interface, a SIP call may be initiated by pressing the Call Button.
Note: When used together with SIP, any press of the Call Button will continue to trigger an Event Monitoring profile configured to do so.<br><br>
<br><br>
<br><br>
<br><br>
<br><br>
<br><br>
<br><br>
<br><br>
<br><br>
<br><br>
<br><br>
<br><br>
<br><br>
<br><br>
<br><br>
<br><br>
<br><br>
<br><br>
<br><br>
<br><br>
<br><br>