qmk-firmware/keyboards/sofle/keymaps/keyhive_via/readme.md
Will Winder 1f618c8302
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.
2022-01-11 12:17:37 -08:00

2.2 KiB

Only compatible with sofle/keyhive firmware which adds an extra column of keys for encoder mapping.

SofleKeyboard version 2.1 RGB Keyhive

Configuring VIA / Vial App

This firmware will not auto-recognize until PR #1060 is accepted to the VIA keyboard database. For now you must install the new layout:

  1. Download keyhive_sofle_rgb.json.
  2. In the VIA app, select File > Import Keymap from the menu.
  3. Open the file you just downloaded.

You'll have to do this every time you use VIA or Vial until the PR is accepted.

Using with VIA

  • The default layouts should be loaded automatically.
  • Layouts can be backed up in VIA in the SAVE+LOAD section.
  • It is a good idea to Save Current Layout after you decide on your mapping.

Custom Features:

Rotary Encoder and VIA Features:

  • Fully remappable. 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 with keyhive_via keymap.

Compiling

Make example for this keyboard (after setting up your build environment):

make sofle/keyhive:keyhive_via

Flashing

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 the keyboard when asked.

Disconnect the first half, connect the second one and repeat the process.

# for Pro Micro-based builds
make sofle/keyhive:keyhive_via:avrdude-split-left
make sofle/keyhive:keyhive_via:avrdude-split-right

# for Elite C or DFU bootloader builds
make sofle/keyhive:keyhive_via:dfu-split-left
make sofle/keyhive:keyhive_via:dfu-split-right

See the build environment setup and the make instructions for more information. Brand new to QMK? Start with our Complete Newbs Guide.