meshcore-dev/meshcore_py
1
0
Fork 0
mirror of https://github.com/meshcore-dev/meshcore_py.git synced 2026-04-20 22:13:49 +00:00
Code Issues Projects Releases Packages Wiki Activity

Implement BLE PIN pairing support for enhanced security

Browse source 
* Implement BLE pin pairing support with comprehensive tests and documentation
This commit is contained in:
Copilot 2025-09-24 00:21:30 +02:00 • committed by GitHub
parent 60e065b5f6
commit 29003b94dc
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
7 changed files with 273 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

17
src/meshcore/ble_cx.py
View file

@ -20,13 +20,15 @@ UART_TX_CHAR_UUID = "6E400003-B5A3-F393-E0A9-E50E24DCCA9E"
class BLEConnection:
def __init__(self, address=None, device=None, client=None):
def __init__(self, address=None, device=None, client=None, pin=None):
"""
Constructor: specify address or an existing BleakClient.
Args:
address (str, optional): The Bluetooth address of the device.
device (BLEDevice, optional): A BLEDevice instance.
client (BleakClient, optional): An existing BleakClient instance.
pin (str, optional): PIN for BLE pairing authentication.
"""
self.address = address
self._user_provided_address = address
@ -34,6 +36,7 @@ class BLEConnection:
self._user_provided_client = client
self.device = device
self._user_provided_device = device
self.pin = pin
self.rx_char = None
self._disconnect_callback = None
@ -93,6 +96,18 @@ class BLEConnection:
try:
await self.client.connect()
# Perform pairing if PIN is provided
if self.pin is not None:
logger.debug(f"Attempting BLE pairing with PIN")
try:
await self.client.pair()
logger.info("BLE pairing successful")
except Exception as e:
logger.warning(f"BLE pairing failed: {e}")
# Don't fail the connection if pairing fails, as the device
# might already be paired or not require pairing
except BleakDeviceNotFoundError:
return None
except TimeoutError:

5
src/meshcore/meshcore.py
View file

@ -128,6 +128,7 @@ class MeshCore:
address: Optional[str] = None,
client=None,
device=None,
pin: Optional[str] = None,
debug: bool = False,
only_error: bool = False,
default_timeout=None,
@ -143,8 +144,10 @@ class MeshCore:
client (BleakClient, optional): An existing BleakClient instance to use.
If provided, 'address' is ignored for connection
but can be used for identification.
device (BLEDevice, optional): A BLEDevice instance to use for connection.
pin (str, optional): PIN for BLE pairing authentication.
"""
connection = BLEConnection(address=address, client=client, device=device)
connection = BLEConnection(address=address, client=client, device=device, pin=pin)
mc = cls(
connection,