BLE

​

Syntax

lager ble COMMAND [OPTIONS]

​

Commands

​

Command Reference

​

scan

lager ble scan [OPTIONS]

• --box BOX - Lager Box name or IP address
• --timeout FLOAT - Scan duration in seconds (default: 5.0)
• --name-contains STRING - Filter devices by name (partial match)
• --name-exact STRING - Filter devices by exact name match
• --verbose - Include UUIDs in output

# Scan for 5 seconds (default)
lager ble scan --box my-lager-box

# Scan for 10 seconds
lager ble scan --timeout 10

# Filter by name
lager ble scan --name-contains "Sensor"

# Verbose output with UUIDs
lager ble scan --verbose

​

info

lager ble info ADDRESS [--box BOX]

• ADDRESS - BLE device address (e.g., AA:BB:CC:DD:EE:FF)

• Device name
• Services and characteristics
• Manufacturer data

​

connect

lager ble connect ADDRESS [--box BOX]

• ADDRESS - BLE device address to connect to

​

disconnect

lager ble disconnect ADDRESS [--box BOX]

• ADDRESS - BLE device address to disconnect from

​

Examples

# Scan for BLE devices
lager ble scan --box my-lager-box

# Scan with filtering
lager ble scan --name-contains "Nordic" --timeout 15

# Get device info
lager ble info AA:BB:CC:DD:EE:FF

# Connect to device
lager ble connect AA:BB:CC:DD:EE:FF

# Disconnect
lager ble disconnect AA:BB:CC:DD:EE:FF

​

Output Format

​

Scan Results

• Device address (MAC address format)
• Device name (if advertised)
• RSSI (signal strength in dBm)
• Manufacturer data (if available)

​

Device Info

• Complete device name
• All advertised services (UUIDs)
• Characteristics for each service
• Read/write/notify properties

​

Use Cases

​

Device Discovery

# Find all devices
lager ble scan --timeout 10

# Find specific device type
lager ble scan --name-contains "Heart Rate"

​

Automated Testing

# Verify device is discoverable
lager ble scan --name-exact "MyProduct" --timeout 5

# Connect and verify services
lager ble info AA:BB:CC:DD:EE:FF

​

Notes

• BLE scanning requires Bluetooth hardware on the box
• BLE uses BlueZ on the box host. lager install and lager update install it. If the box host does not have BlueZ, BLE commands fail with BlueZ is not running on the box host. To fix this, run lager update for the box, or run sudo apt install -y bluez && sudo systemctl enable --now bluetooth on the box
• Address format is XX:XX:XX:XX:XX:XX (colon-separated hex)
• Scan timeout affects how long the box searches for devices
• Some devices do not advertise their name until they connect