tinkerforge 2.1.23 → 2.1.28

data/lib/tinkerforge/bricklet_lcd_16x2.rb

@@ -1,14 +1,16 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-08-23.      #
+# This file was automatically generated on 2021-01-15.      #
 #                                                           #
-# Ruby Bindings Version 2.1.23                              #
+# Ruby Bindings Version 2.1.28                              #
 #                                                           #
 # 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       #
 #############################################################
 
+require_relative './ip_connection'
+
 module Tinkerforge
   # 16x2 character alphanumeric display with blue backlight
   class BrickletLCD16x2 < Device
@@ -16,11 +18,11 @@ module Tinkerforge
     DEVICE_DISPLAY_NAME = 'LCD 16x2 Bricklet' # :nodoc:
 
     # This callback is triggered when a button is pressed. The parameter is
-    # the number of the button (0 to 2).
+    # the number of the button.
     CALLBACK_BUTTON_PRESSED = 9
 
     # This callback is triggered when a button is released. The parameter is
-    # the number of the button (0 to 2).
+    # the number of the button.
     CALLBACK_BUTTON_RELEASED = 10
 
     FUNCTION_WRITE_LINE = 1 # :nodoc:
@@ -39,7 +41,7 @@ module Tinkerforge
     # 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
+      super uid, ipcon, DEVICE_IDENTIFIER, DEVICE_DISPLAY_NAME
 
       @api_version = [2, 0, 1]
 
@@ -55,13 +57,14 @@ module Tinkerforge
       @response_expected[FUNCTION_GET_CUSTOM_CHARACTER] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[FUNCTION_GET_IDENTITY] = RESPONSE_EXPECTED_ALWAYS_TRUE
 
-      @callback_formats[CALLBACK_BUTTON_PRESSED] = 'C'
-      @callback_formats[CALLBACK_BUTTON_RELEASED] = 'C'
+      @callback_formats[CALLBACK_BUTTON_PRESSED] = [9, 'C']
+      @callback_formats[CALLBACK_BUTTON_RELEASED] = [9, 'C']
 
+      @ipcon.add_device self
     end
 
-    # Writes text to a specific line (0 to 1) with a specific position
-    # (0 to 15). The text can have a maximum of 16 characters.
+    # Writes text to a specific line with a specific position.
+    # The text can have a maximum of 16 characters.
     # 
     # For example: (0, 5, "Hello") will write *Hello* in the middle of the
     # first line of the display.
@@ -72,50 +75,64 @@ module Tinkerforge
     # for details. The Unicode example above shows how to specify non-ASCII characters
     # and how to translate from Unicode to the LCD charset.
     def write_line(line, position, text)
-      send_request FUNCTION_WRITE_LINE, [line, position, text], 'C C Z16', 0, ''
+      check_validity
+
+      send_request FUNCTION_WRITE_LINE, [line, position, text], 'C C Z16', 8, ''
     end
 
     # Deletes all characters from the display.
     def clear_display
-      send_request FUNCTION_CLEAR_DISPLAY, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_CLEAR_DISPLAY, [], '', 8, ''
     end
 
     # Turns the backlight on.
     def backlight_on
-      send_request FUNCTION_BACKLIGHT_ON, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_BACKLIGHT_ON, [], '', 8, ''
     end
 
     # Turns the backlight off.
     def backlight_off
-      send_request FUNCTION_BACKLIGHT_OFF, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_BACKLIGHT_OFF, [], '', 8, ''
     end
 
     # Returns *true* if the backlight is on and *false* otherwise.
     def is_backlight_on
-      send_request FUNCTION_IS_BACKLIGHT_ON, [], '', 1, '?'
+      check_validity
+
+      send_request FUNCTION_IS_BACKLIGHT_ON, [], '', 9, '?'
     end
 
     # Configures if the cursor (shown as "_") should be visible and if it
     # should be blinking (shown as a blinking block). The cursor position
     # is one character behind the the last text written with
     # BrickletLCD16x2#write_line.
-    # 
-    # The default is (false, false).
     def set_config(cursor, blinking)
-      send_request FUNCTION_SET_CONFIG, [cursor, blinking], '? ?', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_CONFIG, [cursor, blinking], '? ?', 8, ''
     end
 
     # Returns the configuration as set by BrickletLCD16x2#set_config.
     def get_config
