Skip to content

Commit

Permalink
Initial support for Tetromino added (qmk#18341)
Browse files Browse the repository at this point in the history 
by the spherical lad @an-achronism
  • Loading branch information
@an-achronism @ramonimbao
an-achronism authored and ramonimbao committed Nov 28, 2022
1 parent 623ba93 commit 73bba0f
Show file tree
Hide file tree
Showing 7 changed files with 475 additions and 0 deletions.
42 changes: 42 additions & 0 deletions keyboards/an_achronism/tetromino/README.md
View file
Original file line number Diff line number Diff line change
@@ -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!
31 changes: 31 additions & 0 deletions keyboards/an_achronism/tetromino/config.h
View file
Original file line number Diff line number Diff line change
@@ -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
184 changes: 184 additions & 0 deletions keyboards/an_achronism/tetromino/info.json
View file
Original file line number Diff line number Diff line change
@@ -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 }
]
}
}
62 changes: 62 additions & 0 deletions keyboards/an_achronism/tetromino/keymaps/default/keymap.c
View file
Original file line number Diff line number Diff line change
@@ -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, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
_______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
_______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
_______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______,
_______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______
)
};
Loading

0 comments on commit 73bba0f

Please sign in to comment.