hccontrol8
Bluetooth hci configuration utility
Usage
hccontrol [-hN]
[-n
HCI_node_name]
command
[parameters ...]
Overview
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
hccontrolattempts 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
helpcan be used to obtain the list of all supported commands. To get more information about a specific command usehelpcommand. - 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
hccontrolutility will attempt to resolve the name via bt_gethostbyname(3).
Commands
The currently supported HCI commands in hccontrol are:
InquiryCreate_ConnectionDisconnectAdd_SCO_ConnectionChange_Connection_Packet_TypeRemote_Name_RequestRead_Remote_Supported_FeaturesRead_Remote_Version_InformationRead_Clock_OffsetRole_DiscoverySwitch_RoleRead_Link_Policy_SettingsWrite_Link_Policy_SettingsResetRead_Pin_TypeWrite_Pin_TypeRead_Stored_Link_KeyWrite_Stored_Link_KeyDelete_Stored_Link_KeyChange_Local_NameRead_Local_NameRead_Connection_Accept_TimeoutWrite_Connection_Accept_TimeoutRead_Page_TimeoutWrite_Page_TimeoutRead_Scan_EnableWrite_Scan_EnableRead_Page_Scan_ActivityWrite_Page_Scan_ActivityRead_Inquiry_Scan_ActivityWrite_Inquiry_Scan_ActivityRead_Authentication_EnableWrite_Authentication_EnableRead_Encryption_ModeWrite_Encryption_ModeRead_Class_Of_DeviceWrite_Class_Of_DeviceRead_Voice_SettingsWrite_Voice_SettingsRead_Number_Broadcast_RetransmissionsWrite_Number_Broadcast_RetransmissionsRead_Hold_Mode_ActivityWrite_Hold_Mode_ActivityRead_SCO_Flow_Control_EnableWrite_SCO_Flow_Control_EnableRead_Link_Supervision_TimeoutWrite_Link_Supervision_TimeoutRead_Page_Scan_Period_ModeWrite_Page_Scan_Period_ModeRead_Page_Scan_ModeWrite_Page_Scan_ModeRead_LE_Host_SupportWrite_LE_Host_SupportRead_Local_Version_InformationRead_Local_Supported_CommandsRead_Local_Supported_FeaturesRead_Buffer_SizeRead_Country_CodeRead_BD_ADDRRead_Failed_Contact_CounterReset_Failed_Contact_CounterGet_Link_QualityRead_RSSILE_EnableLE_Read_Local_Supported_FeaturesLE_Set_Advertising_ParametersLE_Read_Advertising_Physical_Channel_Tx_PowerLE_Set_Advertising_DataLE_Set_Scan_Response_DataLE_Set_Advertising_EnableLE_Set_Scan_ParametersLE_Set_Scan_EnableLE_Read_Supported_StatesLE_Read_Buffer_SizeLE_ScanLE_Read_White_List_SizeLE_Clear_White_ListLE_Add_Device_To_White_ListLE_Remove_Device_From_White_ListLE_ConnectLE_Read_Channel_MapLE_Read_Remote_FeaturesLE_Rand
The currently supported node commands in hccontrol are:
Read_Node_StateInitializeRead_Debug_LevelWrite_Debug_LevelRead_Node_Buffer_SizeRead_Node_BD_ADDRRead_Node_FeaturesRead_Node_StatReset_Node_StatFlush_Neighbor_CacheRead_Neighbor_CacheRead_Connection_ListRead_Node_Link_Policy_Settings_MaskWrite_Node_Link_Policy_Settings_MaskRead_Node_Packet_MaskWrite_Node_Packet_MaskRead_Node_Role_SwitchWrite_Node_Role_SwitchRead_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
Releases
52 releases since FreeBSD 5.3-RELEASE; the text changed 35 times.