-      send_request FUNCTION_GET_CONFIG, [], '', 2, '? ?'
+      check_validity
+
+      send_request FUNCTION_GET_CONFIG, [], '', 10, '? ?'
     end
 
-    # Returns *true* if the button (0 to 2) is pressed.
+    # Returns *true* if the button 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, '?'
+      check_validity
+
+      send_request FUNCTION_IS_BUTTON_PRESSED, [button], 'C', 9, '?'
     end
 
     # The LCD 16x2 Bricklet can store up to 8 custom characters. The characters
@@ -133,7 +150,8 @@ module Tinkerforge
     # * ``character[7] = 0b00000000`` (decimal value 0)
     # 
     # The characters can later be written with BrickletLCD16x2#write_line by using the
-    # characters with the byte representation 8 to 15.
+    # characters with the byte representation 8 ("\\x08" or "\\u0008") to 15
+    # ("\\x0F" or "\\u000F").
     # 
     # You can play around with the custom characters in Brick Viewer since
     # version 2.0.1.
@@ -143,7 +161,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.1$nbsp;(Plugin)
     def set_custom_character(index, character)
-      send_request FUNCTION_SET_CUSTOM_CHARACTER, [index, character], 'C C8', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_CUSTOM_CHARACTER, [index, character], 'C C8', 8, ''
     end
 
     # Returns the custom character for a given index, as set with
@@ -151,19 +171,23 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.1$nbsp;(Plugin)
     def get_custom_character(index)
-      send_request FUNCTION_GET_CUSTOM_CHARACTER, [index], 'C', 8, 'C8'
+      check_validity
+
+      send_request FUNCTION_GET_CUSTOM_CHARACTER, [index], 'C', 16, 'C8'
     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 position can be 'a', 'b', 'c', 'd', 'e', 'f', 'g' or 'h' (Bricklet Port).
+    # A Bricklet connected to an :ref:`Isolator Bricklet <isolator_bricklet>` is always at
+    # position 'z'.
     # 
     # 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'
+      send_request FUNCTION_GET_IDENTITY, [], '', 33, 'Z8 Z8 k C3 C3 S'
     end
 
     # Registers a callback with ID <tt>id</tt> to the block <tt>block</tt>.

data/lib/tinkerforge/bricklet_lcd_20x4.rb

@@ -1,14 +1,16 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-08-23.      #
+# This file was automatically generated on 2021-01-15.      #
 #                                                           #
-# Ruby Bindings Version 2.1.23                              #
+# Ruby Bindings Version 2.1.28                              #
 #                                                           #
 # 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       #
 #############################################################
 
+require_relative './ip_connection'
+
 module Tinkerforge
   # 20x4 character alphanumeric display with blue backlight
   class BrickletLCD20x4 < Device
@@ -43,7 +45,7 @@ module Tinkerforge
     # 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
+      super uid, ipcon, DEVICE_IDENTIFIER, DEVICE_DISPLAY_NAME
 
       @api_version = [2, 0, 2]
 
@@ -63,13 +65,14 @@ module Tinkerforge
       @response_expected[FUNCTION_GET_DEFAULT_TEXT_COUNTER] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[FUNCTION_GET_IDENTITY] = RESPONSE_EXPECTED_ALWAYS_TRUE
 
-      @callback_formats[CALLBACK_BUTTON_PRESSED] = 'C'
-      @callback_formats[CALLBACK_BUTTON_RELEASED] = 'C'
+      @callback_formats[CALLBACK_BUTTON_PRESSED] = [9, 'C']
+      @callback_formats[CALLBACK_BUTTON_RELEASED] = [9, 'C']
 
+      @ipcon.add_device self
     end
 
-    # Writes text to a specific line (0 to 3) with a specific position
-    # (0 to 19). The text can have a maximum of 20 characters.
+    # Writes text to a specific line with a specific position.
+    # The text can have a maximum of 20 characters.
     # 
     # For example: (0, 7, "Hello") will write *Hello* in the middle of the
     # first line of the display.
