timex_datalink_client 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: efa331ee9142b5392695a07a8f904f6c967584bb2b39abe1a5fd3577150f4eaf
-  data.tar.gz: ba994a959bb3156a218bfe1faef05c8a51223b911c6c926152d15182178ade1d
+  metadata.gz: 7bbd5ed72c50f798a4efc663846f406338e1a777cd8587ba504a283c7976e7bf
+  data.tar.gz: '0843b0db0875cfc5ea663e85dcf0cf007bfb88b89306945390d51ab9eba09693'
 SHA512:
-  metadata.gz: 69b09f2da57887e8ca4cc8c4f4186c21a9bb10b57d05e839d0122a0158ffde4fe7896268c74d525cdff2caf941dd1506b54d4db4ce4cd620d7bbbffb6d4cfa2a
-  data.tar.gz: 4cc7a686c22c7aa1b2a987286b2ecf023b3a36b423ba2d6a47665b743b8e989a3d29ab718466634893ac7d559f8b4e9e67d25d3797bdea8e8a1a399d67fa9f37
+  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,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 Time
+      include ActiveModel::Validations
       include Helpers::CharEncoders
       prepend Helpers::CrcPacketsWrapper
 
@@ -20,6 +23,16 @@ class TimexDatalinkClient
         "%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.
@@ -41,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,

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,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 Time
+      include ActiveModel::Validations
       include Helpers::CharEncoders
       prepend Helpers::CrcPacketsWrapper
 
@@ -20,6 +23,16 @@ class TimexDatalinkClient
         "%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.
@@ -41,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,

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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class TimexDatalinkClient
-  VERSION = "0.9.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.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Maxwell Pray
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-12-23 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.9.0
+homepage: https://github.com/synthead/timex_datalink_client/tree/v0.10.0
 licenses:
 - MIT
 metadata: {}