From 7bcb85a1d614c7c4d7c6113b20a72b77979bb9df Mon Sep 17 00:00:00 2001 From: Peter Johanson Date: Wed, 19 Feb 2025 17:24:21 -0700 Subject: [PATCH] fixup! docs: Add wired split config docs. --- docs/docs/features/split-keyboards.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/docs/features/split-keyboards.md b/docs/docs/features/split-keyboards.md index 1d317109e62..e7b28e1d664 100644 --- a/docs/docs/features/split-keyboards.md +++ b/docs/docs/features/split-keyboards.md @@ -13,6 +13,12 @@ Full-duplex UART, wired split support is currently experimental, and is availabl Future single-wire, half-duplex UART support, which is planned, will allow using wired ZMK with designs like Corne, Sweep, etc. that use only a single GPIO pin for bidirectional communication between split sides. ::: +:::warning[Hot Plugging Cables] + +Many popular cables, in particular, TRRS/TRS cables, can cause irreparable damage to controllers if they are inserted or removed when power is already present on them. Whether or not you are using the wired split functionality or not, _never_ insert or remove such a cable when a controller is powered by USB _or_ battery. + +::: + ## Central and Peripheral Roles In split keyboards running ZMK, one part is assigned the "central" role which receives key position and sensor events from the other parts that are called "peripherals."