[PATCH BlueZ v1 02/15] doc/bluetoothctl-mgmt: Document arguments and add examples

[Luiz Augusto von Dentz <luiz.dentz@gmail.com>]

From: Luiz Augusto von Dentz <luiz.von.dentz@intel.com>

Add comprehensive parameter documentation for all management interface
commands including select, power, discov, class, name, pair, privacy,
scan-params, phy and other mgmt commands with detailed descriptions
of required vs optional parameters and acceptable values.
---
 doc/bluetoothctl-mgmt.rst | 738 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 733 insertions(+), 5 deletions(-)

diff --git a/doc/bluetoothctl-mgmt.rst b/doc/bluetoothctl-mgmt.rst
index cf252f3a5b87..ba7ed6f4f280 100644
--- a/doc/bluetoothctl-mgmt.rst
+++ b/doc/bluetoothctl-mgmt.rst
@@ -27,6 +27,13 @@ select
 Select a different index
 
 :Usage: **> select <index>**
+:<index>: Controller index number (0-based) to select
+:Example Select controller index 0 (hci0):
+	| **> select 0**
+:Example Select controller index 1 (hci1):
+	| **> select 1**
+:Example Select controller index 2 (hci2):
+	| **> select 2**
 
 revision
 --------
@@ -34,6 +41,8 @@ revision
 Get the MGMT Revision
 
 :Usage: **> revision**
+:Example Display MGMT API revision information:
+	| **> revision**
 
 commands
 --------
@@ -41,6 +50,8 @@ commands
 List supported commands
 
 :Usage: **> commands**
+:Example List all supported management commands:
+	| **> commands**
 
 config
 ------
@@ -48,6 +59,8 @@ config
 Show configuration info
 
 :Usage: **> config**
+:Example Show current controller configuration:
+	| **> config**
 
 info
 ----
@@ -55,6 +68,8 @@ info
 Show controller info
 
 :Usage: **> info**
+:Example Show detailed controller information:
+	| **> info**
 
 extinfo
 -------
@@ -62,6 +77,8 @@ extinfo
 Show extended controller info
 
 :Usage: **> extinfo**
+:Example Show extended controller information:
+	| **> extinfo**
 
 auto-power
 ----------
@@ -69,6 +86,8 @@ auto-power
 Power all available features
 
 :Usage: **> auto-power**
+:Example Automatically power on all available controller features:
+	| **> auto-power**
 
 power
 -----
@@ -76,6 +95,11 @@ power
 Toggle powered state
 
 :Usage: **> power <on/off>**
+:<on/off>: Power state - "on" to enable controller, "off" to disable
+:Example Power on the controller:
+	| **> power on**
+:Example Power off the controller:
+	| **> power off**
 
 discov
 ------
@@ -83,6 +107,22 @@ discov
 Toggle discoverable state
 
 :Usage: **> discov <yes/no/limited> [timeout]**
+:<yes/no/limited>: Discoverable mode - "yes" for general, "no" to disable, "limited" for limited discoverable
+:[timeout]: Optional timeout in seconds for discoverable mode duration
+:Example Make controller discoverable indefinitely:
+	| **> discov yes**
+:Example Make controller non-discoverable:
+	| **> discov no**
+:Example Enable limited discoverable mode:
+	| **> discov limited**
+:Example Make discoverable for 30 seconds:
+	| **> discov yes 30**
+:Example Make discoverable for 2 minutes:
+	| **> discov yes 120**
+:Example Make discoverable for 5 minutes:
+	| **> discov yes 300**
+:Example Limited discoverable for 60 seconds:
+	| **> discov limited 60**
 
 connectable
 -----------
@@ -90,6 +130,11 @@ connectable
 Toggle connectable state
 
 :Usage: **> connectable <on/off>**
+:<on/off>: Connectable state - "on" to allow connections, "off" to reject
+:Example Make controller connectable:
+	| **> connectable on**
+:Example Make controller non-connectable:
+	| **> connectable off**
 
 fast-conn
 ---------
@@ -97,6 +142,11 @@ fast-conn
 Toggle fast connectable state
 
 :Usage: **> fast-conn <on/off>**
+:<on/off>: Fast connectable state - "on" to enable fast connection mode, "off" to disable
+:Example Enable fast connectable mode:
+	| **> fast-conn on**
+:Example Disable fast connectable mode:
+	| **> fast-conn off**
 
 bondable
 --------
@@ -104,6 +154,11 @@ bondable
 Toggle bondable state
 
 :Usage: **> bondable <on/off>**
+:<on/off>: Bondable state - "on" to enable bonding capability, "off" to disable
+:Example Enable bonding capability:
+	| **> bondable on**
+:Example Disable bonding capability:
+	| **> bondable off**
 
 pairable
 --------
@@ -111,6 +166,11 @@ pairable
 Toggle bondable state
 
 :Usage: **> pairable <on/off>**
+:<on/off>: Pairable state - "on" to enable pairing capability, "off" to disable
+:Example Enable pairing capability:
+	| **> pairable on**
+:Example Disable pairing capability:
+	| **> pairable off**
 
 linksec
 -------
@@ -118,13 +178,23 @@ linksec
 Toggle link level security
 
 :Usage: **> linksec <on/off>**
+:<on/off>: Link level security - "on" to enable, "off" to disable
+:Example Enable link level security:
+	| **> linksec on**
+:Example Disable link level security:
+	| **> linksec off**
 
 ssp
 ---
 
 Toggle SSP mode
 
-:Usage: **> spp <on/off>**
+:Usage: **> ssp <on/off>**
+:<on/off>: Secure Simple Pairing mode - "on" to enable SSP, "off" to disable
+:Example Enable Secure Simple Pairing:
+	| **> ssp on**
+:Example Disable Secure Simple Pairing:
+	| **> ssp off**
 
 sc
 --
@@ -132,6 +202,13 @@ sc
 Toggle SC support
 
 :Usage: **> sc <on/off/only>**
+:<on/off/only>: Secure Connections support - "on" to enable, "off" to disable, "only" for exclusive use
+:Example Enable Secure Connections support:
+	| **> sc on**
+:Example Disable Secure Connections support:
+	| **> sc off**
+:Example Use Secure Connections exclusively:
+	| **> sc only**
 
 hs
 --
