[Keyboard] Add cest73/tkm keyboard (#13939)

Co-authored-by: Joel Challis <git@zvecr.com>
Co-authored-by: Ryan <fauxpark@gmail.com>
Co-authored-by: cest <cest@localhost>

7 files changed, 382 insertions, 0 deletions

diff --git a/keyboards/cest73/tkm/config.h b/keyboards/cest73/tkm/config.h
new file mode 100644
index 0000000000..deef979b2c
--- /dev/null
+++ b/keyboards/cest73/tkm/config.h
@@ -0,0 +1,55 @@
+ /* Copyright 2021 cest73 
+  * 
+  * 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
+
+#include "config_common.h"
+
+/* USB Device descriptor parameter */
+#define VENDOR_ID       0xBADD
+#define PRODUCT_ID      0xAA55
+#define DEVICE_VER      0x0001
+#define MANUFACTURER    cest73
+#define PRODUCT         TKM-2021 R1.03
+
+/* key matrix size */
+#define MATRIX_ROWS 11
+#define MATRIX_COLS 10
+
+/* matrix sz handy ruler:  1   2   3   4   5   6   7   8   9  10  11  12 */
+/* key matrix pins */
+/*    row    handy ruler: r0  r1  r2  r3  r4  r5  r6  r7  r8  r9  r10 */
+#define MATRIX_ROW_PINS { B0, B1, B2, B3, B4, B5, B6, B7, C6, C7, D0 }
+/*    column handy ruler: c0  c1  c2  c3  c4  c5  c6  c7  c8  c9 */
+#define MATRIX_COL_PINS { D1, D2, D3, D4, D5, D6, D7, F0, F1, F4 }
+#define UNUSED_PINS { AF }
+
+//NOTE: if D6 pin shows any issues in exploatation the LED on the Teensy is to be removed
+
+#define LED_NUM_LOCK_PIN F6
+#define LED_CAPS_LOCK_PIN F5
+#define LED_SCROLL_LOCK_PIN F7
+#define LED_PIN_ON_STATE 0
+//TODO change the E6 pin to either B5, B6, B7 or C6 to utilize hardware PWM on a future PCB revision
+#define BACKLIGHT_PIN E6
+
+/* COL2ROW or ROW2COL */
+#define DIODE_DIRECTION COL2ROW
+
+/* Set 0 if debouncing isn't needed */
+#define DEBOUNCE 5
+
+/* force n-key rollover*/
+#define FORCE_NKRO
diff --git a/keyboards/cest73/tkm/info.json b/keyboards/cest73/tkm/info.json
new file mode 100644
index 0000000000..1118be836e
--- /dev/null
+++ b/keyboards/cest73/tkm/info.json
@@ -0,0 +1,122 @@
+{
+    "keyboard_name": "TKM 2021",
+    "url": "https://geekhack.org/index.php?topic=110499",
+    "maintainer": "cest73 (aka fire-h0und)",
+    "width": 21,
+    "height": 6.75,
+    "layouts": {
+        "LAYOUT_all": {
+            "layout": [
+              {"label":"Fn", "x":0, "y":0},
+              {"label":"PrtSc", "x":1, "y":0},
+              {"label":"Scroll Lock", "x":2, "y":0},
+              {"label":"Pause", "x":3, "y":0},
+              {"label":"Esc", "x":4.5, "y":0},
+              {"label":"F1", "x":6, "y":0},
+              {"label":"F2", "x":7, "y":0},
+              {"label":"F3", "x":8, "y":0},
+              {"label":"F4", "x":9, "y":0},
+              {"label":"F5", "x":10.25, "y":0},
+              {"label":"F6", "x":11.25, "y":0},
+              {"label":"F7", "x":12.25, "y":0},
+              {"label":"F8", "x":13.25, "y":0},
+              {"label":"F9", "x":14.5, "y":0},
+              {"label":"F10", "x":15.5, "y":0},
+              {"label":"F11", "x":16.5, "y":0},
+              {"label":"F12", "x":17.5, "y":0},
+              {"label":"Home", "x":19, "y":0},
+              {"label":"PgUp", "x":20, "y":0},
+
+              {"label":"-", "x":0, "y":1.5},
+              {"label":"*", "x":1, "y":1.5},
+              {"label":"/", "x":2, "y":1.5},
+              {"label":"Num Lock", "x":3, "y":1.5},
+              {"label":"~", "x":4.5, "y":1.5},
+              {"label":"!", "x":5.5, "y":1.5},
+              {"label":"\"", "x":6.5, "y":1.5},
+              {"label":"\u00a3", "x":7.5, "y":1.5},
+              {"label":"$", "x":8.5, "y":1.5},
+              {"label":"%", "x":9.5, "y":1.5},
+              {"label":"^", "x":10.5, "y":1.5},
+              {"label":"&", "x":11.5, "y":1.5},
+              {"label":"*", "x":12.5, "y":1.5},
+              {"label":"(", "x":13.5, "y":1.5},
+              {"label":")", "x":14.5, "y":1.5},
+              {"label":"_", "x":15.5, "y":1.5},
+              {"label":"+", "x":16.5, "y":1.5},
+              {"label":"Backspace", "x":17.5, "y":1.5, "w":2},
+              {"label":"Insert", "x":20, "y":1.5},
+
+              {"label":"+", "x":0, "y":2.5, "h":2},
+              {"label":"9", "x":1, "y":2.5},
+              {"label":"8", "x":2, "y":2.5},
+              {"label":"7", "x":3, "y":2.5},
+              {"label":"Tab", "x":4.5, "y":2.5, "w":1.5},
+              {"label":"Q", "x":6, "y":2.5},
+              {"label":"W", "x":7, "y":2.5},
+              {"label":"E", "x":8, "y":2.5},
+              {"label":"R", "x":9, "y":2.5},
+              {"label":"T", "x":10, "y":2.5},
+              {"label":"Y", "x":11, "y":2.5},
+              {"label":"U", "x":12, "y":2.5},
+              {"label":"I", "x":13, "y":2.5},
+              {"label":"O", "x":14, "y":2.5},
+              {"label":"P", "x":15, "y":2.5},
+              {"label":"{", "x":16, "y":2.5},
+              {"label":"}", "x":17, "y":2.5},
+              {"label":"Enter", "x":18.25, "y":2.5, "w":1.25, "h":2},
+              {"label":"Delete", "x":20, "y":2.5},
+
+              {"label":"6", "x":1, "y":3.5},
+              {"label":"5", "x":2, "y":3.5},
+              {"label":"4", "x":3, "y":3.5},
+              {"label":"CAPS", "x":4.5, "y":3.5, "w":1.25},
+              {"label":"A", "x":6.25, "y":3.5},
+              {"label":"S", "x":7.25, "y":3.5},
+              {"label":"D", "x":8.25, "y":3.5},
+              {"label":"F", "x":9.25, "y":3.5},
+              {"label":"G", "x":10.25, "y":3.5},
+              {"label":"H", "x":11.25, "y":3.5},
+              {"label":"J", "x":12.25, "y":3.5},
+              {"label":"K", "x":13.25, "y":3.5},
+              {"label":"L", "x":14.25, "y":3.5},
+              {"label":":", "x":15.25, "y":3.5},
+              {"label":"@", "x":16.25, "y":3.5},
+              {"label":"|", "x":17.25, "y":3.5},
+              {"label":"PgDn", "x":20, "y":3.5},
+
+              {"label":"Enter", "x":0, "y":4.5, "h":2},
+              {"label":"3", "x":1, "y":4.5},
+              {"label":"2", "x":2, "y":4.5},
+              {"label":"1", "x":3, "y":4.5},
+              {"label":"Shift", "x":4.5, "y":4.5, "w":2.25},
+              {"label":"Z", "x":6.75, "y":4.5},
+              {"label":"X", "x":7.75, "y":4.5},
+              {"label":"C", "x":8.75, "y":4.5},
+              {"label":"V", "x":9.75, "y":4.5},
+              {"label":"B", "x":10.75, "y":4.5},
+              {"label":"N", "x":11.75, "y":4.5},
+              {"label":"M", "x":12.75, "y":4.5},
+              {"label":"<", "x":13.75, "y":4.5},
+              {"label":">", "x":14.75, "y":4.5},
+              {"label":"?", "x":15.75, "y":4.5},
+              {"label":"Shift", "x":16.75, "y":4.5, "w":1.75},
+              {"label":"End", "x":20, "y":4.5},
+              {"label":"\u2191", "x":18.75, "y":4.75},
+
+              {"label":".", "x":1, "y":5.5},
+              {"label":"0", "x":2, "y":5.5, "w":2},
+              {"label":"Ctrl", "x":4.5, "y":5.5, "w":1.25},
+              {"label":"Win", "x":5.75, "y":5.5},
+              {"label":"Alt", "x":6.75, "y":5.5, "w":1.25},
+              {"label":"Mod1", "x":8, "y":5.5, "w":1.5},
+              {"label":"Space", "x":8, "y":5.5, "w":6.25},
+              {"label":"AltGr", "x":14.25, "y":5.5},
+              {"label":"Menu", "x":15.25, "y":5.5},
+              {"label":"Ctrl", "x":16.25, "y":5.5, "w":1.25},
+              {"label":"\u2190", "x":17.75, "y":5.75},
+              {"label":"\u2193", "x":18.75, "y":5.75},
+              {"label":"\u2192", "x":19.75, "y":5.75}]
+        }
+    }
+}
diff --git a/keyboards/cest73/tkm/keymaps/default/keymap.c b/keyboards/cest73/tkm/keymaps/default/keymap.c
new file mode 100644
index 0000000000..0fa9ea921d
--- /dev/null
+++ b/keyboards/cest73/tkm/keymaps/default/keymap.c
@@ -0,0 +1,79 @@
+ /* Copyright 2021 cest73 
+  * 
+  * 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
+
+// Defines names for use in layer keycodes and the keymap
+enum layer_names {
+		_BASE,
+		_FN
+};
+
+/*
+ * ┌───┬───┬───┬───┐ ┌───┐ ┌───┬───┬───┬───┐┌───┬───┬───┬───┐┌───┬───┬───┬───┐ ┌───┬───┐
+ * │Fn │PSc│Scr│Pse│ │Esc│ │F1 │F2 │F3 │F4 ││F5 │F6 │F7 │F8 ││F9 │F10│F11│F12│ │Hme│PgU│
+ * └───┴───┴───┴───┘ └───┘ └───┴───┴───┴───┘└───┴───┴───┴───┘└───┴───┴───┴───┘ └───┴───┘
+ *
+ * ┌───┬───┬───┬───┐ ┌───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┐ ┌───┐
+ * │ - │ * │ / │Num│ │ ` │ 1 │ 2 │ 3 │ 4 │ 5 │ 6 │ 7 │ 8 │ 9 │ 0 │ - │ = │Bsl│Bsp│ │Ins│
+ * ├───┼───┼───┼───┤ ├───┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴───┤ ├───┤
+ * │ + │ 9 │ 8 │ 7 │ │ Tab │ Q │ W │ E │ R │ T │ Y │ U │ I │ O │ P │ [ │ ] │  \  │ │Del│
+ * ├───┼───┼───┼───┤ ├─────┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬────│ ├───┤
+ * │ = │ 6 │ 5 │ 4 │ │ Caps │ A │ S │ D │ F │ G │ H │ J │ K │ L │ ; │ ' │Etl│ Ent│ │PgD│
+ * ├───┼───┼───┼───┤ ├────┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴───┴┬───┘ ├───┤
+ * │Tab│ 3 │ 2 │ 1 │ │Shft│Shl│ Z │ X │ C │ V │ B │ N │ M │ , │ . │ / │ Shift│┌───┐│End│
+ * ├───┼───┼───┼───┤ ├────┼───┼───┴┬──┴───┴───┴───┴───┴───┴─┬─┴─┬─┴─┬─┴──┬───┘│ ↑ │└───┘
+ * │Ent│ . │ , │ 0 │ │Ctrl│GUI│Alt │                        │Alt│Mnu│Ctrl│┌───┼───┼───┐
+ * └───┴───┴───┴───┘ └────┴───┴────┴────────────────────────┴───┴───┴────┘│ ← │ ↓ │ → │
+ *                                                                        └───┴───┴───┘
+ */
+ /*
+ * ┌───┬───┬───┬───┐ ┌───┐ ┌───┬───┬───┬───┐┌───┬───┬───┬───┐┌───┬───┬───┬───┐ ┌───┬───┐
+ * │   │   │   │   │ │Rst│ │   │   │   │   ││   │   │   │   ││   │   │   │   │ │   │   │
+ * └───┴───┴───┴───┘ └───┘ └───┴───┴───┴───┘└───┴───┴───┴───┘└───┴───┴───┴───┘ └───┴───┘
+ *
+ * ┌───┬───┬───┬───┐ ┌───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┐ ┌───┐
+ * │   │   │   │   │ │   │   │   │   │   │   │   │   │   │   │   │   │   │   │   │ │   │
+ * ├───┼───┼───┼───┤ ├───┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴───┤ ├───┤
+ * │   │   │   │   │ │     │   │   │   │   │   │   │   │   │   │   │   │   │     │ │   │
+ * ├───┼───┼───┼───┤ ├─────┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬────│ ├───┤
+ * │   │   │   │   │ │      │   │   │   │   │   │ ← │ ↑ │ ↓ │ → │   │   │   │ Ent│ │   │
+ * ├───┼───┼───┼───┤ ├────┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴───┴┬───┘ ├───┤
+ * │   │   │   │   │ │Shft│   │   │   │   │   │   │   │   │   │   │   │ Shift│┌───┐│   │
+ * ├───┼───┼───┼───┤ ├────┼───┼───┴┬──┴───┴───┴───┴───┴───┴─┬─┴─┬─┴─┬─┴──┬───┘│ ↑ │└───┘
+ * │   │   │   │   │ │Ctrl│GUI│Alt │                        │Alt│Mnu│Ctrl│┌───┼───┼───┐
+ * └───┴───┴───┴───┘ └────┴───┴────┴────────────────────────┴───┴───┴────┘│ ← │ ↓ │ → │
+ *                                                                        └───┴───┴───┘
+ */
+
+
+const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
+	[_BASE] = LAYOUT_all(
+	MO(1),   KC_PSCR, KC_SLCK, KC_PAUS, KC_ESC,      KC_F1,   KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_F9,   KC_F10,  KC_F11,  KC_F12,       KC_HOME, KC_PGUP,
+	KC_PMNS, KC_PAST, KC_PSLS, KC_NLCK, 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_BSLS, KC_BSPC,     KC_INS,
+	KC_PPLS, KC_P9,   KC_P8,   KC_P7,   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_BSLS,    KC_DEL,
+	KC_PEQL, KC_P6,   KC_P5,   KC_P4,   KC_CAPS,       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_PGDN,
+	KC_TAB,  KC_P3,   KC_P2,   KC_P1,   KC_LSFT, KC_NUBS,  KC_Z,  KC_X,  KC_C,  KC_V,  KC_B,  KC_N,  KC_M,  KC_COMM, KC_DOT,  KC_SLSH,   KC_RSFT,        KC_UP,  KC_END,
+	KC_PENT, KC_PDOT, KC_PCMM, KC_P0,   KC_LCTL, KC_LGUI, KC_LALT,                      KC_SPC,                  KC_RALT, KC_APP, KC_RCTL,     KC_LEFT, KC_DOWN, KC_RGHT
+	),
+	[_FN] = LAYOUT_all(
+	KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,  RESET,        KC_F13,  KC_F14,  KC_F15,  KC_F16,  KC_F17,  KC_F18,  KC_F19,  KC_F20,  KC_F21,  KC_F22,  KC_F23,  KC_F24,       KC_TRNS, KC_TRNS,
+	KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,  KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,  KC_TRNS,
+	KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,  KC_TRNS,      KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,     KC_TRNS,  KC_TRNS,
+	KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,  KC_TRNS,        KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_LEFT,   KC_UP, KC_DOWN, KC_RGHT, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,    KC_TRNS,
+	KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,  KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,  KC_TRNS,
+	KC_TRNS, KC_TRNS, KC_TRNS, KC_TRNS,  KC_TRNS, KC_TRNS, KC_TRNS,                   KC_TRNS,                   KC_TRNS, KC_TRNS, KC_TRNS,           KC_TRNS, KC_TRNS, KC_TRNS
+	)
+};
diff --git a/keyboards/cest73/tkm/readme.md b/keyboards/cest73/tkm/readme.md
new file mode 100644
index 0000000000..947cc26779
--- /dev/null
+++ b/keyboards/cest73/tkm/readme.md
@@ -0,0 +1,22 @@
+# Ten Key Mirrored - 2021
+
+![TKM-2021](https://imgur.com/AlvRk1zh.jpg)
+
+Another take on left side numpad and this time mirrored too for the ever more spacious mouse playground.
+
+* Keyboard Maintainer: cest73 (aka fire-h0und)
+* Hardware Supported: TKM-2021 (multiple layouts and switch options including ALPS, ISO and BAE)
+* Hardware Availability: https://geekhack.org/index.php?topic=110499
+
+
+Make example for this keyboard (after setting up your build environment):
+
+    qmk compile -kb cest73/tkm -km default
+
+As the board uses Teensy 2.0 as a daughter board, to bring the board into flash mode is it sufficient to press the button present on the Teensy.
+
+[TKM-2021 PCB](https://geekhack.org/index.php?action=dlattach;topic=110499.0;attach=268641;image)
+
+Despite many hours gazing over the schematics there was a nasty error on the first batch: namely the 6 and 7 columns got swapped in the design process. Luckily it was trivial to fix in the firmware section (see the comments in the layout file(s)).
+
+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).
diff --git a/keyboards/cest73/tkm/rules.mk b/keyboards/cest73/tkm/rules.mk
new file mode 100644
index 0000000000..43420532f5
--- /dev/null
+++ b/keyboards/cest73/tkm/rules.mk
@@ -0,0 +1,22 @@
+# MCU name
+MCU = atmega32u4
+
+# Bootloader selection
+BOOTLOADER = halfkay
+
+# Build Options
+#   change yes to no to disable
+#
+BOOTMAGIC_ENABLE = full     # Virtual DIP switch configuration
+MOUSEKEY_ENABLE = no        # Mouse keys
+EXTRAKEY_ENABLE = yes       # Audio control and System control
+CONSOLE_ENABLE = no         # Console for debug
+COMMAND_ENABLE = no         # Commands for debug and configuration
+# Do not enable SLEEP_LED_ENABLE. it uses the same timer as BACKLIGHT_ENABLE
+SLEEP_LED_ENABLE = no       # Breathing sleep LED during USB suspend
+# if this doesn't work, see here: https://github.com/tmk/tmk_keyboard/wiki/FAQ#nkro-doesnt-work
+NKRO_ENABLE = yes           # USB Nkey Rollover
+BACKLIGHT_ENABLE = yes      # Enable keyboard backlight functionality
+RGBLIGHT_ENABLE = no        # Enable keyboard RGB underglow
+BLUETOOTH_ENABLE = no       # Enable Bluetooth
+AUDIO_ENABLE = no           # Audio output
diff --git a/keyboards/cest73/tkm/tkm.c b/keyboards/cest73/tkm/tkm.c
new file mode 100644
index 0000000000..b127e9eb53
--- /dev/null
+++ b/keyboards/cest73/tkm/tkm.c
@@ -0,0 +1,16 @@
+ /* Copyright 2021 cest73 
+  * 
+  * 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 "tkm.h"
diff --git a/keyboards/cest73/tkm/tkm.h b/keyboards/cest73/tkm/tkm.h
new file mode 100644
index 0000000000..e846f5f597
--- /dev/null
+++ b/keyboards/cest73/tkm/tkm.h
@@ -0,0 +1,66 @@
+ /* Copyright 2021 cest73 
+  * 
+  * 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
+
+#include "quantum.h"
+
+/* This a shortcut to help you visually see your layout.
+ * The first section contains "names" for physical keys of the keyboard
+ * and defines their position on the board.
+ * The second section defines position of the keys on the switch matrix
+ * (where COLUMNS and ROWS crosses). 
+ This looks so much better in an terminal window :-(*/
+ /*
+ * ┌───┬───┬───┬───┐ ┌───┐ ┌───┬───┬───┬───┐┌───┬───┬───┬───┐┌───┬───┬───┬───┐ ┌───┬───┐
+ * │Fn │PSc│Scr│Pse│ │Esc│ │F1 │F2 │F3 │F4 ││F5 │F6 │F7 │F8 ││F9 │F10│F11│F12│ │Hme│PgU│
+ * └───┴───┴───┴───┘ └───┘ └───┴───┴───┴───┘└───┴───┴───┴───┘└───┴───┴───┴───┘ └───┴───┘
+ *
+ * ┌───┬───┬───┬───┐ ┌───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┬───┐ ┌───┐
+ * │ - │ * │ / │Num│ │ ` │ 1 │ 2 │ 3 │ 4 │ 5 │ 6 │ 7 │ 8 │ 9 │ 0 │ - │ = │Bsl│Bsp│ │Ins│
+ * ├───┼───┼───┼───┤ ├───┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴───┤ ├───┤
+ * │ + │ 9 │ 8 │ 7 │ │ Tab │ Q │ W │ E │ R │ T │ Y │ U │ I │ O │ P │ [ │ ] │  \  │ │Del│
+ * ├───┼───┼───┼───┤ ├─────┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬──┴┬────│ ├───┤
+ * │ = │ 6 │ 5 │ 4 │ │ Caps │ A │ S │ D │ F │ G │ H │ J │ K │ L │ ; │ ' │Etl│ Ent│ │PgD│
+ * ├───┼───┼───┼───┤ ├────┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴─┬─┴───┴┬───┘ ├───┤
+ * │Tab│ 3 │ 2 │ 1 │ │Shft│Shl│ Z │ X │ C │ V │ B │ N │ M │ , │ . │ / │ Shift│┌───┐│End│
+ * ├───┼───┼───┼───┤ ├────┼───┼───┴┬──┴───┴───┴───┴───┴───┴─┬─┴─┬─┴─┬─┴──┬───┘│ ↑ │└───┘
+ * │Ent│ . │ , │ 0 │ │Ctrl│GUI│Alt │                        │Alt│Mnu│Ctrl│┌───┼───┼───┐
+ * └───┴───┴───┴───┘ └────┴───┴────┴────────────────────────┴───┴───┴────┘│ ← │ ↓ │ → │
+ *                                                                        └───┴───┴───┘
+ */
+// due to a nasty PCB layout bug the R1.03 board has "6" and "7" keyboard coulmns swapped...
+
+#define LAYOUT_all( \
+    k00, k10, k01, k11,    k02,      k12, k03, k13, k04, k14, k15, k05, k06, k16, k07, k17, k08,    k18, k09, \
+\
+    k20, k30, k21, k31,    k22, k32, k23, k33, k24, k34, k35, k25, k26, k36, k27, k37, k28, k19, k38,    k29, \
+    k40, k50, k41, k51,    k42, k52, k43, k53, k44, k54, k55, k45, k46, k56, k47, k57, k48, k58,         k49, \
+    k60, k70, k61, k71,    k62, k72, k63, k73, k64, k74, k75, k65, k66, k76, k67, k77, k68, k78,         k69, \
+    k39, k90, k81, k91,    k82, k92, k83, k93, k84, k94, k95, k85, k86, k96, k87, k97, k88,       k98,   k89, \
+    k80, kA0, k59, kA1,    kA2, kA3, kA4,                kA5,                kA6, kA7, kA8,  kA9, k99, k79 \
+) { \
+    { k00, k01, k02, k03, k04, k05, k06, k07, k08, k09 }, \
+    { k10, k11, k12, k13, k14, k15, k16, k17, k18, k19 }, \
+    { k20, k21, k22, k23, k24, k25, k26, k27, k28, k29 }, \
+    { k30, k31, k32, k33, k34, k35, k36, k37, k38, k39 }, \
+    { k40, k41, k42, k43, k44, k45, k46, k47, k48, k49 }, \
+    { k50, k51, k52, k53, k54, k55, k56, k57, k58, k59 }, \
+    { k60, k61, k62, k63, k64, k65, k66, k67, k68, k69 }, \
+    { k70, k71, k72, k73, k74, k75, k76, k77, k78, k79 }, \
+    { k80, k81, k82, k83, k84, k85, k86, k87, k88, k89 }, \
+    { k90, k91, k92, k93, k94, k95, k96, k97, k98, k99 }, \
+    { kA0, kA1, kA2, kA3, kA4, kA5, kA6, kA7, kA8, kA9 } \
+}