FIT SDK Release Notes

The FIT SDK is available for download at https://developer.garmin.com/fit/download/

21.101

In this release:

JavaScript SDK - major version bumped from 0 (beta) to 21 (released)
Python SDK - major version bumped from 0 (beta) to 21 (released)
*** Moving forward the major and minor version of these SDKs will be in-sync with the other SDKs.

Profile additions in this release:

Added new manufacturer ids
- LSEC - renamed from ISEC, which was a typo
- Shaynue
- Porsche EP
Added new Garmin Product ids
- Marq Gen2 Aviator
- Marq Gen2 - all other variants
- Instinct 2 Crossover
Added new sport types
- Racket
- Water Tubing
- Wakesurfing
Added new sub-sport types
- Pickelball (used with Sport type Racket)
- Padel (used with Sport type Racket)
Added new messages
- Time In Zone
- Split
Added new types
- Split Type
- HR Zone Calc - Percent Lactate Threshold HR (LTHR) value
- Local Device Type - used with the Device Type field in the Device Info message
- BLE Device Type - used with the Device Type field in the Device Info message
Added Respiration Fields to:
- Session Mesg
- Lap Mesg
- Length Mesg
- Record Mesg
Added Enhanced Altitude Fields to
- Segment Point Mesg
- Segment Lap Mesg
  *** "Enhanced" fields use a larger data type than their counter part field; 32 bits instead of 16 bits, or 16 bits instead of 8 bits. Data from the counterpart field is copied to the enhanced field during decoding, except for the C SDK. Typically the enhanced fields should be used when present.

21.94

In this release:

New JavaScript SDK
- New Python SDK

Profile additions in this release:

Added new Manufacturer Ids
- ISEC
  - Lululemon Studio
- Added new Garmin Product ids
  - Edge 1040
  - Enduro2
  - Venu Sq 2
  - Venu Sq 2 Music

21.89

In this release:

FIT CSV tool improvements
- Options were added to convert semicircles to decimal degrees, and to convert FIT date-times to ISO-8601. Decimal degrees and ISO-8601 values in the CSV file will also convert back to FIT.
  See https://developer.garmin.com/fit/fitcsvtool/commandline/ for usage.
  - When using the -x option to print bytes as hex, 0x is appended to the value to allow the CSV file to be converted back to FIT.
  - Improved error handling when decoding FIT files. If an exception occurs while decoding a FIT file, a CSV file containing the data up to the point of the corruption will now be written out. Use the -d option (enable debug output) to print the error to the terminal.
  - General fixes for converting CSV files back to FIT.
- A new FIT Activity File Repair Tool was added to the Java SDK. The Activity Repair Tool can remedy the most common issues associated with corrupt or invalid FIT Activity files, so that the repaired file may be successfully uploaded to the desired fitness platform.
  See https://developer.garmin.com/fit/cookbook/activity-file-repair-tool/ for usage.

Profile additions in this release:

Added new Manufacturer Ids
- Tag Heuer
  - Keiser Fitness
  - Fazua
  - Oreka Training
- Added new Garmin Product ids
  - Forerunner 255
  - Forerunner 955
  - Vívosmart 5
  - HRM Pro Plus
  - Tactix 7
  - Edge Expore 2
- Added two dozen new Course Point Types
- Added secondary targets to Workout Step message

21.78

In this release:

The preexisting Objective-C SDK has been removed. It was replaced by new Objective-C SDK v21.67.
- The HR to Record Message plugin in the Java SDK has been updated to better handle heart rate values less than 60 bpm.

Profile additions in this release:

Added new Manufacturer Ids
- Decathlon
  - TQ Systems
  - True Fitness
  - RGT Cycling
  - Vasa
  - Race Republic
- Added new Garmin Product ids
  - Instinct 2
  - Fenix 7
  - Epix Gen 2
  - Descent G1
  - Venu 2 Plus
  - D2 Air X10

21.67

This release includes a new Objective-C SDK that is compatible with Swift. Information on using this SDK can be found at https://developer.garmin.com/fit/example-projects/objc/. This will be the last release that contains the preexisting Objective-C SDK, found under the cpp folder, that is not compatible with Swift.

Profile additions in this release:

Added new Manufacturer Ids
- GeoId
- Added new Garmin Product ids
  - Forerunner 945 LTE
  - Forerunner 55
- Added Sub-Sport Ids
  - Breathing
  - Ultra
  - Indoor Climbing
  - Bouldering
- Added ANT+ Device Type Id
  - Shifting
- Dive Summary Message, added five new fields
  - avg_ascent_rate
  - avg_descent_rate
  - max_ascent_rate
  - max_descent_rate
  - hang_time

21.60

Added new Manufacturer Ids
- Shimano
  - Coospo
  - Syncros
- Added ~30 Garmin Product ids
  - Venu 2
  - Approach
  - Backfilled missing product ids for previously released devices
- Added Sub-Sport Ids
  - Sail-Race
- Java SDK
  - Setting a string with a byte length greater than 254 bytes will now throw an exception. Previously a corrupt FIT file would be created.
  - DateTime class now implements the Comparable interface.
  - Added new FitDecoder, FitListener, and FitMessages classes. These classes work together to decode any type of FIT file with a few lines of code. See the FitDecoderExample class for usage.
  - New Java Example apps that mimic the C# recipes. See https://developer.garmin.com/fit/example-projects/java/ for usage.
    - Encode Activity
    - Encode Course
    - Encode Workout

21.47

Added an operator=() method to the DeveloperFieldDefinition class in the C++ SDK. This is to prevent a crash when encoding FIT files with developer fields.
- Updated the example Encode project in the C++ SDK to provide a better example of how to use Developer Fields when using the C++ SDK.
- New ids where added to the manufacturer list
  - SIGEYI

21.40

Diving has been added to the Sport enum
- New devices have been added to the Garmin Products enum
  - D2 Air
  - Forerunner 745
  - Forerunner 745 Asia
  - Venu Square
  - Venu Square Asia
- FIT SDK Cookbook
  - The FIT SDK Cookbook contains examples of using the FIT SDK to solve real-world problems. There are recipes for encoding and decoding Activity, Workout, and Course files; and recipes that provide tips for working with the FIT SDK.
  - For more information see https://developer.garmin.com/fit/cookbook/