https://github.com/zerbea/hcxbtdumptool
Small tool to capture packets from Bluetooth devices.
https://github.com/zerbea/hcxbtdumptool
bluetooth bluetooth-le bluetooth-low-energy
Last synced: 7 months ago
JSON representation
Small tool to capture packets from Bluetooth devices.
- Host: GitHub
- URL: https://github.com/zerbea/hcxbtdumptool
- Owner: ZerBea
- License: mit
- Created: 2020-06-19T14:50:48.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-01-03T12:19:33.000Z (almost 2 years ago)
- Last Synced: 2025-03-17T19:13:28.750Z (7 months ago)
- Topics: bluetooth, bluetooth-le, bluetooth-low-energy
- Language: C
- Homepage:
- Size: 57.6 KB
- Stars: 47
- Watchers: 12
- Forks: 12
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: changelog
- License: license.txt
Awesome Lists containing this project
README
hcxbtdumptool
==============
Small tool to capture packets from Bluetooth devices.
Initial commit - no Bluetooth functions - only help and version menue and Bluetooth device information available.
This is a playground to get some knowledge about coding Bluetooth.
Everything is high experimental.
Similar to hcxdumptool (WiFi) we use ioctl() system calls to control the device.
Brief description
--------------
Stand-alone binaries - designed to run on Raspberry Pi's with installed Arch Linux.
It may work on other Linux systems (notebooks, desktops) and distributions, too.
Detailed description
--------------
| Tool | Description |
| -------------- | ------------------------------------------------------------------------------------------------------ |
| hcxbtdumptool | Tool to dump Bluetooth packets |
Get source
--------------
```
git clone https://github.com/ZerBea/hcxbtdumptool.git
cd hcxbtdumptool
```
Compile
--------------
```
make
make install (as super user)
```
Requirements
--------------
* Operatingsystem: Arch Linux (strict), Kernel >= 5.4 (strict). It may work on other Linux systems (notebooks, desktops) and distributions, too (no support for other distributions, no support for other operating systems)
* gcc 10 recommended (deprecated versions are not supported: https://gcc.gnu.org/)
* bluetooth and libbluetooth-dev installed
* Raspberry Pi A, B, A+, B+, Zero (WH). (Recommended: Zero (WH) or A+, because of a very low power consumption), but notebooks and desktops may work, too.
* GPIO hardware mod recommended (push button and LED).
Adapters
--------------
| VENDOR MODEL | ID |
| ----------------------- | --------------------------------------------------------------------------------------------- |
| generic CSR 4.0 devic | ID 0a12:0001 Cambridge Silicon Radio, Ltd Bluetooth Dongle (HCI mode) |
| DELOCK CLASS 1 EDR 150m | ID 0a12:0001 Cambridge Silicon Radio, Ltd Bluetooth Dongle (HCI mode) |