fit4ruby 3.9.0 → 3.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f0a74c755c07cbbcfd9b17b9efeb16a62696fd9076c9ece178e00e51b3ce075
-  data.tar.gz: 81ee48cea068828a6ad08c5f4f274270ec96179159e585ecc9068eccbf1be3a4
+  metadata.gz: 550fffeb71313287a1a1037974608c23b738da5a34c6aaca39374fea562b7426
+  data.tar.gz: 923417ab9520777208f4bd830696d7012c68b8ad2e7d39572749bad42301d560
 SHA512:
-  metadata.gz: 0f140497b1f269075e912da5988238db3a279ef5baf20e4ce29f3b960307c3b87a4ada116283f17f5965a7e0e25e9b3e5bcdce7306b14ae49cb16d837692b239
-  data.tar.gz: 829a3ff7cee37f26218915d8370a0dd44fe6c24152c634f073fb0d25a543c3e50783188fe81f6d5cbbb00af42974eba1aed51f59ee25a108718773b7a65f8ad8
+  metadata.gz: 990ce2d227826d09a114e55652bbc4287dc1b8c2e1a4a534a6ade8bbcc2baed3a321a4508ca6b880a6af745c007f58a60649b0f32bf75a6782f0e7df1498f26d
+  data.tar.gz: 3e6fe4df5bda73caa364937a13b1e4a764a65a55723026260f381d9a108441a030dc8ec8ff2876e7ece8527575571933164f8c23eae485e8f1ea09c479fe6924

data/README.md

@@ -10,7 +10,7 @@ me comments and patches. It was developed to form the back-end of
 
 ## Supported Devices
 
-Tested devices: Garmin FR620
+Tested devices: Garmin FR620, Fenix 3, Fenix 5, Fenix 5X, Fenix 6X
 
 Other Garmin devices that generate FIT files may work as well. Since I
 don't have any other devices, I can't add support for them.

data/fit4ruby.gemspec

@@ -22,7 +22,7 @@ EOT
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
-  spec.required_ruby_version = '>=2.0'
+  spec.required_ruby_version = '>=2.3'
 
   spec.add_dependency('bindata', '~>2.4.8')
   spec.add_development_dependency('yard', '~>0.9.20')

data/lib/fit4ruby/Activity.rb

@@ -30,6 +30,8 @@ require 'fit4ruby/HRV'
 require 'fit4ruby/HeartRateZones'
 require 'fit4ruby/Event'
 require 'fit4ruby/PersonalRecords'
+require 'fit4ruby/Workout'
+require 'fit4ruby/WorkoutStep'
 
 module Fit4Ruby
 
@@ -54,6 +56,8 @@ module Fit4Ruby
       :epo_data,
       :user_profiles,
       :user_data,
+      :workouts,
+      :workout_steps,
       :sensor_settings,
       :developer_data_ids,
       :field_descriptions,
@@ -184,7 +188,7 @@ module Fit4Ruby
     # sessions.
     def total_distance
       d = 0.0
-      @sessions.each { |s| d += s.total_distance }
+      @sessions.each { |s| d += (s.total_distance || 0) }
       d
     end
 
@@ -311,11 +315,21 @@ module Fit4Ruby
       @sessions[0].sport
     end
 
+    # Sets the sport type of this activity.
+    def sport=(sport)
+      @sessions[0].sport = sport
+    end
+
     # Returns the sport subtype of this activity.
     def sub_sport
       @sessions[0].sub_sport
     end
 
+    # Sets the sport subtype of this activity.
+    def sub_sport=(sub_sport)
+      @sessions[0].sub_sport = sub_sport
+    end
+
     # Write the Activity data to a file.
     # @param io [IO] File reference
     # @param id_mapper [FitMessageIdMapper] Maps global FIT record types to
@@ -405,6 +419,22 @@ module Fit4Ruby
       new_fit_data_record('user_profile', field_values)
     end
 
+    # Add a new Workout to the Activity.
+    # @param field_values [Hash] A Hash that provides initial values for
+    #        certain fields of the FitDataRecord.
+    # @return [UserProfile]
+    def new_workout(field_values = {})
+      new_fit_data_record('workout', field_values)
+    end
+
+    # Add a new WorkoutSet to the Activity.
+    # @param field_values [Hash] A Hash that provides initial values for
+    #        certain fields of the FitDataRecord.
+    # @return [UserProfile]
+    def new_workout_set(field_values = {})
+      new_fit_data_record('workout_set', field_values)
+    end
+
     # Add a new PhysiologicalMetrics to the Activity.
     # @param field_values [Hash] A Hash that provides initial values for
     #        certain fields of the FitDataRecord.
