tinkerforge 2.1.24 → 2.1.25

data/lib/tinkerforge/bricklet_laser_range_finder_v2.rb

@@ -1,14 +1,16 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-11-25.      #
+# This file was automatically generated on 2020-04-07.      #
 #                                                           #
-# Ruby Bindings Version 2.1.24                              #
+# Ruby Bindings Version 2.1.25                              #
 #                                                           #
 # 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
   # Measures distance up to 40m with laser light
   class BrickletLaserRangeFinderV2 < Device
@@ -84,7 +86,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, 0]
 
@@ -117,9 +119,10 @@ module Tinkerforge
       @response_expected[FUNCTION_READ_UID] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[FUNCTION_GET_IDENTITY] = RESPONSE_EXPECTED_ALWAYS_TRUE
 
-      @callback_formats[CALLBACK_DISTANCE] = 's'
-      @callback_formats[CALLBACK_VELOCITY] = 's'
+      @callback_formats[CALLBACK_DISTANCE] = [10, 's']
+      @callback_formats[CALLBACK_VELOCITY] = [10, 's']
 
+      @ipcon.add_device self
     end
 
     # Returns the measured distance.
@@ -131,7 +134,9 @@ module Tinkerforge
     # CALLBACK_DISTANCE callback. You can set the callback configuration
     # with BrickletLaserRangeFinderV2#set_distance_callback_configuration.
     def get_distance
-      send_request FUNCTION_GET_DISTANCE, [], '', 2, 's'
+      check_validity
+
+      send_request FUNCTION_GET_DISTANCE, [], '', 10, 's'
     end
 
     # The period is the period with which the CALLBACK_DISTANCE callback is triggered
@@ -160,12 +165,16 @@ module Tinkerforge
     # 
     # If the option is set to 'x' (threshold turned off) the callback is triggered with the fixed period.
     def set_distance_callback_configuration(period, value_has_to_change, option, min, max)
-      send_request FUNCTION_SET_DISTANCE_CALLBACK_CONFIGURATION, [period, value_has_to_change, option, min, max], 'L ? k s s', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_DISTANCE_CALLBACK_CONFIGURATION, [period, value_has_to_change, option, min, max], 'L ? k s s', 8, ''
     end
 
     # Returns the callback configuration as set by BrickletLaserRangeFinderV2#set_distance_callback_configuration.
     def get_distance_callback_configuration
-      send_request FUNCTION_GET_DISTANCE_CALLBACK_CONFIGURATION, [], '', 10, 'L ? k s s'
+      check_validity
+
+      send_request FUNCTION_GET_DISTANCE_CALLBACK_CONFIGURATION, [], '', 18, 'L ? k s s'
     end
 
     # Returns the measured velocity. The value has a range of -12800 to 12700
@@ -180,7 +189,9 @@ module Tinkerforge
     # CALLBACK_VELOCITY callback. You can set the callback configuration
     # with BrickletLaserRangeFinderV2#set_velocity_callback_configuration.
     def get_velocity
-      send_request FUNCTION_GET_VELOCITY, [], '', 2, 's'
+      check_validity
+
+      send_request FUNCTION_GET_VELOCITY, [], '', 10, 's'
     end
 
     # The period is the period with which the CALLBACK_VELOCITY callback is triggered
@@ -209,12 +220,16 @@ module Tinkerforge
     # 
     # If the option is set to 'x' (threshold turned off) the callback is triggered with the fixed period.
     def set_velocity_callback_configuration(period, value_has_to_change, option, min, max)
-      send_request FUNCTION_SET_VELOCITY_CALLBACK_CONFIGURATION, [period, value_has_to_change, option, min, max], 'L ? k s s', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_VELOCITY_CALLBACK_CONFIGURATION, [period, value_has_to_change, option, min, max], 'L ? k s s', 8, ''
     end
 
     # Returns the callback configuration as set by BrickletLaserRangeFinderV2#set_velocity_callback_configuration.
     def get_velocity_callback_configuration
-      send_request FUNCTION_GET_VELOCITY_CALLBACK_CONFIGURATION, [], '', 10, 'L ? k s s'
+      check_validity
+
+      send_request FUNCTION_GET_VELOCITY_CALLBACK_CONFIGURATION, [], '', 18, 'L ? k s s'
     end
 
     # Enables the laser of the LIDAR if set to *true*.
@@ -222,12 +237,16 @@ module Tinkerforge
     # We recommend that you wait 250ms after enabling the laser before
     # the first call of BrickletLaserRangeFinderV2#get_distance to ensure stable measurements.
     def set_enable(enable)
-      send_request FUNCTION_SET_ENABLE, [enable], '?', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_ENABLE, [enable], '?', 8, ''
     end
 
     # Returns the value as set by BrickletLaserRangeFinderV2#set_enable.
     def get_enable
-      send_request FUNCTION_GET_ENABLE, [], '', 1, '?'
+      check_validity
+
+      send_request FUNCTION_GET_ENABLE, [], '', 9, '?'
     end
 
     # The **Acquisition Count** defines the number of times the Laser Range Finder Bricklet
@@ -247,7 +266,7 @@ module Tinkerforge
     # the distance to something with a very high reflection (e.g. mirror). Set this to 0 to
     # use the default algorithm. The other allowed values are 1-255.
     # 