@@ -80,42 +83,54 @@ module Tinkerforge
     # for details. The Unicode example above shows how to specify non-ASCII characters
     # and how to translate from Unicode to the LCD charset.
     def write_line(line, position, text)
-      send_request FUNCTION_WRITE_LINE, [line, position, text], 'C C Z20', 0, ''
+      check_validity
+
+      send_request FUNCTION_WRITE_LINE, [line, position, text], 'C C Z20', 8, ''
     end
 
     # Deletes all characters from the display.
     def clear_display
-      send_request FUNCTION_CLEAR_DISPLAY, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_CLEAR_DISPLAY, [], '', 8, ''
     end
 
     # Turns the backlight on.
     def backlight_on
-      send_request FUNCTION_BACKLIGHT_ON, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_BACKLIGHT_ON, [], '', 8, ''
     end
 
     # Turns the backlight off.
     def backlight_off
-      send_request FUNCTION_BACKLIGHT_OFF, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_BACKLIGHT_OFF, [], '', 8, ''
     end
 
     # Returns *true* if the backlight is on and *false* otherwise.
     def is_backlight_on
-      send_request FUNCTION_IS_BACKLIGHT_ON, [], '', 1, '?'
+      check_validity
+
+      send_request FUNCTION_IS_BACKLIGHT_ON, [], '', 9, '?'
     end
 
     # Configures if the cursor (shown as "_") should be visible and if it
     # should be blinking (shown as a blinking block). The cursor position
     # is one character behind the the last text written with
     # BrickletLCD20x4#write_line.
-    # 
-    # The default is (*false*, *false*).
     def set_config(cursor, blinking)
-      send_request FUNCTION_SET_CONFIG, [cursor, blinking], '? ?', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_CONFIG, [cursor, blinking], '? ?', 8, ''
     end
 
     # Returns the configuration as set by BrickletLCD20x4#set_config.
     def get_config
-      send_request FUNCTION_GET_CONFIG, [], '', 2, '? ?'
+      check_validity
+
+      send_request FUNCTION_GET_CONFIG, [], '', 10, '? ?'
     end
 
     # Returns *true* if the button (0 to 2 or 0 to 3 since hardware version 1.2)
@@ -124,7 +139,9 @@ module Tinkerforge
     # 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, '?'
+      check_validity
+
+      send_request FUNCTION_IS_BUTTON_PRESSED, [button], 'C', 9, '?'
     end
 
     # The LCD 20x4 Bricklet can store up to 8 custom characters. The characters
@@ -142,7 +159,8 @@ module Tinkerforge
     # * ``character[7] = 0b00000000`` (decimal value 0)
     # 
     # The characters can later be written with BrickletLCD20x4#write_line by using the
-    # characters with the byte representation 8 ("\x08") to 15 ("\x0F").
+    # characters with the byte representation 8 ("\\x08" or "\\u0008") to 15
+    # ("\\x0F" or "\\u000F").
     # 
     # You can play around with the custom characters in Brick Viewer version
     # since 2.0.1.
@@ -152,7 +170,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.1$nbsp;(Plugin)
     def set_custom_character(index, character)
-      send_request FUNCTION_SET_CUSTOM_CHARACTER, [index, character], 'C C8', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_CUSTOM_CHARACTER, [index, character], 'C C8', 8, ''
     end
 
     # Returns the custom character for a given index, as set with
@@ -160,7 +180,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.1$nbsp;(Plugin)
     def get_custom_character(index)
-      send_request FUNCTION_GET_CUSTOM_CHARACTER, [index], 'C', 8, 'C8'
+      check_validity
+
+      send_request FUNCTION_GET_CUSTOM_CHARACTER, [index], 'C', 16, 'C8'
     end
 
     # Sets the default text for lines 0-3. The max number of characters
@@ -171,7 +193,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def set_default_text(line, text)
-      send_request FUNCTION_SET_DEFAULT_TEXT, [line, text], 'C Z20', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_DEFAULT_TEXT, [line, text], 'C Z20', 8, ''
     end
 
     # Returns the default text for a given line (0-3) as set by
@@ -179,10 +203,12 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_default_text(line)
-      send_request FUNCTION_GET_DEFAULT_TEXT, [line], 'C', 20, 'Z20'
+      check_validity
+
+      send_request FUNCTION_GET_DEFAULT_TEXT, [line], 'C', 28, 'Z20'
     end
 
