tinkerforge 2.0.11 → 2.0.12

data/lib/tinkerforge/bricklet_piezo_buzzer.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2013-09-11.      #
+# This file was automatically generated on 2013-11-27.      #
 #                                                           #
-# Bindings Version 2.0.11                                    #
+# Bindings Version 2.0.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  #

data/lib/tinkerforge/bricklet_piezo_speaker.rb

@@ -0,0 +1,107 @@
+# -*- ruby encoding: utf-8 -*-
+#############################################################
+# This file was automatically generated on 2013-11-27.      #
+#                                                           #
+# Bindings Version 2.0.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  #
+# to the generator git on tinkerforge.com                   #
+#############################################################
+
+module Tinkerforge
+  # Device for controlling a piezo buzzer with configurable frequencies
+  class BrickletPiezoSpeaker < Device
+    DEVICE_IDENTIFIER = 242 # :nodoc:
+
+    # This callback is triggered if a beep set by BrickletPiezoSpeaker#beep is finished
+    CALLBACK_BEEP_FINISHED = 4
+
+    # This callback is triggered if the playback of the morse code set by
+    # BrickletPiezoSpeaker#morse_code is finished.
+    CALLBACK_MORSE_CODE_FINISHED = 5
+
+    FUNCTION_BEEP = 1 # :nodoc:
+    FUNCTION_MORSE_CODE = 2 # :nodoc:
+    FUNCTION_CALIBRATE = 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_BEEP] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_MORSE_CODE] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_CALIBRATE] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[CALLBACK_BEEP_FINISHED] = RESPONSE_EXPECTED_ALWAYS_FALSE
+      @response_expected[CALLBACK_MORSE_CODE_FINISHED] = RESPONSE_EXPECTED_ALWAYS_FALSE
+      @response_expected[FUNCTION_GET_IDENTITY] = RESPONSE_EXPECTED_ALWAYS_TRUE
+
+      @callback_formats[CALLBACK_BEEP_FINISHED] = ''
+      @callback_formats[CALLBACK_MORSE_CODE_FINISHED] = ''
+    end
+
+    # Beeps with the given frequency for the duration in ms. For example: 
+    # If you set a duration of 1000, with a frequency value of 2000
+    # the piezo buzzer will beep for one second with a frequency of
+    # approximately 2 kHz.
+    # 
+    # *frequency* can be set between 585 and 7100.
+    # 
+    # The Piezo Speaker Bricklet can only approximate the frequency, it will play
+    # the best possible match by applying the calibration (see BrickletPiezoSpeaker#calibrate).
+    def beep(duration, frequency)
+      send_request(FUNCTION_BEEP, [duration, frequency], 'L S', 0, '')
+    end
+
+    # Sets morse code that will be played by the piezo buzzer. The morse code
+    # is given as a string consisting of "." (dot), "-" (minus) and " " (space)
+    # for *dits*, *dahs* and *pauses*. Every other character is ignored.
+    # The second parameter is the frequency (see BrickletPiezoSpeaker#beep).
+    # 
+    # For example: If you set the string "...---...", the piezo buzzer will beep
+    # nine times with the durations "short short short long long long short 
+    # short short".
+    # 
+    # The maximum string size is 60.
+    def morse_code(morse, frequency)
+      send_request(FUNCTION_MORSE_CODE, [morse, frequency], 'Z60 S', 0, '')
+    end
+
+    # The Piezo Speaker Bricklet can play 512 different tones. This function
+    # plays each tone and measures the exact frequency back. The result is a
+    # mapping between setting value and frequency. This mapping is stored
+    # in the EEPROM and loaded on startup.
+    # 
+    # The Bricklet should come calibrated, you only need to call this
+    # function (once) every time you reflash the Bricklet plugin.
+    # 
+    # Returns *true* after the calibration finishes.
+    def calibrate
+      send_request(FUNCTION_CALIBRATE, [], '', 1, '?')
+    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 identifiers can be found :ref:`here <device_identifier>`.
+    # 
+    # .. versionadded:: 2.0.0~(Plugin)
+    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

data/lib/tinkerforge/bricklet_ptc.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2013-09-11.      #
+# This file was automatically generated on 2013-11-27.      #
 #                                                           #
-# Bindings Version 2.0.11                                    #
+# Bindings Version 2.0.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  #

data/lib/tinkerforge/bricklet_remote_switch.rb

