timex_datalink_client 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f9e485933a8ebd16d37042e129d57ad2aef2814fc6b7c52c5a4a35230b7a2313
-  data.tar.gz: 393b34c750c6861cffcba17050089f6afcf55f40ce7dae8613fbcd5500c22c16
+  metadata.gz: 93fe636dc699046ea5c14683b355f8c65bb162fb18ee91b3ffe27f4a72633808
+  data.tar.gz: d9476317e2cce78a77247c277e77208969f6e8fa13059a2e0f7452f502f9b112
 SHA512:
-  metadata.gz: 2175e0d2ef370e68ed0a89d9d76d28b2c17503e13ddcd155f070ceac5e4cfab4f5d20850878f6ba95e981865584cf44d9ba3e42dd4e431a48b06ebc9ddfbf35d
-  data.tar.gz: 28452c2ad771e7649870efff7136340f6699ee38877d8ff9085d5d26f1c4d5d19db96f4cfdeddd33c152fefd5a9474025a147f59d07ba0c012168b3b1f4744e1
+  metadata.gz: 313b6bc8ea78a28ee55534ff28648a6544a8aa7dcf1abd731461fc7b9c21ba3711d441de603d7f538666541d5fce4ca0d6206449a2b8cee6cf5d56a263f8691a
+  data.tar.gz: df31c376348f69fd05ba4c0de720e443074f68d63788601610021e0328598af3cfa8a3f85789336d20e80aac90be5ac32526bc6872d208afdd2c6965582f1617

