timex_datalink_client 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93fe636dc699046ea5c14683b355f8c65bb162fb18ee91b3ffe27f4a72633808
-  data.tar.gz: d9476317e2cce78a77247c277e77208969f6e8fa13059a2e0f7452f502f9b112
+  metadata.gz: 7bbd5ed72c50f798a4efc663846f406338e1a777cd8587ba504a283c7976e7bf
+  data.tar.gz: '0843b0db0875cfc5ea663e85dcf0cf007bfb88b89306945390d51ab9eba09693'
 SHA512:
-  metadata.gz: 313b6bc8ea78a28ee55534ff28648a6544a8aa7dcf1abd731461fc7b9c21ba3711d441de603d7f538666541d5fce4ca0d6206449a2b8cee6cf5d56a263f8691a
-  data.tar.gz: df31c376348f69fd05ba4c0de720e443074f68d63788601610021e0328598af3cfa8a3f85789336d20e80aac90be5ac32526bc6872d208afdd2c6965582f1617
+  metadata.gz: 17da22510b17f02379419c84d0c80c35c9d63861d9186627d4adad2cbf7d00ed5c6aaf458316f7ec4bad5ee98fdcfa4bdbbaa96cb01b4506cce81b7193946eaa
+  data.tar.gz: 183bdf6f467c802df1e31c3f2b7e76d5a93a07e851fed8caf85fff56a93f3a48ef448d3b4f9b3884e46e9481e3c894702ae2994b96de92d9c09c4c1737a696af

data/lib/timex_datalink_client/helpers/lsb_msb_formatter.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+class TimexDatalinkClient
+  class Helpers
+    module LsbMsbFormatter
+      def lsb_msb_format_for(value)
+        value.divmod(256).reverse
+      end
+    end
+  end
+end

data/lib/timex_datalink_client/protocol_1/alarm.rb

@@ -1,11 +1,14 @@
 # frozen_string_literal: true
 
+require "active_model"
+
 require "timex_datalink_client/helpers/char_encoders"
 require "timex_datalink_client/helpers/crc_packets_wrapper"
 
 class TimexDatalinkClient
   class Protocol1
     class Alarm
+      include ActiveModel::Validations
       include Helpers::CharEncoders
       prepend Helpers::CrcPacketsWrapper
 
@@ -14,8 +17,50 @@ class TimexDatalinkClient
 
       ALARM_SILENT_START_INDEX = 0x61
 
+      VALID_DAYS_IN_MONTH = {
+        1 => 1..31,
+        2 => 1..29,
+        3 => 1..31,
+        4 => 1..30,
+        5 => 1..31,
+        6 => 1..30,
+        7 => 1..31,
+        8 => 1..31,
+        9 => 1..30,
+        10 => 1..31,
+        11 => 1..30,
+        12 => 1..31
+      }.freeze
+
       attr_accessor :number, :audible, :time, :message, :month, :day
 
+      validates :number, inclusion: {
+        in: 1..5,
+        message: "value %{value} is invalid!  Valid number values are 1..5."
+      }
+
+      validates :month, inclusion: {
+        in: 1..12,
+        allow_nil: true,
+        message: "%{value} is invalid!  Valid months are 1..12 and nil."
+      }
+
+      validates :day, inclusion: {
+        if: ->(alarm) { alarm.month.nil? },
+        in: 1..31,
+        allow_nil: true,
+        message: "%{value} is invalid!  Valid days are 1..31 and nil."
+      }
+
+      validates :day, inclusion: {
+        if: ->(alarm) { alarm.day && alarm.month },
+        in: ->(alarm) { VALID_DAYS_IN_MONTH[alarm.month] },
+        message: ->(alarm, _attributes) do
+          "#{alarm.day} is invalid for month #{alarm.month}!  " \
+          "Valid days are #{VALID_DAYS_IN_MONTH[alarm.month]} and nil when month is #{alarm.month}."
+        end
+      }
+
       # Create an Alarm instance.
       #
       # @param number [Integer] Alarm number (from 1 to 5).
