Adding your Echodyne radars as tracking systems to Security Center - Restricted Security Area Surveillance

RSA Surveillance Integration Guide for Echodyne Radar 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 Echodyne radar system in Security Center, you must add each Echodyne radar as a tracking system in Config Tool. If you are using the Inter-System Gateway (IS Gateway), you must first add your radar to a driver container in the IS Gateway, and then add the driver container as a tracking system in Config Tool.

Before you begin

Procedure

To add an Echodyne radar 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 Echodyne 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 Echodyne 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 Echodyne devices.
  5. In the Add/Edit device window that opens, enter the following information:
    IS Gateway web portal - Add/Edit device dialog box for Echodyne radars.
    Name
    Enter a unique name for this device.
    IP address
    Enter the IP address of the Echodyne radar.
    Status port
    Enter the port used to get the system status of the radar. The default port is 29979.
    Target data port
    Enter the port used to receive the targets from the radar. The default port is 29982.
    Set device orientation
    Manually
    Enter the Heading, Pitch, Roll, and Platform height of the radar manually.
    Semi-automatically
    Enter the Heading manually, and obtain the Pitch, Roll, and Platform height of the radar automatically.
    Automatically
    Obtain the Heading, Pitch, Roll, and Platform height of the radar directly from the radar.
    NOTE: The Automatically option is not recommended, because the radar can give imprecise measurements.
    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.
    Heading
    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 toward true North, set the orientation to 0 degrees. You can use a compass to find the degrees.
    Pitch
    The orientation of the device with respect to the floor. A pitch value of 0 degrees means that the device is looking at the horizon.
    Roll
    The orientation of the device with respect to the horizon. A roll value of 0 degrees means that the device is positioned horizontally.
    Platform height
    The height of the device from the floor, in meters.
  6. Click OK.
    The Echodyne radar is listed under Devices in the Communication section.
  7. Click Save.
  8. 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 an Echodyne radar as a tracking system to Security Center without the IS Gateway:

  1. Click Add an entity (), and then select Tracking system.
    The Add tracking system wizard opens.
  2. On the Tracking system information page, enter the following information:
    Type
    Select Echodyne.
    Name
    Enter a unique name for this tracking system.
  3. On the Communication page, enter the following information:
    IP address
    Enter the IP address of the Echodyne radar.
    Status port
    Enter the port used to get the system status of the radar. The default port is 29979.
    Target data port
    Enter the port used to receive the targets from the radar. The default port is 29982.
  4. Click Refresh connection status () to connect.
  5. When the connection status turns Online (), click Next page ().
  6. On the Specific configuration page, enter the following information:
    Set device position
    Select one of the following:
    Manually
    Enter the GPS coordinates of the radar manually.
    With map
    Select a georeferenced map from the Map list, and then click a location to place it on the map. The GPS coordinates are updated accordingly.
    Set device orientation
    Manually
    Enter the Heading, Pitch, Roll, and Platform height of the radar manually.
    Semi-automatically
    Enter the Heading manually, and obtain the Pitch, Roll, and Platform height of the radar automatically.
    Automatically
    Obtain the Heading, Pitch, Roll, and Platform height of the radar directly from the radar.
    NOTE: This option is not recommended because the radar can give imprecise measurements.
  7. On the RSA configuration page, enter the following information:
    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.
  8. Click Finish.
    The Echodyne radar and its devices are listed in the Area view entity tree.

After you finish

Create RSA zones.