tinderfridge 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 92034339759c82954498219a57e8070f6859b907e135a8d9a8df936abd58a01f
+  data.tar.gz: a222affea211a17b0e6b9fd0087ddb53830f5e2a0de7a63258ebc566d5e6bd7d
+SHA512:
+  metadata.gz: a450530444bcaeeed475e6476d12d7cfeedda25f02cb2619b4ccdd62951f9f16f9a1f03f874c6807fef6efddbe7fe3b06825c5ca120ca6828ef1e332844cceb3
+  data.tar.gz: a7c84f3fd084e655a81f79d58a3bbf1173f31ca0b0fafd5a66041c3aefd689f5a04d18045599a645073ccae693b13a07c6af0f51d668eb0ab8bd0954dbf6f1e9

data/lib/tinderfridge.rb

@@ -0,0 +1,19 @@
+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}" }

data/lib/tinderfridge/device.rb

@@ -0,0 +1,71 @@
+require 'tinkerforge/ip_connection'
+
+module Tinkerforge
+  class Device
+
+    #----------------------------------------------------------------------#
+    #                            Class Methods                             #
+    #----------------------------------------------------------------------#
+
+    class << self
+
+      # Returns all currently defined classes that inherited from this class.
+      #
+      # With help from:
+      # - https://stackoverflow.com/questions/2393697
+      def descendants
+        ObjectSpace.each_object(Class).select { |klass| klass < self }
+      end
+
+      # Returns a map of currently defined device classes.
+      def class_map
+        descendants.map do |klass|
+          if klass.const_defined? 'DEVICE_IDENTIFIER'
+            [
+              klass.const_get('DEVICE_IDENTIFIER'),
+              klass.const_get('DEVICE_DISPLAY_NAME'),
+              klass,
+              File.basename(klass.instance_method('initialize').source_location.first, '.rb')
+            ]
+          else
+            nil
+          end
+        end.compact.sort_by { |i| i[0] }
+      end
+
+    end
+
+    #----------------------------------------------------------------------#
+    #                           Instance Methods                           #
+    #----------------------------------------------------------------------#
+
+    # Returns the device's IPConnection object.
+    attr_reader :ipcon
+
+    # Returns a programmer-friendly representation of the device.
+    def inspect
+      "%s (%s@%s:%s)" % [self.class, @uid_string, ipcon.host, ipcon.port]
+    end
+
+    # Identifies a Tinkerforge device by blinking its status led.
+    #
+    # Supports recent devices. When invoked on older devices, does nothing.
+    def identify(seconds=10)
+      if (respond_to? 'get_status_led_config') and (respond_to? 'set_status_led_config')
+        seconds = seconds.to_i
+        state = get_status_led_config
+
+        (seconds*2).times do |n|
+          set_status_led_config n.remainder(2)
+          sleep 0.5
+        end
+
+        set_status_led_config state
+        seconds
+      else
+        false
+      end
+    end
+
+  end
+end

data/lib/tinderfridge/device_collection.rb

@@ -0,0 +1,46 @@
+module Tinkerforge
+
+  class DeviceCollection < Hash
+
+    # Returns the temperatures as measured inside the microcontrollers of devices in the collection.
+    #
+    # Nil for devices that do not support the get_chip_temperature method.
+    def get_chip_temperature
+      map { |k,d| [ k, d.respond_to?('get_chip_temperature' ) ? d.get_chip_temperature  : nil ] }.to_h
+    end
+
+    # Returns the error counts for devices in the collection.
+    #
+    # Nil for devices that do not support the get_spitfp_error_count method.
+    def get_spitfp_error_count
+      map { |k,d| [ k, d.respond_to?('get_spitfp_error_count' ) ? d.get_spitfp_error_count  : nil ] }.to_h
+    end
+
+    # Returns the status LED configuration for devices in the collection.
+    #
+    # Nil for devices that do not support the get_status_led_config method.
+    def get_status_led_config
+      map { |k,d| [ k, d.respond_to?('get_status_led_config') ? d.get_status_led_config : nil ] }.to_h
+    end
+
+    # Sets the status LED configuration for devices in the collection.
+    #
+    # Ignores devices that do not support the set_status_led_config method.
+    #
+    # Argument can be an Integer (e.g. 0=off, 1=on), or a Hash (as returned by #get_status_led_config).
+    def set_status_led_config(state)
+      case state
+        when Integer
+          map { |k,d| d.respond_to?('set_status_led_config') ? d : nil}.compact.each { |d| d.set_status_led_config(state) }.size
+        when Hash
+          state.keys.select { |k| self[k].respond_to?('set_status_led_config') }.each do |k|
+            self[k].set_status_led_config(state[k])
+          end.size
+        else
+          raise ArgumentError, 'Unknown state'
+      end
+    end
+
+  end
+
+end