-    # Set the **Measurement Frequency** in Hz to force a fixed measurement rate. If set to 0,
+    # Set the **Measurement Frequency** to force a fixed measurement rate. If set to 0,
     # the Laser Range Finder Bricklet will use the optimal frequency according to the other
     # configurations and the actual measured distance. Since the rate is not fixed in this case,
     # the velocity measurement is not stable. For a stable velocity measurement you should
@@ -258,12 +277,16 @@ module Tinkerforge
     # The default values for Acquisition Count, Enable Quick Termination, Threshold Value and
     # Measurement Frequency are 128, false, 0 and 0.
     def set_configuration(acquisition_count, enable_quick_termination, threshold_value, measurement_frequency)
-      send_request FUNCTION_SET_CONFIGURATION, [acquisition_count, enable_quick_termination, threshold_value, measurement_frequency], 'C ? C S', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_CONFIGURATION, [acquisition_count, enable_quick_termination, threshold_value, measurement_frequency], 'C ? C S', 8, ''
     end
 
     # Returns the configuration as set by BrickletLaserRangeFinderV2#set_configuration.
     def get_configuration
-      send_request FUNCTION_GET_CONFIGURATION, [], '', 5, 'C ? C S'
+      check_validity
+
+      send_request FUNCTION_GET_CONFIGURATION, [], '', 13, 'C ? C S'
     end
 
     # Sets the length of a `moving averaging <https://en.wikipedia.org/wiki/Moving_average>`__
@@ -272,12 +295,16 @@ module Tinkerforge
     # Setting the length to 0 will turn the averaging completely off. With less
     # averaging, there is more noise on the data.
     def set_moving_average(distance_average_length, velocity_average_length)
-      send_request FUNCTION_SET_MOVING_AVERAGE, [distance_average_length, velocity_average_length], 'C C', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_MOVING_AVERAGE, [distance_average_length, velocity_average_length], 'C C', 8, ''
     end
 
     # Returns the length moving average as set by BrickletLaserRangeFinderV2#set_moving_average.
     def get_moving_average
-      send_request FUNCTION_GET_MOVING_AVERAGE, [], '', 2, 'C C'
+      check_validity
+
+      send_request FUNCTION_GET_MOVING_AVERAGE, [], '', 10, 'C C'
     end
 
     # The offset is added to the measured distance.
@@ -290,23 +317,31 @@ module Tinkerforge
     # Calculate the offset by measuring the distance to a known distance
     # and set it again.
     def set_offset_calibration(offset)
-      send_request FUNCTION_SET_OFFSET_CALIBRATION, [offset], 's', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_OFFSET_CALIBRATION, [offset], 's', 8, ''
     end
 
     # Returns the offset value as set by BrickletLaserRangeFinderV2#set_offset_calibration.
     def get_offset_calibration
-      send_request FUNCTION_GET_OFFSET_CALIBRATION, [], '', 2, 's'
+      check_validity
+
+      send_request FUNCTION_GET_OFFSET_CALIBRATION, [], '', 10, 's'
     end
 
     # Configures the distance LED to be either turned off, turned on, blink in
     # heartbeat mode or show the distance (brighter = object is nearer).
     def set_distance_led_config(config)
-      send_request FUNCTION_SET_DISTANCE_LED_CONFIG, [config], 'C', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_DISTANCE_LED_CONFIG, [config], 'C', 8, ''
     end
 
     # Returns the LED configuration as set by BrickletLaserRangeFinderV2#set_distance_led_config
     def get_distance_led_config
-      send_request FUNCTION_GET_DISTANCE_LED_CONFIG, [], '', 1, 'C'
+      check_validity
+
+      send_request FUNCTION_GET_DISTANCE_LED_CONFIG, [], '', 9, 'C'
     end
 
     # Returns the error count for the communication between Brick and Bricklet.
@@ -321,7 +356,9 @@ module Tinkerforge
     # The errors counts are for errors that occur on the Bricklet side. All
     # Bricks have a similar function that returns the errors on the Brick side.
     def get_spitfp_error_count
-      send_request FUNCTION_GET_SPITFP_ERROR_COUNT, [], '', 16, 'L L L L'
+      check_validity
+
+      send_request FUNCTION_GET_SPITFP_ERROR_COUNT, [], '', 24, 'L L L L'
     end
 
     # Sets the bootloader mode and returns the status after the requested
@@ -334,12 +371,16 @@ module Tinkerforge
     # This function is used by Brick Viewer during flashing. It should not be
     # necessary to call it in a normal user program.
     def set_bootloader_mode(mode)
-      send_request FUNCTION_SET_BOOTLOADER_MODE, [mode], 'C', 1, 'C'
+      check_validity
+
+      send_request FUNCTION_SET_BOOTLOADER_MODE, [mode], 'C', 9, 'C'
     end
 
     # Returns the current bootloader mode, see BrickletLaserRangeFinderV2#set_bootloader_mode.
     def get_bootloader_mode
-      send_request FUNCTION_GET_BOOTLOADER_MODE, [], '', 1, 'C'
+      check_validity
+
+      send_request FUNCTION_GET_BOOTLOADER_MODE, [], '', 9, 'C'
     end
 
     # Sets the firmware pointer for BrickletLaserRangeFinderV2#write_firmware. The pointer has
