tinderfridge 0.9.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 26a171ddfc01502cca8300d445d498c960b8cfb1304e1b60fddc5d33ad0a68ba
-  data.tar.gz: ebf5e97bd0fe072375c6a548615baff3e42ef77432b96373035571a41897ba8a
+  metadata.gz: 11aec071db2201e67dee0935c5a37ba2f801d2337cf0dc938ea465a9c0435bd3
+  data.tar.gz: ad2faa18ff3320c9320ded930b47f54c38e9471eba0bb52e2aa23cb48da3d108
 SHA512:
-  metadata.gz: e5a6e8d3f54c3955afbbce8d48c1ded48ea46535dd078cc6118d207bf988634c7e04fbcab178a5b440ea5ff55798287df53f94465a06e0971a5d0282876f532f
-  data.tar.gz: 31d5cbea577e5b98279279193301e2a95062db29d7150149c3035ecb639f4301ce739854927f018fa922a9630bea7217c76dfb0329ccc5e88359b73f7c4fc7fe
+  metadata.gz: 440adf1b54a1787963688f4392fe686e07b898eae1361d3f245526a244f6e677b5a29a7cd84f2f3aa0221ef4300372dcbae18b55200cef2b96d6fa7206a0c7d0
+  data.tar.gz: 8204e15a1106392bbde997f2e65704b2cfd176c4e18066685f26e8a50a6cd62e3002b10e8fd6224f16540d946c94c66f66e96f6941b90c7255beec4e4c545a60

data/lib/tinderfridge/device.rb

@@ -15,6 +15,7 @@ module Tinkerforge
       # With help from:
       # - https://stackoverflow.com/questions/2393697
       def descendants
+        # NOTE: Ruby 3.1 has Class#subclasses
         ObjectSpace.each_object(Class).select { |klass| klass < self }
       end
 
@@ -79,7 +80,7 @@ module Tinkerforge
 
     # Returns a programmer-friendly representation of the device.
     def inspect
-      "%s (%s@%s:%s)" % [self.class, @uid_string, ipcon.host, ipcon.port]
+      "%s (%s@%s:%s)" % [self.class, uid_string, ipcon.host, ipcon.port]
     end
 
     # Returns the device's properties.

data/lib/tinderfridge/device_info.txt

@@ -16,6 +16,8 @@
 29	IO-4 Bricklet	Tinkerforge::BrickletIO4	bricklet_io4
 111	HAT Brick	Tinkerforge::BrickHAT	brick_hat
 112	HAT Zero Brick	Tinkerforge::BrickHATZero	brick_hat_zero
+113	ESP32 Brick	Tinkerforge::BrickESP32	brick_esp32
+115	ESP32 Ethernet Brick	Tinkerforge::BrickESP32Ethernet	brick_esp32_ethernet
 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
@@ -142,3 +144,4 @@
 2164	Industrial PTC Bricklet	Tinkerforge::BrickletIndustrialPTC	bricklet_industrial_ptc
 2165	DC Bricklet 2.0	Tinkerforge::BrickletDCV2	bricklet_dc_v2
 2166	Silent Stepper Bricklet 2.0	Tinkerforge::BrickletSilentStepperV2	bricklet_silent_stepper_v2
+2171	GPS Bricklet 3.0	Tinkerforge::BrickletGPSV3	bricklet_gps_v3

data/lib/tinderfridge/devices/brick_esp32/brick_esp32.json

@@ -0,0 +1,11 @@
+{
+  "dimensions": [
+    66,
+    40,
+    9
+  ],
+  "weight": 14,
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricks/ESP32_Brick.html",
+  "versions_identifier": "bricks:esp32",
+  "released": "2022-04-29"
+}

data/lib/tinderfridge/devices/brick_esp32/brick_esp32.rb

@@ -0,0 +1,13 @@
+module Tinkerforge
+
+  class BrickESP32
+
+    private
+
+    def _view_21x8
+      "ESP32        #{uid_string.rjust 8}"
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/brick_esp32_ethernet/brick_esp32_ethernet.json

@@ -0,0 +1,11 @@
+{
+  "dimensions": [
+    88,
+    45,
+    12
+  ],
+  "weight": 20,
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricks/ESP32_Ethernet_Brick.html",
+  "versions_identifier": "bricks:esp32_ethernet",
+  "released": "2022-04-29"
+}

data/lib/tinderfridge/devices/brick_esp32_ethernet/brick_esp32_ethernet.rb

@@ -0,0 +1,13 @@
+module Tinkerforge
+
+  class BrickESP32Ethernet
+
+    private
+
+    def _view_21x8
+      "ESP32 Eth    #{uid_string.rjust 8}"
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/brick_hat/brick_hat.rb

