tinkerforge 2.1.24 → 2.1.25

data/lib/tinkerforge/brick_stepper.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
   # Drives one bipolar stepper motor with up to 38V and 2.5A per phase
   class BrickStepper < Device
@@ -16,8 +18,7 @@ module Tinkerforge
     DEVICE_DISPLAY_NAME = 'Stepper Brick' # :nodoc:
 
     # This callback is triggered when the input voltage drops below the value set by
-    # BrickStepper#set_minimum_voltage. The parameter is the current voltage given
-    # in mV.
+    # BrickStepper#set_minimum_voltage. The parameter is the current voltage.
     CALLBACK_UNDER_VOLTAGE = 31
 
     # This callback is triggered when a position set by BrickStepper#set_steps or
@@ -89,6 +90,8 @@ module Tinkerforge
     FUNCTION_GET_PROTOCOL1_BRICKLET_NAME = 241 # :nodoc:
     FUNCTION_GET_CHIP_TEMPERATURE = 242 # :nodoc:
     FUNCTION_RESET = 243 # :nodoc:
+    FUNCTION_WRITE_BRICKLET_PLUGIN = 246 # :nodoc:
+    FUNCTION_READ_BRICKLET_PLUGIN = 247 # :nodoc:
     FUNCTION_GET_IDENTITY = 255 # :nodoc:
 
     STEP_MODE_FULL_STEP = 1 # :nodoc:
@@ -113,7 +116,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, 4]
 
@@ -166,36 +169,45 @@ module Tinkerforge
       @response_expected[FUNCTION_GET_PROTOCOL1_BRICKLET_NAME] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[FUNCTION_GET_CHIP_TEMPERATURE] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[FUNCTION_RESET] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_WRITE_BRICKLET_PLUGIN] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_READ_BRICKLET_PLUGIN] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[FUNCTION_GET_IDENTITY] = RESPONSE_EXPECTED_ALWAYS_TRUE
 
-      @callback_formats[CALLBACK_UNDER_VOLTAGE] = 'S'
-      @callback_formats[CALLBACK_POSITION_REACHED] = 'l'
-      @callback_formats[CALLBACK_ALL_DATA] = 'S l l S S S'
-      @callback_formats[CALLBACK_NEW_STATE] = 'C C'
+      @callback_formats[CALLBACK_UNDER_VOLTAGE] = [10, 'S']
+      @callback_formats[CALLBACK_POSITION_REACHED] = [12, 'l']
+      @callback_formats[CALLBACK_ALL_DATA] = [24, 'S l l S S S']
+      @callback_formats[CALLBACK_NEW_STATE] = [10, 'C C']
 
+      @ipcon.add_device self
     end
 
-    # Sets the maximum velocity of the stepper motor in steps per second.
+    # Sets the maximum velocity of the stepper motor.
     # This function does *not* start the motor, it merely sets the maximum
     # velocity the stepper motor is accelerated to. To get the motor running use
     # either BrickStepper#set_target_position, BrickStepper#set_steps, BrickStepper#drive_forward or
     # BrickStepper#drive_backward.
     def set_max_velocity(velocity)
-      send_request FUNCTION_SET_MAX_VELOCITY, [velocity], 'S', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_MAX_VELOCITY, [velocity], 'S', 8, ''
     end
 
     # Returns the velocity as set by BrickStepper#set_max_velocity.
     def get_max_velocity
-      send_request FUNCTION_GET_MAX_VELOCITY, [], '', 2, 'S'
+      check_validity
+
+      send_request FUNCTION_GET_MAX_VELOCITY, [], '', 10, 'S'
     end
 
-    # Returns the *current* velocity of the stepper motor in steps per second.
+    # Returns the *current* velocity of the stepper motor.
     def get_current_velocity
-      send_request FUNCTION_GET_CURRENT_VELOCITY, [], '', 2, 'S'
+      check_validity
+
+      send_request FUNCTION_GET_CURRENT_VELOCITY, [], '', 10, 'S'
     end
 
-    # Sets the acceleration and deacceleration of the stepper motor. The values
-    # are given in *steps/s²*. An acceleration of 1000 means, that
+    # Sets the acceleration and deacceleration of the stepper motor.
+    # An acceleration of 1000 means, that
     # every second the velocity is increased by 1000 *steps/s*.
     # 
     # For example: If the current velocity is 0 and you want to accelerate to a