data/lib/timex_datalink_client/helpers/four_byte_formatter.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+class TimexDatalinkClient
+  class Helpers
+    module FourByteFormatter
+      BYTE_NULL = 0x000
+      BYTE_TERMINATOR_ENDF = 0x3fe
+      BYTE_TERMINATOR_ENDR = 0x3ff
+
+      def four_byte_format_for(byte_arrays)
+        byte_arrays.each_with_index.flat_map do |bytes, bytes_index|
+          last_index = bytes_index == byte_arrays.count - 1
+          terminator = last_index ? BYTE_TERMINATOR_ENDR : BYTE_TERMINATOR_ENDF
+
+          bytes_with_terminator = bytes + [terminator]
+
+          bytes_with_terminator.each_slice(4).flat_map do |bytes_slice|
+            bytes_slice.fill(BYTE_NULL, bytes_slice.count, 4 - bytes_slice.count)
+
+            packet_lsbs_sum = bytes_slice.each_with_index.sum { |byte, index| byte / 256 << 6 - index * 2 }
+            packet_msbs = bytes_slice.map { |byte| byte % 256 }
+
+            [packet_lsbs_sum] + packet_msbs
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+require "timex_datalink_client/helpers/four_byte_formatter"
+
+class TimexDatalinkClient
+  class Protocol7
+    class Eeprom
+      class Activity
+        include Helpers::FourByteFormatter
+
+        METADATA_BYTES_BASE = 6
+        METADATA_BYTES_SIZE = 5
+
+        PACKETS_TERMINATOR = 0x04
+
+        # Compile data for all activities.
+        #
+        # @param activities [Array<Activity>] Activities to compile data for.
+        # @return [Array] Compiled data of all activities.
+        def self.packets(activities)
+          header(activities) + metadata_and_messages(activities) + [PACKETS_TERMINATOR]
+        end
+
+        private_class_method def self.header(activities)
+          [
+            random_speech(activities),
+            0,
+            0,
+            0,
+            activities.count,
+            0
+          ]
+        end
+
+        private_class_method def self.random_speech(activities)
+          activities.each_with_index.sum do |activity, activity_index|
+            activity.random_speech ? 1 << activity_index : 0
+          end
+        end
+
+        private_class_method def self.metadata_and_messages(activities)
+          metadata = activities.each_with_index.map do |activity, activity_index|
+            activity.metadata_packet(activities.count + activity_index)
+          end
+
+          messages = activities.map { |activity| activity.messages_packet }
+
+          (metadata + messages).flatten
+        end
+
+        attr_accessor :time, :messages, :random_speech
+
+        # Create an Activity instance.
+        #
+        # @param time [::Time] Time of activity.
+        # @param messages [Array<Array<Integer>>] Messages for activity.
+        # @param random_speech [Boolean] If activity should have random speech.
+        # @return [Activity] Activity instance.
+        def initialize(time:, messages:, random_speech:)
+          @time = time
+          @messages = messages
+          @random_speech = random_speech
+        end
+
+        # Compile a metadata packet for an activity.
+        #
+        # @param activity_index [Integer] Activity index.
+        # @return [Array<Integer>] Array of integers that represent bytes.
+        def metadata_packet(activity_index)
+          [
+            time.hour,
+            time.min,
+            messages.count,
+            metadata_bytes(activity_index),
+            0
+          ].flatten
+        end
+
+        # Compile a message packet for an activity.
+        #
+        # @return [Array<Integer>] Array of integers that represent bytes.
+        def messages_packet
+          four_byte_format_for(messages)
+        end
+
+        private
+
+        def metadata_bytes(activity_index)
+          METADATA_BYTES_BASE + METADATA_BYTES_SIZE * activity_index
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+class TimexDatalinkClient
+  class Protocol7
+    class Eeprom
+      class Calendar
+        class Event
+          FIVE_MINUTES_SECONDS = 300
+
+          attr_accessor :time, :phrase
+
+          # Create an Event instance.
+          #
+          # @param time [::Time] Time of event.
+          # @param phrase [Array<Integer>] Phrase for event.
+          # @return [Event] Event instance.
+          def initialize(time:, phrase:)
+            @time = time
+            @phrase = phrase
+          end
+
+          def time_formatted(device_time)
+            device_time_midnight = Time.new(device_time.year, device_time.month, device_time.day)
+            seconds = (time - device_time_midnight).to_i
+            five_minutes = seconds / FIVE_MINUTES_SECONDS
+
+            five_minutes.divmod(256).reverse
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+require "timex_datalink_client/helpers/four_byte_formatter"
+
+class TimexDatalinkClient
+  class Protocol7
+    class Eeprom
+      class Calendar
+        include Helpers::FourByteFormatter
+
+        DAY_START_TIME = Time.new(2000)
+        DAY_SECONDS = 86400
+
+        EVENTS_BYTES_BASE = 2
+        EVENTS_BYTES_EVENT = 4
+        EVENTS_BYTES_PHRASE_PACKET = 5
+
+        PACKETS_TERMINATOR = 0x01
+
+        attr_accessor :time, :events
+
+        # Create a Calendar instance.
+        #
+        # @param time [::Time] Time to set device to.
+        # @param events [Array<Event>] Event instances to add to the calendar.
+        # @return [Calendar] Calendar instance.
+        def initialize(time:, events: [])
+          @time = time
+          @events = events
+        end
+
+        # Compile data for calendar.
+        #
+        # @return [Array<Integer>] Compiled data for calendar.
+        def packet
+          [
+            events_count,
+            event_packets,
+            event_phrases,
+            time.hour,
+            time.min,
+            days_from_2000,
+            time_formatted,
+            PACKETS_TERMINATOR
+          ].flatten
+        end
+
+        private
+
+        def events_count
+          events.count.divmod(256).reverse
+        end
+
+        def event_packets
+          event_bytes = EVENTS_BYTES_BASE
+          event_bytes += EVENTS_BYTES_EVENT * events.count
+
+          [].tap do |event_packets|
+            events.each_with_index do |event, event_index|
+              event_bytes_formatted = event_bytes.divmod(256).reverse
+              event_time_formatted = event.time_formatted(time)
+
+              event_packets << [event_time_formatted, event_bytes_formatted]
+
+              event_bytes += EVENTS_BYTES_PHRASE_PACKET * (1 + event.phrase.length / 4)
+            end
+          end
+        end
+
+        def event_phrases
+          phrases = events.map(&:phrase)
+
+          four_byte_format_for(phrases)
+        end
+
+        def days_from_2000
+          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
+        end
+
+        def time_formatted
+          five_mintes = (time.hour * 60 + time.min) / 5
+
+          five_mintes.divmod(256).reverse
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+require "timex_datalink_client/helpers/four_byte_formatter"
+
+class TimexDatalinkClient
+  class Protocol7
+    class Eeprom
+      class Games
+        include Helpers::FourByteFormatter
+
+        COUNTDOWN_TIMER_SECONDS_DEFAULT = 60
+
+        COUNTDOWN_TIMER_SOUND_DEFAULT = 0x062
+        MUSIC_TIME_KEEPER_SOUND_DEFAULT = 0x062
+
+        PACKETS_TERMINATOR = 0x02
+
+        attr_accessor :memory_game_enabled, :fortune_teller_enabled, :countdown_timer_enabled, :countdown_timer_seconds,
+          :countdown_timer_sound, :mind_reader_enabled, :music_time_keeper_enabled, :music_time_keeper_sound,
+          :morse_code_practice_enabled, :treasure_hunter_enabled, :rhythm_rhyme_buster_enabled, :stop_watch_enabled,
+          :red_light_green_light_enabled
+
+        # Create a Games instance.
+        #
+        # @param memory_game_enabled [Boolean] Toggle memory game.
+        # @param fortune_teller_enabled [Boolean] Toggle fortune teller.
+        # @param countdown_timer_enabled [Boolean] Toggle countdown timer.
+        # @param countdown_timer_seconds [Integer] Duration for countdown timer in seconds.
+        # @param countdown_timer_sound [Integer] Sound for countdown timer.
+        # @param mind_reader_enabled [Boolean] Toggle mind reader.
+        # @param music_time_keeper_enabled [Boolean] Toggle music time keeper.
+        # @param music_time_keeper_sound [Integer] Sound for music time keeper.
+        # @param morse_code_practice_enabled [Boolean] Toggle Morse code practice.
+        # @param treasure_hunter_enabled [Boolean] Toggle treasure hunter.
+        # @param rhythm_rhyme_buster_enabled [Boolean] Toggle rhythm & rhyme buster.
+        # @param stop_watch_enabled [Boolean] Toggle stop watch.
+        # @param red_light_green_light_enabled [Boolean] Toggle red light, green light.
+        # @return [Games] Games instance.
+        def initialize(
+          memory_game_enabled: false,
+          fortune_teller_enabled: false,
+          countdown_timer_enabled: false,
+          countdown_timer_seconds: COUNTDOWN_TIMER_SECONDS_DEFAULT,
+          countdown_timer_sound: COUNTDOWN_TIMER_SOUND_DEFAULT,
+          mind_reader_enabled: false,
+          music_time_keeper_enabled: false,
+          music_time_keeper_sound: MUSIC_TIME_KEEPER_SOUND_DEFAULT,
+          morse_code_practice_enabled: false,
+          treasure_hunter_enabled: false,
+          rhythm_rhyme_buster_enabled: false,
+          stop_watch_enabled: false,
+          red_light_green_light_enabled: false
+        )
+          @memory_game_enabled = memory_game_enabled
+          @fortune_teller_enabled = fortune_teller_enabled
+          @countdown_timer_enabled = countdown_timer_enabled
+          @countdown_timer_seconds = countdown_timer_seconds
+          @countdown_timer_sound = countdown_timer_sound
+          @mind_reader_enabled = mind_reader_enabled
+          @music_time_keeper_enabled = music_time_keeper_enabled
+          @music_time_keeper_sound = music_time_keeper_sound
+          @morse_code_practice_enabled = morse_code_practice_enabled
+          @treasure_hunter_enabled = treasure_hunter_enabled
+          @rhythm_rhyme_buster_enabled = rhythm_rhyme_buster_enabled
+          @stop_watch_enabled = stop_watch_enabled
+          @red_light_green_light_enabled = red_light_green_light_enabled
+        end
+
+        # Compile data for games.
+        #
+        # @return [Array<Integer>] Compiled data for games.
+        def packet
+          [
+            enabled_games,
+            countdown_timer_time,
+            sounds,
+            PACKETS_TERMINATOR
+          ].flatten
+        end
+
+        private
+
+        def enabled_games
+          bitmask = games.each_with_index.sum do |game, game_index|
+            game ? 1 << game_index : 0
+          end
+
+          bitmask.divmod(256).reverse
+        end
+
+        def countdown_timer_time
+          (countdown_timer_seconds * 10).divmod(256).reverse
+        end
+
+        def sounds
+          sounds_extra_packet = four_byte_format_for(
+            [
+              [music_time_keeper_sound],
+              [countdown_timer_sound],
+              []
+            ]
+          )
+
+          sounds_extra_packet.first(10)
+        end
+
+        def games
+          [
+            memory_game_enabled,
+            fortune_teller_enabled,
+            countdown_timer_enabled,
+            mind_reader_enabled,
+            music_time_keeper_enabled,
+            morse_code_practice_enabled,
+            treasure_hunter_enabled,
+            rhythm_rhyme_buster_enabled,
+            stop_watch_enabled,
+            red_light_green_light_enabled
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require "timex_datalink_client/helpers/four_byte_formatter"
+
+class TimexDatalinkClient
+  class Protocol7
+    class Eeprom
+      class PhoneNumber
+        include Helpers::FourByteFormatter
+
+        PHONE_NUMBER_DIGITS_MAP = {
+          "0" => 0x001,
+          "1" => 0x002,
+          "2" => 0x003,
+          "3" => 0x004,
+          "4" => 0x005,
+          "5" => 0x006,
+          "6" => 0x007,
+          "7" => 0x008,
+          "8" => 0x009,
+          "9" => 0x00a
+        }.freeze
+
+        PACKETS_TERMINATOR = 0x03
+
+        # Compile data for all phone numbers.
+        #
+        # @param phone_numbers [Array<PhoneNumber>] Phone numbers to compile data for.
+        # @return [Array] Compiled data of all phone numbers.
+        def self.packets(phone_numbers)
+          header(phone_numbers) + names_and_numbers(phone_numbers) + [PACKETS_TERMINATOR]
+        end
+
+        private_class_method def self.header(phone_numbers)
+          [
+            phone_numbers.count,
+            0
+          ]
+        end
+
+        private_class_method def self.names_and_numbers(phone_numbers)
+          return [] if phone_numbers.empty?
+
+          names_and_numbers = phone_numbers.flat_map(&:name_and_number)
+
+          phone_numbers.first.four_byte_format_for(names_and_numbers)
+        end
+
+        attr_accessor :name, :number
+
+        # Create a PhoneNumber instance.
+        #
+        # @param name [Array<Integer>] Name associated to phone number.
+        # @param number [String] Phone number text.
+        # @return [PhoneNumber] PhoneNumber instance.
+        def initialize(name: [], number:)
+          @name = name
+          @number = number
+        end
+
+        # Compile an unformatted name and phone number.
+        #
+        # @return [Array<Integer>] Array of integers that represent bytes.
+        def name_and_number
+          [
+            name,
+            number_characters
+          ]
+        end
+
+        private
+
+        def number_characters
+          number.each_char.map { |digit| PHONE_NUMBER_DIGITS_MAP[digit] }
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,228 @@
+# frozen_string_literal: true
+
+require "timex_datalink_client/helpers/four_byte_formatter"
+
+class TimexDatalinkClient
+  class Protocol7
+    class Eeprom
+      class Speech
+        include Helpers::FourByteFormatter
+
+        NICKNAME_LENGTH_WITHOUT_DEVICE = 10
+        NICKNAME_LENGTH_WITH_DEVICE = 14
+
+        NICKNAME_SUFFIXES = [
+          [0x353, 0x3fd, 0x04d, 0x003, 0x28d],
+          [0x353, 0x3fd, 0x04d, 0x003, 0x27b],
+          [0x3fb, 0x363, 0x039, 0x03c],
+          [0x3fb, 0x361, 0x039, 0x03c, 0x194, 0x3fd, 0x04b, 0x003, 0x144, 0x327],
+          [0x3fb, 0x1ae, 0x030, 0x329, 0x03c, 0x3fb, 0x030, 0x320, 0x03c, 0x039, 0x124],
+          [0x3fb, 0x353, 0x003, 0x1ae, 0x2e6, 0x18e],
+          [0x361, 0x039, 0x03c, 0x144, 0x3fd, 0x04b],
+          [0x3fb, 0x361, 0x33e],
+          [0x1cb, 0x039, 0x03c, 0x144, 0x3fd, 0x04b],
+          [0x039, 0x35a, 0x1ae, 0x3fd, 0x04b, 0x18e, 0x381],
+          [0x039, 0x35a, 0x31c, 0x381],
+          [0x353, 0x3fd, 0x04d, 0x003, 0x28d, 0x07b, 0x094],
+          [0x1e0, 0x1ab],
+          [0x253, 0x3fd, 0x04d, 0x182],
+          [0x353, 0x3fd, 0x04d, 0x003, 0x357, 0x10c, 0x3fd, 0x04d]
+        ]
+
+        HEADER_VALUE_1_BASE = 0x0b
+        HEADER_VALUE_1_DEVICE_NICK = 4
+
+        HEADER_VALUE_2_BASE = 0x00
+        HEADER_VALUE_2_PHRASES = 26
+        HEADER_VALUE_2_DEVICE_NICK = 8
+
+        HEADER_VALUE_3_BASE = 0x1a
+        HEADER_VALUE_3_PHRASES = 2
+        HEADER_VALUE_3_DEVICE_NICK = 8
+
+        HEADER_VALUE_4_DEVICE_BASE = 8
+        HEADER_VALUE_4_PHRASE = 2
+
+        HEADER_VALUE_4_BASES = [0x1a, 0x1a, 0x1a, 0x1f, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a]
+        HEADER_VALUE_4_DEVICE_MULTIPLIERS = [5, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 5, 5, 5]
+
+        HEADER_VALUE_4_DEVICE_INDEXES = [
+          [0],
+          [0],
+          [0],
+          [0],
+          [0],
+          [0],
+          [0],
+          [0],
+          [0],
+          [0],
+          [0],
+          [0, 1, 11],
+          [0, 1, 11, 12],
+          [0, 1, 11, 12, 13]
+        ]
+
+        HEADER_VALUE_4_USER_MULTIPLIERS = [0, 0, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5]
+
+        HEADER_VALUE_4_USER_INDEXES = [
+          [],
+          [],
+          [2],
+          [2, 5],
+          [3, 4, 10],
+          [3, 4, 5, 10],
+          [3, 4, 5, 6, 10],
+          [3, 4, 5, 6, 7, 10],
+          [3, 4, 5, 6, 7, 8, 10],
+          [3, 4, 5, 6, 7, 8, 9, 10],
+          [2, 3, 4, 5, 6, 7, 8, 9, 10],
+          [2, 3, 4, 5, 6, 7, 8, 9, 10],
+          [2, 3, 4, 5, 6, 7, 8, 9, 10],
+          [2, 3, 4, 5, 6, 7, 8, 9, 10]
+        ]
+
+        HEADER_VALUE_5_BASE = 0x8d
+
+        HEADER_VALUE_5_DEVICE_BASE = -107
+        HEADER_VALUE_5_DEVICE_INDEXES = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13]
+        HEADER_VALUE_5_DEVICE_MULTIPLIER = 5
+
+        HEADER_VALUE_5_USER_BASE = 0
+        HEADER_VALUE_5_USER_INDEXES = [14]
+        HEADER_VALUE_5_USER_MULTIPLIER = 5
+
+        HEADER_VALUE_5_PHRASE = 2
+        HEADER_VALUE_5_PHRASE_PACKET = 5
+
+        PACKETS_TERMINATOR = 0x05
+
+        attr_accessor :phrases, :device_nickname, :user_nickname
+
+        # Create a Speech instance.
+        #
+        # @param phrases [Array<Array<Integer>>] Two-dimensional array of phrases.
+        # @param device_nickname [Array<Integer>] Device nickname.
+        # @param user_nickname [Array<Integer>] User nickname.
+        # @return [Speech] Speech instance.
+        def initialize(phrases: [], device_nickname: [], user_nickname: [])
+          @phrases = phrases
+          @device_nickname = device_nickname
+          @user_nickname = user_nickname
+        end
+
+        # Compile data for nicknames and phrases.
+        #
+        # @return [Array<Integer>] Compiled data of all nicknames and phrases.
+        def packet
+          header + nickname_bytes + formatted_phrases + [PACKETS_TERMINATOR]
+        end
+
+        private
+
+        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 }
+        end
+
+        def header_value_1
+          value_1 = HEADER_VALUE_1_BASE + phrases.count
+          value_1 += HEADER_VALUE_1_DEVICE_NICK if device_nickname.any?
+
+          value_1
+        end
+
+        def header_value_2
+          value_2 = HEADER_VALUE_2_BASE
+          value_2 += HEADER_VALUE_2_PHRASES if phrases.any?
+          value_2 += HEADER_VALUE_2_DEVICE_NICK if phrases.any? && device_nickname.any?
+
+          value_2
+        end
+
+        def header_value_3
+          value_3 = HEADER_VALUE_3_BASE
+          value_3 += HEADER_VALUE_3_DEVICE_NICK if device_nickname.any?
+          value_3 += HEADER_VALUE_3_PHRASES * phrases.count
+
+          value_3
+        end
+
+        def header_values_4
+          value_4_length = device_nickname.any? ? NICKNAME_LENGTH_WITH_DEVICE : NICKNAME_LENGTH_WITHOUT_DEVICE
+
+          value_4_length.times.flat_map do |value_4_index|
+            device_value = HEADER_VALUE_4_DEVICE_INDEXES[value_4_index].sum { |device_index| packet_lengths[device_index] }
+            device_value *= HEADER_VALUE_4_DEVICE_MULTIPLIERS[value_4_index]
+
+            user_value = HEADER_VALUE_4_USER_INDEXES[value_4_index].sum { |device_index| packet_lengths[device_index] }
+            user_value *= HEADER_VALUE_4_USER_MULTIPLIERS[value_4_index]
+
+            value = device_value + user_value
+            value += HEADER_VALUE_4_BASES[value_4_index]
+            value += HEADER_VALUE_4_PHRASE * phrases.count
+            value += HEADER_VALUE_4_DEVICE_BASE if device_nickname.any?
+
+            value
+          end
+        end
+
+        def header_values_5
+          phrases.each_index.flat_map do |phrase_index|
+            value = HEADER_VALUE_5_BASE
+
+            if device_nickname.any?
+              device_value = HEADER_VALUE_5_DEVICE_INDEXES.sum { |device_index| packet_lengths[device_index] }
+              device_value *= HEADER_VALUE_5_DEVICE_MULTIPLIER
+              device_value += HEADER_VALUE_5_DEVICE_BASE
+
+              value += device_value
+            end
+
+            if user_nickname.any?
+              user_value = HEADER_VALUE_5_USER_INDEXES.sum { |device_index| packet_lengths[device_index] }
+              user_value *= HEADER_VALUE_5_USER_MULTIPLIER
+              user_value += HEADER_VALUE_5_USER_BASE
+
+              value += user_value
+            end
+
+            value += HEADER_VALUE_5_PHRASE * phrases.count
+            value += HEADER_VALUE_5_PHRASE_PACKET * phrases.first(phrase_index).sum { |phrase| 1 + phrase.length / 4 }
+
+            value
+          end
+        end
+
+        def nickname_bytes
+          four_byte_format_for(nicknames_with_suffixes)
+        end
+
+        def packet_lengths
+          nicknames_with_suffixes.map { |nickname| 1 + nickname.length / 4 }
+        end
+
+        def nickname_format
+          format = [device_nickname] * 2
+          format += [user_nickname] * 9
+          format += [device_nickname] * 4 if device_nickname.any?
+
+          format
+        end
+
+        def nicknames_with_suffixes
+          nickname_format.each_with_index.map do |nickname, nickname_index|
+            nickname + NICKNAME_SUFFIXES[nickname_index]
+          end
+        end
+
+        def formatted_phrases
+          return [] if phrases.empty?
+
+          four_byte_format_for(phrases)
+        end
+      end
+    end
+  end
+end