@@ -0,0 +1,104 @@
+# -*- ruby encoding: utf-8 -*-
+#############################################################
+# This file was automatically generated on 2013-11-27.      #
+#                                                           #
+# Bindings Version 2.0.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  #
+# to the generator git on tinkerforge.com                   #
+#############################################################
+
+module Tinkerforge
+  # Device that controls mains switches remotely
+  class BrickletRemoteSwitch < Device
+    DEVICE_IDENTIFIER = 235 # :nodoc:
+
+    # This callback is called whenever the switching state changes
+    # from busy to ready, see BrickletRemoteSwitch#get_switching_state.
+    CALLBACK_SWITCHING_DONE = 3
+
+    FUNCTION_SWITCH_SOCKET = 1 # :nodoc:
+    FUNCTION_GET_SWITCHING_STATE = 2 # :nodoc:
+    FUNCTION_SET_REPEATS = 4 # :nodoc:
+    FUNCTION_GET_REPEATS = 5 # :nodoc:
+    FUNCTION_GET_IDENTITY = 255 # :nodoc:
+
+    SWITCH_TO_OFF = 0 # :nodoc:
+    SWITCH_TO_ON = 1 # :nodoc:
+    SWITCHING_STATE_READY = 0 # :nodoc:
+    SWITCHING_STATE_BUSY = 1 # :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_SWITCH_SOCKET] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_GET_SWITCHING_STATE] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[CALLBACK_SWITCHING_DONE] = RESPONSE_EXPECTED_ALWAYS_FALSE
+      @response_expected[FUNCTION_SET_REPEATS] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_GET_REPEATS] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[FUNCTION_GET_IDENTITY] = RESPONSE_EXPECTED_ALWAYS_TRUE
+
+      @callback_formats[CALLBACK_SWITCHING_DONE] = ''
+    end
+
+    # To switch a socket you have to give the house code, receiver code and the
+    # state (on or off) you want to switch to.
+    # 
+    # A detailed description on how you can find the house and receiver code
+    # can be found :ref:`here <remote_switch_bricklet_house_and_receiver_code>`.
+    def switch_socket(house_code, receiver_code, switch_to)
+      send_request(FUNCTION_SWITCH_SOCKET, [house_code, receiver_code, switch_to], 'C C C', 0, '')
+    end
+
+    # Returns the current switching state. If the current state is busy, the
+    # Bricklet is currently sending a code to switch a socket. It will not
+    # accept any calls of BrickletRemoteSwitch#switch_socket until the state changes to ready.
+    # 
+    # How long the switching takes is dependent on the number of repeats, see
+    # BrickletRemoteSwitch#set_repeats.
+    def get_switching_state
+      send_request(FUNCTION_GET_SWITCHING_STATE, [], '', 1, 'C')
+    end
+
+    # Sets the number of times the code is send when BrickletRemoteSwitch#switch_socket is called.
+    # The repeats basically correspond to the amount of time that a button of the
+    # remote is pressed. 
+    # 
+    # Some dimmers are controlled by the length of a button pressed,
+    # this can be simulated by increasing the repeats.
+    # 
+    # The default value is 5.
+    def set_repeats(repeats)
+      send_request(FUNCTION_SET_REPEATS, [repeats], 'C', 0, '')
+    end
+
+    # Returns the number of repeats as set by BrickletRemoteSwitch#set_repeats.
+    def get_repeats
+      send_request(FUNCTION_GET_REPEATS, [], '', 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 identifiers can be found :ref:`here <device_identifier>`.
+    # 
+    # .. versionadded:: 2.0.0~(Plugin)
+    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

data/lib/tinkerforge/bricklet_rotary_encoder.rb

@@ -0,0 +1,179 @@
+# -*- ruby encoding: utf-8 -*-
+#############################################################
+# This file was automatically generated on 2013-11-27.      #
+#                                                           #
+# Bindings Version 2.0.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  #
+# to the generator git on tinkerforge.com                   #
+#############################################################
+
+module Tinkerforge
+  # Device for sensing Rotary Encoder input
+  class BrickletRotaryEncoder < Device
+    DEVICE_IDENTIFIER = 236 # :nodoc:
+
+    # This callback is triggered periodically with the period that is set by
+    # BrickletRotaryEncoder#set_count_callback_period. The parameter is the count of
+    # the encoder.
+    # 
+    # CALLBACK_COUNT is only triggered if the count has changed since the
+    # last triggering.
+    CALLBACK_COUNT = 8
+
+    # This callback is triggered when the threshold as set by
+    # BrickletRotaryEncoder#set_count_callback_threshold is reached.
+    # The parameter is the count of the encoder.
+    # 
+    # If the threshold keeps being reached, the callback is triggered periodically
+    # with the period as set by BrickletRotaryEncoder#set_debounce_period.
+    CALLBACK_COUNT_REACHED = 9
+
+    # This callback is triggered when the button is pressed.
+    CALLBACK_PRESSED = 11
+
+    # This callback is triggered when the button is released.
+    CALLBACK_RELEASED = 12
+
+    FUNCTION_GET_COUNT = 1 # :nodoc:
+    FUNCTION_SET_COUNT_CALLBACK_PERIOD = 2 # :nodoc:
+    FUNCTION_GET_COUNT_CALLBACK_PERIOD = 3 # :nodoc:
+    FUNCTION_SET_COUNT_CALLBACK_THRESHOLD = 4 # :nodoc:
+    FUNCTION_GET_COUNT_CALLBACK_THRESHOLD = 5 # :nodoc:
+    FUNCTION_SET_DEBOUNCE_PERIOD = 6 # :nodoc:
+    FUNCTION_GET_DEBOUNCE_PERIOD = 7 # :nodoc:
+    FUNCTION_IS_PRESSED = 10 # :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_COUNT] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[FUNCTION_SET_COUNT_CALLBACK_PERIOD] = RESPONSE_EXPECTED_TRUE
+      @response_expected[FUNCTION_GET_COUNT_CALLBACK_PERIOD] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[FUNCTION_SET_COUNT_CALLBACK_THRESHOLD] = RESPONSE_EXPECTED_TRUE
+      @response_expected[FUNCTION_GET_COUNT_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_COUNT] = RESPONSE_EXPECTED_ALWAYS_FALSE
+      @response_expected[CALLBACK_COUNT_REACHED] = RESPONSE_EXPECTED_ALWAYS_FALSE
+      @response_expected[FUNCTION_IS_PRESSED] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[CALLBACK_PRESSED] = RESPONSE_EXPECTED_ALWAYS_FALSE
+      @response_expected[CALLBACK_RELEASED] = RESPONSE_EXPECTED_ALWAYS_FALSE
+      @response_expected[FUNCTION_GET_IDENTITY] = RESPONSE_EXPECTED_ALWAYS_TRUE
+
+      @callback_formats[CALLBACK_COUNT] = 'l'
+      @callback_formats[CALLBACK_COUNT_REACHED] = 'l'
+      @callback_formats[CALLBACK_PRESSED] = ''
+      @callback_formats[CALLBACK_RELEASED] = ''
+    end
+
+    # Returns the current count of the encoder. If you set reset
+    # to true, the count is set back to 0 directly after the
+    # current count is read.
+    # 
+    # The encoder has 24 steps per rotation
+    # 
+    # Turning the encoder to the left decrements the counter,
+    # so a negative count is possible.
+    def get_count(reset)
+      send_request(FUNCTION_GET_COUNT, [reset], '?', 4, 'l')
+    end
+
+    # Sets the period in ms with which the CALLBACK_COUNT callback is triggered
+    # periodically. A value of 0 turns the callback off.
+    # 
+    # CALLBACK_COUNT is only triggered if the count has changed since the
+    # last triggering.
+    # 
+    # The default value is 0.
+    def set_count_callback_period(period)
+      send_request(FUNCTION_SET_COUNT_CALLBACK_PERIOD, [period], 'L', 0, '')
+    end
+
+    # Returns the period as set by BrickletRotaryEncoder#set_count_callback_period.
+    def get_count_callback_period
+      send_request(FUNCTION_GET_COUNT_CALLBACK_PERIOD, [], '', 4, 'L')
+    end
+
+    # Sets the thresholds for the CALLBACK_COUNT_REACHED callback. 
+    # 
+    # The following options are possible:
+    # 
+    #  "Option", "Description"
+    # 
+    #  "'x'",    "Callback is turned off"
+    #  "'o'",    "Callback is triggered when the count is *outside* the min and max values"
+    #  "'i'",    "Callback is triggered when the count is *inside* the min and max values"
+    #  "'<'",    "Callback is triggered when the count is smaller than the min value (max is ignored)"
+    #  "'>'",    "Callback is triggered when the count is greater than the min value (max is ignored)"
+    # 
+    # The default value is ('x', 0, 0).
+    def set_count_callback_threshold(option, min, max)
+      send_request(FUNCTION_SET_COUNT_CALLBACK_THRESHOLD, [option, min, max], 'k l l', 0, '')
+    end
+
+    # Returns the threshold as set by BrickletRotaryEncoder#set_count_callback_threshold.
+    def get_count_callback_threshold
+      send_request(FUNCTION_GET_COUNT_CALLBACK_THRESHOLD, [], '', 9, 'k l l')
+    end
+
+    # Sets the period in ms with which the threshold callback
+    # 
+    # * CALLBACK_COUNT_REACHED
+    # 
+    # is triggered, if the thresholds
+    # 
+    # * BrickletRotaryEncoder#set_count_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 BrickletRotaryEncoder#set_debounce_period.
+    def get_debounce_period
+      send_request(FUNCTION_GET_DEBOUNCE_PERIOD, [], '', 4, 'L')
+    end
+
+    # Returns *true* if the button is pressed and *false* otherwise.
+    # 
+    # It is recommended to use the CALLBACK_PRESSED and CALLBACK_RELEASED callbacks
+    # to handle the button.
+    def is_pressed
+      send_request(FUNCTION_IS_PRESSED, [], '', 1, '?')
+    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 identifiers can be found :ref:`here <device_identifier>`.
+    # 
+    # .. versionadded:: 2.0.0~(Plugin)
+    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

data/lib/tinkerforge/bricklet_rotary_poti.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2013-09-11.      #
+# This file was automatically generated on 2013-11-27.      #
 #                                                           #
-# Bindings Version 2.0.11                                    #
+# Bindings Version 2.0.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  #

data/lib/tinkerforge/bricklet_segment_display_4x7.rb

@@ -0,0 +1,110 @@
+# -*- ruby encoding: utf-8 -*-
+#############################################################
+# This file was automatically generated on 2013-11-27.      #
+#                                                           #
+# Bindings Version 2.0.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  #
+# to the generator git on tinkerforge.com                   #
+#############################################################
+
+module Tinkerforge
+  # Device for controling four 7-segment displays
+  class BrickletSegmentDisplay4x7 < Device
+    DEVICE_IDENTIFIER = 237 # :nodoc:
+
+    # This callback is triggered when the counter (see BrickletSegmentDisplay4x7#start_counter) is
+    # finished.
+    CALLBACK_COUNTER_FINISHED = 5
+
+    FUNCTION_SET_SEGMENTS = 1 # :nodoc:
+    FUNCTION_GET_SEGMENTS = 2 # :nodoc:
+    FUNCTION_START_COUNTER = 3 # :nodoc:
+    FUNCTION_GET_COUNTER_VALUE = 4 # :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_SEGMENTS] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_GET_SEGMENTS] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[FUNCTION_START_COUNTER] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_GET_COUNTER_VALUE] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[CALLBACK_COUNTER_FINISHED] = RESPONSE_EXPECTED_ALWAYS_FALSE
+      @response_expected[FUNCTION_GET_IDENTITY] = RESPONSE_EXPECTED_ALWAYS_TRUE
+
+      @callback_formats[CALLBACK_COUNTER_FINISHED] = ''
+    end
+
+    # The 7-segment display can be set with bitmaps. Every bit controls one
+    # segment:
+    # 
+    # .. image:: /Images/Bricklets/bricklet_segment_display_4x7_bit_order.png
+    #    :scale: 100 %
+    #    :alt: Bit order of one segment
+    #    :align: center
+    # 
+    # For example to set a "5" you would want to activate segments 0, 2, 3, 5 and 6.
+    # This is represented by the number 0b00110101 = 0x35 = 53.
+    # 
+    # The brightness can be set between 0 (dark) and 7 (bright). The colon
+    # parameter turns the colon of the display on or off.
+    def set_segments(segments, brightness, colon)
+      send_request(FUNCTION_SET_SEGMENTS, [segments, brightness, colon], 'C4 C ?', 0, '')
+    end
+
+    # Returns the segment, brightness and color data as set by 
+    # BrickletSegmentDisplay4x7#set_segments.
+    def get_segments
+      send_request(FUNCTION_GET_SEGMENTS, [], '', 6, 'C4 C ?')
+    end
+
+    # Starts a counter with the *from* value that counts to the *to*
+    # value with the each step incremented by *increment*.
+    # The *length* of the increment is given in ms.
+    # 
+    # Example: If you set *from* to 0, *to* to 100, *increment* to 1 and
+    # *length* to 1000, a counter that goes from 0 to 100 with 1 second
+    # pause between each increment will be started.
+    # 
+    # The maximum values for *from*, *to* and *increment* is 9999, 
+    # the minimum value is -999.
+    # 
+    # You can stop the counter at every time by calling BrickletSegmentDisplay4x7#set_segments.
+    def start_counter(value_from, value_to, increment, length)
+      send_request(FUNCTION_START_COUNTER, [value_from, value_to, increment, length], 's s s L', 0, '')
+    end
+
+    # Returns the counter value that is currently shown on the display.
+    # 
+    # If there is no counter running a 0 will be returned.
+    def get_counter_value
+      send_request(FUNCTION_GET_COUNTER_VALUE, [], '', 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 identifiers can be found :ref:`here <device_identifier>`.
+    # 
+    # .. versionadded:: 2.0.0~(Plugin)
+    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