Projet clavier DIY

Colagan V2 — Right Only

Une moitié droite de clavier split fabriquée maison, sur RP2040, en AZERTY français, avec des couches de jeu (FPS et MMO) éclairées touche par touche pour jouer de la main droite. Fonctionnel, et encore perfectible.

Résumé

Contrôleur
RP2040
Raspberry Pi Pico, bootloader rp2040
Touches
29
matrice 6×5, 4 rangées de 6 + 5 pouces
Firmware
QMK + VIA
variante Vial également présente
RGB
29 LEDs
WS2812 sur GP13, chaîne linéaire
Couches
6
BASE · FN · FPS · MMO · MMO_UI · SEL
Version
v0.4
couches FPS et MMO, octobre 2026

Le clavier est « right only » : une seule moitié, la droite, sert de clavier complet (le PCB est conçu réversible, voir plus bas). La couche BASE porte le côté droit de l'AZERTY ; un double-tap sur Ctrl bascule sur la couche FN, qui porte le côté gauche. Un triple-tap ouvre le sélecteur de couche, pour passer en FPS (Warzone) ou MMO (WoW) : le clavier envoie alors les touches par défaut du jeu, sous la main droite, sans rebind.

Couches

Les légendes sont celles obtenues sous un système en AZERTY français (VIA affiche les keycodes QWERTY US, d'où les correspondances du readme).

Ctrl multi-tap et sélecteur de couche

Une seule touche (CTRL_TOG, matrice 4,4) pilote les couches grâce à un compteur de taps dans la fenêtre CTRL_MULTITAP_TERM (500 ms).

TapsEffet
1×Ctrl normal (enfoncé dès l'appui)
2×Bascule la couche FN
3×Ouvre ou ferme le sélecteur SEL (désactive FN), compteur remis à zéro

Dans le sélecteur, la rangée du haut choisit la couche : BASE (blanc), FPS (rouge), MMO (bleu), FN (vert). Sur les couches de jeu, le pouce de droite est une touche MO(SEL) : on la tient, on appuie sur la couche voulue, puis on relâche. Sur MMO, la touche UI (rangée du bas, 2e colonne) tenue donne F1-F5 et les fenêtres du jeu.

Le PCB

Dessiné sous KiCad : « Colagan Pico Split KeyBoard V2 », version fabriquée chez JLCPCB en novembre 2025. Il est conçu réversible (empreintes « Reverse ») : le même circuit sert pour les deux moitiés, en le retournant.

Rendu 3D du PCB V2, face avant : grille 6×4 et cinq touches de pouce en arc

Sources : SplitKeyboard Colagan V2.kicad_pcb (positions et rotations lues dans le fichier) ; rendu 3D généré avec kicad-cli.

Matériel

Colonnes (6)
GP20 · GP22 · GP12 · GP11 · GP10 · GP9
Lignes (5)
GP21 · GP19 · GP18 · GP17 · GP16
Diodes
COL2ROW
Données LED
GP13 (WS2812, driver vendor)
USB
VID 0xFEED · PID 0x0004
Fonctions
bootmagic · extrakey · mousekey · NKRO · RGB matrix

Ordre des LEDs (chaîne linéaire)

rangée 0 :  0  1  2  3  4  5      (CH1  → CH6)
rangée 1 :  6  7  8  9 10 11      (CH7  → CH12)
rangée 2 : 12 13 14 15 16 17
rangée 3 : 18 19 20 21 22 23
pouces   : 24 25 26 27 28         (CH25 → CH29)

Vérifié dans le PCB : la sortie de la LED de chaque touche est reliée à l'entrée de la suivante, dans l'ordre CH1 à CH29, toujours de gauche à droite.

Luminosité maximale 200/255. Plus de 40 animations RGB matrix activées pour les couches BASE et FN.

Build & flash

./build.sh   # copie keymap + config + keyboard.json vers qmk_firmware, compile, récupère firmware.uf2
./flash.sh   # copie firmware.uf2 sur le Pico monté en /media/$USER/RPI-RP2
Environnement de build à recréer Le venv Python qmk_env a été créé avec Python 3.13 ; le système est passé en 3.14 et la CLI qmk ne démarre plus. Il faut recréer le venv (python3 -m venv puis pip install qmk) avant de recompiler.

Contenu du dépôt

colagan-pico-split-keyboard/
├── keyboard.json          # matériel : matrice, LEDs, USB, layout
├── keymaps/via/           # keymap VIA : keymap.c, config.h, rules.mk
├── keymaps/vial/          # variante Vial : + vial.json
├── build.sh · flash.sh    # compilation et flash
├── firmware.uf2           # dernier firmware compilé (v0.3)
├── hardware/              # sources KiCad du PCB, captures, export 3D
├── readme.md              # guide d'utilisation détaillé
└── docs/index.html        # cette page (+ docs/img : captures du PCB)

Pour compiler, le projet dépend d'un clone de qmk_firmware dans lequel build.sh copie les fichiers : la définition du clavier n'est pas encore autonome.

Pistes d'amélioration

Relevés à la lecture du code et des fichiers de configuration. Les points marqués « à vérifier » demandent un essai sur le clavier physique.

Comportement

Matériel et structure

Documentation et hygiène

Historique

Onze commits, tous le 23 novembre 2025 ; firmware compilé le 24 novembre 2025.