tinkerforge 2.1.22 → 2.1.23

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7992b4183f407bb3f941b2a6e526f8b5825797451a3a3df1b947203681934df5
-  data.tar.gz: c9d4b8d0945b8b25cd656d2041fc923ba7055780d4e52b04a94accd344d1f2f8
+  metadata.gz: dd64988900a2ab596ea927820dc04695bc91f1b194cbf6cb35e85ec89014f26c
+  data.tar.gz: 658c988980986bed5dad437fd81d2ad7c39b109cbdc0bdb946b3706d4baf18e3
 SHA512:
-  metadata.gz: 11b45fd4643794ab3f53e8c5a534f0f31c1f2b8853c33bd3eda85ecd0a2441e3c698ea50a99e4762ac1a49f6baf92d968cd461571215b9d78d1b3eb32d6c1b0f
-  data.tar.gz: d6dddff82d677f23a37b09f19e4c47ab8ed2c4d3ff1452262d4c38e0a67618da68e73431a822d9acf2c95991883cc96115a00764525f4a46a865b0867ceadcd5
+  metadata.gz: 8a5c039bbbecf10223b7e7c47beae80a3123cf0297a2e4c74066ed45495bcebb6d04e468bcbafe50dcc4be43e23b38fcd94dbabb1adad8e5b6f7b06c6c387a79
+  data.tar.gz: 31d3663aea0a113e769a4bfd49383e7c638944f424ee3a729ebec9aecdac9db3912a1d7d387770d4db9224d8b0c6fe0fa9566592866a5004585368867507df9b

data/lib/tinkerforge/brick_dc.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-05-21.      #
+# This file was automatically generated on 2019-08-23.      #
 #                                                           #
-# Ruby Bindings Version 2.1.22                              #
+# Ruby Bindings Version 2.1.23                              #
 #                                                           #
 # 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  #
@@ -465,7 +465,7 @@ module Tinkerforge
     # value returned is not the ambient temperature!
     # 
     # The temperature is only proportional to the real temperature and it has an
-    # accuracy of +-15%. Practically it is only useful as an indicator for
+    # accuracy of ±15%. Practically it is only useful as an indicator for
     # temperature changes.
     def get_chip_temperature
       send_request FUNCTION_GET_CHIP_TEMPERATURE, [], '', 2, 's'

data/lib/tinkerforge/brick_hat.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-05-21.      #
+# This file was automatically generated on 2019-08-23.      #
 #                                                           #
-# Ruby Bindings Version 2.1.22                              #
+# Ruby Bindings Version 2.1.23                              #
 #                                                           #
 # 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  #
@@ -79,17 +79,21 @@ module Tinkerforge
 
     # Sets the sleep mode.
     # 
+    # .. note::
+    #  Calling this function will cut the Raspberry Pi's power after Power Off Delay seconds.
+    #  You have to shut down the Operating System yourself, e.g. by calling 'sudo shutdown -h now'.
+    # 
     # Parameters:
     # 
-    # * Power Off Delay: Time before the RPi/Bricklets are powered off in seconds.
-    # * Power Off Duration: Duration that the RPi/Bricklets stay powered off in seconds.
-    # * Raspberry Pi Off: RPi if powereed off if set to true.
+    # * Power Off Delay: Time in seconds before the RPi/Bricklets are powered off.
+    # * Power Off Duration: Duration in seconds that the RPi/Bricklets stay powered off.
+    # * Raspberry Pi Off: RPi is powered off if set to true.
     # * Bricklets Off: Bricklets are powered off if set to true.
     # * Enable Sleep Indicator: If set to true, the status LED will blink in a 1s interval
-    #   during the whole power off duration. This will draw an additional 0.3mA.
+    #   during the whole power off duration. This will draw additional 0.3mA.
     # 
     # Example: To turn RPi and Bricklets off in 5 seconds for 10 minutes with sleep
-    # indicator enabled call (5, 60*10, true, true, true).
+    # indicator enabled, call (5, 60*10, true, true, true).
     # 
     # This function can also be used to implement a watchdog. To do this you can
     # write a program that calls this function once per second in a loop with

