# Quick Start Guide to Build a Piantor (Raspberry Pi Pico)

**Don’t connect or disconnect the TRRS cable when the keyboard is powered. Always disconnect the USB cable first.**

Flash the Vial firmware on both Raspberry Pi Picos by copying the uf2 firmware to the USB mass storage device. If you do not see a mass storage device, you will need to enter the bootloader mode by holding down the BOOTSEL button while reconnecting the board into USB port.

{% file src="/files/UwRKh5QtpOm2knqka8tB" %}

### Solder the Raspberry Pi Pico and the TRRS Jacks

<figure><img src="/files/OnEXTOWP03cXdJ7wF64o" alt=""><figcaption></figcaption></figure>

The Raspberry Pi Pico can be soldered on both left and right halves using the castellated holes on the top side.

### Test the key presses

Connect both halves using TRRS cable. Run Vial on the computer and switch it to the Matrix Tester tab. You can trigger key presses by shorting the hotswap socket pads or switch holes.

### Solder the hotswap sockets or the key switches

You can solder hotswap sockets (as a hotswap version), or low profile choc v1 key switches directly (as a non-hotswap/soldered-in version).

### Final Product

<figure><img src="/files/yLTHDKklZ7t4cdJWST12" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/McbNZWEYyL7WJDv4NUfe" alt=""><figcaption></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.beekeeb.com/piantor-keyboard/quick-start-guide-to-build-a-piantor-raspberry-pi-pico.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.