-    # Sets the default text counter in ms. This counter is decremented each
+    # Sets the default text counter. This counter is decremented each
     # ms by the LCD firmware. If the counter reaches 0, the default text
     # (see BrickletLCD20x4#set_default_text) is shown on the LCD.
     # 
@@ -196,30 +222,34 @@ module Tinkerforge
     # 
     # A negative counter turns the default text functionality off.
     # 
-    # The default is -1.
-    # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def set_default_text_counter(counter)
-      send_request FUNCTION_SET_DEFAULT_TEXT_COUNTER, [counter], 'l', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_DEFAULT_TEXT_COUNTER, [counter], 'l', 8, ''
     end
 
     # Returns the current value of the default text counter.
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_default_text_counter
-      send_request FUNCTION_GET_DEFAULT_TEXT_COUNTER, [], '', 4, 'l'
+      check_validity
+
+      send_request FUNCTION_GET_DEFAULT_TEXT_COUNTER, [], '', 12, 'l'
     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 position can be 'a', 'b', 'c', 'd', 'e', 'f', 'g' or 'h' (Bricklet Port).
+    # A Bricklet connected to an :ref:`Isolator Bricklet <isolator_bricklet>` is always at
+    # position 'z'.
     # 
     # 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'
+      send_request FUNCTION_GET_IDENTITY, [], '', 33, 'Z8 Z8 k C3 C3 S'
     end
 
     # Registers a callback with ID <tt>id</tt> to the block <tt>block</tt>.

data/lib/tinkerforge/bricklet_led_strip.rb

@@ -1,14 +1,16 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-08-23.      #
+# This file was automatically generated on 2021-01-15.      #
 #                                                           #
-# Ruby Bindings Version 2.1.23                              #
+# Ruby Bindings Version 2.1.28                              #
 #                                                           #
 # 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       #
 #############################################################
 
+require_relative './ip_connection'
+
 module Tinkerforge
   # Controls up to 320 RGB LEDs
   class BrickletLEDStrip < Device
@@ -16,7 +18,7 @@ module Tinkerforge
     DEVICE_DISPLAY_NAME = 'LED Strip Bricklet' # :nodoc:
 
     # This callback is triggered directly after a new frame is rendered. The
-    # parameter is the number of LEDs in that frame.
+    # parameter is the number of RGB or RGBW LEDs in that frame.
     # 
     # You should send the data for the next frame directly after this callback
     # was triggered.
@@ -81,7 +83,7 @@ module Tinkerforge
     # 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
+      super uid, ipcon, DEVICE_IDENTIFIER, DEVICE_DISPLAY_NAME
 
       @api_version = [2, 0, 3]
 
@@ -103,20 +105,17 @@ module Tinkerforge
       @response_expected[FUNCTION_IS_FRAME_RENDERED_CALLBACK_ENABLED] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[FUNCTION_GET_IDENTITY] = RESPONSE_EXPECTED_ALWAYS_TRUE
 
-      @callback_formats[CALLBACK_FRAME_RENDERED] = 'S'
+      @callback_formats[CALLBACK_FRAME_RENDERED] = [10, 'S']
 
+      @ipcon.add_device self
     end
 
-    # Sets the RGB values for the LEDs with the given *length* starting
-    # from *index*.
+    # Sets *length* RGB values for the LEDs starting from *index*.
     # 
     # To make the colors show correctly you need to configure the chip type
     # (BrickletLEDStrip#set_chip_type) and a 3-channel channel mapping (BrickletLEDStrip#set_channel_mapping)
     # according to the connected LEDs.
     # 
-    # The maximum length is 16, the index goes from 0 to 319 and the rgb values
-    # have 8 bits each.
-    # 
     # Example: If you set
     # 
     # * index to 5,
@@ -150,41 +149,48 @@ module Tinkerforge
     # information. A call of BrickletLEDStrip#set_rgb_values with index + length above the
     # bounds is ignored completely.
     def set_rgb_values(index, length, r, g, b)
-      send_request FUNCTION_SET_RGB_VALUES, [index, length, r, g, b], 'S C C16 C16 C16', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_RGB_VALUES, [index, length, r, g, b], 'S C C16 C16 C16', 8, ''
     end
 
