Introduction

The Unicorne PCB, designed by Boardsource, is a cutting-edge split keyboard PCB powered by an RP2040 microcontroller with 16MB of ROM on each side. This PCB is perfect for those looking to build a unique and feature-rich split keyboard. In this guide, we will cover all the essential information you need to make the most of your Unicorne PCB.

Key Features

The Unicorne PCB boasts a wide range of features that set it apart from other keyboards. Here's what you can expect:

• Split Design: The Unicorne PCB is split into two halves, making it an ergonomic choice for typists who want a comfortable and customizable typing experience.

• RP2040 MCU: Each side of the Unicorne PCB is powered by an RP2040 microcontroller, providing ample processing power for advanced features and customization.

• 16MB of ROM: With 16MB of ROM on each side, you have plenty of space for storing keymaps, macros, and even animations for OLED displays.

• OLED Support: The Unicorne PCB comes with pre-installed OLED headers, allowing you to easily add OLED screens to both halves of your keyboard. You can display current layer information, typing speed (WPM), keyboard status, or simply showcase cool art.

• RGB Perkey & Underglow The Unicorne PCB supports vibrant RGB per-key lighting for individual key customization and dynamic underglow lighting to illuminate your workspace in style.

• USB-C Connectivity: The Unicorne PCB uses USB-C to USB-C cables to connect the two halves, ensuring a stable and reliable connection between the split keyboard sections.

• Joystick Support: Each side of the Unicorne PCB has a dedicated joystick input, making it a great choice for gaming or navigating menus.

• Boot and Reset Switches: Conveniently located on the top of the PCB, labeled boot and reset switches make it easy to access and manage firmware updates and resets.

• Breakaway Outer Column: The Unicorne PCB's outer columns are breakaway, allowing you to create a 5-column Corne keyboard for a compact 30% keyboard design.

• Backwards Compatibility with Corne/CRKBD PCBs: The Unicorne PCB is fully backward compatible with the Corne/CRKBD PCB, ensuring that any case designed for the Corne will also fit the Unicorne seamlessly.

Pin Configuration

Left Half

Right Half

Case Compatibility

The Unicorne PCB is designed to fit seamlessly into compatible cases. Below is a list of cases that are compatible with the Unicorne PCB:

• MX Cases:
  • Unicorne MX Case
  • FR4 Corne Case
• LP Cases:
  • Unicorne LP Case
  • Corne LP
  • FR4 Corne Case

Getting Creative

One of the standout features of the Unicorne PCB is the exposed pins that allow for customization and hacking. You can take advantage of the following functionalities:

• Full-Color TFT Screens: While full-color TFT screens are not yet supported in Peg, they can be used with CircuitPython and QMK. These screens are perfect for displaying various information, animations, or even just cool art.

• I2C and ADC Lines: With access to I2C and three ADC lines, you have the flexibility to experiment and create custom functionalities or expand your keyboard's capabilities.

Notes on Programming

The Unicorne PCB comes pre-flashed with a QMK VIA map, to be used with VIA. You can use QMK Configurator to reprogram your keyboard.

Of course you can also swap over to BS-python and use PEG, here is guide on how to do that.

Lets Talk About Getting Into Bootloader

Unicorne PCBs come pre-flashed with QMK VIA firmware, so you have two convenient methods to access the bootloader. The first is to hold down the top left key while plugging it in (conventionally 'Esc' or 'Tab'). The second method is the tried-and-true approach: press and hold the boot switch, then the reset switch (while still holding BOOT), and finally release the boot switch.

You'll find clear labels for the boot and reset switches on the PCB. Just to reiterate, the boot switch is the rightmost one, and the reset switch is the leftmost on both sides of the PCB, they are not reflected.

This keyboard is equipped with an RP2040 microcontroller, eliminating the need for QMK Toolbox. As soon as you activate the bootloader, your keyboard will appear as a drive named "RPI-RP2," allowing you to effortlessly drag and drop your new keymap onto it. NOTE: Some operating systems will give you an error message, you can (usually) safely ignore it, the new keymap will generally have still transferred to the drive.

HELP! My Mouse Drifts!

On some systems users may face an issue where their mouse cursor will drift after the keyboard is plugged in. In order to eliminate this issue you simply need to turn off the feature in 'info.json'. This is the setting to chage:

"pointing_device": false,. example below:

    "features": {
        "audio": true,
        "bootmagic": true,
        "encoder": true,
        "extrakey": true,
        "mousekey": true,
        "nkro": true,
        "oled": true,
        "pointing_device": false,
        "rgb_matrix": true
    },

If you don't want to manipulate your configuration manually, and you still want to use VIA, you can use this pre compiled VIA map where joysticks have been turned off.

This is only a problem on some computers and only happen sometimes, do not feel like you need to do this by default. Only if you're noticing mouse cursor drift.