@@ -13,6 +13,18 @@ module Tinkerforge
       )
     end
 
+    private
+
+    def _view_21x8
+      volts = get_voltages
+      <<~ET
+      HAT          #{uid_string.rjust 8}
+
+           USB #{'%5.2f V' % [volts[0]*0.001]}
+           DC  #{'%5.2f V' % [volts[1]*0.001]}
+      ET
+    end
+
   end
 
 end

data/lib/tinderfridge/devices/brick_hat_zero/brick_hat_zero.rb

@@ -9,6 +9,16 @@ module Tinkerforge
       )
     end
 
+    private
+
+    def _view_21x8
+      <<~ET
+      HAT Zero     #{uid_string.rjust 8}
+
+           USB #{'%5.2f V' % [get_usb_voltage*0.001]}
+      ET
+    end
+
   end
 
 end

data/lib/tinderfridge/devices/bricklet_air_quality/bricklet_air_quality.rb

@@ -15,6 +15,21 @@ module Tinkerforge
       )
     end
 
+    # Returns the derived air pressure at sea level.
+    #
+    # Air pressure is derived from:
+    # - air pressure as measured by the Bricklet itself
+    # - temperature as measured by the Bricklet itself
+    # - altitude of the Bricklet's location (meter)
+    #
+    # With help from:
+    # - https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Barometer_V2.html
+    # - https://keisan.casio.com/exec/system/1224575267
+    def qff(altitude)
+    # QFE / [1 - Tg * H / (273.15 + Tfe + Tg * H)] ^ (0.034163 / Tg)
+      (get_air_pressure / (1 - 0.0065 * altitude / (273.15 + (get_temperature * 0.01) + 0.0065 * altitude)) ** (0.034163 / 0.0065)).round
+    end
+
   end
 
 end

data/lib/tinderfridge/devices/bricklet_analog_in_v3/bricklet_analog_in_v3.json

@@ -6,5 +6,6 @@
   ],
   "weight": 8,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Analog_In_V3.html",
-  "versions_identifier": "bricklets:analog_in_v3"
+  "versions_identifier": "bricklets:analog_in_v3",
+  "released": "2018-02-26"
 }

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

@@ -0,0 +1,30 @@
+module Tinkerforge
+
+  class BrickletBarometerV2
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'air_pressure'                 => get_air_pressure,
+        'calibration'                  => get_calibration,
+        'altitude'                     => get_altitude,
+        'reference_air_pressure'       => get_reference_air_pressure,
+        'temperature'                  => get_temperature,
+        'moving_average_configuration' => get_moving_average_configuration,
+        'sensor_configuration'         => get_sensor_configuration,
+      )
+    end
+
+    private
+
+    def _view_21x8
+      <<~ET
+      Baro         #{uid_string.rjust 8}
+
+          #{'%7.2f hPa' % [get_air_pressure*0.001]}
+      ET
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_co2_v2/bricklet_co2_v2.rb

@@ -14,6 +14,16 @@ module Tinkerforge
       )
     end
 
+    private
+
+    def _view_21x8
+      <<~ET
+      CO2          #{uid_string.rjust 8}
+
+            #{'%5d PPM' % get_co2_concentration}
+      ET
+    end
+
   end
 
 end

data/lib/tinderfridge/devices/bricklet_distance_us_v2/bricklet_distance_us_v2.json

@@ -6,5 +6,6 @@
   ],
   "weight": 9,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Distance_US_V2.html",
-  "versions_identifier": "bricklets:distance_us_v2"
+  "versions_identifier": "bricklets:distance_us_v2",
+  "released": "2019-08-22"
 }

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

@@ -6,5 +6,6 @@
   ],
   "weight": 30,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/DMX.html",
-  "versions_identifier": "bricklets:dmx"
+  "versions_identifier": "bricklets:dmx",
+  "released": "2017-11-17"
 }

data/lib/tinderfridge/devices/bricklet_e_paper_296x128/bricklet_e_paper_296x128.json

@@ -6,5 +6,6 @@
   ],
   "weight": 20,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/EPaper_296x128.html",
-  "versions_identifier": "bricklets:e_paper_296x128"
+  "versions_identifier": "bricklets:e_paper_296x128",
+  "released": "2019-05-20"
 }

data/lib/tinderfridge/devices/bricklet_energy_monitor/bricklet_energy_monitor.json

@@ -6,5 +6,6 @@
   ],
   "weight": 7,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Energy_Monitor.html",
-  "versions_identifier": "bricklets:energy_monitor"
+  "versions_identifier": "bricklets:energy_monitor",
+  "released": "2019-08-22"
 }

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