@@ -349,7 +390,9 @@ module Tinkerforge
     # This function is used by Brick Viewer during flashing. It should not be
     # necessary to call it in a normal user program.
     def set_write_firmware_pointer(pointer)
-      send_request FUNCTION_SET_WRITE_FIRMWARE_POINTER, [pointer], 'L', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_WRITE_FIRMWARE_POINTER, [pointer], 'L', 8, ''
     end
 
     # Writes 64 Bytes of firmware at the position as written by
@@ -361,7 +404,9 @@ module Tinkerforge
     # This function is used by Brick Viewer during flashing. It should not be
     # necessary to call it in a normal user program.
     def write_firmware(data)
-      send_request FUNCTION_WRITE_FIRMWARE, [data], 'C64', 1, 'C'
+      check_validity
+
+      send_request FUNCTION_WRITE_FIRMWARE, [data], 'C64', 9, 'C'
     end
 
     # Sets the status LED configuration. By default the LED shows
@@ -372,22 +417,28 @@ module Tinkerforge
     # 
     # If the Bricklet is in bootloader mode, the LED is will show heartbeat by default.
     def set_status_led_config(config)
-      send_request FUNCTION_SET_STATUS_LED_CONFIG, [config], 'C', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_STATUS_LED_CONFIG, [config], 'C', 8, ''
     end
 
     # Returns the configuration as set by BrickletLaserRangeFinderV2#set_status_led_config
     def get_status_led_config
-      send_request FUNCTION_GET_STATUS_LED_CONFIG, [], '', 1, 'C'
+      check_validity
+
+      send_request FUNCTION_GET_STATUS_LED_CONFIG, [], '', 9, 'C'
     end
 
-    # Returns the temperature in °C as measured inside the microcontroller. The
+    # Returns the temperature as measured inside the microcontroller. The
     # value returned is not the ambient temperature!
     # 
     # The temperature is only proportional to the real temperature and it has bad
     # accuracy. Practically it is only useful as an indicator for
     # temperature changes.
     def get_chip_temperature
-      send_request FUNCTION_GET_CHIP_TEMPERATURE, [], '', 2, 's'
+      check_validity
+
+      send_request FUNCTION_GET_CHIP_TEMPERATURE, [], '', 10, 's'
     end
 
     # Calling this function will reset the Bricklet. All configurations
@@ -397,7 +448,9 @@ module Tinkerforge
     # calling functions on the existing ones will result in
     # undefined behavior!
     def reset
-      send_request FUNCTION_RESET, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_RESET, [], '', 8, ''
     end
 
     # Writes a new UID into flash. If you want to set a new UID
@@ -406,25 +459,32 @@ module Tinkerforge
     # 
     # We recommend that you use Brick Viewer to change the UID.
     def write_uid(uid)
-      send_request FUNCTION_WRITE_UID, [uid], 'L', 0, ''
+      check_validity
+
+      send_request FUNCTION_WRITE_UID, [uid], 'L', 8, ''
     end
 
     # Returns the current UID as an integer. Encode as
     # Base58 to get the usual string version.
     def read_uid
-      send_request FUNCTION_READ_UID, [], '', 4, 'L'
+      check_validity
+
+      send_request FUNCTION_READ_UID, [], '', 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).
+    # The Raspberry Pi HAT (Zero) Brick is always at position 'i' and the Bricklet
+    # connected to an :ref:`Isolator Bricklet <isolator_bricklet>` is always as
+    # 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_128x64.rb

@@ -1,14 +1,16 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-11-25.      #
+# This file was automatically generated on 2020-04-07.      #
 #                                                           #
-# Ruby Bindings Version 2.1.24                              #
+# Ruby Bindings Version 2.1.25                              #
 #                                                           #
 # 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
   # 7.1cm (2.8") display with 128x64 pixel and touch screen
   class BrickletLCD128x64 < Device
@@ -153,7 +155,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]
 
@@ -217,12 +219,13 @@ module Tinkerforge
       @response_expected[FUNCTION_READ_UID] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[FUNCTION_GET_IDENTITY] = RESPONSE_EXPECTED_ALWAYS_TRUE
 
-      @callback_formats[CALLBACK_TOUCH_POSITION] = 'S S S L'
-      @callback_formats[CALLBACK_TOUCH_GESTURE] = 'C L S S S S S L'
-      @callback_formats[CALLBACK_GUI_BUTTON_PRESSED] = 'C ?'
-      @callback_formats[CALLBACK_GUI_SLIDER_VALUE] = 'C C'
-      @callback_formats[CALLBACK_GUI_TAB_SELECTED] = 'c'
+      @callback_formats[CALLBACK_TOUCH_POSITION] = [18, 'S S S L']
+      @callback_formats[CALLBACK_TOUCH_GESTURE] = [27, 'C L S S S S S L']
+      @callback_formats[CALLBACK_GUI_BUTTON_PRESSED] = [10, 'C ?']
+      @callback_formats[CALLBACK_GUI_SLIDER_VALUE] = [10, 'C C']
+      @callback_formats[CALLBACK_GUI_TAB_SELECTED] = [9, 'c']
 
