ZSA Keyboards

From NixOS Wiki
Revision as of 16:34, 15 April 2024 by Klinger (talk | contribs)

ZSA.io offers a variety of ergonomic keyboards such as the Ergodox EZ and Moonlander Mark I. Its possible to configure the keyboard layout via https://configure.zsa.io/ and then flash it to the keyboard. Flashing is done via Browser (Chrome, Chromium) or via a desktop application.

To just use a ZSA keyboard its not necessary to change the NixOS configuration.

Flashing

Flashing via Chrome/Chromium Browser

In Oryx ( https://configure.zsa.io/ ) you can just click „Safe to my keyboard“ to flash the keyboard.

There are some udev rules necessary for the connection. You have to activate them in NixOS configuration first:

 
/etc/nixos/configuration.nix
hardware.keyboard.zsa.enable = true;

Flashing via wally-cli (command line tool, deprecated)

ZSA keyboards can be flashed using the wally-cli command-line tool. There are some udev rules necessary for the connection. You have to activate them in NixOS configuration first:

 
/etc/nixos/configuration.nix
hardware.keyboard.zsa.enable = true;

In addition, you need to install wally-cli[1]:

 
/etc/nixos/configuration.nix
environment.systemPackages = with pkgs; [ wally-cli ];

Flashing via keymapp (command line tool)

ZSA keyboards can be flashed using the keymapp command-line tool. There are some udev rules necessary for the connection. You have to activate them in NixOS configuration first:

 
/etc/nixos/configuration.nix
hardware.keyboard.zsa.enable = true;

Unfortunately keymapp is not yet available as package for NixOS.