def connect(self, peer_address, connection_params=None):
"""
Initiates a connection to a peripheral peer with the specified connection parameters, or uses the default
connection parameters if not specified. The connection will not be complete until the returned waitable
either times out or reports the newly connected peer
:param peer_address: The address of the peer to connect to
:type peer_address: peer.PeerAddress
:param connection_params: Optional connection parameters to use. If not specified, uses the set default
:type connection_params: peer.ConnectionParameters
:return: A Waitable which can be used to wait until the connection is successful or times out. Waitable returns
a peer.Peripheral object
:rtype: PeripheralConnectionWaitable
"""
if peer_address in self.connected_peripherals.keys():
raise exceptions.InvalidStateException(
"Already connected to {}".format(peer_address))
if self.connecting_peripheral is not None:
raise exceptions.InvalidStateException(
"Cannot initiate a new connection while connecting to another")
if not connection_params:
connection_params = self._default_conn_params
self.connecting_peripheral = peer.Peripheral(self, peer_address,
connection_params)
periph_connection_waitable = PeripheralConnectionWaitable(
self, self.connecting_peripheral)
self.ble_driver.ble_gap_connect(peer_address)
return periph_connection_waitable
def connect(self, peer_address, connection_params=None) -> PeripheralConnectionWaitable:
"""
Initiates a connection to a peripheral peer with the specified connection parameters, or uses the default
connection parameters if not specified. The connection will not be complete until the returned waitable
either times out or reports the newly connected peer
:param peer_address: The address of the peer to connect to
:type peer_address: peer.PeerAddress
:param connection_params: Optional connection parameters to use. If not specified, uses the set default
:type connection_params: peer.ConnectionParameters
:return: A Waitable which can be used to wait until the connection is successful or times out. Waitable returns
a peer.Peripheral object
"""
if peer_address in self.connected_peripherals.keys():
raise exceptions.InvalidStateException("Already connected to {}".format(peer_address))
if self.connecting_peripheral is not None:
raise exceptions.InvalidStateException("Cannot initiate a new connection while connecting to another")
# Try finding the peer's name in the scan report
name = ""
scan_report = self.scanner.scan_report.get_report_for_peer(peer_address)
if scan_report:
name = scan_report.advertise_data.local_name
if not connection_params:
connection_params = self._default_conn_params
self.connecting_peripheral = peer.Peripheral(self, peer_address, connection_params, self._default_security_params, name,
self._default_conn_config.write_cmd_tx_queue_size)
periph_connection_waitable = PeripheralConnectionWaitable(self, self.connecting_peripheral)
self.ble_driver.ble_gap_connect(peer_address, conn_params=connection_params,
conn_cfg_tag=self._default_conn_config.conn_tag)
return periph_connection_waitable