data/lib/timex_datalink_client/protocol_7/eeprom.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require "timex_datalink_client/helpers/cpacket_paginator"
+require "timex_datalink_client/helpers/crc_packets_wrapper"
+
+class TimexDatalinkClient
+  class Protocol7
+    class Eeprom
+      include Helpers::CpacketPaginator
+      prepend Helpers::CrcPacketsWrapper
+
+      # FIXME use arrays for array models
+      # FIXME: check Array<Integer> yardoc around places
+
+      CPACKET_SECT = [0x90, 0x05]
+      CPACKET_DATA = [0x91, 0x05]
+      CPACKET_END = [0x92, 0x05]
+
+      CPACKET_SECT_WELCOME = [
+        0x44, 0x53, 0x49, 0x20, 0x54, 0x6f, 0x79, 0x73, 0x20, 0x70, 0x72, 0x65, 0x73, 0x65, 0x6e, 0x74, 0x73, 0x2e,
+        0x2e, 0x2e, 0x65, 0x42, 0x72, 0x61, 0x69, 0x6e, 0x21, 0x00, 0x00, 0x00, 0x00, 0x00
+      ]
+
+      CPACKET_DATA_LENGTH = 32
+
+      attr_accessor :activities, :games, :calendar, :phone_numbers, :speech
+
+      # Create an Eeprom instance.
+      #
+      # @param activities [Array<Activity>, nil] Activities to be added to EEPROM data.
+      # @param games [Games, nil] Games to be added to EEPROM data.
+      # @param calendar [Array<Calendar>, nil] Calendar to be added to EEPROM data.
+      # @param phone_numbers [Array<PhoneNumber>, nil] Phone numbers to be added to EEPROM data.
+      # @param speech [Speech, nil] Speech to be added to EEPROM data.
+      # @return [Eeprom] Eeprom instance.
+      def initialize(activities: nil, games: nil, calendar: nil, phone_numbers: nil, speech: nil)
+        @activities = activities
+        @games = games
+        @calendar = calendar
+        @phone_numbers = phone_numbers
+        @speech = speech
+      end
+
+      # Compile packets for EEPROM data.
+      #
+      # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
+      def packets
+        [header] + payloads + [CPACKET_END]
+      end
+
+      private
+
+      def header
+        [
+          CPACKET_SECT,
+          payloads.length,
+          CPACKET_SECT_WELCOME
+        ].flatten
+      end
+
+      def payloads
+        paginate_cpackets(header: CPACKET_DATA, length: CPACKET_DATA_LENGTH, cpackets: all_packets)
+      end
+
+      def all_packets
+        [].tap do |packets|
+          packets.concat(Activity.packets(activities)) if activities
+          packets.concat(games.packet) if games
+          packets.concat(calendar.packet) if calendar
+          packets.concat(PhoneNumber.packets(phone_numbers)) if phone_numbers
+          packets.concat(speech.packet) if speech
+        end
+      end
+    end
+  end
+end