@@ -4,7 +4,7 @@
     35,
     12
   ],
-  "weight": 20,
+  "weight": 16,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/GPS_V2.html",
   "versions_identifier": "bricklets:gps_v2",
   "released": "2017-05-11"

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

@@ -39,6 +39,20 @@ module Tinkerforge
       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
+
   end
 
 end

data/lib/tinderfridge/devices/bricklet_gps_v3/bricklet_gps_v3.json

@@ -0,0 +1,11 @@
+{
+  "dimensions": [
+    40,
+    40,
+    12
+  ],
+  "weight": 12,
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/GPS_V3.html",
+  "versions_identifier": "bricklets:gps_v3",
+  "released": "2022-05-09"
+}

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

@@ -0,0 +1,58 @@
+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
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_hall_effect_v2/bricklet_hall_effect_v2.json

@@ -6,5 +6,6 @@
   ],
   "weight": 2,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Hall_Effect_V2.html",
-  "versions_identifier": "bricklets:hall_effect_v2"
+  "versions_identifier": "bricklets:hall_effect_v2",
+  "released": "2019-05-20"
 }

data/lib/tinderfridge/devices/bricklet_hall_effect_v2/bricklet_hall_effect_v2.rb

@@ -0,0 +1,16 @@
+module Tinkerforge
+
+  class BrickletHallEffectV2
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'magnetic_flux_density' => get_magnetic_flux_density,
+        'counter'               => get_counter(false),
+        'counter_config'        => get_counter_config,
+      )
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_humidity_v2/bricklet_humidity_v2.json

@@ -6,5 +6,6 @@
   ],
   "weight": 3,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Humidity_V2.html",
-  "versions_identifier": "bricklets:humidity_v2"
+  "versions_identifier": "bricklets:humidity_v2",
+  "released": "2017-11-17"
 }

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

@@ -6,5 +6,6 @@
   ],
   "weight": 3,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/IMU_V3.html",
-  "versions_identifier": "bricklets:imu_v3"
+  "versions_identifier": "bricklets:imu_v3",
+  "released": "2020-10-27"
 }

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

@@ -6,5 +6,6 @@
   ],
   "weight": 29.4,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Industrial_Dual_Relay.html",
-  "versions_identifier": "bricklets:industrial_dual_relay"
+  "versions_identifier": "bricklets:industrial_dual_relay",
+  "released": "2018-06-07"
 }

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

@@ -6,5 +6,6 @@
   ],
   "weight": 7.1,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Isolator.html",
-  "versions_identifier": "bricklets:isolator"
+  "versions_identifier": "bricklets:isolator",
+  "released": "2018-09-10"
 }

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

@@ -6,5 +6,6 @@
   ],
   "weight": 15,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Joystick_V2.html",
-  "versions_identifier": "bricklets:joystick_v2"
+  "versions_identifier": "bricklets:joystick_v2",
+  "released": "2019-05-20"
 }

data/lib/tinderfridge/devices/bricklet_laser_range_finder_v2/bricklet_laser_range_finder_v2.json

@@ -6,5 +6,6 @@
   ],
   "weight": 30,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Laser_Range_Finder_V2.html",
-  "versions_identifier": "bricklets:laser_range_finder_v2"
+  "versions_identifier": "bricklets:laser_range_finder_v2",
+  "released": "2019-05-20"
 }

data/lib/tinderfridge/devices/bricklet_lcd_128x64/bricklet_lcd_128x64.json

@@ -6,5 +6,6 @@
   ],
   "weight": 55,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/LCD_128x64.html",
-  "versions_identifier": "bricklets:lcd_128x64"
+  "versions_identifier": "bricklets:lcd_128x64",
+  "released": "2018-09-27"
 }

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

@@ -1,7 +1,21 @@
+require 'tinderfridge/shared/display_ibm437_encoding'
+
 module Tinkerforge
 
   class BrickletLCD128x64
 
+    include Tinkerforge::Shared::IBM437_encoding
+
+    # Encodes a string in the IBM437 character set used by some displays.
+    #
+    # Characters that can not be encoded are replaced with '?'.
+    #
+    # See:
+    # - https://en.wikipedia.org/wiki/Code_page_437
+    def encode(string)
+      ibm437_encode(string)
+    end
+
     # Returns the current setting for the backlight (0..100).
     def backlight
       get_display_configuration[1]
@@ -20,12 +34,81 @@ module Tinkerforge
       true
     end
 
