

USB HID keyboard firmware for tinygo
- Size
- 91 × 55 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 22
- Nets
- 20
- Pads
- 98
- Tracks, vias
- 92, 5
- Pours
- 1
- Routed
- Yes
- KiCad
- KiCad 7 (file 20221018)
- Created
- 9 Dec 2022
- Updated
- 1 Nov 2026
Overview
Sgkey is an open-source printed circuit board by sago35, from the sago35/tinygo-keyboard repository on GitHub, published under the MIT licence. It is a 2-layer board of 91 × 55 mm with 22 parts on 20 nets, routed with 92 tracks and 5 vias.
Its parts include 6 diodes, 6 switches, 2 resistors and 2 ICs. It belongs with the keyboards and input boards and the RP2040, nRF52 and nRF5x and SAM D and SAM boards of this library.
README
README.mdUSB HID Keyboard firmware for TinyGo
The API is not yet fixed.

The following are supported.
- key input
- squared matrix scan
- matrix scan
- duplex-matrix scan
- rotary encoder
- GPIO
- UART
- Shifter (tinygo.org/x/drivers/shifter)
- layer feature by mod key
- mouse click / mouse wheel
- support TRRS (UART)
- support Vial
- Keymap
- Layers (MO(x), TO(x))
- Matrix testers
- Macros
- Mod-Tap
- Modifier Keys
- Combos
Microcontrollers
The following microcontrollers are supported.
- rp2040
- nrf52840
- samd51
- samd21
Tutorial
Additional Resources
sgkb-0.4.0

# sgkb-0.4.0
$ tinygo flash --target xiao-rp2040 --size short --stack-size 8kb ./targets/sgkb/left/
$ tinygo flash --target xiao-rp2040 --size short --stack-size 8kb ./targets/sgkb/right/
# sgkb-0.3.0 or before
$ tinygo flash --target xiao-rp2040 --size short --stack-size 8kb ./targets/sgkb/left-0.3.0/
$ tinygo flash --target xiao-rp2040 --size short --stack-size 8kb ./targets/sgkb/right/- files
- ./kicad/sgkb for KiCad 7.0
- KiCanvas : sgkb-0.4.0 left
- KiCanvas : sgkb-0.4.0 right
- KiCanvas : sgkb-0.3.0 left
- KiCanvas : sgkb-0.3.0 right
- ./kicad/sgkb for KiCad 7.0
| name | amount |
|---|---|
| Cherry MX / Kailh Choc V1 | 72 |
| key cap (1u) | 68 |
| key cap (1.5u) | 1 |
| key cap (1.75u) | 1 |
| key cap (2u) | 1 |
| key cap (ISO-ENTER) | 1 |
| Stabilizer (2u) | 2 |
| diode 1N4148 | 72 |
| xiao-rp2040 | 2 |
| pin header 1x7 | 4 |
| TRRS connector | 2 |
| TRRS cable | 1 |
sg48key

tinygo flash --target xiao --size short --stack-size 8kb ./targets/sg48key/- files
- ./kicad/sg48key
- KiCanvas : sg48key
- ./kicad/sg48key
sgh60

tinygo flash --target waveshare-rp2040-zero --size short --stack-size 8kb ./targets/sgh60/- files
- ./kicad/sgh60
- KiCanvas : sgh60
- ./kicad/sgh60
wiokey-0.1.0

$ tinygo flash --target wioterminal --size short --stack-size 8kb ./targets/wiokey/- files
- ./kicad/wiokey for KiCad 7.0
- KiCanvas : wiokey
- ./kicad/wiokey for KiCad 7.0
| name | amount |
|---|---|
| Cherry MX / Kailh Choc V1 | 6 |
| key cap | 6 |
| diode 1N4148 | 6 |
| wioterminal | 1 |
| pin socket 2x20 | 2 |
sgkey-0.1.0

$ tinygo flash --target xiao-rp2040 --size short --stack-size 8kb ./targets/sgkey/- files
- ./kicad/sgkey for KiCad 7.0
- KiCanvas : sgkey
- ./kicad/sgkey for KiCad 7.0
- build guide
| name | amount |
|---|---|
| Cherry MX / Kailh Choc V1 | 6 |
| key cap | 6 |
| diode 1N4148 | 6 |
| xiao-rp2040 | 1 |
| i2c ssd1306 | 1 |
| register 10k ohm | 2 |
fric10key-0.1.0

