Etape 3: Softwares, QMK and VIAL

Explication des choix des Softwares

Nous souhaitions que le macropad soit facilement et rapidement configurable, sans avoir à modifier le code à chaque changement de touche. C’est pourquoi nous avons choisi d’utiliser Vial, qui nous permet aussi de changer la fonction du rotary encoder et des leds. Pour ce faire, il faut installer 3 softwares… :

QMK est un firmware open-source permettant de personnaliser les claviers mécaniques, il nécessite une recompilation et un flashage du firmware pour modifier les configuration. Vial est une extension de QMK qui permet une personnalisation en temps réel, sans reflasher le clavier. Elle utilise une interface graphique intuitive pour modifier les touches, les macros,… Basé sur QMK, mais elle ajoute des fonctionnalités comme le stockage des réglages directement sur le clavier.

Mettre le code sur le macropad

Dans QMK MSYS

qmk setup

Clonez la dernière version du dépôt depuis https://github.com/vial-kb/vial-qmk dans un nouveau dossier. Ce dossier doit être situé en dehors des dossiers du dépôt QMK existant. Imbriquer vial-qmk dans qmk_firmware peut entraîner des problèmes ; évitez cette pratique.

Si vous ne connaissez pas Git et souhaitez une version avec interface graphique, installez la version GitHub Desktop pour votre système d’exploitation. Accédez à https://github.com/vial-kb/vial-qmk et sélectionnez « Ouvrir dans GitHub Desktop ». Suivez les instructions de téléchargement/clonage.

Dans QMK MSYS

cd /c/vial-qmk (le chemin peut être différent dépendamment du dossier où vous l’avez créé)
- qmk new-keyboard (c’est possible que les questions diffèrent, voilà quelques réponses)
- Keyboard Name? 3x3_v2
- Using a Development Board? [y/n] y
- Development Board ? promicro
- Default Layout?
  1. none of the above
    Please enter your choice: [65] 65
- MCU?
  29. atmega32u4
  Please enter your choice: [29] 29

Il faut ensuite compléter le code.

Dans C:\vial-qmk\keyboards\3x3_v2 il faut un keyboard.json et un dossier keymaps.

Dans le dossier keymaps/vial il faut les fichiers config.h, keymap.c, rules.mk, vial.json.

Pour plus d’infos : https://get.vial.today/, https://qmk.fm/
Vous pouvez aussi changer le code pour ajouter des layers et avoir plusieurs configurations de key sur le macropad, dans ce code, j’ai mis qu’une layer pour optimiser la place.
Pour compiler il faut taper ça dans QMK MSYS :

qmk compile -kb 3x3_v2 -km default (si dans qmk sans vial)
Make 3x3_v2 :vial (si dans vial-qmk)

Si vous avez des problèmes pour compiler et que vous voulez juste tester si votre macropad fonctionne vous trouverez le fichier déjà compilé sur le GitHub.

Et pour finir il faut flash le pro micro, et il suffit d’aller dans QMK Toolbox et de sélectioner le fichier qu’on vient de compile, ATmega32U4 et sélectionner auto-flash. Ensuite il faut appuyer 2 fois de suite sur le petit bouton qu’on a souder à côté du pro micro. Si le programme met que ça a flash mais sans un long développement de plus de 3 lignes ça n’a pas réellement flash. Je sais que c’est bizarre et embêtant mais parfois il faut répéter l’opération plusieurs fois jusqu’à ça fonctionne.
Voilà vous pouvez désormais configurer les touches sur vial !

Etape 4: Explication du code