+    # Returns the current contrast setting (0..63).
+    def contrast
+      get_display_configuration[0]
+    end
+
+    # Sets the contrast (0..63).
+    def contrast=(value)
+      state = get_display_configuration
+      state[0] = value.to_i
+      set_display_configuration *state
+    end
+
     # Clears the display, including the GUI.
     def clear
       clear_display
       remove_all_gui
     end
 
+    # Returns true if automatic draw is set to false.
+    def buffered?
+      ! get_display_configuration[3]
+    end
+
+    # Draws the currently buffered frame.
+    def redraw(force_complete_redraw=false)
+      draw_buffered_frame force_complete_redraw
+    end
+
+    alias flush redraw
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'touch_led_config'      => get_touch_led_config,
+        'display_configuration' => get_display_configuration,
+      )
+    end
+
+    # Clears the display and prints upto 8 lines of text.
+    #
+    # Text may contain newline characters to separate lines.
+    # Lines longer than 21 characters will be wrapped.
+    #
+    # Text is automatically encoded in the IBM437 character set.
+    # @example
+    #  my_lcd.put_screen "Hello, World!\n\nRuby #{RUBY_VERSION}"
+    def put_screen(text='', test: false)
+      lines = text.split("\n")
+      lines = lines.map { |s| s.empty? ? '' : s.scan(/.{1,21}/) }.flatten
+      lines = lines[0,8].map { |l| encode l }
+
+      return lines if test
+
+      clear
+      lines.each_with_index do |s,l|
+        write_line l, 0, s
+      end
+      nil
+    end
+
+    # Shows an object.
+    def show(object)
+      if object.respond_to?( :_view_21x8, true)
+        put_screen ( object.send(:_view_21x8) rescue "21x8 view error\n\n#{object.class.to_s}" )
+      elsif
+        put_screen object.inspect[0,168]
+      end
+    end
+
+    private
+
+    def _view_21x8
+      "LCD          #{uid_string.rjust 8}"
+    end
+
   end
 
 end

data/lib/tinderfridge/devices/bricklet_linear_poti_v2/bricklet_linear_poti_v2.json

@@ -6,5 +6,6 @@
   ],
   "weight": 14,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Linear_Poti_V2.html",
-  "versions_identifier": "bricklets:linear_poti_v2"
+  "versions_identifier": "bricklets:linear_poti_v2",
+  "released": "2019-05-20"
 }

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

@@ -6,5 +6,6 @@
   ],
   "weight": 67,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Motorized_Linear_Poti.html",
-  "versions_identifier": "bricklets:motorized_linear_poti"
+  "versions_identifier": "bricklets:motorized_linear_poti",
+  "released": "2017-11-17"
 }

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

@@ -6,5 +6,6 @@
   ],
   "weight": 18,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/NFC.html",
-  "versions_identifier": "bricklets:nfc"
+  "versions_identifier": "bricklets:nfc",
+  "released": "2018-02-26"
 }

data/lib/tinderfridge/devices/bricklet_oled_128x64_v2/bricklet_oled_128x64_v2.rb

@@ -0,0 +1,94 @@
+require 'tinderfridge/shared/display_ibm437_encoding'
+
+module Tinkerforge
+
+  class BrickletOLED128x64V2
+
+    include Tinkerforge::Shared::IBM437_encoding
+
+    # Encodes a string in the IBM437 character set used by some displays.
+    #
+    # Characters that can not be encoded are replaced with '?'.
+    #
+    # See:
+    # - https://en.wikipedia.org/wiki/Code_page_437
+    def encode(string)
+      ibm437_encode(string)
+    end
+
+    # Turns the display all black.
+    def blackout
+      c = get_display_configuration
+
+      if c[1] # inverted
+        set_display_configuration c[0], false, c[2]
+      end
+
+      clear_display
+
+      if ! c[2] # buffered
+        draw_buffered_frame(true)
+      end
+
+      true
+    end
+
+    # Returns true if automatic draw is set to false.
+    def buffered?
+      ! get_display_configuration[2]
+    end
+
+    # Draws the currently buffered frame.
+    def redraw(force_complete_redraw=false)
+      draw_buffered_frame force_complete_redraw
+    end
+
+    alias flush redraw
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'display_configuration' => get_display_configuration,
+      )
+    end
+
+    # Clears the display and prints upto 8 lines of text.
+    #
+    # Text may contain newline characters to separate lines.
+    # Lines longer than 21 characters will be wrapped.
+    #
+    # Text is automatically encoded in the IBM437 character set.
+    # @example
+    #  my_oled.put_screen "Hello, World!\n\nRuby #{RUBY_VERSION}"
+    def put_screen(text='', test: false)
+      lines = text.split("\n")
+      lines = lines.map { |s| s.empty? ? '' : s.scan(/.{1,21}/) }.flatten
+      lines = lines[0,8].map { |l| encode l }
+
+      return lines if test
+
+      clear_display
+      lines.each_with_index do |s,l|
+        write_line l, 0, s
+      end
+      nil
+    end
+
+    # Shows an object.
+    def show(object)
+      if object.respond_to?( :_view_21x8, true)
+        put_screen ( object.send(:_view_21x8) rescue "21x8 view error\n\n#{object.class.to_s}" )
+      elsif
+        put_screen object.inspect[0,168]
+      end
+    end
+
+    private
+
+    def _view_21x8
+      "OLED         #{uid_string.rjust 8}"
+    end
+
+  end
+
+end

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

