Joel Spadin
4 years ago
11 changed files with 96 additions and 96 deletions
@ -1,9 +0,0 @@ |
|||||||
/ { |
|
||||||
behaviors { |
|
||||||
end: behavior_endpoints { |
|
||||||
compatible = "zmk,behavior-endpoints"; |
|
||||||
label = "ENDPOINTS"; |
|
||||||
#binding-cells = <1>; |
|
||||||
}; |
|
||||||
}; |
|
||||||
}; |
|
@ -0,0 +1,9 @@ |
|||||||
|
/ { |
||||||
|
behaviors { |
||||||
|
out: behavior_outputs { |
||||||
|
compatible = "zmk,behavior-outputs"; |
||||||
|
label = "OUTPUTS"; |
||||||
|
#binding-cells = <1>; |
||||||
|
}; |
||||||
|
}; |
||||||
|
}; |
@ -1,13 +0,0 @@ |
|||||||
/*
|
|
||||||
* Copyright (c) 2020 The ZMK Contributors |
|
||||||
* |
|
||||||
* SPDX-License-Identifier: MIT |
|
||||||
*/ |
|
||||||
|
|
||||||
#define ENDPOINT_TOGGLE_CMD 0 |
|
||||||
#define ENDPOINT_USB_CMD 1 |
|
||||||
#define ENDPOINT_BLE_CMD 2 |
|
||||||
|
|
||||||
#define END_TOG ENDPOINT_TOGGLE_CMD |
|
||||||
#define END_USB ENDPOINT_USB_CMD |
|
||||||
#define END_BLE ENDPOINT_BLE_CMD |
|
@ -0,0 +1,13 @@ |
|||||||
|
/*
|
||||||
|
* Copyright (c) 2020 The ZMK Contributors |
||||||
|
* |
||||||
|
* SPDX-License-Identifier: MIT |
||||||
|
*/ |
||||||
|
|
||||||
|
#define OUTPUT_TOGGLE_CMD 0 |
||||||
|
#define OUTPUT_USB_CMD 1 |
||||||
|
#define OUTPUT_BLE_CMD 2 |
||||||
|
|
||||||
|
#define OUT_TOG OUTPUT_TOGGLE_CMD |
||||||
|
#define OUT_USB OUTPUT_USB_CMD |
||||||
|
#define OUT_BLE OUTPUT_BLE_CMD |
@ -1,59 +0,0 @@ |
|||||||
--- |
|
||||||
title: Endpoint Behavior |
|
||||||
sidebar_label: Endpoints |
|
||||||
--- |
|
||||||
|
|
||||||
## Summary |
|
||||||
|
|
||||||
The endpoint behavior allows selecting whether keyboard input is sent to the |
|
||||||
USB or bluetooth connection when both are connected. This allows connecting a |
|
||||||
keyboard to USB for power but sending input to a different device over bluetooth. |
|
||||||
|
|
||||||
By default, keyboard input is sent to USB when both endpoints are connected. |
|
||||||
Once you select a different endpoint, it will be remembered until you change it again. |
|
||||||
|
|
||||||
## Endpoints Command Defines |
|
||||||
|
|
||||||
Endpoints command defines are provided through the [`dt-bindings/zmk/endpoints.h`](https://github.com/zmkfirmware/zmk/blob/main/app/include/dt-bindings/zmk/endpoints.h) |
|
||||||
header, which is added at the top of the keymap file: |
|
||||||
|
|
||||||
``` |
|
||||||
#include <dt-bindings/zmk/endpoints.h> |
|
||||||
``` |
|
||||||
|
|
||||||
This allows you to reference the actions defined in this header: |
|
||||||
|
|
||||||
| Define | Action | Alias | |
|
||||||
| --------------------- | ---------------------------------------------------- | --------- | |
|
||||||
| `ENDPOINT_USB_CMD` | Send keyboard input to USB | `END_USB` | |
|
||||||
| `ENDPOINT_BLE_CMD` | Send keyboard input to the current bluetooth profile | `END_BLE` | |
|
||||||
| `ENDPOINT_TOGGLE_CMD` | Toggle between USB and BLE | `END_TOG` | |
|
||||||
|
|
||||||
## Endpoints Behavior |
|
||||||
|
|
||||||
The endpoints behavior changes the preferred endpoint on press. |
|
||||||
|
|
||||||
### Behavior Binding |
|
||||||
|
|
||||||
- Reference: `&end` |
|
||||||
- Parameter #1: Command, e.g. `END_BLE` |
|
||||||
|
|
||||||
### Example: |
|
||||||
|
|
||||||
1. Behavior binding to prefer sending keyboard input to USB |
|
||||||
|
|
||||||
``` |
|
||||||
&end END_USB |
|
||||||
``` |
|
||||||
|
|
||||||
1. Behavior binding to prefer sending keyboard input to the current bluetooth profile |
|
||||||
|
|
||||||
``` |
|
||||||
&end END_BLE |
|
||||||
``` |
|
||||||
|
|
||||||
1. Behavior binding to toggle between preferring USB and BLE |
|
||||||
|
|
||||||
``` |
|
||||||
&end END_TOG |
|
||||||
``` |
|
@ -0,0 +1,59 @@ |
|||||||
|
--- |
||||||
|
title: Output Selection Behavior |
||||||
|
sidebar_label: Output Selection |
||||||
|
--- |
||||||
|
|
||||||
|
## Summary |
||||||
|
|
||||||
|
The output behavior allows selecting whether keyboard output is sent to the |
||||||
|
USB or bluetooth connection when both are connected. This allows connecting a |
||||||
|
keyboard to USB for power but outputting to a different device over bluetooth. |
||||||
|
|
||||||
|
By default, output is sent to USB when both USB and BLE are connected. |
||||||
|
Once you select a different output, it will be remembered until you change it again. |
||||||
|
|
||||||
|
## Output Command Defines |
||||||
|
|
||||||
|
Output command defines are provided through the [`dt-bindings/zmk/outputs.h`](https://github.com/zmkfirmware/zmk/blob/main/app/include/dt-bindings/zmk/outputs.h) |
||||||
|
header, which is added at the top of the keymap file: |
||||||
|
|
||||||
|
``` |
||||||
|
#include <dt-bindings/zmk/outputs.h> |
||||||
|
``` |
||||||
|
|
||||||
|
This allows you to reference the actions defined in this header: |
||||||
|
|
||||||
|
| Define | Action | Alias | |
||||||
|
| ------------------- | ----------------------------------------------- | --------- | |
||||||
|
| `OUTPUT_USB_CMD` | Prefer sending to USB | `OUT_USB` | |
||||||
|
| `OUTPUT_BLE_CMD` | Prefer sending to the current bluetooth profile | `OUT_BLE` | |
||||||
|
| `OUTPUT_TOGGLE_CMD` | Toggle between USB and BLE | `OUT_TOG` | |
||||||
|
|
||||||
|
## Output Selection Behavior |
||||||
|
|
||||||
|
The output selection behavior changes the preferred output on press. |
||||||
|
|
||||||
|
### Behavior Binding |
||||||
|
|
||||||
|
- Reference: `&out` |
||||||
|
- Parameter #1: Command, e.g. `OUT_BLE` |
||||||
|
|
||||||
|
### Example: |
||||||
|
|
||||||
|
1. Behavior binding to prefer sending keyboard output to USB |
||||||
|
|
||||||
|
``` |
||||||
|
&out OUT_USB |
||||||
|
``` |
||||||
|
|
||||||
|
1. Behavior binding to prefer sending keyboard output to the current bluetooth profile |
||||||
|
|
||||||
|
``` |
||||||
|
&out OUT_BLE |
||||||
|
``` |
||||||
|
|
||||||
|
1. Behavior binding to toggle between preferring USB and BLE |
||||||
|
|
||||||
|
``` |
||||||
|
&out OUT_TOG |
||||||
|
``` |
Loading…
Reference in new issue