tinkerforge 2.1.23 → 2.1.24

data/lib/tinkerforge/bricklet_dust_detector.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-08-23.      #
+# This file was automatically generated on 2019-11-25.      #
 #                                                           #
-# Ruby Bindings Version 2.1.23                              #
+# Ruby Bindings Version 2.1.24                              #
 #                                                           #
 # 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  #
@@ -71,7 +71,7 @@ module Tinkerforge
 
     end
 
-    # Returns the dust density in µg/m³.
+    # Returns the dust density.
     # 
     # If you want to get the dust density periodically, it is recommended
     # to use the CALLBACK_DUST_DENSITY callback and set the period with
@@ -80,13 +80,11 @@ module Tinkerforge
       send_request FUNCTION_GET_DUST_DENSITY, [], '', 2, 'S'
     end
 
-    # Sets the period in ms with which the CALLBACK_DUST_DENSITY callback is triggered
+    # Sets the period with which the CALLBACK_DUST_DENSITY callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
     # The CALLBACK_DUST_DENSITY callback 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
@@ -107,8 +105,6 @@ module Tinkerforge
     #  "'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
@@ -118,7 +114,7 @@ module Tinkerforge
       send_request FUNCTION_GET_DUST_DENSITY_CALLBACK_THRESHOLD, [], '', 5, 'k S S'
     end
 
-    # Sets the period in ms with which the threshold callback
+    # Sets the period with which the threshold callback
     # 
     # * CALLBACK_DUST_DENSITY_REACHED
     # 
@@ -127,8 +123,6 @@ module Tinkerforge
     # * 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
@@ -139,14 +133,10 @@ module Tinkerforge
     end
 
     # Sets the length of a `moving averaging <https://en.wikipedia.org/wiki/Moving_average>`__
-    # for the dust_density.
+    # 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

data/lib/tinkerforge/bricklet_e_paper_296x128.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-08-23.      #
+# This file was automatically generated on 2019-11-25.      #
 #                                                           #
-# Ruby Bindings Version 2.1.23                              #
+# Ruby Bindings Version 2.1.24                              #
 #                                                           #
 # 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  #
@@ -147,9 +147,8 @@ module Tinkerforge
 
     # Writes black/white pixels to the specified window into the buffer.
     # 
-    # The x-axis goes from 0 to 295 and the y-axis from 0 to 127. The pixels are written
-    # into the window line by line top to bottom and each line is written from left to
-    # right.
+    # The pixels are written into the window line by line top to bottom
+    # and each line is written from left to right.
     # 
     # The value 0 (false) corresponds to a black pixel and the value 1 (true) to a
     # white pixel.
@@ -164,9 +163,8 @@ module Tinkerforge
 
     # Returns the current content of the black/white pixel buffer for the specified window.
     # 
-    # The x-axis goes from 0 to 295 and the y-axis from 0 to 127. The pixels are written
-    # into the window line by line top to bottom and each line is written from left to
-    # right.
+    # The pixels are read into the window line by line top to bottom and
+    # each line is read from left to right.
     # 
     # The current content of the buffer does not have to be the current content of the display.
     # It is possible that the data was not drawn to the display yet and after a restart of
@@ -179,9 +177,8 @@ module Tinkerforge
     # black/white/gray. Depending on the model this function writes either red or
     # gray pixels to the specified window into the buffer.
     # 
-    # The x-axis goes from 0 to 295 and the y-axis from 0 to 127. The pixels are written
-    # into the window line by line top to bottom and each line is written from left to
-    # right.
+    # The pixels are written into the window line by line top to bottom
+    # and each line is written from left to right.
     # 
     # The value 0 (false) means that this pixel does not have color. It will be either black
     # or white (see BrickletEPaper296x128#write_black_white). The value 1 (true) corresponds to a red or gray
@@ -197,9 +194,8 @@ module Tinkerforge
 
     # Returns the current content of the red or gray pixel buffer for the specified window.
     # 
-    # The x-axis goes from 0 to 295 and the y-axis from 0 to 127. The pixels are written
-    # into the window line by line top to bottom and each line is written from left to
-    # right.
+    # The pixels are written into the window line by line top to bottom
+    # and each line is written from left to right.
     # 
     # The current content of the buffer does not have to be the current content of the display.
     # It is possible that the data was not drawn to the display yet and after a restart of
@@ -209,34 +205,39 @@ module Tinkerforge
     end
 
     # Fills the complete content of the display with the given color.