$ tinygo flash --target xiao-rp2040 --size short --stack-size 8kb ./targets/fric10key/- files
- ./kicad/fric10key for KiCad 7.0
- KiCanvas : fric10key
- ./kicad/fric10key for KiCad 7.0
| name | amount |
|---|---|
| Cherry MX / Kailh Choc V1 | 27 |
| key cap (1u) | 26 |
| key cap (2u) | 1 |
| Stabilizer (2u) | 1 |
| diode 1N4148 | 27 |
| xiao-rp2040 | 1 |
xiao-kb01

$ tinygo flash --target xiao-rp2040 --size short --stack-size 8kb ./targets/xiao-kb01/- files
- ./kicad/xiao-kb01 for KiCad 7.0
- KiCanvas : xiao-kb01
- ./kicad/xiao-kb01 for KiCad 7.0
Gopher Badge

$ tinygo flash --target gopher-badge --size short --stack-size 8kb ./targets/gopher-badge/- schema
GoBadge / PyBadge
$ tinygo flash --target gobadge --size short --stack-size 8kb ./targets/gobadgeMacroPad RP2040

$ tinygo flash --target macropad-rp2040 --size short --stack-size 8kb ./targets/macropad-rp2040/Restore default keymap
Set the key with the key code of 0x7C03, and then press it.
Then a reset will restore the default keymap.
See #8.
Restore default keymap (tinygo flash)
Restore default keymap each time it is reset by specifying --tags reset_to_default.
Note that in this setting, any changes made from Vial or other sources will immediately revert to the original setting.
$ tinygo flash --target wioterminal --size short --tags reset_to_default ./targets/wiokeyNote
- Basically, the
--stack-size 8kbsettings is required. - If changing the version of tinygo-keyboard causes it to not work properly, please perform the
Restore default keymapprocedure.
LICENSE
MIT
Parts
22| Qty | Value | Footprint | References |
|---|---|---|---|
| 6 | 1N4148 | Diode_THT:D_DO-35_SOD27_P7.62mm_Horizontal | D1, D2, D3, D4, D5, D6 |
| 6 | SW_PUSH | foostan/kbd:CherryMX_ChocV2_1u | SW1, SW2, SW3, SW4, SW5, SW6 |
| 4 | MountingHole | MountingHole:MountingHole_2.2mm_M2 | H1, H2, H3, H4 |
| 2 | LOGO | snapeda/xiao:tinygo-keyboard-qr | G***, G*** |
| 2 | R | Resistor_THT:R_Axial_DIN0204_L3.6mm_D1.6mm_P7.62mm_Horizontal | R1, R2 |
| 1 | 102010388 | snapeda/xiao:MODULE_102010388 | U1 |
| 1 | i2c-oled-display | snapeda/xiao:i2c-oled-display-0.96 | U2 |
More from sago35/tinygo-keyboard
7- 2 layers285 × 94.6 mm

- 2 layers242.9 × 76.2 mm

- 2 layers174 × 96 mm

- 2 layers134 × 96 mm

- 2 layers77 × 140 mm

- 2 layers90 × 90 mm

- 2 layers126 × 57 mm

Similar boards
- 2 layers158 × 11 mm

Daylight Matchstick
VoronDesign/Voron-Hardware
Cool Hardware designed by the Voron Design group
22 parts1.1kGPL-3.0 - 2 layers57 × 65 mm

Rgb to hdmi
hoglet67/RGBtoHDMI
Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI
22 parts1kGPL-3.0 - 2 layers81 × 57.2 mm

RP2040-Macropad
hackclub/OnBoard
💡 Join 1,000 teenagers and make your first PCB with a $100 grant!
22 parts915 - 2 layers54.6 × 70.9 mm

BeagleLogic Cape
abhishek-kakkar/BeagleLogic
A Software Suite that implements a logic analyzer with the PRU on the BeagleBone / BeagleBone Black.
22 parts479GPL-3.0 - 2 layers66.4 × 24.5 mm

Connecting piece
Chrismettal/flipper-zero-backpacks
Backpack-style addon boards for the Flipper Zero!
22 parts456 - 2 layers51 × 70 mm

- 2 layers19.7 × 19.7 mm

- 2 layers27.8 × 16 mm

Spi 1v8 level shifter
CRImier/MyKiCad
My KiCad boards. Can't be bothered uploading individually anymore, so here you go.
22 parts253GPL-3.0
Questions
How big is the Sgkey PCB?
It measures 91 × 55 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Sgkey use?
22 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
Where can I download the Sgkey KiCad files?
From the sago35/tinygo-keyboard repository on GitHub, at the commit this page was made from: the board is kicad/sgkey/sgkey/sgkey.kicad_pcb and its schematic kicad/fric10key/fric10key/fric10key.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Sgkey design in my own project?
Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).