tinkerforge 2.1.4 → 2.1.6

data/lib/tinkerforge/bricklet_moisture.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 Moisture
+  # Measures soil moisture
   class BrickletMoisture < Device
     DEVICE_IDENTIFIER = 232 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Moisture Bricklet' # :nodoc:
 
     # This callback is triggered periodically with the period that is set by
     # BrickletMoisture#set_moisture_callback_period. The parameter is the moisture value
@@ -140,7 +141,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 moisture value.
     # 
     # Setting the length to 0 will turn the averaging completely off. With less

data/lib/tinkerforge/bricklet_motion_detector.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 that reads out PIR motion detector
+  # Passive infrared (PIR) motion sensor, 7m range
   class BrickletMotionDetector < Device
     DEVICE_IDENTIFIER = 233 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Motion Detector Bricklet' # :nodoc:
 
     # This callback is called after a motion was detected.
     CALLBACK_MOTION_DETECTED = 2

data/lib/tinkerforge/bricklet_multi_touch.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 12 touch sensors
+  # Capacitive touch sensor for 12 electrodes
   class BrickletMultiTouch < Device
     DEVICE_IDENTIFIER = 234 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Multi Touch Bricklet' # :nodoc:
 
     # Returns the current touch state, see BrickletMultiTouch#get_touch_state for
     # information about the state.

data/lib/tinkerforge/bricklet_nfc_rfid.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 that can read and write NFC and RFID tags
+  # Reads and writes NFC and RFID tags
   class BrickletNFCRFID < Device
     DEVICE_IDENTIFIER = 246 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'NFC/RFID Bricklet' # :nodoc:
 
     # This callback is called if the state of the NFC/RFID Bricklet changes.
     # See BrickletNFCRFID#get_state for more information about the possible states.
@@ -75,9 +76,9 @@ module Tinkerforge
     # 
     # Current the following tag types are supported:
     # 
-    # * Mifare Classic (``tag_type`` = 0)
-    # * NFC Forum Type 1 (``tag_type`` = 1)
-    # * NFC Forum Type 2 (``tag_type`` = 2)
+    # * Mifare Classic
+    # * NFC Forum Type 1
+    # * NFC Forum Type 2
     # 
     # After you call BrickletNFCRFID#request_tag_id the NFC/RFID Bricklet will try to read 
     # the tag ID from the tag. After this process is done the state will change.
@@ -107,9 +108,10 @@ module Tinkerforge
     # 
     # To get the tag ID of a tag the approach is as follows:
     # 
-    # * Call BrickletNFCRFID#request_tag_id
-    # * Wait for state to change to *RequestTagIDReady* (see BrickletNFCRFID#get_state or CALLBACK_STATE_CHANGED)
-    # * Call BrickletNFCRFID#get_tag_id
+    # 1. Call BrickletNFCRFID#request_tag_id
+    # 2. Wait for state to change to *RequestTagIDReady* (see BrickletNFCRFID#get_state or
+    #    CALLBACK_STATE_CHANGED)
+    # 3. Call BrickletNFCRFID#get_tag_id
     def get_tag_id
       send_request(FUNCTION_GET_TAG_ID, [], '', 9, 'C C C7')
     end
@@ -128,24 +130,6 @@ module Tinkerforge
     # didn't. If the request worked you can get the page by calling BrickletNFCRFID#get_page.
     # 
     # The same approach is used analogously for the other API functions.
-    # 
-    # Possible states are:
-    # 
-    # * Initialization = 0
-    # * Idle = 128
-    # * Error = 192
-    # * RequestTagID = 2
-    # * RequestTagIDReady = 130
-    # * RequestTagIDError = 194
-    # * AuthenticatingMifareClassicPage = 3
-    # * AuthenticatingMifareClassicPageReady = 131
-    # * AuthenticatingMifareClassicPageError = 195
-    # * WritePage = 4
-    # * WritePageReady = 132
-    # * WritePageError = 196
-    # * RequestPage = 5
-    # * RequestPageReady = 133
-    # * RequestPageError = 197
     def get_state
       send_request(FUNCTION_GET_STATE, [], '', 2, 'C ?')
     end
@@ -159,13 +143,15 @@ module Tinkerforge
     # 
     # The approach to read or write a Mifare Classic page is as follows:
     # 