data/lib/tinderfridge/device_info.rb

@@ -0,0 +1,72 @@
+module Tinkerforge
+
+  class << self
+
+    # Returns information about device types.
+    #
+    # Device information is returned as array:
+    # - 0 : Device Identifier
+    # - 1 : Device Display Name
+    # - 2 : Associated class name and source file
+    #
+    # Optional selector argument can be:
+    # - Device Identifier
+    # - Device class
+    # - Device instance
+    # - Class name or Device Display Name (Regexp)
+    # Selection by regular expression is case-insensitive by default, and returns an array of matches.
+    #
+    # @example Select by Device Identifier
+    #  Tinkerforge.device_info 2103
+    #
+    # @example Select by class
+    #  Tinkerforge.device_info Tinkerforge::BrickletLEDStripV2
+    #
+    # @example Select by class name and Device Display Name
+    #  # All 'analog' devices
+    #  Tinkerforge.device_info /analog/
+    #
+    #  # Relays and switches
+    #  Tinkerforge.device_info /relay|switch/
+    #
+    # @example No Selector
+    #  # All devices
+    #  Tinkerforge.device_info
+    def device_info(selector=nil)
+      @@device_info ||= load_device_info
+      case selector
+        when NilClass
+          @@device_info
+        when Integer
+          @@device_info.select { |i| i[0] == selector }.first
+        when Class
+          klass = selector.to_s
+          @@device_info.select { |i| i[2][0] == klass }.first
+        when Regexp
+          r = Regexp.new selector.source, Regexp::IGNORECASE
+          @@device_info.select { |i| ( i[1] =~ r ) || ( i[2][0] =~ r ) }
+        else
+          if selector.class.ancestors.include? Tinkerforge::Device
+            klass = selector.class.to_s
+            @@device_info.select { |i| i[2][0] == klass }.first
+          else
+            raise ArgumentError, 'Unsupported selector'
+          end
+      end
+    end
+
+    private
+
+    # Load device info from file.
+    def load_device_info
+      File.readlines( File.join( File.dirname(__FILE__), 'device_info.txt' ) ).map do |l|
+        a = l.chomp.split("\t")
+        a[0]   = a[0].to_i
+        a[2,2] = a[2,2], nil
+        a.compact
+      end
+    end
+
+  end
+
+end

data/lib/tinderfridge/device_info.txt

