diff options
| author | brickbots <rich@brickbots.com> | 2020-03-22 06:06:16 -0700 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2020-03-23 00:06:16 +1100 |
| commit | bfb2f8e0a8f809374fdec102eb02c3bce46a14ee (patch) | |
| tree | 2bab982f9b1cc9184b58ca9764d1ba09e133335c /docs | |
| parent | d8f3c28a3786e7888fe3157c173845107c3ccc95 (diff) | |
| download | qmk_firmware-bfb2f8e0a8f809374fdec102eb02c3bce46a14ee.tar.gz qmk_firmware-bfb2f8e0a8f809374fdec102eb02c3bce46a14ee.zip | |
Add Word Per Minute calculation feature (#8054)
* Add Word Per Minute calculation feature
* Fix copyright info
* Remove header from quantum.c, setup overloadable keycode inclusion for WPM, update docs
* Simplify logic for keycode filtering
* Adding link from summary to wpm_feature info
* Update docs/feature_wpm.md
Typo in function prototype example in docs
Co-Authored-By: James Young <18669334+noroadsleft@users.noreply.github.com>
* Add WPM transport via i2c
Co-authored-by: James Young <18669334+noroadsleft@users.noreply.github.com>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/_summary.md | 1 | ||||
| -rw-r--r-- | docs/feature_wpm.md | 25 |
2 files changed, 26 insertions, 0 deletions
diff --git a/docs/_summary.md b/docs/_summary.md index d6186bbf9..4a6e6996e 100644 --- a/docs/_summary.md +++ b/docs/_summary.md | |||
| @@ -80,6 +80,7 @@ | |||
| 80 | * [Terminal](feature_terminal.md) | 80 | * [Terminal](feature_terminal.md) |
| 81 | * [Unicode](feature_unicode.md) | 81 | * [Unicode](feature_unicode.md) |
| 82 | * [Userspace](feature_userspace.md) | 82 | * [Userspace](feature_userspace.md) |
| 83 | * [WPM Calculation](feature_wpm.md) | ||
| 83 | 84 | ||
| 84 | * Hardware Features | 85 | * Hardware Features |
| 85 | * Displays | 86 | * Displays |
diff --git a/docs/feature_wpm.md b/docs/feature_wpm.md new file mode 100644 index 000000000..12dd08057 --- /dev/null +++ b/docs/feature_wpm.md | |||
| @@ -0,0 +1,25 @@ | |||
| 1 | # Word Per Minute (WPM) Calculcation | ||
| 2 | |||
| 3 | The WPM feature uses time between keystrokes to compute a rolling average words | ||
| 4 | per minute rate and makes this available for various uses. | ||
| 5 | |||
| 6 | Enable the WPM system by adding this to your `rules.mk`: | ||
| 7 | |||
| 8 | WPM_ENABLE = yes | ||
| 9 | |||
| 10 | For split keyboards using soft serial, the computed WPM | ||
| 11 | score will be available on the master AND slave half. | ||
| 12 | |||
| 13 | ## Public Functions | ||
| 14 | |||
| 15 | `uint8_t get_current_wpm(void);` | ||
| 16 | This function returns the current WPM as an unsigned integer. | ||
| 17 | |||
| 18 | |||
| 19 | ## Customized keys for WPM calc | ||
| 20 | |||
| 21 | By default, the WPM score only includes letters, numbers, space and some | ||
| 22 | punctuation. If you want to change the set of characters considered as part of | ||
| 23 | the WPM calculation, you can implement `wpm_keycode_user(uint16_t keycode)` | ||
| 24 | and return true for any characters you would like included in the calculation, | ||
| 25 | or false to not count that particular keycode. | ||
