tinderfridge 0.16.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8269237b83fcfd5a052cdcc9cb9f702bbca2f8e093a918dca330418679cf0496
-  data.tar.gz: ff1e59646d0b04205e1f5151d6710c2f0834e2822dab3e842fd627c5a1878140
+  metadata.gz: d72a23621805a4527cf80a4e35d0ad49fff4cb362a94fe1e916a36130f5fe844
+  data.tar.gz: 8e5422de11c1e78dcedfe354fbd35829bf2f09254c33363040091e83d595cc6c
 SHA512:
-  metadata.gz: fb2db92d210948ce317538ef9826ec34e2171061f91f01ea4aa6964edd5379f8274e624cdfa5078618d7ebff4029f8c776c404324587c3344fb08ce9d58d9449
-  data.tar.gz: 2944c853d896630f99b2d305a8b76782fb67158199bfa108ca3ff7432e2c5381710bfdecca993d398bd60b26a0bf1eaefb81d8ef7afc1ba49c8574d255d37915
+  metadata.gz: 576e9b5d51bc93fee968f6a0788dd5bb71c451b0b5e4860f789e1603b1d2ce98cf48e0e8d7825ede45ae4510b3b15c54920f18eb153d21fc1d3424e6f5f1f06a
+  data.tar.gz: 908a10df2b8722fad35b5caf3e243c4d202658f2fe9a53575a59b905cb6e61962dcf1a46b8b5a6b0995f9decb7ad7606fff5ab1b7442ad747d46010500a72189

data/lib/tinderfridge/device/configuration.rb

@@ -1,15 +1,43 @@
 module Tinkerforge
   class Device
 
-    # Returns configuration data for the device (a mutable Hash).
-    def config
-      @config ||= {}
+    # Returns settings for the device (a mutable Hash).
+    def settings
+      @settings ||= {}
     end
 
-    # Sets configuration data (a Hash) for the device.
-    def config=(configuration)
-      raise(ArgumentError, 'Invalid configuration') unless configuration.class == Hash
-      @config = configuration
+    alias config settings
+
+    # Defines settings for the device (a Hash).
+    def settings=(settings_hash)
+      raise(ArgumentError, 'Invalid settings') unless settings_hash.class == Hash
+      @settings = settings_hash
+    end
+
+    alias config= settings=
+
+    # Configures the device by applying settings.
+    def configure
+      if settings.any?
+        logger_debug "Configuring #{settings.keys.map(&:to_s).join(', ')}"
+        case status_led_api_variety
+          when 2
+            if settings.has_key? 'status_led_config'
+              set_status_led_config settings['status_led_config'].to_i
+            end
+          when 1
+            if settings.has_key? 'status_led_enabled'
+              if !!settings['status_led_enabled']
+                enable_status_led
+              else
+                disable_status_led
+              end
+            end
+        end
+        if respond_to?(:custom_configure, true)
+          custom_configure
+        end
+      end
     end
 
   end

data/lib/tinderfridge/device_collection.rb

@@ -79,21 +79,30 @@ module Tinkerforge
       smap 'state'
     end
 
-    # Returns configuration data of devices in the collection.
-    def config
-      smap 'config'
+    # Returns settings for the devices in the collection.
+    def settings
+      smap 'settings'
     end
 
-    # Sets configuration data of devices in the collection.
-    def config=(configuration)
-      raise ArgumentError, 'invalid configuration' unless (configuration.class == Hash)
+    alias config settings
+
+    # Defines settings for the devices in the collection.
+    def settings=(settings_hash)
+      raise ArgumentError, 'invalid settings' unless (settings_hash.class == Hash)
       each do |k,v|
-        if configuration[k]
-          v.config = configuration[k]
+        if settings_hash[k]
+          v.settings = settings_hash[k]
         end
       end
     end
 
+    alias config= settings=
+
+    # Configures the devices in the collection by applying settings.
+    def configure
+      smap 'configure'
+    end
+
     # Opens the online documentation for the devices in the collection (Mac OS only).
     #
     # When the URL for a device's documentation is not known, does nothing.

data/lib/tinderfridge/devices/bricklet_ambient_light_v3/bricklet_ambient_light_v3.rb

@@ -16,6 +16,12 @@ module Tinkerforge
 
     private
 
+    def custom_configure
+      if settings.has_key? 'configuration'
+        set_configuration *settings['configuration']
+      end
+    end
+
     def _view_21x8
       s = state
       "AmbiLightV3  #{uid_string.rjust 8}\n\n\n" +