@@ -139,6 +216,11 @@ hs
 Toggle HS support
 
 :Usage: **> hs <on/off>**
+:<on/off>: High Speed support - "on" to enable 802.11 High Speed, "off" to disable
+:Example Enable High Speed support:
+	| **> hs on**
+:Example Disable High Speed support:
+	| **> hs off**
 
 le
 --
@@ -146,13 +228,23 @@ le
 Toggle LE support
 
 :Usage: **> le <on/off>**
+:<on/off>: Low Energy support - "on" to enable LE functionality, "off" to disable
+:Example Enable Low Energy support:
+	| **> le on**
+:Example Disable Low Energy support:
+	| **> le off**
 
 advertising
 -----------
 
 Toggle LE advertising
 
-:Usage: **> advertise <on/off>**
+:Usage: **> advertising <on/off>**
+:<on/off>: LE advertising state - "on" to enable advertising, "off" to disable
+:Example Enable LE advertising:
+	| **> advertising on**
+:Example Disable LE advertising:
+	| **> advertising off**
 
 bredr
 -----
@@ -160,6 +252,11 @@ bredr
 Toggle BR/EDR support
 
 :Usage: **> bredr <on/off>**
+:<on/off>: BR/EDR support - "on" to enable Classic Bluetooth, "off" to disable
+:Example Enable BR/EDR (Classic Bluetooth) support:
+	| **> bredr on**
+:Example Disable BR/EDR support:
+	| **> bredr off**
 
 privacy
 -------
@@ -167,6 +264,16 @@ privacy
 Toggle privacy support
 
 :Usage: **> privacy <on/off> [irk]**
+:<on/off>: Privacy support - "on" to enable privacy features, "off" to disable
+:[irk]: Optional 32-character hexadecimal Identity Resolving Key
+:Example Enable privacy with auto-generated IRK:
+	| **> privacy on**
+:Example Disable privacy:
+	| **> privacy off**
+:Example Enable privacy with specific IRK:
+	| **> privacy on 0123456789abcdef0123456789abcdef**
+:Example Enable privacy with different IRK:
+	| **> privacy on 1234567890abcdef1234567890abcdef**
 
 class
 -----
@@ -174,6 +281,30 @@ class
 Set device major/minor class
 
 :Usage: **> class <major> <minor>**
+:<major>: Major device class code (hexadecimal)
+:<minor>: Minor device class code (hexadecimal)
+:Example Set class to Audio/Video - Wearable Headset:
+	| **> class 0x04 0x01**
+:Example Set class to Audio/Video - Hands-free:
+	| **> class 0x04 0x02**
+:Example Set class to Audio/Video - Headphones:
+	| **> class 0x04 0x06**
+:Example Set class to Audio/Video - VCR:
+	| **> class 0x04 0x0B**
+:Example Set class to Computer - Desktop workstation:
+	| **> class 0x01 0x01**
+:Example Set class to Computer - Server:
+	| **> class 0x01 0x02**
+:Example Set class to Computer - Laptop:
+	| **> class 0x01 0x03**
+:Example Set class to Computer - Handheld PC/PDA:
+	| **> class 0x01 0x04**
+:Example Set class to Phone - Cellular:
+	| **> class 0x02 0x01**
+:Example Set class to Phone - Cordless:
+	| **> class 0x02 0x02**
+:Example Set class to Phone - Smart phone:
+	| **> class 0x02 0x03**
 
 disconnect
 ----------
@@ -181,6 +312,20 @@ disconnect
 Disconnect device
 
 :Usage: **> disconnect [-t type] <remote address>**
+:[-t type]: Optional address type (public, random, le_public, le_random)
+:<remote address>: Bluetooth address of device to disconnect
+:Example Disconnect device using public address:
+	| **> disconnect 00:11:22:33:44:55**
+:Example Disconnect another device:
+	| **> disconnect AA:BB:CC:DD:EE:FF**
+:Example Disconnect device with public address type:
+	| **> disconnect -t public 00:11:22:33:44:55**
+:Example Disconnect device with random address type:
+	| **> disconnect -t random AA:BB:CC:DD:EE:FF**
+:Example Disconnect LE device with public address:
+	| **> disconnect -t le_public 11:22:33:44:55:66**
+:Example Disconnect LE device with random address:
+	| **> disconnect -t le_random CC:DD:EE:FF:00:11**
 
 con
 ---
@@ -188,6 +333,8 @@ con
 List connections
 
 :Usage: **> con**
+:Example List all active connections:
+	| **> con**
 
 find
 ----
@@ -195,6 +342,20 @@ find
 Discover nearby devices
 
 :Usage: **> find [-l|-b] [-L]**
+:[-l|-b]: Discovery type - "-l" for LE only, "-b" for BR/EDR only (default: both)
+:[-L]: Limited discovery mode flag
+:Example Discover both LE and BR/EDR devices:
+	| **> find**
+:Example Discover LE devices only:
+	| **> find -l**
+:Example Discover BR/EDR devices only:
+	| **> find -b**
+:Example Discover devices in limited mode:
+	| **> find -L**
+:Example Discover LE devices in limited mode:
+	| **> find -l -L**
+:Example Discover BR/EDR devices in limited mode:
+	| **> find -b -L**
 
 find-service
 ------------
@@ -202,6 +363,27 @@ find-service
 Discover nearby service
 
 :Usage: **> find-service [-u UUID] [-r RSSI_Threshold] [-l|-b]**
+:[-u UUID]: Service UUID to search for (16-bit, 32-bit, or 128-bit)
+:[-r RSSI_Threshold]: Minimum RSSI value in dBm for device filtering
+:[-l|-b]: Discovery type - "-l" for LE only, "-b" for BR/EDR only
+:Example Find devices with Generic Access service:
+	| **> find-service -u 0x1800**
+:Example Find devices with Battery Service:
+	| **> find-service -u 0x180F**
+:Example Find devices with custom service:
+	| **> find-service -u 12345678-1234-5678-9abc-123456789abc**
+:Example Find devices with RSSI ≥ -60 dBm:
+	| **> find-service -r -60**
+:Example Find devices with RSSI ≥ -80 dBm:
+	| **> find-service -r -80**
+:Example Find Battery Service devices with RSSI ≥ -70 dBm:
+	| **> find-service -u 0x180F -r -70**
+:Example Find Generic Access on LE devices with strong signal:
+	| **> find-service -u 0x1800 -r -50 -l**
+:Example Find Serial Port Profile on BR/EDR devices:
+	| **> find-service -u 0x1101 -b**
+:Example Find Battery Service on LE devices:
+	| **> find-service -u 0x180F -l**
 
 stop-find
 ---------