data/lib/tinkerforge/brick_hat_zero.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-05-21.      #
+# This file was automatically generated on 2019-08-23.      #
 #                                                           #
-# Ruby Bindings Version 2.1.22                              #
+# Ruby Bindings Version 2.1.23                              #
 #                                                           #
 # 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/brick_imu.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-05-21.      #
+# This file was automatically generated on 2019-08-23.      #
 #                                                           #
-# Ruby Bindings Version 2.1.22                              #
+# Ruby Bindings Version 2.1.23                              #
 #                                                           #
 # 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  #
@@ -625,7 +625,7 @@ module Tinkerforge
     # value returned is not the ambient temperature!
     # 
     # The temperature is only proportional to the real temperature and it has an
-    # accuracy of +-15%. Practically it is only useful as an indicator for
+    # accuracy of ±15%. Practically it is only useful as an indicator for
     # temperature changes.
     def get_chip_temperature
       send_request FUNCTION_GET_CHIP_TEMPERATURE, [], '', 2, 's'

data/lib/tinkerforge/brick_imu_v2.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-05-21.      #
+# This file was automatically generated on 2019-08-23.      #
 #                                                           #
-# Ruby Bindings Version 2.1.22                              #
+# Ruby Bindings Version 2.1.23                              #
 #                                                           #
 # 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  #
@@ -674,7 +674,7 @@ module Tinkerforge
     # value returned is not the ambient temperature!
     # 
     # The temperature is only proportional to the real temperature and it has an
-    # accuracy of +-15%. Practically it is only useful as an indicator for
+    # accuracy of ±15%. Practically it is only useful as an indicator for
     # temperature changes.
     def get_chip_temperature
       send_request FUNCTION_GET_CHIP_TEMPERATURE, [], '', 2, 's'

data/lib/tinkerforge/brick_master.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-05-21.      #
+# This file was automatically generated on 2019-08-23.      #
 #                                                           #
-# Ruby Bindings Version 2.1.22                              #
+# Ruby Bindings Version 2.1.23                              #
 #                                                           #
 # 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  #
@@ -554,7 +554,7 @@ module Tinkerforge
     # Sets the channel used by the Chibi Extension. Possible channels are
     # different for different frequencies:
     # 
-    #  "Frequency",             "Possible Channels"
+    #  "Frequency", "Possible Channels"
     # 
     #  "OQPSK 868MHz (Europe)", "0"
     #  "OQPSK 915MHz (US)",     "1, 2, 3, 4, 5, 6, 7, 8, 9, 10"
@@ -1487,7 +1487,7 @@ module Tinkerforge
       send_request FUNCTION_GET_WIFI2_AP_CONFIGURATION, [], '', 54, '? Z32 C4 C4 C4 C ? C C6'
     end
 
-    # Sets the access point password (up to 63 chars) for the configured encryption
+    # Sets the access point password (at least 8 and up to 63 chars) for the configured encryption
     # mode, see BrickMaster#set_wifi2_ap_configuration.
     # 
     # To apply configuration changes to the WIFI Extension 2.0 the
@@ -1816,7 +1816,7 @@ module Tinkerforge
     # value returned is not the ambient temperature!
     # 
     # The temperature is only proportional to the real temperature and it has an
-    # accuracy of +-15%. Practically it is only useful as an indicator for
+    # accuracy of ±15%. Practically it is only useful as an indicator for
     # temperature changes.
     def get_chip_temperature
       send_request FUNCTION_GET_CHIP_TEMPERATURE, [], '', 2, 's'

data/lib/tinkerforge/brick_red.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-05-21.      #
+# This file was automatically generated on 2019-08-23.      #
 #                                                           #
-# Ruby Bindings Version 2.1.22                              #
+# Ruby Bindings Version 2.1.23                              #
 #                                                           #
 # 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/brick_servo.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-05-21.      #
+# This file was automatically generated on 2019-08-23.      #
 #                                                           #
-# Ruby Bindings Version 2.1.22                              #
+# Ruby Bindings Version 2.1.23                              #
 #                                                           #
 # 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  #
@@ -584,7 +584,7 @@ module Tinkerforge
     # value returned is not the ambient temperature!
     # 
     # The temperature is only proportional to the real temperature and it has an
