tinkerforge 2.1.11 → 2.1.12

data/lib/tinkerforge/brick_stepper.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2017-01-25.      #
+# This file was automatically generated on 2017-04-21.      #
 #                                                           #
-# Ruby Bindings Version 2.1.11                              #
+# Ruby Bindings Version 2.1.12                              #
 #                                                           #
 # 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  #
@@ -36,7 +36,7 @@ module Tinkerforge
     # voltage and the current consumption of the stepper motor.
     CALLBACK_ALL_DATA = 40
 
-    # This callback is triggered whenever the Stepper Brick enters a new state. 
+    # This callback is triggered whenever the Stepper Brick enters a new state.
     # It returns the new state as well as the previous state.
     CALLBACK_NEW_STATE = 41
 
@@ -77,6 +77,7 @@ module Tinkerforge
     FUNCTION_GET_ALL_DATA = 37 # :nodoc:
     FUNCTION_SET_ALL_DATA_PERIOD = 38 # :nodoc:
     FUNCTION_GET_ALL_DATA_PERIOD = 39 # :nodoc:
+    FUNCTION_GET_SEND_TIMEOUT_COUNT = 233 # :nodoc:
     FUNCTION_ENABLE_STATUS_LED = 238 # :nodoc:
     FUNCTION_DISABLE_STATUS_LED = 239 # :nodoc:
     FUNCTION_IS_STATUS_LED_ENABLED = 240 # :nodoc:
@@ -95,6 +96,14 @@ module Tinkerforge
     STATE_DEACCELERATION = 4 # :nodoc:
     STATE_DIRECTION_CHANGE_TO_FORWARD = 5 # :nodoc:
     STATE_DIRECTION_CHANGE_TO_BACKWARD = 6 # :nodoc:
+    COMMUNICATION_METHOD_NONE = 0 # :nodoc:
+    COMMUNICATION_METHOD_USB = 1 # :nodoc:
+    COMMUNICATION_METHOD_SPI_STACK = 2 # :nodoc:
+    COMMUNICATION_METHOD_CHIBI = 3 # :nodoc:
+    COMMUNICATION_METHOD_RS485 = 4 # :nodoc:
+    COMMUNICATION_METHOD_WIFI = 5 # :nodoc:
+    COMMUNICATION_METHOD_ETHERNET = 6 # :nodoc:
+    COMMUNICATION_METHOD_WIFI_V2 = 7 # :nodoc:
 
     # Creates an object with the unique device ID <tt>uid</tt> and adds it to
     # the IP Connection <tt>ipcon</tt>.
@@ -144,6 +153,7 @@ module Tinkerforge
       @response_expected[FUNCTION_GET_ALL_DATA_PERIOD] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[CALLBACK_ALL_DATA] = RESPONSE_EXPECTED_ALWAYS_FALSE
       @response_expected[CALLBACK_NEW_STATE] = RESPONSE_EXPECTED_ALWAYS_FALSE
+      @response_expected[FUNCTION_GET_SEND_TIMEOUT_COUNT] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[FUNCTION_ENABLE_STATUS_LED] = RESPONSE_EXPECTED_FALSE
       @response_expected[FUNCTION_DISABLE_STATUS_LED] = RESPONSE_EXPECTED_FALSE
       @response_expected[FUNCTION_IS_STATUS_LED_ENABLED] = RESPONSE_EXPECTED_ALWAYS_TRUE
@@ -193,14 +203,14 @@ module Tinkerforge
       send_request(FUNCTION_SET_SPEED_RAMPING, [acceleration, deacceleration], 'S S', 0, '')
     end
 
-    # Returns the acceleration and deacceleration as set by 
+    # 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')
     end
 
-    # Executes an active full brake. 
-    #  
+    # Executes an active full brake.
+    # 
     # .. warning::
     #  This function is for emergency purposes,
     #  where an immediate brake is necessary. Depending on the current velocity and
@@ -234,7 +244,7 @@ module Tinkerforge
     # BrickStepper#set_max_velocity and BrickStepper#set_speed_ramping.
     # 
     # A call of BrickStepper#set_target_position with the parameter *x* is equivalent to
