bledis - Test BLE Discovery

Establishes a BLE connection to the DUT and discovers GATT services.

Usage:

- command: bledis %BLEMAC%|<name> [<timeout> [<minRSSI>]]
  [retry: <retryCount>]

Argument

Description

name

GAP name advertised by the DUT, or its BLE MAC address (XX:XX:XX:XX:XX:XX). %BLEMAC% substitutes a previously-captured MAC address user key.

timeout

Discovery/connect timeout, in seconds (default: 5s).

minRSSI

Minimum RSSI, in dBm, required to accept an advertisement (optional; default: no filtering).

retryCount

Number of times to retry the test step (optional)

The first argument is treated as a MAC address only if it is exactly 17 characters long and matches the XX:XX:XX:XX:XX:XX pattern (hex octets separated by colons); otherwise it is treated as a GAP device name. This makes %BLEMAC% and a literal MAC address interchangeable with a plain device name in the same argument position.

Examples

Note

Using the bledis command on a PLT-300A requires a supported BLE test dongle.

Note

bledis connects to the DUT and discovers its GATT services, then disconnects — it is a quick presence/discoverability check. Use ble gatt when the test plan needs to read, write, or match against specific characteristic values after connecting.