NAME
Tinkerforge::Device - Base class for all Bricks and Bricklets (for internal use only)
FUNCTIONS
- register_callback()
-
Registers the given $function name with the given $callback_id.
- get_api_version()
-
Returns the API version (major, minor, revision) of the bindings for this device.
- get_response_expected()
-
Returns the response expected flag for the function specified by the *function_id* parameter. It is *true* if the function is expected to send a response, *false* otherwise.
For getter functions this is enabled by default and cannot be disabled, because those functions will always send a response. For callback configuration functions it is enabled by default too, but can be disabled via the set_response_expected function. For setter functions it is disabled by default and can be enabled.
Enabling the response expected flag for a setter function allows to detect timeouts and other error conditions calls of this setter as well. The device will then send a response for this purpose. If this flag is disabled for a setter function then no response is send and errors are silently ignored, because they cannot be detected.
- set_response_expected()
-
Changes the response expected flag of the function specified by the *function_id* parameter. This flag can only be changed for setter (default value: *false*) and callback configuration functions (default value: *true*). For getter functions it is always enabled.
Enabling the response expected flag for a setter function allows to detect timeouts and other error conditions calls of this setter as well. The device will then send a response for this purpose. If this flag is disabled for a setter function then no response is send and errors are silently ignored, because they cannot be detected.
- set_response_expected_all()
-
Changes the response expected flag for all setter and callback configuration functions of this device at once.