5.6 KiB
5.6 KiB
EcoSteno Custom Keymaps
This repository contains the custom keymaps for the EcoSteno keyboard. It also contains the guide on how to set up the keymaps.
Table of Contents
- EcoSteno Custom Keymaps
- Table of Contents
- Hardware Info
- Current Keymap
- Related Articles
- Pre-requisites
- Clone Repository
- Set Up QMK Environment
- Remapping Keys
- Flashing the Keyboard
Hardware Info
| Property | Value |
|---|---|
| Keyboard | EcoSteno |
| Keys | 28 (2 top + 12+12 main + 4 thumbs) |
| MCU | STM32F103 |
| Firmware | QMK |
| Bootloader | stm32duino |
| Connection | USB |
| USB Vendor ID | 0xFEED |
| USB Product ID | 0x3621 |
| Device Version | 1.1.2 |
| Manufacturer | Noll Electronics LLC |
| Steno Protocol | GeminiPR |
| LEDs | Red (GPIOA 0), Green (GPIOA 1) |
Current Keymap
Key positions reference:
0 1 2 3
4 5 6 7 8 9 | 10 11 12 13 14 15
16 17 18 19 20 21 | 22 23 24 25 26 27
28 29 | 30 31
Layer 0: STENO (Plover / GeminiPR)
#2 #4 #8 #0
->QWRT S T P H * | * F P L T D
_ S K W R * | * R B G S Z
A O | E U
LED: green on, red off
Layer 1: QWERTY
TAB ESC ENTER BSPC
LSHFT Q W E R T | Y U I O P '
[L1] Z X C V B | N M , . / [CAPS]
CTRL GUI | SPC ALT
LED: red on, green off
Combos (QWERTY + QWERTY_CAPS):
top+bottom row same col = virtual home row:
Q+Z=A W+X=S E+C=D R+V=F T+B=G Y+N=H U+M=J I+,=K O+.=L P+/=;
top row + modifier key = numbers:
Q+TAB=1 W+TAB=2 E+ESC=3 R+ESC=4 T+ESC=5
Y+ENT=6 U+ENT=7 I+ENT=8 O+BSP=9 P+BSP=0
CAPS layer: same combos produce shifted output (! @ # $ % ^ & * ( ) :)
[L1] = hold opens LAYER1
[CAPS] = hold activates QWERTY_CAPS (shifted combos)
Layer 2: QWERTY_CAPS (shift layer)
S(TAB) S(ESC) S(ENTER) S(BSPC)
LSHFT Q W E R T | Y U I O P "
[L1] Z X C V B | N M < > ? _
CTRL GUI | SPC ALT
All alpha/symbol keys output shifted versions.
LED: red on, green off
Layer 3: LAYER1 (nav/symbols)
TAB ESC ENTER BSPC
->STEN ` _ _ \ VOL+ | + [ UP ] * =
_ Z X C V VOL- | - LEFT DOWN RIGHT / RSHFT
CTRL GUI | SPC ALT
LED: both red and green on
->STEN = switch to STENO layer
Related Articles
Pre-requisites
- EcoSteno Keyboard
- MacOS
- Homebrew
- This Repository - Custom EcoSteno Keymap
Clone Repository
git clone git@github.com:afiqzudinhadi/EcoSteno-Firmware.git
Set Up QMK Environment
1. Prepare Build Environment
brew install qmk/qmk/qmk
2. Run QMK Setup
qmk setup
Answer Y to all the prompts.
3. Copy the keyboard to the QMK directory
cp -r keyboards/* ~/qmk_firmware/keyboards/
4. Test Build Environment
qmk compile -kb noll/ecosteno -km default
Remapping Keys
1. Edit the Keymap File
Keymaps are located in the following directory:
keyboards/noll/ecosteno/keymaps/default/keymap.c
Keymap guide can be found here.
2. Copy the Keymap to the QMK Directory
If keymap file is edited, copy the keymap to the QMK directory:
cp -r keyboards/* ~/qmk_firmware/keyboards/
3. Compile the Keymap
qmk compile -kb noll/ecosteno -km default
Flashing the Keyboard
1. Plug in the keyboard
2. Press the reset button
- The button is on the back of the keyboard near the USB port.
- LEDs on the keyboard will turn off.
3. Flash the keyboard
Run the following command to flash the keyboard:
qmk flash -kb noll/ecosteno -km default
4. Check the keyboard
- The keyboard will restart and the new keymap will be loaded.
- LEDs on the keyboard will turn on.
Issues
Bootloader not found
Bootloader not found. Make sure the board is in bootloader mode. See https://docs.qmk.fm/#/newbs_flashing
Trying again every 0.5s (Ctrl+C to cancel)...
Fixes
1. Run QMK Doctor
qmk doctor