data/lib/timex_datalink_client/protocol_7/end.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require "timex_datalink_client/helpers/crc_packets_wrapper"
+
+class TimexDatalinkClient
+  class Protocol7
+    class End
+      prepend Helpers::CrcPacketsWrapper
+
+      CPACKET_SKIP = [0x21]
+
+      # Compile packets for data end command.
+      #
+      # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
+      def packets
+        [CPACKET_SKIP]
+      end
+    end
+  end
+end

data/lib/timex_datalink_client/protocol_7/phrase_builder.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require "mdb"
+
+class TimexDatalinkClient
+  class Protocol7
+    class PhraseBuilder
+      class WordNotFound < StandardError; end
+
+      attr_accessor :database
+
+      # Create a PhraseBuilder instance.
+      #
+      # @param database [String] Database file to compile phrase data from.
+      # @return [PhraseBuilder] PhraseBuilder instance.
+      def initialize(database:)
+        @database = database
+      end
+
+      # Compile vocabulary IDs for protocol 7 phrases.
+      #
+      # @param words [Array<String>] Array of words.
+      # @raise [WordNotFound] Word not found in protocol 7 database.
+      # @return [Array<Integer>] Array of protocol 7 vocabulary IDs.
+      def vocab_ids_for(*words)
+        words.flat_map do |word|
+          vocab = vocab_for_word(word)
+
+          raise(WordNotFound, "#{word} is not a valid word!") unless vocab
+
+          vocab_links = vocab_links_for_vocab(vocab)
+
+          vocab_links.map do |vocab_link|
+            linked_vocab = vocab_for_vocab_link(vocab_link)
+
+            linked_vocab[:"PC Index"].to_i
+          end
+        end
+      end
+
+      private
+
+      def mdb
+        @mdb ||= Mdb.open(database)
+      end
+
+      def vocab_table
+        @vocab_table ||= mdb["Vocab"]
+      end
+
+      def vocab_links_table
+        @vocab_links_table ||= mdb["Vocab Links"]
+      end
+
+      def vocab_for_word(word)
+        vocab_table.detect { |vocab| vocab[:Label].casecmp?(word) }
+      end
+
+      def vocab_links_for_vocab(vocab)
+        links = vocab_links_table.select { |vocab_link| vocab_link[:"PC Index"] == vocab[:"PC Index"] }
+
+        links.sort_by { |link| link[:Sequence].to_i }
+      end
+
+      def vocab_for_vocab_link(vocab_link)
+        vocab_table.detect { |vocab| vocab[:"PC Index"] == vocab_link[:"eBrain Index"] }
+      end
+    end
+  end
+end

