Skip to the content
2 layers242.9 × 76.2 mmSg48key, the printed circuit board in 3D

USB HID keyboard firmware for tinygo

Size
242.9 × 76.2 mm
Copper layers
2
Thickness
1.6 mm
Parts
110
Nets
70
Pads
475
Tracks, vias
988, 27
Routed
Yes
KiCad
KiCad 7 (file 20221018)
Created
9 Dec 2022
Updated
1 Nov 2026

Overview

Sg48key 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 242.9 × 76.2 mm with 110 parts on 70 nets, routed with 988 tracks and 27 vias.

Its parts include 55 diodes, 47 switches 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.md

USB 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

Microcontrollers

The following microcontrollers are supported.

  • rp2040
  • nrf52840
  • samd51
  • samd21

Tutorial

Additional Resources

sgkb-0.4.0

text
# 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/
nameamount
Cherry MX / Kailh Choc V172
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 1N414872
xiao-rp20402
pin header 1x74
TRRS connector2
TRRS cable1

sg48key

text
tinygo flash --target xiao --size short --stack-size 8kb ./targets/sg48key/

sgh60

text
tinygo flash --target waveshare-rp2040-zero --size short --stack-size 8kb ./targets/sgh60/

wiokey-0.1.0

text
$ tinygo flash --target wioterminal --size short --stack-size 8kb ./targets/wiokey/
nameamount
Cherry MX / Kailh Choc V16
key cap6
diode 1N41486
wioterminal1
pin socket 2x202

sgkey-0.1.0

text
$ tinygo flash --target xiao-rp2040 --size short --stack-size 8kb ./targets/sgkey/
nameamount
Cherry MX / Kailh Choc V16
key cap6
diode 1N41486
xiao-rp20401
i2c ssd13061
register 10k ohm2

fric10key-0.1.0

text
$ tinygo flash --target xiao-rp2040 --size short --stack-size 8kb ./targets/fric10key/
nameamount
Cherry MX / Kailh Choc V127
key cap (1u)26
key cap (2u)1
Stabilizer (2u)1
diode 1N414827
xiao-rp20401

xiao-kb01

text
$ tinygo flash --target xiao-rp2040 --size short --stack-size 8kb ./targets/xiao-kb01/

Gopher Badge

text
$ tinygo flash --target gopher-badge --size short --stack-size 8kb ./targets/gopher-badge/

GoBadge / PyBadge

text
$ tinygo flash --target gobadge --size short --stack-size 8kb ./targets/gobadge

MacroPad RP2040

text
$ 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.

text
$ tinygo flash --target wioterminal --size short  --tags reset_to_default ./targets/wiokey

Note

  • Basically, the --stack-size 8kb settings is required.
  • If changing the version of tinygo-keyboard causes it to not work properly, please perform the Restore default keymap procedure.

LICENSE

MIT

Parts

110
QtyValueFootprintReferences
551N4148foostan/kbd:D3_SMD_v2D1, D2, D10, D11, D12, D13, D14, D17, D18, D19, D20, D21, D22, D25, D26, D27 +39
47SW_PUSHfoostan/kbd:CherryMX_HotswapS0, S1, S2, S10, S11, S12, S13, S14, S15, S16, S17, S18, S19, S20, S21, S22 +31
6MountingHolexiao:hole_2.5H1, H2, H3, H4, H5, H6
1102010388xiao:MODULE_102010388U1
1~xiao:RKJXV122400RU2

More from sago35/tinygo-keyboard

7
  • 2 layers285 × 94.6 mmSgh60, the printed circuit board in 3D

    Sgh60

    sago35/tinygo-keyboard

    USB HID keyboard firmware for tinygo

    155 parts119MIT
  • 2 layers174 × 96 mmSgkb right, the printed circuit board in 3D

    Sgkb right

    sago35/tinygo-keyboard

    USB HID keyboard firmware for tinygo

    100 parts119MIT
  • 2 layers134 × 96 mmSgkb, the printed circuit board in 3D

    Sgkb

    sago35/tinygo-keyboard

    USB HID keyboard firmware for tinygo

    75 parts119MIT
  • 2 layers77 × 140 mmFric10key, the printed circuit board in 3D

    Fric10key

    sago35/tinygo-keyboard

    USB HID keyboard firmware for tinygo

    63 parts119MIT
  • 2 layers90 × 90 mmXiao kb01, the printed circuit board in 3D

    Xiao kb01

    sago35/tinygo-keyboard

    USB HID keyboard firmware for tinygo

    55 parts119MIT
  • 2 layers91 × 55 mmSgkey, the printed circuit board in 3D

    Sgkey

    sago35/tinygo-keyboard

    USB HID keyboard firmware for tinygo

    22 parts119MIT
  • 2 layers126 × 57 mmWiokey, the printed circuit board in 3D

    Wiokey

    sago35/tinygo-keyboard

    USB HID keyboard firmware for tinygo

    16 parts119MIT

Similar boards

  • 2 layers130 × 169.5 mmBsl array v1, the printed circuit board in 3D

    Bsl array v1

    jackw01/scanlight

    A better light source for scanning color negative film

    110 parts397CERN-OHL-W-2.0
  • 2 layers141.5 × 83 mmRolio, the printed circuit board in 3D

    Rolio

    MickiusMousius/Rolio46Keyboard

    A split wireless keyboard based on the Corne and Sofle

    110 parts236MIT
  • 2 layers277.2 × 107.5 mmCorne V4 Pro Micro Edition, the printed circuit board in 3D

    Corne V4 Pro Micro Edition

    klouderone/CorneV4ProMicroEdition

    The Corne V4 with Pro Micro Micocontrollers, made specifically for beginners and support for wireless microcontrollers

    110 parts208CC-BY-4.0
  • 2 layers134.6 × 208.3 mmTs2, the printed circuit board in 3D

    Ts2

    jefftranter/68000

    Code related to the Motorola 68000 microprocessor.

    110 parts133
  • 2 layers126.2 × 100 mmQuantizer pcb, the printed circuit board in 3D

    Quantizer pcb

    QuinnFreedman/modular

    A collection of free & open source DIY synthesizer module designs for Eurorack

    110 parts116
  • 2 layers244.2 × 112 mmChoctopus44, the printed circuit board in 3D

    Choctopus44

    SlightHeadache/choctopus44

    Choctopus44 is a custom low profile keyboard

    110 parts99
  • 2 layers100 × 100 mmCarte FX 0, the printed circuit board in 3D

    Carte FX 0

    PhysicsDptAngers/polyUAnalog

    Open source, analog and polyphonic synthesizer

    110 parts88MIT

Questions

How big is the Sg48key PCB?

It measures 242.9 × 76.2 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Sg48key use?

110 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 Sg48key KiCad files?

From the sago35/tinygo-keyboard repository on GitHub, at the commit this page was made from: the board is kicad/sg48key/sg48key/sg48key.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 Sg48key 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).