Rule conditions

Conditions are parameters that govern when a rule breaks. They can be combined in a variety of ways to create custom rules.


Condition	Function
Engine data	Includes any of the following events: Active Fault: Measured as on or off (active faults only) Any Fault: Measured as on or off (active and inactive faults) Measurement or Data, which is measured by the reported value or diagnostic
Zone or zone type	Can be based on an individual zone or a zone type (customer, home, office, etc.). Includes the following events: Entering zone: Identifies when an asset is entering a zone (for example, arriving at a delivery location) Exiting zone: Identifies when an asset is exiting a zone (for example, leaving a delivery location) Outside zone: Identifies when an asset is outside of a zone (for example, a company vehicle isn't parked at the yard) Inside zone: Identifies when as asset is inside a zone (for example, the company vehicle is parked at the yard) Inside Any zone: Used for Public Works applications only. Stopped inside zone: Identifies when asset has stopped inside a zone (for example, the asset is making stops at delivery locations within a delivery zone)
Roads with speed limit	Sets a threshold for over or under a defined road speed limit.
Speed	Sets a threshold for over or under the defined speed.
Speed Limit	Defines the speed allowed over the posted limit. You can choose to include or exclude estimated speed limits, and specify the road speed provider (Commercial, Community, or All).
Duration	Defines the time for which a rule must be broken before a notification is triggered.
Distance	Defines the distance over which a rule is broken before a notification is triggered.
Device Ignition	Specifies whether the vehicle ignition must be on or off.
Device	Used to specify that the rule only applies to a specific device.
Driver	Used to specify that the rule only applies to a specific driver.
Driving	Used to specify that the asset must be driving for the rule to trigger.
Stop	Used to specify that the asset must be stopped for the rule to trigger.
Trip distance	Sets a trip distance threshold above, below, or equal to a specific value.
Trip duration	Sets a trip duration threshold above, below, or equal to a specific value.
Auxiliaries	Monitor on/off sensors or other external input devices connected to the telematics device.
After work hours rule	Used to indicate that the event must occur after the specified set of work hours.
Work hours rules	Used to indicate that the event must occur during the specified set of work hours.
After work hours device	Used to indicate that the event must occur after an asset's work hours.
Device work hours	Used to indicate that the event must occur during an asset's work hours.
Wrappers	Add the Is value more than/less than/equal to conditions that don't already require these values. Invert results inverts all conditions.
Logic	And is automatically added. It is used when using multiple conditions that must all be met in order to trigger an exception. Or is used when you want any single condition to trigger an exception. It must be added manually.

Safety conditions

Safety conditions monitor risky driving behavior such as speeding, harsh acceleration, harsh braking, and harsh cornering.

Seat belt and speeding

This condition will trigger an exception when the seatbelt is unbuckled and a driver is going faster than 10km/h.

Condition

Status Data Diagnostic "Driver seat belt (1 = unbuckled)" > 0 and Speed > 10 km/h

Advanced Conditions Editor

And(
    IsValueMoreThan[value=0](
        FilterStatusDataByDiagnostic[diagnostic=DiagnosticDriverSeatbeltId]
    ), 
    IsValueMoreThan[value=10km/h](
        Speed
    )
)

Speed limiter

This condition will trigger an exception when a driver is driving faster than 105 km/h for more than 5 seconds.

Condition

Duration of:

Speed > 105 km/h

> 5s

Advanced Conditions Editor

DurationLongerThan[time=5s](
    IsValueMoreThan[value=105km/h](
        Speed
    )
)

Speeding violations

This condition will trigger an exception when driving 10 km/h over the speed limit for more than 10 seconds.

Condition

Duration of:

(Speed compared to Speed Limit Excluding Estimates data) > 10 km/h

> 10s

Advanced Conditions Editor

DurationLongerThan[time=10s](
    IsValueMoreThan[value=10km/h](
        Speed,
        SpeedLimitExcludingEstimates
    )
)

Speeding violations (roads with speed limit)

This condition will trigger an exception when driving 10 km/h over any road with the speed limit of 105 km/h for more than 5 seconds.

Condition

Duration of:

(Roads with speed limit) > 105 km/h

> 5s

Advanced Conditions Editor

DurationLongerThan[time=5s](
   IsValueMoreThan[value=105km/h](
       Roads with speed limit,
       SpeedLimitAsMeasurement
   )
)

Acceleration

This condition will trigger an exception when a driver accelerates too quickly (0.35G in this example).

Condition

Status Data Diagnostic "Acceleration forward or braking" > 0.35 G

Advanced Conditions Editor

IsValueMoreThan[value=0.35G](
    FilterStatusDataByDiagnostic[diagnostic=DiagnosticAccelerationForwardBrakingId]
)

Braking

This condition will trigger an exception when the driver brakes too quickly (-0.4G in this example).

Condition

Status Data Diagnostic "Acceleration forward or braking" < -0.4 G

Advanced Conditions Editor

IsValueLessThan[value=-0.4G](
    FilterStatusDataByDiagnostic[diagnostic=DiagnosticAccelerationForwardBrakingId]
)

Cornering

This condition will trigger an exception when a driver corners too quickly (0.45G for this example).

Condition

Status Data Diagnostic "Acceleration side to side" > 0.45 G or Status Data Diagnostic "Acceleration side to side" < -0.45 G

Advanced Conditions Editor

Or(
    IsValueMoreThan[value=0.45G](
        FilterStatusDataByDiagnostic[diagnostic=DiagnosticAccelerationSideToSideId]
    ), 
    IsValueLessThan[value=-0.45G](
        FilterStatusDataByDiagnostic[diagnostic=DiagnosticAccelerationSideToSideId]
    )
)

Location conditions

Location conditions monitor vehicle activity in certain areas using zones.

Entering or exiting a zone

This condition will trigger an exception when a driver enters or exits a zone.

Condition

Entering Area "Office" or Exiting Area "Office"

Advanced Conditions Editor

Or(
        EnteringArea[zoneType=b3], 
        ExitingArea[zoneType=b3]
)

Outside zones parking

This condition will trigger an exception when the asset is parked outside of company zones for more than 1 day.

Condition

Duration of:

• Stop

> 1d and Outside Area "Company yard" and Outside Area "Office" and Outside Area "Yard Move"

Advanced Conditions Editor

And(
    And(
        DurationLongerThan[time=1d](
                    IsValueLessThan[value=0](
                        IsDriving
                    )
        ),
         OutsideArea[zone=b30],
        OutsideArea[zoneType=ZoneTypeOfficeId]
    ),
     OutsideArea[zoneType=b8],
)

Vehicle performance conditions

Vehicle performance conditions help your monitor activity that affects your vehicle's health, including battery drain, fuel level, and idling.

Vehicle warning light on

This condition will trigger an exception when the Vehicle Warning light turns on after a distance of 1000m.

Condition

Distance of Active Fault "General vehicle warning light is on" > 1000 m

Advanced Conditions Editor

DistanceLongerThan[distance=1000m](    
        Fault[diagnostic=DiagnosticGeneralVehicleWarningLightId]
)

Battery drain

This condition will trigger an exception when the battery is below 9V.

Condition

Status Data Diagnostic "Telematics device voltage" < 9 V

Advanced Conditions Editor

IsValueLessThan[value=9V](
        FilterStatusDataByDiagnostic[diagnostic=DiagnosticGoDeviceVoltageId]
)

Fuel level

This condition will trigger an exception when the fuel level is below 20L or below 20%.

Condition

Status Data Diagnostic "Fuel level (volume)" < 20 L or Status Data Diagnostic "Fuel level (percentage)" < 20 %

Advanced Conditions Editor

Or(
    IsValueLessThan[value=20L](
        FilterStatusDataByDiagnostic[diagnostic=DiagnosticFuelUnitsId]
    ), 
    IsValueLessThan[value=20%](
        FilterStatusDataByDiagnostic[diagnostic=DiagnosticFuelLevelId]
    )
)

Idling

This condition will trigger an exception when a vehicle is left idling for more than 3 minutes.

Condition

Duration of:

Duration Between GPS Logs < 3m and Speed < 5 km/h and Ignition is true

> 5m

Advanced Condition Editor

DurationLongerThan[time=5m](
    And(
        IsValueLessThan[time=3m](
            DurationBetweenGps
        ),
        And(
            IsValueLessThan[value=5km/h](
                Speed
            ),
            Ignition[true]
        )
    )
)

State of Charge <20% (EV)

This condition will trigger an exception when a vehicle’s charge is less than 20%.

Condition

Status Data Diagnostic "Generic state of charge" < 20 %

Advanced Conditions Editor

IsValueLessThan[value=20%](
    FilterStatusDataByDiagnostic[diagnostic=DiagnosticStateOfChargeId]
)

Tire pressure out of recommended area

This condition will trigger an exception when a vehicle’s tire pressure is outside of the recommended Pa.

Condition

Status Data Diagnostic "Tire pressure - front left" > 351000 Pa or Status Data Diagnostic "Tire pressure - front left" < 340000 Pa or Status Data Diagnostic "Tire pressure - front right" > 351000 Pa or Status Data Diagnostic "Tire pressure - front right" < 340000 Pa or Status Data Diagnostic "Tire pressure - rear left / rear left outer" < 351000 Pa or Status Data Diagnostic "Tire pressure - rear left / rear left outer" > 373000 Pa or Status Data Diagnostic "Tire pressure - rear right / rear right outer" < 351000 Pa or Status Data Diagnostic "Tire pressure - rear right / rear right outer" > 373000 Pa

Advanced Conditions Editor

Or(
   IsValueMoreThan[value=351000Pa](
        FilterStatusDataByDiagnostic[diagnostic=DiagnosticTirePressureFrontLeftId]
   ),
   IsValueLessThan[value=340000Pa](
        FilterStatusDataByDiagnostic[diagnostic=DiagnosticTirePressureFrontLeftId]
   ),
   IsValueMoreThan[value=351000Pa](
        FilterStatusDataByDiagnostic[diagnostic=DiagnosticTirePressureFrontRightId]
   ),
   IsValueLessThan[value=340000Pa](
        FilterStatusDataByDiagnostic[diagnostic=DiagnosticTirePressureFrontRightId]
   ),
   IsValueLessThan[value=351000Pa](
        FilterStatusDataByDiagnostic[diagnostic=DiagnosticTirePressureRearLeftId]
   ),
   IsValueMoreThan[value=373000Pa](
        FilterStatusDataByDiagnostic[diagnostic=DiagnosticTirePressureRearLeftId]
   ),
   IsValueLessThan[value=351000Pa](
        FilterStatusDataByDiagnostic[diagnostic=DiagnosticTirePressureRearRightId]
   ),
   IsValueMoreThan[value=373000Pa](
        FilterStatusDataByDiagnostic[diagnostic=DiagnosticTirePressureRearRightId]
   )
)