@@ -36,8 +81,11 @@ class TimexDatalinkClient
 
       # Compile packets for an alarm.
       #
+      # @raise [ActiveModel::ValidationError] One or more model values are invalid.
       # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
       def packets
+        validate!
+
         [alarm_data_packet].tap do |packets|
           packets << alarm_silent_packet unless audible
         end

data/lib/timex_datalink_client/protocol_1/eeprom/list.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "active_model"
+
 require "timex_datalink_client/helpers/char_encoders"
 require "timex_datalink_client/helpers/length_packet_wrapper"
 
@@ -7,11 +9,18 @@ class TimexDatalinkClient
   class Protocol1
     class Eeprom
       class List
+        include ActiveModel::Validations
         include Helpers::CharEncoders
         prepend Helpers::LengthPacketWrapper
 
         attr_accessor :list_entry, :priority
 
+        validates :priority, inclusion: {
+          in: 1..5,
+          allow_nil: true,
+          message: "%{value} is invalid!  Valid priorities are 1..5 or nil."
+        }
+
         # Create a List instance.
         #
         # @param list_entry [String] List entry text.
@@ -24,10 +33,13 @@ class TimexDatalinkClient
 
         # Compile a packet for a list.
         #
+        # @raise [ActiveModel::ValidationError] One or more model values are invalid.
         # @return [Array<Integer>] Array of integers that represent bytes.
         def packet
+          validate!
+
           [
-            priority,
+            priority_value,
             list_entry_characters
           ].flatten
         end
@@ -37,6 +49,10 @@ class TimexDatalinkClient
         def list_entry_characters
           eeprom_chars_for(list_entry)
         end
+
+        def priority_value
+          priority.nil? ? 0 : priority
+        end
       end
     end
   end

data/lib/timex_datalink_client/protocol_1/time.rb

@@ -1,16 +1,24 @@
 # frozen_string_literal: true
 
+require "active_model"
+
 require "timex_datalink_client/helpers/crc_packets_wrapper"
 
 class TimexDatalinkClient
   class Protocol1
     class Time
+      include ActiveModel::Validations
       prepend Helpers::CrcPacketsWrapper
 
       CPACKET_TIME = [0x30]
 
       attr_accessor :zone, :is_24h, :time
 
+      validates :zone, inclusion: {
+        in: 1..2,
+        message: "%{value} is invalid!  Valid zones are 1..2."
+      }
+
       # Create a Time instance.
       #
       # @param zone [Integer] Time zone number (1 or 2).
@@ -25,8 +33,11 @@ class TimexDatalinkClient
 
       # Compile packets for a time.
       #
+      # @raise [ActiveModel::ValidationError] One or more model values are invalid.
       # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
       def packets