@@ -209,6 +391,13 @@ stop-find
 Stop discovery
 
 :Usage: **> stop-find [-l|-b]**
+:[-l|-b]: Discovery type to stop - "-l" for LE only, "-b" for BR/EDR only (default: all)
+:Example Stop all discovery:
+	| **> stop-find**
+:Example Stop LE discovery only:
+	| **> stop-find -l**
+:Example Stop BR/EDR discovery only:
+	| **> stop-find -b**
 
 name
 ----
@@ -216,6 +405,20 @@ name
 Set local name
 
 :Usage: **> name <name> [shortname]**
+:<name>: Complete local name for the controller
+:[shortname]: Optional shortened local name
+:Example Set complete local name:
+	| **> name "My Bluetooth Device"**
+:Example Set name without spaces:
+	| **> name MyComputer**
+:Example Set name with hyphens:
+	| **> name "Home-Office-PC"**
+:Example Set both complete and shortened names:
+	| **> name "My Long Device Name" MyDevice**
+:Example Set descriptive and short names:
+	| **> name "Professional Workstation" ProWork**
+:Example Set audio device names:
+	| **> name "Bluetooth Audio Headset" BT-Audio**
 
 pair
 ----
@@ -223,6 +426,35 @@ pair
 Pair with a remote device
 
 :Usage: **> pair [-c cap] [-t type] <remote address>**
+:[-c cap]: IO capability (DisplayOnly, DisplayYesNo, KeyboardOnly, NoInputNoOutput, KeyboardDisplay)
+:[-t type]: Address type (public, random, le_public, le_random)
+:<remote address>: Bluetooth address of device to pair with
+:Example Pair with device using default settings:
+	| **> pair 00:11:22:33:44:55**
+:Example Pair with another device:
+	| **> pair AA:BB:CC:DD:EE:FF**
+:Example Pair with display-only IO capability:
+	| **> pair -c DisplayOnly 00:11:22:33:44:55**
+:Example Pair with display and yes/no capability:
+	| **> pair -c DisplayYesNo AA:BB:CC:DD:EE:FF**
+:Example Pair with keyboard-only capability:
+	| **> pair -c KeyboardOnly 11:22:33:44:55:66**
+:Example Pair with no I/O capability:
+	| **> pair -c NoInputNoOutput CC:DD:EE:FF:00:11**
+:Example Pair with keyboard and display capability:
+	| **> pair -c KeyboardDisplay 22:33:44:55:66:77**
+:Example Pair with public address device:
+	| **> pair -t public 00:11:22:33:44:55**
+:Example Pair with random address device:
+	| **> pair -t random AA:BB:CC:DD:EE:FF**
+:Example Pair with LE public address device:
+	| **> pair -t le_public 11:22:33:44:55:66**
+:Example Pair with LE random address device:
+	| **> pair -t le_random CC:DD:EE:FF:00:11**
+:Example Pair LE device with keyboard/display capability:
+	| **> pair -c KeyboardDisplay -t le_public 00:11:22:33:44:55**
+:Example Pair random address device with display/yes-no capability:
+	| **> pair -c DisplayYesNo -t random AA:BB:CC:DD:EE:FF**
 
 cancelpair
 ----------
@@ -230,6 +462,16 @@ cancelpair
 Cancel pairing
 
 :Usage: **> cancelpair [-t type] <remote address>**
+:[-t type]: Address type (public, random, le_public, le_random)
+:<remote address>: Bluetooth address of device to cancel pairing with
+:Example Cancel ongoing pairing with device:
+	| **> cancelpair 00:11:22:33:44:55**
+:Example Cancel pairing with another device:
+	| **> cancelpair AA:BB:CC:DD:EE:FF**
+:Example Cancel pairing with public address device:
+	| **> cancelpair -t public 00:11:22:33:44:55**
+:Example Cancel pairing with LE random address device:
+	| **> cancelpair -t le_random AA:BB:CC:DD:EE:FF**
 
 unpair
 ------
@@ -237,13 +479,27 @@ unpair
 Unpair device
 
 :Usage: **> unpair [-t type] <remote address>**
+:[-t type]: Address type (public, random, le_public, le_random)
+:<remote address>: Bluetooth address of device to unpair
+:Example Remove pairing with device:
+	| **> unpair 00:11:22:33:44:55**
+:Example Remove pairing with another device:
+	| **> unpair AA:BB:CC:DD:EE:FF**
+:Example Unpair public address device:
+	| **> unpair -t public 00:11:22:33:44:55**
+:Example Unpair LE public address device:
+	| **> unpair -t le_public 11:22:33:44:55:66**
+:Example Unpair LE random address device:
+	| **> unpair -t le_random CC:DD:EE:FF:00:11**
 
 keys
 ----
 
 Load Link Keys
 
-:Usage: **keys**
+:Usage: **> keys**
+:Example Load stored link keys:
+	| **> keys**
 
 ltks
 ----
@@ -251,6 +507,8 @@ ltks
 Load Long Term Keys
 
 :Usage: **> ltks**
+:Example Load stored LE long term keys:
+	| **> ltks**
 
 irks
 ----
@@ -258,6 +516,20 @@ irks
 Load Identity Resolving Keys
 
 :Usage: **> irks [--local index] [--file file path]**
+:[--local index]: Local controller index to use
+:[--file file path]: Custom IRK configuration file path
+:Example Load IRKs with default local index and file:
+	| **> irks**
+:Example Load IRKs for controller index 0:
+	| **> irks --local 0**
+:Example Load IRKs for controller index 1:
+	| **> irks --local 1**
+:Example Load IRKs from custom configuration file:
+	| **> irks --file /etc/bluetooth/irks.conf**
+:Example Load IRKs from user file:
+	| **> irks --file /home/user/bluetooth_irks.txt**
+:Example Load IRKs for hci0 from specific file:
+	| **> irks --local 0 --file /etc/bluetooth/hci0_irks.conf**
 
 block
 -----