-    # * Call BrickletNFCRFID#request_tag_id
-    # * Wait for state to change to *RequestTagIDReady* (see BrickletNFCRFID#get_state
-    #   or CALLBACK_STATE_CHANGED)
-    # * Call BrickletNFCRFID#get_tag_id and check if tag ID is correct
-    # * Call BrickletNFCRFID#authenticate_mifare_classic_page with page and key for the page
-    # * Wait for state to change to *AuthenticatingMifareClassicPageReady*
-    # * Call BrickletNFCRFID#request_page or :func`WritePage` to read/write page
+    # 1. Call BrickletNFCRFID#request_tag_id
+    # 2. Wait for state to change to *RequestTagIDReady* (see BrickletNFCRFID#get_state
+    #    or CALLBACK_STATE_CHANGED)
+    # 3. If looking for a specific tag then call BrickletNFCRFID#get_tag_id and check if the
+    #    expected tag was found, if it was not found got back to step 1
+    # 4. Call BrickletNFCRFID#authenticate_mifare_classic_page with page and key for the page
+    # 5. Wait for state to change to *AuthenticatingMifareClassicPageReady* (see
+    #    BrickletNFCRFID#get_state or CALLBACK_STATE_CHANGED)
+    # 6. Call BrickletNFCRFID#request_page or BrickletNFCRFID#write_page to read/write page
     def authenticate_mifare_classic_page(page, key_number, key)
       send_request(FUNCTION_AUTHENTICATE_MIFARE_CLASSIC_PAGE, [page, key_number, key], 'S C C6', 0, '')
     end
@@ -179,11 +165,14 @@ module Tinkerforge
     # 
     # The general approach for writing to a tag is as follows:
     # 
-    # * Call BrickletNFCRFID#request_tag_id
-    # * Wait for state to change to *RequestTagIDReady* (see BrickletNFCRFID#get_state or CALLBACK_STATE_CHANGED)
-    # * Call BrickletNFCRFID#get_tag_id and check if tag ID is correct
-    # * Call BrickletNFCRFID#write_page with page number and data
-    # * Wait for state to change to *WritePageReady*
+    # 1. Call BrickletNFCRFID#request_tag_id
+    # 2. Wait for state to change to *RequestTagIDReady* (see BrickletNFCRFID#get_state or
+    #    CALLBACK_STATE_CHANGED)
+    # 3. If looking for a specific tag then call BrickletNFCRFID#get_tag_id and check if the
+    #    expected tag was found, if it was not found got back to step 1
+    # 4. Call BrickletNFCRFID#write_page with page number and data
+    # 5. Wait for state to change to *WritePageReady* (see BrickletNFCRFID#get_state or
+    #    CALLBACK_STATE_CHANGED)
     # 
     # If you use a Mifare Classic tag you have to authenticate a page before you
     # can write to it. See BrickletNFCRFID#authenticate_mifare_classic_page.
@@ -202,12 +191,15 @@ module Tinkerforge
     # 
     # The general approach for reading a tag is as follows:
     # 
-    # * Call BrickletNFCRFID#request_tag_id
-    # * Wait for state to change to *RequestTagIDReady* (see BrickletNFCRFID#get_state or CALLBACK_STATE_CHANGED)
-    # * Call BrickletNFCRFID#get_tag_id and check if tag ID is correct
-    # * Call BrickletNFCRFID#request_page with page number
-    # * Wait for state to change to *RequestPageReady*
-    # * Call BrickletNFCRFID#get_page to retrieve the page from the buffer
+    # 1. Call BrickletNFCRFID#request_tag_id
+    # 2. Wait for state to change to *RequestTagIDReady* (see BrickletNFCRFID#get_state
+    #    or CALLBACK_STATE_CHANGED)
+    # 3. If looking for a specific tag then call BrickletNFCRFID#get_tag_id and check if the
+    #    expected tag was found, if it was not found got back to step 1
+    # 4. Call BrickletNFCRFID#request_page with page number
+    # 5. Wait for state to change to *RequestPageReady* (see BrickletNFCRFID#get_state
+    #    or CALLBACK_STATE_CHANGED)
+    # 6. Call BrickletNFCRFID#get_page to retrieve the page from the buffer
     # 
     # If you use a Mifare Classic tag you have to authenticate a page before you
     # can read it. See BrickletNFCRFID#authenticate_mifare_classic_page.

