qmk_firmware/keyboards/bastardkb/charybdis/3x6/keymaps/via/readme.md
Charly Delay 50a12c06b9
[keyboard] bastardkb: restructure folder hierarchy (#16778)
* bastardkb: restructure folder hierarchy ahead of supporting other adapters/mcus

Upcoming support for the following (adapter, mcu) pairs will be
submitted in follow-up PRs:

- `v2/elitec`
- `v2/stemcell`
- `blackpill`

This PR contains the following changes:

- Move previous implementation to an inner `v1/elitec` folder
- Move keyboard USB IDs and strings to data driven
- Update headers to update maintainers list
- Run `qmk format-c`

* bastardkb/charybdis: remove broken acceleration implementation

* bastardkb/charybdis: fix debug output

* bastardkb: add support for BastardKb the `v2/elitec` (adapter, mcu) pair

* bastardkb: add Blackpill support

* bastardkb/charybdis/3x5: add `bstiq` keymap

* bastardkb/charybdis: add fake LEDs to the configuration

For the Charybdis 3x5 (respectively 4x6), the LED config now simulates
36 (respectively 58) LEDs instead of the actual 35 (respectively 56) to
prevent confusion when testing LEDs during assembly when handedness is
not set correctly.  Those fake LEDs are bound to the physical
bottom-left corner.

* bastardkbk/charybdis/readme.md: update build commands

Merge pull request #5 from Nathancooke7/update_charybdis_readme_v2_shield.

* bastardkb/charybdis: fix Via keymap with blackpill

* bastardkb/charybdis: add 3x6 configuration

* bastardkb/charybdis: remove unnecessary files

* bastardkb/charybdis: remove obsolete code

* bastardkb/charybdis/3x6: add Via keymap

* bastardkb: add support for Splinky (RP2040) board

* bastardkb: initial configuration for the Splinky (SPI not working yet)

* bastardkb/charybdis/3x5/v2/splinky: tentative change to enable trackball

* bastardkb/charybdis/3x5/v2/splinky: fix SCK, MISO, MOSI pins

* bastardkb/charybdis/3x5/v2/splinky: fix SCK, MISO, MOSI pins

* bastardkb/charybdis/4x6/v2/splinky: add SPI configuration and enable trackball

* bastardkb/charybdis/3x6: add splinky config

* bastardkb/*/v2/splinky: update drivers to `vendor`

* bastardkb/dilemma: add new board

* bastardkb/charybdis: fix infinite loop in `layer_state_set_user(…)` in the `via` keymaps

* bastardkb/dilemma: add `bstiq` keymap

* bastardkb: specify blackpill boards

* bastardkb/charybdis: fix blackpill-specific define syntax

* bastardkb: remove `NO_ACTION_MACRO` and `NO_ACTION_FUNCTION` which are no longer valid options

* bastardkb: fix `QK_BOOT` keycodes

* bastardkb/dilemma: fix mouse direction on X axis

* bastardkb/charybdis/3x6: adjust CS

* bastardkb/dilemma: adjust trackpad configuration

* charybdis: fix `PWM33XX_CS_PIN` defines

This is a follow-up of https://github.com/qmk/qmk_firmware/pull/17613.

* bastardkb: remove Vial mentions from `bstiq` keymaps

* Cleanup unnecessary comments

Co-authored-by: Nathan <nathan.cooke@compass.com>
Co-authored-by: Charly Delay <0xcharly@codesink.dev>
2022-07-25 10:11:28 +01:00

2.3 KiB

Charybdis Mini (3x6) via keymap

The Charydbis Mini (3x6) via keymap is inspired from the original Dactyl Manuform default keymap, with some features and changes specific to the Charybdis.

This layout supports RGB matrix. However, due to space constraints on the MCU, only a limited number of effect can be enabled at once. Look at the config.h file and enable your favorite effect.

Customizing the keymap

Dynamic DPI scaling

Use the following keycodes to change the default DPI:

  • POINTER_DEFAULT_DPI_FORWARD: increases the DPI; decreases when shifted;
  • POINTER_DEFAULT_DPI_REVERSE: decreases the DPI; increases when shifted.

There's a maximum of 16 possible values for the sniping mode DPI. See the Charybdis documentation for more information.

Use the following keycodes to change the sniping mode DPI:

  • POINTER_SNIPING_DPI_FORWARD: increases the DPI; decreases when shifted;
  • POINTER_SNIPING_DPI_REVERSE: decreases the DPI; increases when shifted.

There's a maximum of 4 possible values for the sniping mode DPI. See the Charybdis documentation for more information.

Drag-scroll

Use the DRAGSCROLL_MODE keycode to enable drag-scroll on hold. Use the DRAGSCROLL_TOGGLE keycode to enable/disable drag-scroll on key press.

Sniping

Use the SNIPING_MODE keycode to enable sniping mode on hold. Use the SNIPING_TOGGLE keycode to enable/disable sniping mode on key press.

Change the value of CHARYBDIS_AUTO_SNIPING_ON_LAYER to automatically enable sniping mode on layer change. By default, sniping mode is enabled on the pointer layer:

#define CHARYBDIS_AUTO_SNIPING_ON_LAYER LAYER_POINTER

Auto pointer layer

The pointer layer can be automatically enabled when moving the trackball. To enable or disable this behavior, add or remove the following define:

#define CHARYBDIS_AUTO_POINTER_LAYER_TRIGGER_ENABLE

By default, the layer is turned off 1 second after the last registered trackball movement:

#define CHARYBDIS_AUTO_POINTER_LAYER_TRIGGER_TIMEOUT_MS 1000

The trigger sensibility can also be tuned. The lower the value, the more sensible the trigger:

#define CHARYBDIS_AUTO_POINTER_LAYER_TRIGGER_THRESHOLD 8