Currently there are 8 categories of events generated by the platform:
Alarm (
alarm)Command Result (
commandResult)Geofence (
geofenceEnter,geofenceExit)Ignition (
ignitionOn,ignitionOff)Maintenance (
maintenance)Motion (
deviceMoving,deviceStopped)Overspeed (
deviceOverspeed)Status (
deviceOnline,deviceOffline)
To forward those events to your own system / backend see https://powunity.atlassian.net/wiki/spaces/BTAPI/pages/163348682/BikeTrax+API#Webhook-Integration
Alarm
This type of event generated when a new position contains the alarm attribute. The device emits these alarms when it has been armed.
Command Result
Answers on commands (like arm / disarm) are stored in the result attribute. The platform generates this type of event if the position contains the result attribute.
...
BikeTrax devices can report the ignition status, which is the external power supply. When the bike is switched on, power for BikeTrax is switched on too and the “Ignition ON” event is generated (previous position contained attribute ignition false, current position contains attribute ignition true).
Ignition OFF Event is triggered if previous position contained attribute ignition true and current position contain contains attribute ignition false.
...
This event is generated if device started or stopped moving. The server analyzes If the speed from the incoming position and if the speed is more than event.motion.speedThreshold configuration parameter (default is 0.01 knots) then considered that BikeTrax is reported speed is more than 2km/h BikeTrax is considered moving, and if speed is less than that BikeTrax has stoppedis considered to have stopped.
| Note |
|---|
Currently, if there is no ignition status because there is no external power supply or the supply is not turned on, then there will be several stops recorded during a given bike ride. |
Overspeed
The server generates this event if device exceeds the configured speed limit. Speed limit value can be set via the device or group attribute speedLimit.
...
The server generates this event type when device status changes (online/offline/unknown). Online means that BikeTrax is connected to the server and sending reports. Offline means that BikeTrax is not connected to the server, or did not send anything in the past 3 minutes.
...