keychron_qmk_firmware/keyboards/kyria/keymaps/gotham/README.md
Gautham Yerroju 4057d44989
[Keymap] Add Kyria keymap (#9224)
* Add Kyria keymap

* clean split hand detection code

* rename "joystick" to "thumbstick"

* thumbstick overhaul

* removed angle correction, seems buggy

* save some memory

* Remove deprecated config option

* Use the correct types for getting host led states

* Fix include path

* Made .h files for encoder and oled code

* Increase speed cap on thumbstick
2020-06-13 01:24:13 -07:00

3.2 KiB

Gotham's Keymap for Kyria

Keymap

This is my personal keymap for Kyria with some mods.

More information about the Kyria keyboard can be found here

Rotary Encoders

Press the encoder on each half to cycle between:

  • Volume
  • Word Nav (Ctrl + Left / Right)
  • Left / Right
  • Up / Down
  • Page Up / Page Down

OLEDs

Master-side OLED displays dynamic data:

  • Current layer
  • Current mode of each rotary encoder
  • Current mode of thumbstick

Slave-side OLED currently only displays a static content.

Thumbstick

A PSP 2000 thumbstick is attached to the right half. It will currently only function when the USB cable is connected to the right half. When I figure out how to transfer data between halves using serial link, I will make this work regardless of which side is the master.

Thumbstick Configuration

  • THUMBSTICK_ENABLE: Enable thumbstick.
  • THUMBSTICK_PIN_X/Y (mandatory): The QMK pins to use for the respective axis. The values are from the QMK's ADC driver. I used F0 and F1, for example.
  • THUMBSTICK_FLIP_X/Y: Mirror the direction of the respective axis. Use to compensate for actual orientation of thumbstick.
  • THUMBSTICK_DEBUG: Print raw and calculated values from analogReadPin to console. Will only work with CONSOLE_ENABLE turned on.

Thumbstick Fine-tuning

More tunables are described here. Values like deadzone threshold are hardware-specific. The theoretical range for analog readings is [0, 1023], but emperical readings don't extend the entire range. To find the right values, turn on CONSOLE_ENABLE in rules.mk and THUMBSTICK_DEBUG in config.h to look at the raw values from the pins using hid_listen (or QMK Toolbox).

  • THUMBSTICK_DEAD_ZONE 90: Values below this are ignored (deadzone).

  • THUMBSTICK_FINE_ZONE 180: Values below this enable fine movement.

  • THUMBSTICK_MODE : One of THUMBSTICK_MODE_MOUSE, THUMBSTICK_MODE_ARROWS and THUMBSTICK_MODE_SCROLL. This is just the default mode, it can be changed by calling void thumbstick_mode_cycle(bool reverse) within code.

  • THUMBSTICK_SPEED 127: Cursor speed in THUMBSTICK_MODE_MOUSE.

  • THUMBSTICK_FINE_SPEED 64: Fine cursor speed in THUMBSTICK_MODE_MOUSE (kicks in when slightly nudging the thumbstick).

  • THUMBSTICK_SCROLL_SPEED 1: Scrolling speed in THUMBSTICK_MODE_SCROLL.

  • THUMBSTICK_EIGHT_AXIS true: 8-axis toggle for ARROW and SCROLL modes. Disable to fall back to 4 axes (think D-pads vs analog stick).

  • THUMBSTICK_AXIS_SEPARATION 0.5f: Float value between 0 and 1, used to discretize the circular range into distinct zones for 8-axis. Imagine the top-right quadrant on a graph, and picture the diagonal. This value indicates the angular "distance" from the diagonal to either axis. Moving from the diagonal to each of the axes, this value changes from 0 to 1. So, a value of 0.5 will "sweep" from the center to half-way towards each axis, creating a zone across the diagonal. Smaller values make narrower diagonal zones, and vice versa.

Thanks

  • @pyrho and u/_GEIST_ for the inspiration and initial reference code.
  • @zvecr and @drashna for code review and more pointers.