# Swoop Keyboard

Vial Firmware

Example GitHub Repo: <https://github.com/beekeeb/vial-qmk-swoop>

### Compiled Vial Firmware

{% file src="/files/4X2KTBHFtyYIxDSVhRoj" %}

### Compiled Vial Firmware for RP2040-based boards

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

## Quick Build Guide (Wired with Basic Components)

### Diodes

The diodes are directional. Extra flux will be helpful.

<figure><img src="/files/aZHtusvt5OecznQOrQ0R" alt=""><figcaption><p>Bottom of the Left Hand Side</p></figcaption></figure>

### Jumpers

Bridge the jumpers for the microcontroller breakout board. Make sure the correct side is used.

<figure><img src="/files/56xyOJf1MUC3NjDbMcTm" alt=""><figcaption><p>Top of the Left Hand Side</p></figcaption></figure>

### The Microcontroller, TRRS Jack and Reset button

Solder the microcontroller with the pin headers or sockets. Make sure it's the correct side and align the pins correctly. For Sea-Picro, do not solder the D+ and D- pin.

<figure><img src="/files/cejhNDwWzygw6lvBrln9" alt=""><figcaption><p>Top of the Left Hand Side</p></figcaption></figure>

## Test the Key Presses

When you connect the left side to the computer, short the hotswap socket pads to trigger key presses with a wire or a pair of tweezers.

### Solder the Right Side

Repeat the above steps for the right hand side. Test the keyboard by connecting the TRRS cable, and the left hand side to the computer. As a reminder, do not plug/unplug the TRRS cable when the keyboard is powered.

### Hotswap Sockets

After testing both sides, solder the hotswap sockets.

<figure><img src="/files/jzH14tFjp1uzAju0Zga0" alt=""><figcaption><p>Bottom of the Left Hand Side</p></figcaption></figure>

### Final Photos

Although Sea Picro provides 3.3V, the RGB LEDs might still work. It's not guaranteed that the RGB LEDs will always work with 3.3V.  It's recommended to power the RGB LEDs with 3.7V-5V with Sea Micro.&#x20;

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

<figure><img src="/files/vacHeEZc5gAWv4l32rK6" 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/swoop-keyboard.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.