@@ -522,6 +552,10 @@ module Fit4Ruby
         @data_sources << (record = DataSources.new(field_values))
       when 'user_data'
         @user_data << (record = UserData.new(field_values))
+      when 'workout'
+        @workouts << (record = Workout.new(field_values))
+      when 'workout_step'
+        @workout_steps << (record = WorkoutStep.new(field_values))
       when 'user_profile'
         @user_profiles << (record = UserProfile.new(field_values))
       when 'physiological_metrics'
@@ -615,4 +649,3 @@ module Fit4Ruby
   end
 
 end
-

data/lib/fit4ruby/Converters.rb

@@ -1,5 +1,4 @@
 #!/usr/bin/env ruby -w
-# encoding: UTF-8
 #
 # = Converters.rb -- Fit4Ruby - FIT file processing library for Ruby
 #
@@ -9,34 +8,47 @@
 # it under the terms of version 2 of the GNU General Public License as
 # published by the Free Software Foundation.
 #
+# frozen_string_literal: true
 
 module Fit4Ruby
-
   module Converters
+    FACTORS = {
+      'm' => { 'km' => 0.001, 'in' => 39.3701, 'ft' => 3.28084,
+               'mi' => 0.000621371 },
+      'mm' => { 'cm' => 0.1, 'in' => 0.0393701 },
+      'm/s' => { 'km/h' => 3.6, 'mph' => 2.23694 },
+      'min/km' => { 'min/mi' => 1.60934 },
+      'kg' => { 'lbs' => 2.20462262 },
+      'C' => { 'F' => 9.0 / 5.0 }
+    }.freeze
+    OFFSETS = {
+      'C' => { 'F' => 32 }
+    }.freeze
 
     def conversion_factor(from_unit, to_unit)
-      factors = {
-        'm' => { 'km' => 0.001, 'in' => 39.3701, 'ft' => 3.28084,
-                 'mi' => 0.000621371 },
-        'mm' => { 'cm' => 0.1, 'in' => 0.0393701 },
-        'm/s' => { 'km/h' => 3.6, 'mph' => 2.23694 },
-        'min/km' => { 'min/mi' => 1.60934 },
-        'kg' => { 'lbs' => 0.453592 }
-      }
       return 1.0 if from_unit == to_unit
-      unless factors.include?(from_unit)
-        Log.fatal "No conversion factors defined for unit " +
+
+      unless FACTORS.include?(from_unit)
+        Log.fatal 'No conversion factors defined for unit ' \
                   "'#{from_unit}' to '#{to_unit}'"
       end
 
-      factor = factors[from_unit][to_unit]
+      factor = FACTORS[from_unit][to_unit]
       if factor.nil?
-        Log.fatal "No conversion factor from '#{from_unit}' to '#{to_unit}' " +
-                  "defined."
+        Log.fatal "No conversion factor from '#{from_unit}' to '#{to_unit}' " \
+                  'defined.'
       end
+
       factor
     end
 
+    def conversion_offset(from_unit, to_unit)
+      return 0.0 if from_unit == to_unit || !OFFSETS.include?(from_unit) ||
+                    !OFFSETS[from_unit].include?(to_unit)
+
+      OFFSETS[from_unit][to_unit]
+    end
+
     def speedToPace(speed, distance = 1000.0)
       if speed && speed > 0.01
         # We only show 2 fractional digits, so make sure we round accordingly
@@ -89,4 +101,3 @@ module Fit4Ruby
   end
 
 end
-

data/lib/fit4ruby/FitDataRecord.rb

@@ -1,30 +1,28 @@
 #!/usr/bin/env ruby -w
-# encoding: UTF-8
 #
 # = FitDataRecord.rb -- Fit4Ruby - FIT file processing library for Ruby
 #
-# Copyright (c) 2014, 2015, 2020 by Chris Schlaeger <cs@taskjuggler.org>
+# Copyright (c) 2014, 2015, 2020, 2021 by Chris Schlaeger <cs@taskjuggler.org>
 #
 # This program is free software; you can redistribute it and/or modify
 # it under the terms of version 2 of the GNU General Public License as
 # published by the Free Software Foundation.
 #