+      @ipcon.add_device self
     end
 
     # Writes pixels to the specified window.
@@ -242,7 +245,9 @@ module Tinkerforge
     # Automatic draw can be configured with the BrickletLCD128x64#set_display_configuration
     # function.
     def write_pixels_low_level(x_start, y_start, x_end, y_end, pixels_length, pixels_chunk_offset, pixels_chunk_data)
-      send_request FUNCTION_WRITE_PIXELS_LOW_LEVEL, [x_start, y_start, x_end, y_end, pixels_length, pixels_chunk_offset, pixels_chunk_data], 'C C C C S S ?448', 0, ''
+      check_validity
+
+      send_request FUNCTION_WRITE_PIXELS_LOW_LEVEL, [x_start, y_start, x_end, y_end, pixels_length, pixels_chunk_offset, pixels_chunk_data], 'C C C C S S ?448', 8, ''
     end
 
     # Reads pixels from the specified window.
@@ -259,7 +264,9 @@ module Tinkerforge
     # Automatic draw can be configured with the BrickletLCD128x64#set_display_configuration
     # function.
     def read_pixels_low_level(x_start, y_start, x_end, y_end)
-      send_request FUNCTION_READ_PIXELS_LOW_LEVEL, [x_start, y_start, x_end, y_end], 'C C C C', 484, 'S S ?480'
+      check_validity
+
+      send_request FUNCTION_READ_PIXELS_LOW_LEVEL, [x_start, y_start, x_end, y_end], 'C C C C', 72, 'S S ?480'
     end
 
     # Clears the complete content of the display.
@@ -274,7 +281,9 @@ module Tinkerforge
     # Automatic draw can be configured with the BrickletLCD128x64#set_display_configuration
     # function.
     def clear_display
-      send_request FUNCTION_CLEAR_DISPLAY, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_CLEAR_DISPLAY, [], '', 8, ''
     end
 
     # Sets the configuration of the display.
@@ -284,12 +293,16 @@ module Tinkerforge
     # changes are written into an internal buffer and only shown on the display after
     # a call of BrickletLCD128x64#draw_buffered_frame.
     def set_display_configuration(contrast, backlight, invert, automatic_draw)
-      send_request FUNCTION_SET_DISPLAY_CONFIGURATION, [contrast, backlight, invert, automatic_draw], 'C C ? ?', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_DISPLAY_CONFIGURATION, [contrast, backlight, invert, automatic_draw], 'C C ? ?', 8, ''
     end
 
     # Returns the configuration as set by BrickletLCD128x64#set_display_configuration.
     def get_display_configuration
-      send_request FUNCTION_GET_DISPLAY_CONFIGURATION, [], '', 4, 'C C ? ?'
+      check_validity
+
+      send_request FUNCTION_GET_DISPLAY_CONFIGURATION, [], '', 12, 'C C ? ?'
     end
 
     # Writes text to a specific line with a specific position.
@@ -316,7 +329,9 @@ module Tinkerforge
     # in the LCD 20x4 Bricklet. You can draw text at a specific pixel position
     # and with different font sizes with the BrickletLCD128x64#draw_text function.
     def write_line(line, position, text)
-      send_request FUNCTION_WRITE_LINE, [line, position, text], 'C C Z22', 0, ''
+      check_validity
+
+      send_request FUNCTION_WRITE_LINE, [line, position, text], 'C C Z22', 8, ''
     end
 
     # Draws the currently buffered frame. Normally each call of BrickletLCD128x64#write_pixels and
@@ -329,7 +344,9 @@ module Tinkerforge
     # instead of only the changed parts. Normally it should not be necessary to set this to
     # *true*. It may only become necessary in case of stuck pixels because of errors.
     def draw_buffered_frame(force_complete_redraw)
-      send_request FUNCTION_DRAW_BUFFERED_FRAME, [force_complete_redraw], '?', 0, ''
+      check_validity
+
+      send_request FUNCTION_DRAW_BUFFERED_FRAME, [force_complete_redraw], '?', 8, ''
     end
 
     # Returns the last valid touch position:
@@ -337,9 +354,11 @@ module Tinkerforge
     # * Pressure: Amount of pressure applied by the user
     # * X: Touch position on x-axis
     # * Y: Touch position on y-axis
-    # * Age: Age of touch press in ms (how long ago it was)
+    # * Age: Age of touch press (how long ago it was)
     def get_touch_position
-      send_request FUNCTION_GET_TOUCH_POSITION, [], '', 10, 'S S S L'
+      check_validity
+
+      send_request FUNCTION_GET_TOUCH_POSITION, [], '', 18, 'S S S L'
     end
 
     # The period is the period with which the CALLBACK_TOUCH_POSITION callback
@@ -352,13 +371,17 @@ module Tinkerforge
     # If it is set to false, the callback is continuously triggered with the period,
     # independent of the value.
     def set_touch_position_callback_configuration(period, value_has_to_change)
-      send_request FUNCTION_SET_TOUCH_POSITION_CALLBACK_CONFIGURATION, [period, value_has_to_change], 'L ?', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_TOUCH_POSITION_CALLBACK_CONFIGURATION, [period, value_has_to_change], 'L ?', 8, ''
     end
 
     # Returns the callback configuration as set by
     # BrickletLCD128x64#set_touch_position_callback_configuration.
     def get_touch_position_callback_configuration
