tinderfridge 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f7d7c9860d6aa8495eef63beeca7be8d7122205b562c49d560d513bdd780c7f
-  data.tar.gz: efc7ec85867758066b96df1ceccf63ff5b32eee7f0a29b7060560a2236cfe365
+  metadata.gz: d7b851b2ea04d7ab8385d6ca4f11cece38721b4cb09dd7afbd449e84d9e4e2a7
+  data.tar.gz: 19e264699bc41886fe56fa954339d04b118994d39990cb0e834d7a8b5fb1f0e2
 SHA512:
-  metadata.gz: 8de0db5c9d6dc68b3f2fd18b434191e7b23c7bdff389b71918308846637e23fdc80b4880c3ee15b0f83b97e358a6751364c73795a1071bfe2e3ed0a99aeecf74
-  data.tar.gz: 640bee0f79ea37182229abed010480cedbd079de16a3920623c5a6ee4cfca393482bb82d64924485a9b7b651afc194394c40bf76a787fbea8bf21e119b491f3d
+  metadata.gz: 7694f3b62443011a1658034d015a50485f491cee038ce87f820b58e35bf017ce857a21a25a8aae33b92602164100e04a50fc5094679da1164a0592a845852b5b
+  data.tar.gz: fd7b21aac321ae3b25be1857da5e6c91cbc26d7f3bc839fd5934774de35dd9730a5bdfa13ed103f8d4d3bfb4f533d87a325f01f20ec6db30991a24511a0f6e7d

data/lib/tinderfridge/device.rb

@@ -66,6 +66,16 @@ module Tinkerforge
     # Returns the device's IPConnection object.
     attr_reader :ipcon
 
+    # Returns device information.
+    #
+    # Device information is an array:
+    # - 0 : Device Identifier
+    # - 1 : Device Display Name
+    # - 2 : Associated class name and source file
+    def device_info
+      Tinkerforge.device_info device_identifier
+    end
+
     # Returns a programmer-friendly representation of the device.
     def inspect
       "%s (%s@%s:%s)" % [self.class, @uid_string, ipcon.host, ipcon.port]

data/lib/tinderfridge/device_collection.rb

@@ -80,6 +80,42 @@ module Tinkerforge
       smap('ipcon').values.compact.uniq
     end
 
+    # Returns an array of devices in the collection matching the selector.
+    #
+    # Selector argument can be:
+    # - Device Identifier
+    # - Class name or Device Display Name (Regexp)
+    # Selection by regular expression is case-insensitive by default.
+    #
+    # @example Select by class name and Device Display Name
+    #  # All 'analog' devices
+    #  tf = Tinkerforge.connect.discover(1)
+    #  tf.find_all /analog/
+    def find_all(selector)
+      case selector
+        when Integer
+          values.select { |v| v.device_identifier == selector}
+        when Regexp
+          r = Regexp.new selector.source, Regexp::IGNORECASE
+          values.select { |v| v.class.to_s.split('::').last =~ r || v.device_display_name =~ r }
+      end
+    end
+
+    # Returns the first device in the collection matching the selector.
+    #
+    # Selector argument can be:
+    # - Device Identifier
+    # - Class name or Device Display Name (Regexp)
+    # Selection by regular expression is case-insensitive by default.
+    #
+    # @example Select by Device Identifier
+    #  # Remote Switch Bricklet 2.0
+    #  tf = Tinkerforge.connect('myhost.local').discover(1)
+    #  tf.find 289
+    def find(selector)
+      find_all(selector).first
+    end
+
     private
 
     def smap(m)

data/lib/tinderfridge/devices/bricklet_air_quality.rb

@@ -0,0 +1,20 @@
+module Tinkerforge
+
+  class BrickletAirQuality
+
+    # Returns the device's state.
+    def state
+      av = get_all_values
+      super.merge(
+        'iaq_index'          => av[0],
+        'iaq_index_accuracy' => av[1],
+        'temperature'        => av[2],
+        'temperature_offset' => get_temperature_offset,
+        'humidity'           => av[3],
+        'air_pressure'       => av[4],
+      )
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_ambient_light_v3.rb

@@ -0,0 +1,19 @@
+module Tinkerforge
+
+  class BrickletAmbientLightV3
+
+    ILLUMINANCE_RANGES = [ 64000, 32000, 16000, 8000, 1300, 600, 100000 ]
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'configuration'     => conf = get_configuration,
+        'illuminance_range' => ILLUMINANCE_RANGES[ conf[0] ],
+        'integration_time'  => 50 + conf[1] * 50,
+        'illuminance_raw'   => get_illuminance,
+      )
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_joystick_v2.rb

@@ -0,0 +1,15 @@
+module Tinkerforge
+
+  class BrickletJoystickV2
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'position' => get_position,
+        'pressed'  => is_pressed,
+      )
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_motorized_linear_poti.rb

