Fitparser

Overview

Parses FIT formatted files and exports their contents using Serde. This code was heavily inspired by the python-fitparse module and uses the specifications defined by the Fit File SDK which is maintained by ANT.

The goal of this crate is to parse valid FIT files according to the defined FIT profile and export their data into a more usable format. To that end we leverage the Serde framework which allows end users to export the data in whatever format suits their needs. This library provides a fitdump executable for use and to serve as a template for any other serialization format implemented using Serde.

Notes:

• This library does not support writing FIT files at this time.
• Files with Developer Data fields can be parsed but the developer fields are dropped.

Features in Progress:

• Checking the CRC

Usage

TODO - Add when library API gets more finalized

Updating the FIT profile

All FIT files are generated based on a customizable profile. The profile used here is pulled from ANT's offical SDK which can be accessed here. To update the FIT profile set the environment variable FIT_PROFILE to the path of the desired Profile.xlsx file and then run cargo build. When this variable is not set cargo will simply emit a warning stating that the profile was not updated.

A profile file is not required for building the library as the files generated are committed to the repository. The profile only needs updated to support custom extensions or when ANT releases an updated version.