Merge pull request #37 from torlando-tech/fix/ble-architecture-review-fixes
fix: BLE architecture review fixes and documentation
This commit is contained in:
commit
faf032aa8d
8 changed files with 998 additions and 79 deletions
|
|
@ -1134,6 +1134,20 @@ class BLEInterface(Interface):
|
|||
central_identity = bytes(data)
|
||||
identity_hash = self._compute_identity_hash(central_identity)
|
||||
|
||||
# Check for duplicate identity (same identity already connected at different MAC)
|
||||
# This prevents duplicate connections during MAC rotation overlap
|
||||
if self._check_duplicate_identity(address, central_identity):
|
||||
RNS.log(
|
||||
f"{self} duplicate identity rejected for {address} in peripheral mode (MAC rotation)",
|
||||
RNS.LOG_WARNING
|
||||
)
|
||||
# Disconnect this connection - it's a duplicate
|
||||
try:
|
||||
self.driver.disconnect(address)
|
||||
except Exception as e:
|
||||
RNS.log(f"{self} failed to disconnect duplicate {address}: {e}", RNS.LOG_DEBUG)
|
||||
return True # Consumed the handshake, rejected connection
|
||||
|
||||
self.address_to_identity[address] = central_identity
|
||||
self.identity_to_address[identity_hash] = address
|
||||
|
||||
|
|
@ -1779,11 +1793,18 @@ class BLEInterface(Interface):
|
|||
"""
|
||||
Convert 16-byte identity to 16-character hex string for interface tracking.
|
||||
|
||||
Uses truncated 64-bit hash for map keys (spawned_interfaces, identity_to_address).
|
||||
Collision risk: birthday problem collision at ~2^32 (~4 billion) identities.
|
||||
For BLE mesh networks with <100 simultaneous peers, this is astronomically safe.
|
||||
|
||||
Note: Fragmenter keys use full 32-char hex via _get_fragmenter_key() for
|
||||
maximum precision in packet reassembly.
|
||||
|
||||
Args:
|
||||
peer_identity: 16-byte peer identity (already a hash from BLE handshake)
|
||||
|
||||
Returns:
|
||||
str: First 16 hex chars of identity (8 bytes)
|
||||
str: First 16 hex chars of identity (8 bytes = 64 bits)
|
||||
"""
|
||||
# peer_identity is already the identity hash from BLE handshake
|
||||
# Just convert to hex, don't re-hash (that would corrupt the identity!)
|
||||
|
|
@ -1872,6 +1893,12 @@ class BLEInterface(Interface):
|
|||
if not peer_identity:
|
||||
# Try identity cache - peer may have "disconnected" from Python's view
|
||||
# but Android/driver layer maintains the GATT connection
|
||||
#
|
||||
# POTENTIAL RACE CONDITION: If MAC rotation occurred and data arrives from
|
||||
# the OLD address before onAddressChanged callback fires, we could restore
|
||||
# a stale mapping here. This is a very narrow window since onAddressChanged
|
||||
# is invoked synchronously from Kotlin during deduplication. The cache entry
|
||||
# for the old address gets cleaned up in _address_changed_callback().
|
||||
cached = self._identity_cache.get(peer_address)
|
||||
if cached and (time.time() - cached[1]) < self._identity_cache_ttl:
|
||||
peer_identity = cached[0]
|
||||
|
|
@ -1995,7 +2022,7 @@ class BLEInterface(Interface):
|
|||
try:
|
||||
# Store central's identity
|
||||
central_identity = bytes(data)
|
||||
central_identity_hash = RNS.Identity.full_hash(central_identity)[:16].hex()[:16]
|
||||
central_identity_hash = self._compute_identity_hash(central_identity)
|
||||
|
||||
self.address_to_identity[sender_address] = central_identity
|
||||
self.identity_to_address[central_identity_hash] = sender_address
|
||||
|
|
|
|||
|
|
@ -1204,7 +1204,14 @@ class LinuxBluetoothDriver(BLEDriverInterface):
|
|||
if self.on_error:
|
||||
self.on_error("warning", f"Connection timeout to {address}", None)
|
||||
except Exception as e:
|
||||
self._log(f"Connection failed to {address}: {e}", "ERROR")
|
||||
error_str = str(e)
|
||||
is_duplicate_identity = "Duplicate identity" in error_str
|
||||
|
||||
# Log with appropriate level
|
||||
if is_duplicate_identity:
|
||||
self._log(f"Duplicate identity rejected for {address}: {e}", "WARNING")
|
||||
else:
|
||||
self._log(f"Connection failed to {address}: {e}", "ERROR")
|
||||
|
||||
# Clean up BlueZ state by explicitly disconnecting client
|
||||
try:
|
||||
|
|
@ -1224,7 +1231,13 @@ class LinuxBluetoothDriver(BLEDriverInterface):
|
|||
self._log(f"Error removing BlueZ device {address} after failure: {removal_e}", "DEBUG")
|
||||
|
||||
if self.on_error:
|
||||
self.on_error("error", f"Connection failed to {address}: {e}", e)
|
||||
if is_duplicate_identity:
|
||||
# Use safe message format that doesn't trigger blacklist
|
||||
# The blacklist regex matches "Connection failed to" and "Connection timeout to"
|
||||
# Using "Duplicate identity rejected for" avoids the blacklist
|
||||
self.on_error("info", f"Duplicate identity rejected for {address} (MAC rotation)", e)
|
||||
else:
|
||||
self.on_error("error", f"Connection failed to {address}: {e}", e)
|
||||
finally:
|
||||
# Backup cleanup (primary cleanup is via Future callback in connect())
|
||||
# This provides defense-in-depth in case the callback doesn't execute
|
||||
|
|
|
|||
|
|
@ -80,7 +80,7 @@ class MockBLEDriver(BLEDriverInterface):
|
|||
|
||||
# Callbacks (assigned by consumer)
|
||||
self.on_device_discovered: Optional[Callable[[BLEDevice], None]] = None
|
||||
self.on_device_connected: Optional[Callable[[str], None]] = None
|
||||
self.on_device_connected: Optional[Callable[[str, Optional[bytes]], None]] = None # address, peer_identity
|
||||
self.on_device_disconnected: Optional[Callable[[str], None]] = None
|
||||
self.on_data_received: Optional[Callable[[str, bytes], None]] = None
|
||||
self.on_mtu_negotiated: Optional[Callable[[str, int], None]] = None
|
||||
|
|
@ -160,16 +160,21 @@ class MockBLEDriver(BLEDriverInterface):
|
|||
if address in self._connected_peers:
|
||||
return # Already connected
|
||||
|
||||
# Get peer identity if linked driver is set
|
||||
peer_identity = None
|
||||
if self._linked_driver and self._linked_driver.local_address == address:
|
||||
peer_identity = self._linked_driver._identity
|
||||
|
||||
# Simulate connection with default MTU
|
||||
self._connected_peers[address] = {
|
||||
"role": "central",
|
||||
"mtu": 185, # Default MTU
|
||||
"identity": None
|
||||
"identity": peer_identity
|
||||
}
|
||||
|
||||
# Trigger callback
|
||||
# Trigger callback with peer identity (central mode receives identity during connection)
|
||||
if self.on_device_connected:
|
||||
self.on_device_connected(address)
|
||||
self.on_device_connected(address, peer_identity)
|
||||
|
||||
# Trigger MTU negotiation callback
|
||||
if self.on_mtu_negotiated:
|
||||
|
|
@ -193,8 +198,9 @@ class MockBLEDriver(BLEDriverInterface):
|
|||
"identity": None
|
||||
}
|
||||
|
||||
# Peripheral role: identity is None because we receive it via handshake later
|
||||
if self.on_device_connected:
|
||||
self.on_device_connected(address)
|
||||
self.on_device_connected(address, None)
|
||||
|
||||
if self.on_mtu_negotiated:
|
||||
self.on_mtu_negotiated(address, 185)
|
||||
|
|
|
|||
|
|
@ -39,7 +39,8 @@ def create_mock_peer_interface(peer_address="AA:BB:CC:DD:EE:FF", peer_name="Test
|
|||
parent.reassemblers = {peer_address: BLEReassembler() if BLEReassembler else Mock()}
|
||||
parent.frag_lock = threading.RLock() # Use threading lock for mock
|
||||
parent.peer_lock = threading.RLock() # Use threading lock for mock
|
||||
parent.loop = asyncio.get_event_loop()
|
||||
# Create a new event loop for testing (Python 3.10+ requires this)
|
||||
parent.loop = asyncio.new_event_loop()
|
||||
parent.gatt_server = Mock()
|
||||
parent.gatt_server.send_notification = AsyncMock(return_value=True)
|
||||
|
||||
|
|
|
|||
817
tests/test_mac_rotation_blacklist_bug.py
Normal file
817
tests/test_mac_rotation_blacklist_bug.py
Normal file
|
|
@ -0,0 +1,817 @@
|
|||
"""
|
||||
Tests for MAC rotation blacklist behavior.
|
||||
|
||||
These tests verify that duplicate identity rejection during MAC rotation
|
||||
does NOT incorrectly trigger the connection blacklist.
|
||||
|
||||
Bug Description:
|
||||
----------------
|
||||
When Android rotates a device's MAC address, the new MAC may try to connect
|
||||
while the old MAC is still connected. The _check_duplicate_identity function
|
||||
correctly rejects this as a duplicate. However, the rejection triggers an
|
||||
error callback with "Connection failed to..." which matches the blacklist
|
||||
regex pattern, incorrectly blacklisting the new MAC.
|
||||
|
||||
This causes connectivity gaps because:
|
||||
1. MAC_OLD connected with identity X
|
||||
2. MAC_NEW tries to connect (same identity) -> rejected (correct)
|
||||
3. Rejection triggers _record_connection_failure(MAC_NEW) (incorrect!)
|
||||
4. After 3 rejections, MAC_NEW is blacklisted for 60s+
|
||||
5. MAC_OLD disconnects, identity cleared
|
||||
6. MAC_NEW is blacklisted, can't reconnect for 60s+ (BUG!)
|
||||
|
||||
Expected Behavior:
|
||||
-----------------
|
||||
Duplicate identity rejection should NOT count as a connection failure.
|
||||
It's an intentional rejection, not a failure.
|
||||
"""
|
||||
|
||||
import pytest
|
||||
import time
|
||||
import re
|
||||
import asyncio
|
||||
import threading
|
||||
from unittest.mock import Mock, MagicMock, AsyncMock, patch
|
||||
|
||||
|
||||
class TestMacRotationBlacklistBug:
|
||||
"""Test that duplicate identity rejection doesn't trigger blacklist."""
|
||||
|
||||
@pytest.fixture
|
||||
def mock_ble_interface(self):
|
||||
"""Create a minimal mock of BLEInterface with blacklist behavior."""
|
||||
try:
|
||||
from ble_reticulum.BLEInterface import BLEInterface, DiscoveredPeer
|
||||
except ImportError:
|
||||
pytest.skip("BLEInterface not available")
|
||||
|
||||
# Create mock interface with required attributes
|
||||
interface = Mock(spec=BLEInterface)
|
||||
interface.connection_blacklist = {}
|
||||
interface.identity_to_address = {}
|
||||
interface.address_to_identity = {}
|
||||
interface.connection_retry_backoff = 60
|
||||
interface.max_connection_failures = 3
|
||||
interface.discovered_peers = {}
|
||||
|
||||
# Mock driver (needed for _record_connection_failure)
|
||||
interface.driver = Mock()
|
||||
interface.driver._remove_bluez_device = None # hasattr will return False
|
||||
|
||||
# Import the actual methods we want to test
|
||||
from ble_reticulum.BLEInterface import BLEInterface as RealInterface
|
||||
|
||||
# Bind real methods to our mock
|
||||
interface._check_duplicate_identity = lambda addr, identity: RealInterface._check_duplicate_identity(interface, addr, identity)
|
||||
interface._record_connection_failure = lambda addr: RealInterface._record_connection_failure(interface, addr)
|
||||
interface._is_blacklisted = lambda addr: RealInterface._is_blacklisted(interface, addr)
|
||||
interface._compute_identity_hash = lambda identity: RealInterface._compute_identity_hash(interface, identity)
|
||||
|
||||
return interface
|
||||
|
||||
def test_duplicate_identity_detected_correctly(self, mock_ble_interface):
|
||||
"""Verify that _check_duplicate_identity returns True for duplicates."""
|
||||
interface = mock_ble_interface
|
||||
|
||||
# Setup: identity already connected at MAC_OLD
|
||||
identity = b'\x01\x02\x03\x04\x05\x06\x07\x08\x09\x0a\x0b\x0c\x0d\x0e\x0f\x10'
|
||||
mac_old = "AA:BB:CC:DD:EE:01"
|
||||
mac_new = "AA:BB:CC:DD:EE:02"
|
||||
|
||||
identity_hash = interface._compute_identity_hash(identity)
|
||||
interface.identity_to_address[identity_hash] = mac_old
|
||||
|
||||
# Action: MAC_NEW tries to connect with same identity
|
||||
is_duplicate = interface._check_duplicate_identity(mac_new, identity)
|
||||
|
||||
# Assert: Should detect as duplicate
|
||||
assert is_duplicate is True, "Should detect duplicate identity"
|
||||
|
||||
def test_blacklist_mechanism_triggers_after_3_failures(self, mock_ble_interface):
|
||||
"""
|
||||
Test that the blacklist mechanism correctly triggers after 3 connection failures.
|
||||
|
||||
This tests the MECHANISM, not the fix. The fix is in the driver layer which
|
||||
now uses safe message formats that don't trigger the blacklist.
|
||||
|
||||
This test proves: IF _record_connection_failure is called 3 times,
|
||||
THEN the device is blacklisted (correct behavior for the mechanism).
|
||||
"""
|
||||
interface = mock_ble_interface
|
||||
|
||||
# Setup: Create a peer to track
|
||||
mac = "AA:BB:CC:DD:EE:02"
|
||||
|
||||
try:
|
||||
from ble_reticulum.BLEInterface import DiscoveredPeer
|
||||
interface.discovered_peers[mac] = DiscoveredPeer(mac, "Test-Device", -50)
|
||||
except ImportError:
|
||||
pytest.skip("DiscoveredPeer not available")
|
||||
|
||||
# Record 3 failures - should trigger blacklist
|
||||
for i in range(3):
|
||||
interface._record_connection_failure(mac)
|
||||
|
||||
# After 3 failures, device should be blacklisted
|
||||
is_blacklisted = interface._is_blacklisted(mac)
|
||||
|
||||
assert is_blacklisted is True, (
|
||||
"Blacklist mechanism should trigger after 3 failures"
|
||||
)
|
||||
|
||||
def test_duplicate_rejection_with_safe_message_does_not_trigger_blacklist(self, mock_ble_interface):
|
||||
"""
|
||||
Test that duplicate identity rejection with safe message format
|
||||
does NOT trigger blacklist.
|
||||
|
||||
The fix: linux_bluetooth_driver now uses severity "info" with message
|
||||
"Duplicate identity rejected for {address}" which:
|
||||
1. Doesn't match the blacklist regex "Connection failed to"
|
||||
2. Uses severity "info" which doesn't set should_blacklist=True
|
||||
|
||||
This test verifies the fix works by going through _error_callback
|
||||
with the safe message format.
|
||||
"""
|
||||
interface = mock_ble_interface
|
||||
|
||||
# Setup
|
||||
mac_new = "AA:BB:CC:DD:EE:02"
|
||||
|
||||
try:
|
||||
from ble_reticulum.BLEInterface import DiscoveredPeer, BLEInterface as RealInterface
|
||||
interface.discovered_peers[mac_new] = DiscoveredPeer(mac_new, "Test-Device", -50)
|
||||
interface._error_callback = lambda severity, msg, exc: RealInterface._error_callback(interface, severity, msg, exc)
|
||||
except ImportError:
|
||||
pytest.skip("BLEInterface not available")
|
||||
|
||||
# Simulate 3 duplicate rejections with SAFE message format (the fix)
|
||||
for i in range(3):
|
||||
# This is the NEW behavior - safe message format with "info" severity
|
||||
interface._error_callback(
|
||||
"info",
|
||||
f"Duplicate identity rejected for {mac_new} (MAC rotation)",
|
||||
None
|
||||
)
|
||||
|
||||
# After 3 rejections with safe message, device should NOT be blacklisted
|
||||
is_blacklisted = interface._is_blacklisted(mac_new)
|
||||
|
||||
assert is_blacklisted is False, (
|
||||
"Duplicate identity rejection with safe message format "
|
||||
"should NOT trigger blacklist!"
|
||||
)
|
||||
|
||||
def test_error_message_pattern_matches_blacklist_regex(self):
|
||||
"""
|
||||
Verify that the duplicate identity error message matches the blacklist regex.
|
||||
|
||||
This proves WHY the bug occurs - the error message format triggers blacklisting.
|
||||
"""
|
||||
# The error message generated by linux_bluetooth_driver.py
|
||||
mac_new = "AA:BB:CC:DD:EE:02"
|
||||
error_message = f"Connection failed to {mac_new}: Duplicate identity - already connected via different MAC (Android MAC rotation)"
|
||||
|
||||
# The regex used in _error_callback to extract address for blacklisting
|
||||
blacklist_regex = r'(?:Connection (?:failed|timeout) to|to) ([0-9A-Fa-f]{2}:[0-9A-Fa-f]{2}:[0-9A-Fa-f]{2}:[0-9A-Fa-f]{2}:[0-9A-Fa-f]{2}:[0-9A-Fa-f]{2})'
|
||||
|
||||
match = re.search(blacklist_regex, error_message)
|
||||
|
||||
# This SHOULD NOT match for duplicate identity errors
|
||||
# But currently it DOES match, which is the bug
|
||||
assert match is not None, "Regex matches the error message (this is why the bug occurs)"
|
||||
assert match.group(1).upper() == mac_new, "Extracted address matches MAC_NEW"
|
||||
|
||||
def test_real_connection_failure_should_trigger_blacklist(self, mock_ble_interface):
|
||||
"""
|
||||
Verify that real connection failures (timeouts, errors) DO trigger blacklist.
|
||||
|
||||
This ensures we don't break legitimate blacklisting while fixing the bug.
|
||||
"""
|
||||
interface = mock_ble_interface
|
||||
mac = "AA:BB:CC:DD:EE:03"
|
||||
|
||||
# Create discovered peer
|
||||
try:
|
||||
from ble_reticulum.BLEInterface import DiscoveredPeer
|
||||
interface.discovered_peers[mac] = DiscoveredPeer(mac, "Test-Device", -50)
|
||||
except ImportError:
|
||||
pytest.skip("DiscoveredPeer not available")
|
||||
|
||||
# Simulate 3 real connection failures
|
||||
for i in range(3):
|
||||
interface._record_connection_failure(mac)
|
||||
|
||||
# Real failures SHOULD trigger blacklist
|
||||
is_blacklisted = interface._is_blacklisted(mac)
|
||||
assert is_blacklisted is True, "Real connection failures should trigger blacklist"
|
||||
|
||||
|
||||
class TestDuplicateIdentityErrorClassification:
|
||||
"""Test that duplicate identity errors are classified differently from connection failures."""
|
||||
|
||||
def test_duplicate_identity_error_should_be_distinguishable(self):
|
||||
"""
|
||||
The fix should make duplicate identity errors distinguishable from real failures.
|
||||
|
||||
Options:
|
||||
1. Use different error severity (e.g., "warning" instead of "error")
|
||||
2. Use different error message format that doesn't match blacklist regex
|
||||
3. Add explicit flag to skip blacklisting
|
||||
4. Check error message content before blacklisting
|
||||
"""
|
||||
# This test documents the expected fix approach
|
||||
# The duplicate identity error should either:
|
||||
# a) Not trigger on_error at all (just log and return)
|
||||
# b) Use severity that doesn't trigger blacklist
|
||||
# c) Use message format that doesn't match blacklist regex
|
||||
|
||||
duplicate_error_msg = "Duplicate identity - already connected via different MAC"
|
||||
real_failure_msg = "Connection failed to AA:BB:CC:DD:EE:02: timeout"
|
||||
|
||||
# After fix, these should be distinguishable
|
||||
# For now, just document the requirement
|
||||
assert "Duplicate identity" in duplicate_error_msg
|
||||
assert "Connection failed" in real_failure_msg
|
||||
|
||||
def test_safe_error_message_formats_dont_trigger_blacklist(self):
|
||||
"""
|
||||
Verify that safe error message formats for duplicate identity
|
||||
don't match the blacklist regex pattern.
|
||||
|
||||
This test ensures that when we fix the bug (on both Linux and Android),
|
||||
we use message formats that won't trigger blacklisting.
|
||||
"""
|
||||
mac = "AA:BB:CC:DD:EE:02"
|
||||
|
||||
# The regex used in _error_callback to extract addresses for blacklisting
|
||||
blacklist_regex = r'(?:Connection (?:failed|timeout) to|to) ([0-9A-Fa-f]{2}:[0-9A-Fa-f]{2}:[0-9A-Fa-f]{2}:[0-9A-Fa-f]{2}:[0-9A-Fa-f]{2}:[0-9A-Fa-f]{2})'
|
||||
|
||||
# Messages that SHOULD trigger blacklist (real failures)
|
||||
unsafe_messages = [
|
||||
f"Connection failed to {mac}: timeout",
|
||||
f"Connection timeout to {mac}",
|
||||
f"Connection failed to {mac}: GATT error",
|
||||
]
|
||||
|
||||
# Messages that SHOULD NOT trigger blacklist (duplicate identity)
|
||||
safe_messages = [
|
||||
f"Duplicate identity rejected for {mac}",
|
||||
f"Rejecting duplicate identity from {mac} (already connected)",
|
||||
f"MAC rotation duplicate detected: {mac}",
|
||||
f"Duplicate identity - already connected via different MAC",
|
||||
f"Identity already connected at different address, rejecting {mac}",
|
||||
]
|
||||
|
||||
# Verify unsafe messages match the regex
|
||||
for msg in unsafe_messages:
|
||||
match = re.search(blacklist_regex, msg)
|
||||
assert match is not None, f"Unsafe message should match blacklist regex: {msg}"
|
||||
|
||||
# Verify safe messages do NOT match the regex
|
||||
for msg in safe_messages:
|
||||
match = re.search(blacklist_regex, msg)
|
||||
assert match is None, f"Safe message should NOT match blacklist regex: {msg}"
|
||||
|
||||
|
||||
class TestErrorCallbackBlacklistBehavior:
|
||||
"""Test the actual _error_callback behavior with different severities and messages."""
|
||||
|
||||
@pytest.fixture
|
||||
def mock_interface_for_error_callback(self):
|
||||
"""Create mock interface for testing _error_callback."""
|
||||
try:
|
||||
from ble_reticulum.BLEInterface import BLEInterface
|
||||
except ImportError:
|
||||
pytest.skip("BLEInterface not available")
|
||||
|
||||
interface = Mock()
|
||||
interface.connection_blacklist = {}
|
||||
interface.discovered_peers = {}
|
||||
interface.connection_retry_backoff = 60
|
||||
interface.max_connection_failures = 3
|
||||
|
||||
# Mock driver
|
||||
interface.driver = Mock()
|
||||
interface.driver._remove_bluez_device = None
|
||||
|
||||
# Import actual method
|
||||
from ble_reticulum.BLEInterface import BLEInterface as RealInterface
|
||||
|
||||
interface._record_connection_failure = lambda addr: RealInterface._record_connection_failure(interface, addr)
|
||||
interface._is_blacklisted = lambda addr: RealInterface._is_blacklisted(interface, addr)
|
||||
|
||||
return interface
|
||||
|
||||
def test_error_severity_info_does_not_trigger_blacklist(self, mock_interface_for_error_callback):
|
||||
"""
|
||||
Verify that errors with severity 'info' or 'debug' don't trigger blacklist.
|
||||
|
||||
The fix can use severity 'info' for duplicate identity rejections.
|
||||
"""
|
||||
# _error_callback only triggers blacklist for:
|
||||
# - severity == "error" or "critical"
|
||||
# - severity == "warning" with "Connection timeout" in message
|
||||
|
||||
# Safe severities that don't trigger blacklist:
|
||||
safe_severities = ['info', 'debug']
|
||||
|
||||
# This documents the expected behavior - after implementing the fix,
|
||||
# duplicate identity errors should use one of these safe severities
|
||||
for severity in safe_severities:
|
||||
assert severity in ['info', 'debug', 'notice'], f"Severity {severity} should be safe"
|
||||
|
||||
def test_error_callback_with_duplicate_identity_message(self, mock_interface_for_error_callback):
|
||||
"""
|
||||
Test that _error_callback properly handles duplicate identity messages.
|
||||
|
||||
After the fix, duplicate identity messages should NOT trigger blacklist
|
||||
regardless of how they arrive (Linux driver or Android callback).
|
||||
"""
|
||||
interface = mock_interface_for_error_callback
|
||||
mac = "AA:BB:CC:DD:EE:02"
|
||||
|
||||
# Create discovered peer
|
||||
try:
|
||||
from ble_reticulum.BLEInterface import DiscoveredPeer
|
||||
interface.discovered_peers[mac] = DiscoveredPeer(mac, "Test-Device", -50)
|
||||
except ImportError:
|
||||
pytest.skip("DiscoveredPeer not available")
|
||||
|
||||
# Import actual _error_callback
|
||||
try:
|
||||
from ble_reticulum.BLEInterface import BLEInterface as RealInterface
|
||||
# We can't easily call _error_callback directly without more setup,
|
||||
# but we can verify the regex behavior
|
||||
except ImportError:
|
||||
pytest.skip("BLEInterface not available")
|
||||
|
||||
# The key insight: if we use a message that doesn't contain
|
||||
# "Connection failed to" or "Connection timeout to", blacklist won't trigger
|
||||
|
||||
# Current buggy message (triggers blacklist):
|
||||
buggy_msg = f"Connection failed to {mac}: Duplicate identity"
|
||||
|
||||
# Fixed message (won't trigger blacklist):
|
||||
fixed_msg = f"Duplicate identity rejected for {mac}"
|
||||
|
||||
blacklist_regex = r'(?:Connection (?:failed|timeout) to|to) ([0-9A-Fa-f]{2}:[0-9A-Fa-f]{2}:[0-9A-Fa-f]{2}:[0-9A-Fa-f]{2}:[0-9A-Fa-f]{2}:[0-9A-Fa-f]{2})'
|
||||
|
||||
assert re.search(blacklist_regex, buggy_msg) is not None, "Buggy message triggers blacklist"
|
||||
assert re.search(blacklist_regex, fixed_msg) is None, "Fixed message should not trigger blacklist"
|
||||
|
||||
|
||||
class TestPeripheralModeDuplicateRejection:
|
||||
"""Test duplicate identity rejection in peripheral mode (_handle_identity_handshake)."""
|
||||
|
||||
@pytest.fixture
|
||||
def mock_ble_interface(self):
|
||||
"""Create a minimal mock of BLEInterface for peripheral mode testing."""
|
||||
try:
|
||||
from ble_reticulum.BLEInterface import BLEInterface
|
||||
except ImportError:
|
||||
pytest.skip("BLEInterface not available")
|
||||
|
||||
from unittest.mock import MagicMock
|
||||
|
||||
interface = MagicMock(spec=BLEInterface)
|
||||
interface.identity_to_address = {}
|
||||
interface.address_to_identity = {}
|
||||
|
||||
# Mock driver for disconnect calls
|
||||
interface.driver = MagicMock()
|
||||
interface.driver.disconnect = MagicMock()
|
||||
|
||||
# Configure __str__ for logging (MagicMock handles special methods)
|
||||
interface.__str__ = MagicMock(return_value="BLEInterface[Test]")
|
||||
|
||||
# Import the actual methods we want to test
|
||||
from ble_reticulum.BLEInterface import BLEInterface as RealInterface
|
||||
|
||||
interface._check_duplicate_identity = lambda addr, identity: RealInterface._check_duplicate_identity(interface, addr, identity)
|
||||
interface._compute_identity_hash = lambda identity: RealInterface._compute_identity_hash(interface, identity)
|
||||
interface._handle_identity_handshake = lambda addr, data: RealInterface._handle_identity_handshake(interface, addr, data)
|
||||
|
||||
return interface
|
||||
|
||||
def test_peripheral_mode_rejects_duplicate_identity(self, mock_ble_interface):
|
||||
"""
|
||||
Test that _handle_identity_handshake rejects duplicate identity.
|
||||
|
||||
In peripheral mode, when a central sends an identity handshake with an
|
||||
identity that's already connected at a different MAC, the connection
|
||||
should be rejected.
|
||||
"""
|
||||
interface = mock_ble_interface
|
||||
|
||||
# Setup: identity already connected at MAC_OLD
|
||||
identity = b'\x01\x02\x03\x04\x05\x06\x07\x08\x09\x0a\x0b\x0c\x0d\x0e\x0f\x10'
|
||||
mac_old = "AA:BB:CC:DD:EE:01"
|
||||
mac_new = "AA:BB:CC:DD:EE:02"
|
||||
|
||||
identity_hash = interface._compute_identity_hash(identity)
|
||||
interface.identity_to_address[identity_hash] = mac_old
|
||||
|
||||
# Check: duplicate should be detected for MAC_NEW
|
||||
is_duplicate = interface._check_duplicate_identity(mac_new, identity)
|
||||
|
||||
assert is_duplicate is True, (
|
||||
"Peripheral mode should detect duplicate identity when same identity "
|
||||
"is already connected at different MAC"
|
||||
)
|
||||
|
||||
def test_peripheral_mode_allows_new_identity(self, mock_ble_interface):
|
||||
"""
|
||||
Test that _handle_identity_handshake allows new identity.
|
||||
|
||||
When a central sends an identity that's not already connected,
|
||||
the connection should be allowed.
|
||||
"""
|
||||
interface = mock_ble_interface
|
||||
|
||||
# Setup: no existing connections
|
||||
identity = b'\x01\x02\x03\x04\x05\x06\x07\x08\x09\x0a\x0b\x0c\x0d\x0e\x0f\x10'
|
||||
mac_new = "AA:BB:CC:DD:EE:02"
|
||||
|
||||
# Check: should not be detected as duplicate
|
||||
is_duplicate = interface._check_duplicate_identity(mac_new, identity)
|
||||
|
||||
assert is_duplicate is False, (
|
||||
"Peripheral mode should allow new identity"
|
||||
)
|
||||
|
||||
def test_peripheral_mode_allows_same_mac_identity_refresh(self, mock_ble_interface):
|
||||
"""
|
||||
Test that _handle_identity_handshake allows identity refresh from same MAC.
|
||||
|
||||
When a central reconnects from the same MAC with the same identity,
|
||||
it should be allowed (not considered duplicate).
|
||||
"""
|
||||
interface = mock_ble_interface
|
||||
|
||||
# Setup: identity already connected at same MAC
|
||||
identity = b'\x01\x02\x03\x04\x05\x06\x07\x08\x09\x0a\x0b\x0c\x0d\x0e\x0f\x10'
|
||||
mac = "AA:BB:CC:DD:EE:01"
|
||||
|
||||
identity_hash = interface._compute_identity_hash(identity)
|
||||
interface.identity_to_address[identity_hash] = mac
|
||||
|
||||
# Check: same MAC should not be duplicate
|
||||
is_duplicate = interface._check_duplicate_identity(mac, identity)
|
||||
|
||||
assert is_duplicate is False, (
|
||||
"Peripheral mode should allow identity refresh from same MAC"
|
||||
)
|
||||
|
||||
def test_handle_identity_handshake_rejects_duplicate_and_disconnects(self, mock_ble_interface):
|
||||
"""
|
||||
Test that _handle_identity_handshake actually disconnects when duplicate detected.
|
||||
|
||||
This tests the full code path in _handle_identity_handshake that:
|
||||
1. Calls _check_duplicate_identity
|
||||
2. Logs warning
|
||||
3. Calls driver.disconnect()
|
||||
4. Returns True (handshake consumed)
|
||||
"""
|
||||
interface = mock_ble_interface
|
||||
|
||||
# Setup: identity already connected at MAC_OLD
|
||||
identity = b'\x01\x02\x03\x04\x05\x06\x07\x08\x09\x0a\x0b\x0c\x0d\x0e\x0f\x10'
|
||||
mac_old = "AA:BB:CC:DD:EE:01"
|
||||
mac_new = "AA:BB:CC:DD:EE:02"
|
||||
|
||||
identity_hash = interface._compute_identity_hash(identity)
|
||||
interface.identity_to_address[identity_hash] = mac_old
|
||||
|
||||
# Mock the driver to track disconnect calls
|
||||
disconnect_called = []
|
||||
interface.driver.disconnect = lambda addr: disconnect_called.append(addr)
|
||||
|
||||
# Call _handle_identity_handshake with duplicate identity
|
||||
result = interface._handle_identity_handshake(mac_new, identity)
|
||||
|
||||
# Should return True (handshake consumed/rejected)
|
||||
assert result is True, "Should return True when duplicate rejected"
|
||||
|
||||
# Should have called disconnect on the new MAC
|
||||
assert mac_new in disconnect_called, (
|
||||
f"Should disconnect duplicate connection. Called: {disconnect_called}"
|
||||
)
|
||||
|
||||
# Should NOT have added the new MAC to mappings
|
||||
assert mac_new not in interface.address_to_identity, (
|
||||
"Should not add duplicate identity to address_to_identity"
|
||||
)
|
||||
|
||||
def test_handle_identity_handshake_disconnect_exception_handled(self, mock_ble_interface):
|
||||
"""
|
||||
Test that _handle_identity_handshake handles disconnect exceptions gracefully.
|
||||
|
||||
If driver.disconnect() raises an exception, it should be caught and logged,
|
||||
but the handshake should still return True (rejected).
|
||||
"""
|
||||
interface = mock_ble_interface
|
||||
|
||||
# Setup: identity already connected at MAC_OLD
|
||||
identity = b'\x01\x02\x03\x04\x05\x06\x07\x08\x09\x0a\x0b\x0c\x0d\x0e\x0f\x10'
|
||||
mac_old = "AA:BB:CC:DD:EE:01"
|
||||
mac_new = "AA:BB:CC:DD:EE:02"
|
||||
|
||||
identity_hash = interface._compute_identity_hash(identity)
|
||||
interface.identity_to_address[identity_hash] = mac_old
|
||||
|
||||
# Mock the driver to raise exception on disconnect
|
||||
def raise_on_disconnect(addr):
|
||||
raise Exception("Disconnect failed")
|
||||
interface.driver.disconnect = raise_on_disconnect
|
||||
|
||||
# Call _handle_identity_handshake - should not raise
|
||||
result = interface._handle_identity_handshake(mac_new, identity)
|
||||
|
||||
# Should still return True (handshake consumed/rejected)
|
||||
assert result is True, "Should return True even if disconnect fails"
|
||||
|
||||
|
||||
class TestLinuxDriverDuplicateIdentityErrorHandling:
|
||||
"""Tests for linux_bluetooth_driver duplicate identity exception handling."""
|
||||
|
||||
def test_duplicate_identity_error_logs_warning_not_error(self):
|
||||
"""
|
||||
Test that duplicate identity exceptions are logged as WARNING, not ERROR.
|
||||
|
||||
When a connection fails due to duplicate identity detection, we want to
|
||||
log it as a warning (expected behavior during MAC rotation) not an error.
|
||||
"""
|
||||
from ble_reticulum.linux_bluetooth_driver import LinuxBluetoothDriver
|
||||
|
||||
# Create driver with minimal mocking
|
||||
driver = LinuxBluetoothDriver.__new__(LinuxBluetoothDriver)
|
||||
driver._log_messages = []
|
||||
|
||||
def capture_log(msg, level="INFO"):
|
||||
driver._log_messages.append((msg, level))
|
||||
|
||||
driver._log = capture_log
|
||||
|
||||
# Test the error message detection logic directly
|
||||
error_str = "Duplicate identity rejected for AA:BB:CC:DD:EE:FF"
|
||||
is_duplicate = "Duplicate identity" in error_str
|
||||
|
||||
assert is_duplicate is True, "Should detect duplicate identity in error message"
|
||||
|
||||
# Log with appropriate level based on detection
|
||||
if is_duplicate:
|
||||
driver._log(f"Duplicate identity rejected: {error_str}", "WARNING")
|
||||
else:
|
||||
driver._log(f"Connection failed: {error_str}", "ERROR")
|
||||
|
||||
# Check the log level
|
||||
assert len(driver._log_messages) == 1
|
||||
msg, level = driver._log_messages[0]
|
||||
assert level == "WARNING", f"Expected WARNING level, got {level}"
|
||||
assert "Duplicate identity" in msg
|
||||
|
||||
def test_normal_connection_error_logs_as_error(self):
|
||||
"""
|
||||
Test that normal connection errors are still logged as ERROR.
|
||||
"""
|
||||
from ble_reticulum.linux_bluetooth_driver import LinuxBluetoothDriver
|
||||
|
||||
driver = LinuxBluetoothDriver.__new__(LinuxBluetoothDriver)
|
||||
driver._log_messages = []
|
||||
|
||||
def capture_log(msg, level="INFO"):
|
||||
driver._log_messages.append((msg, level))
|
||||
|
||||
driver._log = capture_log
|
||||
|
||||
# Normal connection error (not duplicate identity)
|
||||
error_str = "Connection timeout to AA:BB:CC:DD:EE:FF"
|
||||
is_duplicate = "Duplicate identity" in error_str
|
||||
|
||||
assert is_duplicate is False, "Should not detect duplicate identity in timeout error"
|
||||
|
||||
# Log with appropriate level
|
||||
if is_duplicate:
|
||||
driver._log(f"Duplicate identity rejected: {error_str}", "WARNING")
|
||||
else:
|
||||
driver._log(f"Connection failed: {error_str}", "ERROR")
|
||||
|
||||
# Check the log level
|
||||
assert len(driver._log_messages) == 1
|
||||
msg, level = driver._log_messages[0]
|
||||
assert level == "ERROR", f"Expected ERROR level, got {level}"
|
||||
|
||||
def test_error_callback_uses_info_for_duplicate_identity(self):
|
||||
"""
|
||||
Test that on_error callback uses 'info' severity for duplicate identity.
|
||||
|
||||
This prevents the blacklist from being triggered for expected MAC rotation
|
||||
rejections.
|
||||
"""
|
||||
from ble_reticulum.linux_bluetooth_driver import LinuxBluetoothDriver
|
||||
|
||||
driver = LinuxBluetoothDriver.__new__(LinuxBluetoothDriver)
|
||||
error_callbacks = []
|
||||
|
||||
def capture_error(severity, message, exception):
|
||||
error_callbacks.append((severity, message, exception))
|
||||
|
||||
driver.on_error = capture_error
|
||||
|
||||
# Simulate duplicate identity error handling
|
||||
error = Exception("Duplicate identity detected")
|
||||
error_str = str(error)
|
||||
is_duplicate = "Duplicate identity" in error_str
|
||||
address = "AA:BB:CC:DD:EE:FF"
|
||||
|
||||
if is_duplicate:
|
||||
driver.on_error("info", f"Duplicate identity rejected for {address} (MAC rotation)", error)
|
||||
else:
|
||||
driver.on_error("error", f"Connection failed to {address}: {error}", error)
|
||||
|
||||
# Check callback was called with 'info' severity
|
||||
assert len(error_callbacks) == 1
|
||||
severity, msg, exc = error_callbacks[0]
|
||||
assert severity == "info", f"Expected 'info' severity for duplicate identity, got '{severity}'"
|
||||
assert "Duplicate identity rejected" in msg
|
||||
assert "MAC rotation" in msg
|
||||
|
||||
|
||||
class TestLinuxDriverDuplicateIdentityCodePath:
|
||||
"""
|
||||
Integration tests that exercise the actual code path in linux_bluetooth_driver.py.
|
||||
|
||||
These tests patch BleakClient to trigger the duplicate identity exception handling
|
||||
code in _connect_to_peer_async(), ensuring the actual driver code is covered.
|
||||
"""
|
||||
|
||||
@pytest.fixture
|
||||
def driver_with_callbacks(self):
|
||||
"""Create a LinuxBluetoothDriver with minimal setup for testing."""
|
||||
from ble_reticulum.linux_bluetooth_driver import LinuxBluetoothDriver
|
||||
|
||||
# Create driver instance using __new__ to skip __init__
|
||||
driver = LinuxBluetoothDriver.__new__(LinuxBluetoothDriver)
|
||||
|
||||
# Set up minimal required attributes for _connect_to_peer
|
||||
driver._log_messages = []
|
||||
driver._connecting_peers = set()
|
||||
driver._connecting_lock = threading.RLock()
|
||||
driver._connected_peers = {}
|
||||
driver._peer_roles = {}
|
||||
driver._peers = {}
|
||||
driver._peers_lock = threading.RLock()
|
||||
driver._connection_timeout = 10.0
|
||||
driver.connection_timeout = 10.0 # Property alias
|
||||
driver._service_discovery_delay = 0.5
|
||||
driver.service_discovery_delay = 0.5 # Property alias
|
||||
driver.service_uuid = "37145b00-442d-4a94-917f-8f42c5da28e3"
|
||||
driver.tx_char_uuid = "37145b00-442d-4a94-917f-8f42c5da28e4"
|
||||
driver.rx_char_uuid = "37145b00-442d-4a94-917f-8f42c5da28e5"
|
||||
driver.identity_char_uuid = "37145b00-442d-4a94-917f-8f42c5da28e6"
|
||||
driver._local_identity = b'\x01\x02\x03\x04\x05\x06\x07\x08\x09\x0a\x0b\x0c\x0d\x0e\x0f\x10'
|
||||
driver.adapter_path = "/org/bluez/hci0"
|
||||
|
||||
# BlueZ version tracking (skip LE-specific connection path)
|
||||
driver.bluez_version = None
|
||||
driver.has_connect_device = False
|
||||
|
||||
# Capture log messages
|
||||
def capture_log(msg, level="INFO"):
|
||||
driver._log_messages.append((msg, level))
|
||||
|
||||
driver._log = capture_log
|
||||
|
||||
# Capture error callbacks
|
||||
driver._error_callbacks = []
|
||||
|
||||
def capture_error(severity, message, exception):
|
||||
driver._error_callbacks.append((severity, message, exception))
|
||||
|
||||
driver.on_error = capture_error
|
||||
|
||||
# Mock _remove_bluez_device
|
||||
driver._remove_bluez_device = AsyncMock(return_value=True)
|
||||
|
||||
# Mock callbacks (not needed for this test path)
|
||||
driver.on_device_connected = None
|
||||
driver.on_device_disconnected = None
|
||||
driver.on_mtu_negotiated = None
|
||||
|
||||
return driver
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_duplicate_identity_exception_uses_warning_log(self, driver_with_callbacks):
|
||||
"""
|
||||
Test that when BleakClient raises a 'Duplicate identity' exception,
|
||||
the driver logs it as WARNING instead of ERROR.
|
||||
|
||||
This exercises the actual code path in linux_bluetooth_driver.py:1207-1214.
|
||||
"""
|
||||
driver = driver_with_callbacks
|
||||
address = "AA:BB:CC:DD:EE:FF"
|
||||
|
||||
# Create a mock client that raises duplicate identity exception on connect
|
||||
mock_client = AsyncMock()
|
||||
mock_client.is_connected = False
|
||||
mock_client.connect = AsyncMock(
|
||||
side_effect=Exception("Duplicate identity - already connected via different MAC (Android MAC rotation)")
|
||||
)
|
||||
|
||||
# Patch BleakClient to return our mock
|
||||
with patch('ble_reticulum.linux_bluetooth_driver.BleakClient', return_value=mock_client):
|
||||
# Call the async connection method
|
||||
await driver._connect_to_peer(address)
|
||||
|
||||
# Verify the log message uses WARNING level
|
||||
warning_logs = [(msg, lvl) for msg, lvl in driver._log_messages if lvl == "WARNING"]
|
||||
error_logs = [(msg, lvl) for msg, lvl in driver._log_messages if lvl == "ERROR"]
|
||||
|
||||
# Should have WARNING log for duplicate identity
|
||||
assert any("Duplicate identity rejected" in msg for msg, _ in warning_logs), \
|
||||
f"Expected WARNING log with 'Duplicate identity rejected', got warnings: {warning_logs}"
|
||||
|
||||
# Should NOT have ERROR log for duplicate identity
|
||||
duplicate_errors = [msg for msg, _ in error_logs if "Duplicate identity" in msg]
|
||||
assert len(duplicate_errors) == 0, \
|
||||
f"Should not log duplicate identity as ERROR, got: {duplicate_errors}"
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_duplicate_identity_exception_uses_info_severity_callback(self, driver_with_callbacks):
|
||||
"""
|
||||
Test that when BleakClient raises a 'Duplicate identity' exception,
|
||||
the on_error callback is called with 'info' severity, not 'error'.
|
||||
|
||||
This exercises the actual code path in linux_bluetooth_driver.py:1234-1238.
|
||||
"""
|
||||
driver = driver_with_callbacks
|
||||
address = "AA:BB:CC:DD:EE:FF"
|
||||
|
||||
# Create a mock client that raises duplicate identity exception on connect
|
||||
mock_client = AsyncMock()
|
||||
mock_client.is_connected = False
|
||||
mock_client.connect = AsyncMock(
|
||||
side_effect=Exception("Duplicate identity - already connected via different MAC")
|
||||
)
|
||||
|
||||
# Patch BleakClient to return our mock
|
||||
with patch('ble_reticulum.linux_bluetooth_driver.BleakClient', return_value=mock_client):
|
||||
await driver._connect_to_peer(address)
|
||||
|
||||
# Verify the on_error callback was called with 'info' severity
|
||||
assert len(driver._error_callbacks) == 1, \
|
||||
f"Expected exactly 1 error callback, got {len(driver._error_callbacks)}"
|
||||
|
||||
severity, message, exception = driver._error_callbacks[0]
|
||||
|
||||
assert severity == "info", \
|
||||
f"Expected 'info' severity for duplicate identity, got '{severity}'"
|
||||
|
||||
assert "Duplicate identity rejected" in message, \
|
||||
f"Expected 'Duplicate identity rejected' in message, got: {message}"
|
||||
|
||||
assert "MAC rotation" in message, \
|
||||
f"Expected 'MAC rotation' in message, got: {message}"
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_normal_exception_still_uses_error_severity(self, driver_with_callbacks):
|
||||
"""
|
||||
Test that normal (non-duplicate-identity) exceptions still use 'error' severity.
|
||||
|
||||
This ensures we didn't break normal error handling.
|
||||
"""
|
||||
driver = driver_with_callbacks
|
||||
address = "AA:BB:CC:DD:EE:FF"
|
||||
|
||||
# Create a mock client that raises a normal exception on connect
|
||||
mock_client = AsyncMock()
|
||||
mock_client.is_connected = False
|
||||
mock_client.connect = AsyncMock(
|
||||
side_effect=Exception("Connection refused by peer")
|
||||
)
|
||||
mock_client.disconnect = AsyncMock()
|
||||
|
||||
# Patch BleakClient to return our mock
|
||||
with patch('ble_reticulum.linux_bluetooth_driver.BleakClient', return_value=mock_client):
|
||||
await driver._connect_to_peer(address)
|
||||
|
||||
# Verify the on_error callback was called with 'error' severity
|
||||
assert len(driver._error_callbacks) == 1, \
|
||||
f"Expected exactly 1 error callback, got {len(driver._error_callbacks)}"
|
||||
|
||||
severity, message, exception = driver._error_callbacks[0]
|
||||
|
||||
assert severity == "error", \
|
||||
f"Expected 'error' severity for normal failure, got '{severity}'"
|
||||
|
||||
assert "Connection failed to" in message, \
|
||||
f"Expected 'Connection failed to' in message, got: {message}"
|
||||
|
||||
# Verify ERROR log was used
|
||||
error_logs = [(msg, lvl) for msg, lvl in driver._log_messages if lvl == "ERROR"]
|
||||
assert any("Connection failed to" in msg for msg, _ in error_logs), \
|
||||
f"Expected ERROR log with 'Connection failed to', got: {error_logs}"
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
pytest.main([__file__, "-v"])
|
||||
|
|
@ -243,6 +243,9 @@ class TestPeerAddressMacRotation:
|
|||
|
||||
When we receive an identity handshake from a new address but already have
|
||||
an interface for that identity, we must update peer_address.
|
||||
|
||||
Note: This simulates MAC rotation where the old connection has dropped
|
||||
but the peer interface is still alive (waiting for reconnection).
|
||||
"""
|
||||
old_addr = ble_interface._old_address
|
||||
new_addr = ble_interface._new_address
|
||||
|
|
@ -253,8 +256,16 @@ class TestPeerAddressMacRotation:
|
|||
assert mock_peer_interface.peer_address == old_addr
|
||||
assert identity_hash in ble_interface.spawned_interfaces
|
||||
|
||||
# Setup: peer connected at new address - but NO identity mapping yet
|
||||
# This simulates a central reconnecting at a new MAC address
|
||||
# Setup for MAC rotation: old connection is gone, new connection arrives
|
||||
# Remove old address from peers (simulates old connection dropped)
|
||||
del ble_interface.peers[old_addr]
|
||||
# Remove old address from address_to_identity (cleaned up after disconnect)
|
||||
del ble_interface.address_to_identity[old_addr]
|
||||
# Remove old address from identity_to_address
|
||||
# (this gets cleared during disconnect cleanup in real code)
|
||||
del ble_interface.identity_to_address[identity_hash]
|
||||
|
||||
# New peer connects at new address
|
||||
ble_interface.peers[new_addr] = (Mock(is_connected=True), 0, 185)
|
||||
# NOTE: Do NOT add new_addr to address_to_identity - the handshake does that
|
||||
|
||||
|
|
|
|||
|
|
@ -53,54 +53,55 @@ if not hasattr(RNS, 'Identity'):
|
|||
RNS.Identity = MagicMock()
|
||||
RNS.Identity.full_hash = lambda x: (x * 2)[:16] # Simple mock
|
||||
|
||||
# Mock ble_reticulum.Interface (required by BLEInterface.py)
|
||||
# First, ensure mock is in place BEFORE any imports that need it
|
||||
rns_interfaces_mock = MagicMock()
|
||||
_sys.modules['ble_reticulum'] = rns_interfaces_mock
|
||||
_sys.modules['ble_reticulum.Interface'] = MagicMock()
|
||||
# Mock ble_reticulum.Interface module (the base class module, not the whole namespace)
|
||||
# We only mock the Interface.py module, allowing BLEInterface.py to be imported from src/
|
||||
if 'ble_reticulum.Interface' not in _sys.modules:
|
||||
# Create mock Interface base class
|
||||
class MockInterface:
|
||||
MODE_FULL = 1
|
||||
def __init__(self):
|
||||
self.IN = True
|
||||
self.OUT = True
|
||||
self.online = False
|
||||
|
||||
# Create mock Interface base class
|
||||
class MockInterface:
|
||||
MODE_FULL = 1
|
||||
def __init__(self):
|
||||
self.IN = True
|
||||
self.OUT = True
|
||||
self.online = False
|
||||
@staticmethod
|
||||
def get_config_obj(configuration):
|
||||
"""Mock config object wrapper - just returns a dict-like object."""
|
||||
class ConfigObj:
|
||||
def __init__(self, config):
|
||||
self._config = config if config else {}
|
||||
|
||||
@staticmethod
|
||||
def get_config_obj(configuration):
|
||||
"""Mock config object that returns dict values via attribute access."""
|
||||
class ConfigObj:
|
||||
def __init__(self, config_dict):
|
||||
self._config = config_dict if isinstance(config_dict, dict) else {}
|
||||
def __getitem__(self, key):
|
||||
return self._config.get(key)
|
||||
|
||||
def __getattr__(self, name):
|
||||
return self._config.get(name)
|
||||
def get(self, key, default=None):
|
||||
return self._config.get(key, default)
|
||||
|
||||
def __contains__(self, key):
|
||||
return key in self._config
|
||||
def as_string(self, key, default=None):
|
||||
val = self._config.get(key, default)
|
||||
return str(val) if val is not None else default
|
||||
|
||||
def get(self, key, default=None):
|
||||
return self._config.get(key, default)
|
||||
def as_int(self, key, default=None):
|
||||
val = self._config.get(key, default)
|
||||
return int(val) if val is not None else default
|
||||
|
||||
def as_dict(self):
|
||||
return self._config
|
||||
def as_bool(self, key, default=False):
|
||||
val = self._config.get(key, default)
|
||||
if isinstance(val, bool):
|
||||
return val
|
||||
if isinstance(val, str):
|
||||
return val.lower() in ('true', 'yes', '1', 'on')
|
||||
return bool(val) if val is not None else default
|
||||
return ConfigObj(configuration)
|
||||
|
||||
return ConfigObj(configuration)
|
||||
|
||||
rns_interfaces_mock.Interface = MockInterface
|
||||
_sys.modules['ble_reticulum.Interface'].Interface = MockInterface
|
||||
# Create a mock module for ble_reticulum.Interface
|
||||
interface_module = MagicMock()
|
||||
interface_module.Interface = MockInterface
|
||||
_sys.modules['ble_reticulum.Interface'] = interface_module
|
||||
|
||||
from tests.mock_ble_driver import MockBLEDriver
|
||||
|
||||
# Import BLEInterface directly using importlib to bypass RNS namespace conflicts
|
||||
import importlib.util
|
||||
_ble_interface_path = os.path.join(os.path.dirname(__file__), '..', 'src', 'RNS', 'Interfaces', 'BLEInterface.py')
|
||||
_spec = importlib.util.spec_from_file_location("BLEInterface", _ble_interface_path)
|
||||
_ble_module = importlib.util.module_from_spec(_spec)
|
||||
_spec.loader.exec_module(_ble_module)
|
||||
BLEInterface = _ble_module.BLEInterface
|
||||
DiscoveredPeer = _ble_module.DiscoveredPeer
|
||||
from ble_reticulum.BLEInterface import BLEInterface, DiscoveredPeer
|
||||
from ble_reticulum.BLEFragmentation import BLEFragmenter, BLEReassembler
|
||||
import time
|
||||
|
||||
|
||||
|
|
@ -172,8 +173,8 @@ class TestIdentityHandshakeBasics:
|
|||
|
||||
# Create fragmenter and peer interface (simulating post-handshake state)
|
||||
frag_key = interface._get_fragmenter_key(existing_identity, central_address)
|
||||
interface.fragmenters[frag_key] = interface._create_fragmenter(185)
|
||||
interface.reassemblers[frag_key] = interface._create_reassembler()
|
||||
interface.fragmenters[frag_key] = BLEFragmenter(mtu=185)
|
||||
interface.reassemblers[frag_key] = BLEReassembler()
|
||||
|
||||
# Receive 16-byte data packet (should be processed as data, not handshake)
|
||||
data_packet = b'\xaa\xbb\xcc\xdd\xee\xff\x11\x22\x33\x44\x55\x66\x77\x88\x99\x00'
|
||||
|
|
@ -273,11 +274,7 @@ class TestIdentityHandshakeBidirectional:
|
|||
peripheral_driver = MockBLEDriver(local_address="BB:BB:BB:BB:BB:BB")
|
||||
MockBLEDriver.link_drivers(central_driver, peripheral_driver)
|
||||
|
||||
# Set peripheral identity
|
||||
peripheral_identity = b'\x11\x11\x11\x11\x11\x11\x11\x11\x11\x11\x11\x11\x11\x11\x11\x11'
|
||||
peripheral_driver.set_identity(peripheral_identity)
|
||||
|
||||
# Start both drivers
|
||||
# Start both drivers first (sets up characteristic UUIDs)
|
||||
central_driver.start(
|
||||
service_uuid="test-uuid",
|
||||
rx_char_uuid="rx-uuid",
|
||||
|
|
@ -291,6 +288,10 @@ class TestIdentityHandshakeBidirectional:
|
|||
identity_char_uuid="identity-uuid"
|
||||
)
|
||||
|
||||
# Set peripheral identity (after start() so characteristic UUID is available)
|
||||
peripheral_identity = b'\x11\x11\x11\x11\x11\x11\x11\x11\x11\x11\x11\x11\x11\x11\x11\x11'
|
||||
peripheral_driver.set_identity(peripheral_identity)
|
||||
|
||||
# Central connects to peripheral
|
||||
central_driver.connect(peripheral_driver.local_address)
|
||||
|
||||
|
|
|
|||
|
|
@ -64,11 +64,9 @@ if not hasattr(RNS, 'Identity'):
|
|||
RNS.Identity = MagicMock()
|
||||
RNS.Identity.full_hash = lambda x: (x * 2)[:16]
|
||||
|
||||
# Mock ble_reticulum.Interface (required by BLEInterface.py)
|
||||
if 'ble_reticulum' not in _sys.modules:
|
||||
rns_interfaces_mock = MagicMock()
|
||||
_sys.modules['ble_reticulum'] = rns_interfaces_mock
|
||||
|
||||
# Mock ble_reticulum.Interface module (the base class module, not the whole namespace)
|
||||
# We only mock the Interface.py module, allowing BLEInterface.py to be imported from src/
|
||||
if 'ble_reticulum.Interface' not in _sys.modules:
|
||||
# Create mock Interface base class
|
||||
class MockInterface:
|
||||
MODE_FULL = 1
|
||||
|
|
@ -77,7 +75,40 @@ if 'ble_reticulum' not in _sys.modules:
|
|||
self.OUT = True
|
||||
self.online = False
|
||||
|
||||
rns_interfaces_mock.Interface = MockInterface
|
||||
@staticmethod
|
||||
def get_config_obj(configuration):
|
||||
"""Mock config object wrapper - just returns a dict-like object."""
|
||||
class ConfigObj:
|
||||
def __init__(self, config):
|
||||
self._config = config if config else {}
|
||||
|
||||
def __getitem__(self, key):
|
||||
return self._config.get(key)
|
||||
|
||||
def get(self, key, default=None):
|
||||
return self._config.get(key, default)
|
||||
|
||||
def as_string(self, key, default=None):
|
||||
val = self._config.get(key, default)
|
||||
return str(val) if val is not None else default
|
||||
|
||||
def as_int(self, key, default=None):
|
||||
val = self._config.get(key, default)
|
||||
return int(val) if val is not None else default
|
||||
|
||||
def as_bool(self, key, default=False):
|
||||
val = self._config.get(key, default)
|
||||
if isinstance(val, bool):
|
||||
return val
|
||||
if isinstance(val, str):
|
||||
return val.lower() in ('true', 'yes', '1', 'on')
|
||||
return bool(val) if val is not None else default
|
||||
return ConfigObj(configuration)
|
||||
|
||||
# Create a mock module for ble_reticulum.Interface
|
||||
interface_module = MagicMock()
|
||||
interface_module.Interface = MockInterface
|
||||
_sys.modules['ble_reticulum.Interface'] = interface_module
|
||||
|
||||
from tests.mock_ble_driver import MockBLEDriver
|
||||
from ble_reticulum.BLEInterface import BLEInterface, DiscoveredPeer
|
||||
|
|
@ -121,7 +152,8 @@ class TestRateLimiting:
|
|||
|
||||
def test_connection_allowed_after_5_seconds(self):
|
||||
"""Test that connection is allowed after 5-second cooldown."""
|
||||
driver = MockBLEDriver(local_address="AA:BB:CC:DD:EE:FF")
|
||||
# Use local MAC lower than peer MAC so connection direction allows us to initiate
|
||||
driver = MockBLEDriver(local_address="11:11:11:11:11:11")
|
||||
owner = MockOwner()
|
||||
|
||||
config = {"name": "Test", "enable_central": True}
|
||||
|
|
@ -129,7 +161,7 @@ class TestRateLimiting:
|
|||
interface.driver = driver
|
||||
interface.local_address = driver.local_address
|
||||
|
||||
peer_address = "11:22:33:44:55:66"
|
||||
peer_address = "22:22:22:22:22:22"
|
||||
peer = DiscoveredPeer(peer_address, "TestPeer", -60)
|
||||
|
||||
# Record connection attempt 6 seconds ago (past cooldown)
|
||||
|
|
@ -146,7 +178,8 @@ class TestRateLimiting:
|
|||
|
||||
def test_never_attempted_peer_allowed(self):
|
||||
"""Test that peer with no prior attempts is allowed."""
|
||||
driver = MockBLEDriver(local_address="AA:BB:CC:DD:EE:FF")
|
||||
# Use local MAC lower than peer MAC so connection direction allows us to initiate
|
||||
driver = MockBLEDriver(local_address="11:11:11:11:11:11")
|
||||
owner = MockOwner()
|
||||
|
||||
config = {"name": "Test", "enable_central": True}
|
||||
|
|
@ -154,7 +187,7 @@ class TestRateLimiting:
|
|||
interface.driver = driver
|
||||
interface.local_address = driver.local_address
|
||||
|
||||
peer_address = "11:22:33:44:55:66"
|
||||
peer_address = "22:22:22:22:22:22"
|
||||
peer = DiscoveredPeer(peer_address, "TestPeer", -60)
|
||||
|
||||
# last_connection_attempt == 0 (never attempted)
|
||||
|
|
@ -208,7 +241,8 @@ class TestDriverStateTracking:
|
|||
|
||||
def test_multiple_rapid_discoveries_handled(self):
|
||||
"""Test that rapid discovery callbacks don't cause duplicate connections."""
|
||||
driver = MockBLEDriver(local_address="AA:BB:CC:DD:EE:FF")
|
||||
# Use local MAC lower than peer MAC so connection direction allows us to initiate
|
||||
driver = MockBLEDriver(local_address="11:11:11:11:11:11")
|
||||
owner = MockOwner()
|
||||
|
||||
config = {"name": "Test", "enable_central": True}
|
||||
|
|
@ -216,21 +250,30 @@ class TestDriverStateTracking:
|
|||
interface.driver = driver
|
||||
interface.local_address = driver.local_address
|
||||
|
||||
peer_address = "11:22:33:44:55:66"
|
||||
peer_address = "22:22:22:22:22:22"
|
||||
peer = DiscoveredPeer(peer_address, "TestPeer", -60)
|
||||
|
||||
# Simulate rapid discovery callbacks (5 times in quick succession)
|
||||
for i in range(5):
|
||||
interface.discovered_peers[peer_address] = peer
|
||||
interface._select_peers_to_connect()
|
||||
# Manually record the first connection attempt (simulating what _try_connect_to_peer does)
|
||||
# This is needed because _select_peers_to_connect() only returns peers to connect,
|
||||
# it doesn't actually initiate the connection or record the attempt
|
||||
interface.discovered_peers[peer_address] = peer
|
||||
first_selection = interface._select_peers_to_connect()
|
||||
|
||||
# After first selection, peer should have recorded attempt
|
||||
# Subsequent selections should be rate-limited
|
||||
# First selection should include the peer
|
||||
assert len(first_selection) == 1
|
||||
assert first_selection[0].address == peer_address
|
||||
|
||||
# Check that last_connection_attempt was recorded
|
||||
# Record the attempt (simulating what happens when connection is initiated)
|
||||
peer.record_connection_attempt()
|
||||
|
||||
# Subsequent rapid selections should be rate-limited
|
||||
for i in range(4):
|
||||
subsequent_selection = interface._select_peers_to_connect()
|
||||
# Should be empty because peer was just attempted
|
||||
assert len(subsequent_selection) == 0, f"Selection {i+2} should be empty due to rate limiting"
|
||||
|
||||
# Verify timestamp was recorded
|
||||
assert peer.last_connection_attempt > 0
|
||||
|
||||
# Verify recent timestamp
|
||||
time_since = time.time() - peer.last_connection_attempt
|
||||
assert time_since < 1.0 # Should be very recent
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue