Files
linux/Documentation/devicetree/bindings/iio/proximity/ams,as3935.yaml
Krzysztof Kozlowski e91d402168 dt-bindings: iio: proximity: ams,as3935: use spi-peripheral-props.yaml
For devices connectable by SPI bus (e.g. already using
"spi-max-frequency" property), reference the "spi-peripheral-props.yaml"
schema to allow using all SPI device properties, even these which device
bindings author did not tried yet.

Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Acked-by: Rob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20221004115642.63749-7-krzysztof.kozlowski@linaro.org
Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
2022-11-23 19:43:59 +00:00

75 lines
1.7 KiB
YAML

# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/iio/proximity/ams,as3935.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Austrian Microsystems AS3935 Franklin lightning sensor
maintainers:
- Matt Ranostay <matt.ranostay@konsulko.com>
description:
This lightening distance sensor uses an I2C or SPI interface. The
binding currently only covers the SPI option.
properties:
compatible:
const: ams,as3935
reg:
maxItems: 1
spi-max-frequency:
maximum: 2000000
spi-cpha: true
interrupts:
maxItems: 1
ams,tuning-capacitor-pf:
$ref: /schemas/types.yaml#/definitions/uint32
description:
Calibration tuning capacitor stepping value. This will require using
the calibration data from the manufacturer.
minimum: 0
maximum: 120
ams,nflwdth:
$ref: /schemas/types.yaml#/definitions/uint32
description:
Set the noise and watchdog threshold register on startup. This will
need to set according to the noise from the MCU board, and possibly
the local environment. Refer to the datasheet for the threshold settings.
required:
- compatible
- reg
- spi-cpha
- interrupts
allOf:
- $ref: /schemas/spi/spi-peripheral-props.yaml#
unevaluatedProperties: false
examples:
- |
spi {
#address-cells = <1>;
#size-cells = <0>;
lightning@0 {
compatible = "ams,as3935";
reg = <0>;
spi-max-frequency = <400000>;
spi-cpha;
interrupt-parent = <&gpio1>;
interrupts = <16 1>;
ams,tuning-capacitor-pf = <80>;
ams,nflwdth = <0x44>;
};
};
...