bluetoothctl-advertise(1) Linux System Administration (NAME) bluetoothctl-advertise - LE (SYNOPSIS) bluetoothctl [--options] [advertise.commands] LE org.bluez.LEAdvertisement(5) org.bluez.LEAdvertisingManager(5) . (Advertise Options Commands) uuids / UUID . (Usage) > uuids [uuid1 uuid2 ...] (Uses) ServiceUUIDs org.bluez.LEAdvertisement(5) [uuid1 uuid2 ...] UUID (: ) UUID > uuids UUID 16-bit > uuids 0x1234 UUID 32-bit > uuids 0x12345678 UUID 128-bit > uuids 90f95193-35de-4306-a6e9-699328f15059 Battery Generic Attribute > uuids 0x180F 0x1801 Device Information Battery HID > uuids 0x180A 0x180F 0x1812 Generic Access > uuids 0x1800 Environmental Sensing > uuids 0x181A Pulse Oximeter > uuids 0x183B UUID > uuids 0x180F 12345678-1234-5678-9abc-123456789abc solicit / UUID (solicit) . (Usage) > solicit [uuid1 uuid2 ...] (Uses) SolicitUUIDs org.bluez.LEAdvertisement(5) [uuid1 uuid2 ...] UUID (: ) UUID > solicit Generic Access > solicit 0x1800 Device Information > solicit 0x180A User Data > solicit 0x181C Battery Generic Attribute > solicit 0x180F 0x1801 Device Info Environmental Sensing Pulse Oximeter > solicit 0x180A 0x181A 0x183B service / . (Usage) > service [uuid] [data=xx xx ...] (Uses) ServiceData org.bluez.LEAdvertisement(5) [uuid] UUID [data=xx xx ...] > service 100 (0x64) > service 0x180F 64 50 (0x32) > service 0x180F 32 0 (0x00) > service 0x180F 00 ( ) > service 0x181A 20 15 C8 07 > service 0x180A 01 02 03 04 UUID 128-bit > service 12345678-1234-5678-9abc-123456789abc FF EE DD CC manufacturer / . (real time) . "Too much data" . (payload) bluetoothd "Failed to register advertisement" . (Usage) > manufacturer [id] [data=xx xx ...] (Uses) ManufacturerData org.bluez.LEAdvertisement(5) [id] (: 0x004C Apple Inc.) [data=xx xx ...] > manufacturer Apple Inc. > manufacturer 0x004C 01 02 03 04 Apple > manufacturer 0x004C FF FE FD FC FB FA F9 F8 Microsoft Corp. > manufacturer 0x0006 10 11 12 13 Samsung Electronics > manufacturer 0x0075 AA BB CC DD EE Google LLC > manufacturer 0x00E0 01 23 45 67 89 AB CD EF > manufacturer 0xFFFF DE AD BE EF data / . . {1} . LE (primary advertisements) . (data 0x0c) (advertise) . . data . (Usage) > data [type] [data=xx xx ...] (Uses) Data org.bluez.LEAdvertisement(5) [type] [data=xx xx ...] (: ) > data (slave connection interval range) > data 0x0C 01 0x0F 13 "Hello" > data 0x09 48 65 6C 6C 6F "Test" > data 0x08 54 65 73 74 (LE General Discoverable + BR/EDR ) > data 0x01 06 (keyboard, 0x0341) > data 0x19 41 03 TX +4 dBm > data 0x0A 04 TX -4 dBm > data 0x0A FC URI "//google.com" > data 0x24 17 2F 2F 67 6F 6F 67 6C 65 2E 63 6F 6D Battery Service ( 0x180F 100) > data 0x16 0F 18 64 sr-uuids / UUID (scan response). (Usage) > sr-uuids [uuid1 uuid2 ...] [uuid1 uuid2 ...] UUID (scan response) UUID (scan response) > sr-uuids Generic Access (scan response) > sr-uuids 0x1800 Device Info Battery (scan response) > sr-uuids 0x180A 0x180F UUID (scan response) > sr-uuids 12345678-1234-5678-9abc-123456789abc sr-solicit / UUID (scan response). (Usage) > sr-solicit [uuid1 uuid2 ...] [uuid1 uuid2 ...] UUID (scan response) UUID (scan response) > sr-solicit Generic Attribute (scan response) > sr-solicit 0x1801 Device Info Environmental Sensing (scan response) > sr-solicit 0x180A 0x181A sr-service / (scan response). (Usage) > sr-service [uuid] [data=xx xx ...] [uuid] UUID [data=xx xx ...] (scan response) > sr-service 128 (scan response) > sr-service 0x180F 80 (scan response) > sr-service 0x181A 22 18 C0 05 "Hello" (scan response) > sr-service 0x180A 48 65 6C 6C 6F sr-manufacturer / (scan response). (Usage) > sr-manufacturer [id] [data=xx xx ...] [id] (: 0x004C Apple Inc.) [data=xx xx ...] (scan response) > sr-manufacturer Apple (scan response) > sr-manufacturer 0x004C 05 06 07 08 Microsoft (scan response) > sr-manufacturer 0x0006 20 21 22 23 (scan response) > sr-manufacturer 0xFFFF CA FE BA BE sr-data / (scan response). (Usage) > sr-data [type] [data=xx xx ...] [type] (scan response) [data=xx xx ...] (scan response) (scan response) > sr-data "ScanResp" (scan response) > sr-data 0x09 53 63 61 6E 52 65 73 70 TX +8 dBm (scan response) > sr-data 0x0A 08 ( 50) (scan response) > sr-data 0x16 0F 18 32 discoverable / (discoverable) . LE discoverable on LE General Discoverable Mode true . (advertising) LE General Discoverable Mode discoverable-timeout . . (Usage) > discoverable [on/off] (Uses) Discoverable org.bluez.LEAdvertisement(5) [on/off] / LE General Discoverable Mode (discoverable) > discoverable LE General Discoverable Mode > discoverable on (discoverable) > discoverable off discoverable-timeout / (discoverable timeout) . LE LE Limited Discoverable Mode LE General Discoverable Mode . LE Limited Discoverable Mode [seconds] discoverable [on] . . (Usage) > discoverable-timeout [seconds] (Uses) DiscoverableTimeout org.bluez.LEAdvertisement(5) [seconds] / LE Limited Discoverable Mode (discoverable timeout) > discoverable-timeout LE Limited Discoverable > discoverable-timeout 30 LE Limited Discoverable > discoverable-timeout 120 LE Limited Discoverable > discoverable-timeout 300 () > discoverable-timeout 0 tx-power // (TX power) . TX Power Level (advertising packet) . dBm -127 127 . LE . (advertising) . . (Usage) > tx-power [on/off] (Uses) Includes org.bluez.LEAdvertisement(5) [on/off] (TX power) ( ) (TX power) > tx-power (TX power) > tx-power on (TX power) > tx-power off name (local name) . (advertising report). . . (Usage) > name [on/off/name] (Uses) LocalName org.bluez.LEAdvertisement(5) [name] ( ) > name (hostname) > name on > name off "My Device" > name "My Device" "Smart Sensor" > name "Smart Sensor" (ID) > name "BLE-Peripheral-001" ( ) > name "0123456789abcdef0123456789abcdef" ( ) > name "This is a very long device name that will be truncated" > name "Devicetm" (accented) > name "Test-Device" appearance / (appearance) . (Usage) > appearance [on/off/value] (Uses) Appearance org.bluez.LEAdvertisement(5) [value] / (appearance) ( ) / (appearance) > appearance / > appearance on / > appearance off / (0x03C1) > appearance 961 / (0x03C2) > appearance 962 / (0x03C3) > appearance 963 / (0x03C4) > appearance 964 / (0x0340) > appearance 832 / (0x0341) > appearance 833 / (0x0342) > appearance 834 / (0x0343) > appearance 835 / (0x0344) > appearance 836 / (0x0540) > appearance 1344 / (0x05C0) > appearance 1472 / (0x0640) > appearance 1600 / (0x0040) > appearance 64 / (0x0080) > appearance 128 / (0x00C0) > appearance 192 duration / . Duration (Instance) . . Duration . . Duration . Duration . Duration . Duration . . . (Usage) > duration [seconds] (Uses) Duration org.bluez.LEAdvertisement(5) [seconds] ( ) > duration ( ) > duration 0 > duration 1 > duration 5 > duration 10 > duration 30 > duration 60 > duration 300 timeout / . (Usage) > timeout [seconds] (Uses) Timeout org.bluez.LEAdvertisement(5) [seconds] ( ) > timeout ( ) > timeout 0 > timeout 30 > timeout 120 > timeout 3600 secondary / . (Usage) > secondary [1M/2M/Coded] (Uses) SecondaryChannel org.bluez.LEAdvertisement(5) [1M/2M/Coded] ( ) > secondary LE 1M PHY > secondary 1M LE 2M PHY > secondary 2M LE Coded PHY > secondary Coded rsi // RSI. RSI ( Resolvable Set Identifier) (Coordinated Set Identification) . (Usage) > rsi [on/off] [on/off] RSI ( ) RSI > rsi RSI > rsi on RSI > rsi off interval / . Interval (Instance) . . Interval . . Interval . Duration . . . (Usage) > interval [min] [max] [min] ( ) [max] ( min ) > interval ( ) > interval 20 ( ) > interval 50 100 ( ) > interval 100 ( ) > interval 200 ( ) > interval 500 ( ) > interval 1000 ( ) > interval 10240 clear . . . (Usage) > clear [uuids/service/manufacturer/config-name...] [uuids/service/manufacturer/config-name...] > clear UUID > clear uuids > clear service > clear manufacturer > clear name (appearance) > clear appearance TX > clear tx-power UUID > clear uuids service > clear manufacturer name UUID > clear uuids service manufacturer TX > clear discoverable tx-power (RESOURCES) (REPORTING BUGS) (COPYRIGHT) (LGPL) . BlueZ November 2022 bluetoothctl-advertise(1)