data/lib/tinderfridge/devices/bricklet_barometer_v2/bricklet_barometer_v2.rb

@@ -17,6 +17,12 @@ module Tinkerforge
 
     private
 
+    def custom_configure
+      if settings.has_key? 'sensor_configuration'
+        set_sensor_configuration *settings['sensor_configuration']
+      end
+    end
+
     def _view_21x8
       "BaroV2       #{uid_string.rjust 8}\n\n\n" +
       ('%.2f hPa' % [get_air_pressure*0.001]).center(21)

data/lib/tinderfridge/devices/bricklet_gps_v2/bricklet_gps_v2.rb

@@ -1,58 +1,9 @@
-module Tinkerforge
+require 'tinderfridge/shared/gps'
 
+module Tinkerforge
   class BrickletGPSV2
 
-    # Returns the device's state.
-    def state
-      super.merge(
-        'fix_led_config' => get_fix_led_config,
-        'fix'            => fix?,
-      )
-    end
-
-    # Returns true if a fix is available.
-    def fix?
-      get_status[0]
-    end
-
-    # Returns latitude and longitude as reported by the GPS Bricklet.
-    #
-    # Nil when there is no fix (position not determined).
-    def coordinates
-      if fix?
-        c = get_coordinates
-        [
-          c[0] / (c[1] == 'N' ? 1000000.0 : -1000000.0),
-          c[2] / (c[3] == 'E' ? 1000000.0 : -1000000.0)
-        ]
-      else
-        nil
-      end
-    end
-
-    # Returns a Time object representing the time as reported by the GPS Bricklet.
-    def time
-      # FIXME: This will not work after 31-Dec-2099.
-      dt = get_date_time.map &:to_s
-      dt = dt[0].rjust(6,'0').unpack('a2a2a2').reverse + dt[1].rjust(9,'0').concat('000').unpack('a2a2a2a6')
-      dt[0].prepend '20'
-      Time.gm *dt.map(&:to_i)
-    end
-
-    # Returns a URL for viewing the current coordinates on OpenStreetMap.
-    def openstreetmap_marker_url(zoom=12)
-      if c = coordinates
-        "https://www.openstreetmap.org/?mlat=%f&mlon=%f&zoom=%d" % [c, zoom].flatten
-      end
-    end
-
-    private
-
-    def _view_21x8
-      "GPSV2        #{uid_string.rjust 8}\n\n" +
-      ((c = coordinates) ? ("   Lat %10.5f\n   Lon %10.5f" % c) : '       no fix')
-    end
+    include Tinkerforge::Shared::GPS
 
   end
-
 end

data/lib/tinderfridge/devices/bricklet_gps_v3/bricklet_gps_v3.rb

@@ -1,58 +1,9 @@
-module Tinkerforge
+require 'tinderfridge/shared/gps'
 
+module Tinkerforge
   class BrickletGPSV3
 
-    # Returns the device's state.
-    def state
-      super.merge(
-        'fix_led_config' => get_fix_led_config,
-        'fix'            => fix?,
-      )
-    end
-
-    # Returns true if a fix is available.
-    def fix?
-      get_status[0]
-    end
-
-    # Returns latitude and longitude as reported by the GPS Bricklet.
-    #
-    # Nil when there is no fix (position not determined).
-    def coordinates
-      if fix?
-        c = get_coordinates
-        [
-          c[0] / (c[1] == 'N' ? 1000000.0 : -1000000.0),
-          c[2] / (c[3] == 'E' ? 1000000.0 : -1000000.0)
-        ]
-      else
-        nil
-      end
-    end
-
-    # Returns a Time object representing the time as reported by the GPS Bricklet.
-    def time
-      # FIXME: This will not work after 31-Dec-2099.
-      dt = get_date_time.map &:to_s
-      dt = dt[0].rjust(6,'0').unpack('a2a2a2').reverse + dt[1].rjust(9,'0').concat('000').unpack('a2a2a2a6')
-      dt[0].prepend '20'
-      Time.gm *dt.map(&:to_i)
-    end
-
-    # Returns a URL for viewing the current coordinates on OpenStreetMap.
-    def openstreetmap_marker_url(zoom=12)
-      if c = coordinates
-        "https://www.openstreetmap.org/?mlat=%f&mlon=%f&zoom=%d" % [c, zoom].flatten
-      end
-    end
-
-    private
-
-    def _view_21x8
-      "GPSV3        #{uid_string.rjust 8}\n\n" +
-      ((c = coordinates) ? ("   Lat %10.5f\n   Lon %10.5f" % c) : '       no fix')
-    end
+    include Tinkerforge::Shared::GPS
 
   end
