/GuudBox

A custom hitbox for GP2040-CE, built with Gateron low profile switches.

GuudBox

GuudBox uses GP2040-CE firmware with custom key maps and layouts, here's related links you may need:

GP2040-CE GitHub page | GP2040-CE documentation

Sample Sample Sample

Hardwares

Screwdrivers and soldering iron are necessary to build this device!

Screwdrivers and soldering iron are necessary to build this device!

Screwdrivers and soldering iron are necessary to build this device!

Standard parts

Parts you need to purchase. All of these should be available in China Mainland.

Make sure you can get these parts (or compatible ones) before building!

Parts Quantity Shopping links for reference
Waveshare RP2040-Zero 1
Gateron low profile switches v2.0 18
Gateron low profile hotswap connectors 18
21mm MX switch compatible round keycaps 12 PUNK WORKSHOP
26mm MX switch compatible round keycaps 1 PUNK WORKSHOP
Standard MX switch keycaps 6 DEADLINE DOYS
6x6x10mm push button switches 2 LCSC
M3*13 locking screws 6 Taobao
M3*5 locking screws 5 Taobao
13x4mm round head silicone foot pads* 6 Taobao

*: Thickness should be greater than 0.5mm.

Custom parts

Parts Quantity Related files Remarks
Controller PCB 1 Gerber_GuudBox.zip 1.6mm thick
CNC / 3D printed bottom case 1 Bottom Case.STEP (for CNC) / Bottom Case.STL (for 3D printing)
CNC / laser cutted cover plate* 1 Cover Plate.STEP (for CNC) / Cover Plate.dxf (for laser cutting) 3mm thick

*: If you'd like to replace 21mm round keycaps with 26mm ones, use files in Alternative folder for cover plate.

MCU Soldering

The RP2040-Zero MCU board should be soldered on bottom side of the controller PCB with front side up. Make the position as accurate as possible to avoid conflicts with case.

Accessories

Wrist Rest

  • For CNC
Parts Quantity Related files / links
CNC wrist rest 1 Wrist Rest_CNC_low_profile.STEP
20x3mm round head silicone foot pads* 4 Taobao

*: Thickness should be greater than 1mm.

  • For 3D printing
Parts Quantity Related files / links Remarks
3D printed wrist rest base part 1 Wrist Rest_3Dp_base_low_profile.STL
Laser cutted cover plate 1 Wrist Rest_3Dp_cover.dxf 3mm thick
20x3mm round head silicone foot pads* 8 Taobao

*: Thickness should be greater than 1mm.

Here's a sample of 3D printed wrist rest:

3D printed wrist rest 3D printed wrist rest

Customizations

Use files in Misc.

EasyEDA Pro is needed to edit .epro file.

Softwares

Firmwares are modified and compiled in AkariiinMKII/GuudBox-GP2040-CE.

Firmware Installation

  1. Download the firmware (.uf2 file) in release page.
  2. Hold BOOT buttom on MCU board when plugging your controller into a PC. A new removable drive named RPI-RP2 should appear in your file explorer.
  3. Drag and drop the firmware into the removable drive.
  4. Wait for the device to automatically disconnect.

Key Maps

Default key map in firmware, you can change it in Web Configurator > Configuration > Pin Mapping.

Key Map

Position GPIO Pin GP2040-CE XInput Switch PS4 PS3 DirectInput Arcade
1 14 L3 LS LS L3 L3 11 LS
2 15 R3 RS RS R3 R3 12 RS
3 26 A1 Guide Home PS PS 13 Home
4 27 A2 - Capture Touchpad - 14 -
5 28 S1 Back Minus Share Select 9 Coin
6 29 S2 Start Plus Options Start 10 Start
7 13 LEFT LEFT LEFT LEFT LEFT LEFT LEFT
8 12 DOWN DOWN DOWN DOWN DOWN DOWN DOWN
9 11 RIGHT RIGHT RIGHT RIGHT RIGHT RIGHT RIGHT
10 10 UP UP UP UP UP UP UP
11 8 B3 X Y Square Square 1 P1
12 6 B4 Y X Triangle Triangle 4 P2
13 4 R1 RB R R1 R1 6 P3
14 2 L1 LB L L1 L1 5 P4
15 9 B1 A B Cross Cross 2 K1
16 7 B2 B A Circle Circle 3 K2
17 5 R2 RT ZR R2 R2 8 K3
18 3 L2 LT ZL L2 L2 7 K4
19* 0 Fn Fn Fn Fn Fn Fn Fn
20** 1 Turbo Turbo Turbo Turbo Turbo Turbo Turbo

*: Disabled by default, enable the function in Web Configurator > Settings > Hotkey Settings before using.

**: Disabled by default, enable the function in Web Configurator > Configuration > Add-Ons Configuration > Turbo before using.

Configurations

Hold S2 (position 6 in default key map) when plugging your controller into a PC, and then visit http://192.168.7.1 in a web browser to access the Web Configurator.

It is strongly recommended to read the documentation before using the configurator.