-    # Returns RGB value with the given *length* starting from the
-    # given *index*.
+    # Returns *length* R, G and B values starting from the
+    # given LED *index*.
     # 
     # The values are the last values that were set by BrickletLEDStrip#set_rgb_values.
     def get_rgb_values(index, length)
-      send_request FUNCTION_GET_RGB_VALUES, [index, length], 'S C', 48, 'C16 C16 C16'
+      check_validity
+
+      send_request FUNCTION_GET_RGB_VALUES, [index, length], 'S C', 56, 'C16 C16 C16'
     end
 
-    # Sets the frame duration in ms.
+    # Sets the frame duration.
     # 
     # Example: If you want to achieve 20 frames per second, you should
     # set the frame duration to 50ms (50ms * 20 = 1 second).
     # 
     # For an explanation of the general approach see BrickletLEDStrip#set_rgb_values.
-    # 
-    # Default value: 100ms (10 frames per second).
     def set_frame_duration(duration)
-      send_request FUNCTION_SET_FRAME_DURATION, [duration], 'S', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_FRAME_DURATION, [duration], 'S', 8, ''
     end
 
-    # Returns the frame duration in ms as set by BrickletLEDStrip#set_frame_duration.
+    # Returns the frame duration as set by BrickletLEDStrip#set_frame_duration.
     def get_frame_duration
-      send_request FUNCTION_GET_FRAME_DURATION, [], '', 2, 'S'
+      check_validity
+
+      send_request FUNCTION_GET_FRAME_DURATION, [], '', 10, 'S'
     end
 
-    # Returns the current supply voltage of the LEDs. The voltage is given in mV.
+    # Returns the current supply voltage of the LEDs.
     def get_supply_voltage
-      send_request FUNCTION_GET_SUPPLY_VOLTAGE, [], '', 2, 'S'
+      check_validity
+
+      send_request FUNCTION_GET_SUPPLY_VOLTAGE, [], '', 10, 'S'
     end
 
-    # Sets the frequency of the clock in Hz. The range is 10000Hz (10kHz) up to
-    # 2000000Hz (2MHz).
+    # Sets the frequency of the clock.
     # 
     # The Bricklet will choose the nearest achievable frequency, which may
     # be off by a few Hz. You can get the exact frequency that is used by
@@ -197,21 +203,23 @@ module Tinkerforge
     # With a decreasing frequency your maximum frames per second will decrease
     # too.
     # 
-    # The default value is 1.66MHz.
-    # 
     # .. note::
     #  The frequency in firmware version 2.0.0 is fixed at 2MHz.
     # 
     # .. versionadded:: 2.0.1$nbsp;(Plugin)
     def set_clock_frequency(frequency)
-      send_request FUNCTION_SET_CLOCK_FREQUENCY, [frequency], 'L', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_CLOCK_FREQUENCY, [frequency], 'L', 8, ''
     end
 
     # Returns the currently used clock frequency as set by BrickletLEDStrip#set_clock_frequency.
     # 
     # .. versionadded:: 2.0.1$nbsp;(Plugin)
     def get_clock_frequency
-      send_request FUNCTION_GET_CLOCK_FREQUENCY, [], '', 4, 'L'
+      check_validity
+
+      send_request FUNCTION_GET_CLOCK_FREQUENCY, [], '', 12, 'L'
     end
 
     # Sets the type of the LED driver chip. We currently support the chips
@@ -223,22 +231,23 @@ module Tinkerforge
     # * LPD8806 and
     # * APA102 / DotStar.
     # 
-    # The default value is WS2801 (2801).
-    # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def set_chip_type(chip)
-      send_request FUNCTION_SET_CHIP_TYPE, [chip], 'S', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_CHIP_TYPE, [chip], 'S', 8, ''
     end
 
     # Returns the currently used chip type as set by BrickletLEDStrip#set_chip_type.
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_chip_type
-      send_request FUNCTION_GET_CHIP_TYPE, [], '', 2, 'S'
+      check_validity
+
+      send_request FUNCTION_GET_CHIP_TYPE, [], '', 10, 'S'
     end
 
