qmk_firmware/keyboards/hillside/52/readme.md

30 lines
1.1 KiB
Markdown
Raw Normal View History

[Keyboard] Add Hillside 52 (#17374) * 52 Keymap.json: Set for Hillside 52 - Change script rows * 52 Keymap.c: mirror .json CAPSWORD, QK_BOOT, readme cleanup, EE_RST * 52 Keymap.json: Initial files copy from 56 * 52 Keymap.json nav/edit lay, thumb shift, syms - Del in backspace spot on sym layer - Thumb shift OSM instead of extra space - Nav/edit on num/fn: arrows cut copy paste undo redo, page up/down - Fn keys bottom row to allow nav edit keys - App and AltGr on lower row, on their layer - Braces on index, so more common -= on middle ring. - Adjust has Ctrl/GUI swap - EE_RST, CAPSWORD, QK_BOOT, SPLIT_DETECT * 52 Family: readme image and folder link * 52 Board: initial copy from 56 * 52 Keymap via * 52 Board: remove keys, cant columns, better ids - .json: vid: MM, pid: H52 * 52 Keymap.c: initial.c copy from 48 * QK_BOOT EE_CLR, not ANY(), as config.qmk supports - CAPSWRD instead of ANY, though config.qmk still converts to ANY() * Cleanup readme * 52 Keymap: Remove redundant key, cleanup script * 52 Keymap: Fix template * 52 Readme: Link lower res image better for readme Co-authored-by: Drashna Jaelre <drashna@live.com> * 52 Keymap: Move pretty-print script to GitHub wiki * 52 Keymap: Link to 1024 res image thumbnails * 52 Keymap: fix whitespace before image link * Family: Fix image link to 1024 thumb Co-authored-by: Drashna Jaelre <drashna@live.com> * 52: Keymap: Caps word on a layer home row * 52: Keymap: Arrows on right. Symmetric layer keys. - Nav: - Arrows on right so up/down more intuitive. Page up/down on ends - Cut on home row, as more common - Sym: - Layer mods on activate hand, extras symbols on left - Common digits on lower row - Base: - Layer keys symmetric, on most extended, not resting, thumb - Mute on util key for easy use - Swap layers 3 and 4 to match swapped thumbs Co-authored-by: mmccoyd <mmccoyd@cs.berkley.edu> Co-authored-by: Drashna Jaelre <drashna@live.com>
2022-08-13 16:19:21 +00:00
# Hillside 52
![hillside](https://imgur.com/eDqDMk7h.png)
[Hillside 52](https://github.com/mmccoyd/hillside)
is a split ergonomic keyboard with 3x6+3+5 choc-spaced keys,
splayed ring and pinkie columns, aggressive column stagger,
a longer thumb arc, an inverted-T arrow cluster and a breakoff outer-pinkie column.
* Keyboard Maintainer: [Michael McCoyd](https://github.com/mmccoyd)
* Hardware Supported: ProMicro/Elite-C and compatible
* Hardware Availability: https://github.com/mmccoyd/hillside
Make example for this keyboard (after setting up your build environment):
make hillside/52/0_1:default
[Keyboard] Add Hillside 52 (#17374) * 52 Keymap.json: Set for Hillside 52 - Change script rows * 52 Keymap.c: mirror .json CAPSWORD, QK_BOOT, readme cleanup, EE_RST * 52 Keymap.json: Initial files copy from 56 * 52 Keymap.json nav/edit lay, thumb shift, syms - Del in backspace spot on sym layer - Thumb shift OSM instead of extra space - Nav/edit on num/fn: arrows cut copy paste undo redo, page up/down - Fn keys bottom row to allow nav edit keys - App and AltGr on lower row, on their layer - Braces on index, so more common -= on middle ring. - Adjust has Ctrl/GUI swap - EE_RST, CAPSWORD, QK_BOOT, SPLIT_DETECT * 52 Family: readme image and folder link * 52 Board: initial copy from 56 * 52 Keymap via * 52 Board: remove keys, cant columns, better ids - .json: vid: MM, pid: H52 * 52 Keymap.c: initial.c copy from 48 * QK_BOOT EE_CLR, not ANY(), as config.qmk supports - CAPSWRD instead of ANY, though config.qmk still converts to ANY() * Cleanup readme * 52 Keymap: Remove redundant key, cleanup script * 52 Keymap: Fix template * 52 Readme: Link lower res image better for readme Co-authored-by: Drashna Jaelre <drashna@live.com> * 52 Keymap: Move pretty-print script to GitHub wiki * 52 Keymap: Link to 1024 res image thumbnails * 52 Keymap: fix whitespace before image link * Family: Fix image link to 1024 thumb Co-authored-by: Drashna Jaelre <drashna@live.com> * 52: Keymap: Caps word on a layer home row * 52: Keymap: Arrows on right. Symmetric layer keys. - Nav: - Arrows on right so up/down more intuitive. Page up/down on ends - Cut on home row, as more common - Sym: - Layer mods on activate hand, extras symbols on left - Common digits on lower row - Base: - Layer keys symmetric, on most extended, not resting, thumb - Mute on util key for easy use - Swap layers 3 and 4 to match swapped thumbs Co-authored-by: mmccoyd <mmccoyd@cs.berkley.edu> Co-authored-by: Drashna Jaelre <drashna@live.com>
2022-08-13 16:19:21 +00:00
Flashing example for this keyboard:
make hillside/52/0_1:default:flash
[Keyboard] Add Hillside 52 (#17374) * 52 Keymap.json: Set for Hillside 52 - Change script rows * 52 Keymap.c: mirror .json CAPSWORD, QK_BOOT, readme cleanup, EE_RST * 52 Keymap.json: Initial files copy from 56 * 52 Keymap.json nav/edit lay, thumb shift, syms - Del in backspace spot on sym layer - Thumb shift OSM instead of extra space - Nav/edit on num/fn: arrows cut copy paste undo redo, page up/down - Fn keys bottom row to allow nav edit keys - App and AltGr on lower row, on their layer - Braces on index, so more common -= on middle ring. - Adjust has Ctrl/GUI swap - EE_RST, CAPSWORD, QK_BOOT, SPLIT_DETECT * 52 Family: readme image and folder link * 52 Board: initial copy from 56 * 52 Keymap via * 52 Board: remove keys, cant columns, better ids - .json: vid: MM, pid: H52 * 52 Keymap.c: initial.c copy from 48 * QK_BOOT EE_CLR, not ANY(), as config.qmk supports - CAPSWRD instead of ANY, though config.qmk still converts to ANY() * Cleanup readme * 52 Keymap: Remove redundant key, cleanup script * 52 Keymap: Fix template * 52 Readme: Link lower res image better for readme Co-authored-by: Drashna Jaelre <drashna@live.com> * 52 Keymap: Move pretty-print script to GitHub wiki * 52 Keymap: Link to 1024 res image thumbnails * 52 Keymap: fix whitespace before image link * Family: Fix image link to 1024 thumb Co-authored-by: Drashna Jaelre <drashna@live.com> * 52: Keymap: Caps word on a layer home row * 52: Keymap: Arrows on right. Symmetric layer keys. - Nav: - Arrows on right so up/down more intuitive. Page up/down on ends - Cut on home row, as more common - Sym: - Layer mods on activate hand, extras symbols on left - Common digits on lower row - Base: - Layer keys symmetric, on most extended, not resting, thumb - Mute on util key for easy use - Swap layers 3 and 4 to match swapped thumbs Co-authored-by: mmccoyd <mmccoyd@cs.berkley.edu> Co-authored-by: Drashna Jaelre <drashna@live.com>
2022-08-13 16:19:21 +00:00
## Bootloader
Enter the bootloader by either:
* **Physical reset button**: Briefly press the button on the front of the PCB.
* **Keycode in layout**: Press the key mapped to `QK_BOOT` if it is available
[Keyboard] Add Hillside 52 (#17374) * 52 Keymap.json: Set for Hillside 52 - Change script rows * 52 Keymap.c: mirror .json CAPSWORD, QK_BOOT, readme cleanup, EE_RST * 52 Keymap.json: Initial files copy from 56 * 52 Keymap.json nav/edit lay, thumb shift, syms - Del in backspace spot on sym layer - Thumb shift OSM instead of extra space - Nav/edit on num/fn: arrows cut copy paste undo redo, page up/down - Fn keys bottom row to allow nav edit keys - App and AltGr on lower row, on their layer - Braces on index, so more common -= on middle ring. - Adjust has Ctrl/GUI swap - EE_RST, CAPSWORD, QK_BOOT, SPLIT_DETECT * 52 Family: readme image and folder link * 52 Board: initial copy from 56 * 52 Keymap via * 52 Board: remove keys, cant columns, better ids - .json: vid: MM, pid: H52 * 52 Keymap.c: initial.c copy from 48 * QK_BOOT EE_CLR, not ANY(), as config.qmk supports - CAPSWRD instead of ANY, though config.qmk still converts to ANY() * Cleanup readme * 52 Keymap: Remove redundant key, cleanup script * 52 Keymap: Fix template * 52 Readme: Link lower res image better for readme Co-authored-by: Drashna Jaelre <drashna@live.com> * 52 Keymap: Move pretty-print script to GitHub wiki * 52 Keymap: Link to 1024 res image thumbnails * 52 Keymap: fix whitespace before image link * Family: Fix image link to 1024 thumb Co-authored-by: Drashna Jaelre <drashna@live.com> * 52: Keymap: Caps word on a layer home row * 52: Keymap: Arrows on right. Symmetric layer keys. - Nav: - Arrows on right so up/down more intuitive. Page up/down on ends - Cut on home row, as more common - Sym: - Layer mods on activate hand, extras symbols on left - Common digits on lower row - Base: - Layer keys symmetric, on most extended, not resting, thumb - Mute on util key for easy use - Swap layers 3 and 4 to match swapped thumbs Co-authored-by: mmccoyd <mmccoyd@cs.berkley.edu> Co-authored-by: Drashna Jaelre <drashna@live.com>
2022-08-13 16:19:21 +00:00
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).