@@ -204,16 +216,18 @@ module Tinkerforge
     # 
     # An acceleration/deacceleration of 0 means instantaneous
     # acceleration/deacceleration (not recommended)
-    # 
-    # The default value is 1000 for both
     def set_speed_ramping(acceleration, deacceleration)
-      send_request FUNCTION_SET_SPEED_RAMPING, [acceleration, deacceleration], 'S S', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_SPEED_RAMPING, [acceleration, deacceleration], 'S S', 8, ''
     end
 
     # Returns the acceleration and deacceleration as set by
     # BrickStepper#set_speed_ramping.
     def get_speed_ramping
-      send_request FUNCTION_GET_SPEED_RAMPING, [], '', 4, 'S S'
+      check_validity
+
+      send_request FUNCTION_GET_SPEED_RAMPING, [], '', 12, 'S S'
     end
 
     # Executes an active full brake.
@@ -225,14 +239,18 @@ module Tinkerforge
     # 
     # Call BrickStepper#stop if you just want to stop the motor.
     def full_brake
-      send_request FUNCTION_FULL_BRAKE, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_FULL_BRAKE, [], '', 8, ''
     end
 
     # Sets the current steps of the internal step counter. This can be used to
     # set the current position to 0 when some kind of starting position
     # is reached (e.g. when a CNC machine reaches a corner).
     def set_current_position(position)
-      send_request FUNCTION_SET_CURRENT_POSITION, [position], 'l', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_CURRENT_POSITION, [position], 'l', 8, ''
     end
 
     # Returns the current position of the stepper motor in steps. On startup
@@ -241,7 +259,9 @@ module Tinkerforge
     # BrickStepper#drive_backward). It also is possible to reset the steps to 0 or
     # set them to any other desired value with BrickStepper#set_current_position.
     def get_current_position
-      send_request FUNCTION_GET_CURRENT_POSITION, [], '', 4, 'l'
+      check_validity
+
+      send_request FUNCTION_GET_CURRENT_POSITION, [], '', 12, 'l'
     end
 
     # Sets the target position of the stepper motor in steps. For example,
@@ -254,12 +274,16 @@ module Tinkerforge
     # a call of BrickStepper#set_steps with the parameter
     # (*x* - BrickStepper#get_current_position).
     def set_target_position(position)
-      send_request FUNCTION_SET_TARGET_POSITION, [position], 'l', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_TARGET_POSITION, [position], 'l', 8, ''
     end
 
     # Returns the last target position as set by BrickStepper#set_target_position.
     def get_target_position
-      send_request FUNCTION_GET_TARGET_POSITION, [], '', 4, 'l'
+      check_validity
+
+      send_request FUNCTION_GET_TARGET_POSITION, [], '', 12, 'l'
     end
 
     # Sets the number of steps the stepper motor should run. Positive values
@@ -267,12 +291,16 @@ module Tinkerforge
     # The velocity, acceleration and deacceleration as set by
     # BrickStepper#set_max_velocity and BrickStepper#set_speed_ramping will be used.
     def set_steps(steps)
-      send_request FUNCTION_SET_STEPS, [steps], 'l', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_STEPS, [steps], 'l', 8, ''
     end
 
     # Returns the last steps as set by BrickStepper#set_steps.
     def get_steps
-      send_request FUNCTION_GET_STEPS, [], '', 4, 'l'
+      check_validity
+
+      send_request FUNCTION_GET_STEPS, [], '', 12, 'l'
     end
 
     # Returns the remaining steps of the last call of BrickStepper#set_steps.
@@ -280,7 +308,9 @@ module Tinkerforge
     # BrickStepper#get_remaining_steps is called after the motor has run for 500 steps,
     # it will return 1500.
     def get_remaining_steps
-      send_request FUNCTION_GET_REMAINING_STEPS, [], '', 4, 'l'
+      check_validity
+
+      send_request FUNCTION_GET_REMAINING_STEPS, [], '', 12, 'l'
     end
 
     # Sets the step mode of the stepper motor. Possible values are:
@@ -292,45 +322,55 @@ module Tinkerforge
     # 
     # A higher value will increase the resolution and
     # decrease the torque of the stepper motor.
-    # 
-    # The default value is 8 (Eighth Step).
     def set_step_mode(mode)
-      send_request FUNCTION_SET_STEP_MODE, [mode], 'C', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_STEP_MODE, [mode], 'C', 8, ''
     end
 
     # Returns the step mode as set by BrickStepper#set_step_mode.
     def get_step_mode