@@ -6,5 +6,6 @@
   ],
   "weight": 10,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Outdoor_Weather.html",
-  "versions_identifier": "bricklets:outdoor_weather"
+  "versions_identifier": "bricklets:outdoor_weather",
+  "released": "2018-02-26"
 }

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

@@ -2,6 +2,13 @@ module Tinkerforge
 
   class BrickletOutdoorWeather
 
+    # Returns the device's state.
+    def state
+      super.merge(
+        'sensor_data' => sensors,
+      )
+    end
+
     # Returns the last measured data for all sensors.
     #
     # The result is a Hash, with sensor identifiers as the keys. Values per sensor are:
@@ -14,6 +21,15 @@ module Tinkerforge
       end.to_h
     end
 
+    private
+
+    def _view_21x8
+      "Weather      #{uid_string.rjust 8}\n\n" +
+      sensors.first(6).map do |k,v|
+        %Q(#{v[2] > 100 ? '?' : ' '} %3d  %4.1f °C  %2d %%\n) % [k,v].flatten
+      end.join
+    end
+
   end
 
 end

data/lib/tinderfridge/devices/bricklet_piezo_speaker_v2/bricklet_piezo_speaker_v2.json

@@ -6,5 +6,6 @@
   ],
   "weight": 20,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Piezo_Speaker_V2.html",
-  "versions_identifier": "bricklets:piezo_speaker_v2"
+  "versions_identifier": "bricklets:piezo_speaker_v2",
+  "released": "2019-05-20"
 }

data/lib/tinderfridge/devices/bricklet_piezo_speaker_v2/bricklet_piezo_speaker_v2.rb

@@ -0,0 +1,14 @@
+module Tinkerforge
+
+  class BrickletPiezoSpeakerV2
+
+    # Beeps briefly.
+    #
+    # Volume (0..10) defaults to 0.
+    def blip(volume=0)
+      set_beep(600, volume, 80)
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_real_time_clock_v2/bricklet_real_time_clock_v2.json

@@ -6,5 +6,6 @@
   ],
   "weight": 3,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/RealTime_Clock_V2.html",
-  "versions_identifier": "bricklets:real_time_clock_v2"
+  "versions_identifier": "bricklets:real_time_clock_v2",
+  "released": "2018-06-07"
 }

data/lib/tinderfridge/devices/bricklet_rgb_led_button/bricklet_rgb_led_button.json

@@ -6,5 +6,6 @@
   ],
   "weight": 7,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/RGB_LED_Button.html",
-  "versions_identifier": "bricklets:rgb_led_button"
+  "versions_identifier": "bricklets:rgb_led_button",
+  "released": "2017-11-17"
 }

data/lib/tinderfridge/devices/bricklet_rgb_led_v2/bricklet_rgb_led_v2.json

@@ -6,5 +6,6 @@
   ],
   "weight": 3,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/RGB_LED_V2.html",
-  "versions_identifier": "bricklets:rgb_led_v2"
+  "versions_identifier": "bricklets:rgb_led_v2",
+  "released": "2019-05-20"
 }

data/lib/tinderfridge/devices/bricklet_rotary_encoder_v2/bricklet_rotary_encoder_v2.json

@@ -6,5 +6,6 @@
   ],
   "weight": 6,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Rotary_Encoder_V2.html",
-  "versions_identifier": "bricklets:rotary_encoder_v2"
+  "versions_identifier": "bricklets:rotary_encoder_v2",
+  "released": "2018-02-26"
 }

data/lib/tinderfridge/devices/bricklet_rotary_poti_v2/bricklet_rotary_poti_v2.json

@@ -6,5 +6,6 @@
   ],
   "weight": 7,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Rotary_Poti_V2.html",
-  "versions_identifier": "bricklets:rotary_poti_v2"
+  "versions_identifier": "bricklets:rotary_poti_v2",
+  "released": "2019-08-22"
 }