@@ -0,0 +1,42 @@
+module Tinkerforge
+
+  class BrickletMotorizedLinearPoti
+
+    # Returns the position of the potentiometer (an integer in the range 0..100).
+    def position
+      get_position
+    end
+
+    # Moves the potentiometer to the given position.
+    #
+    # If the potentiometer was locked before, it will be locked at the new position.
+    # The drive mode (speed) will be the same as the last time the position was set.
+    def position=(position)
+      set_motor_position( position, *get_motor_position[1,2] )
+    end
+
+    alias move_to position=
+
+    # Locks the position of the potentiometer. If a position is given, moves to that position first.
+    def lock(position=nil)
+      set_motor_position( position || get_position, get_motor_position[1], true )
+    end
+
+    alias hold lock
+
+    # Releases the potentiometer, so its position can be changed by hand. If a position is given, moves to that position first.
+    def release(position=nil)
+      set_motor_position( position || get_position, get_motor_position[1], false )
+    end
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'position'       => get_position,
+        'motor_position' => get_motor_position,
+      )
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_remote_switch_v2.rb

@@ -0,0 +1,15 @@
+module Tinkerforge
+
+  class BrickletRemoteSwitchV2
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'remote_configuration' => get_remote_configuration,
+        'repeats'              => get_repeats,
+      )
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_rgb_led_button.rb

@@ -20,6 +20,15 @@ module Tinkerforge
       true
     end
 
+    # Returns the device's state.
+    def state
+      super.merge(
+        'color_rgb'         => get_color,
+        'color_calibration' => get_color_calibration,
+        'pressed'           => ( get_button_state == 0 ) ? true : false,
+      )
+    end
+
   end
 
 end

data/lib/tinderfridge/devices/bricklet_rgb_led_v2.rb

@@ -20,6 +20,13 @@ module Tinkerforge
       true
     end
 
+    # Returns the device's state.
+    def state
+      super.merge(
+        'color_rgb' => get_rgb_value,
+      )
+    end
+
   end
 
 end

data/lib/tinderfridge/devices/bricklet_rotary_encoder_v2.rb

@@ -0,0 +1,20 @@
+module Tinkerforge
+
+  class BrickletRotaryEncoderV2
+
+    # Returns the current count of the encoder.
+    def count
+      get_count(false)
+    end
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'count'   => count,
+        'pressed' => is_pressed,
+      )
+    end
+
+  end
+
+end

data/lib/tinderfridge/ip_connection.rb

@@ -15,6 +15,11 @@ module Tinkerforge
       "%s (%s:%s)" % [self.class, host, port]
     end
 
+    # Returns true if connected to localhost, false if connected via the network.
+    def localhost?
+      @localhost ||= %w(localhost 127.0.0.1 ::1).include? host
+    end
+
     # Returns a Tinkerforge::DeviceCollection with devices discovered for this IP Connection. Discovery may take a few moments.
     #
     # Accepts an optional argument for the number of seconds to wait, otherwise returns immediately.

data/lib/tinderfridge/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tinderfridge
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - lllist.eu
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-02-20 00:00:00.000000000 Z
+date: 2021-03-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tinkerforge
@@ -43,16 +43,22 @@ files:
 - lib/tinderfridge/device_info.txt
 - lib/tinderfridge/devices/brick_hat.rb
 - lib/tinderfridge/devices/brick_hat_zero.rb
+- lib/tinderfridge/devices/bricklet_air_quality.rb
+- lib/tinderfridge/devices/bricklet_ambient_light_v3.rb
 - lib/tinderfridge/devices/bricklet_dmx.rb
 - lib/tinderfridge/devices/bricklet_gps_v2.rb
 - lib/tinderfridge/devices/bricklet_industrial_dual_relay.rb
+- lib/tinderfridge/devices/bricklet_joystick_v2.rb
 - lib/tinderfridge/devices/bricklet_lcd_128x64.rb
 - lib/tinderfridge/devices/bricklet_led_strip_v2.rb
+- lib/tinderfridge/devices/bricklet_motorized_linear_poti.rb
 - lib/tinderfridge/devices/bricklet_multi_touch_v2.rb
 - lib/tinderfridge/devices/bricklet_nfc.rb
 - lib/tinderfridge/devices/bricklet_outdoor_weather.rb
+- lib/tinderfridge/devices/bricklet_remote_switch_v2.rb
 - lib/tinderfridge/devices/bricklet_rgb_led_button.rb
 - lib/tinderfridge/devices/bricklet_rgb_led_v2.rb
+- lib/tinderfridge/devices/bricklet_rotary_encoder_v2.rb
 - lib/tinderfridge/devices/bricklet_segment_display_4x7_v2.rb
 - lib/tinderfridge/ip_connection.rb
 - lib/tinderfridge/tinkerforge.rb