-      send_request FUNCTION_GET_STEP_MODE, [], '', 1, 'C'
+      check_validity
+
+      send_request FUNCTION_GET_STEP_MODE, [], '', 9, 'C'
     end
 
     # Drives the stepper motor forward until BrickStepper#drive_backward or
     # BrickStepper#stop is called. The velocity, acceleration and deacceleration as
     # set by BrickStepper#set_max_velocity and BrickStepper#set_speed_ramping will be used.
     def drive_forward
-      send_request FUNCTION_DRIVE_FORWARD, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_DRIVE_FORWARD, [], '', 8, ''
     end
 
     # Drives the stepper motor backward until BrickStepper#drive_forward or
     # BrickStepper#stop is triggered. The velocity, acceleration and deacceleration as
     # set by BrickStepper#set_max_velocity and BrickStepper#set_speed_ramping will be used.
     def drive_backward
-      send_request FUNCTION_DRIVE_BACKWARD, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_DRIVE_BACKWARD, [], '', 8, ''
     end
 
     # Stops the stepper motor with the deacceleration as set by
     # BrickStepper#set_speed_ramping.
     def stop
-      send_request FUNCTION_STOP, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_STOP, [], '', 8, ''
     end
 
-    # Returns the stack input voltage in mV. The stack input voltage is the
+    # Returns the stack input voltage. The stack input voltage is the
     # voltage that is supplied via the stack, i.e. it is given by a
     # Step-Down or Step-Up Power Supply.
     def get_stack_input_voltage
-      send_request FUNCTION_GET_STACK_INPUT_VOLTAGE, [], '', 2, 'S'
+      check_validity
+
+      send_request FUNCTION_GET_STACK_INPUT_VOLTAGE, [], '', 10, 'S'
     end
 
-    # Returns the external input voltage in mV. The external input voltage is
+    # Returns the external input voltage. The external input voltage is
     # given via the black power input connector on the Stepper Brick.
     # 
     # If there is an external input voltage and a stack input voltage, the motor
@@ -343,49 +383,69 @@ module Tinkerforge
     #  the external connection, it will immediately be driven by the high
     #  stack voltage
     def get_external_input_voltage
-      send_request FUNCTION_GET_EXTERNAL_INPUT_VOLTAGE, [], '', 2, 'S'
+      check_validity
+
+      send_request FUNCTION_GET_EXTERNAL_INPUT_VOLTAGE, [], '', 10, 'S'
     end
 
-    # Returns the current consumption of the motor in mA.
+    # Returns the current consumption of the motor.
     def get_current_consumption
-      send_request FUNCTION_GET_CURRENT_CONSUMPTION, [], '', 2, 'S'
+      check_validity
+
+      send_request FUNCTION_GET_CURRENT_CONSUMPTION, [], '', 10, 'S'
     end
 
-    # Sets the current in mA with which the motor will be driven.
-    # The minimum value is 100mA, the maximum value 2291mA and the
-    # default value is 800mA.
+    # Sets the current with which the motor will be driven.
     # 
     # .. warning::
     #  Do not set this value above the specifications of your stepper motor.
     #  Otherwise it may damage your motor.
     def set_motor_current(current)
-      send_request FUNCTION_SET_MOTOR_CURRENT, [current], 'S', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_MOTOR_CURRENT, [current], 'S', 8, ''
     end
 
     # Returns the current as set by BrickStepper#set_motor_current.
     def get_motor_current
-      send_request FUNCTION_GET_MOTOR_CURRENT, [], '', 2, 'S'
+      check_validity
+
+      send_request FUNCTION_GET_MOTOR_CURRENT, [], '', 10, 'S'
     end
 
     # Enables the driver chip. The driver parameters can be configured (maximum velocity,
     # acceleration, etc) before it is enabled.
     def enable
-      send_request FUNCTION_ENABLE, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_ENABLE, [], '', 8, ''
     end
 
     # Disables the driver chip. The configurations are kept (maximum velocity,
     # acceleration, etc) but the motor is not driven until it is enabled again.
+    # 
+    # .. warning::
+    #  Disabling the driver chip while the motor is still turning can damage the
+    #  driver chip. The motor should be stopped calling BrickStepper#stop function
+    #  before disabling the motor power. The BrickStepper#stop function will **not**
+    #  wait until the motor is actually stopped. You have to explicitly wait for the
+    #  appropriate time after calling the BrickStepper#stop function before calling
+    #  the BrickStepper#disable function.
     def disable