-      send_request FUNCTION_GET_TOUCH_POSITION_CALLBACK_CONFIGURATION, [], '', 5, 'L ?'
+      check_validity
+
+      send_request FUNCTION_GET_TOUCH_POSITION_CALLBACK_CONFIGURATION, [], '', 13, 'L ?'
     end
 
     # Returns one of four touch gestures that can be automatically detected by the Bricklet.
@@ -371,7 +394,9 @@ module Tinkerforge
     # 
     # The age parameter corresponds to the age of gesture (how long ago it was).
     def get_touch_gesture
-      send_request FUNCTION_GET_TOUCH_GESTURE, [], '', 19, 'C L S S S S S L'
+      check_validity
+
+      send_request FUNCTION_GET_TOUCH_GESTURE, [], '', 27, 'C L S S S S S L'
     end
 
     # The period is the period with which the CALLBACK_TOUCH_GESTURE callback
@@ -384,20 +409,26 @@ module Tinkerforge
     # If it is set to false, the callback is continuously triggered with the period,
     # independent of the value.
     def set_touch_gesture_callback_configuration(period, value_has_to_change)
-      send_request FUNCTION_SET_TOUCH_GESTURE_CALLBACK_CONFIGURATION, [period, value_has_to_change], 'L ?', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_TOUCH_GESTURE_CALLBACK_CONFIGURATION, [period, value_has_to_change], 'L ?', 8, ''
     end
 
     # Returns the callback configuration as set by
     # BrickletLCD128x64#set_touch_gesture_callback_configuration.
     def get_touch_gesture_callback_configuration
-      send_request FUNCTION_GET_TOUCH_GESTURE_CALLBACK_CONFIGURATION, [], '', 5, 'L ?'
+      check_validity
+
+      send_request FUNCTION_GET_TOUCH_GESTURE_CALLBACK_CONFIGURATION, [], '', 13, 'L ?'
     end
 
     # Draws a white or black line from (x, y)-start to (x, y)-end.
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def draw_line(position_x_start, position_y_start, position_x_end, position_y_end, color)
-      send_request FUNCTION_DRAW_LINE, [position_x_start, position_y_start, position_x_end, position_y_end, color], 'C C C C ?', 0, ''
+      check_validity
+
+      send_request FUNCTION_DRAW_LINE, [position_x_start, position_y_start, position_x_end, position_y_end, color], 'C C C C ?', 8, ''
     end
 
     # Draws a white or black box from (x, y)-start to (x, y)-end.
@@ -407,7 +438,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def draw_box(position_x_start, position_y_start, position_x_end, position_y_end, fill, color)
-      send_request FUNCTION_DRAW_BOX, [position_x_start, position_y_start, position_x_end, position_y_end, fill, color], 'C C C C ? ?', 0, ''
+      check_validity
+
+      send_request FUNCTION_DRAW_BOX, [position_x_start, position_y_start, position_x_end, position_y_end, fill, color], 'C C C C ? ?', 8, ''
     end
 
     # Draws a text at the pixel position (x, y).
@@ -416,7 +449,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def draw_text(position_x, position_y, font, color, text)
-      send_request FUNCTION_DRAW_TEXT, [position_x, position_y, font, color, text], 'C C C ? Z22', 0, ''
+      check_validity
+
+      send_request FUNCTION_DRAW_TEXT, [position_x, position_y, font, color, text], 'C C C ? Z22', 8, ''
     end
 
     # Draws a clickable button at position (x, y) with the given text.
@@ -441,7 +476,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def set_gui_button(index, position_x, position_y, width, height, text)
-      send_request FUNCTION_SET_GUI_BUTTON, [index, position_x, position_y, width, height, text], 'C C C C C Z16', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_GUI_BUTTON, [index, position_x, position_y, width, height, text], 'C C C C C Z16', 8, ''
     end
 
     # Returns the button properties for a given `Index` as set by BrickletLCD128x64#set_gui_button.
@@ -451,7 +488,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_gui_button(index)
-      send_request FUNCTION_GET_GUI_BUTTON, [index], 'C', 21, '? C C C C Z16'
+      check_validity
+
+      send_request FUNCTION_GET_GUI_BUTTON, [index], 'C', 29, '? C C C C Z16'
     end
 
     # Removes the button with the given index.
@@ -460,7 +499,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def remove_gui_button(index)
-      send_request FUNCTION_REMOVE_GUI_BUTTON, [index], 'C', 0, ''
+      check_validity
+
+      send_request FUNCTION_REMOVE_GUI_BUTTON, [index], 'C', 8, ''
     end
 
     # The period is the period with which the CALLBACK_GUI_BUTTON_PRESSED callback
@@ -475,7 +516,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def set_gui_button_pressed_callback_configuration(period, value_has_to_change)
-      send_request FUNCTION_SET_GUI_BUTTON_PRESSED_CALLBACK_CONFIGURATION, [period, value_has_to_change], 'L ?', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_GUI_BUTTON_PRESSED_CALLBACK_CONFIGURATION, [period, value_has_to_change], 'L ?', 8, ''
     end
 
     # Returns the callback configuration as set by
