Test du clavier K3 Pro de Keychron

I-A-1. Clavier▲

I-A-2. Souris▲

Le Keychron K3 Pro se caractérise par les aspects suivants :

• ultra-fin ;
• trois inclinaisons possibles ;
• sans-fil (Bluetooth 5.1 avec un taux de rafraîchissement de 80 Hz) et filaire (avec taux de rafraîchissement de 1000 Hz) ;
• la possibilité d’enregistrer trois connexions Bluetooth ;
• le support des dispositions Windows et macOS, grâce à quelques chapeaux de touches interchangeables et un bouton physique dédié pour changer la disposition ;
• les chapeaux de touches sont en PBT, double shot ;
• l’utilisation d’un micrologiciel open source (GMK) ;
• embarquant des interrupteurs Gateron mécaniques au profil bas v2.0 pouvant être changés à chaud (disponible en bleu, rouge et marron) ;
• 22 effets de lumière ;
• du N-Key Rollover ;
• une batterie de 1550 mAh (100 heures de fonctionnement sans rétroéclairage, rechargée en environ trois heures) ;
• une puce ARM Cortex M4 32-bits STM32L432 embarquant 128 Ko de mémoire flash.

Le clavier K3 Pro de Keychron est donc un clavier 75 %, c'est-à-dire, un clavier de 84 touches, n’ayant pas de pavé numérique.

Le clavier est préparé avec les chapeaux de touches pour les utilisateurs d’ordinateurs Apple (touches option et commande à la place de Alt et la touche Windows). Les chapeaux de touches inclus dans la boîte permettent d’avoir les touches adéquates à Windows.

Le dessous du clavier dispose de cinq patins antidérapants, trois en bas du clavier et deux aux coins supérieurs. Sur la partie haute, la K3 Pro de Keychron dispose de pieds doubles en plastique avec patin antidérapant. Ainsi, le clavier permet trois inclinaisons : à plat (soit 2,5°), avec les petits pieds pour une élévation de 0,5 cm (soit, une inclinaison de 4,2°) et les grands pieds d’une hauteur de 1 cm offrant 6,5° d’inclinaison.

L’arrière du clavier présente un port USB Type C, un témoin lumineux ainsi que deux interrupteurs :

• un interrupteur à trois positions pour passer du mode filaire, éteindre le clavier ou passer en mode sans fil ;
• l’autre pour choisir entre l’agencement Windows ou l’agencement macOS.

Finalement, le clavier fait 30,6 cm de large, 11,6 cm de long. Le devant du clavier a une hauteur de 17 mm (19 mm en prenant en compte les patins antidérapants) et de 21 mm à l’arrière (23 mm avec le patin). Le tout pèse 514 g.

II-A-1. Témoin lumineux▲

D’après la notice, le témoin lumineux à côté du port USB Type C a deux fonctions :

• lorsque le clavier est en charge (branché), le témoin clignote en rouge si la charge est en dessous de 15 %, reste rouge durant la charge et passe au vert lorsque le clavier est complètement chargé ;
• lorsque le clavier est en mode Bluetooth, le témoin clignote en bleu en attente d’appairage, s’éteint lorsqu’il est appairé et clignote rapidement lors de la connexion à un périphérique.

Toutefois, la fonction du témoin lumineux lorsque le K3 Pro est en mode sans-fil n’est pas disponible. Le témoin reste éteint. Par contre, le clavier donne un retour lumineux, directement en dessous des touches 1, 2 ou 3, lorsque le clavier est en cours d’appairage. En effet, pour une attente d’appairage avec le deuxième périphérique, la touche 2 clignotera en bleu jusqu’à appairage.

Il est évidemment possible d’enlever les chapeaux de touches. Cela se fait sans difficulté grâce à l’outil fourni.

La barre espace, la touche entrée, la touche de verrouillage des majuscules et la touche de retour en arrière disposent de stabilisateurs.

Aussi, sous la touche espace, on trouve un interrupteur pour réinitialiser le clavier.

Les interrupteurs peuvent aussi être enlevés, grâce au second outil inclus. Toutefois, ce dernier n’est pas pratique à utiliser :

