Skip to content

Garmin FIT SDK 21.189.0 #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Lijah99 merged 1 commit into from
Jan 12, 2026
Merged

Garmin FIT SDK 21.189.0 #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
315 changes: 315 additions & 0 deletions src/examples/examples/decode/decode.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,315 @@
////////////////////////////////////////////////////////////////////////////////
// The following FIT Protocol software provided may be used with FIT protocol
// devices only and remains the copyrighted property of Garmin Canada Inc.
// The software is being provided on an "as-is" basis and as an accommodation,
// and therefore all warranties, representations, or guarantees of any kind
// (whether express, implied or statutory) including, without limitation,
// warranties of merchantability, non-infringement, or fitness for a particular
// purpose, are specifically disclaimed.
//
// Copyright 2008 Garmin Canada Inc.
////////////////////////////////////////////////////////////////////////////////

#include <fstream>
#include <iostream>

#include "fit_decode.hpp"
#include "fit_mesg_broadcaster.hpp"
#include "fit_developer_field_description.hpp"

class Listener
: public fit::FileIdMesgListener
, public fit::UserProfileMesgListener
, public fit::MonitoringMesgListener
, public fit::DeviceInfoMesgListener
, public fit::MesgListener
, public fit::DeveloperFieldDescriptionListener
, public fit::RecordMesgListener
{
public:

static void PrintValues(const fit::FieldBase& field)
{
for (FIT_UINT8 j=0; j< (FIT_UINT8)field.GetNumValues(); j++)
{
std::wcout << L" Val" << j << L": ";
switch (field.GetType())
{
// Get float 64 values for numeric types to receive values that have
// their scale and offset properly applied.
case FIT_BASE_TYPE_ENUM:
case FIT_BASE_TYPE_BYTE:
case FIT_BASE_TYPE_SINT8:
case FIT_BASE_TYPE_UINT8:
case FIT_BASE_TYPE_SINT16:
case FIT_BASE_TYPE_UINT16:
case FIT_BASE_TYPE_SINT32:
case FIT_BASE_TYPE_UINT32:
case FIT_BASE_TYPE_SINT64:
case FIT_BASE_TYPE_UINT64:
case FIT_BASE_TYPE_UINT8Z:
case FIT_BASE_TYPE_UINT16Z:
case FIT_BASE_TYPE_UINT32Z:
case FIT_BASE_TYPE_UINT64Z:
case FIT_BASE_TYPE_FLOAT32:
case FIT_BASE_TYPE_FLOAT64:
std::wcout << field.GetFLOAT64Value(j);
break;
case FIT_BASE_TYPE_STRING:
std::wcout << field.GetSTRINGValue(j);
break;
default:
break;
}
std::wcout << L" " << field.GetUnits().c_str() << L"\n";;
}
}

void OnMesg(fit::Mesg& mesg) override
{
printf("On Mesg:\n");
std::wcout << L" New Mesg: " << mesg.GetName().c_str() << L". It has " << mesg.GetNumFields() << L" field(s) and " << mesg.GetNumDevFields() << " developer field(s).\n";

for (FIT_UINT16 i = 0; i < (FIT_UINT16)mesg.GetNumFields(); i++)
{
fit::Field* field = mesg.GetFieldByIndex(i);
std::wcout << L" Field" << i << " (" << field->GetName().c_str() << ") has " << field->GetNumValues() << L" value(s)\n";
PrintValues(*field);
}

for (auto devField : mesg.GetDeveloperFields())
{
std::wcout << L" Developer Field(" << devField.GetName().c_str() << ") has " << devField.GetNumValues() << L" value(s)\n";
PrintValues(devField);
}
}

void OnMesg(fit::FileIdMesg& mesg) override
{
printf("File ID:\n");
if (mesg.IsTypeValid())
printf(" Type: %d\n", mesg.GetType());
if (mesg.IsManufacturerValid())
printf(" Manufacturer: %d\n", mesg.GetManufacturer());
if (mesg.IsProductValid())
printf(" Product: %d\n", mesg.GetProduct());
if (mesg.IsSerialNumberValid())
printf(" Serial Number: %u\n", mesg.GetSerialNumber());
if (mesg.IsNumberValid())
printf(" Number: %d\n", mesg.GetNumber());
}

void OnMesg(fit::UserProfileMesg& mesg) override
{
printf("User profile:\n");
if (mesg.IsFriendlyNameValid())
std::wcout << L" Friendly Name: " << mesg.GetFriendlyName().c_str() << L"\n";
if (mesg.GetGender() == FIT_GENDER_MALE)
printf(" Gender: Male\n");
if (mesg.GetGender() == FIT_GENDER_FEMALE)
printf(" Gender: Female\n");
if (mesg.IsAgeValid())
printf(" Age [years]: %d\n", mesg.GetAge());
if ( mesg.IsWeightValid() )
printf(" Weight [kg]: %0.2f\n", mesg.GetWeight());
}

void OnMesg(fit::DeviceInfoMesg& mesg) override
{
printf("Device info:\n");

if (mesg.IsTimestampValid())
printf(" Timestamp: %d\n", mesg.GetTimestamp());

switch(mesg.GetBatteryStatus())
{
case FIT_BATTERY_STATUS_CRITICAL:
printf(" Battery status: Critical\n");
break;
case FIT_BATTERY_STATUS_GOOD:
printf(" Battery status: Good\n");
break;
case FIT_BATTERY_STATUS_LOW:
printf(" Battery status: Low\n");
break;
case FIT_BATTERY_STATUS_NEW:
printf(" Battery status: New\n");
break;
case FIT_BATTERY_STATUS_OK:
printf(" Battery status: OK\n");
break;
default:
printf(" Battery status: Invalid\n");
break;
}
}

void OnMesg(fit::MonitoringMesg& mesg) override
{
printf("Monitoring:\n");

if (mesg.IsTimestampValid())
{
printf(" Timestamp: %d\n", mesg.GetTimestamp());
}

if(mesg.IsActivityTypeValid())
{
printf(" Activity type: %d\n", mesg.GetActivityType());
}

switch(mesg.GetActivityType()) // The Cycling field is dynamic
{
case FIT_ACTIVITY_TYPE_WALKING:
case FIT_ACTIVITY_TYPE_RUNNING: // Intentional fallthrough
if(mesg.IsStepsValid())
{
printf(" Steps: %d\n", mesg.GetSteps());
}
break;
case FIT_ACTIVITY_TYPE_CYCLING:
case FIT_ACTIVITY_TYPE_SWIMMING: // Intentional fallthrough
if( mesg.IsStrokesValid() )
{
printf( "Strokes: %f\n", mesg.GetStrokes());
}
break;
default:
if(mesg.IsCyclesValid() )
{
printf( "Cycles: %f\n", mesg.GetCycles());
}
break;
}
}

static void PrintOverrideValues( const fit::Mesg& mesg, FIT_UINT8 fieldNum )
{
std::vector<const fit::FieldBase*> fields = mesg.GetOverrideFields( fieldNum );
const fit::Profile::FIELD * profileField = fit::Profile::GetField( mesg.GetNum(), fieldNum );
FIT_BOOL namePrinted = FIT_FALSE;

for ( const fit::FieldBase* field : fields )
{
if ( !namePrinted )
{
printf( " %s:\n", profileField->name.c_str() );
namePrinted = FIT_TRUE;
}

if ( FIT_NULL != dynamic_cast<const fit::Field*>( field ) )
{
// Native Field
printf( " native: " );
}
else
{
// Developer Field
printf( " override: " );
}

switch (field->GetType())
{
// Get float 64 values for numeric types to receive values that have
// their scale and offset properly applied.
case FIT_BASE_TYPE_ENUM:
case FIT_BASE_TYPE_BYTE:
case FIT_BASE_TYPE_SINT8:
case FIT_BASE_TYPE_UINT8:
case FIT_BASE_TYPE_SINT16:
case FIT_BASE_TYPE_UINT16:
case FIT_BASE_TYPE_SINT32:
case FIT_BASE_TYPE_UINT32:
case FIT_BASE_TYPE_SINT64:
case FIT_BASE_TYPE_UINT64:
case FIT_BASE_TYPE_UINT8Z:
case FIT_BASE_TYPE_UINT16Z:
case FIT_BASE_TYPE_UINT32Z:
case FIT_BASE_TYPE_UINT64Z:
case FIT_BASE_TYPE_FLOAT32:
case FIT_BASE_TYPE_FLOAT64:
printf("%f\n", field->GetFLOAT64Value());
break;
case FIT_BASE_TYPE_STRING:
printf("%ls\n", field->GetSTRINGValue().c_str());
break;
default:
break;
}
}
}

void OnMesg( fit::RecordMesg& record ) override
{
printf( "Record:\n" );
PrintOverrideValues( record, fit::RecordMesg::FieldDefNum::HeartRate);
PrintOverrideValues( record, fit::RecordMesg::FieldDefNum::Cadence );
PrintOverrideValues( record, fit::RecordMesg::FieldDefNum::Distance );
PrintOverrideValues( record, fit::RecordMesg::FieldDefNum::Speed );
}

void OnDeveloperFieldDescription( const fit::DeveloperFieldDescription& desc ) override
{
printf( "New Developer Field Description\n" );
printf( " App Version: %d\n", desc.GetApplicationVersion() );
printf( " Field Number: %d\n", desc.GetFieldDefinitionNumber() );
}
};

