ZSA Keyboards: Difference between revisions

From NixOS Wiki
Klinger (talk | contribs)
description of ZSA keyboards, added 2 different ways to flash keyboards
Klinger (talk | contribs)
mNo edit summary
Line 13: Line 13:


== Flashing via wally-cli (command line tool, deprecated) ==
== Flashing via wally-cli (command line tool, deprecated) ==
ZSA keyboards can be flashed using the <code>wally-cli</code> command-line tool. The ZSA udev rules can be set up automatically with the <code>hardware.keyboard.zsa</code> config option.  
ZSA keyboards can be flashed using the <code>wally-cli</code> command-line tool. There are some udev rules necessary for the connection. You have to activate them in NixOS configuration first:


{{file|/etc/nixos/configuration.nix|nix|<nowiki>
{{file|/etc/nixos/configuration.nix|nix|<nowiki>
Line 26: Line 26:


== Flashing via keymapp (command line tool) ==
== Flashing via keymapp (command line tool) ==
ZSA keyboards can be flashed using the <code>keymapp</code> command-line tool. The ZSA udev rules can be set up automatically with the <code>hardware.keyboard.zsa</code> config option.  
ZSA keyboards can be flashed using the <code>keymapp</code> command-line tool. There are some udev rules necessary for the connection. You have to activate them in NixOS configuration first:


{{file|/etc/nixos/configuration.nix|nix|<nowiki>
{{file|/etc/nixos/configuration.nix|nix|<nowiki>

Revision as of 16:34, 15 April 2024

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.