tinderfridge 0.1.0 → 0.6.0

data/lib/tinderfridge/devices/bricklet_dmx/bricklet_dmx.json

@@ -0,0 +1,3 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/DMX.html"
+}

data/lib/tinderfridge/devices/bricklet_dmx/bricklet_dmx.rb

@@ -0,0 +1,18 @@
+module Tinkerforge
+
+  class BrickletDMX
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'dmx_mode'                 => get_dmx_mode,
+        'frame_duration'           => get_frame_duration,
+        'frame_error_count'        => get_frame_error_count,
+        'communication_led_config' => get_communication_led_config,
+        'error_led_config'         => get_error_led_config,
+      )
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_gps_v2/bricklet_gps_v2.json

@@ -0,0 +1,3 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/GPS_V2.html"
+}

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

@@ -0,0 +1,31 @@
+module Tinkerforge
+
+  class BrickletGPSV2
+
+    # Returns latitude and longitude as reported by the GPS Bricklet.
+    #
+    # Nil when there is no fix (position not determined).
+    def coordinates
+      if get_status[0]
+        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
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_imu_v3/bricklet_imu_v3.json

@@ -0,0 +1,3 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/IMU_V3.html"
+}

data/lib/tinderfridge/devices/bricklet_industrial_dual_relay/bricklet_industrial_dual_relay.json

@@ -0,0 +1,3 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Industrial_Dual_Relay.html"
+}

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

@@ -0,0 +1,20 @@
+module Tinkerforge
+
+  class BrickletIndustrialDualRelay
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'relays' => get_value.each_with_index.map do |v,i|
+          {
+            'value'    => v,
+            'output'   => v ? 'A' : 'B',
+            'monoflop' => ['time', 'time_remaining'].zip( get_monoflop(i)[1,2] ).to_h,
+          }
+        end
+      )
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_isolator/bricklet_isolator.json

@@ -0,0 +1,3 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Isolator.html"
+}

data/lib/tinderfridge/devices/bricklet_isolator/bricklet_isolator.rb

@@ -0,0 +1,17 @@
+module Tinkerforge
+
+  class BrickletIsolator
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'statistics'                  => get_statistics,
+        'spitfp_baudrate_config'      => get_spitfp_baudrate_config,
+        'spitfp_baudrate'             => get_spitfp_baudrate,
+        'isolator_spitfp_error_count' => get_isolator_spitfp_error_count,
+      )
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_joystick_v2/bricklet_joystick_v2.json

@@ -0,0 +1,3 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Joystick_V2.html"
+}

data/lib/tinderfridge/devices/bricklet_joystick_v2/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_lcd_128x64/bricklet_lcd_128x64.json

@@ -0,0 +1,3 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/LCD_128x64.html"
+}

data/lib/tinderfridge/devices/bricklet_lcd_128x64/bricklet_lcd_128x64.rb

@@ -0,0 +1,31 @@
+module Tinkerforge
+
+  class BrickletLCD128x64
+
+    # Returns the current setting for the backlight (0..100).
+    def backlight
+      get_display_configuration[1]
+    end
+
+    # Sets the brightness of the backlight (0..100).
+    def backlight=(brightness)
+      state = get_display_configuration
+      state[1] = brightness.to_i
+      set_display_configuration *state
+    end
+
+    # Switches off the backlight.
+    def blackout
+      self.backlight = 0
+      true
+    end
+
+    # Clears the display, including the GUI.
+    def clear
+      clear_display
+      remove_all_gui
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_led_strip_v2/bricklet_led_strip_v2.json

@@ -0,0 +1,3 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/LED_Strip_V2.html"
+}

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

@@ -0,0 +1,55 @@
+module Tinkerforge
+
+  class BrickletLEDStripV2
+
+    # Switches off all connected LEDs. Use in case of misconfiguration or other trouble.
+    #
+    # Sends the connected LEDs 6144 zeros (2048 RGB values or 1536 RGBW values).
+    def blackout
+      a = Array.new(1024,0)
+      6.times { |n| set_led_values( n*1024, a ) }
+      true
+    end
+
+    # Returns the channels as defined by the channel mapping.
+    def channels
+      if ch = lookup_channel_mapping(get_channel_mapping)
+        ch[1].chars
+      else
+        ch
+      end
+    end
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'chip_type'       => get_chip_type,
+        'channel_mapping' => get_channel_mapping,
+        'channels'        => channels,
+        'frame_duration'  => get_frame_duration,
+        'clock_frequency' => get_clock_frequency,
+        'supply_voltage'  => get_supply_voltage,
+      )
+    end
+
+    private
+
+    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
+      end.compact.sort_by { |l| l[0] }
+      case selector
+        when NilClass
+          @@channel_mapping_table
+        when Integer
+          @@channel_mapping_table.select { |n,s| n == selector }.first
+        when String
+          @@channel_mapping_table.select { |n,s| s == selector }.first
+        else
+          raise ArgumentError, 'Unknown selector'
+      end
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_motion_detector_v2/bricklet_motion_detector_v2.json

