Handwired Macro Pad

Pan and zoom to explore the wiring. Remix the project to edit it in your own workspace.

1. 01

   Place the 12 switches

   Press the 12 mechanical switches into the 3-by-4 plate so the two metal solder tabs of every switch are accessible from the back. Number the keys left to right: keys 1–4 on the top row, 5–8 in the middle, and 9–12 on the bottom.

   • Tip: Use a marker or a small paper label to keep track of the rows before soldering.

   • ⚠ Do not heat a switch terminal for too long; excess heat can soften the plastic switch housing.
2. 02

   Make the three row wires

   Solder one bare wire across one terminal of switches 1, 2, 3, and 4, then run that wire to Pro Micro D4 (row 1 signal). Repeat for switches 5–8 to D5 (row 2 signal), and switches 9–12 to D6 (row 3 signal).

   • Tip: Keep each row wire separate and use three different wire colors if possible.
   • Tip: The two switch terminals have no positive or negative side; simply use the same chosen terminal across each row.

   • ⚠ Make sure row wires do not touch each other — a solder bridge would make keys trigger incorrectly.
3. 03

   Solder one diode to every key

   Solder the unstriped end of one 1N4148 diode to the unused terminal of each switch. The diode's painted stripe must face away from the switch; it will join a column wire next.

   • Tip: The stripe is the line printed near one end of the tiny glass diode.
   • Tip: Bend the diode legs first so they lie flat and do not press against nearby switch terminals.

   • ⚠ All 12 stripes must point away from their switches. A reversed diode makes that key fail or behave unpredictably.
4. 04

   Make the four column wires

   Join the striped diode ends for keys 1, 5, and 9, then run that column wire to Pro Micro D7 (key signal). Join keys 2, 6, and 10 to D8 (key signal); keys 3, 7, and 11 to D9 (key signal); and keys 4, 8, and 12 to D10 (key signal).

   • Tip: The four column wires run vertically through the key layout.
   • Tip: Use heat-shrink tubing or electrical tape over exposed diode legs where they cross another wire.

   • ⚠ Do not connect a column wire to the row wire at any key; each key must connect through its own diode only.
5. 05

   Inspect before plugging in

   With the Pro Micro unplugged, look closely for loose strands and solder blobs. Check that D4, D5, and D6 only go to row wires, while D7, D8, D9, and D10 only go to striped diode ends.

   • Tip: A phone camera zoom can make it much easier to spot solder bridges.
   • Tip: Use a multimeter continuity test if you have one: a key should connect its row to its column only while pressed.

   • ⚠ Do not plug in USB until you have checked for touching wires; a short can make the board hot or stop it working.

#include <Arduino.h>
#include <Keyboard.h>

// Hand-wired 3 x 4 keyboard matrix.
// Diode direction is COL2ROW: switch -> diode anode, diode stripe/cathode -> column.
const uint8_t ROW_1_PIN = 4;
const uint8_t ROW_2_PIN = 5;
const uint8_t ROW_3_PIN = 6;
const uint8_t COL_1_PIN = 7;
const uint8_t COL_2_PIN = 8;
const uint8_t COL_3_PIN = 9;
const uint8_t COL_4_PIN = 10;

const uint8_t rowPins[3] = {ROW_1_PIN, ROW_2_PIN, ROW_3_PIN};
const uint8_t colPins[4] = {COL_1_PIN, COL_2_PIN, COL_3_PIN, COL_4_PIN};

// Change these entries later to choose what each physical key sends.
const char macroKeys[3][4] = {
  {'1', '2', '3', '4'},
  {'5', '6', '7', '8'},
  {'9', '0', '-', '='}
};

bool previousPressed[3][4] = {};
unsigned long lastChangeMs[3][4] = {};
const unsigned long DEBOUNCE_MS = 20;

void setup() {
  // Rows normally listen with pull-up resistors enabled.
  for (uint8_t row = 0; row < 3; row++) {
    pinMode(rowPins[row], INPUT_PULLUP);
  }

  // Columns are released except for the one currently scanned.
  for (uint8_t col = 0; col < 4; col++) {
    pinMode(colPins[col], INPUT);
  }

  Keyboard.begin();
}

void loop() {
  const unsigned long now = millis();

  // This is the same COL2ROW scan direction used by the QMK config discussed.
  for (uint8_t col = 0; col < 4; col++) {
    pinMode(colPins[col], OUTPUT);
    digitalWrite(colPins[col], LOW);
    delayMicroseconds(30);

    for (uint8_t row = 0; row < 3; row++) {
      const bool pressed = (digitalRead(rowPins[row]) == LOW);

      if (pressed != previousPressed[row][col] &&
          now - lastChangeMs[row][col] >= DEBOUNCE_MS) {
        previousPressed[row][col] = pressed;
        lastChangeMs[row][col] = now;

        if (pressed) {
          Keyboard.press(macroKeys[row][col]);
        } else {
          Keyboard.release(macroKeys[row][col]);
        }
      }
    }

    pinMode(colPins[col], INPUT);
  }
}

“Deploy to device” opens this project in Schematik, where you can flash it to your board over USB.