Securitas AeroScout

The Securitas AeroScout RTLS duress integrated system provides location identification and tracking.

Definitions

RTLS — Real-Time Location System

RTLS Events — These are events triggered by the Securitas AeroScout RTLS system, e.g., a tag entering or exiting a zone.

Setup

See the Data Servers page for information on configuring driver communication.

Compatibility

Securitas AeroScout is compatible with MobileView v5.7.20.

Prerequisites

Software Minimum Version
IPFusion — Securitas AeroScout RTLS 1.0
.NET Framework 4.7.2

When completing your setup, be sure to have the Securitas AeroScout documentation available for reference.

Ports

These ports must be open in your network firewall for the integration to work.

Purpose Default Value Configurable
Listener Port 9031 Yes
Dataserver 9697 Yes
Debug Tools 9698 No

Communication Configuration

In the integrated system configuration panel, you will find the Communication Settings. The following information is required:

Table 1. Connection Settings
Network Address The IP address where the MobileView server is located.
Network Port The port number used to communicate with the MobileView server.
Username The Username required to authenticate with the RTLS server.
Password The Password associated with the username.
Listener Port A port that is used to send Events via a HTTP Post from MobileView.

Location Paths

The Location Paths navigation menu allow users to create a hierarchy for building definitions that can be assigned to a Zone asset. It is the full path for the location of the zone. The hierarchy is as follows:

Building > Floor > Area > Zone

Once each of the building definitions has been assigned, navigate back to the Map and select the Zone asset. Under Location Path, find the name of the correct hierarchy to link the Zone asset to the Location Path.

Note: The same Building/Floor/Area/Zone names cannot be shared across different buildings.

Assets

Tag

Tag assets are not defined in Designer; however, a placeholder asset called the DefaultTag is available to enable the configuration of Workflows for tag assets. This asset is automatically added to the project on creation of an integrated system instance and will have a unique ID that counts towards the license limit. Alarms on this asset will display the zone it is located within. If the tag has initialized but not entered a zone yet, the zone listed is Unknown Zone. This will be updated once the tag enters a zone. If the tag leaves that zone area but does not enter a new one, the last known zone for the tag will be displayed.

View all properties

Supported States

No Communication Communication has been lost with the driver or asset. This status can also occur if the communication configuration for the system or asset is invalid.
Note: This status is required in all status tables.
Normal The asset is online and in its default state.
Acknowledged An asset alarm has been acknowledged.
Fault An issue has been detected in a connected asset.
Duress Call A tag has fired a duress call.

See the Configure a Status Table page for more information on configuring status tables.

Supported Commands

Acknowledge Acknowledge an asset alarm.
Reset Resets the asset to its true hardware state.
Cancel Deselects all selected assets.

See the Command Tables page for more information on configuring command tables.

Zone

A zone is an area on the RTLS system site map that can be used to identity the approximate location of tags on a Map. The zone assets behave uniquely for a few reasons:

  • Acts as a storage for a collection of tags that are defined by the Securitas AeroScout system. Each zone will only store the collection of tags that are currently in that specific zone.

  • Does not represent the status of the zone, but rather the status of the tags within the zone.

  • Does not have its own set of commands, but rather the commands of the tags in an alarm state within the zone.

  • If multiple tags are in an alarm state within a zone, the zone will display the tag with the highest priority followed by the oldest alarm that is unacknowledged.

  • A zone that has no tags in an alarm state is not available for selection.

Property Grid Fields

Table 2. Required
Location Path The full path for the location of the zone. It is formatted as: Building/Floor/Area/Zone.

View all properties

Supported States

No Communication Communication has been lost with the driver or asset. This status can also occur if the communication configuration for the system or asset is invalid.
Note: This status is required in all status tables.
Normal The asset is online and in its default state.
Acknowledged An asset alarm has been acknowledged.
Fault An issue has been detected in a connected asset.

See the Configure a Status Table page for more information on configuring status tables.

System

The system asset is a representation of the connection state of the RTLS system.

View all properties

Supported States

No Communication Communication has been lost with the driver or asset. This status can also occur if the communication configuration for the system or asset is invalid.
Note: This status is required in all status tables.
Normal The asset is online and in its default state.
Acknowledged An asset alarm has been acknowledged.
Fault An issue has been detected in a connected asset.

See the Configure a Status Table page for more information on configuring status tables.

Supported Commands

Acknowledge Acknowledge an asset alarm.
Cancel Deselects all selected assets.
Reset Resets the asset to its true hardware state.

See the Command Tables page for more information on configuring command tables.

Workflow Integration

Asset Events

Asset events are events used to trigger Workflow actions on an asset level. For more information about Workflows, see the Workflows section.

Tag Asset

On Tag Initialized

The tag has been initialized in Runtime.

Table 3. Properties
Tag ID

The unique identifier given to a Tag by the AeroScout system.
Zone Asset ID

The unique identifier given to a Zone asset that the tag is present in.

Zone Asset

All zone asset events can access the Last Tag Entered, Last Tag Exited, Highest Priority Tag In Alarm and Newest Tag In Alarm. The Caption and Logging Description on the following tag properties use the Tag ID along with the Caption and Logging Description of the zone the tag is in.

On Tag Entered
This event occurs when a tag enters a zone.
Table 4. Properties
Area

The area on the floor which the zone is located within
Building The building the zone is located within.
Contains Selected Tag

Whether the zone contains a tag that is currently selected.
Contains Tag In Alarm

Whether the zone contains a tag in an alarmed state.
Floor The floor of the building the zone is on.
Zone

The name of the zone.
On Tag Exited
This event occurs when a tag exits a zone.
Table 5. Properties
Area

The area on the floor which the zone is located within
Building The building the zone is located within.
Contains Selected Tag

Whether the zone contains a tag that is currently selected.
Contains Tag In Alarm

Whether the zone contains a tag in an alarmed state.
Floor The floor of the building the zone is on.
Zone

The name of the zone.
On Tag Alarm
This event occurs when a tag is in an alarmed state.
Table 6. Properties
Area

The area on the floor which the zone is located within
Building The building the zone is located within.
Contains Selected Tag

Whether the zone contains a tag that is currently selected.
Contains Tag In Alarm

Whether the zone contains a tag in an alarmed state.
Floor The floor of the building the zone is on.
Zone

The name of the zone.

System Commands

System commands are commands executed through Workflows at the system level. For more information about Workflows, see the Workflows section.

Update Asset Business Status

This command allows a user to update the business status of an asset in the MobileView server.

Table 7. Parameters
Name The Friendly Name of the targeted asset.
Application ID The ID assigned to the asset.
Business Status Name The name of the Business Status that will be updated in the MobileView system.

Troubleshooting

Logs from the driver and Runtime can be viewed in the Debug Tools client. These messages contain information which can provide further context for issues during initialization, or while actively running. This can help diagnose problems.

Connection Issues

  • Ensure Communication Settings and asset configuration is correct.
  • Ensure the system hardware is connected to the same network as Runtime.
  • Check if the Integrated System driver service is running.
  • Verify the Integrated System dataserver addresses are correct.
  • Ensure other software on the Workstation is not using the same port as the driver.