@@ -483,7 +526,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_gui_button_pressed_callback_configuration
-      send_request FUNCTION_GET_GUI_BUTTON_PRESSED_CALLBACK_CONFIGURATION, [], '', 5, 'L ?'
+      check_validity
+
+      send_request FUNCTION_GET_GUI_BUTTON_PRESSED_CALLBACK_CONFIGURATION, [], '', 13, 'L ?'
     end
 
     # Returns the state of the button for the given index.
@@ -492,7 +537,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_gui_button_pressed(index)
-      send_request FUNCTION_GET_GUI_BUTTON_PRESSED, [index], 'C', 1, '?'
+      check_validity
+
+      send_request FUNCTION_GET_GUI_BUTTON_PRESSED, [index], 'C', 9, '?'
     end
 
     # Draws a slider at position (x, y) with the given length.
@@ -521,7 +568,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def set_gui_slider(index, position_x, position_y, length, direction, value)
-      send_request FUNCTION_SET_GUI_SLIDER, [index, position_x, position_y, length, direction, value], 'C C C C C C', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_GUI_SLIDER, [index, position_x, position_y, length, direction, value], 'C C C C C C', 8, ''
     end
 
     # Returns the slider properties for a given `Index` as set by BrickletLCD128x64#set_gui_slider.
@@ -531,7 +580,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_gui_slider(index)
-      send_request FUNCTION_GET_GUI_SLIDER, [index], 'C', 6, '? C C C C C'
+      check_validity
+
+      send_request FUNCTION_GET_GUI_SLIDER, [index], 'C', 14, '? C C C C C'
     end
 
     # Removes the slider with the given index.
@@ -540,7 +591,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def remove_gui_slider(index)
-      send_request FUNCTION_REMOVE_GUI_SLIDER, [index], 'C', 0, ''
+      check_validity
+
+      send_request FUNCTION_REMOVE_GUI_SLIDER, [index], 'C', 8, ''
     end
 
     # The period is the period with which the CALLBACK_GUI_SLIDER_VALUE callback
@@ -555,7 +608,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def set_gui_slider_value_callback_configuration(period, value_has_to_change)
-      send_request FUNCTION_SET_GUI_SLIDER_VALUE_CALLBACK_CONFIGURATION, [period, value_has_to_change], 'L ?', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_GUI_SLIDER_VALUE_CALLBACK_CONFIGURATION, [period, value_has_to_change], 'L ?', 8, ''
     end
 
     # Returns the callback configuration as set by
@@ -563,14 +618,18 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_gui_slider_value_callback_configuration
-      send_request FUNCTION_GET_GUI_SLIDER_VALUE_CALLBACK_CONFIGURATION, [], '', 5, 'L ?'
+      check_validity
+
+      send_request FUNCTION_GET_GUI_SLIDER_VALUE_CALLBACK_CONFIGURATION, [], '', 13, 'L ?'
     end
 
     # Returns the current slider value for the given index.
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_gui_slider_value(index)
-      send_request FUNCTION_GET_GUI_SLIDER_VALUE, [index], 'C', 1, 'C'
+      check_validity
+
+      send_request FUNCTION_GET_GUI_SLIDER_VALUE, [index], 'C', 9, 'C'
     end
 
     # Sets the general configuration for tabs. You can configure the tabs to only
@@ -581,14 +640,18 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def set_gui_tab_configuration(change_tab_config, clear_gui)
-      send_request FUNCTION_SET_GUI_TAB_CONFIGURATION, [change_tab_config, clear_gui], 'C ?', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_GUI_TAB_CONFIGURATION, [change_tab_config, clear_gui], 'C ?', 8, ''
     end
 
     # Returns the tab configuration as set by BrickletLCD128x64#set_gui_tab_configuration.
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_gui_tab_configuration
-      send_request FUNCTION_GET_GUI_TAB_CONFIGURATION, [], '', 2, 'C ?'
+      check_validity
+
+      send_request FUNCTION_GET_GUI_TAB_CONFIGURATION, [], '', 10, 'C ?'
     end
 
     # Adds a text-tab with the given index.
@@ -599,7 +662,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def set_gui_tab_text(index, text)
-      send_request FUNCTION_SET_GUI_TAB_TEXT, [index, text], 'C Z5', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_GUI_TAB_TEXT, [index, text], 'C Z5', 8, ''
     end
 
     # Returns the text for a given index as set by BrickletLCD128x64#set_gui_tab_text.
@@ -609,7 +674,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_gui_tab_text(index)
-      send_request FUNCTION_GET_GUI_TAB_TEXT, [index], 'C', 6, '? Z5'
+      check_validity
+
+      send_request FUNCTION_GET_GUI_TAB_TEXT, [index], 'C', 14, '? Z5'
     end
 
     # Adds a icon-tab with the given index. The icon can have a width of 28 pixels
@@ -621,7 +688,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def set_gui_tab_icon(index, icon)
-      send_request FUNCTION_SET_GUI_TAB_ICON, [index, icon], 'C ?168', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_GUI_TAB_ICON, [index, icon], 'C ?168', 8, ''
     end
 
     # Returns the icon for a given index as set by BrickletLCD128x64#set_gui_tab_icon.
