9d69d47fd3
The Devicetree bindings document does not have to say in the title that
it is a "Devicetree binding", but instead just describe the hardware.
Drop beginning "Devicetree bindings" in various forms:
find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
-exec sed -i -e 's/^title: [dD]evice[ -]\?[tT]ree [bB]indings\? for \([tT]he \)\?\(.*\)$/title: \u\2/' {} \;
find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
-exec sed -i -e 's/^title: [bB]indings\? for \([tT]he \)\?\(.*\)$/title: \u\2/' {} \;
find Documentation/devicetree/bindings/ -type f -name '*.yaml' \
-exec sed -i -e 's/^title: [dD][tT] [bB]indings\? for \([tT]he \)\?\(.*\)$/title: \u\2/' {} \;
Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Acked-by: Alexandre Belloni <alexandre.belloni@bootlin.com>
Reviewed-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
Acked-by: Ulf Hansson <ulf.hansson@linaro.org> # MMC
Acked-by: Stephen Boyd <sboyd@kernel.org> # clk
Acked-by: Dmitry Torokhov <dmitry.torokhov@gmail.com> # input
Acked-by: Mark Brown <broonie@kernel.org>
Acked-by: Sebastian Reichel <sre@kernel.org> # power
Link: https://lore.kernel.org/r/20221216163815.522628-8-krzysztof.kozlowski@linaro.org
Signed-off-by: Rob Herring <robh@kernel.org>
143 lines
3.4 KiB
YAML
143 lines
3.4 KiB
YAML
# SPDX-License-Identifier: GPL-2.0-only
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/input/gpio-keys.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: GPIO attached keys
|
|
|
|
maintainers:
|
|
- Rob Herring <robh@kernel.org>
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- gpio-keys
|
|
- gpio-keys-polled
|
|
|
|
autorepeat: true
|
|
|
|
label:
|
|
description: Name of entire device
|
|
|
|
poll-interval: true
|
|
|
|
patternProperties:
|
|
"^(button|event|key|switch|(button|event|key|switch)-[a-z0-9-]+|[a-z0-9-]+-(button|event|key|switch))$":
|
|
$ref: input.yaml#
|
|
|
|
properties:
|
|
gpios:
|
|
maxItems: 1
|
|
|
|
interrupts:
|
|
maxItems: 1
|
|
|
|
label:
|
|
description: Descriptive name of the key.
|
|
|
|
linux,code:
|
|
description: Key / Axis code to emit.
|
|
|
|
linux,input-type:
|
|
default: 1 # EV_KEY
|
|
|
|
linux,input-value:
|
|
description: |
|
|
If linux,input-type is EV_ABS or EV_REL then this
|
|
value is sent for events this button generates when pressed.
|
|
EV_ABS/EV_REL axis will generate an event with a value of 0
|
|
when all buttons with linux,input-type == type and
|
|
linux,code == axis are released. This value is interpreted
|
|
as a signed 32 bit value, e.g. to make a button generate a
|
|
value of -1 use:
|
|
|
|
linux,input-value = <0xffffffff>; /* -1 */
|
|
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
|
|
debounce-interval:
|
|
description:
|
|
Debouncing interval time in milliseconds. If not specified defaults to 5.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
|
|
default: 5
|
|
|
|
wakeup-source:
|
|
description: Button can wake-up the system.
|
|
|
|
wakeup-event-action:
|
|
description: |
|
|
Specifies whether the key should wake the system when asserted, when
|
|
deasserted, or both. This property is only valid for keys that wake up the
|
|
system (e.g., when the "wakeup-source" property is also provided).
|
|
|
|
Supported values are defined in linux-event-codes.h:
|
|
|
|
EV_ACT_ANY - both asserted and deasserted
|
|
EV_ACT_ASSERTED - asserted
|
|
EV_ACT_DEASSERTED - deasserted
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum: [0, 1, 2]
|
|
|
|
linux,can-disable:
|
|
description:
|
|
Indicates that button is connected to dedicated (not shared) interrupt
|
|
which can be disabled to suppress events from the button.
|
|
type: boolean
|
|
|
|
required:
|
|
- linux,code
|
|
|
|
anyOf:
|
|
- required:
|
|
- interrupts
|
|
- required:
|
|
- interrupts-extended
|
|
- required:
|
|
- gpios
|
|
|
|
dependencies:
|
|
wakeup-event-action: [ wakeup-source ]
|
|
linux,input-value: [ gpios ]
|
|
|
|
unevaluatedProperties: false
|
|
|
|
allOf:
|
|
- $ref: input.yaml#
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
const: gpio-keys-polled
|
|
then:
|
|
required:
|
|
- poll-interval
|
|
else:
|
|
properties:
|
|
poll-interval: false
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/interrupt-controller/irq.h>
|
|
|
|
gpio-keys {
|
|
compatible = "gpio-keys";
|
|
autorepeat;
|
|
|
|
key-up {
|
|
label = "GPIO Key UP";
|
|
linux,code = <103>;
|
|
gpios = <&gpio1 0 1>;
|
|
};
|
|
|
|
key-down {
|
|
label = "GPIO Key DOWN";
|
|
linux,code = <108>;
|
|
interrupts = <1 IRQ_TYPE_EDGE_FALLING>;
|
|
};
|
|
};
|
|
|
|
...
|