Skip to the content
2 layers168.5 × 116.3 mmSplitKeyboard Colagan V2, the printed circuit board in 3D

Colagan Pico Split Keyboard QMK

Size
168.5 × 116.3 mm
Copper layers
2
Thickness
1.2 mm
Parts
42
Nets
66
Pads
746
Tracks, vias
1,550, 221
Pours
1
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
14 Oct 2025
Updated
5 Nov 2026

Overview

SplitKeyboard Colagan V2 is an open-source printed circuit board by mccolagan, from the mccolagan/colagan-pico-split-keyboard repository on GitHub. It is a 2-layer board of 168.5 × 116.3 mm with 42 parts on 66 nets, routed with 1,550 tracks and 221 vias.

It belongs with the keyboards and input boards and the RP2040 boards of this library.

README

readme.md

⌨️ Colagan V2 Right Only

Clavier split custom - moitié droite uniquement avec layout AZERTY français

📖 Page du projet : https://mccolagan.github.io/colagan-pico-split-keyboard/ · 🛠️ Matériel (KiCad, PCB V2) : hardware/

Firmware actuel : split Vial des deux moitiés, documenté dans firmware/README.md (compilation, flash, couches, couleurs par couche éditables depuis le configurateur web, protocole docs/led-stream-protocol.md). La suite de ce fichier décrit l'ancien firmware VIA « Right Only » et est conservée pour référence.


✨ Caractéristiques

  • 🧠 Processeur: RP2040 (Raspberry Pi Pico)
  • ⌨️ Layout: 30 touches (matrice 6×5)
  • 🔌 Configuration: VIA (reconfiguration en temps réel)
  • 💡 RGB: 30 LEDs SK6812 MINI-E (1 par touche) avec animations personnalisées
  • 🖐️ Ergonomie: Ligne 5 en forme de "montagne" pour les pouces
  • 🇫🇷 Optimisé: AZERTY français

🎮 Layers disponibles

Le clavier dispose de 6 layers. Il est pensé pour jouer de la main droite (souris à gauche) : les couches de jeu envoient les touches par défaut du jeu, placées sous les doigts, pour ne jamais avoir à rebinder.

LayerRôleAccès
BASECôté droit de l'AZERTYDéfaut
FNCôté gauche de l'AZERTYDouble-tap sur Ctrl
FPSWarzoneSélecteur
MMOWoWSélecteur
MMO_UIF1-F5 et fenêtres du jeuTenir la touche UI depuis MMO
SELSélecteur de coucheTriple-tap sur Ctrl, ou tenir le pouce de droite en jeu

🔀 Changer de layer

La touche de pouce tout à droite (matrice 4,4) fait office de Ctrl multi-tap sur BASE et FN (fenêtre de 500 ms entre deux taps) :

TapsEffet
1xCtrl normal
2xToggle FN
3xOuvre/ferme le sélecteur SEL

Dans le sélecteur, la rangée du haut propose : BASE (blanc), FPS (rouge), MMO (bleu), FN (vert). Un appui choisit la couche. Depuis FPS ou MMO, on tient le pouce de droite (en vert), on appuie sur la couche voulue, puis on relâche.

🎯 Layer BASE - Côté DROIT AZERTY

text
┌─────┬─────┬─────┬─────┬─────┬─────┐
│  -  │  è  │  _  │  ç  │  à  │  )  │
├─────┼─────┼─────┼─────┼─────┼─────┤
│  Y  │  U  │  I  │  O  │  P  │  ^  │
├─────┼─────┼─────┼─────┼─────┼─────┤
│  H  │  J  │  K  │  L  │  M  │  ù  │
├─────┼─────┼─────┼─────┼─────┼─────┤
│  B  │  N  │  ,  │  ;  │  :  │  !  │
├─────┼─────┼─────┼─────┼─────┼─────┤
│ Del │Bksp │ Ent │ Alt │Ctrl │     │
│     │     │     │     │ 2xFN│     │
└─────┴─────┴─────┴─────┴─────┴─────┘

🔤 Layer FN - Côté GAUCHE AZERTY

Double-tap sur Ctrl pour activer/désactiver

text
┌─────┬─────┬─────┬─────┬─────┬─────┐
│  ²  │  &  │  é  │  "  │  '  │  (  │
├─────┼─────┼─────┼─────┼─────┼─────┤
│ Tab │  A  │  Z  │  E  │  R  │  T  │
├─────┼─────┼─────┼─────┼─────┼─────┤
│Caps │  Q  │  S  │  D  │  F  │  G  │
├─────┼─────┼─────┼─────┼─────┼─────┤
│Shift│  <  │  W  │  X  │  C  │  V  │
├─────┼─────┼─────┼─────┼─────┼─────┤
│ Del │Bksp │ Ent │ Alt │Ctrl │     │
└─────┴─────┴─────┴─────┴─────┴─────┘