Maintenant que la grille des touches est dégagée, il est possible d’enlever 11 vis.

Ensuite, il faudra déclipser la plaque arrière (grise) de la grille des touches. Pour ce faire, un outil fin en plastique permettra de désolidariser les deux morceaux.

La grille des touches enlevée, la plaque électronique n’est que posée sur la plaque arrière. Un câble connecte la batterie (cachée par une protection en plastique) de la plaque électronique.

Mis à part l’électronique pour les interrupteurs du clavier, on remarque la carte d’extension pour la connectivité sans fil, placée en bas des touches (en haut sur la photo).

Keychron propose son propre guide vidéo pour le démontage et le remontage :

Il est possible d’acheter des chapeaux de touches pour correspondre à une disposition spécifique ou pour obtenir un coloris différent. Les chapeaux de touches viennent dans une boîte en carton, légèrement moins haute que celle utilisée pour l’emballage du clavier :

Le dessus montre un exemple de chapeau de touches, le nom de la marque et le contenu de la boîte. Toutefois, le coloris ainsi montré ne correspond pas nécessairement au contenu.

Les côtés de la boîte arborent le logo Keychron. L’arrière montre la compatibilité de l’ensemble de chapeaux de touches, dans différents coloris. Seul l’autocollant indique le contenu réel de la boîte, ici, des chapeaux de touches noirs, pour un agencement français. Le modèle montré dans cet article est disponible sur cette page.

L’ouverture de la boîte est maintenue par le bas et s’ouvre en soulevant le dessus :

L’emballage du contenu est plus sobre, avec l’ensemble de chapeaux dans un socle plastique et quelques chapeaux supplémentaires dans un sachet :

Ce jeu de chapeaux de touches est en plastique ABS et est conçu pour que les caractères laissent passer la lumière du rétroéclairage.

Les chapeaux de touches pour les touches numérotées n’indiquent que deux caractères au lieu de trois. En effet, dans la disposition AZERTY, les touches numérotées permettent de taper les caractères spéciaux (avec l’utilisation de Alt Gr), mais ces caractères ne sont imprimés que pour les touches 6 et 8 avec l’ensemble noir français.

Le clavier Keychron K3 Pro fonctionne aussi bien en filaire qu’en sans-fil. Dans le premier cas, il suffit de brancher le clavier pour qu’il soit reconnu par l’ordinateur.

Pour connecter le clavier en Bluetooth, il est évidemment nécessaire de déplacer l’interrupteur à l’arrière du clavier sur la position (« Bluetooth »). Le clavier s’allume. Pour que le clavier soit visible par l’ordinateur, il est nécessaire d’appuyer sur la combinaison Fn + 1 (ou Fn + 2, ou Fn + 3) pendant quatre secondes. En attente d’appairage, la touche 1, 2 ou 3 clignote en bleu. Une fois l’association effectuée, le clavier est connecté, utilisable et reprend son éclairage habituel.

Par défaut, le clavier dispose de dispositions spécifiques à Windows et macOS. Un interrupteur dédié, à l’arrière du clavier, permet d’alterner entre ces deux dispositions. En effet, certaines touches ont un emplacement spécifique suivant le système d’exploitation : les touches Windows, Alt, commande et option. Pour obtenir un comportement classique sous Windows, il faudra placer cet interrupteur sur la position Windows/Android : les touches Windows et Alt fonctionneront comme convenu. Dans le cas où vous utilisez la position pour macOS, alors les touches Windows et Alt seront inversées, mais correspondront au comportement attendu pour un clavier pour macOS (pour les touches commande et option).

En plus de ces deux dispositions, le clavier propose une touche « Fn », similaire à ce que l’on peut trouver sur un ordinateur portable. Lorsque celle-ci est pressée, la disposition change et permet d’accéder à de nouvelles actions pour chaque touche.

Sachant que la fonction des touches est personnalisable au travers de Keychron Launcher, il est possible de configurer jusqu’à quatre dispositions différentes : deux « principales » accessibles au travers de l’interrupteur (numérotées 0 pour la disposition macOS et 2 pour la disposition Windows) et deux dispositions accessibles grâce à la touche « Fn » (numérotée 1, lorsque l’interrupteur est à la position macOS et 3 dans l’autre cas).