-
 end

data/lib/tinderfridge/devices/bricklet_industrial_dual_relay/bricklet_industrial_dual_relay.rb

@@ -15,6 +15,14 @@ module Tinkerforge
       )
     end
 
+    private
+
+    def custom_configure
+      if settings.has_key? 'value'
+        set_value *settings['value']
+      end
+    end
+
   end
 
 end

data/lib/tinderfridge/devices/bricklet_led_strip_v2/bricklet_led_strip_v2.rb

@@ -34,6 +34,28 @@ module Tinkerforge
 
     private
 
+    def custom_configure
+      if settings.has_key? 'chip_type'
+        if settings['chip_type'].to_i != get_chip_type
+          set_chip_type settings['chip_type'].to_i
+        end
+      end
+
+      if settings.has_key? 'channel_mapping'
+        set_channel_mapping settings['channel_mapping'].to_i
+      end
+
+      if settings.has_key? 'frame_duration'
+        set_frame_duration settings['frame_duration'].to_i
+      end
+
+      if settings.has_key? 'clock_frequency'
+        if settings['clock_frequency'].to_i != get_clock_frequency
+          set_clock_frequency settings['clock_frequency'].to_i
+        end
+      end
+    end
+
     def lookup_channel_mapping(selector=nil)
       @@channel_mapping_table ||= self.class.constants.map do |c|
         (c.to_s =~ /^CHANNEL_MAPPING_(\w{3,4})$/ ) ? [self.class.const_get(c), $1] : nil

data/lib/tinderfridge/devices/bricklet_motion_detector_v2/bricklet_motion_detector_v2.rb

@@ -17,6 +17,14 @@ module Tinkerforge
       )
     end
 
+    private
+
+    def custom_configure
+      if settings.has_key? 'sensitivity'
+        set_sensitivity settings['sensitivity'].to_i
+      end
+    end
+
   end
 
 end

data/lib/tinderfridge/devices/bricklet_outdoor_weather/bricklet_outdoor_weather.rb

@@ -18,9 +18,9 @@ module Tinkerforge
     #
     # Sensor identifiers can be mapped to descriptive strings or other values:
     # @example
-    #  my_weather_bricklet.config['sensormap'] = { 202 => 'outdoors' }
+    #  my_weather_bricklet.settings['sensormap'] = { 202 => 'outdoors' }
     def sensors
-      sensormap = (config['sensormap'].class == Hash) ? config['sensormap'] : {}
+      sensormap = (settings['sensormap'].class == Hash) ? settings['sensormap'] : {}
       get_sensor_identifiers.map do |id|
         [ (sensormap[id] || id), get_sensor_data(id).each_with_index.map { |v,i| i == 0 ? v/10.0 : v } ]
       end.to_h

data/lib/tinderfridge/devices/bricklet_particulate_matter/bricklet_particulate_matter.rb

@@ -24,6 +24,12 @@ module Tinkerforge
 
     private
 
+    def custom_configure
+      if settings.has_key? 'enable'
+        set_enable( !! settings['enable'] )
+      end
+    end
+
     def _view_21x8
       "PM           #{uid_string.rjust 8}\n\n" +
       if get_enable

data/lib/tinderfridge/devices/bricklet_rgb_led_button/bricklet_rgb_led_button.rb

@@ -29,6 +29,14 @@ module Tinkerforge
       )
     end
 
+    private
+
+    def custom_configure
+      if settings.has_key? 'color'
+        set_color *settings['color']
+      end
+    end
+
   end
 
 end

data/lib/tinderfridge/devices/bricklet_segment_display_4x7_v2/bricklet_segment_display_4x7_v2.rb

@@ -190,6 +190,14 @@ module Tinkerforge
       end
     end
 
+    private
+
+    def custom_configure
+      if settings.has_key? 'brightness'
+        set_brightness settings['brightness'].to_i
+      end
+    end
+
   end
 
 end

data/lib/tinderfridge/shared/gps.rb