-    # accuracy of +-15%. Practically it is only useful as an indicator for
+    # accuracy of ±15%. Practically it is only useful as an indicator for
     # temperature changes.
     def get_chip_temperature
       send_request FUNCTION_GET_CHIP_TEMPERATURE, [], '', 2, 's'

data/lib/tinkerforge/brick_silent_stepper.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-05-21.      #
+# This file was automatically generated on 2019-08-23.      #
 #                                                           #
-# Ruby Bindings Version 2.1.22                              #
+# Ruby Bindings Version 2.1.23                              #
 #                                                           #
 # 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  #
@@ -878,7 +878,7 @@ module Tinkerforge
     # value returned is not the ambient temperature!
     # 
     # The temperature is only proportional to the real temperature and it has an
-    # accuracy of +-15%. Practically it is only useful as an indicator for
+    # accuracy of ±15%. Practically it is only useful as an indicator for
     # temperature changes.
     def get_chip_temperature
       send_request FUNCTION_GET_CHIP_TEMPERATURE, [], '', 2, 's'

data/lib/tinkerforge/brick_stepper.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-05-21.      #
+# This file was automatically generated on 2019-08-23.      #
 #                                                           #
-# Ruby Bindings Version 2.1.22                              #
+# Ruby Bindings Version 2.1.23                              #
 #                                                           #
 # 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  #
@@ -393,7 +393,7 @@ module Tinkerforge
     # is enabled (see BrickStepper#set_sync_rect).
     # 
     # For a good explanation of the different decay modes see
-    # `this <http://ebldc.com/?p=86/>`__ blog post by Avayan.
+    # `this <https://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
@@ -635,7 +635,7 @@ module Tinkerforge
     # value returned is not the ambient temperature!
     # 
     # The temperature is only proportional to the real temperature and it has an
-    # accuracy of +-15%. Practically it is only useful as an indicator for
+    # accuracy of ±15%. Practically it is only useful as an indicator for
     # temperature changes.
     def get_chip_temperature
       send_request FUNCTION_GET_CHIP_TEMPERATURE, [], '', 2, 's'

data/lib/tinkerforge/bricklet_accelerometer.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-05-21.      #
+# This file was automatically generated on 2019-08-23.      #
 #                                                           #
-# Ruby Bindings Version 2.1.22                              #
+# Ruby Bindings Version 2.1.23                              #
 #                                                           #
 # 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_accelerometer_v2.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-05-21.      #
+# This file was automatically generated on 2019-08-23.      #
 #                                                           #
-# Ruby Bindings Version 2.1.22                              #
+# Ruby Bindings Version 2.1.23                              #
 #                                                           #
 # 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  #
@@ -25,7 +25,19 @@ module Tinkerforge
     # be configured with BrickletAccelerometerV2#set_configuration and this callback can be
     # enabled with BrickletAccelerometerV2#set_continuous_acceleration_configuration.
     # 
-    # The unit of the values is g/10000.
+    # The returned values are raw ADC data. If you want to put this data into
+    # a FFT to determine the occurrences of specific frequencies we recommend
+    # that you use the data as is. It has all of the ADC noise in it. This noise
+    # looks like pure noise at first glance, but it might still have some frequnecy
+    # information in it that can be utilized by the FFT.
+    # 
+    # Otherwise you have to use the following formulas that depend on the
+    # full scale range (see BrickletAccelerometerV2#set_configuration) to calculate
+    # the data in g/10000 (same unit that is returned by BrickletAccelerometerV2#get_acceleration):
+    # 
+    # * Full scale 2G: acceleration = value*625/1024
+    # * Full scale 4G: acceleration = value*1250/1024
+    # * Full scale 8G: acceleration = value*2500/1024
     # 
     # The data is formated in the sequence "x, y, z, x, y, z, ..." depending on
     # the enabled axis. Examples:
@@ -39,7 +51,19 @@ module Tinkerforge
     # be configured with BrickletAccelerometerV2#set_configuration and this callback can be
     # enabled with BrickletAccelerometerV2#set_continuous_acceleration_configuration.
     # 