@@ -0,0 +1,139 @@
+11	DC Brick	Tinkerforge::BrickDC	brick_dc
+13	Master Brick	Tinkerforge::BrickMaster	brick_master
+14	Servo Brick	Tinkerforge::BrickServo	brick_servo
+15	Stepper Brick	Tinkerforge::BrickStepper	brick_stepper
+16	IMU Brick	Tinkerforge::BrickIMU	brick_imu
+17	RED Brick	Tinkerforge::BrickRED	brick_red
+18	IMU Brick 2.0	Tinkerforge::BrickIMUV2	brick_imu_v2
+19	Silent Stepper Brick	Tinkerforge::BrickSilentStepper	brick_silent_stepper
+21	Ambient Light Bricklet	Tinkerforge::BrickletAmbientLight	bricklet_ambient_light
+23	Current12 Bricklet	Tinkerforge::BrickletCurrent12	bricklet_current12
+24	Current25 Bricklet	Tinkerforge::BrickletCurrent25	bricklet_current25
+25	Distance IR Bricklet	Tinkerforge::BrickletDistanceIR	bricklet_distance_ir
+26	Dual Relay Bricklet	Tinkerforge::BrickletDualRelay	bricklet_dual_relay
+27	Humidity Bricklet	Tinkerforge::BrickletHumidity	bricklet_humidity
+28	IO-16 Bricklet	Tinkerforge::BrickletIO16	bricklet_io16
+29	IO-4 Bricklet	Tinkerforge::BrickletIO4	bricklet_io4
+111	HAT Brick	Tinkerforge::BrickHAT	brick_hat
+112	HAT Zero Brick	Tinkerforge::BrickHATZero	brick_hat_zero
+210	Joystick Bricklet	Tinkerforge::BrickletJoystick	bricklet_joystick
+211	LCD 16x2 Bricklet	Tinkerforge::BrickletLCD16x2	bricklet_lcd_16x2
+212	LCD 20x4 Bricklet	Tinkerforge::BrickletLCD20x4	bricklet_lcd_20x4
+213	Linear Poti Bricklet	Tinkerforge::BrickletLinearPoti	bricklet_linear_poti
+214	Piezo Buzzer Bricklet	Tinkerforge::BrickletPiezoBuzzer	bricklet_piezo_buzzer
+215	Rotary Poti Bricklet	Tinkerforge::BrickletRotaryPoti	bricklet_rotary_poti
+216	Temperature Bricklet	Tinkerforge::BrickletTemperature	bricklet_temperature
+217	Temperature IR Bricklet	Tinkerforge::BrickletTemperatureIR	bricklet_temperature_ir
+218	Voltage Bricklet	Tinkerforge::BrickletVoltage	bricklet_voltage
+219	Analog In Bricklet	Tinkerforge::BrickletAnalogIn	bricklet_analog_in
+220	Analog Out Bricklet	Tinkerforge::BrickletAnalogOut	bricklet_analog_out
+221	Barometer Bricklet	Tinkerforge::BrickletBarometer	bricklet_barometer
+222	GPS Bricklet	Tinkerforge::BrickletGPS	bricklet_gps
+223	Industrial Digital In 4 Bricklet	Tinkerforge::BrickletIndustrialDigitalIn4	bricklet_industrial_digital_in_4
+224	Industrial Digital Out 4 Bricklet	Tinkerforge::BrickletIndustrialDigitalOut4	bricklet_industrial_digital_out_4
+225	Industrial Quad Relay Bricklet	Tinkerforge::BrickletIndustrialQuadRelay	bricklet_industrial_quad_relay
+226	PTC Bricklet	Tinkerforge::BrickletPTC	bricklet_ptc
+227	Voltage/Current Bricklet	Tinkerforge::BrickletVoltageCurrent	bricklet_voltage_current
+228	Industrial Dual 0-20mA Bricklet	Tinkerforge::BrickletIndustrialDual020mA	bricklet_industrial_dual_0_20ma
+229	Distance US Bricklet	Tinkerforge::BrickletDistanceUS	bricklet_distance_us
+230	Dual Button Bricklet	Tinkerforge::BrickletDualButton	bricklet_dual_button
+231	LED Strip Bricklet	Tinkerforge::BrickletLEDStrip	bricklet_led_strip
+232	Moisture Bricklet	Tinkerforge::BrickletMoisture	bricklet_moisture
+233	Motion Detector Bricklet	Tinkerforge::BrickletMotionDetector	bricklet_motion_detector
+234	Multi Touch Bricklet	Tinkerforge::BrickletMultiTouch	bricklet_multi_touch
+235	Remote Switch Bricklet	Tinkerforge::BrickletRemoteSwitch	bricklet_remote_switch
+236	Rotary Encoder Bricklet	Tinkerforge::BrickletRotaryEncoder	bricklet_rotary_encoder
+237	Segment Display 4x7 Bricklet	Tinkerforge::BrickletSegmentDisplay4x7	bricklet_segment_display_4x7
+238	Sound Intensity Bricklet	Tinkerforge::BrickletSoundIntensity	bricklet_sound_intensity
+239	Tilt Bricklet	Tinkerforge::BrickletTilt	bricklet_tilt
+240	Hall Effect Bricklet	Tinkerforge::BrickletHallEffect	bricklet_hall_effect
+241	Line Bricklet	Tinkerforge::BrickletLine	bricklet_line
+242	Piezo Speaker Bricklet	Tinkerforge::BrickletPiezoSpeaker	bricklet_piezo_speaker
+243	Color Bricklet	Tinkerforge::BrickletColor	bricklet_color
+244	Solid State Relay Bricklet	Tinkerforge::BrickletSolidStateRelay	bricklet_solid_state_relay
+246	NFC/RFID Bricklet	Tinkerforge::BrickletNFCRFID	bricklet_nfc_rfid
+249	Industrial Dual Analog In Bricklet	Tinkerforge::BrickletIndustrialDualAnalogIn	bricklet_industrial_dual_analog_in
+250	Accelerometer Bricklet	Tinkerforge::BrickletAccelerometer	bricklet_accelerometer
+251	Analog In Bricklet 2.0	Tinkerforge::BrickletAnalogInV2	bricklet_analog_in_v2
+253	Load Cell Bricklet	Tinkerforge::BrickletLoadCell	bricklet_load_cell
+254	RS232 Bricklet	Tinkerforge::BrickletRS232	bricklet_rs232
+255	Laser Range Finder Bricklet	Tinkerforge::BrickletLaserRangeFinder	bricklet_laser_range_finder
+256	Analog Out Bricklet 2.0	Tinkerforge::BrickletAnalogOutV2	bricklet_analog_out_v2
+258	Industrial Analog Out Bricklet	Tinkerforge::BrickletIndustrialAnalogOut	bricklet_industrial_analog_out
+259	Ambient Light Bricklet 2.0	Tinkerforge::BrickletAmbientLightV2	bricklet_ambient_light_v2
+260	Dust Detector Bricklet	Tinkerforge::BrickletDustDetector	bricklet_dust_detector
+262	CO2 Bricklet	Tinkerforge::BrickletCO2	bricklet_co2
+263	OLED 128x64 Bricklet	Tinkerforge::BrickletOLED128x64	bricklet_oled_128x64
+264	OLED 64x48 Bricklet	Tinkerforge::BrickletOLED64x48	bricklet_oled_64x48
+265	UV Light Bricklet	Tinkerforge::BrickletUVLight	bricklet_uv_light
+266	Thermocouple Bricklet	Tinkerforge::BrickletThermocouple	bricklet_thermocouple
+267	Motorized Linear Poti Bricklet	Tinkerforge::BrickletMotorizedLinearPoti	bricklet_motorized_linear_poti
+268	Real-Time Clock Bricklet	Tinkerforge::BrickletRealTimeClock	bricklet_real_time_clock
+270	CAN Bricklet	Tinkerforge::BrickletCAN	bricklet_can
+271	RGB LED Bricklet	Tinkerforge::BrickletRGBLED	bricklet_rgb_led
+272	RGB LED Matrix Bricklet	Tinkerforge::BrickletRGBLEDMatrix	bricklet_rgb_led_matrix
+276	GPS Bricklet 2.0	Tinkerforge::BrickletGPSV2	bricklet_gps_v2
+277	RS485 Bricklet	Tinkerforge::BrickletRS485	bricklet_rs485
+278	Thermal Imaging Bricklet	Tinkerforge::BrickletThermalImaging	bricklet_thermal_imaging
+279	XMC1400 Breakout Bricklet	Tinkerforge::BrickletXMC1400Breakout	bricklet_xmc1400_breakout
+282	RGB LED Button Bricklet	Tinkerforge::BrickletRGBLEDButton	bricklet_rgb_led_button
+283	Humidity Bricklet 2.0	Tinkerforge::BrickletHumidityV2	bricklet_humidity_v2
+284	Industrial Dual Relay Bricklet	Tinkerforge::BrickletIndustrialDualRelay	bricklet_industrial_dual_relay
+285	DMX Bricklet	Tinkerforge::BrickletDMX	bricklet_dmx
+286	NFC Bricklet	Tinkerforge::BrickletNFC	bricklet_nfc
+288	Outdoor Weather Bricklet	Tinkerforge::BrickletOutdoorWeather	bricklet_outdoor_weather
+289	Remote Switch Bricklet 2.0	Tinkerforge::BrickletRemoteSwitchV2	bricklet_remote_switch_v2
+290	Sound Pressure Level Bricklet	Tinkerforge::BrickletSoundPressureLevel	bricklet_sound_pressure_level
+291	Temperature IR Bricklet 2.0	Tinkerforge::BrickletTemperatureIRV2	bricklet_temperature_ir_v2
+292	Motion Detector Bricklet 2.0	Tinkerforge::BrickletMotionDetectorV2	bricklet_motion_detector_v2
+293	Industrial Counter Bricklet	Tinkerforge::BrickletIndustrialCounter	bricklet_industrial_counter
+294	Rotary Encoder Bricklet 2.0	Tinkerforge::BrickletRotaryEncoderV2	bricklet_rotary_encoder_v2
+295	Analog In Bricklet 3.0	Tinkerforge::BrickletAnalogInV3	bricklet_analog_in_v3
+296	Solid State Relay Bricklet 2.0	Tinkerforge::BrickletSolidStateRelayV2	bricklet_solid_state_relay_v2
+297	Air Quality Bricklet	Tinkerforge::BrickletAirQuality	bricklet_air_quality
+298	LCD 128x64 Bricklet	Tinkerforge::BrickletLCD128x64	bricklet_lcd_128x64
+299	Distance US Bricklet 2.0	Tinkerforge::BrickletDistanceUSV2	bricklet_distance_us_v2
+2100	Industrial Digital In 4 Bricklet 2.0	Tinkerforge::BrickletIndustrialDigitalIn4V2	bricklet_industrial_digital_in_4_v2
+2101	PTC Bricklet 2.0	Tinkerforge::BrickletPTCV2	bricklet_ptc_v2
+2102	Industrial Quad Relay Bricklet 2.0	Tinkerforge::BrickletIndustrialQuadRelayV2	bricklet_industrial_quad_relay_v2
+2103	LED Strip Bricklet 2.0	Tinkerforge::BrickletLEDStripV2	bricklet_led_strip_v2
+2104	Load Cell Bricklet 2.0	Tinkerforge::BrickletLoadCellV2	bricklet_load_cell_v2
+2105	Voltage/Current Bricklet 2.0	Tinkerforge::BrickletVoltageCurrentV2	bricklet_voltage_current_v2
+2106	Real-Time Clock Bricklet 2.0	Tinkerforge::BrickletRealTimeClockV2	bricklet_real_time_clock_v2
+2107	CAN Bricklet 2.0	Tinkerforge::BrickletCANV2	bricklet_can_v2
+2108	RS232 Bricklet 2.0	Tinkerforge::BrickletRS232V2	bricklet_rs232_v2
+2109	Thermocouple Bricklet 2.0	Tinkerforge::BrickletThermocoupleV2	bricklet_thermocouple_v2
+2110	Particulate Matter Bricklet	Tinkerforge::BrickletParticulateMatter	bricklet_particulate_matter
+2111	IO-4 Bricklet 2.0	Tinkerforge::BrickletIO4V2	bricklet_io4_v2
+2112	OLED 128x64 Bricklet 2.0	Tinkerforge::BrickletOLED128x64V2	bricklet_oled_128x64_v2
+2113	Temperature Bricklet 2.0	Tinkerforge::BrickletTemperatureV2	bricklet_temperature_v2
+2114	IO-16 Bricklet 2.0	Tinkerforge::BrickletIO16V2	bricklet_io16_v2
+2115	Analog Out Bricklet 3.0	Tinkerforge::BrickletAnalogOutV3	bricklet_analog_out_v3
+2116	Industrial Analog Out Bricklet 2.0	Tinkerforge::BrickletIndustrialAnalogOutV2	bricklet_industrial_analog_out_v2
+2117	Barometer Bricklet 2.0	Tinkerforge::BrickletBarometerV2	bricklet_barometer_v2
+2118	UV Light Bricklet 2.0	Tinkerforge::BrickletUVLightV2	bricklet_uv_light_v2
+2119	Dual Button Bricklet 2.0	Tinkerforge::BrickletDualButtonV2	bricklet_dual_button_v2
+2120	Industrial Dual 0-20mA Bricklet 2.0	Tinkerforge::BrickletIndustrialDual020mAV2	bricklet_industrial_dual_0_20ma_v2
+2121	Industrial Dual Analog In Bricklet 2.0	Tinkerforge::BrickletIndustrialDualAnalogInV2	bricklet_industrial_dual_analog_in_v2
+2122	Isolator Bricklet	Tinkerforge::BrickletIsolator	bricklet_isolator
+2123	One Wire Bricklet	Tinkerforge::BrickletOneWire	bricklet_one_wire
+2124	Industrial Digital Out 4 Bricklet 2.0	Tinkerforge::BrickletIndustrialDigitalOut4V2	bricklet_industrial_digital_out_4_v2
+2125	Distance IR Bricklet 2.0	Tinkerforge::BrickletDistanceIRV2	bricklet_distance_ir_v2
+2127	RGB LED Bricklet 2.0	Tinkerforge::BrickletRGBLEDV2	bricklet_rgb_led_v2
+2128	Color Bricklet 2.0	Tinkerforge::BrickletColorV2	bricklet_color_v2
+2129	Multi Touch Bricklet 2.0	Tinkerforge::BrickletMultiTouchV2	bricklet_multi_touch_v2
+2130	Accelerometer Bricklet 2.0	Tinkerforge::BrickletAccelerometerV2	bricklet_accelerometer_v2
+2131	Ambient Light Bricklet 3.0	Tinkerforge::BrickletAmbientLightV3	bricklet_ambient_light_v3
+2132	Hall Effect Bricklet 2.0	Tinkerforge::BrickletHallEffectV2	bricklet_hall_effect_v2
+2137	Segment Display 4x7 Bricklet 2.0	Tinkerforge::BrickletSegmentDisplay4x7V2	bricklet_segment_display_4x7_v2
+2138	Joystick Bricklet 2.0	Tinkerforge::BrickletJoystickV2	bricklet_joystick_v2
+2139	Linear Poti Bricklet 2.0	Tinkerforge::BrickletLinearPotiV2	bricklet_linear_poti_v2
+2140	Rotary Poti Bricklet 2.0	Tinkerforge::BrickletRotaryPotiV2	bricklet_rotary_poti_v2
+2144	Laser Range Finder Bricklet 2.0	Tinkerforge::BrickletLaserRangeFinderV2	bricklet_laser_range_finder_v2
+2145	Piezo Speaker Bricklet 2.0	Tinkerforge::BrickletPiezoSpeakerV2	bricklet_piezo_speaker_v2
+2146	E-Paper 296x128 Bricklet	Tinkerforge::BrickletEPaper296x128	bricklet_e_paper_296x128
+2147	CO2 Bricklet 2.0	Tinkerforge::BrickletCO2V2	bricklet_co2_v2
+2152	Energy Monitor Bricklet	Tinkerforge::BrickletEnergyMonitor	bricklet_energy_monitor
+2153	Compass Bricklet	Tinkerforge::BrickletCompass	bricklet_compass
+2161	IMU Bricklet 3.0	Tinkerforge::BrickletIMUV3	bricklet_imu_v3
+2162	Industrial Dual AC Relay Bricklet	Tinkerforge::BrickletIndustrialDualACRelay	bricklet_industrial_dual_ac_relay

