aboutsummaryrefslogtreecommitdiff
path: root/docs/feature_split_keyboard.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/feature_split_keyboard.md')
-rw-r--r--docs/feature_split_keyboard.md15
1 files changed, 12 insertions, 3 deletions
diff --git a/docs/feature_split_keyboard.md b/docs/feature_split_keyboard.md
index dc081ff3a..3613775d7 100644
--- a/docs/feature_split_keyboard.md
+++ b/docs/feature_split_keyboard.md
@@ -243,7 +243,12 @@ This sets how many LEDs are directly connected to each controller. The first nu
243```c 243```c
244#define SPLIT_USB_DETECT 244#define SPLIT_USB_DETECT
245``` 245```
246This option changes the startup behavior to detect an active USB connection when delegating master/slave. If this operation times out, then the half is assume to be a slave. This is the default behavior for ARM, and required for AVR Teensy boards (due to hardware limitations). 246
247Enabling this option changes the startup behavior to listen for an active USB communication to delegate which part is master and which is slave. With this option enabled and theres's USB communication, then that half assumes it is the master, otherwise it assumes it is the slave.
248
249Without this option, the master is the half that can detect voltage on the physical USB connection (VBUS detection).
250
251Enabled by default on ChibiOS/ARM.
247 252
248?> This setting will stop the ability to demo using battery packs. 253?> This setting will stop the ability to demo using battery packs.
249 254
@@ -259,9 +264,13 @@ This sets the poll frequency when detecting master/slave when using `SPLIT_USB_D
259 264
260## Hardware Considerations and Mods 265## Hardware Considerations and Mods
261 266
262While most any Pro Micro can be used, micro controllers like the AVR Teensys and most (if not all) ARM boards require the Split USB Detect. 267Master/slave delegation is made either by detecting voltage on VBUS connection or waiting for USB communication (`SPLIT_USB_DETECT`). Pro Micro boards can use VBUS detection out of the box and be used with or without `SPLIT_USB_DETECT`.
268
269Many ARM boards, but not all, do not support VBUS detection. Because it is common that ARM boards lack VBUS detection, `SPLIT_USB_DETECT` is automatically defined on ARM targets (technically when ChibiOS is targetted).
270
271### Teensy boards
263 272
264However, with the Teensy 2.0 and Teensy++ 2.0, there is a simple hardware mod that you can perform to add VBUS detection, so you don't need the Split USB detection option. 273Teensy boards lack VBUS detection out of the box and must have `SPLIT_USB_DETECT` defined. With the Teensy 2.0 and Teensy++ 2.0, there is a simple hardware mod that you can perform to add VBUS detection, so you don't need the `SPLIT_USB_DETECT` option.
265 274
266You'll only need a few things: 275You'll only need a few things:
267 276