tinkerforge 2.1.4 → 2.1.6

data/lib/tinkerforge/bricklet_analog_out.rb

@@ -1,18 +1,19 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2014-12-10.      #
+# This file was automatically generated on 2015-11-17.      #
 #                                                           #
-# Bindings Version 2.1.4                                    #
+# Bindings Version 2.1.6                                    #
 #                                                           #
 # 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 generator git on tinkerforge.com                   #
+# to the generators git repository on tinkerforge.com       #
 #############################################################
 
 module Tinkerforge
-  # Device for output of voltage between 0 and 5V
+  # Generates configurable DC voltage between 0V and 5V
   class BrickletAnalogOut < Device
     DEVICE_IDENTIFIER = 220 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Analog Out Bricklet' # :nodoc:
 
     FUNCTION_SET_VOLTAGE = 1 # :nodoc:
     FUNCTION_GET_VOLTAGE = 2 # :nodoc:

data/lib/tinkerforge/bricklet_analog_out_v2.rb

@@ -0,0 +1,66 @@
+# -*- ruby encoding: utf-8 -*-
+#############################################################
+# This file was automatically generated on 2015-11-17.      #
+#                                                           #
+# Bindings Version 2.1.6                                    #
+#                                                           #
+# 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       #
+#############################################################
+
+module Tinkerforge
+  # Generates configurable DC voltage between 0V and 12V
+  class BrickletAnalogOutV2 < Device
+    DEVICE_IDENTIFIER = 256 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Analog Out Bricklet 2.0' # :nodoc:
+
+    FUNCTION_SET_OUTPUT_VOLTAGE = 1 # :nodoc:
+    FUNCTION_GET_OUTPUT_VOLTAGE = 2 # :nodoc:
+    FUNCTION_GET_INPUT_VOLTAGE = 3 # :nodoc:
+    FUNCTION_GET_IDENTITY = 255 # :nodoc:
+
+
+    # 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
+
+      @api_version = [2, 0, 0]
+
+      @response_expected[FUNCTION_SET_OUTPUT_VOLTAGE] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_GET_OUTPUT_VOLTAGE] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[FUNCTION_GET_INPUT_VOLTAGE] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[FUNCTION_GET_IDENTITY] = RESPONSE_EXPECTED_ALWAYS_TRUE
+
+    end
+
+    # Sets the voltage in mV. The possible range is 0V to 12V (0-12000).
+    def set_output_voltage(voltage)
+      send_request(FUNCTION_SET_OUTPUT_VOLTAGE, [voltage], 'S', 0, '')
+    end
+
+    # Returns the voltage as set by BrickletAnalogOutV2#set_output_voltage.
+    def get_output_voltage
+      send_request(FUNCTION_GET_OUTPUT_VOLTAGE, [], '', 2, 'S')
+    end
+
+    # Returns the input voltage in mV.
+    def get_input_voltage
+      send_request(FUNCTION_GET_INPUT_VOLTAGE, [], '', 2, 'S')
+    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 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')
+    end
+
+  end
+end

data/lib/tinkerforge/bricklet_barometer.rb

@@ -1,18 +1,19 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2014-12-10.      #
+# This file was automatically generated on 2015-11-17.      #
 #                                                           #
-# Bindings Version 2.1.4                                    #
+# Bindings Version 2.1.6                                    #
 #                                                           #
 # 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 generator git on tinkerforge.com                   #
+# to the generators git repository on tinkerforge.com       #
 #############################################################
 
 module Tinkerforge
-  # Device for sensing air pressure and altitude changes
+  # Measures air pressure and altitude changes
   class BrickletBarometer < Device
     DEVICE_IDENTIFIER = 221 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Barometer Bricklet' # :nodoc:
 
     # This callback is triggered periodically with the period that is set by
     # BrickletBarometer#set_air_pressure_callback_period. The parameter is the air pressure of the
@@ -228,13 +229,14 @@ module Tinkerforge
     end
 
     # Sets the reference air pressure in mbar/1000 for the altitude calculation.
