diff --git a/README.md b/README.md index 51ca23a..99efd5a 100644 --- a/README.md +++ b/README.md @@ -250,6 +250,50 @@ These errors occur when BlueZ attempts Classic Bluetooth (BR/EDR) connections in **Solution:** Enable BlueZ experimental mode (see Installation → Manual Installation → step 4). If you used the automated installer, re-run it without `--skip-experimental`. +### Bluetooth adapter not powered / "No powered Bluetooth adapters found" +The Bluetooth adapter exists but is powered off, preventing BLE operations. + +**Symptoms:** +- Error: `dbus.exceptions.DBusException: org.bluez.Error.Failed: Not Powered` +- Error: `BleakError: No powered Bluetooth adapters found.` +- BLE interface fails to start or discover peers +- GATT server startup fails immediately + +**Cause:** +The Bluetooth adapter is in a powered-off state. This commonly happens on Raspberry Pi after boot or system updates. + +**Solution:** +Power on the Bluetooth adapter: + +```bash +# Option 1: Using bluetoothctl (recommended) +bluetoothctl power on + +# Option 2: If adapter is RF-blocked +sudo rfkill unblock bluetooth + +# Option 3: Using hciconfig (older systems) +sudo hciconfig hci0 up + +# Verify adapter is powered: +bluetoothctl show +# Should display "Powered: yes" +``` + +**Automatic power-on at boot:** +Ensure Bluetooth service is enabled and starts at boot: + +```bash +# Enable Bluetooth service +sudo systemctl enable bluetooth +sudo systemctl start bluetooth + +# For persistent power-on, create a systemd service: +# See examples/bluetooth-power-on.service +``` + +The automated installer (v1.x+) automatically checks and powers on the Bluetooth adapter during installation. + ## Architecture The BLE interface consists of four main components: diff --git a/examples/bluetooth-power-on.service b/examples/bluetooth-power-on.service new file mode 100644 index 0000000..a350f75 --- /dev/null +++ b/examples/bluetooth-power-on.service @@ -0,0 +1,12 @@ +[Unit] +Description=Ensure Bluetooth adapter is powered on at boot +After=bluetooth.service +Requires=bluetooth.service + +[Service] +Type=oneshot +ExecStart=/bin/sh -c 'echo -e "power on\nquit" | /usr/bin/bluetoothctl' +RemainAfterExit=yes + +[Install] +WantedBy=multi-user.target diff --git a/examples/config_example.toml b/examples/config_example.toml index 823fd75..a5bf0ef 100644 --- a/examples/config_example.toml +++ b/examples/config_example.toml @@ -266,6 +266,15 @@ power_mode = balanced # - If you used install.sh, it should have enabled this automatically # - Verify: ps aux | grep bluetoothd (should show -E flag) # +# 7. Bluetooth adapter not powered (No powered Bluetooth adapters found): +# IMPORTANT: BLE interface won't work if adapter is powered off! +# - Symptoms: "Not Powered" errors, interface fails to start, no peer discovery +# - Solution: bluetoothctl power on +# - Verify: bluetoothctl show (should display "Powered: yes") +# - For automatic power-on at boot: see examples/bluetooth-power-on.service +# - If blocked: sudo rfkill unblock bluetooth +# - The installer (v1.x+) automatically powers on the adapter +# # For more troubleshooting, see README.md # ============================================================================ diff --git a/install.sh b/install.sh index f3a3520..3ebf450 100755 --- a/install.sh +++ b/install.sh @@ -618,6 +618,45 @@ EOF fi fi +# Step 5B: Bluetooth Adapter Power State +print_header "Bluetooth Adapter Power State" + +if command -v bluetoothctl &> /dev/null; then + print_info "Checking Bluetooth adapter power state..." + + # Check if adapter is powered + if bluetoothctl show | grep -q "Powered: yes"; then + print_success "Bluetooth adapter is powered on" + else + print_warning "Bluetooth adapter is not powered" + print_info "Powering on Bluetooth adapter..." + + # Power on the adapter + echo -e "power on\nquit" | bluetoothctl > /dev/null 2>&1 + + # Verify it worked + sleep 1 + if bluetoothctl show | grep -q "Powered: yes"; then + print_success "Bluetooth adapter powered on successfully" + else + print_error "Failed to power on Bluetooth adapter" + echo + print_info "Troubleshooting steps:" + echo " 1. Check if adapter is blocked: sudo rfkill list bluetooth" + echo " 2. Unblock if needed: sudo rfkill unblock bluetooth" + echo " 3. Try manually: bluetoothctl power on" + echo " 4. Verify adapter exists: bluetoothctl list" + echo + print_warning "BLE interface may not work until adapter is powered on" + fi + fi +else + print_warning "bluetoothctl not available, cannot check adapter power state" + print_info "Ensure Bluetooth adapter is powered on before running rnsd" +fi + +echo + # Step 6: Configuration print_header "Configuration" diff --git a/src/RNS/Interfaces/BLEInterface.py b/src/RNS/Interfaces/BLEInterface.py index d5672d1..604042c 100644 --- a/src/RNS/Interfaces/BLEInterface.py +++ b/src/RNS/Interfaces/BLEInterface.py @@ -862,9 +862,23 @@ class BLEInterface(Interface): RNS.log(f"{self} scanning for peers (scan_time={scan_time:.1f}s)...", RNS.LOG_EXTREME) scanner = BleakScanner(detection_callback=detection_callback) - await scanner.start() - await asyncio.sleep(scan_time) - await scanner.stop() + try: + await scanner.start() + await asyncio.sleep(scan_time) + await scanner.stop() + except Exception as e: + error_msg = str(e) + # Check for "Not Powered" or similar adapter power issues + if "No powered Bluetooth adapters" in error_msg or "Not Powered" in error_msg: + RNS.log(f"{self} Bluetooth adapter is not powered!", RNS.LOG_ERROR) + RNS.log(f"{self} Solution: Run 'bluetoothctl power on' or 'sudo rfkill unblock bluetooth'", RNS.LOG_ERROR) + RNS.log(f"{self} See troubleshooting: https://github.com/torlando-tech/ble-reticulum#bluetooth-adapter-not-powered", RNS.LOG_ERROR) + # Don't raise, just return - the discovery loop will retry + self.scanning = False + return + else: + # Re-raise other errors + raise # Get local adapter address if we don't have it yet (for connection direction preference) if self.local_address is None: