A QMK configurable keyboard

[DHowett]

I’m guessing @Kieran_Levin is talking about this EC host command. It’s not very ergonomic, and it has some limitations, but it does make it possible to perform limited key remapping.

One issue is that the function keys are permanently bound to their FN equivalents — if you make any key emit F8, that key will also emit monitor brightness up when FN is off. Same thing if you rebind what the key labeled F8 does: it will lose the ability to control monitor brightness as well.

I have some ideas that would make it possible to fully control FN mapping from within the OS, but I’m wary to commit to doing it because (1) support and (2) I don’t want to step on Kieran’s toes too much. Building too many things on top of the aforementioned document might make it hard for Framework to do new stuff.

[junaruga]

Finally a user did change the keyboard layout on the firmware level by using DHowett’s ec tool, and also changed the key caps too. Amazing!

Changed my keyboard layout in hardware to colemak!

Hi everyone, since @DHowett released his docs and tools for working with the framework EC, I’ve wanted to change the keyboard to my preferred layout, colemak. Today was the day! First I made sure I could remove a keyboard key without breaking it. Turns out it’s really easy, and I didn’t break a single one. I can send a video for anyone interested, but it’s basically just use the back of the provided screwdriver to pry up the top corners of the key until it pops off. [signal-2022-01-23-151732_…

[junaruga]

I just found GergoPlex, the compact 36 keys keyboard layout, and the thin (low profile) key-switches and key-caps are repairable and customizable. (The vendor’s website is under maintenance right now.)

GergoPlex – A Detailed Look At This Ultra-Minimal Mechanical Split Keyboard

This is what I want to see for Framework Laptop’s keyboard in the future. I realized that a thin keyboard is possible with reparability by watching the video. The zip keycaps like ZSA’s one are also useful to reduce the keys by customization. Right now I am practicing with ZSA’s Moonlander’s 36 keys keyboard layout.

[DHowett]

So, in my spare time I have been working on exactly¹ this². It’s been my daily driver for the past few months, and it seems to work great.

I’ve got one really big question though:

What does “QMK configurable” mean to you?

QMK is primarily a source code distribution, with hand-written and hand-tuned keyboard layouts developed in C. Consider nikchi’s frosty_flake customization, which is by no means unique in the qmk_firmware repository.

There are some graphical tools (open-source ones like config.qmk.fm and proprietary ones like ZSA’s Oryx), but each one of them produces a full flashable firmware image for your keyboard.

Since the keyboard on the Framework Laptop is controlled by the embedded controller, offering web-built full flash download seems very risky. The keyboard part of the firmware isn’t isolated and can’t be reflashed separately, so every time you change your keyboard layout you’re risking wearing out the flash or being left with an unbootable machine… and every keyboard layout change requires a full reboot of the laptop.

I have some thoughts (which I’m happy to go into) about how to proceed but before I do I’d love your take. What does it mean to you?

¹ It’s all in a branch of my fork of Framework’s EC code here, for those of you intrepid enough to try it.
² It has also been pulled out into its own separate repository.
³ The “stock” keymap represented in my fork is here; note how it resembles a QMK keymap.c.

[junaruga]

@DHowett

So, in my spare time I have been working on exactly¹ this². It’s been my daily driver for the past few months, and it seems to work great.

You are using a firmware-level customized keyboard layout by the QMK-like file. Cool project!

@DHowett

What does “QMK configurable” mean to you?

My expectations are

• There is one default keymap file that is equivalent to the Framework’s ANSI layout on the qmk_firmware repository. I think we don’t need to manage user-level keymap files such as “nikchi’s frosty_flake customization” on the repository.
• Users can create their own keymap file from the default keymap file by a tool such as “config.qmk.fm” or other tools.
• Users can flash “a” firmware from their customized keymap by a tool.
• Someone provides other keyboards (hardware or CAD file) with replaceable keyswitches and keycaps, and the keyboard layout like Moonlander’s one. Then users can replace each key.

@DHowett

Since the keyboard on the Framework Laptop is controlled by the embedded controller, offering web-built full flash download seems very risky. The keyboard part of the firmware isn’t isolated and can’t be reflashed separately, so every time you change your keyboard layout you’re risking wearing out the flash or being left with an unbootable machine… and every keyboard layout change requires a full reboot of the laptop.

I see. Hmm. This is risky. But how did the framdeck, the Framework’s mainboard-based cyberdeck achieve the 36 keys’ keyboard layout? Seeing this issue ticket, QMK is used?

[DHowett]

Thanks for the input! All noted.

@junaruga

Seeing this issue ticket, QMK is used?

I believe they connected an existing mechanical keyboard that was already running QMK over USB.

[junaruga]

@DHowett

Thanks for the input! All noted.

I appreciate your work! I am looking forward to seeing it!

@DHowett

I believe they connected an existing mechanical keyboard that was already running QMK over USB.

I see. That makes sense.

[junaruga]

I just got one idea to use keyboard QMK on the Framework Laptop. Can you imagine? In this way, people can use the independent keyboard firmware.

1. Use one of the 4 USB-C ports used for the expansion cards to connect the internal keyboard.
2. One expansion card is to connect the internal USB-C with the internal keyboard inside the board. There is not interface to connect outside. So, the internal keyboard works like existing mechanical keyboard.

[kenshinjenna]

I’m not fond of the idea of losing one of the 4 usb ports just to have the keyboard attached.

[junaruga]

@kenshinjenna

I’m not fond of the idea of losing one of the 4 usb ports just to have the keyboard attached.

I can understand it. So, perhaps a better idea for the expansion card is IN: one internal USB-C port connects with the mainboard’s USB-C port, OUT: 2 USB-C ports (one connects with the internal keyboard, another is used as the external USB-C interface). The expansion card behaves like a USB hub.

[junaruga]

It seems that a fantastic thing happened. - Introducing the Framework Laptop 16 and both Intel and AMD-powered Framework Laptop 13

We’ve also released open source firmware based on QMK keyboard software that runs on the Raspberry Pi RP2040 microcontroller that many of our Input Modules utilize.

With an open source design, we can’t wait to see the incredible modules that the community creates: jog wheels, sliders, touchscreen displays, e-ink notepads, smartcard readers, and more. Really, almost anything can be created into an Input Module. The only limit is your imagination, and the 3.7mm height constraints.

[David_Eastham]

Just to confirm, that would be in the 16” version only?

[junaruga]

I am not sure about it.

Here is the repository of the Input Modules. The Framework Laptop 16 is only mentioned there.

GitHub - FrameworkComputer/InputModules

[Morpheus636]

@David_Eastham

Just to confirm, that would be in the 16” version only?

I believe this is correct, yes. The new generation of Framework Laptop 13 uses the same input covers as the previous two generations.

[CGE]

@Morpheus636

I believe this is correct, yes. The new generation of Framework Laptop 13 uses the same input covers as the previous two generations.

It does, but interestingly, the width and length of the large input module appears to be almost exactly the same as the Framework 13 keyboard. It may be that height would be a problem, but I wonder if a different input cover design would allow a large input module to be used on the Framework 13.

---

Update: I asked nrp about this, but unfortunately, while they thought about the possibility, it apparently doesn’t work well.

As the keyboards will be the same in terms of key structure, though, I wonder if more invasive solutions (a specific, different input cover for a specific keyboard) might work.

[David_Eastham]

That is a shame. I think the 13” model with programmable Atreus keyboard would be the ultimate portable writer’s notebook. The 16” might be a bit overkill for my needs but hard to turn down if it offers ergonomic keyboard modules.

In the other hand Framework might decide to offer a revised 13” chassis in a couple of years whilst taking the opportunity of bringing the best of what they learned designing the 16” model back onto the smaller format. That would surely include the programmable keyboard modules.

[akira]

Using the same software as the QMK firmware, the 16" keyboard should have an N-key rollover function. This means every key has a diode to prevent ghosting. a Different key matrix or circuit than the 13" keyboard and connector of key membrane sheet and main board are different.
Then, the 13" keyboard will not have QMK.

[Internetowe_Statysty]

hi, so have anything changed regarding qmk in 13"?

[MJ1]

Welcome to the forum

@Internetowe_Statysty

hi, so have anything changed regarding qmk in 13"?

I don’t think so. Haven’t seen Framework mention plans to add qmk to the 13". It’s not something they can do in just software. If they did it, you would need a new input cover assembly. Since they would need to add a chip that supports qmk.

[Andrew_Dekker]

I’d buy one if they made it… 100%.
Where can I upvote this request…
Also it’s gotta be ortholinear… Its about time we abandoned the typewriter style staggered key nonsense.
I love my 13 and use qmk and zmk on all my custom boards… I end up doing this most of the time as my preffered board is wireless and split