Clavier Zuoya GMK87 sous Linux

Récemment, à cause d’un collège de boulot, je me suis lancé dans la construction d’un clavier custom basé sur le Zuoya GMK87. Alors oui, c’est un clavier chinois, mais trouver un clavier custom avec écran, molette, compatible VIA, et avec cette qualité de fabrication pour environ 50€, c’est plutôt rare. Du coup, j’ai accepté quelques concessions :

Il s’agit d’un clavier ANSI (et non ISO), donc pas de touche < et > si vous utilisez une disposition AZERTY, mais c’est configurable avec VIA.
Le constructeur ne respecte pas la licence QMK, ce qui limite le support officiel (voir ce commentaire GitHub).
Il faut chercher un peu pour trouver les bons drivers et la bonne définition JSON.

Connecter le clavier à l’interface VIA

Je ne vais pas entrer dans les détails de l’interface VIA, car il existe déjà pas mal de documentation. Mais pour que le clavier soit détecté et utilisable, j’ai rencontré quelques difficultés :

Il faut un navigateur compatible WebHID, ce qui n’est pas le cas de Firefox. J’ai donc utilisé Chrome, facilement installable sous Fedora.
Ensuite, il faut autoriser l’accès au clavier pour l’utilisateur courant.

Cela passe par la création d’un groupe spécifique :

# groupadd -r qmkvia
# usermod -aG qmkvia llaumgui

Puis la mise en palce d’une règle udev :

# echo 'KERNEL=="hidraw*", SUBSYSTEM=="hidraw", MODE="0660", GROUP="qmkvia"' > /etc/udev/rules.d/99-hidraw-qmkvia.rules
# udevadm control --reload-rules
# udevadm trigger

Passer le clavier à une machine virtuelle

Malheureusement, les outils pour mettre à jour le firmware ou changer l’animation de l’écran ne sont disponibles que sous Windows 😥.

J’ai d’abord essayé via GNOME Machines, mais ce dernier empêche la redirection d’un clavier physique vers une VM pour des raisons de sécurité (une fois passé à la VM, le clavier n’est plus utilisable sur l’hôte).

Grâce à une suggestion sur le forum Fedora-Fr (merci à xylphute), je suis passé par Virtual Machine Manager (virt-manager), qui permet de se connecter à une session utilisateur QEMU/KVM et donc de récupérer mes VM créées avec GNOME Boxes. Et là, ça fonctionne !

Trouver les bons drivers et les bonnes définitions JSON

Comme mentionné plus haut, on est sur un clavier chinois, plus ou moins no-name, donc les ressources officielles sont rares. Heureusement, je suis tombé sur une vidéo YouTube très utile qui explique :

Comment mettre à jour le clavier,
Où télécharger le firmware et les définition JSON correctes.

👉 Voir la vidéo ici.

Mettre l’heure à jour ou changer d’image

J’ai vu quelques scripts Python sur GitHub pour synchroniser l’heure, mais je ne les ai pas encore testés.

Pour le moment, je passe par l’application Windows qui permet de changer l’animation de l’écran — c’est aussi là que je mets l’horloge à jour, faute d’option sous Linux.

Gestion des touches `<` & `>`

Étant en AZERTY avec un clavier ANSI, il me manque naturellement les touches < et >. Pour contourner cela, je suis passé par la configuration de VIA, en assignant manuellement les touches là où ça me semblait logique.

Voici une capture d’écran de ma configuration :