@@ -265,6 +537,20 @@ block
 Block Device
 
 :Usage: **> block [-t type] <remote address>**
+:[-t type]: Address type (public, random, le_public, le_random)
+:<remote address>: Bluetooth address of device to block
+:Example Block device using default address type:
+	| **> block 00:11:22:33:44:55**
+:Example Block another device:
+	| **> block AA:BB:CC:DD:EE:FF**
+:Example Block device with public address:
+	| **> block -t public 00:11:22:33:44:55**
+:Example Block device with random address:
+	| **> block -t random AA:BB:CC:DD:EE:FF**
+:Example Block LE device with public address:
+	| **> block -t le_public 11:22:33:44:55:66**
+:Example Block LE device with random address:
+	| **> block -t le_random CC:DD:EE:FF:00:11**
 
 unblock
 -------
@@ -272,6 +558,20 @@ unblock
 Unblock Device
 
 :Usage: **> unblock [-t type] <remote address>**
+:[-t type]: Address type (public, random, le_public, le_random)
+:<remote address>: Bluetooth address of device to unblock
+:Example Unblock device using default address type:
+	| **> unblock 00:11:22:33:44:55**
+:Example Unblock another device:
+	| **> unblock AA:BB:CC:DD:EE:FF**
+:Example Unblock device with public address:
+	| **> unblock -t public 00:11:22:33:44:55**
+:Example Unblock device with random address:
+	| **> unblock -t random AA:BB:CC:DD:EE:FF**
+:Example Unblock LE device with public address:
+	| **> unblock -t le_public 11:22:33:44:55:66**
+:Example Unblock LE device with random address:
+	| **> unblock -t le_random CC:DD:EE:FF:00:11**
 
 add-uuid
 --------
@@ -279,6 +579,22 @@ add-uuid
 Add UUID
 
 :Usage: **> add-uuid <UUID> <service class hint>**
+:<UUID>: Service UUID (16-bit, 32-bit, or 128-bit format)
+:<service class hint>: Service class hint bitmask (hexadecimal)
+:Example Add Serial Port Profile with object transfer hint:
+	| **> add-uuid 0x1101 0x100000**
+:Example Add A2DP with audio hint:
+	| **> add-uuid 0x110E 0x200000**
+:Example Add HFP with audio hint:
+	| **> add-uuid 0x111E 0x200000**
+:Example Add custom service UUID with no hint:
+	| **> add-uuid 12345678-1234-5678-9abc-123456789abc 0x000000**
+:Example Add custom UUID with object transfer hint:
+	| **> add-uuid ABCD1234-ABCD-1234-ABCD-123456789ABC 0x100000**
+:Example Add Generic Access with no specific hint:
+	| **> add-uuid 0x1800 0x000000**
+:Example Add Battery Service with no hint:
+	| **> add-uuid 0x180F 0x000000**
 
 rm-uuid
 -------
@@ -286,13 +602,22 @@ rm-uuid
 Remove UUID
 
 :Usage: **> rm-uuid <UUID>**
+:<UUID>: Service UUID to remove (16-bit, 32-bit, or 128-bit format)
+:Example Remove Serial Port Profile UUID:
+	| **> rm-uuid 0x1101**
+:Example Remove A2DP UUID:
+	| **> rm-uuid 0x110E**
+:Example Remove custom service UUID:
+	| **> rm-uuid 12345678-1234-5678-9abc-123456789abc**
 
 clr-uuids
 ---------
 
 Clear UUIDs
 
-:Usage: **> clear-uuids**
+:Usage: **> clr-uuids**
+:Example Clear all registered UUIDs:
+	| **> clr-uuids**
 
 local-oob
 ---------
@@ -300,6 +625,8 @@ local-oob
 Local OOB data
 
 :Usage: **> local-oob**
+:Example Generate and display local OOB authentication data:
+	| **> local-oob**
 
 remote-oob
 ----------
@@ -308,6 +635,24 @@ Remote OOB data
 
 :Usage: **> remote-oob [-t <addr_type>] [-r <rand192>] [-h <hash192>]
 	[-R <rand256>] [-H <hash256>] <addr>**
+:[-t <addr_type>]: Address type (public, random, le_public, le_random)
+:[-r <rand192>]: P-192 random value (32 hexadecimal characters)
+:[-h <hash192>]: P-192 hash value (32 hexadecimal characters)
+:[-R <rand256>]: P-256 random value (64 hexadecimal characters)
+:[-H <hash256>]: P-256 hash value (64 hexadecimal characters)
+:<addr>: Remote device Bluetooth address
+:Example Set remote OOB data for device (minimal):
+	| **> remote-oob 00:11:22:33:44:55**
+:Example Set P-192 random and hash values:
+	| **> remote-oob -r 0123456789abcdef0123456789abcdef -h fedcba9876543210fedcba9876543210 00:11:22:33:44:55**
+:Example Set P-256 random and hash values:
+	| **> remote-oob -R 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef -H fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210 AA:BB:CC:DD:EE:FF**
+:Example Set OOB data for LE public address device:
+	| **> remote-oob -t le_public 11:22:33:44:55:66**
+:Example Set OOB data for LE random address device:
+	| **> remote-oob -t le_random CC:DD:EE:FF:00:11**
+:Example Set complete OOB data with both P-192 and P-256 values:
+	| **> remote-oob -t public -r 0123456789abcdef0123456789abcdef -h fedcba9876543210fedcba9876543210 -R 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef -H fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210 00:11:22:33:44:55**
 
 did
 ---
@@ -315,6 +660,19 @@ did
 Set Device ID
 
 :Usage: **> did <source>:<vendor>:<product>:<version>**
+:<source>:<vendor>:<product>:<version>: Device ID in format source:vendor:product:version (all hexadecimal)
+:Example Set USB source with Linux Foundation vendor ID:
+	| **> did 0x0002:0x1D6B:0x0001:0x0100**
+:Example Set USB device with Cypress vendor ID:
+	| **> did 0x0002:0x04B4:0x1234:0x0200**
+:Example Set Bluetooth SIG source with Broadcom vendor:
+	| **> did 0x0001:0x000F:0x0001:0x0100**
+:Example Set Bluetooth SIG source with Apple vendor:
+	| **> did 0x0001:0x004C:0x0001:0x0100**
+:Example Set custom USB device ID:
+	| **> did 0x0002:0xFFFF:0x1234:0x5678**
+:Example Set Qualcomm Bluetooth device:
+	| **> did 0x0001:0x05F1:0xABCD:0x0001**
 
 static-addr
 -----------
