G-Code keeb

A simple keyboard to move your 3D printer toolhead. The layout of both the keyboard and the custom keycaps is heavily inspired on Pronterface. This keyboard is meant to be used with Klipper, taking advantage of its multi-microcontroller capabilities.

FAQ

  • Why?

Because I'm lazy and I want a better interface to deal with toolhead movement when I'm standing near my 3D printer. Moving to the computer to use a web interface, or using the LCD menu (when available) takes time, with this keyboard I can just press a button.

  • Where is the USB connector? (Cherry MX 32U4 version)

I broke it down to a Dupont connector, that gives the user more flexibility to manage the cable.

  • Why an ATmega32U4-AU version if you are also adding the Raspberry Pi Pico as microcontroller?

Because I already have some that I bought years before the current components shortage, and since they are already available I might as well use them. However, if you are going to build one for yourself, I highly recommend going with one of the Pico versions, as it already have an USB connector and doesn't require any additional components soldered on the board other than the switches themselves.

  • Why have you chosen the CERN Open Hardware Licence?

Because as much as I love the GPL, it was created for Open Source Software. Open Source Hardware is an entirely different beast, with very different concerns and needs to be attended, there's even an article concerning that on the GNU website. This is my first Open Source Hardware project that is in full compliance with the CERN-OHL-S v2 licence, I have others licensed with earlier versions that need to be upgraded and modified to be fully compliant, but that's off-topic.

TODO

  • Add instructions on how to flash the ATmega32U4/Raspberry Pi Pico microcontroller with Klipper
  • Add instructions on how to configure Klipper to take advantage of this keyboard
  • Design a case for all versions

UPDATES

May 19th, 2022: Initial public release.

May 21st, 2022: Added a tact switch version of the board, using a Raspberry Pi Pico as the microcontroller. Because of that I also reorganized the repository a little bit.

May 22nd, 2022: Corrected some mistakes on the design of the Cherry MX 32u4 version, added the Cherry MX Pico version, made some other small fixes (specially on silkscreen on all boards), and management chores.

May 24th, 2022: Fixed some more silkscreen mistakes. It never ends.

June 20th, 2022: Added a recommendation for the Raspberry Pi Pico versions. I have built the 32u4 version, and after many struggles to build it and make it work, it's just easier (and cheaper) going with the Pico.


© G-Code keeb 2022.
This documentation describes Open Hardware and is licensed under the CERN Open Hardware Licence version 2 - Strongly Reciprocal.
You may redistribute and modify this documentation under the terms of the CERN-OHL-S v2. (http://ohwr.org/cernohl). This documentation is distributed WITHOUT ANY EXPRESS OR IMPLIED WARRANTY, INCLUDING OF MERCHANTABILITY, SATISFACTORY QUALITY AND FITNESS FOR A PARTICULAR PURPOSE. Please see the CERN-OHL-S v2 for applicable conditions.