Au premier abord, cela apporte une limitation. En effet, si vous choisissez l’agencement macOS (0) comme agencement principal, il ne vous sera pas possible d’accéder simplement à l’agencement 3. Il faudra changer la position de l’interrupteur pour passer à l’agencement Windows (2) et ensuite maintenir la touche « Fn ».
Une première façon de se libérer de cette contrainte sera de déterminer un agencement spécifique à un système d’exploitation (Linux) ou à un logiciel que vous utilisez lors de longues sessions. Cette disposition pourra être configurée sur la disposition 0 et lorsque vous changez d’utilisation de votre machine (par exemple, pour les jeux vidéo), vous pouvez passer à l’agencement 2.
En réalité, il est aussi possible de se passer totalement de l’interrupteur tout en gardant une configuration avec plus de deux dispositions. Le micrologiciel QMK dispose d’actions spécifiques pouvant être configurées sur les touches de votre choix permettant de changer la disposition à la volée.

Le format 75 % offre 84 touches uniquement. En observant attentivement les touches, on remarque que ce ne sont pas uniquement les touches du pavé numérique qui sont manquantes, mais aussi :

• la touche « Insérer » ;
• la touche « Menu » ;
• la touche « Pause ».

L’absence de ces touches peut être palliée grâce au logiciel de configuration permettant de reconfigurer l’action d’une touche. À titre d’exemple, il est envisageable de remplacer l’action de la touche en haut à droite du clavier (par défaut, configurée pour changer l’effet du rétroéclairage) pour l’utiliser comme touche « Insérer ». De plus, avec un ensemble de chapeaux de touches supplémentaires, il est possible d’enlever l’icône de l’ampoule pour mettre le chapeau adéquat à la nouvelle configuration.

Comme indiqué dans le manuel ainsi que dans le guide de démarrage rapide, le clavier propose quelques combinaisons de touches spéciales :

• Fn + A : changer le mode d’éclairage ;
• Fn + Tab : éteindre/allumer l’éclairage ;
• Fn + T et Fn + G : accélérer ou ralentir l’effet de l’éclairage ;
• Fn + Z et Fn + S : augmenter ou diminuer la luminosité de l’éclairage ;
• Fn + 1, Fn+ 2 et Fn + 3 : choisir le périphérique Bluetooth (ou associer avec un nouveau périphérique, si l’appui dure plus de quatre secondes) ;
• en mode filaire, Fn + J + W maintenu quatre secondes permet de réinitialiser le clavier à la configuration d’usine.

Un logiciel de configuration montrera que les fonctionnalités suivantes sont aussi disponibles :

• Fn + E et Fn + D : pour changer la teinte de couleur du rétroéclairage ;
• Fn + R et Fn + F : pour changer la saturation de couleur du rétroéclairage.
• Fn + B : affiche le niveau de charge de la batterie. Pour cela, le clavier éteint le rétroéclairage et lance une animation allumant progressivement, en blanc, les touches numérotées, indiquant ainsi le pourcentage de charge (par exemple, les touches de 1 à 6 sont allumées pour indiquer 60 % de charge). Une fois l’animation jouée, les touches restent rétroéclairées en vert pendant quelques secondes puis le clavier retourne au rétroéclairage de l’utilisateur. La combinaison de touche n’est prise en compte que lorsque le clavier est mode sans fil ;
• Fn + N : activer/désactiver le N-Key rollover.

Finalement, si vous allumez le clavier tout en maintenant la touche « Échap » appuyée, le clavier démarrera en mode Device Firmware Update (DFU), en attente d’une mise à jour du micrologiciel.

La fonctionnalité permettant de reconnaître un nombre arbitraire d’appuis simultanés, N-Key rollover, n’est pas activé par défaut. Par conséquent, le clavier ne reconnaîtra que les six premiers appuis et ignorera le reste (6-Key rollover). Le N-Key rollover peut être activé avec la combinaison de touches Fn + N. Une fois effectué, l’ordinateur reconnaîtra l’ensemble des touches appuyées.