@@ -322,6 +680,13 @@ static-addr
 Set static address
 
 :Usage: **> static-addr <address>**
+:<address>: Static random Bluetooth address (must have bits 47-46 set to 11)
+:Example Set static random address (bit 47=1, bit 46=1):
+	| **> static-addr C0:00:00:00:00:01**
+:Example Set another static random address:
+	| **> static-addr D0:11:22:33:44:55**
+:Example Set different static address:
+	| **> static-addr E0:AA:BB:CC:DD:EE**
 
 public-addr
 -----------
@@ -329,6 +694,13 @@ public-addr
 Set public address
 
 :Usage: **> public-addr <address>**
+:<address>: Public Bluetooth address to set for the controller
+:Example Set public Bluetooth address:
+	| **> public-addr 00:11:22:33:44:55**
+:Example Set different public address:
+	| **> public-addr AA:BB:CC:DD:EE:FF**
+:Example Set custom public address:
+	| **> public-addr 12:34:56:78:9A:BC**
 
 ext-config
 ----------
@@ -336,6 +708,11 @@ ext-config
 External configuration
 
 :Usage: **> ext-config <on/off>**
+:<on/off>: External configuration - "on" to enable external config, "off" to disable
+:Example Enable external configuration:
+	| **> ext-config on**
+:Example Disable external configuration:
+	| **> ext-config off**
 
 debug-keys
 ----------
@@ -343,6 +720,11 @@ debug-keys
 Toggle debug keys
 
 :Usage: **> debug-keys <on/off>**
+:<on/off>: Debug keys support - "on" to enable debug keys, "off" to disable
+:Example Enable debug key support:
+	| **> debug-keys on**
+:Example Disable debug key support:
+	| **> debug-keys off**
 
 conn-info
 ---------
@@ -350,6 +732,18 @@ conn-info
 Get connection information
 
 :Usage: **> conn-info [-t type] <remote address>**
+:[-t type]: Address type (public, random, le_public, le_random)
+:<remote address>: Bluetooth address of connected device
+:Example Get connection information for device:
+	| **> conn-info 00:11:22:33:44:55**
+:Example Get info for another device:
+	| **> conn-info AA:BB:CC:DD:EE:FF**
+:Example Get info for public address device:
+	| **> conn-info -t public 00:11:22:33:44:55**
+:Example Get info for LE public address device:
+	| **> conn-info -t le_public 11:22:33:44:55:66**
+:Example Get info for LE random address device:
+	| **> conn-info -t le_random CC:DD:EE:FF:00:11**
 
 io-cap
 ------
@@ -357,6 +751,17 @@ io-cap
 Set IO Capability
 
 :Usage: **> io-cap <cap>**
+:<cap>: IO capability (DisplayOnly, DisplayYesNo, KeyboardOnly, NoInputNoOutput, KeyboardDisplay)
+:Example Set IO capability to display only:
+	| **> io-cap DisplayOnly**
+:Example Set IO capability to display with yes/no:
+	| **> io-cap DisplayYesNo**
+:Example Set IO capability to keyboard only:
+	| **> io-cap KeyboardOnly**
+:Example Set IO capability to no input/output:
+	| **> io-cap NoInputNoOutput**
+:Example Set IO capability to keyboard and display:
+	| **> io-cap KeyboardDisplay**
 
 scan-params
 -----------
@@ -364,6 +769,20 @@ scan-params
 Set Scan Parameters
 
 :Usage: **> scan-params <interval> <window>**
+:<interval>: Scan interval in hexadecimal (0x0004 to 0x4000, units of 0.625ms)
+:<window>: Scan window in hexadecimal (0x0004 to 0x4000, units of 0.625ms)
+:Example Set fast scan (16ms interval, 16ms window):
+	| **> scan-params 0x0010 0x0010**
+:Example Set moderate fast scan (32ms interval, 32ms window):
+	| **> scan-params 0x0020 0x0020**
+:Example Set balanced scan (96ms interval, 48ms window):
+	| **> scan-params 0x0060 0x0030**
+:Example Set slow scan (256ms interval, 80ms window):
+	| **> scan-params 0x0100 0x0050**
+:Example Set background scan (2.56s interval, 18ms window):
+	| **> scan-params 0x0800 0x0012**
+:Example Set very slow background scan:
+	| **> scan-params 0x1000 0x0020**
 
 get-clock
 ---------
@@ -371,6 +790,13 @@ get-clock
 Get Clock Information
 
 :Usage: **> get-clock [address]**
+:[address]: Optional remote device Bluetooth address (omit for local clock)
+:Example Get local Bluetooth clock information:
+	| **> get-clock**
+:Example Get clock information for remote device:
+	| **> get-clock 00:11:22:33:44:55**
+:Example Get clock for another remote device:
+	| **> get-clock AA:BB:CC:DD:EE:FF**
 
 add-device
 ----------
@@ -378,6 +804,33 @@ add-device
 Add Device
 
 :Usage: **> add-device [-a action] [-t type] <address>**
+:[-a action]: Device action (auto, allow, deny) - "auto" for auto-connect, "allow" for allow-only, "deny" to block
+:[-t type]: Address type (public, random, le_public, le_random)
+:<address>: Bluetooth address of device to add
+:Example Add device with auto-connect action and default type:
+	| **> add-device 00:11:22:33:44:55**
+:Example Add another device with defaults:
+	| **> add-device AA:BB:CC:DD:EE:FF**
+:Example Add device with auto-connect action:
+	| **> add-device -a auto 00:11:22:33:44:55**
+:Example Add device with allow-only action (no auto-connect):
+	| **> add-device -a allow 11:22:33:44:55:66**
+:Example Add device with deny action (blocked):
+	| **> add-device -a deny CC:DD:EE:FF:00:11**
+:Example Add device with public address type:
+	| **> add-device -t public 00:11:22:33:44:55**
+:Example Add device with random address type:
+	| **> add-device -t random AA:BB:CC:DD:EE:FF**
+:Example Add LE device with public address:
+	| **> add-device -t le_public 11:22:33:44:55:66**
+:Example Add LE device with random address:
+	| **> add-device -t le_random CC:DD:EE:FF:00:11**
+:Example Add LE public device with auto-connect:
+	| **> add-device -a auto -t le_public 00:11:22:33:44:55**
+:Example Add random address device with allow action:
+	| **> add-device -a allow -t random AA:BB:CC:DD:EE:FF**
+:Example Add LE random device with deny action:
+	| **> add-device -a deny -t le_random CC:DD:EE:FF:00:11**
 
 del-device
 ----------