-      send_request FUNCTION_DISABLE, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_DISABLE, [], '', 8, ''
     end
 
     # Returns *true* if the driver chip is enabled, *false* otherwise.
     def is_enabled
-      send_request FUNCTION_IS_ENABLED, [], '', 1, '?'
+      check_validity
+
+      send_request FUNCTION_IS_ENABLED, [], '', 9, '?'
     end
 
-    # Sets the decay mode of the stepper motor. The possible value range is
-    # between 0 and 65535. A value of 0 sets the fast decay mode, a value of
+    # Sets the decay mode of the stepper motor.
+    # A value of 0 sets the fast decay mode, a value of
     # 65535 sets the slow decay mode and a value in between sets the mixed
     # decay mode.
     # 
@@ -404,36 +464,40 @@ module Tinkerforge
     # Generally, fast decay mode (small value) will be noisier but also
     # allow higher motor speeds.
     # 
-    # The default value is 10000.
-    # 
     # .. note::
     #  There is unfortunately no formula to calculate a perfect decay
     #  mode for a given stepper motor. If you have problems with loud noises
     #  or the maximum motor speed is too slow, you should try to tinker with
     #  the decay value
     def set_decay(decay)
-      send_request FUNCTION_SET_DECAY, [decay], 'S', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_DECAY, [decay], 'S', 8, ''
     end
 
     # Returns the decay mode as set by BrickStepper#set_decay.
     def get_decay
-      send_request FUNCTION_GET_DECAY, [], '', 2, 'S'
+      check_validity
+
+      send_request FUNCTION_GET_DECAY, [], '', 10, 'S'
     end
 
-    # Sets the minimum voltage in mV, below which the CALLBACK_UNDER_VOLTAGE callback
+    # Sets the minimum voltage, below which the CALLBACK_UNDER_VOLTAGE callback
     # is triggered. The minimum possible value that works with the Stepper Brick is 8V.
     # You can use this function to detect the discharge of a battery that is used
     # to drive the stepper motor. If you have a fixed power supply, you likely do
     # not need this functionality.
-    # 
-    # The default value is 8V.
     def set_minimum_voltage(voltage)
-      send_request FUNCTION_SET_MINIMUM_VOLTAGE, [voltage], 'S', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_MINIMUM_VOLTAGE, [voltage], 'S', 8, ''
     end
 
     # Returns the minimum voltage as set by BrickStepper#set_minimum_voltage.
     def get_minimum_voltage
-      send_request FUNCTION_GET_MINIMUM_VOLTAGE, [], '', 2, 'S'
+      check_validity
+
+      send_request FUNCTION_GET_MINIMUM_VOLTAGE, [], '', 10, 'S'
     end
 
     # Turns synchronous rectification on or off (*true* or *false*).
@@ -450,32 +514,35 @@ module Tinkerforge
     #  stepper motor with a large inductivity we strongly
     #  suggest that you disable synchronous rectification. Otherwise the
     #  Brick may not be able to cope with the load and overheat.
-    # 
-    # The default value is *false*.
     def set_sync_rect(sync_rect)
-      send_request FUNCTION_SET_SYNC_RECT, [sync_rect], '?', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_SYNC_RECT, [sync_rect], '?', 8, ''
     end
 
     # Returns *true* if synchronous rectification is enabled, *false* otherwise.
     def is_sync_rect
-      send_request FUNCTION_IS_SYNC_RECT, [], '', 1, '?'
+      check_validity
+
+      send_request FUNCTION_IS_SYNC_RECT, [], '', 9, '?'
     end
 
-    # Sets the time base of the velocity and the acceleration of the stepper brick
-    # (in seconds).
+    # Sets the time base of the velocity and the acceleration of the stepper brick.
     # 
     # For example, if you want to make one step every 1.5 seconds, you can set
     # the time base to 15 and the velocity to 10. Now the velocity is
     # 10steps/15s = 1steps/1.5s.
-    # 
-    # The default value is 1.
     def set_time_base(time_base)
-      send_request FUNCTION_SET_TIME_BASE, [time_base], 'L', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_TIME_BASE, [time_base], 'L', 8, ''
     end
 
     # Returns the time base as set by BrickStepper#set_time_base.
     def get_time_base
