timex_datalink_client 0.1.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b30f06f6a23f4312ee7167089c7e0704ef5f799b4c3f7a2be36d57b445074f46
-  data.tar.gz: f2a82191c18efa5a7c51b422ff6b8c0ad30589890eac654a47507ece261ec445
+  metadata.gz: 187352acb16bdc8baa7fec37d4793942f49b6c3d60da9a778b4afd94505c9f1e
+  data.tar.gz: 55214e32e3536da008eb7739d0921af0012c1af6ff70d17491ef37a2fd6008a8
 SHA512:
-  metadata.gz: 78ddeedea22f0d2476b934d84a0751e67c63c2528cdab1a077cf5a4ddde7310e716da02be053d7abfee90e17bd9110ea92d75f84df510b7acc79e81c814598c3
-  data.tar.gz: 9a4974b2abd86722dacc1d4badd802fcc3b7ac84fab8d27d2bc6f39c31269d0c188635cf4e89e55b189aa86c9290a5148e26925e9c9f15337503d539df01c838
+  metadata.gz: 9106e98e689a8646ab779cd1ca38bce9c220c8aa80ae0fe984237e6a92270b0ee10bbdf9b31bc40c4492dc7b17d25c796baf7f3a5720a4649d7deb09a37b540f
+  data.tar.gz: 70e7601d4ba51ecfc3cb6d3f51549e8272ec3baf55ee39174a6fbc5f48272569efcfad25b3eef447a05af767c855f79a4b84d15c286a39d30d2ad7506d273213

data/lib/timex_datalink_client/alarm.rb

@@ -14,6 +14,13 @@ class TimexDatalinkClient
 
     attr_accessor :number, :audible, :time, :message
 
+    # Create an Alarm instance.
+    #
+    # @param number [Integer] Alarm number (from 1 to 5).
+    # @param audible [Boolean] Toggle alarm sounds.
+    # @param time [::Time] Time of alarm.
+    # @param message [String] Alarm message text.
+    # @return [Alarm] Alarm instance.
     def initialize(number:, audible:, time:, message:)
       @number = number
       @audible = audible
@@ -21,6 +28,9 @@ class TimexDatalinkClient
       @message = message
     end
 
+    # Compile packets for an alarm.
+    #
+    # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
     def packets
       [
         [
@@ -31,7 +41,7 @@ class TimexDatalinkClient
           0,
           0,
           message_characters,
-          audible
+          audible_integer
         ].flatten
       ]
     end
@@ -43,5 +53,9 @@ class TimexDatalinkClient
 
       chars_for(message_padded)
     end
+
+    def audible_integer
+      audible ? 1 : 0
+    end
   end
 end

data/lib/timex_datalink_client/eeprom/anniversary.rb

@@ -11,11 +11,19 @@ class TimexDatalinkClient
 
       attr_accessor :time, :anniversary
 
+      # Create an Anniversary instance.
+      #
+      # @param time [::Time] Time of anniversary.
+      # @param anniversary [String] Anniversary text.
+      # @return [Anniversary] Anniversary instance.
       def initialize(time:, anniversary:)
         @time = time
         @anniversary = anniversary
       end
 