@@ -385,6 +838,20 @@ del-device
 Remove Device
 
 :Usage: **> del-device [-t type] <address>**
+:[-t type]: Address type (public, random, le_public, le_random)
+:<address>: Bluetooth address of device to remove
+:Example Remove device using default address type:
+	| **> del-device 00:11:22:33:44:55**
+:Example Remove another device:
+	| **> del-device AA:BB:CC:DD:EE:FF**
+:Example Remove device with public address type:
+	| **> del-device -t public 00:11:22:33:44:55**
+:Example Remove device with random address type:
+	| **> del-device -t random AA:BB:CC:DD:EE:FF**
+:Example Remove LE device with public address:
+	| **> del-device -t le_public 11:22:33:44:55:66**
+:Example Remove LE device with random address:
+	| **> del-device -t le_random CC:DD:EE:FF:00:11**
 
 clr-devices
 -----------
@@ -392,6 +859,8 @@ clr-devices
 Clear Devices
 
 :Usage: **> clr-devices**
+:Example Clear all devices from the device list:
+	| **> clr-devices**
 
 bredr-oob
 ---------
@@ -399,6 +868,8 @@ bredr-oob
 Local OOB data (BR/EDR)
 
 :Usage: **> bredr-oob**
+:Example Generate and display local BR/EDR OOB authentication data:
+	| **> bredr-oob**
 
 le-oob
 ------
@@ -406,6 +877,8 @@ le-oob
 Local OOB data (LE)
 
 :Usage: **> le-oob**
+:Example Generate and display local LE OOB authentication data:
+	| **> le-oob**
 
 advinfo
 -------
@@ -413,6 +886,8 @@ advinfo
 Show advertising features
 
 :Usage: **> advinfo**
+:Example Display advertising capabilities and supported features:
+	| **> advinfo**
 
 advsize
 -------
@@ -420,6 +895,14 @@ advsize
 Show advertising size info
 
 :Usage: **> advsize [options] <instance_id>**
+:[options]: Advertising options flags
+:<instance_id>: Advertising instance identifier (0-based)
+:Example Show advertising data size information for instance 0:
+	| **> advsize 0**
+:Example Show size information for advertising instance 1:
+	| **> advsize 1**
+:Example Show size information for advertising instance 5:
+	| **> advsize 5**
 
 add-adv
 -------
@@ -427,6 +910,32 @@ add-adv
 Add advertising instance
 
 :Usage: **> add-adv [options] <instance_id>**
+:[options]: Advertising options (-c connectable, -s scannable, -g general discoverable, -l limited discoverable, -m managed flags, -p TX power)
+:<instance_id>: Advertising instance identifier (0-based)
+:Example Add advertising instance 0 with default settings:
+	| **> add-adv 0**
+:Example Add advertising instance 1:
+	| **> add-adv 1**
+:Example Add advertising instance 5:
+	| **> add-adv 5**
+:Example Add connectable advertising instance 0:
+	| **> add-adv -c 0**
+:Example Add scannable advertising instance 1:
+	| **> add-adv -s 1**
+:Example Add general discoverable advertising instance 2:
+	| **> add-adv -g 2**
+:Example Add limited discoverable advertising instance 3:
+	| **> add-adv -l 3**
+:Example Add managed flags advertising instance 4:
+	| **> add-adv -m 4**
+:Example Add TX power advertising instance 5:
+	| **> add-adv -p 5**
+:Example Add connectable and scannable advertising instance:
+	| **> add-adv -c -s 0**
+:Example Add general discoverable with TX power:
+	| **> add-adv -g -p 1**
+:Example Add connectable, general discoverable, and scannable:
+	| **> add-adv -c -g -s 2**
 
 rm-adv
 ------
@@ -434,6 +943,13 @@ rm-adv
 Remove advertising instance
 
 :Usage: **> rm-adv <instance_id>**
+:<instance_id>: Advertising instance identifier (0-based) to remove
+:Example Remove advertising instance 0:
+	| **> rm-adv 0**
+:Example Remove advertising instance 1:
+	| **> rm-adv 1**
+:Example Remove advertising instance 5:
+	| **> rm-adv 5**
 
 clr-adv
 -------
@@ -441,13 +957,41 @@ clr-adv
 Clear advertising instances
 
 :Usage: **> clr-adv**
+:Example Clear all advertising instances:
+	| **> clr-adv**
 
 add-ext-adv-params
 ------------------
 
 Add extended advertising params
 
-:Usage: **> add-ext-adv-parms [options] <instance_id>**
+:Usage: **> add-ext-adv-params [options] <instance_id>**
+:[options]: Extended advertising options (-c connectable, -s scannable, -d directed, -h high duty cycle, -l legacy PDU, -a anonymous, -i include TX power)
+:<instance_id>: Extended advertising instance identifier (0-based)
+:Example Add extended advertising parameters for instance 0:
+	| **> add-ext-adv-params 0**
+:Example Add extended advertising parameters for instance 1:
+	| **> add-ext-adv-params 1**
+:Example Add connectable extended advertising for instance 0:
+	| **> add-ext-adv-params -c 0**
+:Example Add scannable extended advertising for instance 1:
+	| **> add-ext-adv-params -s 1**
+:Example Add directed extended advertising for instance 2:
+	| **> add-ext-adv-params -d 2**
+:Example Add high duty cycle extended advertising for instance 3:
+	| **> add-ext-adv-params -h 3**
+:Example Add legacy PDU extended advertising for instance 4:
+	| **> add-ext-adv-params -l 4**
+:Example Add anonymous extended advertising for instance 5:
+	| **> add-ext-adv-params -a 5**
+:Example Add include TX power extended advertising for instance 6:
+	| **> add-ext-adv-params -i 6**
+:Example Add connectable and scannable extended advertising:
+	| **> add-ext-adv-params -c -s 0**
+:Example Add connectable extended advertising with TX power:
+	| **> add-ext-adv-params -c -i 1**
+:Example Add scannable legacy PDU extended advertising:
+	| **> add-ext-adv-params -s -l 2**
 
 add-ext-adv-data
 ----------------
