GMMK 2 : Guide d'installation du kit QMK

Guides et ressources

Mar 24 2022

QMK pour le GMMK 2 utilise notre branche fourchue officielle Glorious qui contient toutes les mises à jour officielles du micrologiciel QMK et les mappages de touches de la carte. Pour la majeure partie de ce guide, nous suivrons le didacticiel d'installation officiel de QMK trouvé ici .


Avant que tu commences

1. Vous devrez télécharger la boîte à outils QMK que nous avons fournie ici . Cela vous permettra de flasher votre GMMK 2 avec le firmware QMK compilé.

Utilisateurs de Chrome : Chrome peut arrêter le téléchargement, sélectionnez simplement la flèche vers le haut et choisissez « conserver ».

Utilisateurs Windows : Windows Defender SmartScreen peut également arrêter l'exécution du programme. Sélectionnez « Plus d'informations », puis « Exécuter quand même ».

2. Une fenêtre « Installation du pilote » apparaîtra. Cliquez sur « Oui » pour installer les derniers pilotes QMK Toolbox sur votre ordinateur. Attendez que la fenêtre se ferme d'elle-même.

3. Vous aurez également besoin d'un simple éditeur de texte comme Sublime ou Atom , qui vous permettra d'éditer de simples fichiers de keymap. Pour nos tests, nous avons utilisé Sublime.

Remarque : lors de l'installation de Sublime, laisser la case « menu contextuel de l'explorateur » cochée ou décochée n'a pas d'importance pour ce guide.


Préparer l'environnement

4. Utilisateurs Windows : vous devrez télécharger l'outil QMK MSYS, disponible ici . Suivez les instructions simples pour installer MSYS via leur site Web.

Remarque : Windows Defender SmartScreen peut arrêter l'exécution du programme. Sélectionnez « Plus d'informations », puis « Exécuter quand même ».

5. Sélectionnez l'emplacement de votre dossier de destination et sélectionnez « Créer un raccourci » si vous le souhaitez. Commencez le processus d’installation.

6. Après quelques minutes, le processus d'installation se terminera. Cliquez sur « Terminer » pour fermer la fenêtre.

4a. Utilisateurs non Windows : nous vous recommandons de consulter les informations détaillées fournies ici dans la documentation officielle de QMK . 


Exécutez la commande de configuration QMK

Remarque : les étapes 7 à 12 doivent être effectuées dans une seule fenêtre. Ne fermez pas votre session QMK MSYS tant que toutes les étapes n'ont pas été terminées avec succès pour vous assurer qu'elle est correctement effectuée.

7. Cliquez avec le bouton droit pour exécuter le programme QMK MSYS en mode Administrateur et tapez la commande suivante dans la fenêtre :

configuration de qmk GloriousThrall/qmk_firmware

8. Appuyez sur Entrée et la fenêtre affichera :

'Impossible de trouver qmk_firmware !

Souhaitez-vous cloner GloriousThrall/qmk_firmware vers C:/Users/your_name/qmk_firmware ? [ o / n ] .'

9. Tapez « y » et appuyez sur la touche droite Entrée / Monter. Après un moment, le programme commencera à cloner les fichiers nécessaires.

10. Attendez quelques minutes jusqu'à ce que le texte vert indiquant « QMK est prêt à fonctionner » s'affiche.

Remarque : Cela signifie que la branche Glorious QMK Forked a été copiée avec succès sur votre ordinateur local et que QMK est prêt à vous permettre de commencer à compiler votre premier firmware.

11. Ensuite, entrez la commande suivante pour remplacer le répertoire par le dossier qmk_firmware :

cd qmk_firmware

12. Ensuite, tapez simplement la commande GIT suivante ci-dessous pour accéder à la branche GMMK 2 dans le projet forked qmk_firmware :

git checkout glorious_gmmk2

13. La dernière étape consiste à saisir la commande suivante pour télécharger tous les sous-modules QMK nécessaires à ce firmware :

créer un sous-module git

Vous disposez désormais de tous les fichiers nécessaires pour commencer à compiler votre keymap !


Testez votre configuration

14. Pour créer le keymap GMMK 2 par défaut sur QMK, exécutez la commande ci-dessous qui s'applique à votre carte dans la fenêtre QMK MSYS :

a) Pour GMMK 2 Pleine Taille (96%) ANSI :

qmk compile -kb gmmk/gmmk2/p96/ansi -km par défaut

b) Pour GMMK 2 taille réelle (96 %) ISO :

qmk compile -kb gmmk/gmmk2/p96/iso -km par défaut

c) Pour GMMK 2 Compact TKL (65%) ANSI :

qmk compile -kb gmmk/gmmk2/p65/ansi -km par défaut

d) Pour GMMK 2 Compat TKL (65%) ISO :

qmk compile -kb gmmk/gmmk2/p65/iso -km par défaut

Le firmware du keymap de votre GMMK 2 est maintenant compilé et est prêt à être flashé !


Flasher votre micrologiciel

