Two-Key Keyboard Build Log Starts Small, But Thinks Big

January 23, 2021 by Donald Papp 3 Comments

Interested in making a custom keyboard, but unsure where to start? Good news, because [Jared]’s build log for an adorable “2% Milk” two-key mini-keyboard covers everything you need to know about making a custom keyboard, including how to add optional RGB lighting. The only difference is that it gets done in a smaller and cheaper package than jumping directly in with a full-size DIY keyboard.

[Jared] is definitely no stranger to custom keyboard work, but when he saw parts for a two-key “2% Milk” keyboard for sale online, he simply couldn’t resist. Luckily for us, he took plenty of photos and his build log makes an excellent tutorial for anyone who wants to get into custom keyboards by starting small.

The hardware elements are clear by looking at photos, but what about the software? For that, [Jared] uses a ~~Teensy~~ Pro Micro clone running QMK, an open source project for driving and configuring custom input devices. QMK drives tiny devices like the 2% Milk just as easily as it does larger ones, so following [Jared]’s build log therefore conveys exactly the same familiarity that would be needed to work on a bigger keyboard, which is part of what makes it such a great project to document.

Interested in going a little deeper down the custom keyboard rabbit hole? You can go entirely DIY, but there’s also no need to roll everything from scratch. It’s possible to buy most of the parts and treat the project like a kit, and Hackaday’s own [Kristina Panos] is here to tell you all about what that was like.

PinePhone Gets 3D Printed Mechanical Keyboard

December 3, 2020 by Tom Nardi 9 Comments

Do you remember when smartphones had real physical keyboards? Working the command line on some remote machine over SSH was a breeze, and you could even knock out a few lines of code if you were so inclined. But these days you’ve either got to lug around an external keyboard, or suffer through pecking out a few words per minute on a piece of glass. Doesn’t sound much like progress to us.

By the looks of it, [James Williams] doesn’t think so either. He’s designed a physical keyboard add-on that snaps onto the back of the PinePhone to deliver a proper, albeit condensed, typing experience. This is no repurposed BlackBerry board either; he’s created a custom mechanical keyboard that manages to fold into an incredibly small size thanks to resin printed keycaps and Kailh low profile switches. Other than the hand-drawn legends, it’s probably not a stretch to say this is a better keyboard than what many people have on their actual computers.

In addition to the 3D printed frame and Kailh switches, there’s also an Arduino Pro Micro onboard to communicate with the phone. Rather than use USB, the keyboard is wired to the I2C accessory port on the rear of the PinePhone. It sounds like [James] needs a little more time to polish his QMK build before its ready to release, so you might want to wait a bit before you start printing off your own copy of the parts.

Those following along with the development of the PinePhone know there’s supposedly an official keyboard accessory in the works, but who wants to wait when we’re so close to mobile Linux nirvana? Besides, we doubt it will be nearly as pleasant to type on as the board [James] has put together.

Porting QMK To A Cheap Mechanical Keyboard

October 4, 2020 by Tom Nardi 14 Comments

Over the last couple of years, we’ve seen an incredible number of DIY keyboard builds come our way. Some have had their switches nestled into laser-cut aluminum and others 3D printed plastic. They may be soldered together on a custom PCB, or meticulously hand-wired. But however they were built, they almost all shared one thing in common: they ran some variant of the open source QMK keyboard firmware.

But what if you just want to run an open firmware on the keyboard you picked up for $50 bucks on Amazon? That’s exactly where [Stephen Peery] found himself nine months ago with this DK63 gaming keyboard. Since so many of these small RGB LED mechanical keyboards are very similar to existing open source designs, he wondered what it would take to blow out the original firmware and replace it with a build of QMK.

While [Stephen] doesn’t have everything working 100% yet, he’s nearly reached the end of his epic reverse engineering journey. The first step was tearing apart the keyboard and identifying all the components it used, then pulling the original firmware out of the updater. From there, between Ghidra and Serial Wire Debug, he was able to figure out most of what the stock firmware was doing so he could replicate it in QMK.

According to his README, the RGB LEDs and Bluetooth functionality don’t currently work, but other than that it seems QMK is up and running. If you’re OK with those concessions, he has information on the page about flashing his build of QMK to the stock DK63 with the ST-Link V2 so you can give it a shot. Though you do so at your own risk; we wouldn’t recommend doing this on your only keyboard.

We’ve seen commercially manufactured keyboards running QMK before, but it usually involves completely replacing the original controller with new electronics. That [Stephen] got this all working on stock hardware so other owners can follow in his footsteps is really a considerable accomplishment.

[Thanks to Baldpower for the tip.]

40% Keyboard Build Is 100% Open Source

September 7, 2020 by Kristina Panos 21 Comments

[Blake]’s interest in building keyboards happened naturally enough — he was looking for a new project to work on and fell into the treasure chest that is the mechanical keyboard community. It sounds like he hasn’t built anything but keyboards since then, and we can absolutely relate.

