dca669354e
Another pass at removing unnecessary use of 'allOf' with a '$ref'. json-schema versions draft7 and earlier have a weird behavior in that any keywords combined with a '$ref' are ignored (silently). The correct form was to put a '$ref' under an 'allOf'. This behavior is now changed in the 2019-09 json-schema spec and '$ref' can be mixed with other keywords. Cc: Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com> Cc: Thierry Reding <thierry.reding@gmail.com> Cc: Sam Ravnborg <sam@ravnborg.org> Cc: Dmitry Torokhov <dmitry.torokhov@gmail.com> Cc: Pavel Machek <pavel@ucw.cz> Cc: Guenter Roeck <groeck@chromium.org> Cc: Richard Weinberger <richard@nod.at> Cc: Vignesh Raghavendra <vigneshr@ti.com> Cc: "David S. Miller" <davem@davemloft.net> Cc: Kishon Vijay Abraham I <kishon@ti.com> Cc: Sebastian Reichel <sre@kernel.org> Cc: Mathieu Poirier <mathieu.poirier@linaro.org> Signed-off-by: Rob Herring <robh@kernel.org> Acked-by: Mark Brown <broonie@kernel.org> Reviewed-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Acked-By: Vinod Koul <vkoul@kernel.org> Acked-by: Lee Jones <lee.jones@linaro.org> Acked-by: Marek Behún <kabel@kernel.org> Acked-by: Miquel Raynal <miquel.raynal@bootlin.com> Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com> Acked-by: Jakub Kicinski <kuba@kernel.org> Acked-by: Bjorn Andersson <bjorn.andersson@linaro.org> Link: https://lore.kernel.org/r/20220228213802.1639658-1-robh@kernel.org
123 lines
3.3 KiB
YAML
123 lines
3.3 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
|
|
# Copyright 2019-2020 Artur Rojek
|
|
%YAML 1.2
|
|
---
|
|
$id: "http://devicetree.org/schemas/input/adc-joystick.yaml#"
|
|
$schema: "http://devicetree.org/meta-schemas/core.yaml#"
|
|
|
|
title: ADC attached joystick
|
|
|
|
maintainers:
|
|
- Artur Rojek <contact@artur-rojek.eu>
|
|
|
|
description: >
|
|
Bindings for joystick devices connected to ADC controllers supporting
|
|
the Industrial I/O subsystem.
|
|
|
|
properties:
|
|
compatible:
|
|
const: adc-joystick
|
|
|
|
io-channels:
|
|
minItems: 1
|
|
maxItems: 1024
|
|
description: >
|
|
List of phandle and IIO specifier pairs.
|
|
Each pair defines one ADC channel to which a joystick axis is connected.
|
|
See
|
|
https://github.com/devicetree-org/dt-schema/blob/master/schemas/iio/iio-consumer.yaml
|
|
for details.
|
|
|
|
'#address-cells':
|
|
const: 1
|
|
|
|
'#size-cells':
|
|
const: 0
|
|
|
|
required:
|
|
- compatible
|
|
- io-channels
|
|
- '#address-cells'
|
|
- '#size-cells'
|
|
|
|
additionalProperties: false
|
|
|
|
patternProperties:
|
|
"^axis@[0-9a-f]+$":
|
|
type: object
|
|
description: >
|
|
Represents a joystick axis bound to the given ADC channel.
|
|
For each entry in the io-channels list, one axis subnode with a matching
|
|
reg property must be specified.
|
|
|
|
properties:
|
|
reg:
|
|
minimum: 0
|
|
maximum: 1023
|
|
description: Index of an io-channels list entry bound to this axis.
|
|
|
|
linux,code:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description: EV_ABS specific event code generated by the axis.
|
|
|
|
abs-range:
|
|
$ref: /schemas/types.yaml#/definitions/uint32-array
|
|
items:
|
|
- description: minimum value
|
|
- description: maximum value
|
|
description: >
|
|
Minimum and maximum values produced by the axis.
|
|
For an ABS_X axis this will be the left-most and right-most
|
|
inclination of the joystick. If min > max, it is left to userspace to
|
|
treat the axis as inverted.
|
|
This property is interpreted as two signed 32 bit values.
|
|
|
|
abs-fuzz:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description: >
|
|
Amount of noise in the input value.
|
|
Omitting this property indicates the axis is precise.
|
|
|
|
abs-flat:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description: >
|
|
Axial "deadzone", or area around the center position, where the axis
|
|
is considered to be at rest.
|
|
Omitting this property indicates the axis always returns to exactly
|
|
the center position.
|
|
|
|
required:
|
|
- reg
|
|
- linux,code
|
|
- abs-range
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/iio/adc/ingenic,adc.h>
|
|
#include <dt-bindings/input/input.h>
|
|
|
|
joystick: adc-joystick {
|
|
compatible = "adc-joystick";
|
|
io-channels = <&adc INGENIC_ADC_TOUCH_XP>,
|
|
<&adc INGENIC_ADC_TOUCH_YP>;
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
|
|
axis@0 {
|
|
reg = <0>;
|
|
linux,code = <ABS_X>;
|
|
abs-range = <3300 0>;
|
|
abs-fuzz = <4>;
|
|
abs-flat = <200>;
|
|
};
|
|
axis@1 {
|
|
reg = <1>;
|
|
linux,code = <ABS_Y>;
|
|
abs-range = <0 3300>;
|
|
abs-fuzz = <4>;
|
|
abs-flat = <200>;
|
|
};
|
|
};
|