+    # 
+    # This function writes the pixels into the black/white/red|gray pixel buffer, to draw the buffer
+    # to the display use BrickletEPaper296x128#draw.
     def fill_display(color)
       send_request FUNCTION_FILL_DISPLAY, [color], 'C', 0, ''
     end
 
     # Draws a text with up to 50 characters at the pixel position (x, y).
     # 
-    # The x values have to be within the range of 0 to 295 and the y
-    # values have to be within the range of 0 to 127.
-    # 
     # You can use one of 9 different font sizes and draw the text in
     # black/white/red|gray. The text can be drawn horizontal or vertical.
+    # 
+    # This function writes the pixels into the black/white/red|gray pixel buffer, to draw the buffer
+    # to the display use BrickletEPaper296x128#draw.
     def draw_text(position_x, position_y, font, color, orientation, text)
       send_request FUNCTION_DRAW_TEXT, [position_x, position_y, font, color, orientation, text], 'S C C C C Z50', 0, ''
     end
 
     # Draws a line from (x, y)-start to (x, y)-end in the given color.
-    # The x values have to be within the range of 0 to 295 and the y
-    # values have t be within the range of 0 to 127.
+    # 
+    # This function writes the pixels into the black/white/red|gray pixel buffer, to draw the buffer
+    # to the display use BrickletEPaper296x128#draw.
     def draw_line(position_x_start, position_y_start, position_x_end, position_y_end, color)
       send_request FUNCTION_DRAW_LINE, [position_x_start, position_y_start, position_x_end, position_y_end, color], 'S C S C C', 0, ''
     end
 
     # Draws a box from (x, y)-start to (x, y)-end in the given color.
-    # The x values have to be within the range of 0 to 295 and the y
-    # values have to be within the range of 0 to 127.
     # 
     # If you set fill to true, the box will be filled with the
     # color. Otherwise only the outline will be drawn.
+    # 
+    # This function writes the pixels into the black/white/red|gray pixel buffer, to draw the buffer
+    # to the display use BrickletEPaper296x128#draw.
     def draw_box(position_x_start, position_y_start, position_x_end, position_y_end, fill, color)
       send_request FUNCTION_DRAW_BOX, [position_x_start, position_y_start, position_x_end, position_y_end, fill, color], 'S C S C ? C', 0, ''
     end
@@ -418,9 +419,8 @@ module Tinkerforge
 
     # Writes black/white pixels to the specified window into the buffer.
     # 
-    # The x-axis goes from 0 to 295 and the y-axis from 0 to 127. The pixels are written
-    # into the window line by line top to bottom and each line is written from left to
-    # right.
+    # The pixels are written into the window line by line top to bottom
+    # and each line is written from left to right.
     # 
     # The value 0 (false) corresponds to a black pixel and the value 1 (true) to a
     # white pixel.
@@ -462,9 +462,8 @@ module Tinkerforge
 
     # Returns the current content of the black/white pixel buffer for the specified window.
     # 
-    # The x-axis goes from 0 to 295 and the y-axis from 0 to 127. The pixels are written
-    # into the window line by line top to bottom and each line is written from left to
-    # right.
+    # The pixels are read into the window line by line top to bottom and
+    # each line is read from left to right.
     # 
     # The current content of the buffer does not have to be the current content of the display.
     # It is possible that the data was not drawn to the display yet and after a restart of
@@ -506,9 +505,8 @@ module Tinkerforge
     # black/white/gray. Depending on the model this function writes either red or
     # gray pixels to the specified window into the buffer.
     # 
-    # The x-axis goes from 0 to 295 and the y-axis from 0 to 127. The pixels are written
-    # into the window line by line top to bottom and each line is written from left to
-    # right.
+    # The pixels are written into the window line by line top to bottom
+    # and each line is written from left to right.
     # 
     # The value 0 (false) means that this pixel does not have color. It will be either black
     # or white (see BrickletEPaper296x128#write_black_white). The value 1 (true) corresponds to a red or gray
@@ -551,9 +549,8 @@ module Tinkerforge
 
     # Returns the current content of the red or gray pixel buffer for the specified window.
     # 
-    # The x-axis goes from 0 to 295 and the y-axis from 0 to 127. The pixels are written
-    # into the window line by line top to bottom and each line is written from left to
-    # right.
+    # The pixels are written into the window line by line top to bottom
+    # and each line is written from left to right.
     # 
     # The current content of the buffer does not have to be the current content of the display.
     # It is possible that the data was not drawn to the display yet and after a restart of

data/lib/tinkerforge/bricklet_energy_monitor.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-08-23.      #
+# This file was automatically generated on 2019-11-25.      #
 #                                                           #
-# Ruby Bindings Version 2.1.23                              #
+# Ruby Bindings Version 2.1.24                              #
 #                                                           #
 # 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  #