@@ -0,0 +1,3 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Motion_Detector_V2.html"
+}

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

@@ -0,0 +1,22 @@
+module Tinkerforge
+
+  class BrickletMotionDetectorV2
+
+    # Switches off all three blue backlight LEDs.
+    def blackout
+      set_indicator(0, 0, 0)
+      true
+    end
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'motion_detected' => get_motion_detected == 1,
+        'sensitivity'     => get_sensitivity,
+        'indicator'       => get_indicator,
+      )
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_motorized_linear_poti/bricklet_motorized_linear_poti.json

@@ -0,0 +1,3 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Motorized_Linear_Poti.html"
+}

data/lib/tinderfridge/devices/bricklet_motorized_linear_poti/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_multi_touch_v2/bricklet_multi_touch_v2.json

@@ -0,0 +1,3 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Multi_Touch_V2.html"
+}

data/lib/tinderfridge/devices/bricklet_multi_touch_v2/bricklet_multi_touch_v2.rb

@@ -0,0 +1,16 @@
+module Tinkerforge
+
+  class BrickletMultiTouchV2
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'electrode_config'      => get_electrode_config.map { |c| c ? '1' : '0' }.join,
+        'electrode_sensitivity' => get_electrode_sensitivity,
+        'touch_led_config'      => get_touch_led_config,
+      )
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_nfc/bricklet_nfc.json

@@ -0,0 +1,3 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/NFC.html"
+}

data/lib/tinderfridge/devices/bricklet_nfc/bricklet_nfc.rb

@@ -0,0 +1,16 @@
+module Tinkerforge
+
+  class BrickletNFC
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'mode'                 => get_mode,
+        'detection_led_config' => get_detection_led_config,
+        'maximum_timeout'      => get_maximum_timeout,
+      )
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_outdoor_weather/bricklet_outdoor_weather.json

@@ -0,0 +1,3 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Outdoor_Weather.html"
+}

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

@@ -0,0 +1,19 @@
+module Tinkerforge
+
+  class BrickletOutdoorWeather
+
+    # Returns the last measured data for all sensors.
+    #
+    # The result is a Hash, with sensor identifiers as the keys. Values per sensor are:
+    # - 0: Temperature (°C)
+    # - 1: Relative humidity (%RH)
+    # - 2: Last change (seconds)
+    def sensors
+      get_sensor_identifiers.map do |id|
+        [ id, get_sensor_data(id).each_with_index.map { |v,i| i == 0 ? v/10.0 : v } ]
+      end.to_h
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_performance_dc/bricklet_performance_dc.json

@@ -0,0 +1,3 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Performance_DC.html"
+}

data/lib/tinderfridge/devices/bricklet_remote_switch_v2/bricklet_remote_switch_v2.json

@@ -0,0 +1,3 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Remote_Switch_V2.html"
+}

data/lib/tinderfridge/devices/bricklet_remote_switch_v2/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/bricklet_rgb_led_button.json

@@ -0,0 +1,3 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/RGB_LED_Button.html"
+}

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

@@ -0,0 +1,34 @@
+module Tinkerforge
+
+  class BrickletRGBLEDButton
+
+    # Returns the button's current color as three values for red, green, and blue (integers in the range 0..255).
+    def rgb
+      get_color
+    end
+
+    # Sets the button's color using three values for red, green, and blue (integers in the range 0..255).
+    #
+    # Values can be supplied as an array or as three separate values.
+    def rgb=(*rgb)
+      set_color *rgb.flatten
+    end
+
+    # Switches off the button's LED.
+    def blackout
+      self.rgb = 0, 0, 0
+      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,
+      )
+    end
+
+  end
+
+end