# How to use Hideez Bluetooth Dongle on Raspberry Pi

{% hint style="info" %}
**We tested the Hideez Dongle on Raspberry Pi and can confirm its successful operation on the following OS:**

* Debian GNU/Linux 12 (Bookworm) arm64
* Debian GNU/Linux 12 (Bookworm) arm
* Raspbian GNU/Linux 11 (Bullseye) arm
* Debian GNU/Linux 11 (Bullseye) arm64
  {% endhint %}

### **General Algorithm for Using the Dongle**

1. **Disabling the Internal Bluetooth**:
   * Edit the file `/boot/config.txt` (in recent versions of Raspberry Pi - `/boot/firmware/config.txt`).
   * Add the following line at the beginning of the file:

     ```
     dtoverlay=disable-bt
     ```
   * Save the file, turn off the device, insert the external dongle, and boot the Raspberry Pi.
2. **Adding Devices**:
   * Use the Bluetooth button in the upper right corner of the screen.

### Pairing Bluetooth devices via Hideez Dongle on Raspberry Pi 

{% embed url="<https://youtu.be/17j8LIGt7T8>" %}

**Alternative Method of pairing via Command Line**

1. **Launch the Utility**:

   ```
   bluetoothctl
   ```
2. **View Available Devices**:

   ```
   devices
   ```
3. **Pair the Device**:

   ```
   pair <MAC address of the device to be added>
   ```
4. **Establish the Connection**:

```
connect <MAC address of the device>
```

{% hint style="warning" %}
**Factors for Successful Operation on Raspberry Pi:**

1. **Sufficient power supply unit**: The dongle connects via a USB port and requires additional power. Choose a power supply recommended by the manufacturer with sufficient power to avoid issues with connected devices.
2. **Resource Usage**: When working via Bluetooth, Raspberry Pi actively uses device resources (memory, processor). If resources are insufficient, device response to events may degrade (long connection times, pauses in music playback, etc.).
   {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dongle.hideez.com/how-to-use-hideez-bluetooth-dongle-on-raspberry-pi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.