+        validate!
+
         [
           [
             CPACKET_TIME,

data/lib/timex_datalink_client/protocol_1/time_name.rb

@@ -1,11 +1,14 @@
 # frozen_string_literal: true
 
+require "active_model"
+
 require "timex_datalink_client/helpers/char_encoders"
 require "timex_datalink_client/helpers/crc_packets_wrapper"
 
 class TimexDatalinkClient
   class Protocol1
     class TimeName
+      include ActiveModel::Validations
       include Helpers::CharEncoders
       prepend Helpers::CrcPacketsWrapper
 
@@ -13,6 +16,11 @@ class TimexDatalinkClient
 
       attr_accessor :zone, :name
 
+      validates :zone, inclusion: {
+        in: 1..2,
+        message: "%{value} is invalid!  Valid zones are 1..2."
+      }
+
       # Create a TimeName instance.
       #
       # @param zone [Integer] Time zone number (1 or 2).
@@ -25,8 +33,11 @@ class TimexDatalinkClient
 
       # Compile packets for a time name.
       #
+      # @raise [ActiveModel::ValidationError] One or more model values are invalid.
       # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
       def packets
+        validate!
+
         [
           [
             CPACKET_NAME,

data/lib/timex_datalink_client/protocol_3/alarm.rb

@@ -1,11 +1,14 @@
 # frozen_string_literal: true
 
+require "active_model"
+
 require "timex_datalink_client/helpers/char_encoders"
 require "timex_datalink_client/helpers/crc_packets_wrapper"
 
 class TimexDatalinkClient
   class Protocol3
     class Alarm
+      include ActiveModel::Validations
       include Helpers::CharEncoders
       prepend Helpers::CrcPacketsWrapper
 
@@ -13,6 +16,11 @@ class TimexDatalinkClient
 
       attr_accessor :number, :audible, :time, :message
 
+      validates :number, inclusion: {
+        in: 1..5,
+        message: "value %{value} is invalid!  Valid number values are 1..5."
+      }
+
       # Create an Alarm instance.
       #
       # @param number [Integer] Alarm number (from 1 to 5).
@@ -29,8 +37,11 @@ class TimexDatalinkClient
 
       # Compile packets for an alarm.
       #
+      # @raise [ActiveModel::ValidationError] One or more model values are invalid.
       # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
       def packets
+        validate!
+
         [
           [
             CPACKET_ALARM,

data/lib/timex_datalink_client/protocol_3/eeprom/list.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "active_model"
+
 require "timex_datalink_client/helpers/char_encoders"
 require "timex_datalink_client/helpers/length_packet_wrapper"
 
@@ -7,15 +9,22 @@ class TimexDatalinkClient
   class Protocol3
     class Eeprom
       class List
+        include ActiveModel::Validations
         include Helpers::CharEncoders
         prepend Helpers::LengthPacketWrapper
 
         attr_accessor :list_entry, :priority
 
+        validates :priority, inclusion: {
+          in: 1..5,
+          allow_nil: true,
+          message: "%{value} is invalid!  Valid priorities are 1..5 or nil."
+        }
+
         # Create a List instance.
         #
         # @param list_entry [String] List entry text.
-        # @param priority [Integer] List priority.
+        # @param priority [Integer, nil] List priority.
         # @return [List] List instance.
         def initialize(list_entry:, priority:)
           @list_entry = list_entry
@@ -24,10 +33,13 @@ class TimexDatalinkClient
 
         # Compile a packet for a list.
         #
+        # @raise [ActiveModel::ValidationError] One or more model values are invalid.
         # @return [Array<Integer>] Array of integers that represent bytes.
         def packet
+          validate!
+
           [
-            priority,
+            priority_value,
             list_entry_characters
           ].flatten
         end
@@ -37,6 +49,10 @@ class TimexDatalinkClient
         def list_entry_characters
           eeprom_chars_for(list_entry)
         end
+
+        def priority_value
+          priority.nil? ? 0 : priority
+        end
       end
     end
   end

data/lib/timex_datalink_client/protocol_3/time.rb

@@ -1,23 +1,46 @@
 # frozen_string_literal: true
 
+require "active_model"
+
 require "timex_datalink_client/helpers/char_encoders"
 require "timex_datalink_client/helpers/crc_packets_wrapper"
 
 class TimexDatalinkClient
   class Protocol3
     class Time
+      include ActiveModel::Validations
       include Helpers::CharEncoders
       prepend Helpers::CrcPacketsWrapper
 
       CPACKET_TIME = [0x32]
 
+      DATE_FORMAT_MAP = {
+        "%_m-%d-%y" => 0,
+        "%_d-%m-%y" => 1,
+        "%y-%m-%d" => 2,
+        "%_m.%d.%y" => 4,
+        "%_d.%m.%y" => 5,
+        "%y.%m.%d" => 6
+      }.freeze
+
+      validates :zone, inclusion: {
+        in: 1..2,
+        message: "%{value} is invalid!  Valid zones are 1..2."
+      }
+
+      validates :date_format, inclusion: {
+        in: DATE_FORMAT_MAP.keys,
+        message: "%{value} is invalid!  Valid date formats are #{DATE_FORMAT_MAP.keys}."
+      }
+
       attr_accessor :zone, :is_24h, :date_format, :time
 
       # Create a Time instance.
       #
       # @param zone [Integer] Time zone number (1 or 2).
       # @param is_24h [Boolean] Toggle 24 hour time.
-      # @param date_format [Integer] Date format.
+      # @param date_format ["%_m-%d-%y", "%_d-%m-%y", "%y-%m-%d", "%_m.%d.%y", "%_d.%m.%y", "%y.%m.%d"] Date format
+      #   (represented by Time#strftime format).
       # @param time [::Time] Time to set (including time zone).
       # @param name [String, nil] Name of time zone (defaults to zone from time; 3 chars max)
       # @return [Time] Time instance.
@@ -31,8 +54,11 @@ class TimexDatalinkClient
 
       # Compile packets for a time.
       #
+      # @raise [ActiveModel::ValidationError] One or more model values are invalid.
       # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
       def packets
+        validate!
+
         [
           [
             CPACKET_TIME,
@@ -46,7 +72,7 @@ class TimexDatalinkClient
             name_characters,
             wday_from_monday,
             is_24h_value,
-            date_format
+            date_format_value
           ].flatten
         ]
       end
@@ -72,6 +98,10 @@ class TimexDatalinkClient
       def is_24h_value
         is_24h ? 2 : 1
       end
+
+      def date_format_value
+        DATE_FORMAT_MAP.fetch(date_format)
+      end
     end
   end
 end

data/lib/timex_datalink_client/protocol_4/alarm.rb

@@ -1,11 +1,14 @@
 # frozen_string_literal: true
 
+require "active_model"
+
 require "timex_datalink_client/helpers/char_encoders"
 require "timex_datalink_client/helpers/crc_packets_wrapper"
 
 class TimexDatalinkClient
   class Protocol4
     class Alarm
+      include ActiveModel::Validations
       include Helpers::CharEncoders
       prepend Helpers::CrcPacketsWrapper
 
@@ -13,6 +16,11 @@ class TimexDatalinkClient
 
       attr_accessor :number, :audible, :time, :message
 
+      validates :number, inclusion: {
+        in: 1..5,
+        message: "value %{value} is invalid!  Valid number values are 1..5."
+      }
+
       # Create an Alarm instance.
       #
       # @param number [Integer] Alarm number (from 1 to 5).
@@ -29,8 +37,11 @@ class TimexDatalinkClient
 
       # Compile packets for an alarm.
       #
+      # @raise [ActiveModel::ValidationError] One or more model values are invalid.
       # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
       def packets
+        validate!
+
         [
           [
             CPACKET_ALARM,

data/lib/timex_datalink_client/protocol_4/eeprom/list.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "active_model"
+
 require "timex_datalink_client/helpers/char_encoders"
 require "timex_datalink_client/helpers/length_packet_wrapper"
 
@@ -7,11 +9,18 @@ class TimexDatalinkClient
   class Protocol4
     class Eeprom
       class List
+        include ActiveModel::Validations
         include Helpers::CharEncoders
         prepend Helpers::LengthPacketWrapper
 
         attr_accessor :list_entry, :priority
 
+        validates :priority, inclusion: {
+          in: 1..5,
+          allow_nil: true,
+          message: "%{value} is invalid!  Valid priorities are 1..5 or nil."
+        }
+
         # Create a List instance.
         #
         # @param list_entry [String] List entry text.
@@ -24,10 +33,13 @@ class TimexDatalinkClient
 
         # Compile a packet for a list.
         #
+        # @raise [ActiveModel::ValidationError] One or more model values are invalid.
         # @return [Array<Integer>] Array of integers that represent bytes.
         def packet
+          validate!
+
           [
-            priority,
+            priority_value,
             list_entry_characters
           ].flatten
         end
@@ -37,6 +49,10 @@ class TimexDatalinkClient
         def list_entry_characters
           eeprom_chars_for(list_entry)
         end
+
+        def priority_value
+          priority.nil? ? 0 : priority
+        end
       end
     end
   end

data/lib/timex_datalink_client/protocol_4/time.rb

@@ -1,23 +1,46 @@
 # frozen_string_literal: true
 
+require "active_model"
+
 require "timex_datalink_client/helpers/char_encoders"
 require "timex_datalink_client/helpers/crc_packets_wrapper"
 
 class TimexDatalinkClient
   class Protocol4
     class Time
+      include ActiveModel::Validations
       include Helpers::CharEncoders
       prepend Helpers::CrcPacketsWrapper
 
       CPACKET_TIME = [0x32]
 
+      DATE_FORMAT_MAP = {
+        "%_m-%d-%y" => 0,
+        "%_d-%m-%y" => 1,
+        "%y-%m-%d" => 2,
+        "%_m.%d.%y" => 4,
+        "%_d.%m.%y" => 5,
+        "%y.%m.%d" => 6
+      }.freeze
+
+      validates :zone, inclusion: {
+        in: 1..2,
+        message: "%{value} is invalid!  Valid zones are 1..2."
+      }
+
+      validates :date_format, inclusion: {
+        in: DATE_FORMAT_MAP.keys,
+        message: "%{value} is invalid!  Valid date formats are #{DATE_FORMAT_MAP.keys}."
+      }
+
       attr_accessor :zone, :is_24h, :date_format, :time
 
       # Create a Time instance.
       #
       # @param zone [Integer] Time zone number (1 or 2).
       # @param is_24h [Boolean] Toggle 24 hour time.
-      # @param date_format [Integer] Date format.
+      # @param date_format ["%_m-%d-%y", "%_d-%m-%y", "%y-%m-%d", "%_m.%d.%y", "%_d.%m.%y", "%y.%m.%d"] Date format
+      #   (represented by Time#strftime format).
       # @param time [::Time] Time to set (including time zone).
       # @param name [String, nil] Name of time zone (defaults to zone from time; 3 chars max)
       # @return [Time] Time instance.
@@ -31,8 +54,11 @@ class TimexDatalinkClient
 
       # Compile packets for a time.
       #
+      # @raise [ActiveModel::ValidationError] One or more model values are invalid.
       # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
       def packets
+        validate!
+
         [
           [
             CPACKET_TIME,
@@ -46,7 +72,7 @@ class TimexDatalinkClient
             name_characters,
             wday_from_monday,
             is_24h_value,
-            date_format
+            date_format_value
           ].flatten
         ]
       end
@@ -72,6 +98,10 @@ class TimexDatalinkClient
       def is_24h_value
         is_24h ? 2 : 1
       end
+
+      def date_format_value
+        DATE_FORMAT_MAP.fetch(date_format)
+      end
     end
   end
 end

data/lib/timex_datalink_client/protocol_7/eeprom/calendar/event.rb

@@ -1,10 +1,14 @@
 # frozen_string_literal: true
 
+require "timex_datalink_client/helpers/lsb_msb_formatter"
+
 class TimexDatalinkClient
   class Protocol7
     class Eeprom
       class Calendar
         class Event
+          include Helpers::LsbMsbFormatter
+
           FIVE_MINUTES_SECONDS = 300
 
           attr_accessor :time, :phrase
@@ -24,7 +28,7 @@ class TimexDatalinkClient
             seconds = (time - device_time_midnight).to_i
             five_minutes = seconds / FIVE_MINUTES_SECONDS
 
-            five_minutes.divmod(256).reverse
+            lsb_msb_format_for(five_minutes)
           end
         end
       end

data/lib/timex_datalink_client/protocol_7/eeprom/calendar.rb

@@ -1,12 +1,14 @@
 # frozen_string_literal: true
 
 require "timex_datalink_client/helpers/four_byte_formatter"
+require "timex_datalink_client/helpers/lsb_msb_formatter"
 
 class TimexDatalinkClient
   class Protocol7
     class Eeprom
       class Calendar
         include Helpers::FourByteFormatter
+        include Helpers::LsbMsbFormatter
 
         DAY_START_TIME = Time.new(2000)
         DAY_SECONDS = 86400
@@ -48,7 +50,7 @@ class TimexDatalinkClient
         private
 
         def events_count
-          events.count.divmod(256).reverse
+          lsb_msb_format_for(events.count)
         end
 
         def event_packets
@@ -57,7 +59,7 @@ class TimexDatalinkClient
 
           [].tap do |event_packets|
             events.each_with_index do |event, event_index|
-              event_bytes_formatted = event_bytes.divmod(256).reverse
+              event_bytes_formatted = lsb_msb_format_for(event_bytes)
               event_time_formatted = event.time_formatted(time)
 
               event_packets << [event_time_formatted, event_bytes_formatted]
@@ -77,13 +79,13 @@ class TimexDatalinkClient
           since_start_time_seconds = time - DAY_START_TIME
           since_start_time_days = since_start_time_seconds.to_i / DAY_SECONDS
 
-          since_start_time_days.divmod(256).reverse
+          lsb_msb_format_for(since_start_time_days)
         end
 
         def time_formatted
           five_mintes = (time.hour * 60 + time.min) / 5
 
-          five_mintes.divmod(256).reverse
+          lsb_msb_format_for(five_mintes)
         end
       end
     end

data/lib/timex_datalink_client/protocol_7/eeprom/games.rb

@@ -1,12 +1,14 @@
 # frozen_string_literal: true
 
 require "timex_datalink_client/helpers/four_byte_formatter"
+require "timex_datalink_client/helpers/lsb_msb_formatter"
 
 class TimexDatalinkClient
   class Protocol7
     class Eeprom
       class Games
         include Helpers::FourByteFormatter
+        include Helpers::LsbMsbFormatter
 
         COUNTDOWN_TIMER_SECONDS_DEFAULT = 60
 
@@ -85,11 +87,11 @@ class TimexDatalinkClient
             game ? 1 << game_index : 0
           end
 
-          bitmask.divmod(256).reverse
+          lsb_msb_format_for(bitmask)
         end
 
         def countdown_timer_time
-          (countdown_timer_seconds * 10).divmod(256).reverse
+          lsb_msb_format_for(countdown_timer_seconds * 10)
         end
 
         def sounds

data/lib/timex_datalink_client/protocol_7/eeprom/speech.rb

@@ -1,12 +1,14 @@
 # frozen_string_literal: true
 
 require "timex_datalink_client/helpers/four_byte_formatter"
+require "timex_datalink_client/helpers/lsb_msb_formatter"
 
 class TimexDatalinkClient
   class Protocol7
     class Eeprom
       class Speech
         include Helpers::FourByteFormatter
+        include Helpers::LsbMsbFormatter
 
         NICKNAME_LENGTH_WITHOUT_DEVICE = 10
         NICKNAME_LENGTH_WITH_DEVICE = 14
@@ -123,7 +125,7 @@ class TimexDatalinkClient
         def header
           all_values = [header_value_1, header_value_2, header_value_3] + header_values_4 + header_values_5
 
-          all_values.flat_map { |value| value.divmod(256).reverse }
+          all_values.flat_map { |value| lsb_msb_format_for(value) }
         end
 
         def header_value_1

data/lib/timex_datalink_client/protocol_9/alarm.rb

@@ -1,18 +1,63 @@
 # frozen_string_literal: true
 
+require "active_model"
+
 require "timex_datalink_client/helpers/char_encoders"
 require "timex_datalink_client/helpers/crc_packets_wrapper"
 
 class TimexDatalinkClient
   class Protocol9
     class Alarm
+      include ActiveModel::Validations
       include Helpers::CharEncoders
       prepend Helpers::CrcPacketsWrapper
 
       CPACKET_ALARM = [0x50]
 
+      VALID_DAYS_IN_MONTH = {
+        1 => 1..31,
+        2 => 1..29,
+        3 => 1..31,
+        4 => 1..30,
+        5 => 1..31,
+        6 => 1..30,
+        7 => 1..31,
+        8 => 1..31,
+        9 => 1..30,
+        10 => 1..31,
+        11 => 1..30,
+        12 => 1..31
+      }.freeze
+
       attr_accessor :number, :audible, :time, :message, :month, :day
 
+      validates :number, inclusion: {
+        in: 1..10,
+        message: "value %{value} is invalid!  Valid number values are 1..10."
+      }
+
+      validates :month, inclusion: {
+        in: 1..12,
+        allow_nil: true,
+        message: "%{value} is invalid!  Valid months are 1..12 and nil."
+      }
+
+      validates :day, inclusion: {
+        if: ->(alarm) { alarm.month.nil? },
+        in: 1..31,
+        allow_nil: true,
+        message: "%{value} is invalid!  Valid days are 1..31 and nil."
+      }
+
+      validates :day, inclusion: {
+        if: ->(alarm) { alarm.day && alarm.month },
+        in: ->(alarm) { VALID_DAYS_IN_MONTH[alarm.month] },
+        message: ->(alarm, _attributes) do
+          "#{alarm.day} is invalid for month #{alarm.month}!  " \
+          "Valid days are #{VALID_DAYS_IN_MONTH[alarm.month]} and nil when month is #{alarm.month}."
+        end
+      }
+
       # Create an Alarm instance.
       #
       # @param number [Integer] Alarm number (from 1 to 10).
@@ -33,8 +78,11 @@ class TimexDatalinkClient
 
       # Compile packets for an alarm.
       #
+      # @raise [ActiveModel::ValidationError] One or more model values are invalid.
       # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
       def packets
+        validate!
+
         [
           [
             CPACKET_ALARM,

data/lib/timex_datalink_client/protocol_9/eeprom/chrono.rb

@@ -1,11 +1,14 @@
 # frozen_string_literal: true
 
+require "active_model"
+
 require "timex_datalink_client/helpers/char_encoders"
 
 class TimexDatalinkClient
   class Protocol9
     class Eeprom
       class Chrono
+        include ActiveModel::Validations
         include Helpers::CharEncoders
 
         CHRONO_LABEL_LENGTH = 8
@@ -13,6 +16,11 @@ class TimexDatalinkClient
 
         attr_accessor :label, :laps
 
+        validates :laps, inclusion: {
+          in: 2..50,
+          message: "value %{value} is invalid!  Valid laps values are 2..50."
+        }
+
         # Create a Chrono instance.
         #
         # @param label [String] Label for chrono.
@@ -25,8 +33,11 @@ class TimexDatalinkClient
 
         # Compile a packet for a chrono.
         #
+        # @raise [ActiveModel::ValidationError] One or more model values are invalid.
         # @return [Array<Integer>] Array of integers that represent bytes.
         def packet
+          validate!
+
           label_characters
         end
 

data/lib/timex_datalink_client/protocol_9/time.rb

@@ -1,16 +1,24 @@
 # frozen_string_literal: true
 
+require "active_model"
+
 require "timex_datalink_client/helpers/crc_packets_wrapper"
 
 class TimexDatalinkClient
   class Protocol9
     class Time
+      include ActiveModel::Validations
       prepend Helpers::CrcPacketsWrapper
 
       CPACKET_TIME = [0x30]
 
       attr_accessor :zone, :is_24h, :time
 
+      validates :zone, inclusion: {
+        in: 1..2,
+        message: "%{value} is invalid!  Valid zones are 1..2."
+      }
+
       # Create a Time instance.
       #
       # @param zone [Integer] Time zone number (1 or 2).
@@ -25,8 +33,11 @@ class TimexDatalinkClient
 
       # Compile packets for a time.
       #
+      # @raise [ActiveModel::ValidationError] One or more model values are invalid.
       # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
       def packets
+        validate!
+
         [
           [
             CPACKET_TIME,

data/lib/timex_datalink_client/protocol_9/time_name.rb

@@ -1,11 +1,14 @@
 # frozen_string_literal: true
 
+require "active_model"
+
 require "timex_datalink_client/helpers/char_encoders"
 require "timex_datalink_client/helpers/crc_packets_wrapper"
 
 class TimexDatalinkClient
   class Protocol9
     class TimeName
+      include ActiveModel::Validations
       include Helpers::CharEncoders
       prepend Helpers::CrcPacketsWrapper
 
@@ -13,6 +16,11 @@ class TimexDatalinkClient
 
       attr_accessor :zone, :name
 
+      validates :zone, inclusion: {
+        in: 1..2,
+        message: "%{value} is invalid!  Valid zones are 1..2."
+      }
+
       # Create a TimeName instance.
       #
       # @param zone [Integer] Time zone number (1 or 2).
@@ -25,8 +33,11 @@ class TimexDatalinkClient
 
       # Compile packets for a time name.
       #
+      # @raise [ActiveModel::ValidationError] One or more model values are invalid.
       # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
       def packets
+        validate!
+
         [
           [
             CPACKET_NAME,

data/lib/timex_datalink_client/protocol_9/timer.rb

@@ -11,6 +11,12 @@ class TimexDatalinkClient
 
       CPACKET_TIMER = [0x43]
 
+      ACTION_AT_END_MAP = {
+        stop_timer: 0,
+        repeat_timer: 1,
+        start_chrono: 2
+      }.freeze
+
       attr_accessor :number, :label, :time, :action_at_end
 
       # Create a Timer instance.
@@ -18,7 +24,7 @@ class TimexDatalinkClient
       # @param number [Integer] Entry number for timer.
       # @param label [String] Label for timer.
       # @param time [Time] Time of timer.
-      # @param action_at_end [Integer] Action at end of timer.
+      # @param action_at_end [:stop_timer, :repeat_timer, :start_chrono] Action at end of timer.
       # @return [Timer] Timer instance.
       def initialize(number:, label:, time:, action_at_end:)
         @number = number
@@ -38,7 +44,7 @@ class TimexDatalinkClient
             time.hour,
             time.min,
             time.sec,
-            action_at_end,
+            action_at_end_value,
             label_characters
           ].flatten
         ]
@@ -46,6 +52,10 @@ class TimexDatalinkClient
 
       private
 
+      def action_at_end_value
+        ACTION_AT_END_MAP.fetch(action_at_end)
+      end
+
       def label_characters
         chars_for(label, length: 8, pad: true)
       end

data/lib/timex_datalink_client/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class TimexDatalinkClient
-  VERSION = "0.8.0"
+  VERSION = "0.10.0"
 end

metadata

@@ -1,43 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: timex_datalink_client
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Maxwell Pray
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-12-13 00:00:00.000000000 Z
+date: 2022-12-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: crc
+  name: activemodel
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.2
+        version: 7.0.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.2
+        version: 7.0.4
 - !ruby/object:Gem::Dependency
-  name: rubyserial
+  name: crc
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.6.0
+        version: 0.4.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.6.0
+        version: 0.4.2
 - !ruby/object:Gem::Dependency
   name: mdb
   requirement: !ruby/object:Gem::Requirement
@@ -52,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.5.0
+- !ruby/object:Gem::Dependency
+  name: rubyserial
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -106,6 +120,7 @@ files:
 - lib/timex_datalink_client/helpers/crc_packets_wrapper.rb
 - lib/timex_datalink_client/helpers/four_byte_formatter.rb
 - lib/timex_datalink_client/helpers/length_packet_wrapper.rb
+- lib/timex_datalink_client/helpers/lsb_msb_formatter.rb
 - lib/timex_datalink_client/notebook_adapter.rb
 - lib/timex_datalink_client/protocol_1/alarm.rb
 - lib/timex_datalink_client/protocol_1/eeprom.rb
@@ -167,7 +182,7 @@ files:
 - lib/timex_datalink_client/protocol_9/time_name.rb
 - lib/timex_datalink_client/protocol_9/timer.rb
 - lib/timex_datalink_client/version.rb
-homepage: https://github.com/synthead/timex_datalink_client/tree/v0.8.0
+homepage: https://github.com/synthead/timex_datalink_client/tree/v0.10.0
 licenses:
 - MIT
 metadata: {}