+# frozen_string_literal: true
 
 require 'fit4ruby/FitMessageIdMapper'
-require 'fit4ruby/GlobalFitMessages.rb'
+require 'fit4ruby/GlobalFitMessages'
 require 'fit4ruby/BDFieldNameTranslator'
 
 module Fit4Ruby
-
   class FitDataRecord
-
     include Converters
     include BDFieldNameTranslator
 
-    RecordOrder = [ 'user_data', 'user_profile',
-                    'device_info', 'data_sources', 'event',
-                    'record', 'lap', 'length', 'session', 'heart_rate_zones',
-                    'personal_records' ]
+    RecordOrder = ['user_data', 'user_profile', 'workout', 'workout_set',
+                   'device_info', 'data_sources', 'event',
+                   'record', 'lap', 'length', 'session', 'heart_rate_zones',
+                   'personal_records']
 
     attr_reader :message, :timestamp
 
@@ -33,7 +31,7 @@ module Fit4Ruby
 
       # Create instance variables that correspond to every field of the
       # corresponding FIT data record.
-      @message.fields_by_name.each do |name, field|
+      @message.fields_by_name.each do |name, _|
         create_instance_variable(name)
       end
 
@@ -51,9 +49,9 @@ module Fit4Ruby
     end
 
     def set(name, value)
-      ivar_name = '@' + name
+      ivar_name = "@#{name}"
       unless instance_variable_defined?(ivar_name)
-        Log.debug("Unknown FIT record field '#{name}' in global message " +
+        Log.debug("Unknown FIT record field '#{name}' in global message " \
                   "#{@message.name} (#{@message.number}).")
         return
       end
@@ -62,7 +60,7 @@ module Fit4Ruby
 
     def get(name)
       # This is a request for a native FIT field.
-      ivar_name = '@' + name
+      ivar_name = "@#{name}"
       return nil unless instance_variable_defined?(ivar_name)
 
       instance_variable_get(ivar_name)
@@ -82,17 +80,17 @@ module Fit4Ruby
         end
       end
 
-      value * conversion_factor(unit, to_unit)
+      conversion_offset(unit, to_unit) + value * conversion_factor(unit, to_unit)
     end
 
-    def ==(fdr)
-      @message.each_field(field_values_as_hash) do |number, field|
-        ivar_name = '@' + field.name
+    def ==(other)
+      @message.each_field(field_values_as_hash) do |_, field|
+        ivar_name = "@#{field.name}"
         # Comparison of values is done in the fit file format as the accuracy
         # of native formats is better and could lead to wrong results if a
         # value hasn't been read back from a fit file yet.
         v1 = field.native_to_fit(instance_variable_get(ivar_name))
-        v2 = field.native_to_fit(fdr.instance_variable_get(ivar_name))
+        v2 = field.native_to_fit(other.instance_variable_get(ivar_name))
 
         return false unless v1 == v2
       end
@@ -100,16 +98,15 @@ module Fit4Ruby
       true
     end
 
-    def <=>(fdr)
-      @timestamp == fdr.timestamp ?
+    def <=>(other)
+      @timestamp == other.timestamp ?
         RecordOrder.index(@message.name) <=>
-        RecordOrder.index(fdr.message.name) :
-        @timestamp <=> fdr.timestamp
+        RecordOrder.index(other.message.name) :
+        @timestamp <=> other.timestamp
     end
 
     def write(io, id_mapper)
-      global_fit_message = @message.construct(
-        field_values = field_values_as_hash)
+      global_fit_message = @message.construct(field_values = field_values_as_hash)
 
       # Map the global message number to the current local message number.
       unless (local_message_number = id_mapper.get_local(global_fit_message))
@@ -134,10 +131,10 @@ module Fit4Ruby
 
       # Fill the BinData::Struct object with the values from the corresponding
       # instance variables.
-      global_fit_message.each_field(field_values) do |number, field|
+      global_fit_message.each_field(field_values) do |_, field|
         bin_data_type = FitDefinitionFieldBase.fit_type_to_bin_data(field.type)
         field_name = to_bd_field_name(field.name)
-        field_def = [ bin_data_type, field_name ]
+        field_def = [bin_data_type, field_name]
 
         iv = "@#{field.name}"
         if instance_variable_defined?(iv) &&
@@ -147,7 +144,7 @@ module Fit4Ruby
           # If we don't have a corresponding variable or the variable is nil
           # we write the 'undefined' value instead.
           value = FitDefinitionFieldBase.undefined_value(field.type)
-          values[field.name] = field.opts[:array] ? [ value ] :
+          values[field.name] = field.opts[:array] ? [value] :
             field.type == 'string' ? '' : value
         end
 
@@ -157,17 +154,17 @@ module Fit4Ruby
           values[field.name] += "\0"
         elsif field.opts[:array]
           # For Arrays we use a BinData::Array to write them.
-          field_def = [ :array, field_name,
-                        { :type => bin_data_type,
-                          :initial_length => values[field.name].size } ]
+          field_def = [:array, field_name,
+                       { type: bin_data_type,
+                         initial_length: values[field.name].size }]
         end
         fields << field_def
       end
-      bd = BinData::Struct.new(:endian => :little, :fields => fields)
+      bd = BinData::Struct.new(endian: :little, fields: fields)
 
       # Fill the BinData::Struct object with the values from the corresponding
       # instance variables.
-      global_fit_message.each_field(field_values) do |number, field|
+      global_fit_message.each_field(field_values) do |_, field|
         bd[to_bd_field_name(field.name)] = values[field.name]
       end
 
@@ -183,13 +180,13 @@ module Fit4Ruby
       }
 
       @message.each_field(field_values_as_hash) do |number, field|