data/lib/timex_datalink_client/protocol_7/start.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require "timex_datalink_client/helpers/crc_packets_wrapper"
+
+class TimexDatalinkClient
+  class Protocol7
+    class Start
+      prepend Helpers::CrcPacketsWrapper
+
+      CPACKET_START = [0x20, 0x00, 0x00, 0x07]
+
+      # Compile packets for data start command.
+      #
+      # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
+      def packets
+        [CPACKET_START]
+      end
+    end
+  end
+end

data/lib/timex_datalink_client/protocol_7/sync.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+class TimexDatalinkClient
+  class Protocol7
+    class Sync
+      PING_BYTE = [0x78]
+      SYNC_1_BYTE = [0x55]
+      SYNC_2_BYTE = [0xaa]
+
+      SYNC_2_LENGTH = 5
+
+      attr_accessor :length
+
+      # Create a Sync instance.
+      #
+      # @param length [Integer] Number of 0x55 sync bytes to use.
+      # @return [Sync] Sync instance.
+      def initialize(length: 300)
+        @length = length
+      end
+
+      # Compile packets for syncronization data.
+      #
+      # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
+      def packets
+        [PING_BYTE + render_sync_1 + render_sync_2]
+      end
+
+      private
+
+      def render_sync_1
+        SYNC_1_BYTE * length
+      end
+
+      def render_sync_2
+        SYNC_2_BYTE * SYNC_2_LENGTH
+      end
+    end
+  end
+end

