Flexible and Interoperable Data Transfer (FIT) SDK
The Flexible and Interoperable Data Transfer (FIT) protocol is designed specifically for the storing and sharing of data that originates from sport, fitness and health devices. The FIT protocol defines a set of data storage templates (FIT messages) that can be used to store information such as user profiles, activity data, courses, and workouts. It is specifically designed to be compact, interoperable and extensible.
The FIT file protocol was designed to provide:
The following example use case illustrates one way that the FIT protocol is used to transfer activity data acquired during exercise to a cloud platform.
After the initial sensor data is collected, the FIT protocol provides a consistent format allowing all devices in the subsequent chain to share and use the data.
Step 1: Download the FIT SDK. The SDK includes: example programs to Encode and Decode FIT files in many popular programming languages; sample .FIT files; and the FitCSVTool for converting FIT files back and forth to .csv files for testing.
Step 2: The FIT File Types guide describes the predefined FIT File types which consist of common message groupings and best practices for each file type.
The FIT Profile (Profile.xls) lists all of the predefined FIT messages and FIT data types found in the FIT SDK. This document is useful for understanding the content and format of messages. Custom messages and files may also be generated for application specific cases. Profile.xlsx is updated with each release of the FIT SDK and is the most up-to-date and complete reference of the FIT Profile. Profile.xlsx is located at /path/to/fit/sdk/Profile.xlsx.
FitCSVTool is a command line tool used to convert binary FIT files to readable text files. Converting FIT files to text files may assist with the debugging of applications that encode or decode FIT files.
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 tips for working with the FIT SDK. The recipes are written in C#, but the concepts can be applied to the Java and C++ versions of the FIT SDK.
The FIT SDK includes Example Projects for each supported language. The example projects demonstrate how to incorporate the FIT SDK into Java, C#, C++, C, Swift, and Objective-C projects.
FitGen.exe is a Windows command line tool that can be used to customize the FIT SDK. FitGen can be used to add custom messages to the FIT SDK, or to optimize the C SDK for use in embedded applications.
Share your knowledge, ask questions, and get the latest FIT SDK news in the FIT Developer Forum.