data/lib/tinkerforge/bricklet_piezo_buzzer.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 a piezo buzzer
+  # Creates 1kHz beep
   class BrickletPiezoBuzzer < Device
     DEVICE_IDENTIFIER = 214 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Piezo Buzzer Bricklet' # :nodoc:
 
     # This callback is triggered if a beep set by BrickletPiezoBuzzer#beep is finished
     CALLBACK_BEEP_FINISHED = 3

data/lib/tinkerforge/bricklet_piezo_speaker.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 a piezo buzzer with configurable frequencies
+  # Creates beep with configurable frequency
   class BrickletPiezoSpeaker < Device
     DEVICE_IDENTIFIER = 242 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Piezo Speaker Bricklet' # :nodoc:
 
     # This callback is triggered if a beep set by BrickletPiezoSpeaker#beep is finished
     CALLBACK_BEEP_FINISHED = 4
@@ -52,7 +53,7 @@ module Tinkerforge
     # the piezo buzzer will beep for one second with a frequency of
     # approximately 2 kHz.
     # 
-    # .. versionchanged:: 2.0.2~(Plugin)
+    # .. versionchanged:: 2.0.2$nbsp;(Plugin)
     #    A duration of 0 stops the current beep if any, the frequency parameter is
     #    ignored. A duration of 4294967295 results in an infinite beep.
     # 

data/lib/tinkerforge/bricklet_ptc.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 reading temperatures from Pt100 or Pt1000 sensors
+  # Reads temperatures from Pt100 und Pt1000 sensors
   class BrickletPTC < Device
     DEVICE_IDENTIFIER = 226 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'PTC Bricklet' # :nodoc:
 
     # This callback is triggered periodically with the period that is set by
     # BrickletPTC#set_temperature_callback_period. The parameter is the temperature

data/lib/tinkerforge/bricklet_remote_switch.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 that controls mains switches remotely
+  # Controls remote mains switches
   class BrickletRemoteSwitch < Device
     DEVICE_IDENTIFIER = 235 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Remote Switch Bricklet' # :nodoc:
 
     # This callback is called whenever the switching state changes
     # from busy to ready, see BrickletRemoteSwitch#get_switching_state.
@@ -94,7 +95,7 @@ module Tinkerforge
     # A detailed description on how you can figure out the house and receiver code
     # can be found :ref:`here <remote_switch_bricklet_type_a_house_and_receiver_code>`.
     # 
-    # .. versionadded:: 2.0.1~(Plugin)
+    # .. versionadded:: 2.0.1$nbsp;(Plugin)
     def switch_socket_a(house_code, receiver_code, switch_to)
       send_request(FUNCTION_SWITCH_SOCKET_A, [house_code, receiver_code, switch_to], 'C C C', 0, '')
     end
@@ -109,7 +110,7 @@ module Tinkerforge
     # A detailed description on how you can teach a socket the address and unit can
     # be found :ref:`here <remote_switch_bricklet_type_b_address_and_unit>`.
     # 
-    # .. versionadded:: 2.0.1~(Plugin)
+    # .. versionadded:: 2.0.1$nbsp;(Plugin)
     def switch_socket_b(address, unit, switch_to)
       send_request(FUNCTION_SWITCH_SOCKET_B, [address, unit, switch_to], 'L C C', 0, '')
     end
@@ -123,7 +124,7 @@ module Tinkerforge
     # A detailed description on how you can teach a dimmer the address and unit can
     # be found :ref:`here <remote_switch_bricklet_type_b_address_and_unit>`.
     # 
-    # .. versionadded:: 2.0.1~(Plugin)
+    # .. versionadded:: 2.0.1$nbsp;(Plugin)
     def dim_socket_b(address, unit, dim_value)
       send_request(FUNCTION_DIM_SOCKET_B, [address, unit, dim_value], 'L C C', 0, '')
     end
@@ -137,7 +138,7 @@ module Tinkerforge
     # A detailed description on how you can figure out the system and device code
     # can be found :ref:`here <remote_switch_bricklet_type_c_system_and_device_code>`.
     # 
-    # .. versionadded:: 2.0.1~(Plugin)
+    # .. versionadded:: 2.0.1$nbsp;(Plugin)
     def switch_socket_c(system_code, device_code, switch_to)
       send_request(FUNCTION_SWITCH_SOCKET_C, [system_code, device_code, switch_to], 'k C C', 0, '')
     end