data/lib/timex_datalink_client/version.rb

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

data/lib/timex_datalink_client.rb

@@ -43,6 +43,18 @@ require "timex_datalink_client/protocol_4/sync"
 require "timex_datalink_client/protocol_4/time"
 require "timex_datalink_client/protocol_4/wrist_app"
 
+require "timex_datalink_client/protocol_7/eeprom"
+require "timex_datalink_client/protocol_7/eeprom/activity"
+require "timex_datalink_client/protocol_7/eeprom/calendar"
+require "timex_datalink_client/protocol_7/eeprom/calendar/event"
+require "timex_datalink_client/protocol_7/eeprom/games"
+require "timex_datalink_client/protocol_7/eeprom/phone_number"
+require "timex_datalink_client/protocol_7/eeprom/speech"
+require "timex_datalink_client/protocol_7/end"
+require "timex_datalink_client/protocol_7/phrase_builder"
+require "timex_datalink_client/protocol_7/start"
+require "timex_datalink_client/protocol_7/sync"
+
 require "timex_datalink_client/protocol_9/alarm"
 require "timex_datalink_client/protocol_9/eeprom"
 require "timex_datalink_client/protocol_9/eeprom/chrono"
@@ -60,19 +72,20 @@ class TimexDatalinkClient
 
   # Create a TimexDatalinkClient instance.
   #