Le micrologiciel QMK supporte une fonctionnalité appelée « tap dance ». Cette fonctionnalité permet de configurer deux actions différentes pour une même touche : une première, lors d’un appui rapide sur la touche (par défaut, inférieur à 200 ms), la seconde action, lorsque l’appui est plus long. Il existe aussi des configurations avec lesquelles une action différente peut être effectuée suivant le nombre d’appuis courts effectués sur une même touche.

Le « tap dance » offre de multiples possibilités, mais demande aussi un peu d’entraînement pour s’habituer. Voici quelques idées d’utilisation de cette fonctionnalité :

• un appui court sur une touche lettrée permet de taper la touche en minuscule, alors que l’appui long permet de taper la touche en majuscule ;
• les fonctions partageant habituellement les touches de fonctions (l’action F5 et l’action pour diminuer le volume sonore), peuvent être configurées sur une même disposition : un court appui pour diminuer le volume sonore, un appui long pour rafraîchir une page Internet (ou inversement) ;
• la touche « Menu » peut être placée sur la même touche que la touche « Fn ». Un appui court pour le menu (sachant qu’il n’y a aucun intérêt de faire un appui long pour celle-ci) et un appui maintenu pour la touche « Fn » comme à l’accoutumée ;
• …

Les possibilités sont multiples et permettent d’obtenir plus de fonctionnalités sur un clavier ayant un nombre de touches réduit.

Accessible directement depuis le site officiel du constructeur, Keychron Launcher permet de reconfigurer l’agencement des touches, le rétroéclairage, les macros et de mettre à jour les micrologiciels (celui du clavier et celui de la puce Bluetooth), directement depuis le navigateur Internet.

IV-A-1. Connexion▲

La configuration du clavier ne peut être effectuée que si le clavier est connecté avec le câble.

La première action à effectuer dans Keychron Launcher est de connecter le clavier au site. En appuyant sur le bouton « Connecter », une boîte de dialogue s’ouvre pour indiquer quel clavier le navigateur doit rendre accessible au site.

Une fois le clavier connecté, le site rend différentes sections de configuration accessibles et affiche la section « Keymap ».

IV-A-2. Configuration des touches▲

La page « Keymap » montre la disposition actuelle des touches du clavier et offre plusieurs catégories de fonctionnalités à assigner aux touches :

• basique (« Basic ») : les actions classiques d’un clavier (lettres, chiffres, ponctuations…) ;
• Média : les raccourcis multimédias (jouer, mettre en pause, passer à la suivante/précédente…) ;
• Macro: les actions pour déclencher les macros enregistrées dans la mémoire du clavier. Il n’y a pas d’action pour enregistrer une macro à la volée ;
• Touches spéciales (« Special Key ») : des actions telles que les touches de fonction de F13 à F24, des raccourcis pour effectuer des actions liées au système d’exploitation… ;
• Éclairage (« Lighting ») : les actions pour modifier le rétroéclairage ;
• Custom : d’autres actions, spécifiques à ce modèle (tel que : changer le périphérique appairé) ;