+    # Valid values are between 10000 and 1200000.
     # Setting the reference to the current air pressure results in a calculated
     # altitude of 0cm. Passing 0 is a shortcut for passing the current air pressure as
     # reference.
     # 
     # Well known reference values are the Q codes
-    # `QNH <http://en.wikipedia.org/wiki/QNH>`__ and
-    # `QFE <http://en.wikipedia.org/wiki/Mean_sea_level_pressure#Mean_sea_level_pressure>`__
+    # `QNH <https://en.wikipedia.org/wiki/QNH>`__ and
+    # `QFE <https://en.wikipedia.org/wiki/Mean_sea_level_pressure#Mean_sea_level_pressure>`__
     # used in aviation.
     # 
     # The default value is 1013.25mbar.
@@ -261,7 +263,7 @@ module Tinkerforge
     # Sets the different averaging parameters. It is possible to set
     # the length of a normal averaging for the temperature and pressure,
     # as well as an additional length of a 
-    # `moving average <http://en.wikipedia.org/wiki/Moving_average>`__ 
+    # `moving average <https://en.wikipedia.org/wiki/Moving_average>`__
     # for the pressure. The moving average is calculated from the normal 
     # averages.  There is no moving average for the temperature.
     # 
@@ -277,14 +279,14 @@ module Tinkerforge
     # The default values are 10 for the normal averages and 25 for the
     # moving average.
     # 
-    # .. versionadded:: 2.0.1~(Plugin)
+    # .. versionadded:: 2.0.1$nbsp;(Plugin)
     def set_averaging(moving_average_pressure, average_pressure, average_temperature)
       send_request(FUNCTION_SET_AVERAGING, [moving_average_pressure, average_pressure, average_temperature], 'C C C', 0, '')
     end
 
     # Returns the averaging configuration as set by BrickletBarometer#set_averaging.
     # 
-    # .. versionadded:: 2.0.1~(Plugin)
+    # .. versionadded:: 2.0.1$nbsp;(Plugin)
     def get_averaging
       send_request(FUNCTION_GET_AVERAGING, [], '', 3, 'C C C')
     end

data/lib/tinkerforge/bricklet_color.rb

@@ -1,18 +1,19 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2014-12-10.      #
+# This file was automatically generated on 2015-11-17.      #
 #                                                           #
-# Bindings Version 2.1.4                                    #
+# Bindings Version 2.1.6                                    #
 #                                                           #
 # 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 generator git on tinkerforge.com                   #
+# to the generators git repository on tinkerforge.com       #
 #############################################################
 
 module Tinkerforge
-  # Device for measuring color (RGB value), illuminance and color temperature
+  # Measures color (RGB value), illuminance and color temperature
   class BrickletColor < Device
     DEVICE_IDENTIFIER = 243 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Color Bricklet' # :nodoc:
 
     # This callback is triggered periodically with the period that is set by
     # BrickletColor#set_color_callback_period. The parameter is the color
@@ -22,17 +23,18 @@ module Tinkerforge
     # last triggering.
     CALLBACK_COLOR = 8
 
-    # This callback is triggered periodically with the period that is set by
-    # BrickletColor#set_color_callback_period. The parameter is the color
+    # This callback is triggered when the threshold as set by
+    # BrickletColor#set_color_callback_threshold is reached.
+    # The parameter is the color
     # of the sensor as RGBC.
     # 
-    # CALLBACK_COLOR is only triggered if the color has changed since the
-    # last triggering.
+    # If the threshold keeps being reached, the callback is triggered periodically
+    # with the period as set by BrickletColor#set_debounce_period.
     CALLBACK_COLOR_REACHED = 9
 
     # This callback is triggered periodically with the period that is set by
     # BrickletColor#set_illuminance_callback_period. The parameter is the illuminance.
-    # See BrickletColor#get_illuminance for how to interrept this value.
+    # See BrickletColor#get_illuminance for how to interpret this value.
     # 
     # CALLBACK_ILLUMINANCE is only triggered if the illuminance has changed since the
     # last triggering.

data/lib/tinkerforge/bricklet_current12.rb

@@ -1,18 +1,19 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2014-12-10.      #
+# This file was automatically generated on 2015-11-17.      #
 #                                                           #