-        ivar_name = '@' + field.name
+        ivar_name = "@#{field.name}"
         fit_value = field.native_to_fit(instance_variable_get(ivar_name))
         unless field.is_undefined?(fit_value)
           fld = {
             'number' => number,
             'value' => field.fit_to_native(fit_value),
-            #'human' => field.to_human(fit_value),
+            # 'human' => field.to_human(fit_value),
             'type' => field.type
           }
           fld['unit'] = field.opts[:unit] if field.opts[:unit]
@@ -214,7 +211,7 @@ module Fit4Ruby
       # set of fields. It does not contain any AltField objects.
       field_values = {}
       @message.fields_by_name.each_key do |name|
-        field_values[name] = instance_variable_get('@' + name)
+        field_values[name] = instance_variable_get("@#{name}")
       end
 
       field_values
@@ -223,12 +220,9 @@ module Fit4Ruby
     def create_instance_variable(name)
       # Create a new instance variable for 'name'. We initialize it with a
       # provided default value or nil.
-      instance_variable_set('@' + name, nil)
+      instance_variable_set("@#{name}", nil)
       # And create an accessor method for it as well.
       self.class.__send__(:attr_accessor, name)
     end
-
   end
-
 end
-

data/lib/fit4ruby/GlobalFitDictionaries.rb

@@ -3,7 +3,7 @@
 #
 # = GlobalFitDictionaries.rb -- Fit4Ruby - FIT file processing library for Ruby
 #
-# Copyright (c) 2014 by Chris Schlaeger <cs@taskjuggler.org>
+# Copyright (c) 2014, 2021 by Chris Schlaeger <cs@taskjuggler.org>
 #
 # This program is free software; you can redistribute it and/or modify
 # it under the terms of version 2 of the GNU General Public License as
@@ -16,6 +16,10 @@ module Fit4Ruby
 
   GlobalFitDictionaries = GlobalFitDictList.new do
 
+    dict 'activity'
+    entry 0, 'manual'
+    entry 1, 'auto_multi_sport'
+
     dict 'activity_type'
     entry 0, 'generic'
     entry 1, 'running'
@@ -23,50 +27,8 @@ module Fit4Ruby
     entry 3, 'transition'
     entry 4, 'fitness_equipment'
     entry 5, 'swimming'
