FreeBSD manual
download PDF document: hccontrol.8.pdf
HCCONTROL(8) FreeBSD System Manager's Manual HCCONTROL(8)
NAME
hccontrol - Bluetooth HCI configuration utility
SYNOPSIS
hccontrol [-hN] [-n HCI_node_name] command [parameters ...]
DESCRIPTION
The hccontrol utility connects to the specified Netgraph node of type HCI
or the first one found if none is specified and attempts to send the
specified command to the HCI Netgraph node or to the associated Bluetooth
device. The hccontrol utility will print results to the standard output
and error messages to the standard error.
The options are as follows:
-h Display usage message and exit.
-N Show Bluetooth addresses as numbers. Normally hccontrol attempts
to resolve Bluetooth addresses, and display them symbolically.
-n HCI_node_name
Connect to the specified HCI Netgraph node.
command
One of the supported commands (see below). The special command
help can be used to obtain the list of all supported commands.
To get more information about a specific command use help
command.
parameters
One or more optional space separated command parameters. Many
commands require a remote device address as one of the
parameters. The remote device address can be specified as
BD_ADDR or a name. If a name was specified then the hccontrol
utility will attempt to resolve the name via bt_gethostbyname(3).
COMMANDS
The currently supported HCI commands in hccontrol are:
Inquiry
Create_Connection
Disconnect
Add_SCO_Connection
Change_Connection_Packet_Type
Remote_Name_Request
Read_Remote_Supported_Features
Read_Remote_Version_Information
Read_Clock_Offset
Role_Discovery
Switch_Role
Read_Link_Policy_Settings
Write_Link_Policy_Settings
Reset
Read_Pin_Type
Write_Pin_Type
Read_Stored_Link_Key
Write_Stored_Link_Key
Read_Scan_Enable
Write_Scan_Enable
Read_Page_Scan_Activity
Write_Page_Scan_Activity
Read_Inquiry_Scan_Activity
Write_Inquiry_Scan_Activity
Read_Authentication_Enable
Write_Authentication_Enable
Read_Encryption_Mode
Write_Encryption_Mode
Read_Class_Of_Device
Write_Class_Of_Device
Read_Voice_Settings
Write_Voice_Settings
Read_Number_Broadcast_Retransmissions
Write_Number_Broadcast_Retransmissions
Read_Hold_Mode_Activity
Write_Hold_Mode_Activity
Read_SCO_Flow_Control_Enable
Write_SCO_Flow_Control_Enable
Read_Link_Supervision_Timeout
Write_Link_Supervision_Timeout
Read_Page_Scan_Period_Mode
Write_Page_Scan_Period_Mode
Read_Page_Scan_Mode
Write_Page_Scan_Mode
Read_LE_Host_Support
Write_LE_Host_Support
Read_Local_Version_Information
Read_Local_Supported_Commands
Read_Local_Supported_Features
Read_Buffer_Size
Read_Country_Code
Read_BD_ADDR
Read_Failed_Contact_Counter
Reset_Failed_Contact_Counter
Get_Link_Quality
Read_RSSI
LE_Enable
LE_Read_Local_Supported_Features
LE_Set_Advertising_Parameters
LE_Read_Advertising_Physical_Channel_Tx_Power
LE_Set_Advertising_Data
LE_Set_Scan_Response_Data
LE_Set_Advertising_Enable
LE_Set_Scan_Parameters
LE_Set_Scan_Enable
LE_Read_Supported_States
LE_Read_Buffer_Size
LE_Scan
LE_Read_White_List_Size
LE_Clear_White_List
LE_Add_Device_To_White_List
LE_Remove_Device_From_White_List
LE_Connect
LE_Read_Channel_Map
LE_Read_Remote_Features
LE_Rand
Read_Node_BD_ADDR
Read_Node_Features
Read_Node_Stat
Reset_Node_Stat
Flush_Neighbor_Cache
Read_Neighbor_Cache
Read_Connection_List
Read_Node_Link_Policy_Settings_Mask
Write_Node_Link_Policy_Settings_Mask
Read_Node_Packet_Mask
Write_Node_Packet_Mask
Read_Node_Role_Switch
Write_Node_Role_Switch
Read_Node_List
EXIT STATUS
The hccontrol utility exits 0 on success, and >0 if an error occurs.
EXAMPLES
Make the blutooth LE host, ubt0hci, scannable through hccontrol(8)
commands:
hccontrol -n ubt0hci le_set_advertising_enable disable
hccontrol -n ubt0hci le_set_advertising_param
hccontrol -n ubt0hci le_read_advertising_channel_tx_power
hccontrol -n ubt0hci le_set_advertising_data
hccontrol -n ubt0hci le_set_scan_response -n FBSD_Host
hccontrol -n ubt0hci le_set_advertising_enable enable
SEE ALSO
bluetooth(3), netgraph(3), netgraph(4), ng_hci(4)
AUTHORS
Maksim Yevmenkin <m_evmenkin@yahoo.com>
BUGS
Most likely. Please report if found.
FreeBSD 14.0-RELEASE-p11 May 3, 2020 FreeBSD 14.0-RELEASE-p11