TASSTA Documentation Center TASSTA Documentation Center More products
Hide table of contents Hide details Search My account

Lone worker protection behavior specification

Connection states

  • Connected
    This is the state where a client is connected to the T.Lion server and services (for example, State.Synchronized in T.Flex Android).
  • Network lost
    The client has lost its network connection to the T.Lion server and services and has not been able to restore it for 5 seconds.

Feature configuration and dependencies

State diagram

Lone worker protection state diagram

Lone Worker Protection feature

Made Inactive by the following combination of options:

  • Server: Lone Worker Protection = enable
  • User: Lone Worker Protection = enable

Disabled otherwise.

The state of Lone Worker Protection is changed from Inactive to Active by any of the LWP Emergency sub-features being activated.

Sensor Check precondition for Lone Worker Protection

The result of the sensor check affects whether or not Lone Worker Protection is enabled. However, this precondition is waived if vehicle mode is turned on.

Sensor Check is set to Passed by the following property:

  • SensorCheck.passed

Sensor Check is in Vehicle Mode in the event of:

  • lwp:is_vehicle

Sensor Check is Not Passed otherwise.

Dispatcher precondition for Lone Worker Protection

The availability of a dispatcher (meaning a T.Rodon operator at their workstation) affects whether or not Lone Worker Protection is enabled. However, this precondition is waived if the configuration specifies that the dispatcher is not required.

Dispatcher is set to Not Required by the following option:

  • Server: Dispatcher Required = disable

Dispatcher is set to On by the following combination of options:

  • Server: Dispatcher Required = enable
  • lwp:dispatcherUserOnline

Off otherwise.

The Dispatcher status is handled by the lwp service. The client receives status updates either through the use of the sync method of LwpDispatcher/ConnectedUsers structures or through the SSE "dispatcher" event.

The Dispatcher status is silently set to On if Dispatcher is in the Not Required state, but the Dispatcher system notification is not displayed in this case.

The Dispatcher status is volatile so a Sensor Check can be passed no matter whether Dispatcher is On or Off. The client stores the Sensor –°heck result in order to try LWP activation as soon as the Dispatcher starts.

Sensor Check is silently Passed automatically if Vehicle Mode is On. The Sensor Check dialog and notification are not displayed in this case.

Emergency LWP

This feature is Enabled when Lone Worker Protection and one or more of the emergency sub-features (listed below) are Enabled. It is Disabled otherwise.

Available emergencies:

  • LWP Disconnect Emergency
  • LWP Man Down Emergency
  • LWP Movement Emergency
  • LWP Periodic Check Emergency
  • LWP Fall Emergency
  • LWP Battery Warning Emergency
  • LWP Battery Alarm Emergency
  • LWP Yellow Alarm Emergency
Note:

A Yellow Alarm is a timed alarm. Unlike other LWP Emergencies, it is not triggered by a sensor but by letting a timer run out.

Emergency feature

This feature should not be confused with Emergency LWP. For Emergency, it doesn't matter if Lone Worker Protection is enabled. However, historically T.Commander groups Emergency settings with the Lone Worker Protection-related options.

Emergency is set to Enabled by the following option:

  • User: Make Emergency Call = enable

Disabled otherwise.

When Emergency is Enabled, the following sub-features can be turned on:

  • Emergency SOS
    Automatic
  • Emergency GSM Call
    Lone workers: Emergency GSM Call = enabled
  • Emergency SMS
    Lone workers: Emergency SMS = enabled
  • Emergency Email
    Lone workers: Emergency Email = enabled

State-specific behavior

What happens Response if LWP is disabled Response if LWP is inactive Response if LWP is active
Connected (login or first connection) None
  • Show the Dispatcher on/off notification
  • Play the Dispatcher sound
  • Show the Sensor Check dialog
  • Show the Sensor Check notification
  • Show the Sensor Check dialog
  • Show the Sensor Check notification
Connected (reconnection) None
  • Show the Dispatcher on/off notification
  • Play the Dispatcher sound
  • Show the Sensor Check dialog
  • Show the Sensor Check notification
None
Network lost None None None
Emergency LWP
(LWP sensor-initiated emergency or Yellow Alarm)
None None
  • Emergency GSM Call
- OR -
  1. Sensor-specific LWP Emergency (such as LWP Man Down or LWP Battery Alarm)
  2. Emergency SMS
  3. Emergency Email
Emergency
(initiated by the user while offline)
Unrelated to LWP, so its state doesn't matter.
  • Emergency GSM Call
- OR -
  1. Emergency SOS
  2. Emergency SMS
Emergency
(initiated by the user while online)
Unrelated to LWP, so its state doesn't matter.
  • Emergency GSM Call
- OR -
  1. Emergency SOS
  2. Emergency Email