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
           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
     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), hcseriald(8)

AUTHORS
     Maksim Yevmenkin <m_evmenkin@yahoo.com>

BUGS
     Most likely.  Please report if found.

FreeBSD 13.1-RELEASE-p6           May 3, 2020          FreeBSD 13.1-RELEASE-p6