FIT SDK Release Notes

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

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

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/