tinderfridge 0.8.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1f848437f1877596a58521fdbe213042f6561b42a91c91b60eca2fd3ab1a690
-  data.tar.gz: '09c7adcf40fabf6eae5ca89316428aeb6cabfa5f4abccbaaf27bd3901535afca'
+  metadata.gz: f1c28bf9d30fc0a07640bc0455e0c79625d9c83891eff91d8e6e4227780c57d3
+  data.tar.gz: cb7039e16d274378b77af9c065e74ff0ad2ebd07450df034893d04144c5b5302
 SHA512:
-  metadata.gz: a84bc2687015ef1c65dd61cac031a7b6e6ff57e22a811784e6160dd5b002badf5f55f11c3883ffa754a6f42d0b5a6e5a085a4c930700c899956d06ec8f533d98
-  data.tar.gz: c12dcf3ef70b1111f665a3098ab213a75819c2953b3c7cb2ebc020bd00b016588ec70ca0bebbdf72666a84edcc4be345f7aaa67c8ee4f8841262c1fc4afb80a7
+  metadata.gz: 3311ac8e16a9233ae652ae8caf50aca8ebe6fa48ba8f0079764da55a8234542d57044ab52c2d7a6358fe22fb57e771c4cef8777e772dff3ad78da1e0e86ba989
+  data.tar.gz: 466bc1054d70689af056866a5d784050d6731d71fc711937a59e8a053bc7f17335eee594034f241282f918d773237d401486f62cef209d173e37eb95b559e105

data/lib/tinderfridge/device.rb

@@ -79,7 +79,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.
@@ -109,7 +109,13 @@ module Tinkerforge
         [ 'ipcon'    , { 'host' => ipcon.host , 'port'     => ipcon.port  } ],
 
         respond_to?('get_chip_temperature'  ) ? [ 'chip_temperature'  , get_chip_temperature   ] : nil,
-        respond_to?('get_spitfp_error_count') ? [ 'spitfp_error_count', get_spitfp_error_count ] : nil,
+
+        if respond_to?('get_spitfp_error_count') and (method(:get_spitfp_error_count).arity == 0)
+          [ 'spitfp_error_count', get_spitfp_error_count ]
+        else
+          nil
+        end,
+
         respond_to?('get_status_led_config' ) ? [ 'status_led_config' , get_status_led_config  ] : nil,
 
       ].compact.to_h
@@ -131,9 +137,30 @@ module Tinkerforge
 
     # Identifies a Tinkerforge device by blinking its status led.
     #
-    # Supports recent devices. When invoked on older devices, does nothing.
+    # Supports recent devices. When invoked on some older devices, does nothing.
     def identify(seconds=10)
-      if (respond_to? 'get_status_led_config') and (respond_to? 'set_status_led_config')
+      case status_led_api_variety
+      when 1
+        seconds = seconds.to_i
+        state   = is_status_led_enabled
+
+        (seconds*2).times do |n|
+          if n.even?
+            disable_status_led
+          else
+            enable_status_led
+          end
+          sleep 0.5
+        end
+
+        if state
+          enable_status_led
+        else
+          disable_status_led
+        end
+
+        seconds
+      when 2
         seconds = seconds.to_i
         state = get_status_led_config
 
@@ -175,6 +202,20 @@ module Tinkerforge
       end
     end
 
+    def status_led_api_variety
+      @status_led_api_variety ||=
+        if ( respond_to?('get_status_led_config') &&
+             respond_to?('set_status_led_config') )
+          2
+        elsif ( respond_to?('is_status_led_enabled') &&
+                respond_to?('enable_status_led')     &&
+                respond_to?('disable_status_led') )
+          1
+        else
+          nil
+        end
+    end
+
   end
 
 end

data/lib/tinderfridge/device_collection.rb

@@ -5,6 +5,8 @@ module Tinkerforge
     # 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.
+    #
+    # Note: most devices return temperature in °C, but a few return temperature in 1/10 °C.
     def get_chip_temperature
       smap 'get_chip_temperature'
     end
@@ -135,7 +137,7 @@ module Tinkerforge
     private
 
     def smap(m)
-      map { |k,d| [ k, d.respond_to?(m) ? d.send(m) : nil ] }.to_h
+      map { |k,d| [ k, ( d.respond_to?(m) and (d.method(m).arity == 0) ) ? d.send(m) : nil ] }.to_h
     end
 
   end

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/brick_master/brick_master.json

@@ -0,0 +1,11 @@
+{
+  "dimensions": [
+    40,
+    40,
+    16
+  ],
+  "weight": 12,
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricks/Master_Brick.html",
+  "versions_identifier": "bricks:master",
+  "released": ""
+}

data/lib/tinderfridge/devices/brick_master/brick_master.rb

@@ -0,0 +1,11 @@
+module Tinkerforge
+
+  class BrickMaster
+
+    # Unit returned by #get_chip_temperature. Master Bricks return temperature as 1/10 °C.
+    CHIP_TEMPERATURE_UNIT = 0.1
+    # REVIEW: This should ideally be part of base Tinkerforge.
+
+  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_ambient_light_v3/bricklet_ambient_light_v3.json

@@ -6,5 +6,6 @@
   ],
   "weight": 2,
   "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/Ambient_Light_V3.html",
-  "versions_identifier": "bricklets:ambient_light_v3"
+  "versions_identifier": "bricklets:ambient_light_v3",
+  "released": "2019-01-29"
 }

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.json

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

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

@@ -0,0 +1,29 @@
+module Tinkerforge
+
+  class BrickletCO2V2
+
+    # Returns the device's state.
+    def state
+      av = get_all_values
+      super.merge(
+        'co2_concentration'  => av[0],
+        'temperature'        => av[1],
+        'temperature_offset' => get_temperature_offset,
+        'humidity'           => av[2],
+        'air_pressure'       => get_air_pressure,
+      )
+    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_color_v2/bricklet_color_v2.json

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

data/lib/tinderfridge/devices/bricklet_compass/bricklet_compass.json

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

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

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

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

@@ -2,11 +2,24 @@ 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 get_status[0]
+      if fix?
         c = get_coordinates
         [
           c[0] / (c[1] == 'N' ? 1000000.0 : -1000000.0),
@@ -26,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
+      "GPS          #{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,4 @@
+{
+  "documentation_en_url": "https://www.tinkerforge.com/en/doc/Hardware/Bricklets/GPS_V3.html",
+  "released": "2022-05-09"
+}

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