BLE

​

Syntax

lager ble COMMAND [OPTIONS]

​

Commands

​

Command Reference

​

scan

lager ble scan [OPTIONS]

• --box BOX - Lagerbox 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
• Address format is XX:XX:XX:XX:XX:XX (colon-separated hex)
• Scan timeout affects how long the box searches for devices
• Some devices may not advertise their name until connected