Revision 2 of my original 3d printed Clueboard (https://www.thingiverse.com/thing:2897260).
Printing
Before printing, make sure to orient the pieces correctly. Flip the plate pieces upside down so there are no overhangs. For the base pieces, be sure to lay them flat on the build plate.
Example build logs
Hardware
- Controller e.g. Teensy 2++, Teensy 2.0, Pro Micro, etc...
- 66 * Diodes (I used 1N4148)
- 66 * Switches
- 4 * 2u plate mount Cherry stabiliser
- 1 * 6.25u plate mount Cherry stabiliser
- Keycaps (you'll need 2x 2.25u Shift caps as L and R shifts are same size or perhaps use the numpad 0 if you dgaf about spacing and profile)
- (Optional) 1 * Micro USB breakout PCB (https://cdn.thingiverse.com/renders/65/2e/69/13/38/c7da2202001ef3739c67954b4c9dbb31_preview_featured.jpg)
- 8 * 16 or 12mm M3 bolt and nut
- 8 * 20mm M3 bolt and nut
- Soldering gear
- (Optional) Sticky rubber feet
Using Teensy 2.0 is probably going to be the easiest as you won't have to make any modifications to source code. You can download the VIA firmware straight from the website and flash it.
Wiring
If you haven't hand wired a keyboard before, take a moment to look at qmk's hand wire guide.
Take a look at the qmk firmware and decide what kind of matrix you would like to do.
- rev1 has rows that go from one end of the board to the other which makes wiring simpler but you will need 21 pins which limits you to a Teensy2.0 or Teensy2++.
- rev3 has rows which split in the middle of the board. It is a little more confusing and messy to wire up but only requires 18 pins which is possible on an Arduino Pro Micro.
rev1
Board |
fw edit required? |
Teensy2++ |
Yes - change processor to at90usb1286 |
Teensy2.0 |
No |
Pro Micro |
Not compatible |
rev1 wiring diagram
See Gooberpsycho's make (https://www.thingiverse.com/make:849895).
rev3
Board |
fw edit required? |
Teensy2++ |
Yes - change processor to at90usb1286 |
Teensy2.0 |
No |
Pro Micro |
Yes - change pin numbers to match your wiring |
rev3 wiring diagram
Firmware
Please have a read of the qmk documentation on how to set up the qmk build environment.
VIA for Teensy2.0 and rev1 wiring
See Gooberpsycho's make (https://www.thingiverse.com/make:849895) for his VIA compatible firmware for Teensy2.0. Download it from the VIA website under handwired/3dp660.
VIA for Teensy2++ and rev3 wiring
If you are using a Teensy2++, I've got VIA working with some minor changes to rev4. Just edit info.js
and redefine the pins according to how you've wired it to your Teensy2++ and build with the via
keymap (qmk compile -kb clueboard/66/rev4 -km via
). VIA will detect it as a Clueboard 66% rev4. I've included a hex file in the files section which is built from my modified info.js
.
Pro Micro and rev3 wiring
You will need to edit info.js
and change the pin numbers according to how you have wired your board. I would just fork the rev4 firmware and work off that.
Changelog
Update 2021-10-17
Since posting this design, there's been a change to qmk which now uses json files to define keyboard layout and wiring. Please check the json file which has the layout and pins defined. Again, consider rev1 if you're using a bigger breakout board such as the teensy 2++.
I've also updated the design to hold a mini-B breakout board.
Update 2021-11-28
Uploaded clueboard_66_rev4_via_teensy2pp.hex
firmware which will enable VIA if you've used a Teensy2++ and wired it like rev3.