Skip to the content
2 layers76.2 × 95.2 mmNugMacro Keypad, the printed circuit board in 3D

Macropurd

Size
76.2 × 95.2 mm
Copper layers
2
Thickness
1.6 mm
Parts
51
Nets
53
Pads
208
Tracks, vias
540, 34
Pours
1
Routed
Yes
KiCad
KiCad 6 (file 20211014)
Created
31 Dec 2022
Updated
28 Dec 2023

Overview

NugMacro Keypad is an open-source printed circuit board by Sir-keet, from the Sir-keet/NugMacro-Keypad repository on GitHub, published under the MIT licence. It is a 2-layer board of 76.2 × 95.2 mm with 51 parts on 53 nets, routed with 540 tracks and 34 vias.

It is built around the ATMEGA32U4-AU. Its parts include 16 diodes, 8 capacitors, 6 resistors, 2 connectors and 2 switches. It belongs with the keyboards and input boards and the AVR (ATmega, ATtiny) boards of this library.

Main components

1

README

README.md

NugMacro-Keypad

This is my first (working)attempt at designing/assembling a keyboard from scratch. I'll try to include some issues I had, and how I resolved them for others to look at when troubleshooting their own designs, and for myself.

Preface/Disclaimer

For anyone reading this trying to troubleshoot their own project. If you have not realized this yet, especially if this is your first attemp at something like this, realize that troubleshooting will be the most time consuming part of this. After all, it's always a learning experince, and thats just the nature of it.

  • Disclaimer to anyone reading this. My understanding is that this project uses a bit of outdated components with the mcu, power connector, and daughterboard as theres definetely better MCU options and now better daughterboard options. I originally began this in 2020, so please don't use my schematic or parts list as a bible for building your own.

Learning How To Use KiCAD

  • The popular EDA of choice is KiCAD. It's free and not incredibly hard to learn.
  • YouTube videos worked best for me to get started.
  • Going through KiCAD's doc page is incredibly helpful for any issues videos can't help you solve.
  • Like with any new software, it's going to take a lot of time to really understand it, but try not to get discouraged.

Schematic Issues

  • Try to keep everything organized for yours, and others sake.
  • Flags are your friend for organization.
  • Try to look at it from the perspective of someone else every now and then. Noone wants to try to understand a shitty schematic, and if you take a long break from working on it, it's a pain in the ass to know what you were doing (Learned this the hard way).
  • For footprints and symbols, there are some great libraries from people like Ai03 and EBastler. You can learn to make your own, but for your first attempt theres not a whole lot of reason to do that to yourself.
  • When actually choosing your components, look at the datasheet for your chosen MCU. It's got everything you need to know for the basic requirements.

PCB Issues

  • If you already know how you want the outline of your PCB to look like, make sure your components will fit into this well to make it easy to route later.
  • For USB connections, route your data lines in a close to equal length, with no other traces under or over them.
  • Make your traces and layout look good. Your spending a lot of time to create this, and when you finally see the physical result, you want it to look intentional and thoughtful.
  • Try to keep your crystal close to your MCU, and keep other traces away from it if they don't need to be there. A ground fill around it is also good for reducing possible interference.
  • This took me longer to realize than it should have, but don't try to connect the ground net through a messy spiderweb of traces. Use a ground fill.
  • Orient your MCU in whatever way makes it easist, and prettiest, to route.

Adding Artwork

  • If you want, you can add drawings or other symbols/lettering to your silkscreen using something like SVG to Shenzen.

Manufacturing

  • I ordered my boards from JLCPCB.
  • When making the production files, there are plugins for KiCAD that can make this easier, but just make sure you verify it looks correct.
  • When selecting components for assmebly, make sure they are all correct. I had an issue from choosing a crystal at the correct speed, but wrong load.
  • I used this formula (CL = (C1 * C2) / (C1 + C2) + Cstray) for finding what load rating I needed for my crystal. C1 and C2 are the caps for your crystal and I used 5pF for my stray approximation.
  • For the love of god do not try to assemble the entire board yourself thinking it wont be that hard.
  • After you buy all the parts, ship everything, and assemble it. The time and money spent is not worth getting at least the majority of the board assembled form JLC.
  • Especially if you try to do this all with a soldering iron, it can definetly be done, but there is a Lot of room for mistakes
  • I did it thinking it would be good experince, and thinking it would be cool to do it all myself. It wasn't, mistakes are expensive, a lot can and did go wrong for me, and soldering experince will in no way make you immune to these mistakes.
  • Given all of that, it is kinda fun doing it all yourself.
  • And for components, I just uploaded my BOM to DigiKey and ordered from them.

Writing The Code

  • I'll add info on this later, sorry.

Case and Plate

  • If you 3D print this yourself, make sure you have a well calibrated printer.
  • I opted to use a piece of FR4 that I then lasercut to size.
  • You can use a plate generator like this one from swillkb to make it easier.
  • I am currently working on a walnut case for my board, but when designing your case. Make sure you account for your desired mounting style, and daughterboard or any additional components you may have.