data/lib/tinderfridge/devices/bricklet_temperature_ir_v2/bricklet_temperature_ir_v2.json

@@ -6,5 +6,6 @@
   ],
   "weight": 3,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Temperature_IR_V2.html",
-  "versions_identifier": "bricklets:temperature_ir_v2"
+  "versions_identifier": "bricklets:temperature_ir_v2",
+  "released": "2018-02-26"
 }

data/lib/tinderfridge/devices/bricklet_temperature_ir_v2/bricklet_temperature_ir_v2.rb

@@ -0,0 +1,14 @@
+module Tinkerforge
+
+  class BrickletTemperatureIRV2
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'emissivity'  => get_emissivity,
+      )
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_temperature_v2/bricklet_temperature_v2.json

@@ -6,5 +6,6 @@
   ],
   "weight": 2,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Temperature_V2.html",
-  "versions_identifier": "bricklets:temperature_v2"
+  "versions_identifier": "bricklets:temperature_v2",
+  "released": "2018-09-27"
 }

data/lib/tinderfridge/devices/bricklet_temperature_v2/bricklet_temperature_v2.rb

@@ -0,0 +1,27 @@
+module Tinkerforge
+
+  class BrickletTemperatureV2
+
+    # Returns the device's state.
+    def state
+      super.merge(
+        'temperature'          => get_temperature,
+        'heater_configuration' => get_heater_configuration,
+      )
+    end
+
+    private
+
+    def _view_21x8
+      <<~ET
+      Temp         #{uid_string.rjust 8}
+
+            #{'%6.2f °C' % [get_temperature*0.01]}
+
+              #{get_heater_configuration == 1 ? 'HEATER' : ''}
+      ET
+    end
+
+  end
+
+end

data/lib/tinderfridge/devices/bricklet_thermal_imaging/bricklet_thermal_imaging.json

@@ -6,5 +6,6 @@
   ],
   "weight": 8,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Thermal_Imaging.html",
-  "versions_identifier": "bricklets:thermal_imaging"
+  "versions_identifier": "bricklets:thermal_imaging",
+  "released": "2017-11-17"
 }

data/lib/tinderfridge/devices/bricklet_thermocouple_v2/bricklet_thermocouple_v2.json

@@ -6,5 +6,6 @@
   ],
   "weight": 9,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Thermocouple_V2.html",
-  "versions_identifier": "bricklets:thermocouple_v2"
+  "versions_identifier": "bricklets:thermocouple_v2",
+  "released": "2018-06-07"
 }

data/lib/tinderfridge/devices/bricklet_uv_light_v2/bricklet_uv_light_v2.json

@@ -6,5 +6,6 @@
   ],
   "weight": 2.1,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/UV_Light_V2.html",
-  "versions_identifier": "bricklets:uv_light_v2"
+  "versions_identifier": "bricklets:uv_light_v2",
+  "released": "2018-09-27"
 }

data/lib/tinderfridge/devices/bricklet_voltage_current_v2/bricklet_voltage_current_v2.json

@@ -6,5 +6,6 @@
   ],
   "weight": 10,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Voltage_Current_V2.html",
-  "versions_identifier": "bricklets:voltage_current_v2"
+  "versions_identifier": "bricklets:voltage_current_v2",
+  "released": "2018-06-07"
 }

data/lib/tinderfridge/devices/bricklet_xmc1400_breakout/bricklet_xmc1400_breakout.json

@@ -6,5 +6,6 @@
   ],
   "weight": 12,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/XMC1400_Breakout.html",
-  "versions_identifier": "bricklets:xmc1400_breakout"
+  "versions_identifier": "bricklets:xmc1400_breakout",
+  "released": "2019-08-22"
 }

data/lib/tinderfridge/ip_connection.rb

@@ -10,6 +10,9 @@ module Tinkerforge
     # Returns the port for the IP Connection.
     attr_reader :port
 
+    # Returns the network socket used by the IP Connection.
+    attr_reader :socket
+
     # Returns a programmer-friendly representation of the object.
     def inspect
       "%s (%s:%s)" % [self.class, host, port]
@@ -117,17 +120,22 @@ module Tinkerforge
 
   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
+
+  class << self
+
+    # 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 connect(host=nil, port=nil)
+      ipcon = IPConnection.new
+      ipcon.connect(
+        ( host || ENV['TINKERFORGE_HOST'] || 'localhost' ),
+        ( port || ENV['TINKERFORGE_PORT'] ||  4223       )
+      )
+      ipcon
+    end
+
   end
 
 end

data/lib/tinderfridge/shared/display_ibm437_encoding.rb