int main(int argc, char* argv[])
{
fit::Decode decode;
// decode.SkipHeader(); // Use on streams with no header and footer (stream contains FIT defn and data messages only)
// decode.IncompleteStream(); // This suppresses exceptions with unexpected eof (also incorrect crc)
fit::MesgBroadcaster mesgBroadcaster;
Listener listener;
std::fstream file;

printf("FIT Decode Example Application\n");

if (argc != 2)
{
printf("Usage: decode.exe <filename>\n");
return -1;
}

file.open(argv[1], std::ios::in | std::ios::binary);

if (!file.is_open())
{
printf("Error opening file %s\n", argv[1]);
return -1;
}

if (!decode.CheckIntegrity(file))
{
printf("FIT file integrity failed.\nAttempting to decode...\n");
}

mesgBroadcaster.AddListener((fit::FileIdMesgListener &)listener);
mesgBroadcaster.AddListener((fit::UserProfileMesgListener &)listener);
mesgBroadcaster.AddListener((fit::MonitoringMesgListener &)listener);
mesgBroadcaster.AddListener((fit::DeviceInfoMesgListener &)listener);
mesgBroadcaster.AddListener((fit::RecordMesgListener&)listener);
mesgBroadcaster.AddListener((fit::MesgListener &)listener);

try
{
decode.Read(&file, &mesgBroadcaster, &mesgBroadcaster, &listener);
}
catch (const fit::RuntimeException& e)
{
printf("Exception decoding file: %s\n", e.what());
return -1;
}
catch (...)
{
printf("Exception decoding file");
return -1;
}

printf("Decoded FIT file %s.\n", argv[1]);

return 0;
}