-    # a call of BrickStepper#set_steps with the parameter 
+    # 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, '')
@@ -246,7 +256,7 @@ module Tinkerforge
     end
 
     # Sets the number of steps the stepper motor should run. Positive values
-    # will drive the motor forward and negative values backward. 
+    # will drive the motor forward and negative values backward.
     # The velocity, acceleration and deacceleration as set by
     # BrickStepper#set_max_velocity and BrickStepper#set_speed_ramping will be used.
     def set_steps(steps)
@@ -259,7 +269,7 @@ module Tinkerforge
     end
 
     # Returns the remaining steps of the last call of BrickStepper#set_steps.
-    # For example, if BrickStepper#set_steps is called with 2000 and 
+    # For example, if BrickStepper#set_steps is called with 2000 and
     # BrickStepper#get_remaining_steps is called after the motor has run for 500 steps,
     # it will return 1500.
     def get_remaining_steps
@@ -287,7 +297,7 @@ module Tinkerforge
     end
 
     # Drives the stepper motor forward until BrickStepper#drive_backward or
-    # BrickStepper#stop is called. The velocity, acceleration and deacceleration as 
+    # 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, '')
@@ -300,24 +310,24 @@ module Tinkerforge
       send_request(FUNCTION_DRIVE_BACKWARD, [], '', 0, '')
     end
 
-    # Stops the stepper motor with the deacceleration as set by 
+    # Stops the stepper motor with the deacceleration as set by
     # BrickStepper#set_speed_ramping.
     def stop
       send_request(FUNCTION_STOP, [], '', 0, '')
     end
 
     # Returns the stack input voltage in mV. The stack input voltage is the
-    # voltage that is supplied via the stack, i.e. it is given by a 
+    # 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')
     end
 
     # Returns the external input voltage in mV. The external input voltage is
-    # given via the black power input connector on the Stepper Brick. 
-    #  
+    # 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
-    # will be driven by the external input voltage. If there is only a stack 
+    # will be driven by the external input voltage. If there is only a stack
     # voltage present, the motor will be driven by this voltage.
     # 
     # .. warning::
@@ -335,7 +345,7 @@ module Tinkerforge
     end
 
     # Sets the current in mA with which the motor will be driven.
-    # The minimum value is 100mA, the maximum value 2291mA and the 
+    # The minimum value is 100mA, the maximum value 2291mA and the
     # default value is 800mA.
     # 
     # .. warning::
@@ -375,13 +385,13 @@ module Tinkerforge
     # Changing the decay mode is only possible if synchronous rectification
     # is enabled (see BrickStepper#set_sync_rect).
     # 
-    # For a good explanation of the different decay modes see 
+    # For a good explanation of the different decay modes see
     # `this <http://ebldc.com/?p=86/>`__ blog post by Avayan.
     # 
     # A good decay mode is unfortunately different for every motor. The best
     # way to work out a good decay mode for your stepper motor, if you can't
     # measure the current with an oscilloscope, is to listen to the sound of
-    # the motor. If the value is too low, you often hear a high pitched 
+    # the motor. If the value is too low, you often hear a high pitched
     # sound and if it is too high you can often hear a humming sound.
     # 
     # Generally, fast decay mode (small value) will be noisier but also
@@ -406,7 +416,7 @@ module Tinkerforge
     # Sets the minimum voltage in mV, 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 
+    # to drive the stepper motor. If you have a fixed power supply, you likely do
     # not need this functionality.
     # 
     # The default value is 8V.
@@ -425,11 +435,11 @@ module Tinkerforge
     # (see BrickStepper#set_decay). Without synchronous rectification fast
     # decay is used.
     # 
-    # For an explanation of synchronous rectification see 
+    # For an explanation of synchronous rectification see
     # `here <https://en.wikipedia.org/wiki/Active_rectification>`__.
     # 
     # .. warning::
-    #  If you want to use high speeds (> 10000 steps/s) for a large 
+    #  If you want to use high speeds (> 10000 steps/s) for a large
     #  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.