@@ -0,0 +1,41 @@
+module Tinkerforge
+
+  module Shared
+
+    module IBM437_encoding
+
+      private
+
+      # Encodes a string in the IBM437 character set used by some displays.
+      #
+      # Characters that can not be encoded are replaced with '?'.
+      #
+      # See:
+      # - https://en.wikipedia.org/wiki/Code_page_437
+      def ibm437_encode(string)
+        string.encode('IBM437', fallback: ibm437_encoding_fallback_table)
+      end
+
+      # Ruby's IBM437 encoding does not include codepoints 0..31 and 127.
+      # This fallback table defines those, minus 0,
+      # and defines '?' as default for undefined characters.
+      def ibm437_encoding_fallback_table
+        @@ibm437_encoding_fallback_table ||= Hash.new('?').merge(
+          {
+            '☺'=> "\x01", '☻'=> "\x02", '♥'=> "\x03", '♦'=> "\x04",
+            '♣'=> "\x05", '♠'=> "\x06", '•'=> "\x07", '◘'=> "\x08",
+            '○'=> "\x09", '◙'=> "\x0a", '♂'=> "\x0b", '♀'=> "\x0c",
+            '♪'=> "\x0d", '♫'=> "\x0e", '☼'=> "\x0f", '►'=> "\x10",
+            '◄'=> "\x11", '↕'=> "\x12", '‼'=> "\x13", '¶'=> "\x14",
+            '§'=> "\x15", '▬'=> "\x16", '↨'=> "\x17", '↑'=> "\x18",
+            '↓'=> "\x19", '→'=> "\x1a", '←'=> "\x1b", '∟'=> "\x1c",
+            '↔'=> "\x1d", '▲'=> "\x1e", '▼'=> "\x1f", '⌂'=> "\x7f"
+          }
+        )
+      end
+
+    end
+
+  end
+
+end

data/lib/tinderfridge/tinkerforge.rb

@@ -5,16 +5,31 @@ module Tinkerforge
   ALL_VERSIONS_URL    = 'https://download.tinkerforge.com/all_versions.txt'
   LATEST_VERSIONS_URL = 'https://download.tinkerforge.com/latest_versions.txt'
 
-  # 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
+  class << self
+
+    # Returns the directory where Tinkerforge bindings appear to be installed.
+    def 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 require_everything
+      Dir.glob(File.join lib_dir, 'tinkerforge', '*.rb').map do |file|
+        require(file) ? file : nil
+      end.compact
+    end
+
+    # Discovers local devices.
+    #
+    # Connects to 'localhost', and returns devices discovered there. If no port is specified, defaults to port 4223.
+    # @example
+    #  Tinkerforge.local.ls
+    # @example Mac only
+    #  Tinkerforge.local.doc
+    def local(port=4223)
+      connect('localhost', port).discover(0.25)
+    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

@@ -3,7 +3,7 @@ require 'tinkerforge/version'
 module Tinkerforge
 
   # Tinderfridge version.
-  TINDERFRIDGE_VERSION = '0.9.0'
+  TINDERFRIDGE_VERSION = '0.12.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.9.0
+  version: 0.12.0
 platform: ruby
 authors:
 - lllist.eu
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-01-26 00:00:00.000000000 Z
+date: 2022-07-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tinkerforge
@@ -41,6 +41,10 @@ files:
 - lib/tinderfridge/device_collection.rb
 - lib/tinderfridge/device_info.rb
 - lib/tinderfridge/device_info.txt
+- lib/tinderfridge/devices/brick_esp32/brick_esp32.json
+- lib/tinderfridge/devices/brick_esp32/brick_esp32.rb
+- lib/tinderfridge/devices/brick_esp32_ethernet/brick_esp32_ethernet.json
+- lib/tinderfridge/devices/brick_esp32_ethernet/brick_esp32_ethernet.rb
 - lib/tinderfridge/devices/brick_hat/brick_hat.json
 - lib/tinderfridge/devices/brick_hat/brick_hat.rb
 - lib/tinderfridge/devices/brick_hat_zero/brick_hat_zero.json
@@ -55,6 +59,7 @@ files:
 - lib/tinderfridge/devices/bricklet_analog_in_v3/bricklet_analog_in_v3.json
 - lib/tinderfridge/devices/bricklet_analog_out_v3/bricklet_analog_out_v3.json
 - lib/tinderfridge/devices/bricklet_barometer_v2/bricklet_barometer_v2.json
+- lib/tinderfridge/devices/bricklet_barometer_v2/bricklet_barometer_v2.rb
 - lib/tinderfridge/devices/bricklet_can_v2/bricklet_can_v2.json
 - lib/tinderfridge/devices/bricklet_co2_v2/bricklet_co2_v2.json
 - lib/tinderfridge/devices/bricklet_co2_v2/bricklet_co2_v2.rb
