RubyGems - tinkerforge - Versions diffs - 2.1.6 → 2.1.7 - Mend

tinkerforge 2.1.6 → 2.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (68) hide show

data/lib/tinkerforge/brick_dc.rb +2 -2
data/lib/tinkerforge/brick_imu.rb +2 -2
data/lib/tinkerforge/brick_imu_v2.rb +2 -2
data/lib/tinkerforge/brick_master.rb +2 -2
data/lib/tinkerforge/brick_red.rb +2 -2
data/lib/tinkerforge/brick_servo.rb +2 -2
data/lib/tinkerforge/brick_stepper.rb +2 -2
data/lib/tinkerforge/bricklet_accelerometer.rb +2 -2
data/lib/tinkerforge/bricklet_ambient_light.rb +2 -2
data/lib/tinkerforge/bricklet_ambient_light_v2.rb +2 -2
data/lib/tinkerforge/bricklet_analog_in.rb +2 -2
data/lib/tinkerforge/bricklet_analog_in_v2.rb +3 -3
data/lib/tinkerforge/bricklet_analog_out.rb +2 -2
data/lib/tinkerforge/bricklet_analog_out_v2.rb +2 -2
data/lib/tinkerforge/bricklet_barometer.rb +2 -2
data/lib/tinkerforge/bricklet_co2.rb +158 -0
data/lib/tinkerforge/bricklet_color.rb +2 -2
data/lib/tinkerforge/bricklet_current12.rb +2 -2
data/lib/tinkerforge/bricklet_current25.rb +2 -2
data/lib/tinkerforge/bricklet_distance_ir.rb +2 -2
data/lib/tinkerforge/bricklet_distance_us.rb +2 -2
data/lib/tinkerforge/bricklet_dual_button.rb +2 -2
data/lib/tinkerforge/bricklet_dual_relay.rb +2 -2
data/lib/tinkerforge/bricklet_dust_detector.rb +2 -2
data/lib/tinkerforge/bricklet_gps.rb +2 -2
data/lib/tinkerforge/bricklet_hall_effect.rb +2 -2
data/lib/tinkerforge/bricklet_humidity.rb +2 -2
data/lib/tinkerforge/bricklet_industrial_analog_out.rb +2 -2
data/lib/tinkerforge/bricklet_industrial_digital_in_4.rb +2 -2
data/lib/tinkerforge/bricklet_industrial_digital_out_4.rb +2 -2
data/lib/tinkerforge/bricklet_industrial_dual_0_20ma.rb +2 -2
data/lib/tinkerforge/bricklet_industrial_dual_analog_in.rb +2 -2
data/lib/tinkerforge/bricklet_industrial_quad_relay.rb +2 -2
data/lib/tinkerforge/bricklet_io16.rb +2 -2
data/lib/tinkerforge/bricklet_io4.rb +2 -2
data/lib/tinkerforge/bricklet_joystick.rb +2 -2
data/lib/tinkerforge/bricklet_laser_range_finder.rb +2 -2
data/lib/tinkerforge/bricklet_lcd_16x2.rb +5 -4
data/lib/tinkerforge/bricklet_lcd_20x4.rb +6 -5
data/lib/tinkerforge/bricklet_led_strip.rb +2 -2
data/lib/tinkerforge/bricklet_line.rb +2 -2
data/lib/tinkerforge/bricklet_linear_poti.rb +2 -2
data/lib/tinkerforge/bricklet_load_cell.rb +2 -2
data/lib/tinkerforge/bricklet_moisture.rb +2 -2
data/lib/tinkerforge/bricklet_motion_detector.rb +2 -2
data/lib/tinkerforge/bricklet_multi_touch.rb +2 -2
data/lib/tinkerforge/bricklet_nfc_rfid.rb +2 -2
data/lib/tinkerforge/bricklet_oled_128x64.rb +124 -0
data/lib/tinkerforge/bricklet_oled_64x48.rb +123 -0
data/lib/tinkerforge/bricklet_piezo_buzzer.rb +2 -2
data/lib/tinkerforge/bricklet_piezo_speaker.rb +2 -2
data/lib/tinkerforge/bricklet_ptc.rb +2 -2
data/lib/tinkerforge/bricklet_remote_switch.rb +2 -2
data/lib/tinkerforge/bricklet_rotary_encoder.rb +2 -2
data/lib/tinkerforge/bricklet_rotary_poti.rb +2 -2
data/lib/tinkerforge/bricklet_rs232.rb +2 -2
data/lib/tinkerforge/bricklet_segment_display_4x7.rb +2 -2
data/lib/tinkerforge/bricklet_solid_state_relay.rb +2 -2
data/lib/tinkerforge/bricklet_sound_intensity.rb +2 -2
data/lib/tinkerforge/bricklet_temperature.rb +2 -2
data/lib/tinkerforge/bricklet_temperature_ir.rb +2 -2
data/lib/tinkerforge/bricklet_thermocouple.rb +235 -0
data/lib/tinkerforge/bricklet_tilt.rb +2 -2
data/lib/tinkerforge/bricklet_uv_light.rb +160 -0
data/lib/tinkerforge/bricklet_voltage.rb +2 -2
data/lib/tinkerforge/bricklet_voltage_current.rb +2 -2
data/lib/tinkerforge/version.rb +1 -1
metadata +7 -2