@@ -631,7 +700,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_gui_tab_icon(index)
-      send_request FUNCTION_GET_GUI_TAB_ICON, [index], 'C', 169, '? ?168'
+      check_validity
+
+      send_request FUNCTION_GET_GUI_TAB_ICON, [index], 'C', 30, '? ?168'
     end
 
     # Removes the tab with the given index.
@@ -640,14 +711,18 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def remove_gui_tab(index)
-      send_request FUNCTION_REMOVE_GUI_TAB, [index], 'C', 0, ''
+      check_validity
+
+      send_request FUNCTION_REMOVE_GUI_TAB, [index], 'C', 8, ''
     end
 
     # Sets the tab with the given index as selected (drawn as selected on the display).
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def set_gui_tab_selected(index)
-      send_request FUNCTION_SET_GUI_TAB_SELECTED, [index], 'C', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_GUI_TAB_SELECTED, [index], 'C', 8, ''
     end
 
     # The period is the period with which the CALLBACK_GUI_TAB_SELECTED callback
@@ -662,7 +737,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def set_gui_tab_selected_callback_configuration(period, value_has_to_change)
-      send_request FUNCTION_SET_GUI_TAB_SELECTED_CALLBACK_CONFIGURATION, [period, value_has_to_change], 'L ?', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_GUI_TAB_SELECTED_CALLBACK_CONFIGURATION, [period, value_has_to_change], 'L ?', 8, ''
     end
 
     # Returns the callback configuration as set by
@@ -670,7 +747,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_gui_tab_selected_callback_configuration
-      send_request FUNCTION_GET_GUI_TAB_SELECTED_CALLBACK_CONFIGURATION, [], '', 5, 'L ?'
+      check_validity
+
+      send_request FUNCTION_GET_GUI_TAB_SELECTED_CALLBACK_CONFIGURATION, [], '', 13, 'L ?'
     end
 
     # Returns the index of the currently selected tab.
@@ -678,7 +757,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_gui_tab_selected
-      send_request FUNCTION_GET_GUI_TAB_SELECTED, [], '', 1, 'c'
+      check_validity
+
+      send_request FUNCTION_GET_GUI_TAB_SELECTED, [], '', 9, 'c'
     end
 
     # Sets the configuration for up to four graphs.
@@ -701,7 +782,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def set_gui_graph_configuration(index, graph_type, position_x, position_y, width, height, text_x, text_y)
-      send_request FUNCTION_SET_GUI_GRAPH_CONFIGURATION, [index, graph_type, position_x, position_y, width, height, text_x, text_y], 'C C C C C C Z4 Z4', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_GUI_GRAPH_CONFIGURATION, [index, graph_type, position_x, position_y, width, height, text_x, text_y], 'C C C C C C Z4 Z4', 8, ''
     end
 
     # Returns the graph properties for a given `Index` as set by BrickletLCD128x64#set_gui_graph_configuration.
@@ -711,7 +794,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_gui_graph_configuration(index)
-      send_request FUNCTION_GET_GUI_GRAPH_CONFIGURATION, [index], 'C', 14, '? C C C C C Z4 Z4'
+      check_validity
+
+      send_request FUNCTION_GET_GUI_GRAPH_CONFIGURATION, [index], 'C', 22, '? C C C C C Z4 Z4'
     end
 
     # Sets the data for a graph with the given index. You have to configure the graph with
@@ -729,14 +814,18 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def set_gui_graph_data_low_level(index, data_length, data_chunk_offset, data_chunk_data)
-      send_request FUNCTION_SET_GUI_GRAPH_DATA_LOW_LEVEL, [index, data_length, data_chunk_offset, data_chunk_data], 'C S S C59', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_GUI_GRAPH_DATA_LOW_LEVEL, [index, data_length, data_chunk_offset, data_chunk_data], 'C S S C59', 8, ''
     end
 
     # Returns the graph data for a given index as set by BrickletLCD128x64#set_gui_graph_data.
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_gui_graph_data_low_level(index)
-      send_request FUNCTION_GET_GUI_GRAPH_DATA_LOW_LEVEL, [index], 'C', 63, 'S S C59'
+      check_validity
+
+      send_request FUNCTION_GET_GUI_GRAPH_DATA_LOW_LEVEL, [index], 'C', 71, 'S S C59'
     end
 
     # Removes the graph with the given index.
@@ -745,14 +834,18 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def remove_gui_graph(index)
-      send_request FUNCTION_REMOVE_GUI_GRAPH, [index], 'C', 0, ''
+      check_validity
+
+      send_request FUNCTION_REMOVE_GUI_GRAPH, [index], 'C', 8, ''
     end
 
     # Removes all GUI elements (buttons, slider, graphs, tabs).
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def remove_all_gui
-      send_request FUNCTION_REMOVE_ALL_GUI, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_REMOVE_ALL_GUI, [], '', 8, ''
     end
 
     # Sets the touch LED configuration. By default the LED is on if the
@@ -764,14 +857,18 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def set_touch_led_config(config)
-      send_request FUNCTION_SET_TOUCH_LED_CONFIG, [config], 'C', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_TOUCH_LED_CONFIG, [config], 'C', 8, ''
     end
 
     # Returns the configuration as set by BrickletLCD128x64#set_touch_led_config
     # 
     # .. versionadded:: 2.0.2$nbsp;(Plugin)
     def get_touch_led_config