🔫 Layer FPS - Warzone

Touches par défaut du jeu (AZERTY côté OS). Le cluster ZQSD est au même endroit que sur la couche MMO.

text
┌─────┬─────┬─────┬─────┬─────┬─────┐
│  1  │  2  │  3  │  4  │  5  │ Tab │
├─────┼─────┼─────┼─────┼─────┼─────┤
│  C  │Shift│  Z  │  E  │  F  │  G  │
├─────┼─────┼─────┼─────┼─────┼─────┤
│  X  │  Q  │  S  │  D  │  R  │  V  │
├─────┼─────┼─────┼─────┼─────┼─────┤
│  M  │  T  │  /  │Bksp │ Ent │ Esc │
├─────┼─────┼─────┼─────┼─────┼─────┘
│ Spc │Ctrl │ Alt │     │ SEL │
└─────┴─────┴─────┴─────┴─────┘

⚔️ Layer MMO - WoW

S1 à S11 sont des emplacements de sorts, à lier dans le jeu (ou à remapper dans VIA). Shift, Ctrl et Alt aux pouces multiplient chaque emplacement.

text
┌─────┬─────┬─────┬─────┬─────┬─────┐
│ S1  │ S2  │ S3  │ S4  │ S5  │ S6  │
├─────┼─────┼─────┼─────┼─────┼─────┤
│ Tab │  A  │  Z  │  E  │ S7  │ S8  │
├─────┼─────┼─────┼─────┼─────┼─────┤
│NumLk│  Q  │  S  │  D  │ S9  │ S10 │
├─────┼─────┼─────┼─────┼─────┼─────┤
│ S11 │ UI  │  /  │Bksp │ Ent │ Esc │
├─────┼─────┼─────┼─────┼─────┼─────┘
│ Spc │Shift│Ctrl │ Alt │ SEL │
└─────┴─────┴─────┴─────┴─────┘

