# 7.1 Swapping Microcontrollers: Bluetooth

### 7.1.1 Introduction

This page discusses how to convert your non-Bluetooth dactyl manuform keyboard to a Bluetooth-enabled keyboard. If you have purchased a Bluetooth-enabled keyboard directly on our [store](https://taikohub.com), then this page is not relevant to you because Bluetooth has already been setup for you.

{% hint style="danger" %}
Unplug any cords or batteries before swapping your microcontrollers.
{% endhint %}

### 7.1.2 Necessary tools and components

* [ ] 3mm Allen key
* [ ] 2 x Microcontroller that support Bluetooth. The nice!nano V2, the SuperMini nRF52840 and the Pro Micro nRF52840 are officially supported, but most microcontrollers with a footprint similar to the Arduino Pro Micro should work. <mark style="color:red;">Not compatible with BlueMicro840 V1.0.</mark>
* [ ] &#x20;2 x LiPo batteries with 2-Pin JST-PH. It's safest to get them from [Adafruit ](https://www.adafruit.com/product/1570)or [Sparkfun](https://www.sparkfun.com/products/13853).

{% hint style="danger" %}
Double check the LiPo battery for your microcontroller! Different microcontrollers may require different batteries. <mark style="color:red;">**Using the wrong battery can lead to**</mark> <mark style="color:red;">**explosions**</mark>!

Make sure that your JST-PH is correctly wired! The black wire and red wire should be in the correct orientation on the JST-PH connector, as shown in Figure 7.1.1.&#x20;

It's recommended you use batteries from Adafruit or Sparkfun. You can use other vendors, but note that some vendors sell LiPo batteries with their wires reversed. See video on this issue by Adafruit [here](https://www.youtube.com/watch?v=ILArrTIMFyM).
{% endhint %}

<div><figure><img src="https://content.gitbook.com/content/0Ec0PeiPTpjEJM01pozO/blobs/HTUzc8VvYZ83QzoSuLSx/lipo_battery_caution.png" alt="dactyl manuform keyboard bluetooth lipo battery wiring"><figcaption><p>Figure 7.1.1 Orient your JST connector same way as the photo above. The black wire should be on the right and red should be on the left.</p></figcaption></figure> <figure><img src="https://content.gitbook.com/content/0Ec0PeiPTpjEJM01pozO/blobs/mtjnit45qxAfgnCipEct/lipo_battery.jpg" alt="dactyl manuform keyboard bluetooth lipo battery example"><figcaption><p>Figure 7.1.2. This 3.7V 110mAh LiPo battery worked with nice!nano's during testing.</p></figcaption></figure></div>

### 7.1.3 Adding Bluetooth

1. Remove the plastic cover and take out the default microcontroller that came with the keyboard.

<figure><img src="https://content.gitbook.com/content/0Ec0PeiPTpjEJM01pozO/blobs/JTt4Xz7Fie7NalRojLLc/taikohub-dactyl-manuform-keyboard-with-nice-nano-v2-step-1.jpg" alt="taikohub dactyl manuform keyboard adding bluetooth functionality with nice nanos step one" width="375"><figcaption><p>Figure 7.1.2.1 Take out the default microcontroller that came with the keyboard.</p></figcaption></figure>

2. Insert the Bluetooth enabled microcontroller.

* Optional: If you want the USB-C port to be closer to the edge of the keyboard, you can loosen the screws counterclockwise with an 3mm Allen Key by a half circle. Then slide the PCB forward. Tighten the screw again afterwards by turning it clockwise.

<figure><img src="https://content.gitbook.com/content/0Ec0PeiPTpjEJM01pozO/blobs/nF2DYxDByW6TeCT89K3Q/taikohub-dactyl-manuform-keyboard-with-nice-nano-v2-step-3.jpg" alt="taikohub dactyl manuform keyboard adding bluetooth functionality with nice nanos step two" width="375"><figcaption><p>Figure 7.1.2.2 Insert the new Bluetooth-enabled microcontroller. <br>If you want the USB-C port to be closer to the edge of the keyboard, <br>you can loosen the screws.</p></figcaption></figure>

3. Insert the LiPo battery.

* No special instructions for inserting the battery. As long as you obtained the correct battery, the connector will insert correctly. This is because the JST-PH socket can only accept the battery header in one direction.

<figure><img src="https://content.gitbook.com/content/0Ec0PeiPTpjEJM01pozO/blobs/FqoHMi1lGV93s6wSFNtN/taikohub-dactyl-manuform-keyboard-with-nice-nano-v2-step-2.jpg" alt="taikohub dactyl manuform keyboard adding bluetooth functionality with nice nanos step three" width="375"><figcaption><p>Figure 7.1.2.3 Insert the new Bluetooth enabled microcontroller <br>and the LiPo battery.</p></figcaption></figure>

4. Put the cover back on.&#x20;

* You did it 🎉! Proceed to the section on flashing your keyboard with ZMK.

<figure><img src="https://content.gitbook.com/content/0Ec0PeiPTpjEJM01pozO/blobs/WnuD9V1dqdcNe0p9X1xr/taikohub-dactyl-manuform-keyboard-with-nice-nano-v2-step-4.jpg" alt="taikohub dactyl manuform keyboard adding bluetooth functionality with nice nanos step four" width="375"><figcaption><p>Figure 7.1.2.4 Put the cover back on.</p></figcaption></figure>


---

# 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://docs.taikohub.com/swapping-microcontrollers/bluetooth.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.