@@ -455,6 +999,20 @@ add-ext-adv-data
 Add extended advertising data
 
 :Usage: **> add-ext-adv-data [options] <instance_id>**
+:[options]: Data options (-s for scan response data, -c for complete data)
+:<instance_id>: Extended advertising instance identifier (0-based)
+:Example Add advertising data to extended instance 0:
+	| **> add-ext-adv-data 0**
+:Example Add advertising data to extended instance 1:
+	| **> add-ext-adv-data 1**
+:Example Add scan response data to extended instance 0:
+	| **> add-ext-adv-data -s 0**
+:Example Add scan response data to extended instance 1:
+	| **> add-ext-adv-data -s 1**
+:Example Add complete advertising data to instance 0:
+	| **> add-ext-adv-data -c 0**
+:Example Add complete scan response data to instance 1:
+	| **> add-ext-adv-data -c -s 1**
 
 appearance
 ----------
@@ -462,6 +1020,43 @@ appearance
 Set appearance
 
 :Usage: **> appearance <appearance>**
+:<appearance>: Appearance value (16-bit integer) representing device type
+:Example Set appearance to Unknown:
+	| **> appearance 0**
+:Example Set appearance to Generic Phone:
+	| **> appearance 64**
+:Example Set appearance to Generic Computer:
+	| **> appearance 128**
+:Example Set appearance to Generic Audio/Video device:
+	| **> appearance 832**
+:Example Set appearance to Speaker:
+	| **> appearance 833**
+:Example Set appearance to Microphone:
+	| **> appearance 834**
+:Example Set appearance to Headset:
+	| **> appearance 835**
+:Example Set appearance to Headphones:
+	| **> appearance 836**
+:Example Set appearance to Generic HID:
+	| **> appearance 960**
+:Example Set appearance to Keyboard:
+	| **> appearance 961**
+:Example Set appearance to Mouse:
+	| **> appearance 962**
+:Example Set appearance to Joystick:
+	| **> appearance 963**
+:Example Set appearance to Generic Health Sensor:
+	| **> appearance 1344**
+:Example Set appearance to Heart Rate Sensor:
+	| **> appearance 1345**
+:Example Set appearance to Blood Pressure Monitor:
+	| **> appearance 1346**
+:Example Set appearance to Generic Sports and Fitness:
+	| **> appearance 1472**
+:Example Set appearance to Location Display:
+	| **> appearance 1473**
+:Example Set appearance to Location Navigation Display:
+	| **> appearance 1474**
 
 phy
 ---
@@ -471,6 +1066,45 @@ Get/Set PHY Configuration
 :Usage: **> phy [LE1MTX] [LE1MRX] [LE2MTX] [LE2MRX] [LECODEDTX] [LECODEDRX]
 	[BR1M1SLOT] [BR1M3SLOT] [BR1M5SLOT][EDR2M1SLOT] [EDR2M3SLOT]
 	[EDR2M5SLOT][EDR3M1SLOT] [EDR3M3SLOT] [EDR3M5SLOT]**
+:[PHY flags]: PHY configuration flags to enable (LE1MTX, LE1MRX, LE2MTX, LE2MRX, LECODEDTX, LECODEDRX, BR1M1SLOT, etc.)
+:Example Display current PHY configuration:
+	| **> phy**
+:Example Enable LE 1M TX PHY:
+	| **> phy LE1MTX**
+:Example Enable LE 1M RX PHY:
+	| **> phy LE1MRX**
+:Example Enable LE 2M TX PHY:
+	| **> phy LE2MTX**
+:Example Enable LE 2M RX PHY:
+	| **> phy LE2MRX**
+:Example Enable LE Coded TX PHY:
+	| **> phy LECODEDTX**
+:Example Enable LE Coded RX PHY:
+	| **> phy LECODEDRX**
+:Example Enable BR 1M 1-slot packets:
+	| **> phy BR1M1SLOT**
+:Example Enable BR 1M 3-slot packets:
+	| **> phy BR1M3SLOT**
+:Example Enable BR 1M 5-slot packets:
+	| **> phy BR1M5SLOT**
+:Example Enable EDR 2M 1-slot packets:
+	| **> phy EDR2M1SLOT**
+:Example Enable EDR 2M 3-slot packets:
+	| **> phy EDR2M3SLOT**
+:Example Enable EDR 2M 5-slot packets:
+	| **> phy EDR2M5SLOT**
+:Example Enable EDR 3M 1-slot packets:
+	| **> phy EDR3M1SLOT**
+:Example Enable EDR 3M 3-slot packets:
+	| **> phy EDR3M3SLOT**
+:Example Enable EDR 3M 5-slot packets:
+	| **> phy EDR3M5SLOT**
+:Example Enable LE 1M TX and RX PHYs:
+	| **> phy LE1MTX LE1MRX**
+:Example Enable LE 1M and 2M TX/RX PHYs:
+	| **> phy LE1MTX LE1MRX LE2MTX LE2MRX**
+:Example Enable 1-slot packets for all BR/EDR PHYs:
+	| **> phy BR1M1SLOT EDR2M1SLOT EDR3M1SLOT**
 
 wbs
 ---
@@ -478,6 +1112,11 @@ wbs
 Toggle Wideband-Speech support
 
 :Usage: **> wbs <on/off>**
+:<on/off>: Wideband Speech support - "on" to enable for audio profiles, "off" to disable
+:Example Enable Wideband Speech support for audio profiles:
+	| **> wbs on**
+:Example Disable Wideband Speech support:
+	| **> wbs off**
 
 secinfo
 -------
@@ -485,6 +1124,8 @@ secinfo
 Show security information
 
 :Usage: **> secinfo**
+:Example Display security features and capabilities:
+	| **> secinfo**
 
 expinfo
 -------
@@ -492,6 +1133,8 @@ expinfo
 Show experimental features
 
 :Usage: **> expinfo**