-    entry 6, 'basketball'
-    entry 7, 'soccer'
-    entry 8, 'tennis'
-    entry 9, 'american_football'
-    entry 10, 'training'
-    entry 11, 'walking'
-    entry 12, 'cross_country_skiing'
-    entry 13, 'alpine_skiing'
-    entry 14, 'snowboarding'
-    entry 15, 'rowing'
-    entry 16, 'mountaineering'
-    entry 17, 'hiking'
-    entry 18, 'multisport'
-    entry 19, 'paddling'
-    entry 20, 'flying'
-    entry 21, 'e_biking'
-    entry 22, 'motorcycling'
-    entry 23, 'boating'
-    entry 24, 'driving'
-    entry 25, 'golf'
-    entry 26, 'hang_gliding'
-    entry 27, 'horseback_riding'
-    entry 28, 'hunting'
-    entry 29, 'fishing'
-    entry 30, 'inline_skating'
-    entry 31, 'rock_climbing'
-    entry 32, 'sailing'
-    entry 33, 'ice_skating'
-    entry 34, 'sky_diving'
-    entry 35, 'snowshoeing'
-    entry 36, 'snowmobiling'
-    entry 37, 'stand_up_paddleboarding'
-    entry 38, 'surfing'
-    entry 39, 'wakeboarding'
-    entry 40, 'water_skiing'
-    entry 41, 'kayaking'
-    entry 42, 'rafting'
-    entry 43, 'windsurfing'
-    entry 44, 'kitesurfing'
-    entry 45, 'tactical'
-    entry 46, 'jumpmaster'
-    entry 47, 'boxing'
-    entry 48, 'floor_climbing'
-    entry 53, 'diving'
+    entry 6, 'walking'
+    entry 8, 'sedentary'
     entry 254, 'all'
 
     dict 'activity_level'
@@ -714,6 +676,9 @@ module Fit4Ruby
     entry 1, 'rest'
     entry 2, 'warmup'
     entry 3, 'cooldown'
+    entry 4, 'recovery'
+    entry 5, 'interval'
+    entry 6, 'other'
 
     dict 'hr_zone_calc'
     entry 0, 'custom'
@@ -933,6 +898,36 @@ module Fit4Ruby
     entry 17, 'hiking'
     entry 18, 'multisport'
     entry 19, 'paddling'
+    entry 20, 'flying'
+    entry 21, 'e_biking'
+    entry 22, 'motorcycling'
+    entry 23, 'boating'
+    entry 24, 'driving'
+    entry 25, 'golf'
+    entry 26, 'hang_gliding'
+    entry 27, 'horseback_riding'
+    entry 28, 'hunting'
+    entry 29, 'fishing'
+    entry 30, 'inline_skating'
+    entry 31, 'rock_climbing'
+    entry 32, 'sailing'
+    entry 33, 'ice_skating'
+    entry 34, 'sky_diving'
+    entry 35, 'snowshoeing'
+    entry 36, 'snowmobiling'
+    entry 37, 'stand_up_paddleboarding'
+    entry 38, 'surfing'
+    entry 39, 'wakeboarding'
+    entry 40, 'water_skiing'
+    entry 41, 'kayaking'
+    entry 42, 'rafting'
+    entry 43, 'windsurfing'
+    entry 44, 'kitesurfing'
+    entry 45, 'tactical'
+    entry 46, 'jumpmaster'
+    entry 47, 'boxing'
+    entry 48, 'floor_climbing'
+    entry 53, 'diving'
     entry 254, 'all'
 
     dict 'swim_stroke'
@@ -1023,6 +1018,79 @@ module Fit4Ruby
     entry 2, 'maintaining'
     entry 3, 'up'
 
+    dict 'wkt_step_duration'
+    entry 0, 'time'
+    entry 1, 'distance'
+    entry 2, 'hr_less_than'
+    entry 3, 'hr_greater_than'
+    entry 4, 'calories'
+    entry 5, 'open'
+    entry 6, 'repeat_until_steps_cmplt'
+    entry 7, 'repeat_until_time'
+    entry 8, 'repeat_until_distance'
+    entry 9, 'repeat_until_calories'
+    entry 10, 'repeat_until_hr_less_than'
+    entry 11, 'repeat_until_hr_greater_than'
+    entry 12, 'repeat_until_power_less_than'
+    entry 13, 'repeat_until_power_greater_than'
+    entry 14, 'power_less_than'
+    entry 15, 'power_greater_than'
+    entry 16, 'training_peaks_tss'
+    entry 17, 'repeat_until_power_last_lap_less_than'
+    entry 18, 'repeat_until_max_power_last_lap_less_than'
+    entry 19, 'power_3s_less_than'
+    entry 20, 'power_10s_less_than'
+    entry 21, 'power_30s_less_than'
+    entry 22, 'power_3s_greater_than'
+    entry 23, 'power_10s_greater_than'
+    entry 24, 'power_30s_greater_than'
+    entry 25, 'power_lap_less_than'
+    entry 26, 'power_lap_greater_than'
+    entry 27, 'repeat_until_training_peaks_tss'
+    entry 28, 'repetition_time'
+    entry 29, 'reps'
+    entry 31, 'time_only'
+
+    dict 'wkt_step_target'
+    entry 0, 'speed'
+    entry 1, 'heart_rate'
+    entry 2, 'open'
+    entry 3, 'cadence'
+    entry 4, 'power'
+    entry 5, 'grade'
+    entry 6, 'resistance'
+    entry 7, 'power_3s'
+    entry 8, 'power_10s'
+    entry 9, 'power_30s'
+    entry 10, 'power_lap'
+    entry 11, 'swim_stroke'
+    entry 12, 'speed_lap'
+    entry 13, 'heart_rate_lap'
+
+    dict 'workout_capabilities'
+    entry 0x1, 'interval'
+    entry 0x2, 'custom'
+    entry 0x4, 'fitness_equipment'
+    entry 0x8, 'firstbeat'
+    entry 0x10, 'new_leaf'
+    entry 0x20, 'tcx'
+    entry 0x80, 'speed'
+    entry 0x100, 'heart_rate'
+    entry 0x200, 'distance'
+    entry 0x400, 'cadence'
+    entry 0x800, 'power'
+    entry 0x1000, 'grade'
+    entry 0x2000, 'resistance'
+    entry 0x4000, 'protected'
+
+    dict 'workout_equipment'
+    entry 0, 'none'
+    entry 1, 'swim_fins'
+    entry 2, 'swim_kickboard'
+    entry 3, 'swim_paddles'
+    entry 4, 'swim_pull_buoy'
+    entry 5, 'swim_snorkel'
+
   end
 
 end