data/lib/tinkerforge/bricklet_gps.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_hall_effect.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_humidity.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_industrial_analog_out.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_industrial_digital_in_4.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_industrial_digital_out_4.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_industrial_dual_0_20ma.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_industrial_dual_analog_in.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_industrial_quad_relay.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_io16.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_io4.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_joystick.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_laser_range_finder.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_lcd_16x2.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #
@@ -111,8 +111,9 @@ module Tinkerforge
       send_request(FUNCTION_GET_CONFIG, [], '', 2, '? ?')
     end
-    # Returns *true* if the button (0 to 2) is pressed. If you want to react
-    # on button presses and releases it is recommended to use the
+    # Returns *true* if the button (0 to 2) is pressed.
+    #
+    # If you want to react on button presses and releases it is recommended to use the
     # CALLBACK_BUTTON_PRESSED and CALLBACK_BUTTON_RELEASED callbacks.
     def is_button_pressed(button)
       send_request(FUNCTION_IS_BUTTON_PRESSED, [button], 'C', 1, '?')

data/lib/tinkerforge/bricklet_lcd_20x4.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #
@@ -120,9 +120,10 @@ module Tinkerforge
     end
     # Returns *true* if the button (0 to 2 or 0 to 3 since hardware version 1.2)
-    # is pressed. If you want to react
-    # on button presses and releases it is recommended to use the
-    # CALLBACK_BUTTON_PRESSED and CALLBACK_BUTTON_RELEASED callbacks.
+    # is pressed.
+    #
+    # If you want to react on button presses and releases it is recommended to use
+    # the CALLBACK_BUTTON_PRESSED and CALLBACK_BUTTON_RELEASED callbacks.
     def is_button_pressed(button)
       send_request(FUNCTION_IS_BUTTON_PRESSED, [button], 'C', 1, '?')
     end

data/lib/tinkerforge/bricklet_led_strip.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_line.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_linear_poti.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_load_cell.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_moisture.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_motion_detector.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_multi_touch.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_nfc_rfid.rb CHANGED Viewed

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2015-11-17.      #
+# This file was automatically generated on 2016-01-06.      #
 #                                                           #
-# Bindings Version 2.1.6                                    #
+# Ruby Bindings Version 2.1.7                               #
 #                                                           #
 # If you have a bugfix for this file and want to commit it, #
 # please fix the bug in the generator. You can find a link  #

data/lib/tinkerforge/bricklet_oled_128x64.rb ADDED Viewed

