SelfSync

Record message

Record messages are the time series of an activity: the device writes one every second (or using smart recording, when something changes), with everything it measures at that moment: GPS position, altitude, heart rate, speed, cadence, power, temperature and so on. They are by far the most numerous messages in an activity file and the source of every chart and map.

FIT name
record
Global message number
20
JavaScript SDK key
recordMesgs
Fields
85

Fields

  • timestampDateTimes

    Moment the values were measured, in UTC.

  • positionLatSint32semicircles

    Latitude. FIT stores coordinates as semicircles: multiply by 180 / 2^31 to get degrees.

  • positionLongSint32semicircles

    Longitude. FIT stores coordinates as semicircles: multiply by 180 / 2^31 to get degrees.

  • altitudeFloat64

    Altitude.

  • heartRateUint8bpm

    Heart rate.

  • cadenceUint8rpm

    Cadence: revolutions per minute for cycling, steps per minute for running.

  • distanceFloat64m

    Distance covered since the start of the activity.

  • speedFloat64

    Speed.

  • powerUint16watts

    Power output.

  • Speed and distance packed together in a compact format, decoded into speed and distance.

  • gradeFloat64%

    Current slope.

  • Resistance of the fitness equipment, from 0 (none) to 254 (maximum).

  • Time ahead of (negative) or behind (positive) the course or virtual partner.

  • cycleLengthFloat64m

    Distance covered per cycle (pedal revolution, stroke…).

  • Ambient temperature measured by the device.

  • speed1sFloat64[]m/s

    Speeds at 1 second intervals, the timestamp being the one of the last element.

  • cyclesUint8

    Number of cycles since the previous record, rolling over.

  • totalCyclesUint32cycles

    Total number of cycles since the start of the activity.

  • Running total of the power, in a compact format that rolls over.

  • accumulatedPowerUint32watts

    Running total of the power since the start, used to compute averages.

  • Power contribution of the right leg, when the right bit is set, as a percentage of the total. The left leg makes up the rest.

    2 possible values
    • right
    • mask
  • Estimated accuracy of the GPS position.

  • verticalSpeedFloat64m/s

    Vertical speed.

  • caloriesUint16kcal

    Energy expenditure.

  • Vertical oscillation: how much the torso moves up and down.

  • stanceTimePercentFloat64percent

    Ground contact time, as a percentage of the step duration.

  • stanceTimeFloat64ms

    Ground contact time of the step.

  • 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
  • Torque effectiveness of the left leg.

  • Torque effectiveness of the right leg.

  • leftPedalSmoothnessFloat64percent

    Pedal smoothness of the left leg.

  • rightPedalSmoothnessFloat64percent

    Pedal smoothness of the right leg.

  • Pedal smoothness of both legs combined, for single-sided power meters.

  • time128Float64s

    Time with a 1/128 second resolution.

  • Type of stroke, for racket sports: serve, forehand, backhand, smash…

    6 possible values
    • other
    • noEvent
    • serve
    • forehand
    • backhand
    • smash
  • zoneUint8

    Zone of the court or table the ball was hit to.

  • ballSpeedFloat64m/s

    Ball speed, for racket sports.

  • cadence256Float64rpm

    Cadence with its fractional part, kept for backwards compatibility.

  • Fractional part of the cadence, to add to it for a more precise value.

  • Total hemoglobin concentration in the muscle.

  • Minimum total hemoglobin concentration since the previous record.

  • Maximum total hemoglobin concentration since the previous record.

  • Muscle oxygen saturation (SmO2).

  • Minimum muscle oxygen saturation since the previous record.

  • Maximum muscle oxygen saturation since the previous record.

  • 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
  • leftPcoSint8mm

    Platform center offset of the left foot.

  • rightPcoSint8mm

    Platform center offset of the right foot.

  • leftPowerPhaseFloat64[]degrees

    Start and end angles of the left pedal stroke portion producing positive power.

  • leftPowerPhasePeakFloat64[]degrees

    Start and end angles of the left pedal stroke portion producing peak power.

  • rightPowerPhaseFloat64[]degrees

    Start and end angles of the right pedal stroke portion producing positive power.

  • rightPowerPhasePeakFloat64[]degrees

    Start and end angles of the right pedal stroke portion producing peak power.

  • enhancedSpeedFloat64m/s

    Speed, with a larger range than the speed field. Prefer it when present.

  • Altitude, with a larger range than the altitude field. Prefer it when present.

  • batterySocFloat64percent

    State of charge of the light electric vehicle (e-bike) battery.

  • motorPowerUint16watts

    Motor power of the light electric vehicle (e-bike).

  • verticalRatioFloat64percent

    Vertical oscillation divided by step length.

  • stanceTimeBalanceFloat64percent

    Ground contact time balance between left and right foot.

  • stepLengthFloat64mm

    Step length.

  • Distance covered per cycle, with a larger range for paddle sports.

  • Absolute pressure measured by the dive computer, atmospheric pressure included.

  • depthFloat64m

    Current depth. 0 when above water.

  • Depth of the next decompression stop.

  • Duration of the next decompression stop.

  • Time needed to reach the surface, decompression stops included.

  • ndlTimeUint32s

    No decompression limit: time left at the current depth before a decompression stop becomes mandatory.

  • cnsLoadUint8percent

    Central nervous system oxygen toxicity (CNS%).

  • n2LoadUint16percent

    Nitrogen tissue loading.

  • Respiration rate, in breaths per minute.

  • enhancedRespirationRateFloat64Breaths/min

    Respiration rate, in breaths per minute.

  • gritFloat32

    Current grit score: how difficult the trail is.

  • flowFloat32

    Current flow score: how smoothly the rider keeps their momentum.

  • Current stress level.

  • Estimated range left with the e-bike battery.

  • ebikeBatteryLevelUint8percent

    Battery level of the e-bike.

  • ebikeAssistModeUint8depends on sensor

    Assistance mode of the e-bike, whose values depend on the system.

  • Assistance level of the e-bike motor.

  • Estimated time left before the tank runs out of breathable gas.

  • pressureSacFloat64bar/min

    Surface air consumption based on tank pressure.

  • volumeSacFloat64L/min

    Surface air consumption based on gas volume.

  • rmvFloat64L/min

    Respiratory minute volume: volume of gas breathed per minute.

  • ascentRateFloat64m/s

    Current ascent rate.

  • po2Float64percent

    Current partial pressure of oxygen.

  • Core body temperature, from a core temperature sensor.

  • 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