Use this tool to control your Human Interface Devices (HID), like keyboards and mice. This utility communicates with kernel module and keeps database of HID devices. Database is stored in directory /var/spool/affix/hiddb.
Bthidctl can search for available devices and when found sends SDP request to them to find out if they are HID capable. All HID devices are added to device database. Note that you have to press device's connect button before bthidctl is able to find it.
Add devices in HID device database. Also reconnects to those devices that were connected to some other computer meantime. To connect a device it must be ready for it. Most devices have a special button that sets then ready for it. After connecting to device use "bthidctl listen" to connect again. Parameter is whether the connected device's Bluetooth address or keyword "all". All means that all connectible devices in the range are added to database and connected.
This command can be used only by root unless you change the user rights for the database directory at /var/spool/affix
Notify kernel about device to allow HID connections to/from it. Before giving a device to listen command the device have to be registered to HID device database (see above). Give keyword "all" instead of Bluetooth address to activate all the devices included in the database. This is very useful for boot scripts.
Note! HID devices remember to which computer they last time were connected. If you used the HID device with some other computer meanwhile you have to use "bthidctl connect" to reconnect it to this computer.
--active Activate the connection immediately. This is needed only for some older HID devices that cannot automatically reconnect and can not announce it.
Terminate a connection with given device and remove it from the kernel's allowed device list. The device database is left untouched. Device can be reconnected after adding it again to kernel's allowed device list ("bthidctl listen" command).
Remove a device permanently from the device database. If there is open connection it will be closed. Note here is not possible use "all" keyword.
This command can be used only by root unless you change the user rights for the database directory at /var/spool/affix
Get a list of HID devices in the device database. The given list includes device's Bluetooth address, status and device identifier. If "discovery" parameter is given a discovery is performed before listing the devices. The found devices will be listed too. HID incompatible devices are stated as "IN RANGE" status and they have no device identifier.