data/lib/fit4ruby/GlobalFitMessages.rb

@@ -3,7 +3,7 @@
 #
 # = GlobalFitMessages.rb -- Fit4Ruby - FIT file processing library for Ruby
 #
-# Copyright (c) 2014, 2015, 2020 by Chris Schlaeger <cs@taskjuggler.org>
+# Copyright (c) 2014, 2015, 2020, 2021 by Chris Schlaeger <cs@taskjuggler.org>
 #
 # This program is free software; you can redistribute it and/or modify
 # it under the terms of version 2 of the GNU General Public License as
@@ -461,19 +461,23 @@ module Fit4Ruby
     field 169, 'uint16', 'undocumented_field_169'
     field 170, 'uint16', 'undocumented_field_170'
     field 177, 'uint16', 'undocumented_field_177'
-    field 178, 'uint16', 'undocumented_field_178'
+    field 178, 'uint16', 'est_sweat_loss', :unit => 'ml' # guessed
     field 179, 'uint16', 'undocumented_field_179'
     field 180, 'uint16', 'undocumented_field_180'
-    field 181, 'float32', 'undocumented_field_181'
-    field 183, 'uint16', 'undocumented_field_183'
+    field 181, 'float32', 'total_grit', :unit => 'kGrit'
+    field 182, 'float32', 'total_flow', :unit => 'Flow'
+    field 183, 'uint16', 'jump_count'
     field 184, 'enum', 'undocumented_field_184'
     field 185, 'uint8', 'undocumented_field_185'
-    field 187, 'float32', 'undocumented_field_187'
+    field 186, 'float32', 'avg_grit', :unit => 'kGrit'
+    field 187, 'float32', 'avg_flow', :unit => 'Flow'
     field 188, 'enum', 'undocumented_field_188'
     field 189, 'uint16', 'undocumented_field_189'
     field 190, 'uint16', 'undocumented_field_190'
     field 194, 'uint8', 'undocumented_field_194'
     field 195, 'uint8', 'undocumented_field_195'
+    field 199, 'uint8', 'total_fractional_ascent', :scale => 100, :unit => 'm'
+    field 200, 'uint8', 'total_fractional_descent', :scale => 100, :unit => 'm'
     field 253, 'uint32', 'timestamp', :type => 'date_time'
     field 254, 'uint16', 'message_index'
 
@@ -638,7 +642,7 @@ module Fit4Ruby
     field 83, 'uint16', 'vertical_ratio', :scale => 100, :unit => '%' # guessed
     field 84, 'uint16', 'gct_balance', :scale => 100, :unit => '%' # guessed
     field 85, 'uint16', 'stride_length', :scale => 10000, :unit => 'm' # guessed
-    field 87, 'uint16', 'undefined_value_87' # first seen on F3 FW6.80
+    field 87, 'uint16', 'stroke_distance', :scale => 100, :unit => 'm'
     field 88, 'uint16', 'undefined_value_88' # first seen on F3HR FW3.60
     field 90, 'sint8', 'performance_condition' # guessed
     field 100, 'sint32', 'undocumented_field_100'