@@ -94,14 +94,14 @@ module Tinkerforge
 
     # Returns all of the measurements that are done by the Energy Monitor Bricklet.
     # 
-    # * Voltage (V): Voltage RMS with a resolution of 10mV (example: 230.05V = 23005)
-    # * Current (A): Current RMS with a resolution of 10mA (example: 1.42A = 142)
-    # * Energy (Wh): Energy (integrated over time) with a resolution of 10mWh (example: 1.1kWh = 110000)
-    # * Real Power (W): Real Power with a resolution of 10mW (example: 1234.56W = 123456)
-    # * Apparent Power (VA): Apparent Power with a resolution of 10mVA (example: 1234.56VA = 123456)
-    # * Reactive Power (VAR): Reactive Power with a resolution of 10mVAR (example: 1234.56VAR = 123456)
-    # * Power Factor: Power Factor with a resolution of 1/1000 (example: PF 0.995 = 995)
-    # * Frequency (Hz): AC Frequency of the mains voltage with a resolution of 1/100 Hz (example: 50Hz = 5000)
+    # * Voltage RMS
+    # * Current RMS
+    # * Energy (integrated over time)
+    # * Real Power
+    # * Apparent Power
+    # * Reactive Power
+    # * Power Factor
+    # * Frequency (AC Frequency of the mains voltage)
     # 
     # The frequency is recalculated every 6 seconds.
     # 
@@ -151,8 +151,6 @@ module Tinkerforge
     # 
     # The calibration is saved in non-volatile memory, you only have to set it once.
     # 
-    # By default the voltage ratio is set to 1923 and the current ratio is set to 3000.
-    # 
     # Set the phase shift to 0. It is for future use and currently not supported by the Bricklet.
     def set_transformer_calibration(voltage_ratio, current_ratio, phase_shift)
       send_request FUNCTION_SET_TRANSFORMER_CALIBRATION, [voltage_ratio, current_ratio, phase_shift], 'S S s', 0, ''
@@ -179,7 +177,7 @@ module Tinkerforge
       send_request FUNCTION_CALIBRATE_OFFSET, [], '', 0, ''
     end
 
-    # The period in ms is the period with which the CALLBACK_ENERGY_DATA
+    # The period is the period with which the CALLBACK_ENERGY_DATA
     # callback is triggered periodically. A value of 0 turns the callback off.
     # 
     # If the `value has to change`-parameter is set to true, the callback is only
@@ -188,8 +186,6 @@ module Tinkerforge
     # 
     # If it is set to false, the callback is continuously triggered with the period,
     # independent of the value.
-    # 
-    # The default value is (0, false).
     def set_energy_data_callback_configuration(period, value_has_to_change)
       send_request FUNCTION_SET_ENERGY_DATA_CALLBACK_CONFIGURATION, [period, value_has_to_change], 'L ?', 0, ''
     end

data/lib/tinkerforge/bricklet_gps.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-08-23.      #
+# This file was automatically generated on 2019-11-25.      #
 #                                                           #
-# Ruby Bindings Version 2.1.23                              #
+# Ruby Bindings Version 2.1.24                              #
 #                                                           #
 # 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  #
@@ -127,9 +127,9 @@ module Tinkerforge
     # the additional multiplicative effect of GPS satellite geometry on GPS
     # precision. See
     # `here <https://en.wikipedia.org/wiki/Dilution_of_precision_(GPS)>`__
-    # for more information. The values are give in hundredths.
+    # for more information.
     # 
-    # EPE is the "Estimated Position Error". The EPE is given in cm. This is not the
+    # EPE is the "Estimated Position Error". This is not the
     # absolute maximum error, it is the error with a specific confidence. See
     # `here <https://www.nps.gov/gis/gps/WhatisEPE.html>`__ for more information.
     # 
@@ -158,16 +158,13 @@ module Tinkerforge
 
     # Returns the current altitude and corresponding geoidal separation.
     # 
-    # Both values are given in cm.
-    # 
     # This data is only valid if there is currently a fix as indicated by
     # BrickletGPS#get_status.
     def get_altitude
       send_request FUNCTION_GET_ALTITUDE, [], '', 8, 'l l'
     end
 
-    # Returns the current course and speed. Course is given in hundredths degree
-    # and speed is given in hundredths km/h. A course of 0° means the Bricklet is
+    # Returns the current course and speed. A course of 0° means the Bricklet is
     # traveling north bound and 90° means it is traveling east bound.
     # 
     # Please note that this only returns useful values if an actual movement