data/lib/tinkerforge/bricklet_rotary_encoder.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 Rotary Encoder input
+  # 360° rotary encoder with push-button
   class BrickletRotaryEncoder < Device
     DEVICE_IDENTIFIER = 236 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Rotary Encoder Bricklet' # :nodoc:
 
     # This callback is triggered periodically with the period that is set by
     # BrickletRotaryEncoder#set_count_callback_period. The parameter is the count of

data/lib/tinkerforge/bricklet_rotary_poti.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 Rotary Potentiometer input
+  # 300° rotary potentiometer
   class BrickletRotaryPoti < Device
     DEVICE_IDENTIFIER = 215 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'Rotary Poti Bricklet' # :nodoc:
 
     # This callback is triggered periodically with the period that is set by
     # BrickletRotaryPoti#set_position_callback_period. The parameter is the position of the

data/lib/tinkerforge/bricklet_rs232.rb

@@ -0,0 +1,183 @@
+# -*- 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
+  # Communicates with RS232 devices
+  class BrickletRS232 < Device
+    DEVICE_IDENTIFIER = 254 # :nodoc:
+    DEVICE_DISPLAY_NAME = 'RS232 Bricklet' # :nodoc:
+
+    # This callback is called if new data is available. The message has
+    # a maximum size of 60 characters. The actual length of the message
+    # is given in addition.
+    # 
+    # To enable this callback, use BrickletRS232#enable_read_callback.
+    CALLBACK_READ_CALLBACK = 8
+
+    # This callback is called if an error occurs. 
+    # Possible errors are overrun, parity or framing error.
+    # 
+    # .. versionadded:: 2.0.1$nbsp;(Plugin)
+    CALLBACK_ERROR_CALLBACK = 9
+
+    FUNCTION_WRITE = 1 # :nodoc:
+    FUNCTION_READ = 2 # :nodoc:
+    FUNCTION_ENABLE_READ_CALLBACK = 3 # :nodoc:
+    FUNCTION_DISABLE_READ_CALLBACK = 4 # :nodoc:
+    FUNCTION_IS_READ_CALLBACK_ENABLED = 5 # :nodoc:
+    FUNCTION_SET_CONFIGURATION = 6 # :nodoc:
+    FUNCTION_GET_CONFIGURATION = 7 # :nodoc:
+    FUNCTION_SET_BREAK_CONDITION = 10 # :nodoc:
+    FUNCTION_GET_IDENTITY = 255 # :nodoc:
+
+    BAUDRATE_300 = 0 # :nodoc:
+    BAUDRATE_600 = 1 # :nodoc:
+    BAUDRATE_1200 = 2 # :nodoc:
+    BAUDRATE_2400 = 3 # :nodoc:
+    BAUDRATE_4800 = 4 # :nodoc:
+    BAUDRATE_9600 = 5 # :nodoc:
+    BAUDRATE_14400 = 6 # :nodoc:
+    BAUDRATE_19200 = 7 # :nodoc:
+    BAUDRATE_28800 = 8 # :nodoc:
+    BAUDRATE_38400 = 9 # :nodoc:
+    BAUDRATE_57600 = 10 # :nodoc:
+    BAUDRATE_115200 = 11 # :nodoc:
+    BAUDRATE_230400 = 12 # :nodoc:
+    PARITY_NONE = 0 # :nodoc:
+    PARITY_ODD = 1 # :nodoc:
+    PARITY_EVEN = 2 # :nodoc:
+    PARITY_FORCED_PARITY_1 = 3 # :nodoc:
+    PARITY_FORCED_PARITY_0 = 4 # :nodoc:
+    STOPBITS_1 = 1 # :nodoc:
+    STOPBITS_2 = 2 # :nodoc:
+    WORDLENGTH_5 = 5 # :nodoc:
+    WORDLENGTH_6 = 6 # :nodoc:
+    WORDLENGTH_7 = 7 # :nodoc:
+    WORDLENGTH_8 = 8 # :nodoc:
+    HARDWARE_FLOWCONTROL_OFF = 0 # :nodoc:
+    HARDWARE_FLOWCONTROL_ON = 1 # :nodoc:
+    SOFTWARE_FLOWCONTROL_OFF = 0 # :nodoc:
+    SOFTWARE_FLOWCONTROL_ON = 1 # :nodoc:
+    ERROR_OVERRUN = 1 # :nodoc:
+    ERROR_PARITY = 2 # :nodoc:
+    ERROR_FRAMING = 4 # :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, 2]
+
+      @response_expected[FUNCTION_WRITE] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[FUNCTION_READ] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[FUNCTION_ENABLE_READ_CALLBACK] = RESPONSE_EXPECTED_TRUE
+      @response_expected[FUNCTION_DISABLE_READ_CALLBACK] = RESPONSE_EXPECTED_TRUE
+      @response_expected[FUNCTION_IS_READ_CALLBACK_ENABLED] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[FUNCTION_SET_CONFIGURATION] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_GET_CONFIGURATION] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[CALLBACK_READ_CALLBACK] = RESPONSE_EXPECTED_ALWAYS_FALSE
+      @response_expected[CALLBACK_ERROR_CALLBACK] = RESPONSE_EXPECTED_ALWAYS_FALSE
+      @response_expected[FUNCTION_SET_BREAK_CONDITION] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_GET_IDENTITY] = RESPONSE_EXPECTED_ALWAYS_TRUE
+
+      @callback_formats[CALLBACK_READ_CALLBACK] = 'k60 C'
+      @callback_formats[CALLBACK_ERROR_CALLBACK] = 'C'
+    end
+
+    # Writes a string of up to 60 characters to the RS232 interface. The string
+    # can be binary data, ASCII or similar is not necessary.
+    # 
+    # The length of the string has to be given as an additional parameter.
+    # 
+    # The return value is the number of bytes that could be written.
+    # 
+    # See :func:`SetConfigurations` for configuration possibilities
+    # regarding baudrate, parity and so on.
+    def write(message, length)
+      send_request(FUNCTION_WRITE, [message, length], 'k60 C', 1, 'C')
+    end
+
+    # Returns the currently buffered message. The maximum length
+    # of message is 60. If the length is given as 0, there was no
+    # new data available.
+    # 
+    # Instead of polling with this function, you can also use
+    # callbacks. See BrickletRS232#enable_read_callback and CALLBACK_READ_CALLBACK.
+    def read
+      send_request(FUNCTION_READ, [], '', 61, 'k60 C')
+    end
+
+    # Enables the CALLBACK_READ_CALLBACK.
+    # 
+    # By default the callback is disabled.
+    def enable_read_callback
+      send_request(FUNCTION_ENABLE_READ_CALLBACK, [], '', 0, '')
+    end
+
+    # Disables the CALLBACK_READ_CALLBACK.
+    # 
+    # By default the callback is disabled.
+    def disable_read_callback
+      send_request(FUNCTION_DISABLE_READ_CALLBACK, [], '', 0, '')
+    end
+
+    # Returns *true* if the CALLBACK_READ_CALLBACK is enabled,
+    # *false* otherwise.
+    def is_read_callback_enabled
+      send_request(FUNCTION_IS_READ_CALLBACK_ENABLED, [], '', 1, '?')
+    end
+
+    # Sets the configuration for the RS232 communication. Available options:
+    # 
+    # * Baudrate between 300 and 230400 baud.
+    # * Parity of none, odd, even or forced parity.
+    # * Stopbits can be 1 or 2.
+    # * Word length of 5 to 8.
+    # * Hard-/Software flow control can each be on or off.
+    # 
+    # The default is: 115200 baud, parity none, 1 stop bit, word length 8, hard-/software flow control off.
+    def set_configuration(baudrate, parity, stopbits, wordlength, hardware_flowcontrol, software_flowcontrol)
+      send_request(FUNCTION_SET_CONFIGURATION, [baudrate, parity, stopbits, wordlength, hardware_flowcontrol, software_flowcontrol], 'C C C C C C', 0, '')
+    end
+
+    # Returns the configuration as set by BrickletRS232#set_configuration.
+    def get_configuration
+      send_request(FUNCTION_GET_CONFIGURATION, [], '', 6, 'C C C C C C')
+    end
+
+    # Sets a break condition (the TX output is forced to a logic 0 state). 
+    # The parameter sets the hold-time of the break condition (in ms). 
+    # 
+    # .. versionadded:: 2.0.2$nbsp;(Plugin)
+    def set_break_condition(break_time)
+      send_request(FUNCTION_SET_BREAK_CONDITION, [break_time], 'S', 0, '')
+    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