zmk/app/dts/bindings/zmk,boot-magic-combo.yaml

24 lines
800 B
YAML

# Copyright (c) 2026, The ZMK Contributors
# SPDX-License-Identifier: MIT
description: |
Triggers one or more actions if a combination of keys is held while the keyboard boots.
This is typically used for recovering a keyboard in cases such as &bootloader
being missing from the keymap or a split peripheral which isn't connected to
the central, and therefore can't process the keymap.
compatible: "zmk,boot-magic-combo"
properties:
combo-positions:
type: array
required: true
description: Zero-based indices of the keys which must be simultaneously pressed to trigger the action(s).
# Boot magic actions:
jump-to-bootloader:
type: boolean
description: Reboots into the bootloader.
reset-settings:
type: boolean
description: Clears settings and reboots.