@@ -182,7 +179,7 @@ module Tinkerforge
     # Returns the current date and time. The date is
     # given in the format ``ddmmyy`` and the time is given
     # in the format ``hhmmss.sss``. For example, 140713 means
-    # 14.05.13 as date and 195923568 means 19:59:23.568 as time.
+    # 14.07.13 as date and 195923568 means 19:59:23.568 as time.
     def get_date_time
       send_request FUNCTION_GET_DATE_TIME, [], '', 8, 'L L'
     end
@@ -199,13 +196,11 @@ module Tinkerforge
       send_request FUNCTION_RESTART, [restart_type], 'C', 0, ''
     end
 
-    # Sets the period in ms with which the CALLBACK_COORDINATES callback is triggered
+    # Sets the period with which the CALLBACK_COORDINATES callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
     # The CALLBACK_COORDINATES callback is only triggered if the coordinates changed
     # since the last triggering.
-    # 
-    # The default value is 0.
     def set_coordinates_callback_period(period)
       send_request FUNCTION_SET_COORDINATES_CALLBACK_PERIOD, [period], 'L', 0, ''
     end
@@ -215,13 +210,11 @@ module Tinkerforge
       send_request FUNCTION_GET_COORDINATES_CALLBACK_PERIOD, [], '', 4, 'L'
     end
 
-    # Sets the period in ms with which the CALLBACK_STATUS callback is triggered
+    # Sets the period with which the CALLBACK_STATUS callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
     # The CALLBACK_STATUS callback is only triggered if the status changed since the
     # last triggering.
-    # 
-    # The default value is 0.
     def set_status_callback_period(period)
       send_request FUNCTION_SET_STATUS_CALLBACK_PERIOD, [period], 'L', 0, ''
     end
@@ -231,13 +224,11 @@ module Tinkerforge
       send_request FUNCTION_GET_STATUS_CALLBACK_PERIOD, [], '', 4, 'L'
     end
 
-    # Sets the period in ms with which the CALLBACK_ALTITUDE callback is triggered
+    # Sets the period with which the CALLBACK_ALTITUDE callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
     # The CALLBACK_ALTITUDE callback is only triggered if the altitude changed since
     # the last triggering.
-    # 
-    # The default value is 0.
     def set_altitude_callback_period(period)
       send_request FUNCTION_SET_ALTITUDE_CALLBACK_PERIOD, [period], 'L', 0, ''
     end
@@ -247,13 +238,11 @@ module Tinkerforge
       send_request FUNCTION_GET_ALTITUDE_CALLBACK_PERIOD, [], '', 4, 'L'
     end
 
-    # Sets the period in ms with which the CALLBACK_MOTION callback is triggered
+    # Sets the period with which the CALLBACK_MOTION callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
     # The CALLBACK_MOTION callback is only triggered if the motion changed since the
     # last triggering.
-    # 
-    # The default value is 0.
     def set_motion_callback_period(period)
       send_request FUNCTION_SET_MOTION_CALLBACK_PERIOD, [period], 'L', 0, ''
     end
@@ -263,13 +252,11 @@ module Tinkerforge
       send_request FUNCTION_GET_MOTION_CALLBACK_PERIOD, [], '', 4, 'L'
     end
 
-    # Sets the period in ms with which the CALLBACK_DATE_TIME callback is triggered
+    # Sets the period with which the CALLBACK_DATE_TIME callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
     # The CALLBACK_DATE_TIME callback is only triggered if the date or time changed
     # since the last triggering.
-    # 
-    # The default value is 0.
     def set_date_time_callback_period(period)
       send_request FUNCTION_SET_DATE_TIME_CALLBACK_PERIOD, [period], 'L', 0, ''
     end

data/lib/tinkerforge/bricklet_gps_v2.rb

@@ -1,8 +1,8 @@
 # -*- ruby encoding: utf-8 -*-
 #############################################################
-# This file was automatically generated on 2019-08-23.      #
+# This file was automatically generated on 2019-11-25.      #
 #                                                           #
-# Ruby Bindings Version 2.1.23                              #
+# Ruby Bindings Version 2.1.24                              #
 #                                                           #
 # 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  #
@@ -209,16 +209,13 @@ module Tinkerforge
 
     # Returns the current altitude and corresponding geoidal separation.
     # 
-    # Both values are given in cm.
-    # 
     # This data is only valid if there is currently a fix as indicated by
     # BrickletGPSV2#get_status.
     def get_altitude
       send_request FUNCTION_GET_ALTITUDE, [], '', 8, 'l l'
     end
 
