Adding your Quanergy QORTEX server as a tracking system to Security Center - Restricted Security Area Surveillance

RSA Surveillance Integration Guide for Quanergy Lidar Systems

Applies to
Restricted Security Area Surveillance
Last updated
2024-02-12
Content type
Guides > Integration guides
Guides > Plugin and extension guides
Language
English
Product
Restricted Security Area Surveillance

Before you can monitor the restricted areas secured by your Quanergy lidar system in Security Center, you must add each Quanergy QORTEX server as a tracking system in Config Tool. If you are using the Inter-System Gateway (IS Gateway), you must first add your QORTEX server to a driver container in the IS Gateway, and then add the driver container as a tracking system in Config Tool.

Before you begin

What you should know

WARNING: If you move a lidar on the map in the Config Tool Map designer task, the targets are detected incorrectly. To reposition a lidar on the map, set the coordinates from the Quanergy tracking system's Properties page.

Procedure

To add your Quanergy QORTEX server as a tracking system to Security Center with the IS Gateway:

  1. Log on to the IS Gateway web portal:
    1. Open a web browser and enter the URL https://<GatewayServer>:4242.
      <GatewayServer> is the name or IP address of the server hosting the IS Gateway service. The default port is 4242. Use the port you configured at installation.
    2. Accept the security certificate.
    3. On the logon page, enter the Username and Password and click Sign in.
      The username and password were assigned during the Inter-System Gateway Configuration step of the IS Gateway service installation.
  2. Add a driver container for the tracking system that you want to add to Security Center:
    1. On the homepage of the IS Gateway, click the Container () tab.
    2. Click the button besides the docker engine label, and then click Add driver container.
    3. In the Add Driver Container window that opens, enter the following information:
      IS Gateway web portal - Add Driver Container dialog box.
      Driver
      Select the driver that you want to install.
      Version
      Select the driver version that you want. The latest version is selected by default.
      Label
      Label used to identify this driver container in the list of containers on the left.
      Port
      Port used to communicate with the driver.
      Network adapter
      Select the network adapter used by the driver to communicate with the IS Gateway service.
      Show advanced
      Some drivers require other communication ports to be open. If necessary, click here to add those ports.
    4. Click Add.
      The IS Gateway immediately downloads the required driver container image from the repository. A notification is shown in the upper right corner of the browser page during the download process.
      New driver creation notification for Quanergy in the IS Gateway web portal.

      After the download completes, the new driver container is displayed in the list of containers on the left, under the selected docker engine.

      IS Gateway web portal showing a new Quanergy driver container.
    5. Start the driver container. To do so, click the button beside the driver container label and click Start.
    NOTE: If you are adding multiple driver containers, make sure that each driver container has a unique port number. This will prevent any port conflicts if multiple driver containers are running at the same time.
  3. Select the driver container corresponding to the tracking system that you want to add to Security Center.
  4. In the Communication section, click Add ().
    IS Gateway web portal - Communication section for adding Quanergy M8 devices.
  5. In the Add/Edit device window that opens, enter the following information:
    IS Gateway web portal - Dialog box for adding Quanergy M8 devices.
    Name
    Enter a unique name for this device.
    Model
    Select M8 series QORTEX Sensor.
    IP Address
    The IP address of the Quanergy QORTEX server.
    Latitude and Longitude
    Enter the coordinates of the device. Coordinates are in decimal degrees using the World Geodetic System (WGS84) format. You can use a web site like https://www.latlong.net/ to find the coordinates of a specific civic address.
    Elevation
    Height of the device from the ground, in meters.
    Bearing
    If the device has a field of view, identify the physical orientation of the device using compass points. For example: If the device's field of view points towards true North, set the orientation to 0 degrees. You can use a compass to find the degrees.
  6. Click OK.
    The Quanergy device is listed under Devices in the Communication section.
  7. In the Events section under M8 series QORTEX Sensor Events, turn on the custom events that you want to monitor for this tracking system.
    IS Gateway web portal - Events section showing M8 series QORTEX Sensor events.
  8. Click Save.
  9. Add your driver container as a tracking system to Security Center:
    1. From the Config Tool homepage, open the Plugins task.
    2. From the entity tree, select the Restricted Security Area Surveillance plugin role.
    3. Click Add an entity (), and select Tracking system.
      The Add tracking system dialog box opens.
    4. From the Type drop-down, select Inter-System Gateway.
    5. In the Name field, enter a name for your tracking system.
    6. From the Model drop-down, select the driver container you are adding and click Next ().
    7. If applicable, configure the specific settings for your driver and click Next ().
    8. If applicable, import the map from the third-party application and click Finish.
    9. Open the Area view task.
      After a few seconds, your tracking system () should be added to the area view.

To add your Quanergy QORTEX server as a tracking system to Security Center without the IS Gateway:

  1. From the Config Tool homepage, open the Area view task.
  2. Click Add an entity (), and then select Tracking system.
    The Add tracking system wizard opens.
  3. On the Tracking system information page, enter the following information:
    Type
    Select Quanergy.
    Name
    Enter a unique name for this tracking system.
    Model
    The model of device that is supported by the RSA Surveillance plugin.
  4. On the Communication page, enter the following information:
    IP address
    The IP address of the Quanergy QORTEX server.
  5. Click Refresh connection status () to connect.
  6. When the connection status turns Online (), click Next page ().
  7. On the Specific configuration page, set the coordinates of the main lidar of your QORTEX server:
    Latitude and Longitude
    Enter the coordinates of the device. Coordinates are in decimal degrees using the World Geodetic System (WGS84) format. You can use a web site like https://www.latlong.net/ to find the coordinates of a specific civic address.
    With map
    To set the device's position using a map, select With map. In the Map list, choose a georeferenced map. From the map, zoom in and out as needed using the map controls. Click the map to place the device. After clicking the map, the Latitude and Longitude settings are updated with the coordinates from the map.
    Orientation
    If the device has a field of view, identify the physical orientation of the device using compass points. For example: If the device's field of view points towards true North, set the orientation to 0 degrees. You can use a compass to find the degrees. Or, select With map, click the green dot, and drag it to the device's orientation.
  8. On the RSA configuration page, enter the following information:
    Import on map
    Select the map that you want to use to display the devices in Security Center.
    Events
    Turn on the custom events that you want to monitor for this tracking system.
    NOTE: You can modify this later on the Properties page of the tracking system.
  9. Click Finish.
    The Quanergy QORTEX server and its devices are listed in the Area view entity tree.

After you finish

Create RSA zones.