data/lib/tinderfridge/ip_connection.rb

@@ -0,0 +1,73 @@
+require 'tinkerforge/ip_connection'
+
+module Tinkerforge
+
+  class IPConnection
+
+    # Returns the host for the IP Connection object.
+    attr_reader :host
+
+    # Returns the port for the IP Connection object.
+    attr_reader :port
+
+    # Returns a programmer-friendly representation of the object.
+    def inspect
+      "%s (%s:%s)" % [self.class, host, port]
+    end
+
+    # Returns a Tinkerforge::DeviceCollection with devices discovered for this IP Connection.
+    #
+    # Discovery may take a few seconds, but will return a Tinkerforge::DeviceCollection immediately.
+    #
+    # It is therefore a good idea to store the result in a variable.
+    # This variable will be filled with devices as they are found. See examples.
+    #
+    # @example Using Tinkerforge.connect
+    #  my_devices = Tinkerforge.connect.discover
+    #
+    # @example Classic
+    #  ipcon = Tinkerforge::IPConnection.new
+    #  ipcon.connect 'localhost', 4223
+    #  my_devices = ipcon.discover
+    def discover
+      list = Tinkerforge::DeviceCollection.new
+      self.register_callback(CALLBACK_ENUMERATE) do |*args|
+        case args[6]
+
+          when 0, 1  # Available or Connected
+            info = Tinkerforge.device_info args[5]
+            if info
+              require File.join('tinkerforge', info[2][1] )
+              list[args.first] = Tinkerforge.const_get( info[2][0] ).new args.first, self
+            else     # Device not in device_info
+              list[args.first] = nil
+            end
+
+          when 2     # Disconnected
+            list[args.first] = nil
+
+          else
+            raise "Unknown Enumeration Type: #{args[6]}"
+
+        end
+      end
+      self.enumerate
+      list
+    end
+
+  end
+
+  # Creates an IP Connection object connected to the given host and port.
+  #
+  # If no host and port are specified, uses the TINKERFORGE_HOST and TINKERFORGE_PORT environment variables, when defined.
+  # Otherwise defaults to 'localhost' and port 4223.
+  def self.connect(host=nil, port=nil)
+    ipcon = IPConnection.new
+    ipcon.connect(
+      ( host || ENV['TINKERFORGE_HOST'] || 'localhost' ),
+      ( port || ENV['TINKERFORGE_PORT'] ||  4223       )
+    )
+    ipcon
+  end
+
+end

