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
hccontrolattempts to resolve Bluetooth addresses, and display them symbolically. -nHCI_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
SEE ALSO
AUTHORS
Maksim Yevmenkin <m_evmenkin@yahoo.com>
BUGS
Most likely. Please report if found.