CenTrak TruView

The CenTrak TruView integrated system provides patient wandering and location tracking.

Definitions

RTLS — Real-Time Location System.

Tag — A tag is a physical device that tracks the location for people. There are two types in CenTrak — one for residents, and another for staff.

RTLS Events — These are events triggered by the CenTrak TruView system, e.g., a tag firing a duress alarm.

Setup

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

Compatibility

The CenTrak TruView integrated system is compatible with CenTrak TruView v5.0.0.12.

Prerequisites

Software Minimum Version
IPFusion — CenTrak TruView 1.0
.NET Framework 4.7.2
Important: Contact the CenTrak TruView team to have the API enabled on your system.

When completing your setup, be sure to have the CenTrak TruView documentation available for reference.

Ports

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

Purpose Default Value Configurable
Communication Settings 3008 Yes
Dataserver 9673 Yes
Debug Tools 9674 No

Communication Configuration

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

Table 1. Connection Settings
Address The address of the CenTrak TruView server.
Port The port for the connection to the CenTrak TruView server.
Table 2. Authentication
Username The username for the account used for the Runtime connection to CenTrak.
Password The password for the CenTrak TruView account.
Note: Red X indicates an invalid or out of range value given for field.

Assets

Tag

Tag assets are not defined in Designer. Instead, the tag assets are defined in the RTLS system and are automatically imported into Runtime. 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.

Supported States

Normal The asset is online and in its default state.
Fault An issue has been detected in a connected asset.
Acknowledged An asset alarm has been acknowledged.
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.
Resident Geo Pendant A duress alarm triggered by a resident tag.
Staff Geo Pendant A duress alarm triggered by a staff tag.
Roaming A resident tag has roamed into a disallowed area for that resident.

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 CenTrak TruView 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.

Required Property Grid Fields

IR ID The identifier of the zone within the CenTrak TruView system.

View all properties

Supported States

Normal The asset is online and in its default state.
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.
Fault An issue has been detected in a connected asset.
Acknowledged An asset alarm has been acknowledged.

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

Pull Cord

The pull cord asset represents a pull cord station in the CenTrak TruView integrated system.

Required Property Grid Fields

PullCord ID The identifier of the pull cord within the CenTrak TruView system.

View all properties

Supported States

Normal The asset is online and in its default state.
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.
Fault An issue has been detected in a connected asset.
Acknowledged An asset alarm has been acknowledged.
Pull Cord The cord on the station has been pulled.
Jack Button Press The pull cord station button has been pushed.
Jack Removal The pull cord has been removed from its station.

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

Normal The asset is online and in its default state.
Fault An issue has been detected in a connected asset.
Acknowledged An asset alarm has been acknowledged.
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.

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.

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.

Zone Asset

All zone asset events can access the Last Tag Entered, Last Tag Exited, Highest Priority Tag In Alarm, and Selected Tag Asset. The Caption and Logging Description on the tag properties use the tag IR ID.

On Tag Exited
This event occurs when a tag exits a zone.
Important: Tag location updates only occur while the tag is in a roaming or duress state.
Table 3. Properties
Item ID

The ID of the zone asset this trigger fired for.
Contains Selected Tag Whether this zone contains a tag that is currently selected.
Containing Tag in Alarm Whether the zone contains a tag in an alarmed state.
On Tag Entered
This event occurs when a tag enters a zone.
Important: Tag location updates only occur while the tag is in a roaming or duress state.
Table 4. Properties
Item ID

The ID of the zone asset this trigger fired for.
Contains Selected Tag Whether this zone contains a tag that is currently selected.
Containing Tag in Alarm Whether the zone contains a tag in an alarmed state.
On Tag Alarm
This event occurs when a tag is in an alarmed state.
Table 5. Properties
Item ID

The ID of the zone asset this trigger fired for.
Contains Selected Tag Whether this zone contains a tag that is currently selected.
Containing Tag in Alarm Whether the zone contains a tag in an alarmed state.

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.

Alarms not coming in Runtime for Second System Instance

This system does not currently support multiple instances. It is recommended to only use one instance for a project.

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.

Selected Asset Navigation not Working Correctly

When you select an asset in the alarm grid or via a Workflow, it automatically navigates you to that assets map. In the event this does not occur properly, it is likely your asset is either a duplicate, or hidden.

To see if your asset is a duplicate, check if other assets of that type contain the same settings. If you find that it is a duplicate, it is recommended to:

  1. Delete the extra asset.
    Note: If there are any references to this asset in Workflows, those will be broken by deleting this.
  2. If you wish to place this asset in multiple locations, right-click the remaining asset and select Copy.
  3. In the location you wish to duplicate this asset, right-click and select Paste. This will duplicate only the icon, but not the asset itself.

If your asset is hidden, it will not be navigated to on selection. If you do wish to navigate to a specific map, you can create a Workflow which changes the active map in a Map Container to the one desired.