summaryrefslogtreecommitdiff
path: root/keyboards/sofle/keyhive/readme.md
diff options
context:
space:
mode:
authorWill Winder <wwinder.unh@gmail.com>2022-01-11 15:17:37 -0500
committerGitHub <noreply@github.com>2022-01-11 12:17:37 -0800
commit1f618c8302cc5053c382436a2d1fb11082c99057 (patch)
tree4ea16702e13498c2af2eb403f6e2acefb286cc8b /keyboards/sofle/keyhive/readme.md
parent1fdc42155a19a415b2d574ccbf61aac45e6543aa (diff)
keyhive sofle rgb: fix configuration. (#15339)
* keyhive sofle rgb: fix configuration. * Add Colemak-DH and cycle layer keycode. * Fix indentation. * Add PLACEHOLDER for better readability. * Fix breaking changes. * Just one colemak. * PR Cleanup * Use NO_PIN definition instead of C7 * Define animations individually * Remove via json file and update documentation * Reduce LED brightness, one of the animations caused a crash * More PR feedback. * Better credit. * Disable NKRO. * Cleanup RGB configuration. * animations defined in keymap. * Update keyboards/sofle/keyhive/readme.md * PR Feedback. * Update phrasing from template. * Disable RGBLIGHT_ENABLE in keymap for better compatibility with default keymap. * Set a default animation. * Use default in keyboard readme. * Update keyboards/sofle/keyhive/info.json * Move via specific layout into via keymap.
Diffstat (limited to 'keyboards/sofle/keyhive/readme.md')
-rwxr-xr-xkeyboards/sofle/keyhive/readme.md62
1 files changed, 25 insertions, 37 deletions
diff --git a/keyboards/sofle/keyhive/readme.md b/keyboards/sofle/keyhive/readme.md
index 43813b856a..3847dfe6bb 100755
--- a/keyboards/sofle/keyhive/readme.md
+++ b/keyboards/sofle/keyhive/readme.md
@@ -1,66 +1,54 @@
-# Sofle Keyboard
+# Keyhive Sofle Keyboard
![SofleKeyboard version 2.1 RGB Keyhive](https://i.imgur.com/WH9OoWuh.jpg)
Sofle is 6×4+5 keys column-staggered split keyboard. Based on Lily58, Corne and Helix keyboards.
-For detailed instructions on using VIA and flashing, please refer to the sections further down the page!
-
For details about the keyboard design, refer to Josef's blog: [Sofle Keyboard - a split keyboard based on Lily58 and Crkbd](https://josef-adamcik.cz/electronics/let-me-introduce-you-sofle-keyboard-split-keyboard-based-on-lily58.html)
Build guide: [Keyhive Sofle RGB build guide](https://github.com/keyhive/build_guides/blob/master/docs/keyboards/sofle-rgb.md)
-* Keyboard Maintainer: [Solartempest]
-* Hardware Supported: SofleKeyboard V2.1 RGB PCB, ProMicro / Elite-C
+* Keyboard Maintainer: [Winder](https://github.com/winder)
+* Hardware Supported: Keyhive Sofle RGB, ProMicro / Elite-C
* Hardware Availability: [Keyhive](https://keyhive.xyz/shop/sofle)
-# Custom Features:
-
-### OLED Features:
-- Includes Snakey keyboard pet! Slithers according to WPM, bites, and sticks its tongue out at you!
-- OLED displays current layer, lock key status, WPM, custom logo, and custom name.
-- OLED shuts off on idle and when computer is sleeping.
-- Includes working Luna keyboard pet.
-- Includes working Bongocat (disable RGB for sufficient space).
-- Includes stock OLED code as well.
+### Acknowledgements
-### RGB Features:
-- Adds custom layer lighting with custom gradients for each layer.
-- RGB underglow support and remapped to physical locations (nicer gradients and effects).
-- Adds white caps lock, scroll lock, and num lock key indicators using the top row/underglow LEDs.
+* Solartempest - the image on this page and most of the code is either copied directly or inspired by their fork. [Solartempest's fork.](https://github.com/solartempest/qmk_firmware/tree/master/keyboards/solartempest/sofle).
+* [Keyhive fork](https://github.com/keyhive/qmk_firmware) defined all of the board settings.
-### Rotary Encoder and VIA Features:
-- Fully emappable left encoder controls volume up/down/mute. Right encoder PGUP/PGDOWN.
-- Allows for live remapping of per-layer rotary encoder functions in VIA.
-- VIA support included by default.
-- This fixes the Keyhive left bottom row offset issue in VIA. You will need to import sofle.json in VIA.
-- Custom macro key in VIA for Super Alt Tab, which is fully compatible with rotary encoders.
-- Custom macro key in VIA for moving windows to other monitors in Windows, which is fully compatible with rotary encoders.
+# Supported Keymaps
-### Tap and Other Features:
-- Push left-shift + backspace to delete whole words. Right-shift + backspace to delete whole words in the opposite direction.
-- Double tap layers to stay on a layer instead of momentary push.
-- Adds key combo functionality.
-- Symmetric modifiers (CMD/Super, Alt/Opt, Ctrl, Shift).
+The keyhive schematic has been slightly modified compared to the open source sofle and not all keymaps are compatible.
-## Using with VIA
+* **default**: Basic functionality, no rgb, no VIA.
+* [keyhive_via](../keymaps/keyhive_via/readme.md) - Includes rgblighting and special support for remapping encoders with VIA.
+* **Other**: may work but backwards compatibility is not guaranteed or tested.
-- After flashing, in VIA make sure to Import Keymap, which is "sofle VIA keymap.json". This will alow VIA to recognize the updated layout and custom functions. VIA will not auto-recognize the keyboard with this firmware because of the necessary customization.
-- Go to Save+Load to Load Saved Layout. You can import my own layout "sofle VIA layout.json" or just use the Keymap tab to assign your own keys. Having another keyboard connected can be handy for doing this step.
-- It is a good idea to Save Current Layout after you decide on your mapping.
+# VIA Support
+As of 1.3.1, the VIA tool does not support Keyhive/Sofle V2 out of the box.
+See [keyhive_via](../keymaps/keyhive_via/readme.md) for details about configuring and using VIA.
+# Compiling
Make example for this keyboard (after setting up your build environment):
make sofle/keyhive:default
-Flashing example for this keyboard:
+## Flashing
- make sofle/keyhive:default:flash
+Flash using the correct command below (or use QMK Toolbox). These commands can be mixed if, for example, you have an Elite C on the left and a pro micro on the right.
-Press reset button on he keyboard when asked.
+Press reset button on the keyboard when asked.
Disconnect the first half, connect the second one and repeat the process.
+ # for Pro Micro-based builds
+ make sofle/keyhive:default:avrdude-split-left
+ make sofle/keyhive:default:avrdude-split-right
+
+ # for Elite C or DFU bootloader builds
+ make sofle/keyhive:default:dfu-split-left
+ make sofle/keyhive:default:dfu-split-right
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).