Guide to the Unicorne PCB

Guide to the Unicorne PCB

Written By: Boardsource

Category: guides - easy

Tags: building, programming, learning

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 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

Pin NamePython NameFunction
gpio0TXSplit Com
gpio1RXSplit Com (defaults disabled)
gpio2GP02Column 0
gpio3GP03Column 1
gpio4GP04Column 2
gpio5GP05Column 3
gpio6GP06Column 4
gpio7GP07Column 5
gpio8GP08Encoder A (MX Only)
gpio9GP09Encoder B (MX Only)
gpio14GP14Row 0
gpio15GP15Row 1
gpio16GP16Row 2
gpio17GP17Row 3
gpio18GP18Command Pin
gpio22GP22OLED SDA
gpio23GP23OLED SCL
gpio25GP25SPI CS
gpio26GP26Joystick X & SPI SCK
gpio27GP27Joystick Y & SPI TX
gpio29GP29RGB LED Control

Right Half

Pin NamePython NameFunction
gpio0TXSplit Com
gpio1RXSplit Com (defaults disabled)
gpio2GP02Column 0
gpio3GP03Column 1
gpio4GP04Column 2
gpio5GP05Column 3
gpio6GP06Column 4
gpio7GP07Column 5
gpio8GP08Encoder A (MX Only)
gpio9GP09Encoder B (MX Only)
gpio14GP14Row 0
gpio15GP15Row 1
gpio16GP16Row 2
gpio17GP17Row 3
gpio18GP18Command Pin
gpio22GP22OLED SDA
gpio23GP23OLED SCL
gpio25GP25SPI CS
gpio26GP26Joystick X & SPI SCK
gpio27GP27Joystick Y & SPI TX
gpio28GP28Buzzer Control (Right)
gpio29GP29RGB LED Control

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:

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 Programing

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.

And of course you can swap over to BS-python and use peg, here is guide on how to do that. then you can plug it into peg and let it take care of the rest.

Lets Talk About Getting Into The Bootloader

Since it comes preloaded with QMK firmware, you have two convenient methods to access the bootloader. The first is to hold down the top left key while plugging it in. The second is the tried-and-true approach: press and hold the boot switch, then the reset switch, 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.

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.