# FAQ

<details>

<summary>Help! I got a key that isn't working!</summary>

First make sure your switch doesn't have a bent pin by pulling the switch and verify the pin is good and straight, if it isn't gerntly bend it back and reinstall your switch.

If the pins are straight, disconnect/turn off your keyboard and verify your diode is installed in the proper direction and both the diode and swtich socket are soldered completely.

</details>

<details>

<summary>How do I connected my Wired Keyboard?</summary>

Please see the [Wired Keyboard First Time Setup Guide](/turkeyboards-docs/getting-started/wired-keyboard-first-time-setup-guide.md).

First connect the TRRS cable to each half. Next plug in your usb C cable from your keyboard to your computer.

{% hint style="info" %}
Remember, when disconnecting, always disconnect the USB first, then the TRRS. When connecting, however, plug in the TRRS first THEN the USB cable. If you disconnect your TRRS while your USB is plugged in or after the USB is plugged in then you will cause your keyboard to crash.
{% endhint %}

</details>

<details>

<summary>How do I connect my Wireless Keyboard?</summary>

Please see the [Wireless Keyboard First Time Setup Guide](/turkeyboards-docs/wireless-keyboard-first-time-setup-guide.md).

Turn on both halves of your keyboard and then add your blue tooth keyboard to the device.

</details>

<details>

<summary>My Keyboard isn't Powering on!</summary>

Wired: Make sure your USB and TRRS cables are FULLY inserted. If you are using a USB hub, bypass this and plug directly into your computer.

Wireless: Make sure your batteries are fully charged. Do so by turning your switch on then plugging in a USB C cable/charger into the usbc port.

</details>

<details>

<summary>How do I update my firmare?</summary>

### Brief Guide: How to Reflash a Split Keyboard

Reflashing means replacing the firmware on your keyboard’s controller. For split keyboards, you usually flash **each half separately**.

#### 0. Backup your Keyboard!

When installing your new firmware your configuration will be wiped. We recomend backing up your keyboard prior to flashing to ensure you don't lose your customization settings.

* Wired Keyboards - Install the [Vial application](https://get.vial.today/download/) on your computer if you already haven't done so and then go to File --> Save Current Layout... to save all your customization settings. Hold onto this file, you will restore it later after flashing by going to File --> Load Saved Layouts... in the final step.
* Wireless Keyboards - Currently ZMK Studio does not provide an option yet to backup your keyboard, so save screen shots of your keyboard so you can easily rebuild your keymap.

#### 1. Identify your firmware

Grab the latest firmware build from our Github page for your model keyboard.

**QMK/Vial**

* Used for wired keyboards.
* Firmware file is in the firmware folder and ends in `.uf2.`

**ZMK**

* Used for our wireless Bluetooth keyboards.
* Firmware file is in the firmware folder and ends in `.uf2.`
* Each half usually has its own firmware file, such as:
  * `left.uf2`
  * `right.uf2`

***

#### 2. Put one half into bootloader mode

Connect only one half of the keyboard to your computer with USB. You will repeat these steps for your other half.

To enter bootloader mode, use one of these methods:

* Press the physical **reset button** twice quickly (most of our keyboards)
* Press and hold **BOOT**, then tap **RESET (Corne v4.1)**
* Press the keyboard’s reset key if your keymap has one

For all our keyboards when you reset them into bootloader mode usually appears as a USB drive named something like:

```
RPI-RP2
```

***

#### 3. Flash the firmware

**For `.uf2` firmware**

When the controller appears as a USB drive:

1. Open the drive.
2. Drag the correct `.uf2` file onto it.
3. The drive will disappear.
4. The controller will reboot automatically.

Example:

```
Drag left.uf2 onto RPI-RP2
```

Then repeat the process for the right half using the right firmware. (Only ZMK has right left, all wired keyboards just copy the single firmware file to each half)

***

#### 4. Reconnect the keyboard

After both halves are flashed:

1. Unplug both halves.
2. Connect the halves together using TRRS, USB-C, or the keyboard’s split connection method.
3. Plug the main half into the computer.
4. Test the keys.

Either side can be used as primary for wired keyboards, we typically recommend left half.

***

#### 5. Test the keyboard

Make sure everything works and don't forget to restore your customization settings!

* Wired Keyboards - Open Vial Application and select File --> Load Saved Layout... and select your saved layout file to restore to your keyboard.
* Wireless Keyboards - Currently ZMK Studio does not provide an option yet to restore your keyboard, so use your screen shots of your keyboard you saved earlier so you can easily rebuild your keymap.

</details>


---

# 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.turkeyboards.com/turkeyboards-docs/troubleshooting/faq.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.