@@ -447,8 +457,8 @@ module Tinkerforge
     # Sets the time base of the velocity and the acceleration of the stepper brick
     # (in seconds).
     # 
-    # 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 
+    # 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.
@@ -465,7 +475,7 @@ module Tinkerforge
     # the current position, the remaining steps, the stack voltage, the external
     # voltage and the current consumption of the stepper motor.
     # 
-    # There is also a callback for this function, see CALLBACK_ALL_DATA.
+    # 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')
     end
@@ -481,6 +491,18 @@ module Tinkerforge
       send_request(FUNCTION_GET_ALL_DATA_PERIOD, [], '', 4, 'L')
     end
 
+    # Returns the timeout count for the different communication methods.
+    # 
+    # The methods 0-2 are available for all Bricks, 3-7 only for Master Bricks.
+    # 
+    # This function is mostly used for debugging during development, in normal operation
+    # the counters should nearly always stay at 0.
+    # 
+    # .. 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')
+    end
+
     # Enables the status LED.
     # 
     # The status LED is the blue LED next to the USB connector. If enabled is is
@@ -541,7 +563,7 @@ module Tinkerforge
       send_request(FUNCTION_RESET, [], '', 0, '')
     end
 
-    # Returns the UID, the UID where the Brick is connected to, 
+    # Returns the UID, the UID where the Brick is connected to,
     # the position, the hardware and firmware version as well as the
     # device identifier.
     # 

data/lib/tinkerforge/bricklet_accelerometer.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2017-01-25.      #
+# This file was automatically generated on 2017-04-21.      #
 #                                                           #
-# Ruby Bindings Version 2.1.11                              #
+# Ruby Bindings Version 2.1.12                              #
 #                                                           #
 # 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  #
@@ -19,8 +19,8 @@ module Tinkerforge
     # BrickletAccelerometer#set_acceleration_callback_period. The parameters are the
     # X, Y and Z acceleration.
     # 
-    # CALLBACK_ACCELERATION is only triggered if the acceleration has changed since the
-    # last triggering.
+    # The CALLBACK_ACCELERATION callback is only triggered if the acceleration has
+    # changed since the last triggering.
     CALLBACK_ACCELERATION = 14
 
     # This callback is triggered when the threshold as set by
@@ -102,8 +102,8 @@ module Tinkerforge
     # Returns the acceleration in x, y and z direction. The values
     # are given in g/1000 (1g = 9.80665m/s²), not to be confused with grams.
     # 
-    # If you want to get the acceleration periodically, it is recommended 
-    # to use the callback CALLBACK_ACCELERATION and set the period with 
+    # If you want to get the acceleration periodically, it is recommended
+    # to use the CALLBACK_ACCELERATION callback and set the period with
     # BrickletAccelerometer#set_acceleration_callback_period.
     def get_acceleration
       send_request(FUNCTION_GET_ACCELERATION, [], '', 6, 's s s')
@@ -112,8 +112,8 @@ module Tinkerforge
     # Sets the period in ms with which the CALLBACK_ACCELERATION callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
-    # CALLBACK_ACCELERATION is only triggered if the acceleration has changed since the
-    # last triggering.
+    # The CALLBACK_ACCELERATION callback is only triggered if the acceleration has
+    # changed since the last triggering.
     # 
     # The default value is 0.
     def set_acceleration_callback_period(period)
@@ -125,7 +125,7 @@ module Tinkerforge
       send_request(FUNCTION_GET_ACCELERATION_CALLBACK_PERIOD, [], '', 4, 'L')
     end
 
-    # Sets the thresholds for the CALLBACK_ACCELERATION_REACHED callback. 
+    # Sets the thresholds for the CALLBACK_ACCELERATION_REACHED callback.
     # 
     # The following options are possible:
     # 
@@ -179,7 +179,7 @@ module Tinkerforge
     # * Full scale range of -2G to +2G up to -16G to +16G.
     # * Filter bandwidth between 50Hz and 800Hz.
     # 
-    # Decreasing data rate or full scale range will also decrease the noise on 
+    # Decreasing data rate or full scale range will also decrease the noise on
     # the data.
     # 
     # The default values are 100Hz data rate, -4G to +4G range and 200Hz