-    # The unit of the values is g*256/10000.
+    # The returned values are raw ADC data. If you want to put this data into
+    # a FFT to determine the occurrences of specific frequencies we recommend
+    # that you use the data as is. It has all of the ADC noise in it. This noise
+    # looks like pure noise at first glance, but it might still have some frequnecy
+    # information in it that can be utilized by the FFT.
+    # 
+    # Otherwise you have to use the following formulas that depend on the
+    # full scale range (see BrickletAccelerometerV2#set_configuration) to calculate
+    # the data in g/10000 (same unit that is returned by BrickletAccelerometerV2#get_acceleration):
+    # 
+    # * Full scale 2G:  acceleration = value*256*625/1024
+    # * Full scale 4G:  acceleration = value*256*1250/1024
+    # * Full scale 8G:  acceleration = value*256*2500/1024
     # 
     # The data is formated in the sequence "x, y, z, x, y, z, ..." depending on
     # the enabled axis. Examples:
@@ -58,6 +82,8 @@ module Tinkerforge
     FUNCTION_GET_INFO_LED_CONFIG = 7 # :nodoc:
     FUNCTION_SET_CONTINUOUS_ACCELERATION_CONFIGURATION = 9 # :nodoc:
     FUNCTION_GET_CONTINUOUS_ACCELERATION_CONFIGURATION = 10 # :nodoc:
+    FUNCTION_SET_FILTER_CONFIGURATION = 13 # :nodoc:
+    FUNCTION_GET_FILTER_CONFIGURATION = 14 # :nodoc:
     FUNCTION_GET_SPITFP_ERROR_COUNT = 234 # :nodoc:
     FUNCTION_SET_BOOTLOADER_MODE = 235 # :nodoc:
     FUNCTION_GET_BOOTLOADER_MODE = 236 # :nodoc:
@@ -95,6 +121,10 @@ module Tinkerforge
     INFO_LED_CONFIG_SHOW_HEARTBEAT = 2 # :nodoc:
     RESOLUTION_8BIT = 0 # :nodoc:
     RESOLUTION_16BIT = 1 # :nodoc:
+    IIR_BYPASS_APPLIED = 0 # :nodoc:
+    IIR_BYPASS_BYPASSED = 1 # :nodoc:
+    LOW_PASS_FILTER_NINTH = 0 # :nodoc:
+    LOW_PASS_FILTER_HALF = 1 # :nodoc:
     BOOTLOADER_MODE_BOOTLOADER = 0 # :nodoc:
     BOOTLOADER_MODE_FIRMWARE = 1 # :nodoc:
     BOOTLOADER_MODE_BOOTLOADER_WAIT_FOR_REBOOT = 2 # :nodoc:
@@ -116,7 +146,7 @@ module Tinkerforge
     def initialize(uid, ipcon)
       super uid, ipcon
 
-      @api_version = [2, 0, 0]
+      @api_version = [2, 0, 1]
 
       @response_expected[FUNCTION_GET_ACCELERATION] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[FUNCTION_SET_CONFIGURATION] = RESPONSE_EXPECTED_FALSE
@@ -127,6 +157,8 @@ module Tinkerforge
       @response_expected[FUNCTION_GET_INFO_LED_CONFIG] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[FUNCTION_SET_CONTINUOUS_ACCELERATION_CONFIGURATION] = RESPONSE_EXPECTED_FALSE
       @response_expected[FUNCTION_GET_CONTINUOUS_ACCELERATION_CONFIGURATION] = RESPONSE_EXPECTED_ALWAYS_TRUE
+      @response_expected[FUNCTION_SET_FILTER_CONFIGURATION] = RESPONSE_EXPECTED_FALSE
+      @response_expected[FUNCTION_GET_FILTER_CONFIGURATION] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[FUNCTION_GET_SPITFP_ERROR_COUNT] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[FUNCTION_SET_BOOTLOADER_MODE] = RESPONSE_EXPECTED_ALWAYS_TRUE
       @response_expected[FUNCTION_GET_BOOTLOADER_MODE] = RESPONSE_EXPECTED_ALWAYS_TRUE
@@ -222,8 +254,26 @@ module Tinkerforge
     # one of the axis is enabled and the resolution is set to 16 bit,
     # the CALLBACK_CONTINUOUS_ACCELERATION_16_BIT callback is activated.
     # 