-  # @param serial_device [String] Path to serial device.
+  # @param serial_device [String, nil] Path to serial device.
   # @param models [Array<Protocol1::Sync, Protocol1::Start, Protocol1::Time, Protocol1::TimeName, Protocol1::Alarm,
   #   Protocol1::Eeprom, Protocol1::End, Protocol3::Sync, Protocol3::Start, Protocol3::Time, Protocol3::Alarm,
   #   Protocol3::Eeprom, Protocol3::SoundTheme, Protocol3::SoundOptions, Protocol3::WristApp, Protocol3::End,
   #   Protocol4::Sync, Protocol4::Start, Protocol4::Time, Protocol4::Alarm, Protocol4::Eeprom, Protocol4::SoundTheme,
-  #   Protocol4::SoundOptions, Protocol4::WristApp, Protocol4::End, Protocol9::Sync, Protocol9::Start, Protocol9::Time,
-  #   Protocol9::TimeName, Protocol9::Timer, Protocol9::Alarm, Protocol9::Eeprom, Protocol9::SoundOptions,
-  #   Protocol9::End>] Models to compile data for.
+  #   Protocol4::SoundOptions, Protocol4::WristApp, Protocol4::End, Protocol7::Sync, Protocol7::Start,
+  #   Protocol7::Eeprom, Protocol7::End, Protocol9::Sync, Protocol9::Start, Protocol9::Time, Protocol9::TimeName,
+  #   Protocol9::Timer, Protocol9::Alarm, Protocol9::Eeprom, Protocol9::SoundOptions, Protocol9::End>] Models to compile
+  #   data for.
   # @param byte_sleep [Integer, nil] Time to sleep after sending byte.
   # @param packet_sleep [Integer, nil] Time to sleep after sending packet of bytes.
   # @param verbose [Boolean] Write verbose output to console.
   # @return [TimexDatalinkClient] TimexDatalinkClient instance.