@@ -208,7 +208,7 @@ module Tinkerforge
       send_request(FUNCTION_IS_LED_ON, [], '', 1, '?')
     end
 
-    # Returns the UID, the UID where the Bricklet is connected to, 
+    # Returns the UID, the UID where the Bricklet is connected to,
     # the position, the hardware and firmware version as well as the
     # device identifier.
     # 

data/lib/tinkerforge/bricklet_ambient_light.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2017-01-25.      #
+# This file was automatically generated on 2017-04-21.      #
 #                                                           #
-# Ruby Bindings Version 2.1.11                              #
+# Ruby Bindings Version 2.1.12                              #
 #                                                           #
 # 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  #
@@ -19,7 +19,7 @@ module Tinkerforge
     # BrickletAmbientLight#set_illuminance_callback_period. The parameter is the illuminance of the
     # ambient light sensor.
     # 
-    # CALLBACK_ILLUMINANCE is only triggered if the illuminance has changed since the
+    # The CALLBACK_ILLUMINANCE callback is only triggered if the illuminance has changed since the
     # last triggering.
     CALLBACK_ILLUMINANCE = 13
 
@@ -27,7 +27,7 @@ module Tinkerforge
     # BrickletAmbientLight#set_analog_value_callback_period. The parameter is the analog value of the
     # ambient light sensor.
     # 
-    # CALLBACK_ANALOG_VALUE is only triggered if the analog value has changed since the
+    # The CALLBACK_ANALOG_VALUE callback is only triggered if the analog value has changed since the
     # last triggering.
     CALLBACK_ANALOG_VALUE = 14
 
@@ -103,7 +103,7 @@ module Tinkerforge
     # of 4500 means that an illuminance of 450lux is measured.
     # 
     # If you want to get the illuminance periodically, it is recommended to use the
-    # callback CALLBACK_ILLUMINANCE and set the period with 
+    # CALLBACK_ILLUMINANCE callback and set the period with
     # BrickletAmbientLight#set_illuminance_callback_period.
     def get_illuminance
       send_request(FUNCTION_GET_ILLUMINANCE, [], '', 2, 'S')
@@ -122,8 +122,8 @@ module Tinkerforge
     #  set dynamically depending on the light intensity. It is impossible to
     #  distinguish between these ranges with the analog value.
     # 
-    # If you want the analog value periodically, it is recommended to use the 
-    # callback CALLBACK_ANALOG_VALUE and set the period with 
+    # If you want the analog value periodically, it is recommended to use the
+    # CALLBACK_ANALOG_VALUE callback and set the period with
     # BrickletAmbientLight#set_analog_value_callback_period.
     def get_analog_value
       send_request(FUNCTION_GET_ANALOG_VALUE, [], '', 2, 'S')
@@ -132,7 +132,7 @@ module Tinkerforge
     # Sets the period in ms with which the CALLBACK_ILLUMINANCE callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
-    # CALLBACK_ILLUMINANCE is only triggered if the illuminance has changed since the
+    # The CALLBACK_ILLUMINANCE callback is only triggered if the illuminance has changed since the
     # last triggering.
     # 
     # The default value is 0.
@@ -148,7 +148,7 @@ module Tinkerforge
     # Sets the period in ms with which the CALLBACK_ANALOG_VALUE callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
-    # CALLBACK_ANALOG_VALUE is only triggered if the analog value has changed since the
+    # The CALLBACK_ANALOG_VALUE callback is only triggered if the analog value has changed since the
     # last triggering.
     # 
     # The default value is 0.
@@ -161,7 +161,7 @@ module Tinkerforge
       send_request(FUNCTION_GET_ANALOG_VALUE_CALLBACK_PERIOD, [], '', 4, 'L')
     end
 
-    # Sets the thresholds for the CALLBACK_ILLUMINANCE_REACHED callback. 
+    # Sets the thresholds for the CALLBACK_ILLUMINANCE_REACHED callback.
     # 
     # The following options are possible:
     # 
