From 9ac0e522bbb5fb30015dee26ee95c96d62a54010 Mon Sep 17 00:00:00 2001 From: Tim Eastwood Date: Tue, 24 Jun 2025 13:22:04 +1000 Subject: [PATCH 1/7] rii/518bt usb keyboard added --- keyboards/rii/518bt/keyboard.json | 137 ++++++++++++++++++ keyboards/rii/518bt/keymaps/default/keymap.c | 62 ++++++++ keyboards/rii/518bt/keymaps/default/readme.md | 5 + keyboards/rii/518bt/keymaps/default/rules.mk | 4 + keyboards/rii/518bt/readme.md | 42 ++++++ 5 files changed, 250 insertions(+) create mode 100644 keyboards/rii/518bt/keyboard.json create mode 100644 keyboards/rii/518bt/keymaps/default/keymap.c create mode 100644 keyboards/rii/518bt/keymaps/default/readme.md create mode 100644 keyboards/rii/518bt/keymaps/default/rules.mk create mode 100644 keyboards/rii/518bt/readme.md diff --git a/keyboards/rii/518bt/keyboard.json b/keyboards/rii/518bt/keyboard.json new file mode 100644 index 00000000000..31d7e0f5c05 --- /dev/null +++ b/keyboards/rii/518bt/keyboard.json @@ -0,0 +1,137 @@ +{ + "keyboard_name": "518bt", + "manufacturer": "Rii", + "maintainer": "tim-eastwood", + "usb": { + "vid": "0xFEED", + "pid": "0x0011", + "device_version": "0.0.1" + }, + "backlight": { + "pin": "B0", + "driver": "software", + "levels": 7 + }, + "bootmagic": { + "enabled": true, + "matrix": [5,0] + }, + "indicators": { + "caps_lock": "B1", + "on_state": 1 + }, + "features": { + "backlight": true, + "bootmagic": true, + "command": true, + "console": true, + "extrakey": true, + "mousekey": false, + "nkro": true + }, + "qmk": { + "locking": { + "enabled": true, + "resync": true + } + }, + "matrix_pins": { + "cols": [ + "A7", + "A6", + "A15", + "B3", + "B4", + "B5", + "B6", + "B7", + "B8", + "B9", + "C13", + "C14" + ], + "rows": ["A14", "A1", "A2", "A3", "A4", "A5"] + }, + "diode_direction": "COL2ROW", + "processor": "STM32F072", + "bootloader": "stm32-dfu", + "layouts": { + "LAYOUT": { + "layout": [ + { "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, 11], "x": 10, "y": 0, "w": 2 }, + + { "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": [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": [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": [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, "w": 2 }, + + { "matrix": [5, 0], "x": 0, "y": 5, "w": 2 }, + { "matrix": [5, 1], "x": 2, "y": 5 }, + { "matrix": [5, 2], "x": 3, "y": 5 }, + { "matrix": [5, 4], "x": 4, "y": 5 }, + { "matrix": [5, 5], "x": 5, "y": 5 }, + { "matrix": [5, 6], "x": 6, "y": 5 }, + { "matrix": [5, 7], "x": 7, "y": 5 }, + { "matrix": [5, 8], "x": 8, "y": 5 }, + { "matrix": [5, 9], "x": 10, "y": 5 }, + { "matrix": [5, 10], "x": 11, "y": 5 }, + { "matrix": [5, 11], "x": 12, "y": 5 } + ] + } + } +} diff --git a/keyboards/rii/518bt/keymaps/default/keymap.c b/keyboards/rii/518bt/keymaps/default/keymap.c new file mode 100644 index 00000000000..4b638d75ef0 --- /dev/null +++ b/keyboards/rii/518bt/keymaps/default/keymap.c @@ -0,0 +1,62 @@ +#include QMK_KEYBOARD_H +#define CTALDEL LCTL(LALT(KC_DEL)) + +bool process_record_user(uint16_t keycode, keyrecord_t *record) { + // If console is enabled, it will print the matrix position and status of each key pressed +#ifdef CONSOLE_ENABLE + uprintf("KL: kc: 0x%04X, col: %2u, row: %2u, pressed: %u, time: %5u, int: %u, count: %u\n", keycode, record->event.key.col, record->event.key.row, record->event.pressed, record->event.time, record->tap.interrupted, record->tap.count); +#endif + return true; +} + +/* Qwerty + * .----------------------------------------------------------------------------. + * |light | home | GUI | MUTE | VOL- | VOL+ | Prev | Pause| Next | Bksp | + * .------+------+------+------+------+------+------+------+------+------+------+------| + * | Esc | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 0 | ~ | + * |------+------+------+------+------+------+------+------+------+------+------+------| + * | Tab | Q | W | E | R | T | Y | U | I | O | P | | | + * |------+------+------+------+------+-------------+------+------+------+------+------| + * | Caps | A | S | D | F | G | H | J | K | L | ; | " | + * |------+------+------+------+------+------|------+------+------+------+------+------| + * | Shift| Z | X | C | V | B | N | M | ? | Up | Enter | + * |------+------+------+------+------+------+------+------+------+------+------+------| + * | Fn | Ctrl | Alt | - | = | Space | Down | Left | Right| + * `-----------------------------------------------------------------------------------' + */ + +const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = { + [0] = LAYOUT( + BL_TOGG, KC_F1, KC_LGUI, KC_MUTE, KC_VOLD, KC_VOLU, KC_MPRV, KC_MPLY, KC_MNXT, KC_BSPC, + KC_ESC, KC_1, KC_2, KC_3, KC_4, KC_5, KC_6, KC_7, KC_8, KC_9, KC_0, KC_GRV, + KC_TAB, KC_Q, KC_W, KC_E, KC_R, KC_T, KC_Y, KC_U, KC_I, KC_O, KC_P, KC_BSLS, + 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_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_SLSH, KC_UP, KC_ENT, + TT(1), KC_LCTL, KC_LALT, KC_MINS, KC_EQL, KC_SPC, KC_SPC, KC_SPC, KC_DOWN, KC_LEFT, KC_RGHT + ), + + /* Qwerty + * .----------------------------------------------------------------------------. + * | | F1 | F2 | F3 | F4 | F5 | F6 | F7 | F8 | Del | + * .------+------+------+------+------+------+------+------+------+------+------+------| + * | | | | | | | | | F9 | F10 | F11 | F12 | + * |------+------+------+------+------+------+------+------+------+------+------+------| + * | | | | | | | | | | | [ | ] | + * |------+------+------+------+------+-------------+------+------+------+------+------| + * | | | | | | | | | < | > | { | } | + * |------+------+------+------+------+------|------+------+------+------+------+------| + * | | | | | | | | , | . | PgUp | CTRL+ALT+DEL| + * |------+------+------+------+------+------+------+------+------+------+------+------| + * | | | | | | | PgDn | Home | End | + * `-----------------------------------------------------------------------------------' + */ + + [1] = LAYOUT( + BL_STEP, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_F7, KC_F8, KC_DEL, + _______, _______, _______, _______, _______, _______, _______, _______, KC_F9, KC_F10, KC_F11, KC_F12, + _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, KC_LBRC, KC_RBRC, + _______, _______, _______, _______, _______, _______, _______, _______, KC_LT, KC_GT, KC_LCBR, KC_RCBR, + _______, _______, _______, _______, _______, _______, _______, KC_COMM, KC_DOT, KC_PGUP, CTALDEL, + _______, _______, _______, _______, _______, _______, _______, _______, KC_PGDN, KC_HOME, KC_END + ) +}; diff --git a/keyboards/rii/518bt/keymaps/default/readme.md b/keyboards/rii/518bt/keymaps/default/readme.md new file mode 100644 index 00000000000..480e94a1551 --- /dev/null +++ b/keyboards/rii/518bt/keymaps/default/readme.md @@ -0,0 +1,5 @@ +# The default keymap for rii 518bt USB + +Based on this layout: https://www.keyboard-layout-editor.com/#/gists/70694950d14d5aae1ed446701dd83b74 + +- Based on custom PCB, using original key membrane and layout / legend diff --git a/keyboards/rii/518bt/keymaps/default/rules.mk b/keyboards/rii/518bt/keymaps/default/rules.mk new file mode 100644 index 00000000000..f5671a8f013 --- /dev/null +++ b/keyboards/rii/518bt/keymaps/default/rules.mk @@ -0,0 +1,4 @@ +BACKLIGHT_ENABLE = yes +NKRO_ENABLE = yes +COMMAND_ENABLE = yes +EXTRAKEY_ENABLE = yes \ No newline at end of file diff --git a/keyboards/rii/518bt/readme.md b/keyboards/rii/518bt/readme.md new file mode 100644 index 00000000000..a123287196e --- /dev/null +++ b/keyboards/rii/518bt/readme.md @@ -0,0 +1,42 @@ +Rii 518BT (Custom USB PCB) +=== + +This firmware is used with [a custom PCB](https://github.com/tim-eastwood/rii-518bt-usb-qmk-pcb) to replace the original, which is Bluetooth-only, in the Rii 518BT. The drop-in replacement provides a USB2.0 interface, better backlighting, and of course supports QMK. + +![Rii 518BT](https://raw.githubusercontent.com/tim-eastwood/rii-518bt-usb-qmk-pcb/main/pics/1.png) + +The Rii 518bt is an ultra-compact 68-key keyboard. + +**Keyboard Maintainer:** [Tim / Tangles](https://github.com/tim-eastwood/QMK-rii-518bt-usb) +**Hardware Supported:** Rii 518BT with [custom USB/STM32F072 PCB](https://github.com/tim-eastwood/rii-518bt-usb-qmk-pcb) +**Hardware Availability:** Build it yourself using any PCBA service using the source files / BoM located at [https://github.com/tim-eastwood/rii-518bt-usb-qmk-pcb](https://github.com/tim-eastwood/rii-518bt-usb-qmk-pcb) + +--- + +## Compiling + +In [QMK MSYS](https://docs.qmk.fm/newbs_getting_started#set-up-your-environment), run: + +```sh +qmk compile -kb rii/518bt -km default +``` + +## Flashing + +To compile and flash directly: + +```sh +qmk flash -kb rii/518bt -km default +``` + +## Resources + +- [QMK Build Environment Setup](https://docs.qmk.fm/#/getting_started_build_tools) +- [QMK Make Instructions](https://docs.qmk.fm/#/getting_started_make_guide) +- [Complete Newbs Guide](https://docs.qmk.fm/#/newbs) + +--- + +This is an independent hardware project and is not affiliated with Rii or the original manufacturer. + +Purchasing a Rii 518BT is required to obtain the housing, key membrane, and adhesive sheet of dome switches. From c0fdc7796bbd2b21db8153c0ccd38446f153d53e Mon Sep 17 00:00:00 2001 From: Tim Eastwood Date: Tue, 24 Jun 2025 13:28:19 +1000 Subject: [PATCH 2/7] license --- keyboards/rii/518bt/keymaps/default/keymap.c | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/keyboards/rii/518bt/keymaps/default/keymap.c b/keyboards/rii/518bt/keymaps/default/keymap.c index 4b638d75ef0..0866457144d 100644 --- a/keyboards/rii/518bt/keymaps/default/keymap.c +++ b/keyboards/rii/518bt/keymaps/default/keymap.c @@ -1,3 +1,18 @@ +/* Copyright 2025 tim-eastwood + * + * 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 . + */ #include QMK_KEYBOARD_H #define CTALDEL LCTL(LALT(KC_DEL)) From 3cbd4685caa395578001b4138bc3ad44ffe4bb1d Mon Sep 17 00:00:00 2001 From: Tim Eastwood Date: Tue, 24 Jun 2025 13:33:50 +1000 Subject: [PATCH 3/7] keymap doc --- keyboards/rii/518bt/keymaps/default/keymap.c | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/keyboards/rii/518bt/keymaps/default/keymap.c b/keyboards/rii/518bt/keymaps/default/keymap.c index 0866457144d..2cece1a5d87 100644 --- a/keyboards/rii/518bt/keymaps/default/keymap.c +++ b/keyboards/rii/518bt/keymaps/default/keymap.c @@ -24,19 +24,19 @@ bool process_record_user(uint16_t keycode, keyrecord_t *record) { return true; } -/* Qwerty +/* Membrane labels - base * .----------------------------------------------------------------------------. * |light | home | GUI | MUTE | VOL- | VOL+ | Prev | Pause| Next | Bksp | * .------+------+------+------+------+------+------+------+------+------+------+------| - * | Esc | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 0 | ~ | + * | Esc | 1! | 2@ | 3# | 4$ | 5% | 6^ | 7& | 8* | 9( | 0) | ` ~ | * |------+------+------+------+------+------+------+------+------+------+------+------| - * | Tab | Q | W | E | R | T | Y | U | I | O | P | | | + * | Tab | Q | W | E | R | T | Y | U | I | O | P | \| | * |------+------+------+------+------+-------------+------+------+------+------+------| - * | Caps | A | S | D | F | G | H | J | K | L | ; | " | + * | Caps | A | S | D | F | G | H | J | K | L | ;: | ' " | * |------+------+------+------+------+------|------+------+------+------+------+------| - * | Shift| Z | X | C | V | B | N | M | ? | Up | Enter | + * | Shift| Z | X | C | V | B | N | M | /? | Up | Enter | * |------+------+------+------+------+------+------+------+------+------+------+------| - * | Fn | Ctrl | Alt | - | = | Space | Down | Left | Right| + * | Fn | Ctrl | Alt | -_ | =+ | Space | Down | Left | Right| * `-----------------------------------------------------------------------------------' */ @@ -50,7 +50,7 @@ const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = { TT(1), KC_LCTL, KC_LALT, KC_MINS, KC_EQL, KC_SPC, KC_SPC, KC_SPC, KC_DOWN, KC_LEFT, KC_RGHT ), - /* Qwerty + /* Membrane labels - function (orange) * .----------------------------------------------------------------------------. * | | F1 | F2 | F3 | F4 | F5 | F6 | F7 | F8 | Del | * .------+------+------+------+------+------+------+------+------+------+------+------| From 6e5fe5f77c1e51af204c23232f38e75a934a7b01 Mon Sep 17 00:00:00 2001 From: Tim Eastwood Date: Tue, 24 Jun 2025 13:34:38 +1000 Subject: [PATCH 4/7] remove diag config --- keyboards/rii/518bt/keyboard.json | 2 -- keyboards/rii/518bt/keymaps/default/keymap.c | 8 -------- 2 files changed, 10 deletions(-) diff --git a/keyboards/rii/518bt/keyboard.json b/keyboards/rii/518bt/keyboard.json index 31d7e0f5c05..41e02f9f8a9 100644 --- a/keyboards/rii/518bt/keyboard.json +++ b/keyboards/rii/518bt/keyboard.json @@ -23,8 +23,6 @@ "features": { "backlight": true, "bootmagic": true, - "command": true, - "console": true, "extrakey": true, "mousekey": false, "nkro": true diff --git a/keyboards/rii/518bt/keymaps/default/keymap.c b/keyboards/rii/518bt/keymaps/default/keymap.c index 2cece1a5d87..6ff8061b634 100644 --- a/keyboards/rii/518bt/keymaps/default/keymap.c +++ b/keyboards/rii/518bt/keymaps/default/keymap.c @@ -16,14 +16,6 @@ #include QMK_KEYBOARD_H #define CTALDEL LCTL(LALT(KC_DEL)) -bool process_record_user(uint16_t keycode, keyrecord_t *record) { - // If console is enabled, it will print the matrix position and status of each key pressed -#ifdef CONSOLE_ENABLE - uprintf("KL: kc: 0x%04X, col: %2u, row: %2u, pressed: %u, time: %5u, int: %u, count: %u\n", keycode, record->event.key.col, record->event.key.row, record->event.pressed, record->event.time, record->tap.interrupted, record->tap.count); -#endif - return true; -} - /* Membrane labels - base * .----------------------------------------------------------------------------. * |light | home | GUI | MUTE | VOL- | VOL+ | Prev | Pause| Next | Bksp | From fcaf67e4fc9e683fb2c07615d6f003e8685ff66e Mon Sep 17 00:00:00 2001 From: Tim Eastwood Date: Fri, 27 Jun 2025 15:50:30 +1000 Subject: [PATCH 5/7] changes as reviewed --- keyboards/rii/518bt/keyboard.json | 29 ++++++-------------- keyboards/rii/518bt/keymaps/default/rules.mk | 4 --- keyboards/rii/518bt/readme.md | 6 ++-- 3 files changed, 11 insertions(+), 28 deletions(-) delete mode 100644 keyboards/rii/518bt/keymaps/default/rules.mk diff --git a/keyboards/rii/518bt/keyboard.json b/keyboards/rii/518bt/keyboard.json index 41e02f9f8a9..16e947ecad6 100644 --- a/keyboards/rii/518bt/keyboard.json +++ b/keyboards/rii/518bt/keyboard.json @@ -5,7 +5,7 @@ "usb": { "vid": "0xFEED", "pid": "0x0011", - "device_version": "0.0.1" + "device_version": "1.0.0" }, "backlight": { "pin": "B0", @@ -13,8 +13,7 @@ "levels": 7 }, "bootmagic": { - "enabled": true, - "matrix": [5,0] + "matrix": [5, 0] }, "indicators": { "caps_lock": "B1", @@ -25,7 +24,8 @@ "bootmagic": true, "extrakey": true, "mousekey": false, - "nkro": true + "nkro": true, + "command": true }, "qmk": { "locking": { @@ -34,20 +34,7 @@ } }, "matrix_pins": { - "cols": [ - "A7", - "A6", - "A15", - "B3", - "B4", - "B5", - "B6", - "B7", - "B8", - "B9", - "C13", - "C14" - ], + "cols": ["A7", "A6", "A15", "B3", "B4", "B5", "B6", "B7", "B8", "B9", "C13", "C14"], "rows": ["A14", "A1", "A2", "A3", "A4", "A5"] }, "diode_direction": "COL2ROW", @@ -126,9 +113,9 @@ { "matrix": [5, 6], "x": 6, "y": 5 }, { "matrix": [5, 7], "x": 7, "y": 5 }, { "matrix": [5, 8], "x": 8, "y": 5 }, - { "matrix": [5, 9], "x": 10, "y": 5 }, - { "matrix": [5, 10], "x": 11, "y": 5 }, - { "matrix": [5, 11], "x": 12, "y": 5 } + { "matrix": [5, 9], "x": 9, "y": 5 }, + { "matrix": [5, 10], "x": 10, "y": 5 }, + { "matrix": [5, 11], "x": 11, "y": 5 } ] } } diff --git a/keyboards/rii/518bt/keymaps/default/rules.mk b/keyboards/rii/518bt/keymaps/default/rules.mk deleted file mode 100644 index f5671a8f013..00000000000 --- a/keyboards/rii/518bt/keymaps/default/rules.mk +++ /dev/null @@ -1,4 +0,0 @@ -BACKLIGHT_ENABLE = yes -NKRO_ENABLE = yes -COMMAND_ENABLE = yes -EXTRAKEY_ENABLE = yes \ No newline at end of file diff --git a/keyboards/rii/518bt/readme.md b/keyboards/rii/518bt/readme.md index a123287196e..b749ffc7ec9 100644 --- a/keyboards/rii/518bt/readme.md +++ b/keyboards/rii/518bt/readme.md @@ -11,6 +11,8 @@ The Rii 518bt is an ultra-compact 68-key keyboard. **Hardware Supported:** Rii 518BT with [custom USB/STM32F072 PCB](https://github.com/tim-eastwood/rii-518bt-usb-qmk-pcb) **Hardware Availability:** Build it yourself using any PCBA service using the source files / BoM located at [https://github.com/tim-eastwood/rii-518bt-usb-qmk-pcb](https://github.com/tim-eastwood/rii-518bt-usb-qmk-pcb) +Purchasing a Rii 518BT is required to obtain the housing, key membrane, and adhesive sheet of dome switches. + --- ## Compiling @@ -37,6 +39,4 @@ qmk flash -kb rii/518bt -km default --- -This is an independent hardware project and is not affiliated with Rii or the original manufacturer. - -Purchasing a Rii 518BT is required to obtain the housing, key membrane, and adhesive sheet of dome switches. +Disclaimer: This is an independent hardware project and is not affiliated with Rii or the original manufacturer. From 7a9e176808764d7a9e121b3524193beb6a833f0c Mon Sep 17 00:00:00 2001 From: Tim Eastwood Date: Wed, 2 Jul 2025 17:02:35 +1000 Subject: [PATCH 6/7] match enter key matrix position to new PCB version --- keyboards/rii/518bt/keyboard.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/keyboards/rii/518bt/keyboard.json b/keyboards/rii/518bt/keyboard.json index 16e947ecad6..a95480f0708 100644 --- a/keyboards/rii/518bt/keyboard.json +++ b/keyboards/rii/518bt/keyboard.json @@ -103,7 +103,7 @@ { "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, "w": 2 }, + { "matrix": [4, 11], "x": 10, "y": 4, "w": 2 }, { "matrix": [5, 0], "x": 0, "y": 5, "w": 2 }, { "matrix": [5, 1], "x": 2, "y": 5 }, From fb4d504df1ee43f4b3c69b37316929d10144f8a5 Mon Sep 17 00:00:00 2001 From: Tim Eastwood Date: Tue, 15 Jul 2025 12:21:46 +1000 Subject: [PATCH 7/7] fix: formatting / image links --- keyboards/rii/518bt/keyboard.json | 181 +++++++++---------- keyboards/rii/518bt/keymaps/default/keymap.c | 10 + keyboards/rii/518bt/readme.md | 48 ++--- 3 files changed, 116 insertions(+), 123 deletions(-) diff --git a/keyboards/rii/518bt/keyboard.json b/keyboards/rii/518bt/keyboard.json index a95480f0708..8b07cb97751 100644 --- a/keyboards/rii/518bt/keyboard.json +++ b/keyboards/rii/518bt/keyboard.json @@ -1,121 +1,114 @@ { - "keyboard_name": "518bt", "manufacturer": "Rii", + "keyboard_name": "518bt", "maintainer": "tim-eastwood", - "usb": { - "vid": "0xFEED", - "pid": "0x0011", - "device_version": "1.0.0" - }, "backlight": { - "pin": "B0", "driver": "software", - "levels": 7 + "levels": 7, + "pin": "B0" }, + "bootloader": "stm32-dfu", "bootmagic": { "matrix": [5, 0] }, - "indicators": { - "caps_lock": "B1", - "on_state": 1 - }, + "diode_direction": "COL2ROW", "features": { "backlight": true, "bootmagic": true, + "command": true, "extrakey": true, - "mousekey": false, - "nkro": true, - "command": true + "nkro": true }, + "indicators": { + "caps_lock": "B1" + }, + "matrix_pins": { + "cols": ["A7", "A6", "A15", "B3", "B4", "B5", "B6", "B7", "B8", "B9", "C13", "C14"], + "rows": ["A14", "A1", "A2", "A3", "A4", "A5"] + }, + "processor": "STM32F072", "qmk": { "locking": { "enabled": true, "resync": true } }, - "matrix_pins": { - "cols": ["A7", "A6", "A15", "B3", "B4", "B5", "B6", "B7", "B8", "B9", "C13", "C14"], - "rows": ["A14", "A1", "A2", "A3", "A4", "A5"] + "usb": { + "device_version": "1.0.0", + "pid": "0x0011", + "vid": "0xFEED" }, - "diode_direction": "COL2ROW", - "processor": "STM32F072", - "bootloader": "stm32-dfu", "layouts": { "LAYOUT": { "layout": [ - { "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, 11], "x": 10, "y": 0, "w": 2 }, - - { "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": [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": [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": [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, 11], "x": 10, "y": 4, "w": 2 }, - - { "matrix": [5, 0], "x": 0, "y": 5, "w": 2 }, - { "matrix": [5, 1], "x": 2, "y": 5 }, - { "matrix": [5, 2], "x": 3, "y": 5 }, - { "matrix": [5, 4], "x": 4, "y": 5 }, - { "matrix": [5, 5], "x": 5, "y": 5 }, - { "matrix": [5, 6], "x": 6, "y": 5 }, - { "matrix": [5, 7], "x": 7, "y": 5 }, - { "matrix": [5, 8], "x": 8, "y": 5 }, - { "matrix": [5, 9], "x": 9, "y": 5 }, - { "matrix": [5, 10], "x": 10, "y": 5 }, - { "matrix": [5, 11], "x": 11, "y": 5 } + {"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, 11], "x": 10, "y": 0, "w": 2}, + {"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": [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": [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": [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, 11], "x": 10, "y": 4, "w": 2}, + {"matrix": [5, 0], "x": 0, "y": 5, "w": 2}, + {"matrix": [5, 1], "x": 2, "y": 5}, + {"matrix": [5, 2], "x": 3, "y": 5}, + {"matrix": [5, 4], "x": 4, "y": 5}, + {"matrix": [5, 5], "x": 5, "y": 5}, + {"matrix": [5, 6], "x": 6, "y": 5}, + {"matrix": [5, 7], "x": 7, "y": 5}, + {"matrix": [5, 8], "x": 8, "y": 5}, + {"matrix": [5, 9], "x": 9, "y": 5}, + {"matrix": [5, 10], "x": 10, "y": 5}, + {"matrix": [5, 11], "x": 11, "y": 5} ] } } diff --git a/keyboards/rii/518bt/keymaps/default/keymap.c b/keyboards/rii/518bt/keymaps/default/keymap.c index 6ff8061b634..c0cc85c2208 100644 --- a/keyboards/rii/518bt/keymaps/default/keymap.c +++ b/keyboards/rii/518bt/keymaps/default/keymap.c @@ -16,6 +16,16 @@ #include QMK_KEYBOARD_H #define CTALDEL LCTL(LALT(KC_DEL)) +void keyboard_pre_init_user(void) { + gpio_set_pin_output(B2); + gpio_set_pin_output(B10); + gpio_set_pin_output(B11); + gpio_write_pin_low(B2); + gpio_write_pin_low(B10); + gpio_write_pin_low(B11); +} + + /* Membrane labels - base * .----------------------------------------------------------------------------. * |light | home | GUI | MUTE | VOL- | VOL+ | Prev | Pause| Next | Bksp | diff --git a/keyboards/rii/518bt/readme.md b/keyboards/rii/518bt/readme.md index b749ffc7ec9..4fdfea4634d 100644 --- a/keyboards/rii/518bt/readme.md +++ b/keyboards/rii/518bt/readme.md @@ -1,42 +1,32 @@ -Rii 518BT (Custom USB PCB) -=== +# Rii 518BT -This firmware is used with [a custom PCB](https://github.com/tim-eastwood/rii-518bt-usb-qmk-pcb) to replace the original, which is Bluetooth-only, in the Rii 518BT. The drop-in replacement provides a USB2.0 interface, better backlighting, and of course supports QMK. +![Rii 518BT](https://i.imgur.com/bj3WmLd.png) -![Rii 518BT](https://raw.githubusercontent.com/tim-eastwood/rii-518bt-usb-qmk-pcb/main/pics/1.png) +*A custom PCB for the Rii 518BT keyboard* -The Rii 518bt is an ultra-compact 68-key keyboard. - -**Keyboard Maintainer:** [Tim / Tangles](https://github.com/tim-eastwood/QMK-rii-518bt-usb) -**Hardware Supported:** Rii 518BT with [custom USB/STM32F072 PCB](https://github.com/tim-eastwood/rii-518bt-usb-qmk-pcb) -**Hardware Availability:** Build it yourself using any PCBA service using the source files / BoM located at [https://github.com/tim-eastwood/rii-518bt-usb-qmk-pcb](https://github.com/tim-eastwood/rii-518bt-usb-qmk-pcb) +* Keyboard Maintainer: [Tim / Tangles](https://github.com/tim-eastwood) +* Hardware Supported: [Custom USB/STM32F072 PCB for Rii 518bt](https://github.com/tim-eastwood/rii-518bt-usb-qmk-pcb) +* Hardware Availability: Build it yourself using any PCBA service using the source files / BoM located at [https://github.com/tim-eastwood/rii-518bt-usb-qmk-pcb](https://github.com/tim-eastwood/rii-518bt-usb-qmk-pcb) Purchasing a Rii 518BT is required to obtain the housing, key membrane, and adhesive sheet of dome switches. ---- +Make example for this keyboard (after setting up your build environment): -## Compiling + make rii/518bt:default + or + qmk compile -kb rii/518bt -km default -In [QMK MSYS](https://docs.qmk.fm/newbs_getting_started#set-up-your-environment), run: +Flashing example for this keyboard: -```sh -qmk compile -kb rii/518bt -km default -``` + make rii/518bt:default:flash + or + qmk flash -kb rii/518bt -km default -## Flashing +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). -To compile and flash directly: +## Bootloader -```sh -qmk flash -kb rii/518bt -km default -``` +Enter the bootloader in 2 ways: -## Resources - -- [QMK Build Environment Setup](https://docs.qmk.fm/#/getting_started_build_tools) -- [QMK Make Instructions](https://docs.qmk.fm/#/getting_started_make_guide) -- [Complete Newbs Guide](https://docs.qmk.fm/#/newbs) - ---- - -Disclaimer: This is an independent hardware project and is not affiliated with Rii or the original manufacturer. +* **Bootmagic reset**: Hold down the key at (5,0) in the matrix (Function key) and plug in the keyboard +* **Physical reset button**: Short the pads on the back of the PCB while plugging in the keyboard \ No newline at end of file