-  def initialize(serial_device:, models: [], byte_sleep: nil, packet_sleep: nil, verbose: false)
+  def initialize(serial_device: nil, models: [], byte_sleep: nil, packet_sleep: nil, verbose: false)
     @serial_device = serial_device
     @models = models
     @byte_sleep = byte_sleep

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: timex_datalink_client
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Maxwell Pray
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-11-24 00:00:00.000000000 Z
+date: 2022-12-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: crc
@@ -38,6 +38,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.6.0
+- !ruby/object:Gem::Dependency
+  name: mdb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.0
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -90,6 +104,7 @@ files:
 - lib/timex_datalink_client/helpers/char_encoders.rb
 - lib/timex_datalink_client/helpers/cpacket_paginator.rb
 - 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/notebook_adapter.rb
 - lib/timex_datalink_client/protocol_1/alarm.rb
@@ -129,6 +144,17 @@ files:
 - lib/timex_datalink_client/protocol_4/sync.rb
 - lib/timex_datalink_client/protocol_4/time.rb
 - lib/timex_datalink_client/protocol_4/wrist_app.rb
+- lib/timex_datalink_client/protocol_7/eeprom.rb
+- lib/timex_datalink_client/protocol_7/eeprom/activity.rb
+- lib/timex_datalink_client/protocol_7/eeprom/calendar.rb
+- lib/timex_datalink_client/protocol_7/eeprom/calendar/event.rb
+- lib/timex_datalink_client/protocol_7/eeprom/games.rb
+- lib/timex_datalink_client/protocol_7/eeprom/phone_number.rb
+- lib/timex_datalink_client/protocol_7/eeprom/speech.rb
+- lib/timex_datalink_client/protocol_7/end.rb
+- lib/timex_datalink_client/protocol_7/phrase_builder.rb
+- lib/timex_datalink_client/protocol_7/start.rb
+- lib/timex_datalink_client/protocol_7/sync.rb
 - lib/timex_datalink_client/protocol_9/alarm.rb
 - lib/timex_datalink_client/protocol_9/eeprom.rb
 - lib/timex_datalink_client/protocol_9/eeprom/chrono.rb
@@ -141,7 +167,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.7.0
+homepage: https://github.com/synthead/timex_datalink_client/tree/v0.8.0
 licenses:
 - MIT
 metadata: {}