system:events [GPS Police Support Centre]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Device events ======
GPS Police devices report a large variety of events that are shown on the Now and History pages. Here is a detailed description of all the events you may see in HQ.

<panel type="default">
=== Check-in ===
<sup>Compatible with: Ping, Link </sup>

  * **Requires:** Ignition **or** Engine detection
  * **How it works:** when the vehicle is turned off (ignition or engine off), a timer will begin and when it reaches 3 hours (Ping), 4 hours (Link), an event called "Check-in" will happen.
  * **Purpose:** To let you know the device is still operating and where it currently is.
</panel>


<panel type="default">
=== Ignition detection ===
<sup>Compatible with: Ping, Link</sup>

**Ignition on**
  * **Requires:** the green ignition sense wire on the device wiring harness must be connected to the ignition circuit on the asset.
  * **How it works:** when the key is at the ignition ON position, the vehicle circuitry allows the vehicle or asset's engine to start. Ignition on also powers up the climate control and safety system in a vehicle. Ignition is not the same as the accessory circuit which is intended to power up the stereo or infotainment system.
  * **Purpose:** to know when the key is in the ignition and the intent of the driver is to have the engine start, running, and driving.
  * **Advantages:** when the ignition and engine are on, HQ will record and tally engine hours and mileage.

----
**Ignition off**
  * **Requires:** the green ignition sense wire on the device wiring harness must be connected to the ignition circuit on the asset.
  * **How it works:** when the key is at the ignition ON position, the vehicle circuitry allows the vehicle or asset's engine to start. Ignition on also powers up the climate control and safety system in a vehicle. Ignition is not the same as the accessory circuit which is intended to power up the stereo or infotainment system.
  * **Purpose:** to know when the key is in the ignition and the intent of the driver is to have the engine start, running, and driving.
  * **Advantages:** when the ignition and engine are on, HQ will record and tally engine hours and mileage.

</panel>




<hidden>
<panel type="primary">
=== Engine detection ===
<sup>Compatible with: Ping, Link</sup>

** Engine on **
    * Requires: the black and red wires must be connected to the voltage system (or battery) on the asset.
    * How it works: the device knows the voltage it's connected to. When the engine is running, the alternator in the vehicle or asset begins charging back the battery and power system. When this happens, the voltage increases.
    * Purpose: to know when the engine is running.
    * Advantages: key is in the ignition and the intent of the driver is to have the engine start, running, and driving.
    * The device has detected a rise in voltage in the entire system it's connected to. 99.99% of the time this indicates that the engine is running.

----
** Engine off **
    * Requires: the black and red wires must be connected to the voltage system (or battery) on the asset.
    * How it works: the device knows the voltage it's connected to. When the engine is running, the alternator in the vehicle or asset begins charging back the battery and power system. When this happens, the voltage increases.
    * Purpose: to know when the engine is running.
    * Advantages: key is in the ignition and the intent of the driver is to have the engine start, running, and driving.
    * The device has detected a rise in voltage in the entire system it's connected to. 99.99% of the time this indicates that the engine is running.

</panel>
</hidden>



<panel type="success">
=== Driving, Stop, Go ===
<sup>Compatible with: Ping, Link </sup>

** Go ** (see also Moving)
    * Requires: Ignition **or** Engine detection

    * The vehicle (device) is considered **go** if:
      * Ignition is on **or** Engine is on
      * Moving speed is above 20kph
      * Has been driving for at least 3 seconds
      * The previous state was a **Stop**

----
** Driving **
    * Requires: Ignition **and** Engine detection

    * The vehicle (device) is considered **driving** if:
      * Ignition is on and Engine is on
      * Moving speed is above 20kph 
      * Moving for greater than 3 seconds
      * **Driving updates will happen when (whichever happens first):**
        * The vehicle changes speed by 15-20kph
        * The vehicle changes course by 15-25 degrees
        * The vehicle has travelled 1000m
        * 120 seconds have elapsed

----
** Stop ** (see also Stationary)
    * Requires: Ignition **or** Engine detection

    * The vehicle (device) is considered **stopped** if:
      * Ignition is on **or** Engine is on
      * Moving speed is below 20kph (walking speed)
      * Has been ~stationary for at least 6 seconds
      * The previous state was **Driving** or a **Go**

</panel>




<panel type="info">
=== Stationary, Moving ===
<sup>Compatible with: Ping, Link </sup>

**Stationary** (similar to Idling)
    * Requires: Engine detection

    * The vehicle (device) is considered **Stationary** if:
      * Engine is **on** but ignition is off (or not detected)
      * Moving speed is below 5kph (less than walking speed)
      * Stationary (stopped) for at least 5 minutes

----
**Moving** (similar to Idle ended)
    * Requires: Engine detection

    * How it works. The vehicle (device) is considered **Moving** if:
      * Engine is **on** but ignition is **off** (or not detected)
      * Moving speed is above 5kph (greater than walking speed)
      * Moving for at least 2 second

</panel>

<panel type="warning">
=== Idling === 
<sup>Compatible with: Link </sup>


**Idling**
    * Requires: Ignition **and** Engine detection

    * The vehicle (device) is considered **Idling** if:
      * Ignition is on **and** Engine is on
      * Moving speed is below 5kph (walking speed)
      * Not moving for at least 5 minutes

----
**Idle ended**
    * Requires: Ignition **and** Engine detection

    * The vehicle (device) is considered **Idle ended** if:
      * Ignition is on **and** Engine is on 
      * Moving speed is above 5kph (walking speed)
      * Has been moving for at least 1 second
      * The previous state was **Idling** and the vehicle has begun moving
        * **or** the vehicle has been turned off (engine off and ignition off)

</panel>




<panel type="danger">
=== Speeding ===
<sup>Compatible with: Ping, Link </sup>

**Speeding**
    * Requires: Ignition **and/or** Engine detection

    * The vehicle (device) is considered **Speeding** if:
      * Ignition is on **and** Engine is on
      * Moving speed is over the posted speed limit. You can determine what kind of speeding is acceptable (ie. 10km over posted speed limit).

----
**Extreme Speeding**
    * Requires: Ignition **and/or** Engine detection

    * The vehicle (device) is considered **Extreme Speeding** if:
      * Ignition is on **and** Engine is on 
      * Moving speed is what speeding should never, ever occur (ie. 20km over the posted speed limit). You can determine how many km over is extreme speeding.
</panel>




<panel type="danger">
=== Possible theft emergencies ===
<sup>Compatible with: Ping, Link </sup>

**Power disconnected**
    * Requires: Constant power (engine) detection

    * The vehicle (device) is considered **Power disconnected** if:
      * Incoming power (vehicle battery) has been removed from the device for 30 seconds.
</panel>