-      send_request FUNCTION_GET_TIME_BASE, [], '', 4, 'L'
+      check_validity
+
+      send_request FUNCTION_GET_TIME_BASE, [], '', 12, 'L'
     end
 
     # Returns the following parameters: The current velocity,
@@ -484,26 +551,32 @@ module Tinkerforge
     # 
     # There is also a callback for this function, see CALLBACK_ALL_DATA callback.
     def get_all_data
-      send_request FUNCTION_GET_ALL_DATA, [], '', 16, 'S l l S S S'
+      check_validity
+
+      send_request FUNCTION_GET_ALL_DATA, [], '', 24, 'S l l S S S'
     end
 
     # Sets the period with which the CALLBACK_ALL_DATA callback is triggered
     # periodically. A value of 0 turns the callback off.
     def set_all_data_period(period)
-      send_request FUNCTION_SET_ALL_DATA_PERIOD, [period], 'L', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_ALL_DATA_PERIOD, [period], 'L', 8, ''
     end
 
     # Returns the period as set by BrickStepper#set_all_data_period.
     def get_all_data_period
-      send_request FUNCTION_GET_ALL_DATA_PERIOD, [], '', 4, 'L'
+      check_validity
+
+      send_request FUNCTION_GET_ALL_DATA_PERIOD, [], '', 12, 'L'
     end
 
     # The SPITF protocol can be used with a dynamic baudrate. If the dynamic baudrate is
     # enabled, the Brick will try to adapt the baudrate for the communication
     # between Bricks and Bricklets according to the amount of data that is transferred.
     # 
-    # The baudrate will be increased exponentially if lots of data is send/received and
-    # decreased linearly if little data is send/received.
+    # The baudrate will be increased exponentially if lots of data is sent/received and
+    # decreased linearly if little data is sent/received.
     # 
     # This lowers the baudrate in applications where little data is transferred (e.g.
     # a weather station) and increases the robustness. If there is lots of data to transfer
@@ -517,20 +590,20 @@ module Tinkerforge
     # BrickStepper#set_spitfp_baudrate. If the dynamic baudrate is disabled, the baudrate
     # as set by BrickStepper#set_spitfp_baudrate will be used statically.
     # 
-    # The minimum dynamic baudrate has a value range of 400000 to 2000000 baud.
-    # 
-    # By default dynamic baudrate is enabled and the minimum dynamic baudrate is 400000.
-    # 
     # .. versionadded:: 2.3.6$nbsp;(Firmware)
     def set_spitfp_baudrate_config(enable_dynamic_baudrate, minimum_dynamic_baudrate)
-      send_request FUNCTION_SET_SPITFP_BAUDRATE_CONFIG, [enable_dynamic_baudrate, minimum_dynamic_baudrate], '? L', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_SPITFP_BAUDRATE_CONFIG, [enable_dynamic_baudrate, minimum_dynamic_baudrate], '? L', 8, ''
     end
 
     # Returns the baudrate config, see BrickStepper#set_spitfp_baudrate_config.
     # 
     # .. versionadded:: 2.3.6$nbsp;(Firmware)
     def get_spitfp_baudrate_config
-      send_request FUNCTION_GET_SPITFP_BAUDRATE_CONFIG, [], '', 5, '? L'
+      check_validity
+
+      send_request FUNCTION_GET_SPITFP_BAUDRATE_CONFIG, [], '', 13, '? L'
     end
 
     # Returns the timeout count for the different communication methods.
@@ -542,11 +615,12 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.3.4$nbsp;(Firmware)
     def get_send_timeout_count(communication_method)
-      send_request FUNCTION_GET_SEND_TIMEOUT_COUNT, [communication_method], 'C', 4, 'L'
+      check_validity
+
+      send_request FUNCTION_GET_SEND_TIMEOUT_COUNT, [communication_method], 'C', 12, 'L'
     end
 
-    # Sets the baudrate for a specific Bricklet port ('a' - 'd'). The
-    # baudrate can be in the range 400000 to 2000000.
+    # Sets the baudrate for a specific Bricklet port.
     # 
     # If you want to increase the throughput of Bricklets you can increase
     # the baudrate. If you get a high error count because of high
@@ -560,18 +634,20 @@ module Tinkerforge
     # or similar is necessary in you applications we recommend to not change
     # the baudrate.
     # 
-    # The default baudrate for all ports is 1400000.
-    # 
     # .. versionadded:: 2.3.3$nbsp;(Firmware)
     def set_spitfp_baudrate(bricklet_port, baudrate)