Il est maintenant temps de flasher votre nouveau fichier de firmware sur votre GMMK 2. Nous mettrons en évidence les principales étapes ci-dessous, mais vous pouvez vous référer à la documentation officielle de QMK pour des informations plus spécifiques concernant le flashage ici .

15. Maintenant que vous avez compilé vos fichiers de micrologiciel, ils doivent se trouver dans le dossier qmk_firmware du dossier .build. Tous vos fichiers de firmware sont affichés ici.

Remarque : Pour trouver rapidement ce dossier à l'aide de l'Explorateur de fichiers, recherchez ou accédez à :

C:/Users/ <Votre nom d'utilisateur> /qmk_firmware

16. Ouvrez la boîte à outils QMK que vous avez téléchargée précédemment. Nous l'utiliserons pour flasher votre firmware sur le GMMK 2 et vérifier si notre clavier est en mode bootloader.


Mettre le clavier en mode Bootloader

17. Débranchez votre clavier. Maintenez ensuite « Barre d'espace » et « b » tout en rebranchant la clé USB sur le clavier. En cas de succès, QMK Toolbox affichera un message indiquant que votre clavier est en mode chargeur de démarrage.

18. Dans la barre d'outils QMK Toolbox, cliquez sur le bouton Ouvrir ici (élément n°1 dans l'image ci-dessous) et accédez à votre répertoire qmk_firmware/.build où se trouvent vos fichiers de micrologiciel.

19. Sélectionnez le fichier de micrologiciel correct avec une extension « .bin ». Son nom ressemblera à la commande que vous avez saisie à l'étape 14.

Exemple : les propriétaires de GMMK 2 en taille réelle (96 %) verront : gmmk_gmmk2_p96_ansi_default.bin

20. Assurez-vous que votre clavier est branché et en mode chargeur de démarrage ou DFU avant de cliquer sur le bouton flash (élément n°2 dans l'image ci-dessous) . Attendez que la fenêtre indique que le flash a été terminé avec succès.

21. Une fois terminé, débranchez la carte et rebranchez-la.

Félicitations, vous avez réussi à flasher votre propre firmware QMK sur votre GMMK 2 !


Personnalisation des claviers

22. Si vous souhaitez personnaliser davantage votre QMK avec de nouvelles couches, différentes configurations de clavier, mises en page et extraits personnalisés, accédez au dossier qmk_firmware situé ici :

C:\Users\ <Nom d'utilisateur> \qmk_firmware\keyboards\gmmk\gmmk2\ <variante de clavier> \ <ansi ou iso> \keymaps\default

23. Ouvrez le dossier par défaut. Ensuite, ouvrez le fichier keymap.c dans votre éditeur de texte pour remapper toutes les touches de votre choix, ajouter ou supprimer des calques et amusez-vous à explorer !

24. Une fois que vous avez terminé, enregistrez le fichier et exécutez la commande de compilation répertoriée ci-dessus.

25. Suivez à nouveau les étapes 13 à 20 pour recompiler votre micrologiciel de clavier nouvellement modifié et le flasher sur votre carte.

Félicitations une dernière fois ! Pour plus d'informations sur la personnalisation et les codes clavier spécifiques, consultez la documentation de QMK sur le sujet ici.


Revenir à Glorious CORE

Pour revenir au firmware Glorious d'origine fourni en usine avec votre GMMK 2, vous devrez le restaurer à son firmware d'origine à l'aide de nos fichiers de firmware préemballés situés ci-dessous. Veuillez sélectionner votre clavier.

Remarque : Cliquer sur un lien peut vous diriger vers un document .txt. Pour obtenir le fichier dont vous avez besoin, faites un clic droit et sélectionnez "Enregistrer sous". Ensuite, supprimez « .txt » du nom du fichier pour qu’il se termine par « .hex ». Enfin, sous « Enregistrer sous : » sélectionnez « Tous les fichiers » dans la liste déroulante.

Si vous n'avez pas modifié le raccourci du chargeur de démarrage avec le clavier par défaut du micrologiciel QMK que vous avez flashé sur votre GMMK 2, procédez comme suit :

1. Débranchez votre clavier. Ensuite, tout en maintenant la touche « Échap », rebranchez-le. Le clavier devrait alors passer en mode chargeur de démarrage.

2. Si vous êtes entré avec succès en mode chargeur de démarrage, la boîte à outils QMK soulignera que votre clavier est en mode chargeur de démarrage.

3. Dans la barre d'outils QMK Toolbox, cliquez sur le bouton Ouvrir ici (élément numéro 1 dans l'image ci-dessous) .

4. Accédez au répertoire où se trouve le fichier du micrologiciel Glorious .hex que vous venez de télécharger.

5. Sélectionnez le fichier du micrologiciel.

6. Assurez-vous que votre clavier est branché et en mode bootloader ou DFU et cliquez simplement sur le bouton flash (élément numéro 2 dans l'image ci-dessous) .

7. Vous verrez une série de messages puis terminerez.

C'est ça! Ouvrez Glorious CORE et vous devriez voir à nouveau le clavier apparaître dans le logiciel.