+    # The returned values are raw ADC data. If you want to put this data into
+    # a FFT to determine the occurrences of specific frequencies we recommend
+    # that you use the data as is. It has all of the ADC noise in it. This noise
+    # looks like pure noise at first glance, but it might still have some frequnecy
+    # information in it that can be utilized by the FFT.
+    # 
+    # Otherwise you have to use the following formulas that depend on the configured
+    # resolution (8/16 bit) and the full scale range (see BrickletAccelerometerV2#set_configuration) to calculate
+    # the data in g/10000 (same unit that is returned by BrickletAccelerometerV2#get_acceleration):
+    # 
+    # * 16 bit, full scale 2G: acceleration = value*625/1024
+    # * 16 bit, full scale 4G: acceleration = value*1250/1024
+    # * 16 bit, full scale 8G: acceleration = value*2500/1024
+    # 
     # If a resolution of 8 bit is used, only the 8 most significant bits will be
-    # transferred. This means that the unit changes from g/10000 to g*256/10000.
+    # transferred, so you can use the following formulas:
+    # 
+    # * 8 bit, full scale 2G:  acceleration = value*256*625/1024
+    # * 8 bit, full scale 4G:  acceleration = value*256*1250/1024
+    # * 8 bit, full scale 8G:  acceleration = value*256*2500/1024
     # 
     # If no axis is enabled, both callbacks are disabled. If one of the continuous
     # callbacks is enabled, the CALLBACK_ACCELERATION callback is disabled.
@@ -245,6 +295,31 @@ module Tinkerforge
       send_request FUNCTION_GET_CONTINUOUS_ACCELERATION_CONFIGURATION, [], '', 4, '? ? ? C'
     end
 
+    # Configures IIR Bypass filter mode and low pass filter roll off corner frequency.
+    # 
+    # The filter can be applied or bypassed and the corner frequency can be
+    # half or a ninth of the output data rate.
+    # 
+    # .. image:: /Images/Bricklets/bricklet_accelerometer_v2_filter.png
+    #    :scale: 100 %
+    #    :alt: Accelerometer filter
+    #    :align: center
+    #    :target: ../../_images/Bricklets/bricklet_accelerometer_v2_filter.png
+    # 
+    # By default filtering is applied and the filter corner frequency is a ninth of the output data rate.
+    # 
+    # .. versionadded:: 2.0.2$nbsp;(Plugin)
+    def set_filter_configuration(iir_bypass, low_pass_filter)
+      send_request FUNCTION_SET_FILTER_CONFIGURATION, [iir_bypass, low_pass_filter], 'C C', 0, ''
+    end
+
+    # Returns the configuration as set by BrickletAccelerometerV2#set_filter_configuration.
+    # 
+    # .. versionadded:: 2.0.2$nbsp;(Plugin)
+    def get_filter_configuration
+      send_request FUNCTION_GET_FILTER_CONFIGURATION, [], '', 2, 'C C'
+    end
+
     # Returns the error count for the communication between Brick and Bricklet.
     # 
     # The errors are divided into

data/lib/tinkerforge/bricklet_air_quality.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-05-21.      #
+# This file was automatically generated on 2019-08-23.      #
 #                                                           #
-# Ruby Bindings Version 2.1.22                              #
+# Ruby Bindings Version 2.1.23                              #
 #                                                           #
 # 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_ambient_light.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-05-21.      #
+# This file was automatically generated on 2019-08-23.      #
 #                                                           #
-# Ruby Bindings Version 2.1.22                              #
+# Ruby Bindings Version 2.1.23                              #
 #                                                           #
 # 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_ambient_light_v2.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-05-21.      #
+# This file was automatically generated on 2019-08-23.      #
 #                                                           #
-# Ruby Bindings Version 2.1.22                              #
+# Ruby Bindings Version 2.1.23                              #
 #                                                           #
 # 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_ambient_light_v3.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-05-21.      #
+# This file was automatically generated on 2019-08-23.      #
 #                                                           #
-# Ruby Bindings Version 2.1.22                              #
+# Ruby Bindings Version 2.1.23                              #
 #                                                           #
 # 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  #