Skip to content

Commit 1e8a39e

Browse files
daysgobyedaysgobye
committed
unicorne pcb
1 parent 54cb651 commit 1e8a39e

File tree

1 file changed

+127
-0
lines changed

1 file changed

+127
-0
lines changed

‎guides/unicorne_pcb.md‎

Lines changed: 127 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,127 @@
1+
---
2+
title: Guide to the Unicorne PCB
3+
description: Everything you need to know about the Unicorne PCB by Boardsource.
4+
author: Boardsource
5+
product_link: https://boardsource.xyz/store/unicorne-pcb
6+
subcategory: easy
7+
draft: true
8+
tags:
9+
- building
10+
- programming
11+
- learning
12+
banner: https://images.boardsource.xyz/unicorne_pcb_banner.png
13+
thumbnail: https://images.boardsource.xyz/unicorne_pcb_thumbnail.png
14+
---
15+
16+
# Introduction
17+
18+
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.
19+
20+
## Key Features
21+
22+
The Unicorne PCB boasts a wide range of features that set it apart from other keyboards. Here's what you can expect:
23+
24+
* **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.
25+
26+
* **RP2040 MCU:** Each side of the Unicorne PCB is powered by an RP2040 microcontroller, providing ample processing power for advanced features and customization.
27+
28+
* **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.
29+
30+
* **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.
31+
32+
* **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.
33+
34+
* **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.
35+
36+
* **Joystick Support:** Each side of the Unicorne PCB has a dedicated joystick input, making it a great choice for gaming or navigating menus.
37+
38+
* **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.
39+
40+
* **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.
41+
42+
* **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.
43+
44+
## Pin Configuration
45+
46+
Here is the pin configuration for the Unicorne PCB:
47+
48+
![Unicorne PCB Pinout](https://images.boardsource.xyz/unicorne_pcb_pinout.jpg)
49+
50+
### **Left Half**
51+
52+
| Pin Name | Python Name | Function |
53+
|----------|-------------|------------------------------|
54+
| gpio0 | TX | Split Com |
55+
| gpio1 | RX | Split Com (defaults disabled)|
56+
| gpio2 | GP02 | Column 0 |
57+
| gpio3 | GP03 | Column 1 |
58+
| gpio4 | GP04 | Column 2 |
59+
| gpio5 | GP05 | Column 3 |
60+
| gpio6 | GP06 | Column 4 |
61+
| gpio7 | GP07 | Column 5 |
62+
| gpio8 | GP08 | Encoder A (MX Only) |
63+
| gpio9 | GP09 | Encoder B (MX Only) |
64+
| gpio14 | GP14 | Row 0 |
65+
| gpio15 | GP15 | Row 1 |
66+
| gpio16 | GP16 | Row 2 |
67+
| gpio17 | GP17 | Row 3 |
68+
| gpio18 | GP18 | Command Pin |
69+
| gpio22 | GP22 | OLED SDA |
70+
| gpio23 | GP23 | OLED SCL |
71+
| gpio25 | GP25 | SPI CS |
72+
| gpio26 | GP26 | Joystick X & SPI SCK |
73+
| gpio27 | GP27 | Joystick Y & SPI TX |
74+
| gpio29 | GP29 | RGB LED Control |
75+
76+
### **Right Half**
77+
78+
| Pin Name | Python Name | Function |
79+
|----------|-------------|------------------------------|
80+
| gpio0 | TX | Split Com |
81+
| gpio1 | RX | Split Com (defaults disabled)|
82+
| gpio2 | GP02 | Column 0 |
83+
| gpio3 | GP03 | Column 1 |
84+
| gpio4 | GP04 | Column 2 |
85+
| gpio5 | GP05 | Column 3 |
86+
| gpio6 | GP06 | Column 4 |
87+
| gpio7 | GP07 | Column 5 |
88+
| gpio8 | GP08 | Encoder A (MX Only) |
89+
| gpio9 | GP09 | Encoder B (MX Only) |
90+
| gpio14 | GP14 | Row 0 |
91+
| gpio15 | GP15 | Row 1 |
92+
| gpio16 | GP16 | Row 2 |
93+
| gpio17 | GP17 | Row 3 |
94+
| gpio18 | GP18 | Command Pin |
95+
| gpio22 | GP22 | OLED SDA |
96+
| gpio23 | GP23 | OLED SCL |
97+
| gpio25 | GP25 | SPI CS |
98+
| gpio26 | GP26 | Joystick X & SPI SCK |
99+
| gpio27 | GP27 | Joystick Y & SPI TX |
100+
| gpio28 | GP28 | Buzzer Control (Right) |
101+
| gpio29 | GP29 | RGB LED Control |
102+
103+
104+
## Case Compatibility
105+
106+
The Unicorne PCB is designed to fit seamlessly into compatible cases. Below is a list of cases that are compatible with the Unicorne PCB:
107+
108+
* **MX Cases:**
109+
- [Unicorne MX Case](https://boardsource.xyz/store/unicorne-mx)
110+
- [FR4 Corne Case](https://boardsource.xyz/store/corne)
111+
112+
* **LP Cases:**
113+
- [Unicorne LP Case](https://boardsource.xyz/store/unicorne-lp)
114+
- [Corne LP](https://boardsource.xyz/store/technik-case)
115+
- [FR4 Corne Case](https://boardsource.xyz/store/corne)
116+
117+
118+
## Getting Creative
119+
120+
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:
121+
122+
* **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.
123+
124+
* **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.
125+
126+
## Notes
127+

0 commit comments

Comments
 (0)