+:Example Display available experimental features and their status:
+	| **> expinfo**
 
 exp-debug
 ---------
@@ -499,6 +1142,11 @@ exp-debug
 Set debug feature
 
 :Usage: **> exp-debug <on/off>**
+:<on/off>: Experimental debug features - "on" to enable, "off" to disable
+:Example Enable experimental debug features:
+	| **> exp-debug on**
+:Example Disable experimental debug features:
+	| **> exp-debug off**
 
 exp-privacy
 -----------
@@ -506,6 +1154,11 @@ exp-privacy
 Set LL privacy feature
 
 :Usage: **> exp-privacy <on/off>**
+:<on/off>: Experimental Link Layer privacy - "on" to enable LL privacy features, "off" to disable
+:Example Enable experimental Link Layer privacy features:
+	| **> exp-privacy on**
+:Example Disable experimental Link Layer privacy features:
+	| **> exp-privacy off**
 
 exp-quality
 -----------
@@ -513,6 +1166,11 @@ exp-quality
 Set bluetooth quality report feature
 
 :Usage: **> exp-quality <on/off>**
+:<on/off>: Experimental quality reporting - "on" to enable Bluetooth quality reports, "off" to disable
+:Example Enable experimental Bluetooth quality reporting:
+	| **> exp-quality on**
+:Example Disable experimental Bluetooth quality reporting:
+	| **> exp-quality off**
 
 exp-offload
 -----------
@@ -520,6 +1178,11 @@ exp-offload
 Toggle codec support
 
 :Usage: **> exp-offload <on/off>**
+:<on/off>: Experimental codec offload - "on" to enable codec offload support, "off" to disable
+:Example Enable experimental codec offload support:
+	| **> exp-offload on**
+:Example Disable experimental codec offload support:
+	| **> exp-offload off**
 
 read-sysconfig
 --------------
@@ -527,6 +1190,8 @@ read-sysconfig
 Read System Configuration
 
 :Usage: **> read-sysconfig**
+:Example Read current system configuration parameters:
+	| **> read-sysconfig**
 
 set-sysconfig
 -------------
@@ -534,12 +1199,52 @@ set-sysconfig
 Set System Configuration
 
 :Usage: **> set-sysconfig <-v|-h> [options...]**
+:<-v|-h>: Verbose output or help flag
+:[options...]: System configuration options (--br-page-scan-type, --br-page-scan-interval, etc.)
+:Example Show help for system configuration options:
+	| **> set-sysconfig -h**
+:Example Set system configuration with verbose output:
+	| **> set-sysconfig -v**
+:Example Set BR/EDR page scan type with verbose output:
+	| **> set-sysconfig -v --br-page-scan-type=0**
+:Example Set BR/EDR page scan interval:
+	| **> set-sysconfig -v --br-page-scan-interval=0x800**
+:Example Set BR/EDR page scan window:
+	| **> set-sysconfig -v --br-page-scan-window=0x12**
+:Example Set BR/EDR inquiry scan type:
+	| **> set-sysconfig -v --br-inquiry-scan-type=0**
+:Example Set BR/EDR link supervision timeout:
+	| **> set-sysconfig -v --br-link-supervision-timeout=0x2000**
+:Example Set LE minimum connection interval:
+	| **> set-sysconfig -v --le-min-connection-interval=0x18**
+:Example Set LE maximum connection interval:
+	| **> set-sysconfig -v --le-max-connection-interval=0x28**
+:Example Set multiple BR/EDR scan parameters:
+	| **> set-sysconfig -v --br-page-scan-type=0 --br-page-scan-interval=0x800 --br-page-scan-window=0x12**
+:Example Set multiple LE connection parameters:
+	| **> set-sysconfig -v --le-min-connection-interval=0x18 --le-max-connection-interval=0x28 --le-connection-latency=0**
 
 get-flags
 ---------
 
 Get device flags
 
+:Usage: **> get-flags [-t type] <address>**
+:[-t type]: Address type (public, random, le_public, le_random)
+:<address>: Bluetooth address of device to query flags for
+:Example Get device flags for device using default type:
+	| **> get-flags 00:11:22:33:44:55**
+:Example Get flags for another device:
+	| **> get-flags AA:BB:CC:DD:EE:FF**
+:Example Get flags for public address device:
+	| **> get-flags -t public 00:11:22:33:44:55**
+:Example Get flags for random address device:
+	| **> get-flags -t random AA:BB:CC:DD:EE:FF**
+:Example Get flags for LE public address device:
+	| **> get-flags -t le_public 11:22:33:44:55:66**
+:Example Get flags for LE random address device:
+	| **> get-flags -t le_random CC:DD:EE:FF:00:11**
+
 
 set-flags
 ---------
@@ -547,6 +1252,29 @@ set-flags
 Set device flags
 
 :Usage: **> set-flags [-f flags] [-t type] <address>**
+:[-f flags]: Device flags bitmask in hexadecimal (0x01=remote wake, 0x02=privacy)
+:[-t type]: Address type (public, random, le_public, le_random)
+:<address>: Bluetooth address of device to set flags for
+:Example Set default flags for device:
+	| **> set-flags 00:11:22:33:44:55**
+:Example Set default flags for another device:
+	| **> set-flags AA:BB:CC:DD:EE:FF**
+:Example Set remote wake flag for device:
+	| **> set-flags -f 0x01 00:11:22:33:44:55**
+:Example Set device privacy flag:
+	| **> set-flags -f 0x02 AA:BB:CC:DD:EE:FF**
+:Example Set both remote wake and privacy flags:
+	| **> set-flags -f 0x03 11:22:33:44:55:66**
+:Example Set remote wake for public address device:
+	| **> set-flags -f 0x01 -t public 00:11:22:33:44:55**
+:Example Set privacy flag for LE public device:
+	| **> set-flags -f 0x02 -t le_public 11:22:33:44:55:66**
+:Example Set multiple flags for LE random device:
+	| **> set-flags -f 0x03 -t le_random CC:DD:EE:FF:00:11**
+:Example Clear all flags for device:
+	| **> set-flags -f 0x00 00:11:22:33:44:55**
+:Example Clear all flags for LE public device:
+	| **> set-flags -f 0x00 -t le_public 11:22:33:44:55:66**
 
 RESOURCES
 =========
-- 
2.52.0