tinkerforge 2.1.24 → 2.1.29

data/lib/tinkerforge/bricklet_lcd_16x2.rb

@@ -1,14 +1,16 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-11-25.      #
+# This file was automatically generated on 2021-05-06.      #
 #                                                           #
-# Ruby Bindings Version 2.1.24                              #
+# Ruby Bindings Version 2.1.29                              #
 #                                                           #
 # 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
@@ -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,9 +57,10 @@ 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 with a specific position.
@@ -72,27 +75,37 @@ 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
@@ -100,12 +113,16 @@ module Tinkerforge
     # is one character behind the the last text written with
     # BrickletLCD16x2#write_line.
     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 is pressed.
@@ -113,7 +130,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 16x2 Bricklet can store up to 8 custom characters. The characters
@@ -131,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.
@@ -141,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
@@ -149,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-11-25.      #
+# This file was automatically generated on 2021-05-06.      #
 #                                                           #
-# Ruby Bindings Version 2.1.24                              #
+# Ruby Bindings Version 2.1.29                              #
 #                                                           #
 # 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,9 +65,10 @@ 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 with a specific position.
@@ -80,27 +83,37 @@ 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
@@ -108,12 +121,16 @@ module Tinkerforge
     # is one character behind the the last text written with
     # BrickletLCD20x4#write_line.
     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)
@@ -122,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
@@ -140,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.
@@ -150,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
@@ -158,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
@@ -169,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
@@ -177,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,26 +224,32 @@ module Tinkerforge
     # 
     # .. 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-11-25.      #
+# This file was automatically generated on 2021-05-06.      #
 #                                                           #
-# Ruby Bindings Version 2.1.24                              #
+# Ruby Bindings Version 2.1.29                              #
 #                                                           #
 # 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
@@ -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,8 +105,9 @@ 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 *length* RGB values for the LEDs starting from *index*.
@@ -146,7 +149,9 @@ 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 *length* R, G and B values starting from the
@@ -154,7 +159,9 @@ module Tinkerforge
     # 
     # 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.
@@ -164,17 +171,23 @@ module Tinkerforge
     # 
     # For an explanation of the general approach see BrickletLEDStrip#set_rgb_values.
     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 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.
     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.
@@ -195,14 +208,18 @@ module Tinkerforge
     # 
     # .. 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
@@ -216,14 +233,18 @@ module Tinkerforge
     # 
     # .. 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 *length* RGBW values for the LEDs starting from *index*.
@@ -281,7 +302,9 @@ 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 *length* RGBW values starting from the given *index*.
@@ -290,7 +313,9 @@ module Tinkerforge
     # 
     # .. 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.
@@ -315,14 +340,18 @@ module Tinkerforge
     # 
     # .. 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.
@@ -331,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.
@@ -340,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>.