• Disposition (« Layer ») : les actions pour changer la disposition du clavier à la volée. Par défaut, la touche « Fn » utilise l’action MO(X) où X est l’index de la disposition vers laquelle transiter. MO indique que la touche agit comme un modificateur (comme pour les touches « Ctrl » ou « Maj »). D’autres actions sont disponibles :

  • OSL(X) pour activer la disposition X pour la prochaine frappe uniquement ;
  • TG(X) pour activer/désactiver une disposition ;
  • TT(X) associant les fonctionnalités de MO(X) et de TG(X) grâce au « tap dancing » (agit comme MO(X) pour un appui long et comme TG(X) après cinq appuis courts) ;
  • TO(X) pour passer exclusivement à la disposition X ;
  • DF(X) pour changer la disposition par défaut (celle active lorsque l’on n'appuie sur aucune touche).

La configuration d’une touche s’effectue en cliquant sur une touche du clavier affiché, puis sur l’action à assigner.

Aussi, l’interface permet de sélectionner la langue de l’agencement pour correspondre aux chapeaux de touches mis en place. Les actions à associer changent aussi pour correspondre à l’agencement choisi.

Les quatre dispositions du clavier peuvent être reconfigurées.

Finalement, il est possible de réinitialiser la configuration, de l’exporter dans un fichier JSON et de l’importer.

IV-A-3. Rétroéclairage▲

La section rétroéclairage permet de configurer l’effet en cours, de choisir sa couleur, sa vitesse ainsi que la luminosité du rétroéclairage. Toutefois, dans la version 1.6.3 bêta, les effets ne sont pas reconnus. La liste déroulante permettant de choisir l’effet n’est pas correctement peuplée et cliquer sur un des éléments éteindra le rétroéclairage.

L’interface ne se met pas automatiquement à jour après avoir changé la configuration du rétroéclairage depuis les combinaisons de touches du clavier.

IV-A-4. Macros▲

Il est possible de stocker et de lancer des macros avec le Keychron K3 Pro. Toutefois, deux limitations existent :

• 16 macros différentes peuvent être sauvegardées ;
• la mémoire interne pour stocker les macros est de 1,2 Ko (avec le micrologiciel Keychron). Cela correspond toutefois à environ 1000 actions.

Pour enregistrer une macro, Keychron Launcher propose deux méthodes :

• une méthode d’enregistrement qui enregistre les actions réalisées sur le clavier afin de les reproduire ;
• une méthode manuelle, ou les différentes actions seront à ajouter par le biais de l’interface.

L’interface permet d’éditer la macro, d’ajouter, d’éditer, de supprimer et de déplacer des événements. Les macros peuvent aussi être exportées en JSON et réimportées. Finalement, il est possible d’enregistrer un délai d’attente entre les actions de la macro.

IV-A-5. Test des touches▲

La section « Key Test » est très simple et permet de vérifier si les touches du clavier sont reconnues. Par défaut, pour chaque appui, un compteur sera incrémenté pour la touche en question et un son est joué.

IV-A-6. Mise à jour du firmware▲

Le clavier embarque le micrologiciel à la version 1.0.2. La version disponible au cours de l’écriture de l’article est la 1.0.3.

La procédure de mise à jour du firmware comporte les étapes suivantes :

• télécharger la QMK Toolbox (le téléchargement est proposé directement depuis Keychron Launcher), l’installer et la lancer en tant qu’administrateur. La boîte à outils permet d’installer les pilotes et notamment le pilote de la puce STM32L432 présent dans le clavier (menu « Install Driver ») ;
• débrancher le clavier ;
• rebrancher le clavier en appuyant sur la touche « Échap ». Ainsi, le clavier démarre sur son chargeur de démarrage ;
• cliquer sur le bouton « Match device », ce qui va lancer la connexion entre le Keychron Launcher et la puce du clavier ;
• cliquer sur « Flash Firmware » pour procéder à la mise à jour.

L’application Web Keychron Launcher assiste l’utilisateur tout le long de la procédure.

IV-A-7. Mise à jour du firmware Bluetooth▲

Le clavier est fourni avec le micrologiciel de la puce Bluetooth à la version 01.32. Il n’y a pas de nouvelle mise à jour disponible au moment de l’écriture de l’article. Keychron détaille la procédure de mise à jour sur cette page. Toutefois, le constructeur recommande de ne pas mettre à jour le micrologiciel si le clavier fonctionne correctement.

Évidemment, pour une telle mise à jour, le clavier doit être branché et utilisé en mode filaire.

Pour mettre à jour le micrologiciel, il est nécessaire de télécharger l’outil dédié pour Windows ou pour macOS.

Dans l’outil, il faudra d’abord appuyer sur le bouton « Get Version » pour obtenir la version présente sur le clavier, télécharger le micrologiciel sur le site de Keychron et cliquer sur le bouton « Update ».

Une fois la mise à jour terminée, il est nécessaire de réinitialiser le clavier avec la combinaison de touches à maintenir quatre secondes Fn + J + A.

IV-A-8. Autres▲

Keychron Launcher propose aussi une section comportant un formulaire pour rapporter un bogue ainsi qu’une section de paramètres. Cette dernière permet de changer la langue de l’interface, de voir les journaux et d’accéder à un éditeur JSON pour les fichiers de définitions de clavier.

Une alternative à Keychron Launcher est d’utiliser VIA, une autre application Web de configuration de clavier prenant en charge le micrologiciel QMK.

Si vous tentez de connecter le clavier, il est probable que le site retourne l’erreur suivante :

Fetching v3 definition failed
Device: Keychron K3 Pro
Vid: 0x3434
Pid: 0x0231

Le fichier de définition est un fichier JSON décrivant les aspects du clavier au site. Keychron fournit les fichiers nécessaires sur la page des micrologiciels ou encore, sur le dépôt officiel de Keychron.

Afin de faire reconnaître le clavier à l’application VIA, il faut activer la section « Design » depuis les paramètres (« Settings ») et téléverser le fichier JSON adéquat dans la section Design.
Une fois cette opération effectuée, le clavier pourra être reconnu par le site et être reconfiguré.

Les fonctionnalités et même l’interface de VIA sont très proches de celle de Keychron Launcher :

• la possibilité de reconfigurer les actions des touches en cliquant sur la touche du clavier visuel de l’application et en cliquant ensuite sur l’action à associer. Les actions sont aussi réparties en catégories : basique, média, macro, dispositions, spécial, éclairage et personnalisé ;
• la possibilité de reconfigurer le rétroéclairage : choix de l’effet, vitesse, couleur et luminosité ;
• la possibilité de sauvegarder/charger une configuration ;

• la possibilité de configurer des macros. Il est possible d’enregistrer les appuis sur les touches, d’éditer la macro enregistrée ou de l’éditer au format JSON ;

  

• de tester les touches.

Finalement, dans les paramètres, il est possible de changer le thème du site, de passer du mode sombre au mode clair ou encore, d’afficher une vue 3D du clavier.

IV-B-1. Fonctionnement en local▲

npm install bun
npm run dev

Remap est un autre projet (open source), permettant la redéfinition des touches. En plus de permettre la configuration de disposition de touches personnalisée, il est aussi possible de reconfigurer le clavier pour envoyer des codes MIDI ou encore, de créer un PDF des actions associées aux touches du clavier.

Comme pour VIA, il sera nécessaire de téléverser le fichier de définition JSON adéquat pour que le Keychron K3 Pro soit reconnu.

Remap supporte la configuration du « tap dance ». Il sera alors possible de configurer une action sur un appui long pour n’importe quelle touche. Par contre, l’action pouvant être effectuée ainsi ne peut être que celle des touches spéciales ou d’une combinaison de celles-ci. Mais, le choix de l’action pour l’appui court est libre.
Remap ne propose pas de section pour modifier le rétroéclairage. Toutefois, Remap possède un éditeur pour écrire son propre micrologiciel.

Vial est une application de bureau (dont il existe une version en ligne) permettant aussi de reconfigurer un clavier embarquant le micrologiciel QMK. Toutefois, Vial ne prend pas en charge le K3 Pro. Dans un tel cas, il sera nécessaire de bidouiller le code, comme a pu le faire un contributeur pour d’autres claviers de la marque.

Ainsi, l’utilisateur d’un clavier K3 Pro a le choix parmi trois logiciels de configuration (quatre en comptant Vial). Chacun possède des avantages et des inconvénients. Premièrement, les applications Keychron Launcher et VIA sont très similaires. Ils offrent les mêmes fonctionnalités (configuration de la disposition, du rétroéclairage, des macros et test des touches), seule l’interface diffère légèrement.
Keychron Launcher possède quelques particularités telles que la possibilité de changer la langue de l’interface ainsi que la langue de la disposition du clavier. Cela facilite le placement des touches accentuées et des caractères spéciaux. Aussi, il est possible de mettre à jour les micrologiciels directement depuis l’application. Malheureusement, l’application du constructeur contient encore quelques problèmes mineurs :

• la section rétroéclairage ne gère pas les effets disponibles correctement ;
• il manque certaines actions, liées au rétroéclairage, dans la section de configuration de la disposition. Il ne sera alors pas possible de configurer une nouvelle touche pour changer la teinte, la saturation, la vitesse ou encore, l’effet.

Ces deux applications diffèrent aussi sur l’interface de configuration des macros.

Remap apporte des fonctionnalités uniques telles que la gestion d’un parc de claviers, ou encore, la possibilité d’écrire et de compiler son micrologiciel en ligne. Mais surtout dans le cas du K3 Pro, la configuration des touches en « tap dance » est bienvenue.

Vial permet aussi de configurer des touches en « tap dance », d’une façon plus libre (le choix de l’action n’est pas limité), mais cela pour un maximum de 32 touches. Malheureusement, le clavier Keychron K3 Pro n’est pas supporté.

Il existe une solution permettant d’avoir la configuration de vos rêves, même si cela réduit les possibilités de changer la configuration à la volée : personnaliser le micrologiciel QMK.

Pour compiler le projet, il sera d’abord nécessaire de récupérer l’utilitaire qmk-cli. Celui-ci facilite la mise en place des outils pour compiler le micrologiciel QMK ainsi que dans le processus de création d’un binaire exploitable. Il peut être installé directement depuis les paquets des distributions Linux, depuis brew sur Mac ou encore, grâce à un installateur MSYS2 spécifique pour Windows ou simplement en utilisant pip : python3 -m pip install qmk. Autrement, il est toujours possible d’obtenir qmk-cli à partir des sources du projet grâce aux commandes suivantes :

python3 -m pip install build
python3 -m build

Ou encore :

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

La commande qmk étant maintenant disponible, il devient facile de récupérer les sources du micrologiciel et de préparer un environnement de compilation. En effet, la commande suivante récupère les sources du micrologiciel depuis Git et installe automatiquement les dépendances adéquates :

qmk setup Keychron/qmk_firmware -b bluetooth_playground

Il ne reste plus qu’à compiler le micrologiciel :

qmk compile -kb keychron/k3_pro/iso/rgb -km default

Le code du micrologiciel pour le clavier Keychron K3 Pro se trouve dans le dossier keyboards/keychron/k3_pro. En voici une rapide présentation :

• iso/rgb/keymaps/default/keymap.c : la disposition des touches par défaut ;
• rules.mk : les paramètres de compilation, permettant d’activer quelques options. Aussi, le fichier inclut le fichier bluetooth.mk, activant le support du Bluetooth ;
• iso/rgb : le support des LEDs ;
• config.h et iso/rgb/config.h : quelques variables globales liées aux spécificités électroniques du clavier ;
• k3.pro.c : ajoute le support de certaines touches spécifiques, avec la fonction process_record_kb ;
• Bluetooth : l’implémentation du support du Bluetooth et du niveau de la batterie ;

Globalement, la partie spécifique à ce clavier se trouve dans le dossier keychron/k3_pro. Les fonctionnalités génériques de QMK se trouvent dans le dossier quantum, notamment les animations des LED RGB se trouvent dans : quantum/rgb_matrix/animations. Un autre exemple avec la variable TAPPING_TERM dans quantum/action_tapping.h définissant le seuil, en secondes, permettant de différencier entre un appui court et un appui long pour le « tap dance ».

V-C-1. QMK Toolbox▲

QMK Toolbox est un outil graphique, pour Windows et macOS permettant de flasher le micrologiciel sur le clavier. Dès son ouverture, le logiciel demande s’il est nécessaire d’installer les pilotes spécifiques pour communiquer avec la puce embarquée dans le clavier.

Pour que l’installation des pilotes réussisse, il est nécessaire de lancer QMK Toolbox en tant qu’administrateur.

Pour flasher le micrologiciel, il suffit de passer le clavier en mode Device Firmware Update (DFU). Pour le Keychron K3, il est nécessaire de maintenir la touche « Échap » appuyée pendant le démarrage du clavier en mode filaire.
Ensuite, dans QMK Toolbox, il faut sélectionner le firmware à flasher et cliquer sur le bouton « Flash ».

V-C-2. Ligne de commande▲

qmk flash -kb <my_keyboard> -km <my_keymap>

sudo udevadm control --reload-rules
sudo udevadm trigger

QMK Configurator est un outil permettant de créer facilement une disposition de clavier et d’obtenir le micrologiciel embarquant cette disposition.

qmk json2c keymap.json

L’outil propose aussi un testeur de touches.