bluetoothctl-gatt(1) Linux System Administration bluetoothctl-gatt(1) (NAME) bluetoothctl-gatt - (Generic Attribute Submenu) (SYNOPSIS) bluetoothctl [--options] [gatt.commands] (services) (characteristics) (descriptors) GATT org.bluez.GattService(5) org.bluez.GattCharacteristic(5) org.bluez.GattDescriptor(5) org.bluez.GattManager(5) . (Generic Attribute Commands) list-attributes (handles) . . (Usage) > list-attributes [dev/local] [dev/local] MAC "local" ( ) > list-attributes /org/bluez/hci0/dev_00_11_22_33_44_55/service001a > list-attributes /org/bluez/hci0/dev_00_11_22_33_44_55/service001a/char001c > list-attributes /org/bluez/hci0/dev_AA_BB_CC_DD_EE_FF/service0020 Generic Access > list-attributes 0x1800 (Battery Service) > list-attributes 0x180F (Device Name) > list-attributes 0x2A00 (UUID) > list-attributes 00001801-0000-1000-8000-00805f9b34fb UUID > list-attributes 12345678-1234-5678-9abc-123456789abc select-attribute . . (context) ( read write notify ) . (Usage) > select-attribute [attribute/UUID] GATT (UUID) "local" [attribute/UUID] UUID "local" () > select-attribute /org/bluez/hci0/dev_00_11_22_33_44_55/service001a/char001c > select-attribute /org/bluez/hci0/dev_00_11_22_33_44_55/service0020/char0022/desc0024 > select-attribute /org/bluez/hci0/dev_AA_BB_CC_DD_EE_FF/service001a (Device Name) > select-attribute 0x2A00 (Battery Level) > select-attribute 0x2A19 (CCCD) > select-attribute 0x2902 UUID > select-attribute 00002a6e-0000-1000-8000-00805f9b34fb > select-attribute 12345678-1234-5678-9abc-123456789abc attribute-info . UUID . . (Usage) > attribute-info [attribute/UUID] [attribute/UUID] GATT UUID ( ) > attribute-info > attribute-info /org/bluez/hci0/dev_00_11_22_33_44_55/service001a/char001c > attribute-info 0x2A19 > attribute-info 0x2A00 > attribute-info 00002a6e-0000-1000-8000-00805f9b34fb read . select-attribute . offset . (Usage) > read [offset] (Uses) ReadValue org.bluez.GattCharacteristic(5) [offset] ( 0 ) > read () > read 0 > read 4 > read 10 > read 16 write . select-attribute . () . offset type . (Usage) > write [offset] [type] (Uses) WriteValue org.bluez.GattCharacteristic(5) [offset] ( 0 ) [type] - request command reliable ( request ) "Hello" ( ) > write "48 65 6C 6C 6F" > write "01 02 03 04" > write "FF" > write "01 02" 4 () > write "48 65 6C 6C 6F" 0 request ( ) > write "01 02 03" 0 command (reliable) > write "FF EE DD" 0 reliable acquire-write (Write file descriptor) . . (Usage) > acquire-write (Uses) AcquireWrite org.bluez.GattCharacteristic(5) > acquire-write release-write acquire-write . . (Usage) > release-write > release-write acquire-notify (Notify file descriptor) . . (Usage) > acquire-notify (Uses) AcquireNotify org.bluez.GattCharacteristic(5) > acquire-notify release-notify acquire-notify . . (Usage) > release-notify > release-notify notify . . (polling) . (Usage) > notify (Uses) StartNotify StopNotify org.bluez.GattCharacteristic(5) > notify on > notify off clone () . . (Usage) > clone [dev/attribute/UUID] [dev/attribute/UUID] MAC UUID ( ) GATT > clone 00:11:22:33:44:55 > clone AA:BB:CC:DD:EE:FF > clone /org/bluez/hci0/dev_00_11_22_33_44_55/service001a > clone /org/bluez/hci0/dev_00_11_22_33_44_55/service001a/char001c Generic Access > clone 0x1800 > clone 0x180F > clone 0x2A19 register-application . (Usage) > register-application [UUID ...] (Uses) RegisterApplication org.bluez.GattManager(5) [UUID ...] UUID GATT UUID > register-application > register-application 0x180F Generic Access > register-application 0x1800 0x180F UUID > register-application 12345678-1234-5678-9abc-123456789abc > register-application 0x1800 0x180F 0x180A unregister-application . (Usage) > unregister-application (Uses) UnregisterApplication org.bluez.GattManager(5) GATT > unregister-application register-service . . (Usage) > register-service [handle] (UUID) ( ) [handle] ( ) Generic Access ( ) > register-service 0x1800 ( ) > register-service 0x180F ( ) > register-service 0x180A Generic Access > register-service 0x1800 0x0001 > register-service 0x180F 0x0010 > register-service 0x180A 0x0020 ( ) > register-service 12345678-1234-5678-9abc-123456789abc > register-service 12345678-1234-5678-9abc-123456789abc 0x0050 unregister-service . (Usage) > unregister-service Generic Access > unregister-service 0x1800 > unregister-service 0x180F > unregister-service 12345678-1234-5678-9abc-123456789abc > unregister-service /org/bluez/example/service0 > unregister-service /org/bluez/example/service1 register-includes (included) . (Usage) > register-includes [handle] [handle] ( ) Generic Access > register-includes 0x1800 > register-includes 0x180F 0x0015 > register-includes 12345678-1234-5678-9abc-123456789abc unregister-includes . (Usage) > unregister-includes Generic Access > unregister-includes 0x1800 0x180F > unregister-includes 12345678-1234-5678-9abc-123456789abc 0x180A register-characteristic . (Usage) > register-characteristic [handle] ( ) [handle] ( ) () > register-characteristic 0x2A00 read ( + ) > register-characteristic 0x2A19 read,notify ( ) > register-characteristic 0x2A37 notify ( + ) > register-characteristic 0x2A00 read,write ( + + ) > register-characteristic 0x2A19 read,write,notify ( + /indications) > register-characteristic 0x2A6E read,indicate > register-characteristic 0x2A00 read 0x0003 > register-characteristic 0x2A19 read,notify 0x0013 > register-characteristic 12345678-1234-5678-9abc-123456789abc read,write,notify > register-characteristic ABCD1234-ABCD-1234-ABCD-123456789ABC write-without-response > register-characteristic 0x2A00 read,write,write-without-response,notify,indicate unregister-characteristic . (Usage) > unregister-characteristic > unregister-characteristic 0x2A00 > unregister-characteristic 0x2A19 > unregister-characteristic 12345678-1234-5678-9abc-123456789abc > unregister-characteristic /org/bluez/example/service0/char0 > unregister-characteristic /org/bluez/example/service1/char1 register-descriptor . (Usage) > register-descriptor [handle] ( ) [handle] ( ) (CCCD) > register-descriptor 0x2902 read,write > register-descriptor 0x2901 read > register-descriptor 0x2904 read CCCD > register-descriptor 0x2902 read,write 0x0005 > register-descriptor 0x2901 read 0x0015 > register-descriptor 12345678-1234-5678-9abc-123456789abc read,write > register-descriptor ABCD1234-ABCD-1234-ABCD-123456789ABC read > register-descriptor 0x2906 read > register-descriptor 0x2907 read > register-descriptor 0x2908 read unregister-descriptor . (Usage) > unregister-descriptor (CCCD) > unregister-descriptor 0x2902 > unregister-descriptor 0x2901 > unregister-descriptor 12345678-1234-5678-9abc-123456789abc > unregister-descriptor /org/bluez/example/service0/char0/desc0 > unregister-descriptor /org/bluez/example/service1/char1/desc1 (RESOURCES) (REPORTING BUGS) (COPYRIGHT) (LGPL) . BlueZ November 2022 bluetoothctl-gatt(1)