-    # Returns the current course and speed. Course is given in hundredths degree
-    # and speed is given in hundredths km/h. A course of 0° means the Bricklet is
+    # Returns the current course and speed. A course of 0° means the Bricklet is
     # traveling north bound and 90° means it is traveling east bound.
     # 
     # Please note that this only returns useful values if an actual movement
@@ -233,7 +230,7 @@ module Tinkerforge
     # Returns the current date and time. The date is
     # given in the format ``ddmmyy`` and the time is given
     # in the format ``hhmmss.sss``. For example, 140713 means
-    # 14.05.13 as date and 195923568 means 19:59:23.568 as time.
+    # 14.07.13 as date and 195923568 means 19:59:23.568 as time.
     def get_date_time
       send_request FUNCTION_GET_DATE_TIME, [], '', 8, 'L L'
     end
@@ -268,12 +265,7 @@ module Tinkerforge
       send_request FUNCTION_GET_SATELLITE_SYSTEM_STATUS_LOW_LEVEL, [satellite_system], 'C', 20, 'C C12 C S S S'
     end
 
-    # Returns the current
-    # 
-    # * elevation (0° - 90°),
-    # * azimuth (0° - 359°) and
-    # * SNR (0dB - 99dB)
-    # 
+    # Returns the current elevation, azimuth and SNR
     # for a given satellite and satellite system.
     # 
     # The satellite number here always goes from 1 to 32. For GLONASS it corresponds to
@@ -301,13 +293,11 @@ module Tinkerforge
       send_request FUNCTION_GET_FIX_LED_CONFIG, [], '', 1, 'C'
     end
 
-    # Sets the period in ms with which the CALLBACK_COORDINATES callback is triggered
+    # Sets the period with which the CALLBACK_COORDINATES callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
     # The CALLBACK_COORDINATES callback is only triggered if the coordinates changed
     # since the last triggering.
-    # 
-    # The default value is 0.
     def set_coordinates_callback_period(period)
       send_request FUNCTION_SET_COORDINATES_CALLBACK_PERIOD, [period], 'L', 0, ''
     end
@@ -317,13 +307,11 @@ module Tinkerforge
       send_request FUNCTION_GET_COORDINATES_CALLBACK_PERIOD, [], '', 4, 'L'
     end
 
-    # Sets the period in ms with which the CALLBACK_STATUS callback is triggered
+    # Sets the period with which the CALLBACK_STATUS callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
     # The CALLBACK_STATUS callback is only triggered if the status changed since the
     # last triggering.
-    # 
-    # The default value is 0.
     def set_status_callback_period(period)
       send_request FUNCTION_SET_STATUS_CALLBACK_PERIOD, [period], 'L', 0, ''
     end
@@ -333,13 +321,11 @@ module Tinkerforge
       send_request FUNCTION_GET_STATUS_CALLBACK_PERIOD, [], '', 4, 'L'
     end
 
-    # Sets the period in ms with which the CALLBACK_ALTITUDE callback is triggered
+    # Sets the period with which the CALLBACK_ALTITUDE callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
     # The CALLBACK_ALTITUDE callback is only triggered if the altitude changed since the
     # last triggering.
-    # 
-    # The default value is 0.
     def set_altitude_callback_period(period)
       send_request FUNCTION_SET_ALTITUDE_CALLBACK_PERIOD, [period], 'L', 0, ''
     end
@@ -349,13 +335,11 @@ module Tinkerforge
       send_request FUNCTION_GET_ALTITUDE_CALLBACK_PERIOD, [], '', 4, 'L'
     end
 
-    # Sets the period in ms with which the CALLBACK_MOTION callback is triggered
+    # Sets the period with which the CALLBACK_MOTION callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
     # The CALLBACK_MOTION callback is only triggered if the motion changed since the
     # last triggering.
-    # 
-    # The default value is 0.
     def set_motion_callback_period(period)
       send_request FUNCTION_SET_MOTION_CALLBACK_PERIOD, [period], 'L', 0, ''
     end
@@ -365,13 +349,11 @@ module Tinkerforge
       send_request FUNCTION_GET_MOTION_CALLBACK_PERIOD, [], '', 4, 'L'
     end
 
-    # Sets the period in ms with which the CALLBACK_DATE_TIME callback is triggered
+    # Sets the period with which the CALLBACK_DATE_TIME callback is triggered
     # periodically. A value of 0 turns the callback off.
     # 
     # The CALLBACK_DATE_TIME callback is only triggered if the date or time changed
     # since the last triggering.
-    # 
-    # The default value is 0.
     def set_date_time_callback_period(period)
       send_request FUNCTION_SET_DATE_TIME_CALLBACK_PERIOD, [period], 'L', 0, ''
     end