@@ -71,7 +76,10 @@ files:
 - lib/tinderfridge/devices/bricklet_energy_monitor/bricklet_energy_monitor.json
 - lib/tinderfridge/devices/bricklet_gps_v2/bricklet_gps_v2.json
 - lib/tinderfridge/devices/bricklet_gps_v2/bricklet_gps_v2.rb
+- lib/tinderfridge/devices/bricklet_gps_v3/bricklet_gps_v3.json
+- lib/tinderfridge/devices/bricklet_gps_v3/bricklet_gps_v3.rb
 - lib/tinderfridge/devices/bricklet_hall_effect_v2/bricklet_hall_effect_v2.json
+- lib/tinderfridge/devices/bricklet_hall_effect_v2/bricklet_hall_effect_v2.rb
 - lib/tinderfridge/devices/bricklet_humidity_v2/bricklet_humidity_v2.json
 - lib/tinderfridge/devices/bricklet_imu_v3/bricklet_imu_v3.json
 - lib/tinderfridge/devices/bricklet_industrial_analog_out_v2/bricklet_industrial_analog_out_v2.json
@@ -107,12 +115,14 @@ files:
 - lib/tinderfridge/devices/bricklet_nfc/bricklet_nfc.json
 - lib/tinderfridge/devices/bricklet_nfc/bricklet_nfc.rb
 - lib/tinderfridge/devices/bricklet_oled_128x64_v2/bricklet_oled_128x64_v2.json
+- lib/tinderfridge/devices/bricklet_oled_128x64_v2/bricklet_oled_128x64_v2.rb
 - lib/tinderfridge/devices/bricklet_one_wire/bricklet_one_wire.json
 - lib/tinderfridge/devices/bricklet_outdoor_weather/bricklet_outdoor_weather.json
 - lib/tinderfridge/devices/bricklet_outdoor_weather/bricklet_outdoor_weather.rb
 - lib/tinderfridge/devices/bricklet_particulate_matter/bricklet_particulate_matter.json
 - lib/tinderfridge/devices/bricklet_performance_dc/bricklet_performance_dc.json
 - lib/tinderfridge/devices/bricklet_piezo_speaker_v2/bricklet_piezo_speaker_v2.json
+- lib/tinderfridge/devices/bricklet_piezo_speaker_v2/bricklet_piezo_speaker_v2.rb
 - lib/tinderfridge/devices/bricklet_ptc_v2/bricklet_ptc_v2.json
 - lib/tinderfridge/devices/bricklet_real_time_clock_v2/bricklet_real_time_clock_v2.json
 - lib/tinderfridge/devices/bricklet_remote_switch_v2/bricklet_remote_switch_v2.json
@@ -134,7 +144,9 @@ files:
 - lib/tinderfridge/devices/bricklet_sound_pressure_level/bricklet_sound_pressure_level.json
 - lib/tinderfridge/devices/bricklet_sound_pressure_level/bricklet_sound_pressure_level.rb
 - lib/tinderfridge/devices/bricklet_temperature_ir_v2/bricklet_temperature_ir_v2.json
+- lib/tinderfridge/devices/bricklet_temperature_ir_v2/bricklet_temperature_ir_v2.rb
 - lib/tinderfridge/devices/bricklet_temperature_v2/bricklet_temperature_v2.json
+- lib/tinderfridge/devices/bricklet_temperature_v2/bricklet_temperature_v2.rb
 - lib/tinderfridge/devices/bricklet_thermal_imaging/bricklet_thermal_imaging.json
 - lib/tinderfridge/devices/bricklet_thermocouple_v2/bricklet_thermocouple_v2.json
 - lib/tinderfridge/devices/bricklet_uv_light_v2/bricklet_uv_light_v2.json
@@ -142,6 +154,7 @@ files:
 - lib/tinderfridge/devices/bricklet_voltage_current_v2/bricklet_voltage_current_v2.rb
 - lib/tinderfridge/devices/bricklet_xmc1400_breakout/bricklet_xmc1400_breakout.json
 - lib/tinderfridge/ip_connection.rb
+- lib/tinderfridge/shared/display_ibm437_encoding.rb
 - lib/tinderfridge/tinkerforge.rb
 - lib/tinderfridge/version.rb
 homepage: https://github.com/lllisteu/tinderfridge
@@ -166,7 +179,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.32
+rubygems_version: 3.3.11
 signing_key:
 specification_version: 4
 summary: Extending Tinkerforge in fun and useful ways.