💾 Archived View for m0yng.uk › 2022 › 03 › koda-keyboard captured on 2022-04-28 at 17:40:17. Gemini links have been rewritten to link to archived content
-=-=-=-=-=-=-
Created 2022-03-12
Small 4 row by 12 keyboard with black square key caps with white lettering and a pink glow [IMG]
I needed to get PCB(s) made, which isn't something I've done before. I went with JLCPCB on the basis that people like Big Clive dot com use them. The process wasn't too complex, but I did end up guessing on some options (like surface finish) or just picking based on price. In the end I ordered:
Now, when Great Scott says his JLCPCB order came within the week, I suspect he gets the special sponsor treatment.
My timeline was:
The PCBs themselves seem to be of good quality, and the one I have used works fine. I'd buy from them again.
The PCBs themselves cost £18.74 and the cheapest shipping was £19.15 for a total of £37.89 or about £2.53 per board. Did I need 15? No. Did it change the total price much? Also no. On that note, if you are in the UK and want one, let me know!
I got the rest of the stuff from mechboards in the UK, and it wasn't cheap!
The total with shipping was **£115**!
1: https://mechboards.co.uk/products/throughhole-diodes
2: https://mechboards.co.uk/products/pro-micro-5v
3: https://mechboards.co.uk/products/24-pin-pro-micro-sockets
4: https://mechboards.co.uk/products/mill-max-socket-pins
5: https://mechboards.co.uk/products/kailh-low-profile-choc-switches-v1-brown?variant=40330408198349
6: https://mechboards.co.uk/products/work-louder-choc-keycaps-daily-set
I then got to test their support. The first set of keycaps I received had two "D" keys, and no "C". They asked me to post the set back and replaced it once they received them, which was slow but ok I guess.
However, when I went to install the keycaps I realised that I had no down key! In the pack it looked like a down key, but it was actually a left/right that had been rotated 90, and as the keycaps can only be installed one way (well, also upside down) I don't currently have a down arrow key. Luckily the set has a few dots that I can borrow, whilst I wait for mechboards to decide what to do next.
I don't have many photos of this because I was doing it between other things, and after waiting this long I was keen to get it working!
The process is fairly simple,
1. Snip the socket into just the side rails so we can fit the controller
2. Shove the pins into the socket and position them into the controller - with the USB side towards the PCB
3. Solder the pins into the controller
4. Solder all the diodes to the under side of the PCB
5. Solder the socket to the underside of the PCB
6. Solder all the switches - beware of bent pins!
Later I used some brass M2 standoffs and screws with another PCB and some sticky feet to make a more robust (no exposed diodes and microcontroller) setup.
I had to do the initial flash with the microcontroller not installed, so I could reach the reset button, or you can short `RST` to `GND` using a screwdriver.
I cloned the penkkesu repo and copied the keyboard stuff into `~/qmk_firmware/keyboards/penkesu`
From there I could `cd` into `~/qmk_firmware/keyboards/penkesu/keymaps/default` and run
qmk compile qmk flash
Once you have QMK installed getting the keyboard into flash mode is simply a case of holding the top left and bottom left keys when connecting it to the computer, in this case `esc` and the bottom left dot.
Obviously I had to make some tweaks! So far just two...
Odd-rocket says
koda has no leds. two extra data pins with GND and VCC were broken out for RGB underlighting.
These are the four through holes in a line below the controller.
I connected some addressable RGB LED tape to the top data connection and made the following configuration changes;
# config.h /* Define pins etc. for RGB lights */ #define RGB_DI_PIN C6 /* specify physical data pin */ #define RGBLED_NUM 12 /* specify number of LEDs */ #define RGBLIGHT_ANIMATIONS #define RGBLIGHT_SLEEP /* turn LEDs off when host sleeps */
# rules.mk BACKLIGHT_ENABLE ?= no # Enable keyboard backlight functionality RGBLIGHT_ENABLE ?= yes # Enable RGB LEDs
# keymaps/default/keymap.c # In the third KEYMAP (the "raise" key on penkesu, to the right of space) on the second row (tab, a, s, d, f) RGB_TOG, RGB_MOD, RGB_HUI, RGB_SAI, RGB_VAI,
This lets to turn the RGB on/off `RGB_TOG`, change the mode `RGB_MOD`, then change the Hue, Saturation, and Intensity/Brightness.
These settings are remembered between use.
It looks good, making the middle of the board glow, but it doesn't help identify keys in the dark.
the keyboard in the dark with purple glow, some letters are slightly visible [IMG]
So far my only changes have been
It would be nice to have function keys too...
I'm using it now, as a stand-alone keyboard. I've never used an ortholinear keyboard before so it is taking some getting used to the layout.
I like the switches, they feel good and sound good. I like the keycaps, they look and feel nice. But they should for the price!
I've also not used QMK before, and I didn't find it easy to get started. There seems to be a lot of older info out there, and there are many different keyboards and configurations possible, so it can be hard to pin down specifics. I've found the official documentation to be the best.
My build is pretty solid and looks nice, and I could pop it into a bag to bring with me easily enough, but it is going to take time to o get my typing speed back up!
Ultimately I still want to install this into the penkesu when I build it, but it is a nice keyboard on its own. Maybe I can have a passthrough on the penkesu so I can connect it to a host computer and just use the keyboard.
-+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+-
🖤 Black Lives Matter
💙🤍💜 Trans Rights are Human Rights
❤️🧡💛💚💙💜 Love is Love
Copyright © 2022 Christopher M0YNG
Code snippets are licenced under the Hippocratic License 3.0 (or later.)
Page generated 2022-04-27 by Complex 19
![Small 4 row by 12 keyboard with black square key caps with white lettering and a pink glow [IMG]](/kennedy.gemi.dev/archive/cached?url=gemini%3a%2f%2fm0yng.uk%2fimages%2f2022%2f03%2fkodaKeyboard.jpg&t=637867644170000000&raw=False){kind=link}
![underside of the keyboard PCB showing LED tape lit up in the middle and most of the width of the keyboard [IMG]](/kennedy.gemi.dev/archive/cached?url=gemini%3a%2f%2fm0yng.uk%2fimages%2f2022%2f03%2fkodaKeyboard-led.jpg&t=637867644170000000&raw=False){kind=link}
![the keyboard in the dark with purple glow, some letters are slightly visible [IMG]](/kennedy.gemi.dev/archive/cached?url=gemini%3a%2f%2fm0yng.uk%2fimages%2f2022%2f03%2fkodaKeyboard-dark.jpg&t=637867644170000000&raw=False){kind=link}