68 changes: 68 additions & 0 deletions src/examples/examples/decode/makefile
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
CC=g++
CFLAGS=-I"." -I"../../"

decode: decode.o fit_developer_field.o fit_developer_field_definition.o fit_developer_field_description.o fit_field_base.o fit.o fit_accumulated_field.o fit_accumulator.o fit_buffered_mesg_broadcaster.o fit_buffered_record_mesg_broadcaster.o fit_crc.o fit_decode.o fit_field.o fit_field_definition.o fit_mesg.o fit_mesg_broadcaster.o fit_mesg_definition.o fit_mesg_with_event_broadcaster.o fit_profile.o fit_unicode.o
$(CC) $(CFLAGS) decode.o fit_developer_field.o fit_developer_field_definition.o fit_developer_field_description.o fit_field_base.o fit.o fit_accumulated_field.o fit_accumulator.o fit_buffered_mesg_broadcaster.o fit_buffered_record_mesg_broadcaster.o fit_crc.o fit_decode.o fit_field.o fit_field_definition.o fit_mesg.o fit_mesg_broadcaster.o fit_mesg_definition.o fit_mesg_with_event_broadcaster.o fit_profile.o fit_unicode.o -o decode

decode.o: decode.cpp
$(CC) $(CFLAGS) -c decode.cpp -o decode.o