data/lib/tinderfridge/tinkerforge.rb

@@ -0,0 +1,17 @@
+require 'tinkerforge/ip_connection'
+
+module Tinkerforge
+
+  # Returns the directory where Tinkerforge bindings appear to be installed.
+  def self.lib_dir
+    File.dirname File.dirname Device.instance_method('uid').source_location.first
+  end
+
+  # Attempts to load all files that are part of Tinkerforge. Returns a list of files loaded.
+  def self.require_everything
+    Dir.glob(File.join lib_dir, 'tinkerforge', '*.rb').map do |file|
+      require(file) ? file : nil
+    end.compact
+  end
+
+end

data/lib/tinderfridge/version.rb

@@ -0,0 +1,13 @@
+require 'tinkerforge/version'
+
+module Tinkerforge
+
+  # Tinderfridge version.
+  TINDERFRIDGE_VERSION = '0.1.0'
+
+  # About Tinkerforge & Tinderfridge.
+  def self.about
+    "Tinkerforge #{VERSION} (with Tinderfridge #{TINDERFRIDGE_VERSION})"
+  end
+
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: tinderfridge
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- lllist.eu
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-12-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: tinkerforge
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.1.27
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.1.27
+description: 
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/tinderfridge.rb
+- lib/tinderfridge/device.rb
+- lib/tinderfridge/device_collection.rb
+- lib/tinderfridge/device_info.rb
+- lib/tinderfridge/device_info.txt
+- lib/tinderfridge/ip_connection.rb
+- lib/tinderfridge/tinkerforge.rb
+- lib/tinderfridge/version.rb
+homepage: https://github.com/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
+  documentation_uri: https://www.rubydoc.info/gems/tinderfridge
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key: 
+specification_version: 4
+summary: Extending Tinkerforge in fun and useful ways.
+test_files: []