forked from forks/qmk_firmware
75 lines
2.9 KiB
Markdown
75 lines
2.9 KiB
Markdown
## Programmable Button
|
||
|
||
Programmable button is a feature that can be used to send keys that have no
|
||
predefined meaning.
|
||
This means they can be processed on the host side by custom software without
|
||
colliding without the operating system trying to interpret these keys.
|
||
|
||
The keycodes are emitted according to the HID usage
|
||
"Telephony Device Page" (0x0B), "Programmable button usage" (0x07).
|
||
On Linux (> 5.14) they are handled automatically and translated to `KEY_MACRO#`
|
||
keycodes.
|
||
(Up to `KEY_MACRO30`)
|
||
|
||
### Enabling Programmable Button support
|
||
|
||
To enable Programmable Button, add the following line to your keymap’s `rules.mk`:
|
||
|
||
```c
|
||
PROGRAMMABLE_BUTTON_ENABLE = yes
|
||
```
|
||
|
||
### Mapping
|
||
|
||
In your keymap you can use the following keycodes to map key presses to Programmable Buttons:
|
||
|
||
|Key |Description |
|
||
|------------------------|----------------------|
|
||
|`PROGRAMMABLE_BUTTON_1` |Programmable button 1 |
|
||
|`PROGRAMMABLE_BUTTON_2` |Programmable button 2 |
|
||
|`PROGRAMMABLE_BUTTON_3` |Programmable button 3 |
|
||
|`PROGRAMMABLE_BUTTON_4` |Programmable button 4 |
|
||
|`PROGRAMMABLE_BUTTON_5` |Programmable button 5 |
|
||
|`PROGRAMMABLE_BUTTON_6` |Programmable button 6 |
|
||
|`PROGRAMMABLE_BUTTON_7` |Programmable button 7 |
|
||
|`PROGRAMMABLE_BUTTON_8` |Programmable button 8 |
|
||
|`PROGRAMMABLE_BUTTON_9` |Programmable button 9 |
|
||
|`PROGRAMMABLE_BUTTON_10`|Programmable button 10|
|
||
|`PROGRAMMABLE_BUTTON_11`|Programmable button 11|
|
||
|`PROGRAMMABLE_BUTTON_12`|Programmable button 12|
|
||
|`PROGRAMMABLE_BUTTON_13`|Programmable button 13|
|
||
|`PROGRAMMABLE_BUTTON_14`|Programmable button 14|
|
||
|`PROGRAMMABLE_BUTTON_15`|Programmable button 15|
|
||
|`PROGRAMMABLE_BUTTON_16`|Programmable button 16|
|
||
|`PROGRAMMABLE_BUTTON_17`|Programmable button 17|
|
||
|`PROGRAMMABLE_BUTTON_18`|Programmable button 18|
|
||
|`PROGRAMMABLE_BUTTON_19`|Programmable button 19|
|
||
|`PROGRAMMABLE_BUTTON_20`|Programmable button 20|
|
||
|`PROGRAMMABLE_BUTTON_21`|Programmable button 21|
|
||
|`PROGRAMMABLE_BUTTON_22`|Programmable button 22|
|
||
|`PROGRAMMABLE_BUTTON_23`|Programmable button 23|
|
||
|`PROGRAMMABLE_BUTTON_24`|Programmable button 24|
|
||
|`PROGRAMMABLE_BUTTON_25`|Programmable button 25|
|
||
|`PROGRAMMABLE_BUTTON_26`|Programmable button 26|
|
||
|`PROGRAMMABLE_BUTTON_27`|Programmable button 27|
|
||
|`PROGRAMMABLE_BUTTON_28`|Programmable button 28|
|
||
|`PROGRAMMABLE_BUTTON_29`|Programmable button 29|
|
||
|`PROGRAMMABLE_BUTTON_30`|Programmable button 30|
|
||
|`PROGRAMMABLE_BUTTON_31`|Programmable button 31|
|
||
|`PROGRAMMABLE_BUTTON_32`|Programmable button 32|
|
||
|`PB_1` to `PB_32` |Aliases for keymaps |
|
||
|
||
### API
|
||
|
||
You can also use a dedicated API defined in `programmable_button.h` to interact with this feature:
|
||
|
||
```
|
||
void programmable_button_clear(void);
|
||
void programmable_button_send(void);
|
||
void programmable_button_on(uint8_t code);
|
||
void programmable_button_off(uint8_t code);
|
||
bool programmable_button_is_on(uint8_t code);
|
||
uint32_t programmable_button_get_report(void);
|
||
void programmable_button_set_report(uint32_t report);
|
||
```
|