@@ -183,7 +183,7 @@ module Tinkerforge
       send_request(FUNCTION_GET_ILLUMINANCE_CALLBACK_THRESHOLD, [], '', 5, 'k S S')
     end
 
-    # Sets the thresholds for the CALLBACK_ANALOG_VALUE_REACHED callback. 
+    # Sets the thresholds for the CALLBACK_ANALOG_VALUE_REACHED callback.
     # 
     # The following options are possible:
     # 
@@ -227,7 +227,7 @@ module Tinkerforge
       send_request(FUNCTION_GET_DEBOUNCE_PERIOD, [], '', 4, 'L')
     end
 
-    # Returns the UID, the UID where the Bricklet is connected to, 
+    # Returns the UID, the UID where the Bricklet is connected to,
     # the position, the hardware and firmware version as well as the
     # device identifier.
     # 

data/lib/tinkerforge/bricklet_ambient_light_v2.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2017-01-25.      #
+# This file was automatically generated on 2017-04-21.      #
 #                                                           #
-# Ruby Bindings Version 2.1.11                              #
+# Ruby Bindings Version 2.1.12                              #
 #                                                           #
 # 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  #
@@ -19,7 +19,7 @@ module Tinkerforge
     # BrickletAmbientLightV2#set_illuminance_callback_period. The parameter is the illuminance of the
     # ambient light sensor.
     # 
-    # CALLBACK_ILLUMINANCE is only triggered if the illuminance has changed since the
+    # The CALLBACK_ILLUMINANCE callback is only triggered if the illuminance has changed since the
     # last triggering.
     CALLBACK_ILLUMINANCE = 10
 
@@ -97,7 +97,7 @@ module Tinkerforge
     #   configuration should be modified, see BrickletAmbientLightV2#set_configuration.
     # 
     # If you want to get the illuminance periodically, it is recommended to use the
-    # callback CALLBACK_ILLUMINANCE and set the period with 
+    # CALLBACK_ILLUMINANCE callback and set the period with
     # BrickletAmbientLightV2#set_illuminance_callback_period.
     def get_illuminance
       send_request(FUNCTION_GET_ILLUMINANCE, [], '', 4, 'L')
@@ -106,8 +106,8 @@ module Tinkerforge
     # Sets the period in ms with which the CALLBACK_ILLUMINANCE callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
-    # CALLBACK_ILLUMINANCE is only triggered if the illuminance has changed since the
-    # last triggering.
+    # The CALLBACK_ILLUMINANCE callback is only triggered if the illuminance has changed
+    # since the last triggering.
     # 
     # The default value is 0.
     def set_illuminance_callback_period(period)
@@ -119,7 +119,7 @@ module Tinkerforge
       send_request(FUNCTION_GET_ILLUMINANCE_CALLBACK_PERIOD, [], '', 4, 'L')
     end
 
-    # Sets the thresholds for the CALLBACK_ILLUMINANCE_REACHED callback. 
+    # Sets the thresholds for the CALLBACK_ILLUMINANCE_REACHED callback.
     # 
     # The following options are possible:
     # 
@@ -195,7 +195,7 @@ module Tinkerforge
       send_request(FUNCTION_GET_CONFIGURATION, [], '', 2, 'C C')
     end
 
-    # Returns the UID, the UID where the Bricklet is connected to, 
+    # Returns the UID, the UID where the Bricklet is connected to,
     # the position, the hardware and firmware version as well as the
     # device identifier.
     # 

data/lib/tinkerforge/bricklet_analog_in.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2017-01-25.      #
+# This file was automatically generated on 2017-04-21.      #
 #                                                           #
-# Ruby Bindings Version 2.1.11                              #
+# Ruby Bindings Version 2.1.12                              #
 #                                                           #
 # 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  #
@@ -19,16 +19,16 @@ module Tinkerforge
     # BrickletAnalogIn#set_voltage_callback_period. The parameter is the voltage of the
     # sensor.
     # 
