7 files changed, 475 insertions(+), 0 deletions(-)

A keyboards/an_achronism/tetromino/README.md
A keyboards/an_achronism/tetromino/config.h
A keyboards/an_achronism/tetromino/info.json
A keyboards/an_achronism/tetromino/keymaps/default/keymap.c
A keyboards/an_achronism/tetromino/keymaps/indicators/config.h
A keyboards/an_achronism/tetromino/keymaps/indicators/keymap.c
A keyboards/an_achronism/tetromino/rules.mk

@@ 0,0 1,42 @@
+# tetromino
+
+![tetromino](https://i.postimg.cc/RSfJkbTP/IMG-2428.jpg)
+* Keyboard Maintainer: [an_achronism](https://github.com/an-achronism)
+* Hardware Availability: Currently in prototyping stage, so only via [Discord](https://discord.gg/8hpygm4PgW)
+
+This project started for one reason alone: I suspected that I would hate typing on an ortholinear keyboard and wanted to find out if I was correct.
+
+It ended up turning into something a little more interesting, at least from my perspective. Much of this was driven by my general dissatisfaction with how RGB LEDs tend to be used in keyboards. I'd been talking for quite some time about how I'd like to build RGB behaviours into my keyboards that had a purely functional purpose, rather than existing mostly to look cool. Specifically, I wanted to represent layer and lock statuses in a way I've never seen anybody else do. For instance, turning on Caps Lock would not switch on a single Caps Lock indicator LED, but rather light up all of the keys that would behave differently because of Caps Lock being switched on, meaning A-Z but nothing else. The other indicators (Num and Scroll Lock) would do something very similar. Activating a custom keymap layer would also light up only the keys that were mapped differently on that layer compared to the base layer.
+
+I managed to implement a custom function to achieve exactly the desired RGB LED functionality, but for reasons that mostly have to do with following general QMK guidelines, this (relatively large) custom function is not included in the default keymap. If you want it, flash the "indicators" keymap instead.
+
+## Compiling the firmware
+
+You'll first need to set up a build environment for QMK (see below). Once you've done that, you can run a `make` for the keymap of your choice.
+
+The default keymap does NOT have my preferred custom RGB behaviour in it, in the interests of keeping with QMK repository's preference of keeping the default keymap as straightforward as possible (the custom RGB function is relatively large). If you don't care about having that, you can just do this:
+
+    make tetromino:default
+
+If however you do want my custom RGB matrix behaviour, do this:
+
+    make tetromino:indicators
+
+This will give you the RGB behaviour described in the section above.
+
+See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).
+
+## Entering the bootloader
+
+You'll need to do this to flash or reflash the firmware. You can enter the bootloader in a number of different ways:
+
+* **Physical reset button**: If you have a reset button soldered on, and the keyboard is fully assembled, you should be able to reach into the hole in the underside of the case while the keyboard is connected and double-press the reset button (push it twice in quick succession). Only pressing it once will reset the microcontroller, but won't put it into bootloader mode.
+* **Physical BOOTSEL button**: Regardless of whether you have a reset button soldered into place, there is a BOOTSEL button included onboard the Raspberry Pi Pico that hosts the microcontroller. With the keyboard disconnected, press and hold down the BOOTSEL button and connect the keyboard, then release BOOTSEL.
+* **Bootmagic reset**: Hold down the top left key and plug in the keyboard (similar to the BOOTSEL method above).
+* **Keycode in layout**: Press the key mapped to `QK_BOOT` if it is available in your keymap.
+
+Once that's done, you should see a USB mass storage device appear in your operating system pertaining to the RP2040's bootloader. This indicates that the MCU is ready to flash a firmware of your choice.
+
+## Flashing the firmware
+
+The RP2040 MCU comes preflashed with a UF2 bootloader which, once activated by one of the methods above, allows the user to flash a firmware by simply dragging and dropping the firmware file into the USB mass storage device that appears in the OS. In this case, drag and drop the .uf2 file for your corresponding QMK firmware (compiled previously as per instructions above) into the relevant USB device and the firmware should flash, then the keyboard will immediately restart with the firmware on it, ready to use. Happy typing!

@@ 0,0 1,31 @@
+/*
+Copyright 2022 an_achronism (@an-achronism)
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+#pragma once
+#define RP2040_BOOTLOADER_DOUBLE_TAP_RESET
+#define DRIVER_LED_TOTAL 70
+
+/* disable debug print */
+//#define NO_DEBUG
+
+/* disable print */
+//#define NO_PRINT
+
+/* disable action features */
+//#define NO_ACTION_LAYER
+//#define NO_ACTION_TAPPING
+//#define NO_ACTION_ONESHOT

@@ 0,0 1,184 @@
+{
+    "manufacturer": "an_achronism",
+    "keyboard_name": "tetromino",
+    "maintainer": "an-achronism",
+    "processor": "RP2040",
+    "bootloader": "rp2040",
+    "url": "https://github.com/an-achronism/tetromino",
+    "usb": {
+        "device_version": "1.0.0",
+        "pid": "0x3435",
+        "vid": "0x4161"
+    },
+    "features": {
+        "bootmagic": true,
+        "command": false,
+        "console": false,
+        "extrakey": true,
+        "mousekey": true,
+        "nkro": true,
+        "rgblight": false,
+        "rgb_matrix": true
+    },
+    "diode_direction": "COL2ROW",
+    "matrix_pins": {
+        "cols": ["GP0",  "GP1",  "GP2",  "GP3",  "GP4",  "GP5",  "GP6",
+                 "GP9",  "GP10", "GP11", "GP12", "GP13", "GP14", "GP15"],
+        "rows": ["GP16", "GP17", "GP18", "GP19", "GP20"]
+    },
+    "layouts": {
+        "LAYOUT_ortho_5x14": {
+            "layout": [
+                { "matrix": [0,  0], "x": 0,  "y": 0 },
+                { "matrix": [0,  1], "x": 1,  "y": 0 },
+                { "matrix": [0,  2], "x": 2,  "y": 0 },
+                { "matrix": [0,  3], "x": 3,  "y": 0 },
+                { "matrix": [0,  4], "x": 4,  "y": 0 },
+                { "matrix": [0,  5], "x": 5,  "y": 0 },
+                { "matrix": [0,  6], "x": 6,  "y": 0 },
+                { "matrix": [0,  7], "x": 7,  "y": 0 },
+                { "matrix": [0,  8], "x": 8,  "y": 0 },
+                { "matrix": [0,  9], "x": 9,  "y": 0 },
+                { "matrix": [0, 10], "x": 10, "y": 0 },
+                { "matrix": [0, 11], "x": 11, "y": 0 },
+                { "matrix": [0, 12], "x": 12, "y": 0 },
+                { "matrix": [0, 13], "x": 13, "y": 0 },
+                { "matrix": [1,  0], "x": 0,  "y": 1 },
+                { "matrix": [1,  1], "x": 1,  "y": 1 },
+                { "matrix": [1,  2], "x": 2,  "y": 1 },
+                { "matrix": [1,  3], "x": 3,  "y": 1 },
+                { "matrix": [1,  4], "x": 4,  "y": 1 },
+                { "matrix": [1,  5], "x": 5,  "y": 1 },
+                { "matrix": [1,  6], "x": 6,  "y": 1 },
+                { "matrix": [1,  7], "x": 7,  "y": 1 },
+                { "matrix": [1,  8], "x": 8,  "y": 1 },
+                { "matrix": [1,  9], "x": 9,  "y": 1 },
+                { "matrix": [1, 10], "x": 10, "y": 1 },
+                { "matrix": [1, 11], "x": 11, "y": 1 },
+                { "matrix": [1, 12], "x": 12, "y": 1 },
+                { "matrix": [1, 13], "x": 13, "y": 1 },
+                { "matrix": [2,  0], "x": 0,  "y": 2 },
+                { "matrix": [2,  1], "x": 1,  "y": 2 },
+                { "matrix": [2,  2], "x": 2,  "y": 2 },
+                { "matrix": [2,  3], "x": 3,  "y": 2 },
+                { "matrix": [2,  4], "x": 4,  "y": 2 },
+                { "matrix": [2,  5], "x": 5,  "y": 2 },
+                { "matrix": [2,  6], "x": 6,  "y": 2 },
+                { "matrix": [2,  7], "x": 7,  "y": 2 },
+                { "matrix": [2,  8], "x": 8,  "y": 2 },
+                { "matrix": [2,  9], "x": 9,  "y": 2 },
+                { "matrix": [2, 10], "x": 10, "y": 2 },
+                { "matrix": [2, 11], "x": 11, "y": 2 },
+                { "matrix": [2, 12], "x": 12, "y": 2 },
+                { "matrix": [2, 13], "x": 13, "y": 2 },
+                { "matrix": [3,  0], "x": 0,  "y": 3 },
+                { "matrix": [3,  1], "x": 1,  "y": 3 },
+                { "matrix": [3,  2], "x": 2,  "y": 3 },
+                { "matrix": [3,  3], "x": 3,  "y": 3 },
+                { "matrix": [3,  4], "x": 4,  "y": 3 },
+                { "matrix": [3,  5], "x": 5,  "y": 3 },
+                { "matrix": [3,  6], "x": 6,  "y": 3 },
+                { "matrix": [3,  7], "x": 7,  "y": 3 },
+                { "matrix": [3,  8], "x": 8,  "y": 3 },
+                { "matrix": [3,  9], "x": 9,  "y": 3 },
+                { "matrix": [3, 10], "x": 10, "y": 3 },
+                { "matrix": [3, 11], "x": 11, "y": 3 },
+                { "matrix": [3, 12], "x": 12, "y": 3 },
+                { "matrix": [3, 13], "x": 13, "y": 3 },
+                { "matrix": [4,  0], "x": 0,  "y": 4 },
+                { "matrix": [4,  1], "x": 1,  "y": 4 },
+                { "matrix": [4,  2], "x": 2,  "y": 4 },
+                { "matrix": [4,  3], "x": 3,  "y": 4 },
+                { "matrix": [4,  4], "x": 4,  "y": 4 },
+                { "matrix": [4,  5], "x": 5,  "y": 4 },
+                { "matrix": [4,  6], "x": 6,  "y": 4 },
+                { "matrix": [4,  7], "x": 7,  "y": 4 },
+                { "matrix": [4,  8], "x": 8,  "y": 4 },
+                { "matrix": [4,  9], "x": 9,  "y": 4 },
+                { "matrix": [4, 10], "x": 10, "y": 4 },
+                { "matrix": [4, 11], "x": 11, "y": 4 },
+                { "matrix": [4, 12], "x": 12, "y": 4 },
+                { "matrix": [4, 13], "x": 13, "y": 4 }
+            ]
+        }
+    },
+    "rgblight": {
+        "led_count": 70,
+        "pin": "GP26"
+    },
+    "rgb_matrix": {
+        "driver": "WS2812",
+        "layout": [
+            { "flags": 4, "matrix": [0,  0], "x": 0,   "y": 0  },
+            { "flags": 4, "matrix": [0,  1], "x": 17,  "y": 0  },
+            { "flags": 4, "matrix": [0,  2], "x": 34,  "y": 0  },
+            { "flags": 4, "matrix": [0,  3], "x": 52,  "y": 0  },
+            { "flags": 4, "matrix": [0,  4], "x": 69,  "y": 0  },
+            { "flags": 4, "matrix": [0,  5], "x": 86,  "y": 0  },
+            { "flags": 4, "matrix": [0,  6], "x": 103, "y": 0  },
+            { "flags": 4, "matrix": [0,  7], "x": 121, "y": 0  },
+            { "flags": 4, "matrix": [0,  8], "x": 138, "y": 0  },
+            { "flags": 4, "matrix": [0,  9], "x": 155, "y": 0  },
+            { "flags": 4, "matrix": [0, 10], "x": 172, "y": 0  },
+            { "flags": 4, "matrix": [0, 11], "x": 190, "y": 0  },
+            { "flags": 4, "matrix": [0, 12], "x": 207, "y": 0  },
+            { "flags": 4, "matrix": [0, 13], "x": 224, "y": 0  },
+            { "flags": 4, "matrix": [1,  0], "x": 0,   "y": 16 },
+            { "flags": 4, "matrix": [1,  1], "x": 17,  "y": 16 },
+            { "flags": 4, "matrix": [1,  2], "x": 34,  "y": 16 },
+            { "flags": 4, "matrix": [1,  3], "x": 52,  "y": 16 },
+            { "flags": 4, "matrix": [1,  4], "x": 69,  "y": 16 },
+            { "flags": 4, "matrix": [1,  5], "x": 86,  "y": 16 },
+            { "flags": 4, "matrix": [1,  6], "x": 103, "y": 16 },
+            { "flags": 4, "matrix": [1,  7], "x": 121, "y": 16 },
+            { "flags": 4, "matrix": [1,  8], "x": 138, "y": 16 },
+            { "flags": 4, "matrix": [1,  9], "x": 155, "y": 16 },
+            { "flags": 4, "matrix": [1, 10], "x": 172, "y": 16 },
+            { "flags": 4, "matrix": [1, 11], "x": 190, "y": 16 },
+            { "flags": 4, "matrix": [1, 12], "x": 207, "y": 16 },
+            { "flags": 4, "matrix": [1, 13], "x": 224, "y": 16 },
+            { "flags": 4, "matrix": [2,  0], "x": 0,   "y": 32 },
+            { "flags": 4, "matrix": [2,  1], "x": 17,  "y": 32 },
+            { "flags": 4, "matrix": [2,  2], "x": 34,  "y": 32 },
+            { "flags": 4, "matrix": [2,  3], "x": 52,  "y": 32 },
+            { "flags": 4, "matrix": [2,  4], "x": 69,  "y": 32 },
+            { "flags": 4, "matrix": [2,  5], "x": 86,  "y": 32 },
+            { "flags": 4, "matrix": [2,  6], "x": 103, "y": 32 },
+            { "flags": 4, "matrix": [2,  7], "x": 121, "y": 32 },
+            { "flags": 4, "matrix": [2,  8], "x": 138, "y": 32 },
+            { "flags": 4, "matrix": [2,  9], "x": 155, "y": 32 },
+            { "flags": 4, "matrix": [2, 10], "x": 172, "y": 32 },
+            { "flags": 4, "matrix": [2, 11], "x": 190, "y": 32 },
+            { "flags": 4, "matrix": [2, 12], "x": 207, "y": 32 },
+            { "flags": 4, "matrix": [2, 13], "x": 224, "y": 32 },
+            { "flags": 4, "matrix": [3,  0], "x": 0,   "y": 48 },
+            { "flags": 4, "matrix": [3,  1], "x": 17,  "y": 48 },
+            { "flags": 4, "matrix": [3,  2], "x": 34,  "y": 48 },
+            { "flags": 4, "matrix": [3,  3], "x": 52,  "y": 48 },
+            { "flags": 4, "matrix": [3,  4], "x": 69,  "y": 48 },
+            { "flags": 4, "matrix": [3,  5], "x": 86,  "y": 48 },
+            { "flags": 4, "matrix": [3,  6], "x": 103, "y": 48 },
+            { "flags": 4, "matrix": [3,  7], "x": 121, "y": 48 },
+            { "flags": 4, "matrix": [3,  8], "x": 138, "y": 48 },
+            { "flags": 4, "matrix": [3,  9], "x": 155, "y": 48 },
+            { "flags": 4, "matrix": [3, 10], "x": 172, "y": 48 },
+            { "flags": 4, "matrix": [3, 11], "x": 190, "y": 48 },
+            { "flags": 4, "matrix": [3, 12], "x": 207, "y": 48 },
+            { "flags": 4, "matrix": [3, 13], "x": 224, "y": 48 },
+            { "flags": 4, "matrix": [4,  0], "x": 0,   "y": 64 },
+            { "flags": 4, "matrix": [4,  1], "x": 17,  "y": 64 },
+            { "flags": 4, "matrix": [4,  2], "x": 34,  "y": 64 },
+            { "flags": 4, "matrix": [4,  3], "x": 52,  "y": 64 },
+            { "flags": 4, "matrix": [4,  4], "x": 69,  "y": 64 },
+            { "flags": 4, "matrix": [4,  5], "x": 86,  "y": 64 },
+            { "flags": 4, "matrix": [4,  6], "x": 103, "y": 64 },
+            { "flags": 4, "matrix": [4,  7], "x": 121, "y": 64 },
+            { "flags": 4, "matrix": [4,  8], "x": 138, "y": 64 },
+            { "flags": 4, "matrix": [4,  9], "x": 155, "y": 64 },
+            { "flags": 4, "matrix": [4, 10], "x": 172, "y": 64 },
+            { "flags": 4, "matrix": [4, 11], "x": 190, "y": 64 },
+            { "flags": 4, "matrix": [4, 12], "x": 207, "y": 64 },
+            { "flags": 4, "matrix": [4, 13], "x": 224, "y": 64 }
+        ]
+    }
+}

@@ 0,0 1,62 @@
+/*
+Copyright 2022 an_achronism (@an-achronism)
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+#include QMK_KEYBOARD_H
+
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+    /*
+     * ┌───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┐
+     * │ ` │ 1 │ 2 │ 3 │ 4 │ 5 │ 6 │ 7 │ 8 │ 9 │ 0 │ - │ = │Del│
+     * ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+     * │Tab| Q │ W │ E | R │ T │ Y │ U │ I │ O │ P │ [ │ ] │Bsp│
+     * ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+     * │Ctl│ A │ S │ D │ F │ G │ H │ J │ K │ L │ ; │ ' │UK#│Rtn|
+     * ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+     * │Sft│ Z │ X │ C │ V │ B │ N │ M │ , │ . │ / │Sft│ ↑ │App|
+     * ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+     * │Esc│Ctl│Alt│GUI│L_1│Spc│L_2|GUI│Alt│Ctl|UK\│ ← │ ↓ │ → │
+     * └───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┘
+     */
+    [0] = LAYOUT_ortho_5x14(
+        KC_GRV,  KC_1,    KC_2,    KC_3,    KC_4,    KC_5,    KC_6,    KC_7,    KC_8,    KC_9,    KC_0,    KC_MINS, KC_EQL,  KC_DEL,
+        KC_TAB,  KC_Q,    KC_W,    KC_E,    KC_R,    KC_T,    KC_Y,    KC_U,    KC_I,    KC_O,    KC_P,    KC_LBRC, KC_RBRC, KC_BSPC,
+        KC_LCTL, KC_A,    KC_S,    KC_D,    KC_F,    KC_G,    KC_H,    KC_J,    KC_K,    KC_L,    KC_SCLN, KC_QUOT, KC_NUHS, KC_ENT,
+        KC_LSFT, KC_Z,    KC_X,    KC_C,    KC_V,    KC_B,    KC_N,    KC_M,    KC_COMM, KC_DOT,  KC_SLSH, KC_RSFT, KC_UP, RSFT_T(KC_APP),
+        KC_ESC,  KC_LCTL, KC_LALT, KC_LGUI, MO(1),   KC_SPC,  MO(2),   KC_RGUI, KC_RALT, KC_RCTL, KC_NUBS, KC_LEFT, KC_DOWN, KC_RGHT
+    ),
+    [1] = LAYOUT_ortho_5x14(
+        KC_BRID, KC_BRIU, _______, _______, _______, _______, KC_NUM,  KC_PSLS, KC_PAST, KC_PEQL, _______, _______, _______, KC_PWR,
+        _______, _______, KC_UP,   _______, _______, _______, KC_P7,   KC_P8,   KC_P9,   KC_PMNS, KC_PAUS, KC_ESC,  _______, KC_SLEP,
+        _______, KC_LEFT, KC_DOWN, KC_RGHT, _______, _______, KC_P4,   KC_P5,   KC_P6,   KC_PPLS, _______, _______, _______, KC_CALC,
+        KC_CAPS, _______, _______, _______, _______, KC_PAUS, KC_P1,   KC_P2,   KC_P3,   KC_PENT, _______, KC_CAPS, _______, _______,
+        _______, _______, _______, _______, _______, _______, KC_P0,   KC_PDOT, _______, _______, _______, _______, _______, _______
+    ),
+    [2] = LAYOUT_ortho_5x14(
+        _______, _______, _______, _______, _______, _______, KC_SCRL, _______, _______, _______, KC_MUTE, KC_VOLD, KC_VOLU, KC_MSTP,
+        _______, KC_F4,   KC_F3,   KC_F2,   KC_F1,   _______, KC_HOME, KC_PGDN, KC_PGUP, KC_END, C(KC_BRK), KC_ESC, _______, _______,
+        _______, KC_F8,   KC_F7,   KC_F6,   KC_F5,   _______, KC_LEFT, KC_DOWN, KC_UP,   KC_RGHT, _______, KC_MPRV, KC_MNXT, KC_MPLY,
+        KC_CAPS, KC_F12,  KC_F11,  KC_F10,  KC_F9,  C(KC_BRK),_______, _______, _______, _______, _______, KC_CAPS, _______, KC_PSCR,
+        _______, _______, _______, _______, MO(3),   _______, _______, _______, _______, _______, _______, _______, _______, _______
+    ),
+    [3] = LAYOUT_ortho_5x14(
+        QK_BOOT, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+        _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+        _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+        _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+        _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______
+    )
+};

@@ 0,0 1,30 @@
+/*
+Copyright 2022 an_achronism (@an-achronism)
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+#pragma once
+#define RGB_TRIGGER_ON_KEYDOWN
+
+/* disable debug print */
+//#define NO_DEBUG
+
+/* disable print */
+//#define NO_PRINT
+
+/* disable action features */
+//#define NO_ACTION_LAYER
+//#define NO_ACTION_TAPPING
+//#define NO_ACTION_ONESHOT

@@ 0,0 1,124 @@
+/*
+Copyright 2022 an_achronism (@an-achronism)
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 2 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+#include QMK_KEYBOARD_H
+
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+    /*
+     * ┌───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┐
+     * │ ` │ 1 │ 2 │ 3 │ 4 │ 5 │ 6 │ 7 │ 8 │ 9 │ 0 │ - │ = │Del│
+     * ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+     * │Tab| Q │ W │ E | R │ T │ Y │ U │ I │ O │ P │ [ │ ] │Bsp│
+     * ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+     * │Ctl│ A │ S │ D │ F │ G │ H │ J │ K │ L │ ; │ ' │UK#│Rtn|
+     * ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+     * │Sft│ Z │ X │ C │ V │ B │ N │ M │ , │ . │ / │Sft│ ↑ │App|
+     * ├───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┼───┤
+     * │Esc│Ctl│Alt│GUI│L_1│Spc│L_2|GUI│Alt│Ctl|UK\│ ← │ ↓ │ → │
+     * └───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┘
+     */
+    [0] = LAYOUT_ortho_5x14(
+        KC_GRV,  KC_1,    KC_2,    KC_3,    KC_4,    KC_5,    KC_6,    KC_7,    KC_8,    KC_9,    KC_0,    KC_MINS, KC_EQL,  KC_DEL,
+        KC_TAB,  KC_Q,    KC_W,    KC_E,    KC_R,    KC_T,    KC_Y,    KC_U,    KC_I,    KC_O,    KC_P,    KC_LBRC, KC_RBRC, KC_BSPC,
+        KC_LCTL, KC_A,    KC_S,    KC_D,    KC_F,    KC_G,    KC_H,    KC_J,    KC_K,    KC_L,    KC_SCLN, KC_QUOT, KC_NUHS, KC_ENT,
+        KC_LSFT, KC_Z,    KC_X,    KC_C,    KC_V,    KC_B,    KC_N,    KC_M,    KC_COMM, KC_DOT,  KC_SLSH, KC_RSFT, KC_UP, RSFT_T(KC_APP),
+        KC_ESC,  KC_LCTL, KC_LALT, KC_LGUI, MO(1),   KC_SPC,  MO(2),   KC_RGUI, KC_RALT, KC_RCTL, KC_NUBS, KC_LEFT, KC_DOWN, KC_RGHT
+    ),
+    [1] = LAYOUT_ortho_5x14(
+        KC_BRID, KC_BRIU, _______, _______, _______, _______, KC_NUM,  KC_PSLS, KC_PAST, KC_PEQL, _______, _______, _______, KC_PWR,
+        _______, _______, KC_UP,   _______, _______, _______, KC_P7,   KC_P8,   KC_P9,   KC_PMNS, KC_PAUS, KC_ESC,  _______, KC_SLEP,
+        _______, KC_LEFT, KC_DOWN, KC_RGHT, _______, _______, KC_P4,   KC_P5,   KC_P6,   KC_PPLS, _______, _______, _______, KC_CALC,
+        KC_CAPS, _______, _______, _______, _______, KC_PAUS, KC_P1,   KC_P2,   KC_P3,   KC_PENT, _______, KC_CAPS, _______, _______,
+        _______, _______, _______, _______, _______, _______, KC_P0,   KC_PDOT, _______, _______, _______, _______, _______, _______
+    ),
+    [2] = LAYOUT_ortho_5x14(
+        _______, _______, _______, _______, _______, _______, KC_SCRL, _______, _______, _______, KC_MUTE, KC_VOLD, KC_VOLU, KC_MSTP,
+        _______, KC_F4,   KC_F3,   KC_F2,   KC_F1,   _______, KC_HOME, KC_PGDN, KC_PGUP, KC_END, C(KC_BRK), KC_ESC, _______, _______,
+        _______, KC_F8,   KC_F7,   KC_F6,   KC_F5,   _______, KC_LEFT, KC_DOWN, KC_UP,   KC_RGHT, _______, KC_MPRV, KC_MNXT, KC_MPLY,
+        KC_CAPS, KC_F12,  KC_F11,  KC_F10,  KC_F9,  C(KC_BRK),_______, _______, _______, _______, _______, KC_CAPS, _______, KC_PSCR,
+        _______, _______, _______, _______, MO(3),   _______, _______, _______, _______, _______, _______, _______, _______, _______
+    ),
+    [3] = LAYOUT_ortho_5x14(
+        QK_BOOT, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+        _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+        _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+        _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
+        _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______
+    )
+};
+
+// Initialise RBG matrix with all LEDs set to solid colour and zero HSV (i.e. off):
+void keyboard_post_init_user(void) {
+    rgb_matrix_mode_noeeprom(RGB_MATRIX_SOLID_COLOR);
+    rgb_matrix_sethsv_noeeprom(HSV_OFF);
+};
+
+// Custom RGB indicator behaviour:
+void rgb_matrix_indicators_advanced_user(uint8_t led_min, uint8_t led_max) {
+    uint8_t led_processed_count = 0;
+    for (uint8_t row = 0; row < MATRIX_ROWS; ++row) {
+        for (uint8_t col = 0; col < MATRIX_COLS; ++col) {
+            if (led_processed_count == RGB_MATRIX_LED_PROCESS_LIMIT){
+                return;
+            }
+            uint8_t led_index = g_led_config.matrix_co[row][col];
+            uint16_t keycode = keymap_key_to_keycode(0, (keypos_t){col,row});
+            if (led_index >= led_min && led_index <= led_max && led_index != NO_LED) {
+                // Light base layer arrow keys orange if Scroll Lock is on, otherwise light them magenta:
+                led_processed_count++;
+                if (keycode >= KC_RIGHT && keycode <= KC_UP) {
+                    if (host_keyboard_led_state().scroll_lock) {
+                        rgb_matrix_set_color(led_index, RGB_ORANGE);
+                    } else {
+                        rgb_matrix_set_color(led_index, RGB_MAGENTA);
+                    }
+                }
+                // Light alpha keys (A-Z only) red if Caps Lock is on:
+                if (host_keyboard_led_state().caps_lock && keycode >= KC_A && keycode <= KC_Z) {
+                    rgb_matrix_set_color(led_index, RGB_RED);
+                }
+                // Whenever a layer above base is active, recolour only the keys that are different on that layer:
+                if (get_highest_layer(layer_state) > 0) {
+                    uint8_t layer = get_highest_layer(layer_state);
+                    uint16_t momentary_keycode = keymap_key_to_keycode(layer, (keypos_t){col,row});
+                    if (momentary_keycode > KC_TRNS) {
+                        switch(layer) {
+                            case 2:
+                                // The uppermost layer is blue:
+                                rgb_matrix_set_color(led_index, RGB_BLUE);
+                                break;
+                            case 1:
+                                // The middle layer is green, except that the numpad section turns
+                                // orange when Num Lock is on:
+                                if (host_keyboard_led_state().num_lock &&
+                                (momentary_keycode == KC_KP_EQUAL ||
+                                (momentary_keycode >= KC_NUM_LOCK && momentary_keycode <= KC_KP_DOT)
+                                )) {
+                                    rgb_matrix_set_color(led_index, RGB_ORANGE);
+                                } else {
+                                    rgb_matrix_set_color(led_index, RGB_GREEN);
+                                }
+                                break;
+                            default:
+                                break;
+                        }   
+                    }
+                }
+            }
+        }
+    }
+}

@@ 0,0 1,2 @@
+# Use dedicated PIO on Raspberry Pi Pico for RGB LEDs:
+WS2812_DRIVER = vendor