Quick Start, Keymap & Firmware

After assembling the keyboard, or receiving a pre-soldered keyboard, it is possible to start using it without the 3.7V lithium batteries.

This keyboard is designed to be as flat as possible. When the USB-C connector is used, because of the cable, it is expected that the keyboard does not sit perfectly flat on the table.

Most users use this as a wireless keyboard without an always-connected USB-C cable, so this is not an issue. If you prefer the keyboard to stay flat while USB-C cable is connected, attach taller rubber feet to the bottom case or use a magnetic tenting stand.

Connect the left side to the computer with a USB data cable, but not a charging-only cable.

Connect the right side to the computer with a USB data or charging-only cable.

For charging, it is recommended to connect the keyboard to the computer. Do not use a power bank to charge the keyboard.

The right side connects to the left side via Bluetooth.

You should be able to type now.

Default Keymap

If you have a pre-soldered Toucan or download the firmware from the Toucan Repo (https://github.com/beekeeb/zmk-keyboard-toucan), here is the default keymap

ZMK Studio

To modify the keymap, ZMK studio can be used. It supports real-time updates, allowing you to apply changes instantly without the need to recompile or flash firmware to the device.

If you require more advanced features, compiling your own ZMK firmware is recommended.

To unlock the keyboard, press the middle key of the thumb cluster, followed by the key in the Z position.

Keymap Editor by Nick Coutsos

The latest version of Toucan firmware in (https://github.com/beekeeb/zmk-keyboard-toucan) also supports using the popular tool ZMK Keyap Editor.

ZMK Firmware

It is recommended to compile your own firmware. For your safety, always review, verify and understand the source code before compiling and flashing it.

Toucan Repo in GitHub

For your convenient, pre-compiled firmwares can be download from GitHub at https://github.com/beekeeb/zmk-keyboard-toucan/actions

Alternatively, a pre-compiled firmware can be downloaded here.

425KB

toucan-firmware-f4269af.zip

archive

Open

SHA256 of version f4269af: 976cdb523e7d3bf05e5f68911e76c7b185254c7c32b4f9a2ac347cfc55db0a49

Toucan with Prospector

The Prospector can be used as a ZMK bluetooth dongle (firmware created by Carrefinho https://github.com/carrefinho/prospector) or a scanner (firmware created by Ogura san in https://github.com/t-ogura/zmk-config-prospector)

Feature	Prospector as a ZMK Dongle	Prospector as a ZMK Scanner
Photo
Connection	The Prospector sits between the computer device and Toucan keyboard. The Toucan keyboard connects to the Prospector Dongle via Bluetooth. The dongle connects to your computer device via USB-C cable.	The Prospector working as a scanner. It doesn't require to connect to your computer device. It listens to the "status updates" of your Toucan keyboard and display them in the screen.
Benefit	Your computer device doesn't require to have bluetooth feature (or sometimes, bluetooth connection is not allowed in the computer for security reasons) to use the wireless Toucan keyboard.	It acts as an additional display to your Toucan keyboard. Your Toucan keyboard still works if you forget to bring the Prospector with you.
Firmware	prospector-dongle branch: https://github.com/beekeeb/zmk-keyboard-toucan/tree/prospector-dongle	prospector-scanner branch: https://github.com/beekeeb/zmk-keyboard-toucan/tree/prospector-scanner

Firmware Flashing

1. Flash the Left Side

Begin by flashing the left-side firmware to one of the Seeed Studio XIAO nRF52840 Plus modules.

• Connect the XIAO nRF52840 Plus to your computer using a data-capable USB cable.

• Double-tap the RST button to enter UF2 bootloader mode.

Note: The RST button is located on the XIAO module. If the keyboard case is already assembled, gently support the acrylic plate while double-pressing the button located near the USB-C connector.

• Confirm the Drive: Depending on your operating system, a drive named starting with "XIAO" will mount automatically.

• Copy the UF2 File: Drag and drop (or copy) the left-hand UF2 file into the mounted drive.

Troubleshooting the Connection: If the drive does not appear, ensure you are using a data-transfer cable rather than a charge-only cable. If you purchased or received the "beekeeb" branded 2-in-1 USB cable (C-C and A-C), it is recommended for this process. Additionally, check your system settings, as user permission may be required to mount external drives.

2. Verification

• The flashing process takes approximately 5–10 seconds.

• You may see a warning regarding "Disk Not Ejected Properly"; you can safely ignore this.

• The copied UF2 file will not be visible within the drive after the transfer—this is normal behavior.

• Disconnect the XIAO module and reconnect it. Confirm that the LED flashes twice rather than cycling through a blue-red-green loop.

3. Flash the Right Side

Repeat the steps above for the second XIAO module using the right-hand firmware. After reconnecting the module to your computer, verify that the LED also flashes twice to confirm a successful installation.

Next Steps

You might want to install batteries, and start making your own keymap.