@@ -745,6 +749,48 @@ module Fit4Ruby
     # counter.
     field 2, 'byte', 'undocumented_field_2', :array => true
 
+    message 26, 'workout'
+    field 4, 'enum', 'sport', :dict => 'sport'
+    field 5, 'uint32z', 'capabilities', :dict => 'workout_capabilities'
+    field 6, 'uint16', 'num_valid_step'
+    field 8, 'string', 'wkt_name'
+    field 11, 'enum', 'sub_sport', :dict => 'sub_sport'
+    field 14, 'uint16', 'pool_length', :scale => 100, :unit => 'm'
+    field 15, 'enum', 'pool_length_unit'
+
+    message 27, 'workout_step'
+    field 0, 'string', 'wkt_step_name'
+    field 1, 'enum', 'duration_type', :dict => 'wkt_step_duration'
+    alt_field 2, 'duration_type' do
+     field :default, 'uint32', 'duration_value'
+     field 'distance', 'uint32', 'duration_distance', :scale => 100, :unit => 'm'
+     field 'time', 'uint32', 'duration_time', :scale => 1000, :unit => 's'
+     field 'repeat_until_steps_cmplt', 'uint32', 'duration_reps'
+    end
+    field 3, 'enum', 'target_type', :dict => 'wkt_step_target'
+    alt_field 4, 'target_type' do
+      field :default, 'uint32', 'target_value'
+      field 'speed', 'uint32', 'target_speed_zone'
+      field 'cadence', 'uint32', 'target_cadence_zone'
+      field 'power', 'uint32', 'target_power_zone'
+    end
+    alt_field 5, 'target_type' do
+      field :default, 'uint32', 'custom_target_value_low'
+      field 'speed', 'uint32', 'custom_target_speed_low', :scale => 1000, :unit => 'm/s'
+    end
+    alt_field 6, 'target_type' do
+      field :default, 'uint32', 'custom_target_value_high'
+      field 'speed', 'uint32', 'custom_target_speed_high', :scale => 1000, :unit => 'm/s'
+    end
+    field 7, 'enum', 'intensity', :dict => 'intensity'
+    field 8, 'string', 'notes'
+    field 9, 'enum', 'equipment', :dict => 'workout_equipment'
+    field 10, 'uint16', 'exercise_category'
+    field 11, 'uint16', 'exercise_name'
+    field 12, 'uint16', 'exercise_weight', :scale => 100, :unit => 'kg'
+    field 13, 'uint16', 'weight_display_unit'
+    field 254, 'uint16', 'message_index'
+
     # Message 29 is just a guess. It's not officially documented.
     # Found in LCTNS.FIT on Fenix 3
     message 29, 'location'
@@ -771,7 +817,7 @@ module Fit4Ruby
     message 34, 'activity'
     field 0, 'uint32', 'total_timer_time', :type => 'duration',  :scale => 1000
     field 1, 'uint16', 'num_sessions'
-    field 2, 'enum', 'type', :dict => 'activity_type'
+    field 2, 'enum', 'type', :dict => 'activity'
     field 3, 'enum', 'event', :dict => 'event'
     field 4, 'enum', 'event_type', :dict => 'event_type'
     field 5, 'uint32', 'local_timestamp', :type => 'date_time'
@@ -1069,14 +1115,19 @@ module Fit4Ruby
     field 73, 'uint16z', 'undocumented_field_73'
     field 254, 'uint16', 'message_index'
 
-    # Not part of the official ANT SDK doc.
-    message 160, 'undocumented_160'
-    field 3, 'uint32', 'undocumented_field_3'
-    field 4, 'uint32', 'undocumented_field_4'
+    message 160, 'gps_metadata'
+    field 0, 'uint16', 'timestamp_ms'
+    field 1, 'sint32', 'position_lat'
+    field 2, 'sint32', 'position_long'
+    field 3, 'uint32', 'enhanced_altitude', :scale => 5, :offset => 500, :unit => 'm'
+    field 4, 'uint32', 'enhanced_speed', :unit => 'm/s', :scale => 1000
+    field 5, 'uint16', 'heading', :unit => 'degrees', :scale => 100
+    field 6, 'uint32', 'utc_timestamp', :type => 'date_time'
+    field 7, 'sint16', 'velocity', :array => true, :scale => 100, :unit => 'm/s'
+    field 253, 'uint32', 'timestamp', :type => 'date_time'
 
