mirror of
https://github.com/greatscottgadgets/ubertooth.git
synced 2026-10-12 02:15:11 +00:00
128 lines
3.8 KiB
ReStructuredText
128 lines
3.8 KiB
ReStructuredText
=================
|
|
Building from git
|
|
=================
|
|
|
|
Prerequisites
|
|
~~~~~~~~~~~~~
|
|
|
|
There are some prerequisites that need to be installed before building libbtbb and the Ubertooth tools. Many of these are available from your operating system's package repositories, for example:
|
|
|
|
Debian/Ubuntu
|
|
^^^^^^^^^^^^^
|
|
|
|
.. code-block:: sh
|
|
|
|
sudo apt-get install git cmake libusb-1.0-0-dev make gcc g++ libbluetooth-dev \
|
|
pkg-config libpcap-dev python-numpy python-pyside python-qt4
|
|
|
|
|
|
|
|
Fedora / Red Hat
|
|
^^^^^^^^^^^^^^^^
|
|
|
|
.. code-block:: sh
|
|
|
|
su -c "yum install git libusb1-devel make gcc wget tar bluez-libs-devel"
|
|
|
|
|
|
|
|
Mac OS X users can use either MacPorts or Homebrew to install the required packages:
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
.. code-block:: sh
|
|
|
|
sudo port install git libusb wget cmake python27 py27-numpy py27-pyside
|
|
or
|
|
brew install git libusb wget cmake pkg-config homebrew/dupes/libpcap
|
|
|
|
|
|
|
|
libbtbb
|
|
~~~~~~~
|
|
|
|
Next the Bluetooth baseband library (libbtbb) needs to be built for the Ubertooth tools to decode Bluetooth packets:
|
|
|
|
.. code-block:: sh
|
|
|
|
git clone https://github.com/greatscottgadgets/libbtbb.git
|
|
cd libbtbb
|
|
mkdir build
|
|
cd build
|
|
cmake ..
|
|
make
|
|
sudo make install
|
|
|
|
**Linux users**: if you are installing for the first time, or you receive errors about finding the library, you should run:
|
|
|
|
.. code-block:: sh
|
|
|
|
sudo ldconfig
|
|
|
|
|
|
|
|
Ubertooth tools
|
|
~~~~~~~~~~~~~~~
|
|
|
|
The Ubertooth repository contains host code for sniffing Bluetooth packets, configuring the Ubertooth and updating firmware. All three are built and installed by default using the following method:
|
|
|
|
.. code-block:: sh
|
|
|
|
git clone https://github.com/greatscottgadgets/ubertooth.git
|
|
cd ubertooth/host
|
|
mkdir build
|
|
cd build
|
|
cmake ..
|
|
make
|
|
sudo make install
|
|
|
|
**Linux users**: if you are installing for the first time, or you receive errors about finding the library, you should run:
|
|
|
|
.. code-block:: sh
|
|
|
|
sudo ldconfig
|
|
|
|
|
|
|
|
Wireshark
|
|
~~~~~~~~~
|
|
|
|
Wireshark version 1.12 and newer includes the Ubertooth BLE plugin by default. It is also possible to `capture BLE from Ubertooth directly into Wireshark <https://ubertooth.readthedocs.io/en/latest/capturing_BLE_Wireshark.html>`__ with a little work.
|
|
|
|
The Wireshark BTBB and BR/EDR plugins allow Bluetooth baseband traffic that has been captured using Kismet to be analysed and disected within the Wireshark GUI. They are built separately from the rest of the Ubertooth and libbtbb software. The directory passed to cmake as ``MAKE_INSTALL_LIBDIR`` varies from system to system, but it should be the location of existing Wireshark plugins, such as ``asn1.so`` and ``ethercat.so``.
|
|
|
|
.. code-block:: sh
|
|
|
|
sudo apt-get install wireshark wireshark-dev libwireshark-dev cmake
|
|
cd libbtbb/wireshark/plugins/btbb
|
|
mkdir build
|
|
cd build
|
|
cmake -DCMAKE_INSTALL_LIBDIR=/usr/lib/x86_64-linux-gnu/wireshark/libwireshark3/plugins ..
|
|
make
|
|
sudo make install
|
|
|
|
Then repeat for the BT BR/EDR plugin:
|
|
|
|
.. code-block:: sh
|
|
|
|
sudo apt-get install wireshark wireshark-dev libwireshark-dev cmake
|
|
cd libbtbb/wireshark/plugins/btbredr
|
|
mkdir build
|
|
cd build
|
|
cmake -DCMAKE_INSTALL_LIBDIR=/usr/lib/x86_64-linux-gnu/wireshark/libwireshark3/plugins ..
|
|
make
|
|
sudo make install
|
|
|
|
|
|
|
|
Third Party Software
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
There are a number of pieces of `third party software <https://ubertooth.readthedocs.io/en/latest/third_party_software.html>`__ that support the Ubertooth. Some support Ubertooth out of the box, while others require plugins to be built.
|
|
|
|
|
|
|
|
Firmware
|
|
~~~~~~~~
|
|
|
|
This completes the install of the Ubertooth tools, the next step is to look at the getting started guide. You should always `update the firmware <https://ubertooth.readthedocs.io/en/latest/firmware.html>`__ on the Ubertooth device to match the software release version that you are using.
|