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
Delete_Stored_Link_Key
Change_Local_Name
Read_Local_Name
Read_Connection_Accept_Timeout
Write_Connection_Accept_Timeout
Read_Page_Timeout
Write_Page_Timeout
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

The currently supported node commands in hccontrol are:

Read_Node_State
Initialize
Read_Debug_Level
Write_Debug_Level
Read_Node_Buffer_Size
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

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.