This tidy 40% ortholinear is [Blake]’s third build, not including macro keebs. It’s based on an open source case and plate from Thingiverse, and uses an Arduino Pro Micro running the popular QMK firmware to read input from 47 Gateron blues and a rotary encoder.

We particularly like the double rainbow ribbon cable wiring method [Blake] used to connect each row and column to the controller. It looks beautiful, yes, but it’s also a great way to maintain sanity while programming and troubleshooting.

Keyboard builds can look daunting, even at 40% of standard size. But as [Blake] discovered, there are some really good guides out there with fantastic tips for hand-wiring in small spaces. And now there is another well-written guide with clear pictures to point to.

Looking to split from the standard rectangle form factor but don’t know what to go with? Divine your next clacker with this split keyboard finder.

Thanks for the tip, [jrdsgl]!

Breakaway Keyboard PCB Makes Customization A Snap

July 29, 2020 by Kristina Panos 18 Comments

Once upon a time, keyboards were something that you took with you from computer to computer, because most of them were built quite nicely. After a few dark decades of membrane keyboards being the norm, the rise of the mechanical keyboard community has shined a light on what is possible with open source designs. Anyone can join in, because quality clackers now exist on every level, whether you want to design the perfect split ortho with OLEDs, rotary encoders, and rear view mirrors, or just want to fork over some money and get to punching switches.

Break me off a piece of that candy bar keeb.

Building your own keyboard doesn’t have to be daunting. It can be as easy or as involved as you want. There’s still a fair amount of soldering simply because it’s a keyboard. But there are plenty of options if you don’t want to do a whole lot beyond soldering switches (or hot swap sockets!) and putting a case together.

Take for instance the JNAO (Just Need An Ortho) build that [Jared] just finished. It starts with a PCB and on-board controller, and the idea is to customize it from there. You’re left to 3D print, laser cut, or otherwise carve your own case and a plate to stabilize the key switches, and then get down to business deciding on switches and keycaps.

The interesting thing about the JNAO is the breakaway row of keys on the bottom. The standard grid is 12×5, but if you don’t need the dedicated number row along the top like [Jared], you’re not stuck with it. And you’re not stuck with the default layout, either. Flashing to a standard Planck layout didn’t go as easily as [Jared] might have liked, but we think he was wise to get the firmware squared away before ever turning on the soldering iron.

Don’t know what to do with such a small keyboard? They’re pretty much perfect for cyberdeck builds.

Vintage Keyboard Gets The QMK Treatment

June 19, 2020 by Tom Nardi 15 Comments

While nobody could deny that computing technology has some a long way in the last few decades, there are many out there who believe peak keyboard was sometime before the turn of the new millennium. They prefer the look, feel, and especially the sounds, of those classic keyboards to what passes for an input device these days. So much so that it’s not uncommon to see one of these old mammoths get freshened up and pushed into service with a modern computer.

Which is exactly what [Juan Pablo Kutianski] has done with his Compaq MX-11800. This keyboard, which is actually a branded version of the Cherry G80-11800, really stands out in a crowd. With an integrated trackball and a two-row arrangement for the function keys, it’s not hard to see why he’d want to show it off. But while the hardware itself was solid, the features and capabilities of this old school keyboard left something to be desired.

The solution was to replace the keyboard’s original electronics with a Teensy++2.0 running the popular QMK firmware. This not only made the keyboard USB, but allowed [Juan] to tweak things such as the trackball sensitivity and add in support for layers and macros. All of which can be managed through VIA, a graphical configuration tool for QMK.

As we’ve seen in so many projects, the combination of QMK running on the Teensy is a powerful tool for getting the most out of your keyboard. Whether breathing new life into a vintage piece of hardware or creating something truly custom like our very own [Kristina Panos] recently did, it’s definitely something to keep in mind if you’re considering any keyboard hacking.

The ABCs Of Adding QMK To A WASD Keyboard

May 5, 2020 by Kristina Panos 21 Comments

[Oleg] is a software engineer who appreciates a good keyboard, especially since coming over to the dark side of mechanical keebs. It’s true what they say — once you go clack, you never go back.

Anyway, before going full nerd with an ortholinear split ergo keyboard, [Oleg] had a nice little WASD with many upsides. Because the ErgoDox is oh so customizable, his use of the WASD had fallen by the wayside.

That’s because the ErgoDox can run QMK firmware, which allows the user to customize every key they see and add layers of functionality. Many people have converted all kinds of old keebs over to QMK by swapping out the native controller for a Teensy, and [Oleg] was sure it would work for the WASD.

[Oleg] got under the hood and found that the controller sits on a little removable board around the arrow keys and talks to the main PCB through two sets of double-row header pins. After some careful probing with a ‘scope, the controller board revealed its secrets and [Oleg] was able to set up a testing scheme to reverse engineer the keyboard matrix by connecting each row to an LED, and all the columns to ground. With next to no room for the Teensy, [Oleg] ended up strapping it to the back of the switch PCB and wiring it quite beautifully to the header pins.

With Teensy and QMK, it’s easy to make a keyboard any way you want, even if you’re all thumbs.