SelfSync

Event message

Event messages record everything that happens at a given moment of an activity: the timer starting and stopping, laps, alerts (heart rate, speed, power…), gear changes, rider position changes, radar threats, dive alerts and so on. The event and eventType fields tell what happened; the other fields hold the data specific to that kind of event.

FIT name
event
Global message number
21
JavaScript SDK key
eventMesgs
Fields
44

Fields

  • timestampDateTimes

    Moment the event occurred, in UTC.

  • eventEnum

    Kind of event: timer, lap, session, activity, workout step, course point, battery, gear change, rider position change…

    46 possible values
    • length
    • session
    • activity
    • workout
    • lap
    • workoutStep
    • coursePoint
    • battery
    • fitnessEquipment
    • timer
    • powerDown
    • powerUp
    • offCourse
    • virtualPartnerPace
    • hrHighAlert
    • hrLowAlert
    • speedHighAlert
    • speedLowAlert
    • cadHighAlert
    • cadLowAlert
    • powerHighAlert
    • powerLowAlert
    • recoveryHr
    • batteryLow
    • timeDurationAlert
    • distanceDurationAlert
    • calorieDurationAlert
    • userMarker
    • sportPoint
    • calibration
    • frontGearChange
    • rearGearChange
    • riderPositionChange
    • elevHighAlert
    • elevLowAlert
    • commTimeout
    • autoActivityDetect
    • diveAlert
    • diveGasSwitched
    • tankPressureReserve
    • tankPressureCritical
    • tankLost
    • radarThreatAlert
    • tankBatteryLow
    • tankPodConnected
    • tankPodDisconnected
  • What happened for the event: start, stop, stopAll, marker, begin or end of a depreciated range…

    10 possible values
    • stop
    • start
    • marker
    • consecutiveDepreciated
    • stopAll
    • beginDepreciated
    • endDepreciated
    • endAllDepreciated
    • stopDisable
    • stopDisableAll
  • data16Uint16

    Generic 16-bit value attached to the event, kept for compatibility.

  • dataUint32

    Generic value attached to the event, whose meaning depends on the event. Decoders expand it into the more specific fields of this message.

  • What started or stopped the timer: the user (manual), the device (auto pause) or the fitness equipment.

    3 possible values
    • auto
    • manual
    • fitnessEquipment
  • messageIndex of the course point reached, for course point events.

  • batteryLevelFloat64V

    Battery voltage of the device, for battery events.

  • Speed of the virtual partner.

  • hrHighAlertUint8bpm

    Heart rate above which the high heart rate alert is triggered.

  • hrLowAlertUint8bpm

    Heart rate below which the low heart rate alert is triggered.

  • speedHighAlertFloat64m/s

    Speed above which the high speed alert is triggered.

  • speedLowAlertFloat64m/s

    Speed below which the low speed alert is triggered.

  • cadHighAlertUint16rpm

    Cadence above which the high cadence alert is triggered.

  • cadLowAlertUint16rpm

    Cadence below which the low cadence alert is triggered.

  • powerHighAlertUint16watts

    Power above which the high power alert is triggered.

  • powerLowAlertUint16watts

    Power below which the low power alert is triggered.

  • Duration after which the time alert is triggered.

  • Distance after which the distance alert is triggered.

  • calorieDurationAlertUint32calories

    Calories after which the calorie alert is triggered.

  • State of the connected fitness equipment (treadmill, trainer…): ready, in use, paused or unknown.

    4 possible values
    • unknown
    • paused
    • ready
    • inUse
  • Packed score of a point, decoded into score and opponentScore.

  • Packed gear change data, decoded into frontGearNum, frontGear, rearGearNum and rearGear.

  • Position of the cyclist: seated, standing, or transitioning between both.

    4 possible values
    • seated
    • standing
    • transitionToSeated
    • transitionToStanding
  • Kind of communication timeout with a sensor: pairing timeout, connection lost or connection timeout.

    4 possible values
    • wildcardPairingTimeout
    • pairingTimeout
    • connectionLost
    • connectionTimeout
  • Kind of dive alert: NDL reached, ascent too fast, gas switch prompted, safety stop, battery low…

    39 possible values
    • batteryLow
    • tankBatteryLow
    • ndlReached
    • gasSwitchPrompted
    • nearSurface
    • approachingNdl
    • po2Warn
    • po2CritHigh
    • po2CritLow
    • timeAlert
    • depthAlert
    • decoCeilingBroken
    • decoComplete
    • safetyStopBroken
    • safetyStopComplete
    • cnsWarning
    • cnsCritical
    • otuWarning
    • otuCritical
    • ascentCritical
    • alertDismissedByKey
    • alertDismissedByTimeout
    • batteryCritical
    • safetyStopStarted
    • approachingFirstDecoStop
    • setpointSwitchAutoLow
    • setpointSwitchAutoHigh
    • setpointSwitchManualLow
    • setpointSwitchManualHigh
    • autoSetpointSwitchIgnored
    • switchedToOpenCircuit
    • switchedToClosedCircuit
    • po2CcrDilLow
    • decoStopCleared
    • apneaNeutralBuoyancy
    • apneaTargetDepth
    • apneaSurface
    • apneaHighSpeed
    • apneaLowSpeed
  • Duration of the activity detected automatically by the device.

  • Packed radar data, decoded into the radarThreat* fields.

  • Groups related events together, so that start and stop events of the same group can be paired.

  • scoreUint16

    Score of the user, decoded from sportPoint.

  • Score of the opponent, decoded from sportPoint.

  • Number of the front chainring, 1 being the innermost.

  • frontGearUint8z

    Number of teeth of the front chainring.

  • Number of the rear sprocket, 1 being the innermost.

  • rearGearUint8z

    Number of teeth of the rear sprocket.

  • Index of the device that produced the data, matching the deviceIndex of a device_info message. The value creator designates the recording device itself.

    1 possible value
    • creator
  • Broad type of activity (running, cycling, swimming, walking, fitness equipment…) the data relates to.

    10 possible values
    • all
    • running
    • transition
    • generic
    • cycling
    • fitnessEquipment
    • swimming
    • walking
    • sedentary
    • wheelchairPushing
  • Moment the event started, for events lasting a while.

  • Moment the automatically detected activity started.

  • Highest threat level detected by the rear radar: none, approaching or approaching fast.

    4 possible values
    • threatUnknown
    • threatNone
    • threatApproaching
    • threatApproachingFast
  • Number of vehicles detected by the rear radar.

  • Average approach speed of the vehicles detected by the rear radar.

  • Maximum approach speed of the vehicles detected by the rear radar.

  • mesgNumString

    Global message number identifying the kind of message. Decoders use it to know which profile to apply to the data.

Other activity messages

See all the FIT messages