zmk/app/dts/bindings/behaviors/zmk,behavior-send-string.yaml
Joel Spadin 76ffce6779 feat(behaviors): Add a send string behavior
This adds the following:

- A character map driver API, which maps Unicode code points to behavior
  bindings.

- A zmk,character-map driver which implements this API. This driver is
  designed for ROM efficiency, so it sends every value defined in the
  map to one behavior and passes any code point not in the map through
  to another. (A more flexible implementation that allows for a unique
  behavior binding per character could be added later if necessary.)

- A zmk,send-string behavior, which users can define and bind to their
  keymaps to send strings.

- A zmk_send_string() function, which queues the necessary behaviors
  to type a UTF-8 string. This is separated from the send string
  behavior since it could be used for other features such as Unicode
  key sequences, behaviors that print dynamic messages, etc.
2024-04-07 15:05:06 -05:00

26 lines
651 B
YAML

# Copyright (c) 2023 The ZMK Contributors
# SPDX-License-Identifier: MIT
description: Send String Behavior
compatible: "zmk,behavior-send-string"
include: zero_param.yaml
properties:
text:
type: string
required: true
description: The text to send.
wait-ms:
type: int
description: The time to wait (in milliseconds) before pressing the next key in the text.
tap-ms:
type: int
description: The time to wait (in milliseconds) between the press and release of each key in the text.
charmap:
type: phandle
description: A zmk,character-map instance to use. If omitted, the zmk,charmap chosen node is used.