-    # Not part of the official ANT SDK doc.
-    message 188, 'undocumented_188'
-    field 0, 'enum', 'undocumented_field_0'
+    message 188, 'ohr_settings'
+    field 0, 'enum', 'switch'
     field 253, 'uint32', 'timestamp', :type => 'date_time'
 
     message 206, 'field_description'
@@ -1217,6 +1268,24 @@ module Fit4Ruby
     field 252, 'uint8', 'undocumented_field_252'
     field 253, 'uint32', 'timestamp', :type => 'date_time'
 
+    # Not part of the official ANT SDK doc.
+    message 312, 'undocumented_312'
+    field 0, 'enum', 'undocumented_field_0'
+    field 9, 'uint32', 'interval_start', :type => 'date_time'
+    field 15, 'uint8', 'min_heart_rate', :unit => 'bpm'
+    field 16, 'uint8', 'max_heart_rate', :unit => 'bpm'
+    field 21, 'sint32', 'position_lat', :type => 'coordinate'
+    field 22, 'sint32', 'position_long', :type => 'coordinate'
+    field 27, 'uint32', 'interval_end', :type => 'date_time'
+    field 32, 'sint8', 'avg_temperature', :unit => 'C'
+    field 33, 'sint8', 'max_temperature', :unit => 'C'
+    field 34, 'sint8', 'min_temperature', :unit => 'C'
+    field 37, 'uint16', 'undocumented_field_37'
+    field 38, 'uint16', 'undocumented_field_38'
+    field 39, 'uint16', 'undocumented_field_39'
+    field 253, 'uint32', 'timestamp', :type => 'date_time'
+    field 254, 'uint16', 'message_index'
+
     # Not part of the official ANT SDK doc.
     message 325, 'undocumented_325'
     field 0, 'uint8', 'undocumented_field_0'
@@ -1259,4 +1328,3 @@ module Fit4Ruby
   end
 
 end
-

data/lib/fit4ruby/Workout.rb

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# = Workout.rb -- Fit4Ruby - FIT file processing library for Ruby
+#
+# Copyright (c) 2021 by Chris Schlaeger <cs@taskjuggler.org>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of version 2 of the GNU General Public License as
+# published by the Free Software Foundation.
+#
+
+require 'fit4ruby/FitDataRecord'
+
+module Fit4Ruby
+
+  class Workout < FitDataRecord
+
+    def initialize(field_values = {})
+      super('workout')
+      set_field_values(field_values)
+    end
+
+    def check(index)
+    end
+
+  end
+
+end
+
+

data/lib/fit4ruby/WorkoutStep.rb

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# = WorkoutStep.rb -- Fit4Ruby - FIT file processing library for Ruby
+#
+# Copyright (c) 2021 by Chris Schlaeger <cs@taskjuggler.org>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of version 2 of the GNU General Public License as
+# published by the Free Software Foundation.
+#
+
+require 'fit4ruby/FitDataRecord'
+
+module Fit4Ruby
+
+  class WorkoutStep < FitDataRecord
+
+    def initialize(field_values = {})
+      super('workout_step')
+      set_field_values(field_values)
+    end
+
+    def check(index)
+    end
+
+  end
+
+end
+
+
+

data/lib/fit4ruby/version.rb

@@ -1,4 +1,4 @@
 module Fit4Ruby
   # The version number of the library.
-  VERSION = '3.9.0'
+  VERSION = '3.11.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fit4ruby
 version: !ruby/object:Gem::Version
-  version: 3.9.0
+  version: 3.11.0
 platform: ruby
 authors:
 - Chris Schlaeger
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-17 00:00:00.000000000 Z
+date: 2023-06-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bindata
@@ -164,6 +164,8 @@ files:
 - lib/fit4ruby/TrainingStatus.rb
 - lib/fit4ruby/UserData.rb
 - lib/fit4ruby/UserProfile.rb
+- lib/fit4ruby/Workout.rb
+- lib/fit4ruby/WorkoutStep.rb
 - lib/fit4ruby/version.rb
 - spec/FileNameCoder_spec.rb
 - spec/FitFile_spec.rb
@@ -184,14 +186,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.0'
+      version: '2.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
+rubygems_version: 3.4.10
 signing_key: 
 specification_version: 4
 summary: Library to read and write GARMIN FIT files.