Notes

  • I'll add some helpful links later.
  • I'll get these files organized a bit better/remove a good bit of junk soon.
  • Prob need to condense/organize this better.
  • If anyone has any questions about your own project or mine. Shoot me an email (Logan@Scootah.dev) and I'll do my best to give you a good answer.

UPDATE

Project is on hiatus for now, but if for whatever reason someone builds one of their own, qmk firmware is finished and if you want it just email me. P.S. I wired the OLED wrong so prob wanna put it on the correct pins if you make your own to save a headache.

Parts

51
QtyValueFootprintReferences
16D_SmallDiode_SMD:D_SOD-123D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, D16
40.1uFCapacitor_SMD:C_0805_2012MetricC3, C4, C5, C8
210KResistor_SMD:R_0805_2012MetricR5, R6
210kResistor_SMD:R_0805_2012MetricR1, R4
222Resistor_SMD:R_0805_2012MetricR2, R3
222pFCapacitor_SMD:C_0805_2012MetricC1, C2
1#1MX_Only:MXOnly-1U-NoLEDMX1
1#1bMX_Only:MXOnly-1U-NoLEDMX2
1#1cMX_Only:MXOnly-1U-NoLEDMX3
1#1dMX_Only:MXOnly-1U-NoLEDMX4
1#2MX_Only:MXOnly-1U-NoLEDMX5
1#2bMX_Only:MXOnly-1U-NoLEDMX6
1#2cMX_Only:MXOnly-1U-NoLEDMX7
1#2dMX_Only:MXOnly-1U-NoLEDMX8
1#3MX_Only:MXOnly-1U-NoLEDMX9
1#3bMX_Only:MXOnly-1U-NoLEDMX10
1#3cMX_Only:MXOnly-1U-NoLEDMX11
1#3dMX_Only:MXOnly-1U-NoLEDMX12
1#4MX_Only:MXOnly-1U-NoLEDMX13
1#4bMX_Only:MXOnly-1U-NoLEDMX14
1#4cMX_Only:MXOnly-2U-NoLEDMX15
110uFCapacitor_SMD:C_0805_2012MetricC7
116MHzCrystal:Crystal_SMD_3225-4Pin_3.2x2.5mmY1
11uFCapacitor_SMD:C_0805_2012MetricC6
1ATmega32U4-APackage_QFP:TQFP-44_10x10mm_P0.8mmU1
1Conn_01x04random-keyboard-parts:JST-SR-4J2
1Conn_01x04_Female_For_LCDConnector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_VerticalJ3
1RotaryEncoder_SwitchRotary_Encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mmSW2
1SW_Pushrandom-keyboard-parts:SKQG-1155865SW1

Similar boards

  • 2 layers243.2 × 106 mm3W6, the printed circuit board in 3D

    3W6

    weteor/3W6

    a small compact 3x5+3 split ortho keyboard

    113 parts488
  • 2 layers228.4 × 85 mmLeChiffre, the printed circuit board in 3D

    LeChiffre

    tominabox1/Le-Chiffre-Keyboard

    Great thanks goes to Jake at P3D for really making the case amazing and open sourcing his work. Check him out at P3Dstore.com

    105 parts183GPL-3.0
  • 2 layers228.6 × 76.8 mmSchwann Rev0.5b, the printed circuit board in 3D

    Schwann Rev0.5b

    The-Royal/The_Royal_Open-Source-Projects

    A Master Repository For All things Royal Made

    127 parts159MIT
  • 2 layers30 × 65 mmKeyboard mcu, the printed circuit board in 3D

    Keyboard mcu

    dpapavas/lagrange-keyboard

    A configurable, handwired, ergonomic keyboard

    26 parts137AGPL-3.0
  • 2 layers88.4 × 80 mmLHS Controller PCB, the printed circuit board in 3D

    LHS Controller PCB

    dmcke5/ZenDeck

    This is the second revision of my Mini PC based handheld Gaming PC! It is designed for a Beelink SER 5 Mini PC but could be adapted to other systems by changing the mounting brackets and outlet plate.

    76 parts133CERN-OHL-S-2.0
  • 2 layers259.5 × 89.1 mmSteno, the printed circuit board in 3D

    Steno

    crides/steno

    Embedded steno firmware + custom steno PCBs

    61 parts75MIT
  • 2 layers99.1 × 99.1 mmPower supply panelized, the printed circuit board in 3D

    Power supply panelized

    thebiguno/microcontroller-projects

    A home for a bunch of microcontroller projects which don't warrant their own repos.

    223 parts75
  • 2 layers323.9 × 95.1 mmUnSplit, the printed circuit board in 3D

    UnSplit

    swiftrax/UnSplit

    Ergo 40% mechanical keyboard with all components on the top with diodes arranged in an array

    110 parts68GPL-2.0

Questions

How big is the NugMacro Keypad PCB?

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

What parts does the NugMacro Keypad use?

51 parts, built around the ATMEGA32U4-AU. 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 NugMacro Keypad KiCad files?

From the Sir-keet/NugMacro-Keypad repository on GitHub, at the commit this page was made from: the board is NugMacro-Keypad.kicad_pcb and its schematic MX_Matrix.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the NugMacro Keypad 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).