ZSA Keyboards: Difference between revisions

Line 1:

== Flashing ==

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 ~~such as the Ergodox EZ and Moonlander Mark I~~ 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~~. In previous versions, your user had to be a member of the <code>plugdev</code> group~~.

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>

Line 7:

Line 19:

</nowiki>}}

In addition, you ~~might also want~~ to install wally-cli[https://github.com/zsa/wally-cli]:

In addition, you need to install wally-cli[https://github.com/zsa/wally-cli]:

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

environment.systemPackages = with pkgs; [ wally-cli ];

</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]]

@@ Line 1: / Line 1: @@
-== Flashing ==
+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 such as the Ergodox EZ and Moonlander Mark I 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. In previous versions, your user had to be a member of the <code>plugdev</code> group.
+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>
@@ Line 7: / Line 19: @@
 </nowiki>}}
-In addition, you might also want to install wally-cli[https://github.com/zsa/wally-cli]:
+In addition, you need to install wally-cli[https://github.com/zsa/wally-cli]:
 {{file|/etc/nixos/configuration.nix|nix|<nowiki>
 environment.systemPackages = with pkgs; [ wally-cli ];
 </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]]