-      send_request FUNCTION_SET_SPITFP_BAUDRATE, [bricklet_port, baudrate], 'k L', 0, ''
+      check_validity
+
+      send_request FUNCTION_SET_SPITFP_BAUDRATE, [bricklet_port, baudrate], 'k L', 8, ''
     end
 
     # Returns the baudrate for a given Bricklet port, see BrickStepper#set_spitfp_baudrate.
     # 
     # .. versionadded:: 2.3.3$nbsp;(Firmware)
     def get_spitfp_baudrate(bricklet_port)
-      send_request FUNCTION_GET_SPITFP_BAUDRATE, [bricklet_port], 'k', 4, 'L'
+      check_validity
+
+      send_request FUNCTION_GET_SPITFP_BAUDRATE, [bricklet_port], 'k', 12, 'L'
     end
 
     # Returns the error count for the communication between Brick and Bricklet.
@@ -588,7 +664,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.3.3$nbsp;(Firmware)
     def get_spitfp_error_count(bricklet_port)
-      send_request FUNCTION_GET_SPITFP_ERROR_COUNT, [bricklet_port], 'k', 16, 'L L L L'
+      check_validity
+
+      send_request FUNCTION_GET_SPITFP_ERROR_COUNT, [bricklet_port], 'k', 24, 'L L L L'
     end
 
     # Enables the status LED.
@@ -600,7 +678,9 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.3.1$nbsp;(Firmware)
     def enable_status_led
-      send_request FUNCTION_ENABLE_STATUS_LED, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_ENABLE_STATUS_LED, [], '', 8, ''
     end
 
     # Disables the status LED.
@@ -612,14 +692,18 @@ module Tinkerforge
     # 
     # .. versionadded:: 2.3.1$nbsp;(Firmware)
     def disable_status_led
-      send_request FUNCTION_DISABLE_STATUS_LED, [], '', 0, ''
+      check_validity
+
+      send_request FUNCTION_DISABLE_STATUS_LED, [], '', 8, ''
     end
 
     # Returns *true* if the status LED is enabled, *false* otherwise.
     # 
     # .. versionadded:: 2.3.1$nbsp;(Firmware)
     def is_status_led_enabled
-      send_request FUNCTION_IS_STATUS_LED_ENABLED, [], '', 1, '?'
+      check_validity
+
+      send_request FUNCTION_IS_STATUS_LED_ENABLED, [], '', 9, '?'
     end
 
     # Returns the firmware and protocol version and the name of the Bricklet for a
@@ -628,17 +712,21 @@ module Tinkerforge
     # This functions sole purpose is to allow automatic flashing of v1.x.y Bricklet
     # plugins.
     def get_protocol1_bricklet_name(port)
-      send_request FUNCTION_GET_PROTOCOL1_BRICKLET_NAME, [port], 'k', 44, 'C C3 Z40'
+      check_validity
+
+      send_request FUNCTION_GET_PROTOCOL1_BRICKLET_NAME, [port], 'k', 52, 'C C3 Z40'
     end
 
-    # Returns the temperature in °C/10 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 an
     # accuracy of ±15%. 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 Brick. Calling this function
@@ -648,19 +736,43 @@ 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 32 bytes of firmware to the bricklet attached at the given port.
+    # The bytes are written to the position offset * 32.
+    # 
+    # This function is used by Brick Viewer during flashing. It should not be
+    # necessary to call it in a normal user program.
+    def write_bricklet_plugin(port, offset, chunk)
+      check_validity
+
+      send_request FUNCTION_WRITE_BRICKLET_PLUGIN, [port, offset, chunk], 'k C C32', 8, ''
+    end
+
+    # Reads 32 bytes of firmware from the bricklet attached at the given port.
+    # The bytes are read starting at the position offset * 32.
+    # 
+    # This function is used by Brick Viewer during flashing. It should not be
+    # necessary to call it in a normal user program.
+    def read_bricklet_plugin(port, offset)
+      check_validity
+
+      send_request FUNCTION_READ_BRICKLET_PLUGIN, [port, offset], 'k C', 40, 'C32'
     end
 
     # Returns the UID, the UID where the Brick is connected to,
     # the position, the hardware and firmware version as well as the
     # device identifier.
     # 
-    # The position can be '0'-'8' (stack position).
+    # The position is the position in the stack from '0' (bottom) to '8' (top).
     # 
     # 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>.