ZSA Keyboards: Difference between revisions
imported>Fufexan m Add page to Hardware category |
description of ZSA keyboards, added 2 different ways to flash keyboards |
||
| Line 1: | Line 1: | ||
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. | |||
ZSA keyboards | 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: | |||
{{file|/etc/nixos/configuration.nix|nix|<nowiki> | |||
hardware.keyboard.zsa.enable = true; | |||
</nowiki>}} | |||
== 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. | |||
{{file|/etc/nixos/configuration.nix|nix|<nowiki> | {{file|/etc/nixos/configuration.nix|nix|<nowiki> | ||
| Line 7: | Line 19: | ||
</nowiki>}} | </nowiki>}} | ||
In addition, you | In addition, you need to install wally-cli[https://github.com/zsa/wally-cli]: | ||
{{file|/etc/nixos/configuration.nix|nix|<nowiki> | {{file|/etc/nixos/configuration.nix|nix|<nowiki> | ||
environment.systemPackages = with pkgs; [ wally-cli ]; | environment.systemPackages = with pkgs; [ wally-cli ]; | ||
</nowiki>}} | </nowiki>}} | ||
== 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. | |||
{{file|/etc/nixos/configuration.nix|nix|<nowiki> | |||
hardware.keyboard.zsa.enable = true; | |||
</nowiki>}} | |||
Unfortunately keymapp is not yet available as package for NixOS. | |||
[[Category: Hardware]] | [[Category: Hardware]] | ||
Revision as of 16:30, 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. The ZSA udev rules can be set up automatically with the hardware.keyboard.zsa config option.
/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. The ZSA udev rules can be set up automatically with the hardware.keyboard.zsa config option.
/etc/nixos/configuration.nix
hardware.keyboard.zsa.enable = true;
Unfortunately keymapp is not yet available as package for NixOS.