millertechnologyperu/hcitool

Bluetooth Host Controller Interface Command Line Tool for for sending HCI commands on macOS and Linux

hcitool

Bluetooth Host Controller Interface Command Line Tool for for sending HCI commands on macOS and Linux

hcitool's Issues

Add `LE Set Host Channel Classification Command`

The LE_Set_Host_Channel_Classification command allows the Host to specify a channel classification for data channels based on its “local information”.

Add `LE Connection Update Command`

The LE_Connection_Update command is used to change the Link Layer connection parameters of a connection. This command may be issued on both the master and slave.

Add `LE Set Advertising Data Command`

The LE_Set_Advertising_Data command is used to set the data used in advertising packets that have a data field.

Doesn't compile (swift build)

swift build leads to this result:

hcitool/Sources/hcitool/main.swift:18:38: error: value of type 'HostController' has no member 'isPowerChangeSupported'
    if controller.powerState != .on, controller.isPowerChangeSupported {
                                     ^~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~
error: terminated(1): /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/swift-build-tool -f '/[...]/hcitool/.build/debug.yaml' main output:

Could it be because I don't have the latest Xcode version?

LE Start Encryption Command

The LE_Start_Encryption command is used to authenticate the given encryption key associated with the remote device specified by the Connection_Handle, and once authenticated will encrypt the connection.

Add `LE Set Scan Parameters Command`

The LE_Set_Scan_Parameters command is used to set the scan parameters.

Add `LE Set Event Mask Command`

The LE_Set_Event_Mask command is used to control which LE events are generated by the HCI for the Host.

Added `LE Set Scan Enable Command`

The LE_Set_Scan_Enable command is used to start scanning. Scanning is used to discover advertising devices nearby.

Add `LE Read White List Size Command`

The LE_Read_White_List_Size command is used to read the total number of White List entries that can be stored in the Controller.

Add `Create Connection Cancel Command `

The LE_Create_Connection_Cancel command is used to cancel the LE_Create_Connection or LE_Extended_Create_Connection commands.

Add `LE Add Device To Resolving List Command`

The LE_Add_Device_To_Resolving_List command is used to add one device to the list of address translations used to resolve Resolvable Private Addresses in the Controller.

How do you install this?

Any chance you could add info about how do you install hcitool on osx?

Add help information for each command

Each command should have a description property, and when no command is specified we should load all the possible options. Command will need an all property.

Add `LE Test End Command`

This command is used to stop any test which is in progress. The Number_Of_Packets for a transmitter test shall be reported as 0x0000. The Number_Of_Packets is an unsigned number and contains the number of received packets.

Add LE Read Supported States Command

The LE_Read_Supported_States command reads the states and state combinations that the link layer supports.

Add `LE Set Scan Enable Command`

The LE_Set_Scan_Enable command is used to start scanning. Scanning is used to discover advertising devices nearby.

Refactor project layout

Refactor layout of project to have a model framework target, a unit test target, and an executable target that is only main.swift.

Add `LE Create Connection Command`

The LE_Create_Connection command is used to create a Link Layer connection to a connectable advertiser.

Add `LE Read Buffer Size Command`

The LE_Read_Buffer_Size command is used to read the maximum size of the data portion of HCI LE ACL Data Packets sent from the Host to the Controller.

Add `LE Receiver Test Command`

This command is used to start a test where the DUT receives test reference packets at a fixed interval.

Implement more LE commands

Implement more Bluetooth Low Energy commands.

Add `LE Long Term Key Request Reply Command`

The LE_Long_Term_Key_Request Reply command is used to reply to an LE Long Term Key Request event from the Controller, and specifies the Long_Term_Key parameter that shall be used for this Connection_Handle.

Add `LE Read Channel Map Command`

The LE_Read_Channel_Map command returns the current Channel_Map for the specified Connection_Handle.

Add `LE Set Advertising Enable Command`

The LE_Set_Advertising_Enable command is used to request the Controller to start or stop advertising.

Add `LE Read Local Supported Features Command`

This command requests the list of the supported LE features for the Controller.

Add `LE Remove Device From Resolving List Command`

The LE_Remove_Device_From_Resolving_List command is used to remove one device from the list of address translations used to resolve Resolvable Private Addresses in the Controller.

Add `LE Transmitter Test Command`

This command is used to start a test where the DUT generates test reference packets at a fixed interval. The Controller shall transmit at maximum power.

Add `LE Set Scan Response Data Command`

This command is used to provide data used in Scanning Packets that have a data field.

Add `LE Set Random Address Command`

The LE_Set_Random_Address command is used by the Host to set the LE Random Device Address in the Controller.

Input/output error

Having error while executing lescan

root@homeassistant:~# hcitool -i hci0 lescan
Set scan parameters failed: Input/output error

Add `LE Add Device To White List Command`

The LE_Add_Device_To_White_List command is used to add a single device to the White List stored in the Controller.

Add `LE Long Term Key Request Negative Reply Command`

The LE_Long_Term_Key_Request_Negative_Reply command is used to reply to an LE Long Term Key Request event from the Controller if the Host cannot provide a Long Term Key for this Connection_Handle.

Add remaining HCI Commands

Add `LE Clear Resolving List Command`

The LE_Clear_Resolving_List command is used to remove all devices from the list of address translations used to resolve Resolvable Private Addresses in the Controller.

Add `LE Read Resolving List Size Command`

The LE_Read_Resolving_List_Size command is used to read the total number of address translation entries in the resolving list that can be stored in the Controller. Note: The number of entries that can be stored is not fixed and the Controller can change it at any time (e.g. because the memory used to store the list can also be used for other purposes).

Add `LE Clear White List Command`

The LE_Clear_White_List command is used to clear the White List stored in the Controller.

Add `LE Set Advertising Parameters Command`

The LE_Set_Advertising_Parameters command is used by the Host to set the advertising parameters.

Add `LE Remove Device From White List Command`

The LE_Remove_Device_From_White_List command is used to remove a single device from the White List stored in the Controller.

Assertion failed

I was able to compile the project with Xcode 13.2.1 and then tried to run this command:

.build/x86_64-apple-macosx/debug/hcitool ibeacon

However, this error message appeared:

BluetoothDarwin/BluetoothDarwin.swift:31: Assertion failed
zsh: illegal hardware instruction .build/x86_64-apple-macosx/debug/hcitool ibeacon

Do we need to configure anything before running ibeacon?

Properly parse boolean command line arguments

Right now we have 2 swift files that deal with boolean values for the command line interface:

• CommandLineBool.swift
• Boolean.swift

We need to avoid duplicate code and standardize.

Add `LE Rand Command`

The LE_Rand command is used to request the Controller to generate 8 octets of random data to be sent to the Host.

Add `LE Encrypt Command`

The LE_Encrypt command is used to request the Controller to encrypt the Plaintext_Data in the command using the Key given in the command and returns the Encrypted_Data to the Host.

Add `LE Read Advertising Channel Tx Power Command`

The LE_Read_Advertising_Channel_Tx_Power command is used by the Host to read the transmit power level used for LE advertising channel packets.