+      # Compile a packet for an anniversary.
+      #
+      # @return [Array<Integer>] Array of integers that represent bytes.
       def packet
         [
           time.month,

data/lib/timex_datalink_client/eeprom/appointment.rb

@@ -11,11 +11,19 @@ class TimexDatalinkClient
 
       attr_accessor :time, :message
 
+      # Create an Appointment instance.
+      #
+      # @param time [::Time] Time of appointment.
+      # @param message [String] Appointment text.
+      # @return [Appointment] Appointment instance.
       def initialize(time:, message:)
         @time = time
         @message = message
       end
 
+      # Compile a packet for an appointment.
+      #
+      # @return [Array<Integer>] Array of integers that represent bytes.
       def packet
         [
           time.month,

data/lib/timex_datalink_client/eeprom/list.rb

@@ -11,11 +11,19 @@ class TimexDatalinkClient
 
       attr_accessor :list_entry, :priority
 
+      # Create a List instance.
+      #
+      # @param list_entry [String] List entry text.
+      # @param priority [Integer] List priority.
+      # @return [List] List instance.
       def initialize(list_entry:, priority:)
         @list_entry = list_entry
         @priority = priority
       end
 
+      # Compile a packet for a list.
+      #
+      # @return [Array<Integer>] Array of integers that represent bytes.
       def packet
         [
           priority,

data/lib/timex_datalink_client/eeprom/phone_number.rb

@@ -13,12 +13,21 @@ class TimexDatalinkClient
 
       attr_accessor :name, :number, :type
 
+      # Create a PhoneNumber instance.
+      #
+      # @param name [String] Name associated to phone number.
+      # @param number [String] Phone number text.
+      # @param type [String] Phone number type.
+      # @return [PhoneNumber] PhoneNumber instance.
       def initialize(name:, number:, type: " ")
         @name = name
         @number = number
         @type = type
       end
 
+      # Compile a packet for a phone number.
+      #
+      # @return [Array<Integer>] Array of integers that represent bytes.
       def packet
         [
           number_with_type_characters,

data/lib/timex_datalink_client/eeprom.rb

@@ -18,6 +18,15 @@ class TimexDatalinkClient
 
     attr_accessor :appointments, :anniversaries, :phone_numbers, :lists, :appointment_notification
 
+    # Create an Eeprom instance.
+    #
+    # @param appointments [Array<Appointment>] Appointments to be added to EEPROM data.
+    # @param anniversaries [Array<Anniversary>] Anniversaries to be added to EEPROM data.
+    # @param phone_numbers [Array<PhoneNumber>] Phone numbers to be added to EEPROM data.
+    # @param lists [Array<List>] Lists to be added to EEPROM data.
+    # @param appointment_notification [Integer] Appointment notification (intervals of 15 minutes, 255 for no
+    #   notification)
+    # @return [Eeprom] Eeprom instance.
     def initialize(appointments: [], anniversaries: [], phone_numbers: [], lists: [], appointment_notification: APPOINTMENT_NO_NOTIFICATION)
       @appointments = appointments
       @anniversaries = anniversaries
@@ -26,6 +35,9 @@ class TimexDatalinkClient
       @appointment_notification = appointment_notification
     end
 
+    # Compile packets for EEPROM data.
+    #
+    # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
     def packets
       [CPACKET_CLEAR, header] + payloads + [CPACKET_END]
     end

data/lib/timex_datalink_client/end.rb

@@ -8,6 +8,9 @@ class TimexDatalinkClient
 
     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

data/lib/timex_datalink_client/notebook_adapter.rb

@@ -4,24 +4,42 @@ require "rubyserial"
 
 class TimexDatalinkClient
   class NotebookAdapter
-    BYTE_SLEEP = 0.025
-    PACKET_SLEEP = 0.25
-
-    attr_accessor :serial_device
-
-    def initialize(serial_device)
+    BYTE_SLEEP_DEFAULT = 0.025
+    PACKET_SLEEP_DEFAULT = 0.25
+
+    attr_accessor :serial_device, :byte_sleep, :packet_sleep, :verbose
+
+    # Create a NotebookAdapter instance.
+    #
+    # @param serial_device [String] Path to serial device.
+    # @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 [NotebookAdapter] NotebookAdapter instance.
+    def initialize(serial_device:, byte_sleep: nil, packet_sleep: nil, verbose: false)
       @serial_device = serial_device
+      @byte_sleep = byte_sleep || BYTE_SLEEP_DEFAULT
+      @packet_sleep = packet_sleep || PACKET_SLEEP_DEFAULT
+      @verbose = verbose
     end
 
+    # Write packets of bytes to serial device.
+    #
+    # @param packets [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
+    # @return [void]
     def write(packets)
       packets.each do |packet|
         packet.each do |byte|
+          printf("%.2X ", byte) if verbose
+
           serial.write(byte.chr)
 
-          sleep(BYTE_SLEEP)
+          sleep(byte_sleep)
         end
 
-        sleep(PACKET_SLEEP)
+        sleep(packet_sleep)
+
+        puts if verbose
       end
     end
 

data/lib/timex_datalink_client/sound_options.rb

@@ -8,17 +8,33 @@ class TimexDatalinkClient
 
     CPACKET_BEEPS = [0x71]
 
-    attr_accessor :hourly_chimes, :button_beep
+    attr_accessor :hourly_chime, :button_beep
 
-    def initialize(hourly_chimes:, button_beep:)
-      @hourly_chimes = hourly_chimes
+    # Create a SoundOptions instance.
+    #
+    # @param hourly_chime [Boolean] Toggle hourly chime sounds.
+    # @param button_beep [Boolean] Toggle button beep sounds.
+    # @return [SoundOptions] SoundOptions instance.
+    def initialize(hourly_chime:, button_beep:)
+      @hourly_chime = hourly_chime
       @button_beep = button_beep
     end
 
+    # Compile packets for sound options.
+    #
+    # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
     def packets
       [
-        CPACKET_BEEPS + [hourly_chimes, button_beep]
+        CPACKET_BEEPS + [hourly_chime_integer, button_beep_integer]
       ]
     end
+
+    def hourly_chime_integer
+      hourly_chime ? 1 : 0
+    end
+
+    def button_beep_integer
+      button_beep ? 1 : 0
+    end
   end
 end

data/lib/timex_datalink_client/sound_theme.rb

@@ -14,32 +14,49 @@ class TimexDatalinkClient
 
     SOUND_DATA_HEADER = "\x25\x04\x19\x69"
 
-    attr_accessor :sound_data
-
-    def initialize(sound_data:)
-      @sound_data = sound_data
+    attr_accessor :spc_file
+
+    # Create a SoundTheme instance.
+    #
+    # @param sound_theme_data [String, nil] Sound theme data.
+    # @param spc_file [String, nil] Path to SPC file.
+    # @return [SoundTheme] SoundTheme instance.
+    def initialize(sound_theme_data: nil, spc_file: nil)
+      @sound_theme_data = sound_theme_data
+      @spc_file = spc_file
     end
 
+    # Compile packets for a sound theme.
+    #
+    # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
     def packets
       [load_sect] + payloads + [CPACKET_END]
     end
 
     private
 
-    def sound_bytes
-      sound_data.delete_prefix(SOUND_DATA_HEADER).bytes
-    end
-
     def load_sect
       CPACKET_SECT + [payloads.length, offset]
     end
 
     def payloads
-      paginate_cpackets(header: CPACKET_DATA, cpackets: sound_bytes)
+      paginate_cpackets(header: CPACKET_DATA, cpackets: sound_theme_data.bytes)
+    end
+
+    def sound_theme_data
+      @sound_theme_data || spc_file_data_without_header
+    end
+
+    def spc_file_data
+      File.open(spc_file, "rb").read
+    end
+
+    def spc_file_data_without_header
+      spc_file_data.delete_prefix(SOUND_DATA_HEADER)
     end
 
     def offset
-      0x100 - sound_bytes.length
+      0x100 - sound_theme_data.bytesize
     end
   end
 end

data/lib/timex_datalink_client/start.rb

@@ -8,6 +8,9 @@ class TimexDatalinkClient
 
     CPACKET_START = [0x20, 0x00, 0x00, 0x03]
 
+    # Compile packets for data start command.
+    #
+    # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
     def packets
       [CPACKET_START]
     end

data/lib/timex_datalink_client/sync.rb

@@ -9,10 +9,17 @@ class TimexDatalinkClient
 
     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
       [render_sync_1 + render_sync_2]
     end

data/lib/timex_datalink_client/time.rb

@@ -12,6 +12,13 @@ class TimexDatalinkClient
 
     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 time [::Time] Time to set (including time zone).
+    # @return [Time] Time instance.
     def initialize(zone:, is_24h:, date_format:, time:)
       @zone = zone
       @is_24h = is_24h
@@ -19,6 +26,9 @@ class TimexDatalinkClient
       @time = time
     end
 
+    # Compile packets for a time.
+    #
+    # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
     def packets
       [
         [

data/lib/timex_datalink_client/version.rb

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

data/lib/timex_datalink_client/wrist_app.rb

@@ -16,12 +16,21 @@ class TimexDatalinkClient
     WRIST_APP_DELIMITER = /\xac.*\r\n/n
     WRIST_APP_CODE_INDEX = 8
 
-    attr_accessor :wrist_app_data
+    attr_accessor :zap_file
 
-    def initialize(wrist_app_data:)
+    # Create a WristApp instance.
+    #
+    # @param wrist_app_data [String, nil] WristApp data.
+    # @param zap_file [String, nil] Path to ZAP file.
+    # @return [WristApp] WristApp instance.
+    def initialize(wrist_app_data: nil, zap_file: nil)
       @wrist_app_data = wrist_app_data
+      @zap_file = zap_file
     end
 
+    # Compile packets for an alarm.
+    #
+    # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
     def packets
       [CPACKET_CLEAR, cpacket_sect] + payloads + [CPACKET_END]
     end
@@ -32,16 +41,24 @@ class TimexDatalinkClient
       CPACKET_SECT + [payloads.length, 1]
     end
 
-    def wrist_app_ascii
-      wrist_app_data.split(WRIST_APP_DELIMITER)[WRIST_APP_CODE_INDEX]
+    def payloads
+      paginate_cpackets(header: CPACKET_DATA, cpackets: wrist_app_data.bytes)
     end
 
-    def wrist_app_bytes
-      [wrist_app_ascii].pack("H*").bytes
+    def wrist_app_data
+      @wrist_app_data || zap_file_data_binary
     end
 
-    def payloads
-      paginate_cpackets(header: CPACKET_DATA, cpackets: wrist_app_bytes)
+    def zap_file_data
+      File.open(zap_file, "rb").read
+    end
+
+    def zap_file_data_ascii
+      zap_file_data.split(WRIST_APP_DELIMITER)[WRIST_APP_CODE_INDEX]
+    end
+
+    def zap_file_data_binary
+      [zap_file_data_ascii].pack("H*")
     end
   end
 end

data/lib/timex_datalink_client.rb

@@ -17,17 +17,35 @@ require "timex_datalink_client/version"
 require "timex_datalink_client/wrist_app"
 
 class TimexDatalinkClient
-  attr_accessor :serial_device, :models
+  attr_accessor :serial_device, :models, :byte_sleep, :packet_sleep, :verbose
 
-  def initialize(serial_device:, models: [])
+  # Create a TimexDatalinkClient instance.
+  #
+  # @param serial_device [String] Path to serial device.
+  # @param models [Array<Alarm, Eeprom, End, SoundOptions, SoundTheme, Start, Sync, Time, WristApp>] 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)
     @serial_device = serial_device
     @models = models
+    @byte_sleep = byte_sleep
+    @packet_sleep = packet_sleep
+    @verbose = verbose
   end
 
+  # Write data for all models to serial device.
+  #
+  # @return [void]
   def write
     notebook_adapter.write(packets)
   end
 
+  # Compile packets for all models.
+  #
+  # @return [Array<Array<Integer>>] Two-dimensional array of integers that represent bytes.
   def packets
     models.map(&:packets).flatten(1)
   end
@@ -35,6 +53,11 @@ class TimexDatalinkClient
   private
 
   def notebook_adapter
-    @notebook_adapter ||= NotebookAdapter.new(serial_device)
+    @notebook_adapter ||= NotebookAdapter.new(
+      serial_device: serial_device,
+      byte_sleep: byte_sleep,
+      packet_sleep: packet_sleep,
+      verbose: verbose
+    )
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: timex_datalink_client
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Maxwell Pray
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-09-05 00:00:00.000000000 Z
+date: 2022-09-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: crc
@@ -66,6 +66,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 2.0.5
+- !ruby/object:Gem::Dependency
+  name: yard-junk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.9
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.9
 description: Write data to Timex Datalink watches with an optical sensor
 email: synthead@gmail.com
 executables: []