-# Bindings Version 2.1.4                                    #
+# Bindings Version 2.1.6                                    #
 #                                                           #
 # 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 generator git on tinkerforge.com                   #
+# to the generators git repository on tinkerforge.com       #
 #############################################################
 
 module Tinkerforge
-  # Device for sensing current of up to 12.5A
+  # Measures AC/DC current between -12.5A and +12.5A
   class BrickletCurrent12 < Device
     DEVICE_IDENTIFIER = 23 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Current12 Bricklet' # :nodoc:
 
     # This callback is triggered periodically with the period that is set by
     # BrickletCurrent12#set_current_callback_period. The parameter is the current of the

data/lib/tinkerforge/bricklet_current25.rb

@@ -1,18 +1,19 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2014-12-10.      #
+# This file was automatically generated on 2015-11-17.      #
 #                                                           #
-# Bindings Version 2.1.4                                    #
+# Bindings Version 2.1.6                                    #
 #                                                           #
 # 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 generator git on tinkerforge.com                   #
+# to the generators git repository on tinkerforge.com       #
 #############################################################
 
 module Tinkerforge
-  # Device for sensing current of up to 25A
+  # Measures AC/DC current between -25A and +25A
   class BrickletCurrent25 < Device
     DEVICE_IDENTIFIER = 24 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Current25 Bricklet' # :nodoc:
 
     # This callback is triggered periodically with the period that is set by
     # BrickletCurrent25#set_current_callback_period. The parameter is the current of the

data/lib/tinkerforge/bricklet_distance_ir.rb

@@ -1,18 +1,19 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2014-12-10.      #
+# This file was automatically generated on 2015-11-17.      #
 #                                                           #
-# Bindings Version 2.1.4                                    #
+# Bindings Version 2.1.6                                    #
 #                                                           #
 # 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 generator git on tinkerforge.com                   #
+# to the generators git repository on tinkerforge.com       #
 #############################################################
 
 module Tinkerforge
-  # Device for sensing distance via infrared
+  # Measures distance up to 150cm with infrared light
   class BrickletDistanceIR < Device
     DEVICE_IDENTIFIER = 25 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Distance IR Bricklet' # :nodoc:
 
     # This callback is triggered periodically with the period that is set by
     # BrickletDistanceIR#set_distance_callback_period. The parameter is the distance of the
@@ -73,7 +74,7 @@ module Tinkerforge
     def initialize(uid, ipcon)
       super uid, ipcon
 
-      @api_version = [2, 0, 0]
+      @api_version = [2, 0, 1]
 
       @response_expected[FUNCTION_GET_DISTANCE] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[FUNCTION_GET_ANALOG_VALUE] = RESPONSE_EXPECTED_ALWAYS_TRUE
@@ -202,12 +203,12 @@ module Tinkerforge
     # 
     # The default value is ('x', 0, 0).
     def set_distance_callback_threshold(option, min, max)
-      send_request(FUNCTION_SET_DISTANCE_CALLBACK_THRESHOLD, [option, min, max], 'k s s', 0, '')
+      send_request(FUNCTION_SET_DISTANCE_CALLBACK_THRESHOLD, [option, min, max], 'k S S', 0, '')
     end
 
     # Returns the threshold as set by BrickletDistanceIR#set_distance_callback_threshold.
     def get_distance_callback_threshold
-      send_request(FUNCTION_GET_DISTANCE_CALLBACK_THRESHOLD, [], '', 5, 'k s s')
+      send_request(FUNCTION_GET_DISTANCE_CALLBACK_THRESHOLD, [], '', 5, 'k S S')
     end
 
     # Sets the thresholds for the CALLBACK_ANALOG_VALUE_REACHED callback. 

data/lib/tinkerforge/bricklet_distance_us.rb

@@ -1,18 +1,19 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2014-12-10.      #
+# This file was automatically generated on 2015-11-17.      #
 #                                                           #
-# Bindings Version 2.1.4                                    #
+# Bindings Version 2.1.6                                    #
 #                                                           #
 # 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 generator git on tinkerforge.com                   #
