def handleNotification(self, char_handle, data):
"""It is called whenever a notification arises.
Args:
char_handle (int): The characteristic's handle to look for.
data (str): The data notified from the given characteristic.
Raises:
:exc:`blue_st_sdk.utils.blue_st_exceptions.InvalidDataException`
if the data array has not enough data to read.
"""
try:
# Calling on-read callback.
if self._node._debug_console:
# Calling on-update callback for a debug characteristic.
characteristic = \
self._node._char_handle_to_characteristic_dict[char_handle]
if Debug.is_debug_characteristic(str(characteristic.uuid)):
self._node._debug_console.on_update_characteristic(
characteristic, data)
return
# Calling on-read callback for the other characteristics.
self._node._update_features(char_handle, data, True)
except InvalidDataException as e:
self._logger.warning(str(e))
def read_feature(self, feature):
"""Synchronous request to read a feature.
Args:
feature (:class:`blue_st_sdk.feature.Feature`): The feature to read.
Raises:
:exc:`blue_st_sdk.utils.blue_st_exceptions.BlueSTInvalidOperationException`
is raised if the feature is not enabled or the operation
required is not supported.
:exc:`blue_st_sdk.utils.blue_st_exceptions.BlueSTInvalidDataException`
if the data array has not enough data to read.
"""
if not feature.is_enabled():
raise BlueSTInvalidOperationException(' The "' +
feature.get_name() +
'" feature is not enabled.')
characteristic = feature.get_characteristic()
if not self.characteristic_can_be_read(characteristic):
raise BlueSTInvalidOperationException(' The "' +
feature.get_name() +
'" feature is not readable.')
# Reading data.
try:
with lock(self):
char_handle = characteristic.getHandle()
data = self.readCharacteristic(char_handle)
# Calling on-read callback.
if self._debug_console and \
Debug.is_debug_characteristic(str(characteristic.uuid)):
# Calling on-read callback for a debug characteristic.
self._debug_console.on_update_characteristic(
characteristic, data)
else:
# Calling on-read callback for the other characteristics.
self._update_features(char_handle, data, False)
except BlueSTInvalidDataException as e:
raise e
except BTLEException as e:
self._unexpected_disconnect()
def handleNotification(self, char_handle, data):
"""It is called whenever a notification arises.
Args:
char_handle (int): The characteristic's handle to look for.
data (str): The data notified from the given characteristic.
"""
try:
# Calling on-read callback.
if self._node._debug_console:
# Calling on-update callback for a debug characteristic.
characteristic = \
self._node._char_handle_to_characteristic_dict[char_handle]
if Debug.is_debug_characteristic(str(characteristic.uuid)):
self._node._debug_console.on_update_characteristic(
characteristic, data)
return
# Calling on-read callback for the other characteristics.
self._node._update_features(char_handle, data, True)
except BlueSTInvalidDataException as e:
self._logger.warning(str(e))
except BTLEException as e:
self._unexpected_disconnect()