-    # CALLBACK_VOLTAGE is only triggered if the voltage has changed since the
-    # last triggering.
+    # The CALLBACK_VOLTAGE callback is only triggered if the voltage has changed since
+    # the last triggering.
     CALLBACK_VOLTAGE = 13
 
     # This callback is triggered periodically with the period that is set by
-    # BrickletAnalogIn#set_analog_value_callback_period. The parameter is the analog value of the
-    # sensor.
+    # BrickletAnalogIn#set_analog_value_callback_period. The parameter is the analog
+    # value of the sensor.
     # 
-    # CALLBACK_ANALOG_VALUE is only triggered if the voltage has changed since the
-    # last triggering.
+    # The CALLBACK_ANALOG_VALUE callback is only triggered if the voltage has changed
+    # since the last triggering.
     CALLBACK_ANALOG_VALUE = 14
 
     # This callback is triggered when the threshold as set by
@@ -117,7 +117,7 @@ module Tinkerforge
     # Between 6 and 45V the resolution is about 10mV.
     # 
     # If you want to get the voltage periodically, it is recommended to use the
-    # callback CALLBACK_VOLTAGE and set the period with 
+    # CALLBACK_VOLTAGE callback and set the period with
     # BrickletAnalogIn#set_voltage_callback_period.
     def get_voltage
       send_request(FUNCTION_GET_VOLTAGE, [], '', 2, 'S')
@@ -132,8 +132,8 @@ module Tinkerforge
     #  unfiltered analog values. The only reason to use BrickletAnalogIn#get_analog_value is,
     #  if you need the full resolution of the analog-to-digital converter.
     # 
-    # If you want the analog value periodically, it is recommended to use the 
-    # callback CALLBACK_ANALOG_VALUE and set the period with 
+    # If you want the analog value periodically, it is recommended to use the
+    # CALLBACK_ANALOG_VALUE callback and set the period with
     # BrickletAnalogIn#set_analog_value_callback_period.
     def get_analog_value
       send_request(FUNCTION_GET_ANALOG_VALUE, [], '', 2, 'S')
@@ -142,8 +142,8 @@ module Tinkerforge
     # Sets the period in ms with which the CALLBACK_VOLTAGE callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
-    # CALLBACK_VOLTAGE is only triggered if the voltage has changed since the
-    # last triggering.
+    # The CALLBACK_VOLTAGE callback is only triggered if the voltage has changed since
+    # the last triggering.
     # 
     # The default value is 0.
     def set_voltage_callback_period(period)
@@ -158,8 +158,8 @@ module Tinkerforge
     # Sets the period in ms with which the CALLBACK_ANALOG_VALUE callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
-    # CALLBACK_ANALOG_VALUE is only triggered if the analog value has changed since the
-    # last triggering.
+    # The CALLBACK_ANALOG_VALUE callback is only triggered if the analog value has
+    # changed since the last triggering.
     # 
     # The default value is 0.
     def set_analog_value_callback_period(period)
@@ -171,7 +171,7 @@ module Tinkerforge
       send_request(FUNCTION_GET_ANALOG_VALUE_CALLBACK_PERIOD, [], '', 4, 'L')
     end
 
-    # Sets the thresholds for the CALLBACK_VOLTAGE_REACHED callback. 
+    # Sets the thresholds for the CALLBACK_VOLTAGE_REACHED callback.
     # 
     # The following options are possible:
     # 
@@ -193,7 +193,7 @@ module Tinkerforge
       send_request(FUNCTION_GET_VOLTAGE_CALLBACK_THRESHOLD, [], '', 5, 'k S S')
     end
 
-    # Sets the thresholds for the CALLBACK_ANALOG_VALUE_REACHED callback. 
+    # Sets the thresholds for the CALLBACK_ANALOG_VALUE_REACHED callback.
     # 
     # The following options are possible:
     # 
@@ -280,7 +280,7 @@ module Tinkerforge
       send_request(FUNCTION_GET_AVERAGING, [], '', 1, 'C')
     end
 
-    # Returns the UID, the UID where the Bricklet is connected to, 
+    # Returns the UID, the UID where the Bricklet is connected to,
     # the position, the hardware and firmware version as well as the
     # device identifier.
     #