+# to the generators git repository on tinkerforge.com       #
 #############################################################
 
 module Tinkerforge
-  # Device for sensing distance via ultrasound
+  # Measures distance between 2cm and 400cm with ultrasound
   class BrickletDistanceUS < Device
     DEVICE_IDENTIFIER = 229 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Distance US Bricklet' # :nodoc:
 
     # This callback is triggered periodically with the period that is set by
     # BrickletDistanceUS#set_distance_callback_period. The parameter is the distance value
@@ -52,7 +53,7 @@ module Tinkerforge
     def initialize(uid, ipcon)
       super uid, ipcon
 
-      @api_version = [2, 0, 0]
+      @api_version = [2, 0, 1]
 
       @response_expected[FUNCTION_GET_DISTANCE_VALUE] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[FUNCTION_SET_DISTANCE_CALLBACK_PERIOD] = RESPONSE_EXPECTED_TRUE
@@ -115,12 +116,12 @@ module Tinkerforge
     # 
     # The default value is ('x', 0, 0).
     def set_distance_callback_threshold(option, min, max)
-      send_request(FUNCTION_SET_DISTANCE_CALLBACK_THRESHOLD, [option, min, max], 'k s s', 0, '')
+      send_request(FUNCTION_SET_DISTANCE_CALLBACK_THRESHOLD, [option, min, max], 'k S S', 0, '')
     end
 
     # Returns the threshold as set by BrickletDistanceUS#set_distance_callback_threshold.
     def get_distance_callback_threshold
-      send_request(FUNCTION_GET_DISTANCE_CALLBACK_THRESHOLD, [], '', 5, 'k s s')
+      send_request(FUNCTION_GET_DISTANCE_CALLBACK_THRESHOLD, [], '', 5, 'k S S')
     end
 
     # Sets the period in ms with which the threshold callbacks
@@ -143,7 +144,7 @@ module Tinkerforge
       send_request(FUNCTION_GET_DEBOUNCE_PERIOD, [], '', 4, 'L')
     end
 
-    # Sets the length of a `moving averaging <http://en.wikipedia.org/wiki/Moving_average>`__ 
+    # Sets the length of a `moving averaging <https://en.wikipedia.org/wiki/Moving_average>`__
     # for the distance value.
     # 
     # Setting the length to 0 will turn the averaging completely off. With less

data/lib/tinkerforge/bricklet_dual_button.rb

@@ -1,18 +1,19 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2014-12-10.      #
+# This file was automatically generated on 2015-11-17.      #
 #                                                           #
-# Bindings Version 2.1.4                                    #
+# Bindings Version 2.1.6                                    #
 #                                                           #
 # 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 generator git on tinkerforge.com                   #
+# to the generators git repository on tinkerforge.com       #
 #############################################################
 
 module Tinkerforge
-  # Device with two buttons and two LEDs
+  # Two tactile buttons with built-in blue LEDs
   class BrickletDualButton < Device
     DEVICE_IDENTIFIER = 230 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Dual Button Bricklet' # :nodoc:
 
     # This callback is called whenever a button is pressed. 
     # 

data/lib/tinkerforge/bricklet_dual_relay.rb

@@ -1,18 +1,19 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2014-12-10.      #
+# This file was automatically generated on 2015-11-17.      #
 #                                                           #
-# Bindings Version 2.1.4                                    #
+# Bindings Version 2.1.6                                    #
 #                                                           #
 # 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 generator git on tinkerforge.com                   #
+# to the generators git repository on tinkerforge.com       #
 #############################################################
 
 module Tinkerforge
-  # Device for controlling two relays
+  # Two relays to switch AC/DC devices
   class BrickletDualRelay < Device
     DEVICE_IDENTIFIER = 26 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Dual Relay Bricklet' # :nodoc:
 
     # This callback is triggered whenever a monoflop timer reaches 0. The 
     # parameter contain the relay (1 or 2) and the current state of the relay 

data/lib/tinkerforge/bricklet_dust_detector.rb