-      send_request FUNCTION_GET_TOUCH_LED_CONFIG, [], '', 1, 'C'
+      check_validity
+
+      send_request FUNCTION_GET_TOUCH_LED_CONFIG, [], '', 9, 'C'
     end
 
     # Returns the error count for the communication between Brick and Bricklet.
@@ -786,7 +883,9 @@ module Tinkerforge
     # The errors counts are for errors that occur on the Bricklet side. All
     # Bricks have a similar function that returns the errors on the Brick side.
     def get_spitfp_error_count
-      send_request FUNCTION_GET_SPITFP_ERROR_COUNT, [], '', 16, 'L L L L'
+      check_validity
+
+      send_request FUNCTION_GET_SPITFP_ERROR_COUNT, [], '', 24, 'L L L L'
     end
 
     # Sets the bootloader mode and returns the status after the requested
@@ -799,12 +898,16 @@ module Tinkerforge
     # This function is used by Brick Viewer during flashing. It should not be
     # necessary to call it in a normal user program.
     def set_bootloader_mode(mode)
-      send_request FUNCTION_SET_BOOTLOADER_MODE, [mode], 'C', 1, 'C'
+      check_validity
+
+      send_request FUNCTION_SET_BOOTLOADER_MODE, [mode], 'C', 9, 'C'
     end
 
     # Returns the current bootloader mode, see BrickletLCD128x64#set_bootloader_mode.
     def get_bootloader_mode
-      send_request FUNCTION_GET_BOOTLOADER_MODE, [], '', 1, 'C'
+      check_validity
+
+      send_request FUNCTION_GET_BOOTLOADER_MODE, [], '', 9, 'C'
     end
 
     # Sets the firmware pointer for BrickletLCD128x64#write_firmware. The pointer has
@@ -814,7 +917,9 @@ module Tinkerforge
     # This function is used by Brick Viewer during flashing. It should not be
     # necessary to call it in a normal user program.
     def set_write_firmware_pointer(pointer)
-      send_request FUNCTION_SET_WRITE_FIRMWARE_POINTER, [pointer], 'L', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_WRITE_FIRMWARE_POINTER, [pointer], 'L', 8, ''
     end
 
     # Writes 64 Bytes of firmware at the position as written by
@@ -826,7 +931,9 @@ module Tinkerforge
     # This function is used by Brick Viewer during flashing. It should not be
     # necessary to call it in a normal user program.
     def write_firmware(data)
-      send_request FUNCTION_WRITE_FIRMWARE, [data], 'C64', 1, 'C'
+      check_validity
+
+      send_request FUNCTION_WRITE_FIRMWARE, [data], 'C64', 9, 'C'
     end
 
     # Sets the status LED configuration. By default the LED shows
@@ -837,22 +944,28 @@ module Tinkerforge
     # 
     # If the Bricklet is in bootloader mode, the LED is will show heartbeat by default.
     def set_status_led_config(config)
-      send_request FUNCTION_SET_STATUS_LED_CONFIG, [config], 'C', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_STATUS_LED_CONFIG, [config], 'C', 8, ''
     end
 
     # Returns the configuration as set by BrickletLCD128x64#set_status_led_config
     def get_status_led_config
-      send_request FUNCTION_GET_STATUS_LED_CONFIG, [], '', 1, 'C'
+      check_validity
+
+      send_request FUNCTION_GET_STATUS_LED_CONFIG, [], '', 9, 'C'
     end
 
-    # Returns the temperature in °C as measured inside the microcontroller. The
+    # Returns the temperature as measured inside the microcontroller. The
     # value returned is not the ambient temperature!
     # 
     # The temperature is only proportional to the real temperature and it has bad
     # accuracy. Practically it is only useful as an indicator for
     # temperature changes.
     def get_chip_temperature
-      send_request FUNCTION_GET_CHIP_TEMPERATURE, [], '', 2, 's'
+      check_validity
+
+      send_request FUNCTION_GET_CHIP_TEMPERATURE, [], '', 10, 's'
     end
 
     # Calling this function will reset the Bricklet. All configurations
@@ -862,7 +975,9 @@ module Tinkerforge
     # calling functions on the existing ones will result in
     # undefined behavior!
     def reset
-      send_request FUNCTION_RESET, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_RESET, [], '', 8, ''
     end
 
     # Writes a new UID into flash. If you want to set a new UID
@@ -871,25 +986,32 @@ module Tinkerforge
     # 
     # We recommend that you use Brick Viewer to change the UID.
     def write_uid(uid)
-      send_request FUNCTION_WRITE_UID, [uid], 'L', 0, ''
+      check_validity
+
+      send_request FUNCTION_WRITE_UID, [uid], 'L', 8, ''
     end
 
     # Returns the current UID as an integer. Encode as
     # Base58 to get the usual string version.
     def read_uid
-      send_request FUNCTION_READ_UID, [], '', 4, 'L'
+      check_validity
+
+      send_request FUNCTION_READ_UID, [], '', 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).
+    # The Raspberry Pi HAT (Zero) Brick is always at position 'i' and the Bricklet
+    # connected to an :ref:`Isolator Bricklet <isolator_bricklet>` is always as
+    # 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
 
     # Writes pixels to the specified window.