-    # Sets the RGBW values for the LEDs with the given *length* starting
-    # from *index*.
+    # Sets *length* RGBW values for the LEDs starting from *index*.
     # 
     # To make the colors show correctly you need to configure the chip type
     # (BrickletLEDStrip#set_chip_type) and a 4-channel channel mapping (BrickletLEDStrip#set_channel_mapping)
@@ -293,17 +302,20 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.6$nbsp;(Plugin)
     def set_rgbw_values(index, length, r, g, b, w)
-      send_request FUNCTION_SET_RGBW_VALUES, [index, length, r, g, b, w], 'S C C12 C12 C12 C12', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_RGBW_VALUES, [index, length, r, g, b, w], 'S C C12 C12 C12 C12', 8, ''
     end
 
-    # Returns RGBW values with the given *length* starting from the
-    # given *index*.
+    # Returns *length* RGBW values starting from the given *index*.
     # 
     # The values are the last values that were set by BrickletLEDStrip#set_rgbw_values.
     # 
     # .. versionadded:: 2.0.6$nbsp;(Plugin)
     def get_rgbw_values(index, length)
-      send_request FUNCTION_GET_RGBW_VALUES, [index, length], 'S C', 48, 'C12 C12 C12 C12'
+      check_validity
+
+      send_request FUNCTION_GET_RGBW_VALUES, [index, length], 'S C', 56, 'C12 C12 C12 C12'
     end
 
     # Sets the channel mapping for the connected LEDs.
@@ -326,18 +338,20 @@ module Tinkerforge
     # BrickletLEDStrip#set_rgbw_values has to be used. Calling BrickletLEDStrip#set_rgb_values with a
     # 4-channel mapping will produce incorrect results.
     # 
-    # The default value is BGR (36).
-    # 
     # .. versionadded:: 2.0.6$nbsp;(Plugin)
     def set_channel_mapping(mapping)
-      send_request FUNCTION_SET_CHANNEL_MAPPING, [mapping], 'C', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_CHANNEL_MAPPING, [mapping], 'C', 8, ''
     end
 
     # Returns the currently used channel mapping as set by BrickletLEDStrip#set_channel_mapping.
     # 
     # .. versionadded:: 2.0.6$nbsp;(Plugin)
     def get_channel_mapping
-      send_request FUNCTION_GET_CHANNEL_MAPPING, [], '', 1, 'C'
+      check_validity
+
+      send_request FUNCTION_GET_CHANNEL_MAPPING, [], '', 9, 'C'
     end
 
     # Enables the CALLBACK_FRAME_RENDERED callback.
@@ -346,7 +360,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.6$nbsp;(Plugin)
     def enable_frame_rendered_callback
-      send_request FUNCTION_ENABLE_FRAME_RENDERED_CALLBACK, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_ENABLE_FRAME_RENDERED_CALLBACK, [], '', 8, ''
     end
 
     # Disables the CALLBACK_FRAME_RENDERED callback.
@@ -355,26 +371,32 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.6$nbsp;(Plugin)
     def disable_frame_rendered_callback
-      send_request FUNCTION_DISABLE_FRAME_RENDERED_CALLBACK, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_DISABLE_FRAME_RENDERED_CALLBACK, [], '', 8, ''
     end
 
     # Returns *true* if the CALLBACK_FRAME_RENDERED callback is enabled, *false* otherwise.
     # 
     # .. versionadded:: 2.0.6$nbsp;(Plugin)
     def is_frame_rendered_callback_enabled
-      send_request FUNCTION_IS_FRAME_RENDERED_CALLBACK_ENABLED, [], '', 1, '?'
+      check_validity
+
+      send_request FUNCTION_IS_FRAME_RENDERED_CALLBACK_ENABLED, [], '', 9, '?'
     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 position can be 'a', 'b', 'c', 'd', 'e', 'f', 'g' or 'h' (Bricklet Port).
+    # A Bricklet connected to an :ref:`Isolator Bricklet <isolator_bricklet>` is always at
+    # position 'z'.
     # 
     # 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'
+      send_request FUNCTION_GET_IDENTITY, [], '', 33, 'Z8 Z8 k C3 C3 S'
     end
 
     # Registers a callback with ID <tt>id</tt> to the block <tt>block</tt>.