fit_developer_field.o: ../../fit_developer_field.cpp
$(CC) $(CFLAGS) -c ../../fit_developer_field.cpp -o fit_developer_field.o

fit_developer_field_definition.o: ../../fit_developer_field_definition.cpp
$(CC) $(CFLAGS) -c ../../fit_developer_field_definition.cpp -o fit_developer_field_definition.o

fit_developer_field_description.o: ../../fit_developer_field_description.cpp
$(CC) $(CFLAGS) -c ../../fit_developer_field_description.cpp -o fit_developer_field_description.o

fit_field_base.o: ../../fit_field_base.cpp
$(CC) $(CFLAGS) -c ../../fit_field_base.cpp -o fit_field_base.o

fit.o: ../../fit.cpp
$(CC) $(CFLAGS) -c ../../fit.cpp -o fit.o

fit_accumulated_field.o: ../../fit_accumulated_field.cpp
$(CC) $(CFLAGS) -c ../../fit_accumulated_field.cpp -o fit_accumulated_field.o

fit_accumulator.o: ../../fit_accumulator.cpp
$(CC) $(CFLAGS) -c ../../fit_accumulator.cpp -o fit_accumulator.o

fit_buffered_mesg_broadcaster.o: ../../fit_buffered_mesg_broadcaster.cpp
$(CC) $(CFLAGS) -c ../../fit_buffered_mesg_broadcaster.cpp -o fit_buffered_mesg_broadcaster.o

fit_buffered_record_mesg_broadcaster.o: ../../fit_buffered_record_mesg_broadcaster.cpp
$(CC) $(CFLAGS) -c ../../fit_buffered_record_mesg_broadcaster.cpp -o fit_buffered_record_mesg_broadcaster.o

fit_crc.o: ../../fit_crc.cpp
$(CC) $(CFLAGS) -c ../../fit_crc.cpp -o fit_crc.o

fit_decode.o: ../../fit_decode.cpp
$(CC) $(CFLAGS) -c ../../fit_decode.cpp -o fit_decode.o

fit_field.o: ../../fit_field.cpp
$(CC) $(CFLAGS) -c ../../fit_field.cpp -o fit_field.o

fit_field_definition.o: ../../fit_field_definition.cpp
$(CC) $(CFLAGS) -c ../../fit_field_definition.cpp -o fit_field_definition.o

fit_mesg.o: ../../fit_mesg.cpp
$(CC) $(CFLAGS) -c ../../fit_mesg.cpp -o fit_mesg.o

fit_mesg_broadcaster.o: ../../fit_mesg_broadcaster.cpp
$(CC) $(CFLAGS) -c ../../fit_mesg_broadcaster.cpp -o fit_mesg_broadcaster.o

fit_mesg_definition.o: ../../fit_mesg_definition.cpp
$(CC) $(CFLAGS) -c ../../fit_mesg_definition.cpp -o fit_mesg_definition.o

fit_mesg_with_event_broadcaster.o: ../../fit_mesg_with_event_broadcaster.cpp
$(CC) $(CFLAGS) -c ../../fit_mesg_with_event_broadcaster.cpp -o fit_mesg_with_event_broadcaster.o

fit_profile.o: ../../fit_profile.cpp
$(CC) $(CFLAGS) -c ../../fit_profile.cpp -o fit_profile.o

fit_unicode.o: ../../fit_unicode.cpp
$(CC) $(CFLAGS) -c ../../fit_unicode.cpp -o fit_unicode.o

clean:
rm -f decode *.o
Loading