@@ -0,0 +1,178 @@
+# -*- ruby encoding: utf-8 -*-
+#############################################################
+# This file was automatically generated on 2015-11-17.      #
+#                                                           #
+# Bindings Version 2.1.6                                    #
+#                                                           #
+# 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       #
+#############################################################
+
+module Tinkerforge
+  # Measures dust density
+  class BrickletDustDetector < Device
+    DEVICE_IDENTIFIER = 260 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Dust Detector Bricklet' # :nodoc:
+
+    # This callback is triggered periodically with the period that is set by
+    # BrickletDustDetector#set_dust_density_callback_period. The parameter is the 
+    # dust density of the sensor.
+    # 
+    # CALLBACK_DUST_DENSITY is only triggered if the dust density value has changed since the
+    # last triggering.
+    CALLBACK_DUST_DENSITY = 8
+
+    # This callback is triggered when the threshold as set by
+    # BrickletDustDetector#set_dust_density_callback_threshold is reached.
+    # The parameter is the dust density of the sensor.
+    # 
+    # If the threshold keeps being reached, the callback is triggered periodically
+    # with the period as set by BrickletDustDetector#set_debounce_period.
+    CALLBACK_DUST_DENSITY_REACHED = 9
+
+    FUNCTION_GET_DUST_DENSITY = 1 # :nodoc:
+    FUNCTION_SET_DUST_DENSITY_CALLBACK_PERIOD = 2 # :nodoc:
+    FUNCTION_GET_DUST_DENSITY_CALLBACK_PERIOD = 3 # :nodoc:
+    FUNCTION_SET_DUST_DENSITY_CALLBACK_THRESHOLD = 4 # :nodoc:
+    FUNCTION_GET_DUST_DENSITY_CALLBACK_THRESHOLD = 5 # :nodoc:
+    FUNCTION_SET_DEBOUNCE_PERIOD = 6 # :nodoc:
+    FUNCTION_GET_DEBOUNCE_PERIOD = 7 # :nodoc:
+    FUNCTION_SET_MOVING_AVERAGE = 10 # :nodoc:
+    FUNCTION_GET_MOVING_AVERAGE = 11 # :nodoc:
+    FUNCTION_GET_IDENTITY = 255 # :nodoc:
+
+    THRESHOLD_OPTION_OFF = 'x' # :nodoc:
+    THRESHOLD_OPTION_OUTSIDE = 'o' # :nodoc:
+    THRESHOLD_OPTION_INSIDE = 'i' # :nodoc:
+    THRESHOLD_OPTION_SMALLER = '<' # :nodoc:
+    THRESHOLD_OPTION_GREATER = '>' # :nodoc:
+
+    # 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
+
+      @api_version = [2, 0, 0]
+
+      @response_expected[FUNCTION_GET_DUST_DENSITY] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[FUNCTION_SET_DUST_DENSITY_CALLBACK_PERIOD] = RESPONSE_EXPECTED_TRUE
+      @response_expected[FUNCTION_GET_DUST_DENSITY_CALLBACK_PERIOD] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[FUNCTION_SET_DUST_DENSITY_CALLBACK_THRESHOLD] = RESPONSE_EXPECTED_TRUE
+      @response_expected[FUNCTION_GET_DUST_DENSITY_CALLBACK_THRESHOLD] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[FUNCTION_SET_DEBOUNCE_PERIOD] = RESPONSE_EXPECTED_TRUE
+      @response_expected[FUNCTION_GET_DEBOUNCE_PERIOD] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[CALLBACK_DUST_DENSITY] = RESPONSE_EXPECTED_ALWAYS_FALSE
+      @response_expected[CALLBACK_DUST_DENSITY_REACHED] = RESPONSE_EXPECTED_ALWAYS_FALSE
+      @response_expected[FUNCTION_SET_MOVING_AVERAGE] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_GET_MOVING_AVERAGE] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[FUNCTION_GET_IDENTITY] = RESPONSE_EXPECTED_ALWAYS_TRUE
+
+      @callback_formats[CALLBACK_DUST_DENSITY] = 'S'
+      @callback_formats[CALLBACK_DUST_DENSITY_REACHED] = 'S'
+    end
+
+    # Returns the dust density in µg/m³.
+    # 
+    # If you want to get the dust density periodically, it is recommended 
+    # to use the callback CALLBACK_DUST_DENSITY and set the period with 
+    # BrickletDustDetector#set_dust_density_callback_period.
+    def get_dust_density
+      send_request(FUNCTION_GET_DUST_DENSITY, [], '', 2, 'S')
+    end
+
+    # Sets the period in ms with which the CALLBACK_DUST_DENSITY callback is triggered
+    # periodically. A value of 0 turns the callback off.
+    # 
+    # CALLBACK_DUST_DENSITY is only triggered if the dust density has changed since the
+    # last triggering.
+    # 
+    # The default value is 0.
+    def set_dust_density_callback_period(period)
+      send_request(FUNCTION_SET_DUST_DENSITY_CALLBACK_PERIOD, [period], 'L', 0, '')
+    end
+
+    # Returns the period as set by BrickletDustDetector#set_dust_density_callback_period.
+    def get_dust_density_callback_period
+      send_request(FUNCTION_GET_DUST_DENSITY_CALLBACK_PERIOD, [], '', 4, 'L')
+    end
+
+    # Sets the thresholds for the CALLBACK_DUST_DENSITY_REACHED callback. 
+    # 
+    # The following options are possible:
+    # 
+    #  "Option", "Description"
+    # 
+    #  "'x'",    "Callback is turned off"
+    #  "'o'",    "Callback is triggered when the dust density value is *outside* the min and max values"
+    #  "'i'",    "Callback is triggered when the dust density value is *inside* the min and max values"
+    #  "'<'",    "Callback is triggered when the dust density value is smaller than the min value (max is ignored)"
+    #  "'>'",    "Callback is triggered when the dust density value is greater than the min value (max is ignored)"
+    # 
+    # The default value is ('x', 0, 0).
+    def set_dust_density_callback_threshold(option, min, max)
+      send_request(FUNCTION_SET_DUST_DENSITY_CALLBACK_THRESHOLD, [option, min, max], 'k S S', 0, '')
+    end
+
+    # Returns the threshold as set by BrickletDustDetector#set_dust_density_callback_threshold.
+    def get_dust_density_callback_threshold
+      send_request(FUNCTION_GET_DUST_DENSITY_CALLBACK_THRESHOLD, [], '', 5, 'k S S')
+    end
+
+    # Sets the period in ms with which the threshold callback
+    # 
+    # * CALLBACK_DUST_DENSITY_REACHED
+    # 
+    # is triggered, if the threshold
+    # 
+    # * BrickletDustDetector#set_dust_density_callback_threshold
+    # 
+    # keeps being reached.
+    # 
+    # The default value is 100.
+    def set_debounce_period(debounce)
+      send_request(FUNCTION_SET_DEBOUNCE_PERIOD, [debounce], 'L', 0, '')
+    end
+
+    # Returns the debounce period as set by BrickletDustDetector#set_debounce_period.
+    def get_debounce_period
+      send_request(FUNCTION_GET_DEBOUNCE_PERIOD, [], '', 4, 'L')
+    end
+
+    # Sets the length of a `moving averaging <https://en.wikipedia.org/wiki/Moving_average>`__
+    # for the dust_density.
+    # 
+    # Setting the length to 0 will turn the averaging completely off. With less
+    # averaging, there is more noise on the data.
+    # 
+    # The range for the averaging is 0-100.
+    # 
+    # The default value is 100.
+    def set_moving_average(average)
+      send_request(FUNCTION_SET_MOVING_AVERAGE, [average], 'C', 0, '')
+    end
+
+    # Returns the length moving average as set by BrickletDustDetector#set_moving_average.
+    def get_moving_average
+      send_request(FUNCTION_GET_MOVING_AVERAGE, [], '', 1, 'C')
+    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 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')
+    end
+
+    # Registers a callback with ID <tt>id</tt> to the block <tt>block</tt>.
+    def register_callback(id, &block)
+      callback = block
+      @registered_callbacks[id] = callback
+    end
+  end
+end