@@ -0,0 +1,124 @@
+# -*- ruby encoding: utf-8 -*-
+#############################################################
+# This file was automatically generated on 2016-01-06.      #
+#                                                           #
+# Ruby Bindings Version 2.1.7                               #
+#                                                           #
+# If you have a bugfix for this file and want to commit it, #
+# please fix the bug in the generator. You can find a link  #
+# to the generators git repository on tinkerforge.com       #
+#############################################################
+module Tinkerforge
+  # 1.3" OLED with 128x64 pixels
+  class BrickletOLED128x64 < Device
+    DEVICE_IDENTIFIER = 263 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'OLED 128x64 Bricklet' # :nodoc:
+    FUNCTION_WRITE = 1 # :nodoc:
+    FUNCTION_NEW_WINDOW = 2 # :nodoc:
+    FUNCTION_CLEAR_DISPLAY = 3 # :nodoc:
+    FUNCTION_SET_DISPLAY_CONFIGURATION = 4 # :nodoc:
+    FUNCTION_GET_DISPLAY_CONFIGURATION = 5 # :nodoc:
+    FUNCTION_WRITE_LINE = 6 # :nodoc:
+    FUNCTION_GET_IDENTITY = 255 # :nodoc:
+    # Creates an object with the unique device ID <tt>uid</tt> and adds it to
+    # the IP Connection <tt>ipcon</tt>.
+    def initialize(uid, ipcon)
+      super uid, ipcon
+      @api_version = [2, 0, 0]
+      @response_expected[FUNCTION_WRITE] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_NEW_WINDOW] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_CLEAR_DISPLAY] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_SET_DISPLAY_CONFIGURATION] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_GET_DISPLAY_CONFIGURATION] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[FUNCTION_WRITE_LINE] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_GET_IDENTITY] = RESPONSE_EXPECTED_ALWAYS_TRUE
+    end
+    # Appends 64 byte of data to the window as set by BrickletOLED128x64#new_window.
+    #
+    # Each row has a height of 8 pixels which corresponds to one byte of data.
+    #
+    # Example: if you call BrickletOLED128x64#new_window with column from 0 to 127 and row
+    # from 0 to 7 (the whole display) each call of BrickletOLED128x64#write (red arrow) will
+    # write half of a row.
+    #
+    # .. image:: /Images/Bricklets/bricklet_oled_128x64_display.png
+    #    :scale: 100 %
+    #    :alt: Display pixel order
+    #    :align: center
+    #    :target: ../../_images/Bricklets/bricklet_oled_128x64_display.png
+    #
+    # The LSB (D0) of each data byte is at the top and the MSB (D7) is at the
+    # bottom of the row.
+    #
+    # The next call of BrickletOLED128x64#write will write the second half of the row
+    # and the next two the second row and so on. To fill the whole display
+    # you need to call BrickletOLED128x64#write 16 times.
+    def write(data)
+      send_request(FUNCTION_WRITE, [data], 'C64', 0, '')
+    end
+    # Sets the window in which you can write with BrickletOLED128x64#write. One row
+    # has a height of 8 pixels.
+    #
+    # The columns have a range of 0 to 127 and the rows have a range of 0 to 7.
+    def new_window(column_from, column_to, row_from, row_to)
+      send_request(FUNCTION_NEW_WINDOW, [column_from, column_to, row_from, row_to], 'C C C C', 0, '')
+    end
+    # Clears the current content of the display.
+    def clear_display
+      send_request(FUNCTION_CLEAR_DISPLAY, [], '', 0, '')
+    end
+    # Sets the configuration of the display.
+    #
+    # You can set a contrast value from 0 to 255 and you can invert the color
+    # (black/white) of the display.
+    #
+    # The default values are contrast 143 and inverting off.
+    def set_display_configuration(contrast, invert)
+      send_request(FUNCTION_SET_DISPLAY_CONFIGURATION, [contrast, invert], 'C ?', 0, '')
+    end
+    # Returns the configuration as set by BrickletOLED128x64#set_display_configuration.
+    def get_display_configuration
+      send_request(FUNCTION_GET_DISPLAY_CONFIGURATION, [], '', 2, 'C ?')
+    end
+    # Writes text to a specific line (0 to 7) with a specific position
+    # (0 to 25). The text can have a maximum of 26 characters.
+    #
+    # For example: (1, 10, "Hello") will write *Hello* in the middle of the
+    # second line of the display.
+    #
+    # You can draw to the display with BrickletOLED128x64#write and then add text to it
+    # afterwards.
+    #
+    # The display uses a special 5x7 pixel charset. You can view the characters
+    # of the charset in Brick Viewer.
+    def write_line(line, position, text)
+      send_request(FUNCTION_WRITE_LINE, [line, position, text], 'C C Z26', 0, '')
+    end
+    # Returns the UID, the UID where the Bricklet is connected to,
+    # the position, the hardware and firmware version as well as the
+    # device identifier.
+    #
+    # The position can be 'a', 'b', 'c' or 'd'.
+    #
+    # The device identifier numbers can be found :ref:`here <device_identifier>`.
+    # |device_identifier_constant|
+    def get_identity
+      send_request(FUNCTION_GET_IDENTITY, [], '', 25, 'Z8 Z8 k C3 C3 S')
+    end
+  end
+end

data/lib/tinkerforge/bricklet_oled_64x48.rb ADDED Viewed

