Categories
Documentation Integrations exacqVision Client Categories Products exacqVision Integrations Uncategorized

Elgato Stream Deck Integration Guide

Overview

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

  1. 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>
  2. 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>
  3. 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>
  4. 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>
  5. Click on CommandSender in the search results, then select the Get button. Once installed, return to the Stream Deck software.<br><br>
  6. 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>
  7. Set the Communication Type to ‘TCP’.<br><br>
  8. 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>
  9. 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>
  10. 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>
  11. You will not use the Command Released field for use with exacqVision.<br><br>
  12. 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>
  13. 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.

  1. Open the exacqVision Desktop Client application and enter Configuration mode by selecting the cog wheel icon in the upper-left corner.<br><br>
  2. From the left-hand navigation panel, expand the system name, then select the Serial Ports node on the tree.<br><br>
  3. Under the IP section, press the New button.<br><br>
  4. In the new row that appears, enter something in the Name field, such as “Stream Deck”.<br><br>
  5. Change the Use column to ‘POS’.<br><br>
  6. Change the Profile field to ‘New…’.<br><br>
  7. Change the Type field to ‘TCP Listener’.<br><br>
  8. 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>
  9. In the Port field, enter the port number displayed in CommandSender, which by default is ‘45671’.<br><br>
  10. The remaining fields are left as is.<br><br>
  11. 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

  1. Begin by providing a descriptive Name to your Serial Profile.<br><br>
  2. 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>
  3. For this use case you do not need to enter anything into the fields for SOT marker or EOT marker.<br><br>
  4. Select the Event Keywords tab.<br><br>
  5. Press the New button.<br><br>
  6. In the String field, enter the text exactly as you entered when configuring the button in CommandSender, without the line feed code.<br><br>
  7. 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:

  1. Select the Event Monitoring node on the navigation tree, located near the top of the left-hand panel.<br><br>
  2. Press the New button under the Profiles panel and enter a descriptive Name in the Profile Configuration area to the right.<br><br>
  3. Change the Show Event List field to ‘On Event’.<br><br>
  4. Check the Show Newest Event box.<br><br>
  5. Set the Type selection to ‘Video Panel’.<br><br>
  6. 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>
  7. From the Action Type panel, select ‘Switch Video’.<br><br>
  8. Select a camera from the Action Target panel to display when nothing else is being triggered.<br><br>
  9. Press the New button under the Client Actions panel in the middle of the window.<br><br>
  10. From the Event Type panel, highlight ‘Serial Profile’.<br><br>
  11. 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>
  12. Select ‘Switch Video’ from the Action Type panel.<br><br>
  13. Choose a camera from the Action Target panel that you want to display when the Stream Deck button is pressed.<br><br>
  14. 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>
  15. Uncheck the Confirm checkbox near the bottom of the window.<br><br>
  16. Change the Timeout field to “5”.<br><br>
  17. 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.

  1. Drag several different cameras to the layout.<br><br>
  2. 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>
  3. 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>
  4. 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:

  1. Expand the System menu from the actions panel.<br><br>
  2. Drag an instance of the Open action from the panel onto an empty button in the layout.<br><br>
  3. Customize this instance near the bottom of the window.<br><br>
  4. Provide an optional Title and/or customize the button’s icon.<br><br>
  5. 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"

<br>

Categories
Documentation Integrations Categories Products exacqVision Integrations

Axis License Plate Verifier Serial Integration Guide

Overview

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

  1. Mount the camera at the best viewing angle for license plate reading. (See User Manual for more information)<br><br>
  2. Download the Axis License Plate Verifier application.<br><br>
  3. Login to the camera’s web interface and access the Settings page.<br><br>
  4. 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>
  5. Select the Add or Add App option.<br><br>
  6. Select the downloaded Axis License Plate Verifier application file.<br><br>
  7. 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

  1. Select the vertical ellipses on the far-right side of the License Plate Verifier ribbon.
  2. Choose either:
    1. Activate with a license key to upload a key file
    2. Activate license automatically to download from Axis
      1. Enter the license code into the text field provided.
      2. Press the Activate button

Firmware 10.x

  1. Select the License Plate Verifier app
  2. Choose either:
    1. Use the center Install button to upload a key file
    2. Enter the license code into the text field provided, and press the Install button beside it

<br>

