2015-10-26 20:32:37 +00:00
/*
Copyright 2012 Jun Wako < wakojun @ gmail . com >
Copyright 2013 Oleg Kostyuk < cub . uanic @ gmail . com >
This program is free software : you can redistribute it and / or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation , either version 2 of the License , or
( at your option ) any later version .
This program is distributed in the hope that it will be useful ,
but WITHOUT ANY WARRANTY ; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE . See the
GNU General Public License for more details .
You should have received a copy of the GNU General Public License
along with this program . If not , see < http : //www.gnu.org/licenses/>.
*/
2016-07-10 09:01:28 +00:00
# ifndef ERGODOX_EZ_CONFIG_H
# define ERGODOX_EZ_CONFIG_H
2015-10-26 20:32:37 +00:00
2016-11-22 01:17:32 +00:00
# include "config_common.h"
2015-10-26 20:32:37 +00:00
/* USB Device descriptor parameter */
# define VENDOR_ID 0xFEED
# define PRODUCT_ID 0x1307
# define DEVICE_VER 0x0001
# define MANUFACTURER ErgoDox EZ
# define PRODUCT ErgoDox EZ
2016-07-04 16:01:10 +00:00
# define DESCRIPTION QMK keyboard firmware for Ergodox EZ
2015-10-26 20:32:37 +00:00
/* key matrix size */
# define MATRIX_ROWS 14
improve ergodox ez performance
With these changes, the ergodox ez goes from 315 scans per second
when no keys are pressed (~3.17ms/scan) to 447 (~2.24ms/scan).
The changes to the pin read are just condensing the logic, and
replacing a lot of conditional operations with a single bitwise
inversion.
The change to row scanning is more significant, and merits
explanation. In general, you can only scan one row of a keyboard
at a time, because if you scan two rows, you no longer know
which row is pulling a given column down. But in the Ergodox
design, this isn't the case; the left hand is controlled by an
I2C-based GPIO expander, and the columns and rows are *completely
separate* electrically from the columns and rows on the right-hand
side.
So simply reading rows in parallel offers two significant
improvements. One is that we no longer need the 30us delay after
each right-hand row, because we're spending more than 30us
communicating with the left hand over i2c. Another is that we're
no longer wastefully sending i2c messages to the left hand
to unselect rows when no rows had actually been selected in the
first place. These delays were, between them, coming out to
nearly 30% of the time spent in each scan.
Signed-off-by: seebs <seebs@seebs.net>
2017-11-18 22:11:26 +00:00
# define MATRIX_ROWS_PER_SIDE (MATRIX_ROWS / 2)
2015-10-26 20:32:37 +00:00
# define MATRIX_COLS 6
2017-08-24 02:29:07 +00:00
# define MOUSEKEY_INTERVAL 20
# define MOUSEKEY_DELAY 0
# define MOUSEKEY_TIME_TO_MAX 60
# define MOUSEKEY_MAX_SPEED 7
# define MOUSEKEY_WHEEL_DELAY 0
# define TAPPING_TOGGLE 1
/* define if matrix has ghost */
//#define MATRIX_HAS_GHOST
# define TAPPING_TERM 200
# define IGNORE_MOD_TAP_INTERRUPT // this makes it possible to do rolling combos (zx) with keys that convert to other keys on hold (z becomes ctrl when you hold it, and when this option isn't enabled, z rapidly followed by x actually sends Ctrl-x. That's bad.)
/* Mechanical locking support. Use KC_LCAP, KC_LNUM or KC_LSCR instead in keymap */
# define LOCKING_SUPPORT_ENABLE
/* Locking resynchronize hack */
# define LOCKING_RESYNC_ENABLE
/* key combination for command */
# define IS_COMMAND() ( \
keyboard_report - > mods = = ( MOD_BIT ( KC_LCTL ) | MOD_BIT ( KC_RCTL ) ) | | \
keyboard_report - > mods = = ( MOD_BIT ( KC_LSFT ) | MOD_BIT ( KC_RSFT ) ) \
)
2015-10-26 20:32:37 +00:00
/* number of backlight levels */
# define BACKLIGHT_LEVELS 3
2017-11-23 21:34:50 +00:00
# ifndef LED_BRIGHTNESS_LO
2016-07-09 08:26:15 +00:00
# define LED_BRIGHTNESS_LO 15
2017-11-23 21:34:50 +00:00
# endif
# ifndef LED_BRIGHTNESS_HI
2016-07-09 08:26:15 +00:00
# define LED_BRIGHTNESS_HI 255
2017-11-23 21:34:50 +00:00
# endif
# define LED_BRIGHTNESS_DEFAULT (LED_BRIGHTNESS_HI)
2016-07-09 08:26:15 +00:00
2016-11-29 05:09:56 +00:00
/* ws2812 RGB LED */
# define RGB_DI_PIN D7
# define RGBLIGHT_ANIMATIONS
# define RGBLED_NUM 15 // Number of LEDs
# define RGBLIGHT_HUE_STEP 12
# define RGBLIGHT_SAT_STEP 255
# define RGBLIGHT_VAL_STEP 12
2017-04-03 19:11:42 +00:00
/* fix space cadet rollover issue */
# define DISABLE_SPACE_CADET_ROLLOVER
2017-01-23 18:55:24 +00:00
// #define RGB_MIDI
2016-11-29 05:09:56 +00:00
# define RGBW_BB_TWI
2016-12-19 16:18:18 +00:00
# define RGBW 1
2016-07-09 08:26:15 +00:00
improve ergodox ez performance
With these changes, the ergodox ez goes from 315 scans per second
when no keys are pressed (~3.17ms/scan) to 447 (~2.24ms/scan).
The changes to the pin read are just condensing the logic, and
replacing a lot of conditional operations with a single bitwise
inversion.
The change to row scanning is more significant, and merits
explanation. In general, you can only scan one row of a keyboard
at a time, because if you scan two rows, you no longer know
which row is pulling a given column down. But in the Ergodox
design, this isn't the case; the left hand is controlled by an
I2C-based GPIO expander, and the columns and rows are *completely
separate* electrically from the columns and rows on the right-hand
side.
So simply reading rows in parallel offers two significant
improvements. One is that we no longer need the 30us delay after
each right-hand row, because we're spending more than 30us
communicating with the left hand over i2c. Another is that we're
no longer wastefully sending i2c messages to the left hand
to unselect rows when no rows had actually been selected in the
first place. These delays were, between them, coming out to
nearly 30% of the time spent in each scan.
Signed-off-by: seebs <seebs@seebs.net>
2017-11-18 22:11:26 +00:00
/* "debounce" is measured in keyboard scans. Some users reported
* needing values as high as 15 , which was at the time around 50 ms .
* If you don ' t define it here , the matrix code will default to
* 5 , which is now closer to 10 ms , but still plenty according to
* manufacturer specs .
*
* Default is quite high , because of reports with some production
* runs seeming to need it . This may change when configuration for
* this is more directly exposed .
*/
Change to per-key eager debouncing for ErgoDox EZ.
Empirically, waiting for N consecutive identical scans as a debouncing
strategy doesn't work very well for the ErgoDox EZ where scans are very
slow compared to most keyboards. Instead, debounce the signals by
eagerly reporting a change as soon as one scan observes it, but then
ignoring further changes from that key for the next N scans.
This is implemented by keeping an extra matrix of uint8 countdowns, such
that only keys whose countdown is currently zero are eligible to change.
When we do observe a change, we bump that key's countdown to DEBOUNCE.
During each scan, every nonzero countdown is decremented.
With this approach to debouncing, much higher debounce constants are
tolerable, because latency does not increase with the constant, and
debounce countdowns on one key do not interfere with events on other
keys. The only negative effect of increasing the constant is that the
minimum duration of a keypress increases. Perhaps I'm just extremely
unlucky w.r.t. key switch quality, but I saw occasional bounces even
with DEBOUNCE=10; with 15, I've seen none so far. That's around 47ms,
which seems like an absolutely insane amount of time for a key to be
bouncy, but at least it works.
2017-04-26 22:29:39 +00:00
# define DEBOUNCE 15
2015-10-26 20:32:37 +00:00
2017-05-29 00:05:37 +00:00
# define PREVENT_STUCK_MODIFIERS
2017-01-02 14:57:39 +00:00
# define USB_MAX_POWER_CONSUMPTION 500
2016-12-15 04:24:40 +00:00
2017-11-06 14:00:05 +00:00
// #define RGBLIGHT_COLOR_LAYER_0 0x00, 0x00, 0xFF
2017-11-09 13:12:43 +00:00
/* #define RGBLIGHT_COLOR_LAYER_1 0x00, 0x00, 0xFF */
/* #define RGBLIGHT_COLOR_LAYER_2 0xFF, 0x00, 0x00 */
/* #define RGBLIGHT_COLOR_LAYER_3 0x00, 0xFF, 0x00 */
/* #define RGBLIGHT_COLOR_LAYER_4 0xFF, 0xFF, 0x00 */
/* #define RGBLIGHT_COLOR_LAYER_5 0x00, 0xFF, 0xFF */
/* #define RGBLIGHT_COLOR_LAYER_6 0xFF, 0x00, 0xFF */
/* #define RGBLIGHT_COLOR_LAYER_7 0xFF, 0xFF, 0xFF */
2017-11-06 14:00:05 +00:00
2015-10-26 20:32:37 +00:00
/*
* Feature disable options
* These options are also useful to firmware size reduction .
*/
/* disable debug print */
// #define NO_DEBUG
/* disable print */
// #define NO_PRINT
/* disable action features */
//#define NO_ACTION_LAYER
//#define NO_ACTION_TAPPING
//#define NO_ACTION_ONESHOT
//#define NO_ACTION_MACRO
//#define NO_ACTION_FUNCTION
//#define DEBUG_MATRIX_SCAN_RATE
# endif