@@ -0,0 +1,123 @@
+# -*- ruby encoding: utf-8 -*-
+#############################################################
+# This file was automatically generated on 2016-01-06.      #
+#                                                           #
+# Ruby Bindings Version 2.1.7                               #
+#                                                           #
+# If you have a bugfix for this file and want to commit it, #
+# please fix the bug in the generator. You can find a link  #
+# to the generators git repository on tinkerforge.com       #
+#############################################################
+module Tinkerforge
+  # 0.66" OLED with 64x48 pixels
+  class BrickletOLED64x48 < Device
+    DEVICE_IDENTIFIER = 264 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'OLED 64x48 Bricklet' # :nodoc:
+    FUNCTION_WRITE = 1 # :nodoc:
+    FUNCTION_NEW_WINDOW = 2 # :nodoc:
+    FUNCTION_CLEAR_DISPLAY = 3 # :nodoc:
+    FUNCTION_SET_DISPLAY_CONFIGURATION = 4 # :nodoc:
+    FUNCTION_GET_DISPLAY_CONFIGURATION = 5 # :nodoc:
+    FUNCTION_WRITE_LINE = 6 # :nodoc:
+    FUNCTION_GET_IDENTITY = 255 # :nodoc:
+    # Creates an object with the unique device ID <tt>uid</tt> and adds it to
+    # the IP Connection <tt>ipcon</tt>.
+    def initialize(uid, ipcon)
+      super uid, ipcon
+      @api_version = [2, 0, 0]
+      @response_expected[FUNCTION_WRITE] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_NEW_WINDOW] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_CLEAR_DISPLAY] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_SET_DISPLAY_CONFIGURATION] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_GET_DISPLAY_CONFIGURATION] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[FUNCTION_WRITE_LINE] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_GET_IDENTITY] = RESPONSE_EXPECTED_ALWAYS_TRUE
+    end
+    # Appends 64 byte of data to the window as set by BrickletOLED64x48#new_window.
+    #
+    # Each row has a height of 8 pixels which corresponds to one byte of data.
+    #
+    # Example: if you call BrickletOLED64x48#new_window with column from 0 to 63 and row
+    # from 0 to 5 (the whole display) each call of BrickletOLED64x48#write (red arrow) will
+    # write one row.
+    #
+    # .. image:: /Images/Bricklets/bricklet_oled_64x48_display.png
+    #    :scale: 100 %
+    #    :alt: Display pixel order
+    #    :align: center
+    #    :target: ../../_images/Bricklets/bricklet_oled_64x48_display.png
+    #
+    # The LSB (D0) of each data byte is at the top and the MSB (D7) is at the
+    # bottom of the row.
+    #
+    # The next call of BrickletOLED64x48#write will write the second row and so on. To
+    # fill the whole display you need to call BrickletOLED64x48#write 6 times.
+    def write(data)
+      send_request(FUNCTION_WRITE, [data], 'C64', 0, '')
+    end
+    # Sets the window in which you can write with BrickletOLED64x48#write. One row
+    # has a height of 8 pixels.
+    #
+    # The columns have a range of 0 to 63 and the rows have a range of 0 to 5.
+    def new_window(column_from, column_to, row_from, row_to)
+      send_request(FUNCTION_NEW_WINDOW, [column_from, column_to, row_from, row_to], 'C C C C', 0, '')
+    end
+    # Clears the current content of the display.
+    def clear_display
+      send_request(FUNCTION_CLEAR_DISPLAY, [], '', 0, '')
+    end
+    # Sets the configuration of the display.
+    #
+    # You can set a contrast value from 0 to 255 and you can invert the color
+    # (black/white) of the display.
+    #
+    # The default values are contrast 143 and inverting off.
+    def set_display_configuration(contrast, invert)
+      send_request(FUNCTION_SET_DISPLAY_CONFIGURATION, [contrast, invert], 'C ?', 0, '')
+    end
+    # Returns the configuration as set by BrickletOLED64x48#set_display_configuration.
+    def get_display_configuration
+      send_request(FUNCTION_GET_DISPLAY_CONFIGURATION, [], '', 2, 'C ?')
+    end
+    # Writes text to a specific line (0 to 5) with a specific position
+    # (0 to 13). The text can have a maximum of 14 characters.
+    #
+    # For example: (1, 4, "Hello") will write *Hello* in the middle of the
+    # second line of the display.
+    #
+    # You can draw to the display with BrickletOLED64x48#write and then add text to it
+    # afterwards.
+    #
+    # The display uses a special 5x7 pixel charset. You can view the characters
+    # of the charset in Brick Viewer.
+    def write_line(line, position, text)
+      send_request(FUNCTION_WRITE_LINE, [line, position, text], 'C C Z13', 0, '')
+    end
+    # Returns the UID, the UID where the Bricklet is connected to,
+    # the position, the hardware and firmware version as well as the
+    # device identifier.
+    #
+    # The position can be 'a', 'b', 'c' or 'd'.
+    #
+    # The device identifier numbers can be found :ref:`here <device_identifier>`.
+    # |device_identifier_constant|
+    def get_identity
+      send_request(FUNCTION_GET_IDENTITY, [], '', 25, 'Z8 Z8 k C3 C3 S')
+    end
+  end
+end