S1 à S10 envoient 1 à 0 (AZERTY : & é " ' ( - è _ ç à), S11 envoie -. Tenir UI ouvre la sous-couche MMO_UI :

text
┌─────┬─────┬─────┬─────┬─────┬─────┐
│ F1  │ F2  │ F3  │ F4  │ F5  │  P  │
├─────┼─────┼─────┼─────┼─────┼─────┤
│     │     │     │     │  C  │  B  │
├─────┼─────┼─────┼─────┼─────┼─────┤
│     │     │     │     │  M  │  N  │
├─────┼─────┼─────┼─────┼─────┼─────┤
│  L  │     │     │     │     │     │
└─────┴─────┴─────┴─────┴─────┴─────┘

Les cases vides gardent la touche de la couche MMO.

🎛️ Layer SEL - Sélecteur

text
┌─────┬─────┬─────┬─────┬─────┬─────┐
│BASE │ FPS │ MMO │ FN  │     │     │
├─────┼─────┼─────┼─────┼─────┼─────┤
│ Br- │ Br+ │     │     │     │     │
└─────┴─────┴─────┴─────┴─────┴─────┘

Couleurs RGB des couches de jeu :

  • 🔵 BLEU : armes 1-5 (FPS), sorts (MMO)
  • ⚪ BLANC : ZQSD + Espace
  • 🟡 JAUNE : modificateurs, Tab
  • 🔴 ROUGE : actions de jeu (FPS)
  • 🟣 VIOLET : touches de menu (Échap, Entrée, Retour, /)
  • 🟢 VERT : sélecteur de couche, UI
  • ⚫ ÉTEINT : touches inutilisées

La luminosité se règle depuis le sélecteur (Br- / Br+).


🚀 Quick Start

1️⃣ Compiler le firmware

bash
./build.sh

Ce script :

  • Synchronise les fichiers du projet vers QMK
  • Compile le firmware
  • Copie le .uf2 dans le projet

2️⃣ Flasher le Pico

Entrer en mode bootloader :

  • 🔹 Méthode 1 : Maintenir BOOT + appuyer RESET + relâcher BOOT
  • 🔹 Méthode 2 : Double-tap rapide sur RESET

Flasher automatiquement :

bash
./flash.sh

Ou manuellement :

bash
sudo cp firmware.uf2 /media/$USER/RPI-RP2*/

✅ Le clavier redémarre automatiquement !

3️⃣ Reset EEPROM (première utilisation)

Pour appliquer la configuration par défaut du firmware (luminosité 10%, etc.) :

Bootmagic Reset :

  1. Débranchez le clavier
  2. Maintenez la touche en haut à gauche (position 0,0 - la touche "-")
  3. Rebranchez le clavier tout en maintenant la touche
  4. L'EEPROM sera réinitialisée

📁 Structure des fichiers

text
colagan-pico-split-keyboard/
├── 🔨 build.sh                    # Script de compilation + synchronisation
├── ⚡ flash.sh                    # Script de flash automatique
├── 📦 firmware.uf2                # Firmware compilé
├── ⚙️ keyboard.json               # Configuration matérielle QMK
├── 📖 readme.md                   # Ce fichier
└── 🗂️ keymaps/
    └── via/                       # Keymap VIA
        ├── keymap.c               # Layout des touches + RGB custom
        └── config.h               # Configuration (6 layers, luminosité)

🔧 Configuration matérielle

📌 Pins GPIO

  • Colonnes (6) : GP20, GP22, GP12, GP11, GP10, GP9
  • Lignes (5) : GP21, GP19, GP18, GP17, GP16
  • RGB LEDs : GP13 (SK6812 MINI-E data)

💡 RGB Matrix

  • LEDs : 30 SK6812 MINI-E (1 par touche)
  • Câblage : Serpentin (ligne 0: L→R, ligne 1: R→L, etc.)
  • Luminosité par défaut : 10% (26/255)
  • Luminosité max : 200/255

🔌 USB VID/PID

  • Vendor ID : 0xFEED
  • Product ID : 0x0004
  • Nom : Colagan V2 Right Only

🎨 RGB Matrix

Modes RGB

Firmware Vial split : couleurs et effet par couche se règlent dans le configurateur web, voir firmware/README.md. Ce qui suit concerne l'ancien firmware.

Le clavier dispose de 2 modes RGB distincts :

  1. Layers BASE/FN : Animations RGB Matrix standards (40+ effets)
  2. Layers FPS/MMO/SEL : Couleurs fixes personnalisées par touche (voir schémas ci-dessus)

Contrôles RGB via VIA

Dans VIA (onglet Lighting → QMK RGB Matrix) :

KeycodeAction
RM_TOGG💡 On/Off des LEDs
RM_NEXT➡️ Animation suivante
RM_PREV⬅️ Animation précédente
RM_VALU☀️ Augmenter la luminosité
RM_VALD🌙 Diminuer la luminosité
RM_HUEU🔴 Augmenter la teinte
RM_HUED🔵 Diminuer la teinte
RM_SATU⬆️ Augmenter la saturation
RM_SATD⬇️ Diminuer la saturation
RM_SPDU⚡ Vitesse d'animation +
RM_SPDD🐌 Vitesse d'animation -

Note : Sur les layers FPS, MMO et SEL, seuls les contrôles de luminosité (Br-/Br+ du sélecteur) fonctionnent. Les autres effets sont désactivés pour maintenir les couleurs personnalisées.


🎹 Configuration VIA

🔄 Correspondances AZERTY ↔ QWERTY

⚠️ VIA affiche en QWERTY US, mais votre OS utilise AZERTY français

🇫🇷 Pour obtenir (AZERTY)🇺🇸 Sélectionner dans VIA
' (apostrophe)4
é2
è7
à0
ù' (quote)
ç9
- (tiret)6
AQ
QA
WZ
ZW
M;
, (virgule)M

🛠️ Dépannage

❌ VIA ne détecte pas le clavier

  1. ✅ Vérifiez que le firmware a été compilé avec -km via
  2. 🔄 Rechargez la page VIA
  3. 🔌 Vérifiez la connexion USB :
    bash
    lsusb | grep -i feed
    # Devrait afficher : ID feed:0004 Colagan V2 Right Only

🔤 Les touches ne correspondent pas

➡️ Normal ! VIA affiche en QWERTY, votre OS est en AZERTY. 📋 Référez-vous au tableau de correspondances ci-dessus.

💡 Le clavier démarre avec des couleurs RGB étranges

C'est normal ! Le clavier démarre en layer BASE avec les animations RGB par défaut.

Pour utiliser les layers de jeu :

  • Triple-tap sur Ctrl (touche en bas à droite), puis choisir FPS ou MMO

Pour désactiver le RGB au démarrage :

  • Utilisez VIA pour assigner RM_TOGG à une touche et éteindre le RGB

🎮 Les layers de jeu ne démarrent pas avec la bonne luminosité

Si la luminosité est à 0 après un flash :

  1. Débranchez le clavier
  2. Maintenez la touche en haut à gauche ("-")
  3. Rebranchez le clavier (Bootmagic Reset)
  4. La luminosité sera réinitialisée à 10%

🔄 Reset de la configuration

Bootmagic Reset (recommandé) :

  • Débranchez le clavier
  • Maintenez la touche en haut à gauche (L0C0)
  • Rebranchez le clavier

Via VIA :

  • Settings ⚙️ → "Clear EEPROM"
  • Déconnectez/reconnectez le clavier

📚 Commandes utiles

bash
# 🔨 Compiler et synchroniser
./build.sh

# ⚡ Flasher
./flash.sh

# 🧹 Nettoyer les fichiers de compilation
cd ~/qmk_firmware
~/qmk_env/bin/qmk clean

# 🩺 Vérifier la configuration QMK
~/qmk_env/bin/qmk doctor

# ℹ️ Informations du clavier
~/qmk_env/bin/qmk info -kb colagan_v2_right_only

🔗 Ressources


📄 License

GPL-2.0-or-later


🎯 Notes de développement

Custom RGB Gaming Layers

Les layers FPS, MMO et SEL utilisent rgb_matrix_indicators_user() pour définir des couleurs personnalisées par touche :

  • Les couleurs sont proportionnelles à la luminosité globale (rgb_matrix_get_val())
  • Les touches Br+/Br- (layer SEL) appellent directement rgb_matrix_increase_val() et rgb_matrix_decrease_val()
  • Le mapping LED suit la chaîne linéaire du PCB : index = ligne × 6 + colonne (pouces : 24 à 28)

Multi-tap Ctrl Key

La touche Ctrl (position 4,4) utilise un système de multi-tap :

  • Délai de détection : CTRL_MULTITAP_TERM (500ms)
  • 1 tap : Ctrl normal
  • 2 taps : Toggle layer FN
  • 3 taps : Ouvre/ferme le sélecteur SEL (TO() vers BASE, FPS, MMO ou FN)

Parts

42
QtyValueFootprintReferences
25KS33_SW_HSLibrary SplitKeyboard Colagan:KS33-HS-Colagan-1U-FinalCH1, CH2, CH10, CH11, CH13, CH14, CH15, CH16, CH17, CH19, CH20, CH21, CH22, CH23, CH25, CH26 +9
4KS33_SW_HSLibrary SplitKeyboard Colagan:KS33-HS-Colagan-1.5U-FinalCH6, CH12, CH18, CH24
3LOGOLOGOG***, G***, G***
1LOGOLibrary SplitKeyboard Colagan:qrcode githubG***
1R1Library SplitKeyboard Colagan:Capasitor_SMD_1206_Reversible_ColaganV35k1R1
1RaspberryPi_Pico_WLibrary SplitKeyboard Colagan:RaspberryPi_Pico_Colagan_REF3A1
1USB_C_Receptacle_USB2.0_16PLibrary SplitKeyboard Colagan:USB_C_16P-Reversible-colaganJ2
1~Library SplitKeyboard Colagan:Capasitor_SMD_1206_Reversible_ColaganV35k1R2

The 37 most common of 42 parts.

Similar boards

  • 2 layers30 × 50 mmModuleV400, the printed circuit board in 3D

    ModuleV400

    stuartpittaway/diyBMSv4

    Version 4 of the diyBMS

    42 parts1.1k
  • 2 layers139.7 × 64.8 mmSprig console, the printed circuit board in 3D

    Sprig console

    hackclub/sprig

    🍃 Learn to code by making games in a JavaScript web-based game editor.

    42 parts1.1kMIT
  • 2 layers90.5 × 50 mmMain control board, the printed circuit board in 3D

    Main control board

    jamro/tiny-engineer

    A small desktop robot that brings an AI coding assistant to life, physically acting out when it reads files, thinks, writes code, and finishes work.

    42 parts1.1k
  • 2 layers67.6 × 30.5 mmRgb to hdmi, the printed circuit board in 3D

    Rgb to hdmi

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    42 parts1kGPL-3.0
  • 2 layers190 × 80 mmPcb shield, the printed circuit board in 3D

    Pcb shield

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    42 parts915
  • 2 layers98 × 80 mmMai io, the printed circuit board in 3D

    Mai io

    whowechina/mai_pico

    Pico controller for Maimai

    42 parts475
  • 2 layers50.8 × 90.4 mmOBOGS PANEL, the printed circuit board in 3D

    OBOGS PANEL

    jrsteensen/OpenHornet

    OpenHornet 1:1 F/A-18C Simulator Repository

    42 parts431

Questions

How big is the SplitKeyboard Colagan V2 PCB?

It measures 168.5 × 116.3 mm and has 2 copper layers, 1.2 mm thick.

What parts does the SplitKeyboard Colagan V2 use?

42 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the SplitKeyboard Colagan V2 KiCad files?

From the mccolagan/colagan-pico-split-keyboard repository on GitHub, at the commit this page was made from: the board is hardware/kicad/SplitKeyboard Colagan V2.kicad_pcb and its schematic hardware/kicad/SplitKeyboard Colagan V2.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the SplitKeyboard Colagan V2 design in my own project?

Its repository states no licence, so its author keeps all rights: ask mccolagan before reusing the design.