Configuring the Application

  1. Use the toggle switch to enable the application.
  2. Wait for the Status to indicate the application is Running. Shown below are the indicators for firmware 11.x and 10.x.

  3. Press the Open button to configure the application.
  4. 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:

  1. Select the Settings tab.<br><br>
  2. 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>
  3. Within the Image panel, set the Resolution as needed.<br><br>
  4. 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>
  5. 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>
  6. 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>
  7. 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>
  8. 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>
  9. 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>
  10. 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.

  1. Within the License Plate Verifier application, select the Integration tab.<br><br>
  2. Within the Push event panel, you will configure an active profile.<br><br>
  3. Ensure the Protocol field is set to TCP.<br><br>
  4. 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>
  5. 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>
  6. 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>
  7. 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>
  8. 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>
  9. 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.

  1. Open the exacqVision Client software and select the Configuration button (cog wheel icon).<br><br>
  2. From the navigation tree along the left-hand side, expand the options shown beneath the name of the server.<br><br>
  3. Select Serial Ports from the tree.<br><br>
  4. Locate the IP connections panel and select the New button below it.<br><br>
  5. Enter a helpful name to identify the connection. This example has named this “AxisLPR”.<br><br>
  6. Select POS from the options in the Use column.<br><br>
  7. 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>
  8. 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>
  9. Use the Port field to enter the port number chosen in Step 4 of Sending Data to exacqVision above.<br><br>
  10. 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>
  11. 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>
  12. 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.

  1. 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>
  2. 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.
  1. 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>
  2. 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>
  3. Leave the Parser and Marker Type fields as their default settings.<br><br>
  4. Press the Apply button to save your changes.<br><br>
  5. 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.

  1. Within the Serial Profile, select the Line Masks tab.<br><br>
  2. Select the New button.<br><br>
  3. In the empty row that is added, enter the text in the String column. In this example, the text entered is "imagesURI".<br><br>
  4. 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>
  5. Press Apply to save your changes.<br><br>
  6. 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:

  1. Within the Serial Profile, select the String Replacements tab.<br><br>
  2. Select the New button.<br><br>
  3. 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>
  4. 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>
  5. Just as with Line Masks, each entry has the option of being applied to Live or Search as you choose.<br><br>
  6. Press Apply to save your changes.<br><br>
  7. 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.

  1. Locate the "camera_info" field in the raw serial data, which contains the camera “SerialNumber” value. Make note of this value.
    <br><br>
  2. Within the Serial Profile, select the Event Keywords tab.<br><br>
  3. Select the New button.<br><br>
  4. In the empty row that appears, enter the serial number value into the String column, and ensure the Enable checkbox is marked.<br><br>
  5. Press the Apply button.<br><br>
  6. 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.

  1. Within the License Plate Verifier application, navigate to the List management page.<br><br>
  2. Add a license plate number of interest to either the Allow or Block list. Leave the Description field empty for now.
    <br><br>
  3. 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>
  4. Locate the data property for “plateListDescription” and note that the value is empty.
    <br><br>
  5. 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>
  6. 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>
  7. 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>
  8. Navigate to the Event Keywords tab in the Serial Profile.<br><br>
  9. Select the New button.<br><br>
  10. 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>
  11. Select Apply.<br><br>
  12. 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.

  1. Navigate to the Event Linking page within the exacqVision Client software.<br><br>
  2. Select the New button near the bottom of the page.<br><br>
  3. From the Event Type list, select Serial Profile.<br><br>
  4. 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>
  5. Select the Action Type from the next panel. In this example Record Video is selected.<br><br>
  6. 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>
  7. 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.

  1. Navigate to the Event Linking page within the exacqVision Client software.<br><br>
  2. Select the New button near the bottom of the page.<br><br>
  3. From the Event Type list, select Serial Profile.<br><br>
  4. 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>
  5. Select the Action Type from the next panel. In this example, we have selected Notify.<br><br>
  6. 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>
  7. 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.

  1. Navigate to the Event Monitoring page within the exacqVision Client software.<br><br>
  2. Select the New button to create a new Event Monitoring profile.<br><br>
  3. Enter a descriptive profile Name.<br><br>
  4. Select On Event from the Show Event List setting.<br><br>
  5. Check the Show Newest Event box.<br><br>
  6. Select the View button from the Type field.<br><br>
  7. Skip to the Event Type list near the bottom of the page and select Default.<br><br>
  8. The Default type has no source option. Skip to the the Action Type panel and select Switch View.<br><br>
  9. From the Action Target list, highlight the multi-camera view to be displayed when there is no activity.<br><br>
  10. Uncheck the Confirm checkbox near the bottom of the screen.
  1. Near the middle of the screen, under the Client Actions panel, press the New button.<br><br>
  2. From the Event Type list, select Serial Profile.<br><br>
  3. 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>
  4. Leave the Lasts at Least box unchecked.<br><br>
  5. From the Action Type list, select Switch View.<br><br>
  6. 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>
  7. If your Event Monitoring profile includes multiple view changes or LPR cameras, utilize the Priority setting to define which views take precedence.<br><br>
  8. 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>
  9. Press the Apply button at the bottom of the screen to save your changes.
  1. Navigate to the Live view of the exacqVision Client.<br><br>
  2. 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.

  1. Select Indicators from the left-hand navigation tree.<br><br>
  2. If connected to multiple exacqVision Servers, select the system for which the Axis camera is sending license plate data.<br><br>
  3. 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.

  1. Navigate to Live view.<br><br>
  2. Change the device list shown to Cameras.<br><br>
  3. 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.

  1. Navigate to the Search page<br><br>
  2. Checkmark the Serial Port providing the data you wish to search from the device tree on the left.<br><br>
  3. 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>
  4. 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>
  5. Enter the dates and times of your Search Range into the provided fields.<br><br>
  6. Press the Search button to populate the timeline with results.<br><br>
  7. If you wish to see the serial data recorded, toggle the Show/Hide Keywords and Serial Data button.<br><br>
  8. 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>
  9. Clicking on any of the transactions listed will move the playhead on the timeline to that event.<br><br>
  10. Matches to serial data searched from Step 4 above, are highlighted.<br><br>
  11. 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.

<br>

Product Links

<br>

Categories
Knowledge Support Support exacqVision Client exacqVision Server Categories Products

TCP Listener not showing “Connected”

When adding an IP Serial Port, most of the time you will see the Status go to “Connected”

However, the Type “TCP Listener” does not actually connect to the device sending data. We are simply opening up on that port and waiting for any unencrypted data to show up.

Because of this the Status will remain “Connecting” indefinitely. This is the expected behavior.

This also means the Port Status of the Serial Profile will show “Connecting” as well.

Categories
Configuration Video Library exacqVision Client Youtube Video Library Categories Products

Serial Profiles

The Serial Profiles page allows you to configure how the serial data received is displayed as well as create rules to mask data, replace strings, or create keywords used to trigger system actions.