@@ -0,0 +1,68 @@
+module Tinkerforge
+  module Shared
+
+    # Mixin for GPS Bricklet versions 2 & 3.
+    module GPS
+
+      # Returns the device's state.
+      def state
+        super.merge(
+          'fix_led_config' => get_fix_led_config,
+          'fix'            => fix?,
+        )
+      end
+
+      # Returns true if a fix is available.
+      def fix?
+        get_status[0]
+      end
+
+      # Returns latitude and longitude as reported by the GPS Bricklet.
+      #
+      # Nil when there is no fix (position not determined).
+      def coordinates
+        if fix?
+          c = get_coordinates
+          [
+            c[0] / (c[1] == 'N' ? 1000000.0 : -1000000.0),
+            c[2] / (c[3] == 'E' ? 1000000.0 : -1000000.0)
+          ]
+        else
+          nil
+        end
+      end
+
+      # Returns a Time object representing the time as reported by the GPS Bricklet.
+      def time
+        # FIXME: This will not work after 31-Dec-2099.
+        dt = get_date_time.map &:to_s
+        dt = dt[0].rjust(6,'0').unpack('a2a2a2').reverse + dt[1].rjust(9,'0').concat('000').unpack('a2a2a2a6')
+        dt[0].prepend '20'
+        Time.gm *dt.map(&:to_i)
+      end
+
+      # Returns a URL for viewing the current coordinates on OpenStreetMap.
+      def openstreetmap_marker_url(zoom=12)
+        if c = coordinates
+          "https://www.openstreetmap.org/?mlat=%f&mlon=%f&zoom=%d" % [c, zoom].flatten
+        end
+      end
+
+      private
+
+      def custom_configure
+        if settings.has_key? 'fix_led_config'
+          set_fix_led_config settings['fix_led_config'].to_i
+        end
+      end
+
+      def _view_21x8
+        @label21x8 ||= self.class.to_s[-5,5]
+        "#{@label21x8}        #{uid_string.rjust 8}\n\n" +
+        ((c = coordinates) ? ("   Lat %10.5f\n   Lon %10.5f" % c) : '       no fix')
+      end
+
+    end
+
+  end
+end

data/lib/tinderfridge/version.rb

@@ -3,7 +3,7 @@ require 'tinkerforge/version'
 module Tinkerforge
 
   # Tinderfridge version.
-  TINDERFRIDGE_VERSION = '0.16.0'
+  TINDERFRIDGE_VERSION = '0.17.0'
 
   # About Tinkerforge & Tinderfridge.
   def self.about

data/lib/tinderfridge.rb

@@ -2,18 +2,9 @@ if defined? Tinkerforge
   raise 'Tinkerforge was already loaded, so Tinderfridge can not reliably extend it!'
 end
 
-%w(
-
-  version
-
-  ip_connection
-
-  device
-
-  tinkerforge
-
-  device_info
-
-  device_collection
-
-).each { |m| require "tinderfridge/#{m}" }
+require 'tinderfridge/version'
+require 'tinderfridge/ip_connection'
+require 'tinderfridge/device'
+require 'tinderfridge/tinkerforge'
+require 'tinderfridge/device_info'
+require 'tinderfridge/device_collection'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tinderfridge
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.17.0
 platform: ruby
 authors:
 - lllist.eu
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-04-14 00:00:00.000000000 Z
+date: 2026-01-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tinkerforge
@@ -159,15 +159,16 @@ files:
 - lib/tinderfridge/devices/bricklet_xmc1400_breakout/bricklet_xmc1400_breakout.json
 - lib/tinderfridge/ip_connection.rb
 - lib/tinderfridge/shared/display_ibm437_encoding.rb
+- lib/tinderfridge/shared/gps.rb
 - lib/tinderfridge/shared/logger.rb
 - lib/tinderfridge/tinkerforge.rb
 - lib/tinderfridge/version.rb
-homepage: https://github.com/lllisteu/tinderfridge
+homepage: https://codeberg.org/lllisteu/tinderfridge
 licenses:
 - CC0-1.0
 metadata:
-  homepage_uri: https://github.com/lllisteu/tinderfridge
-  changelog_uri: https://github.com/lllisteu/tinderfridge/blob/master/History.md
+  homepage_uri: https://codeberg.org/lllisteu/tinderfridge
+  changelog_uri: https://codeberg.org/lllisteu/tinderfridge/src/branch/master/History.md
   documentation_uri: https://www.rubydoc.info/gems/tinderfridge
 post_install_message:
 rdoc_options: []