mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-09-05 18:39:59 +00:00
![Rob Herring](/assets/img/avatar_default.png)
Adding checks for undocumented compatible strings reveals a bunch of warnings in the DT binding examples. Fix the cases which are typos, just a mismatch between the schema and the example, or aren't documented at all. In a couple of cases, fixing the compatible revealed some schema errors which are fixed. There's a bunch of others remaining after this which have bindings, but those aren't converted to schema yet. Cc: Thierry Reding <thierry.reding@gmail.com> Cc: Sam Ravnborg <sam@ravnborg.org> Cc: Pavel Machek <pavel@ucw.cz> Cc: linux-clk@vger.kernel.org Cc: dmaengine@vger.kernel.org Cc: linux-i3c@lists.infradead.org Cc: linux-iio@vger.kernel.org Cc: linux-leds@vger.kernel.org Cc: linux-pm@vger.kernel.org Cc: linux-serial@vger.kernel.org Cc: linux-spi@vger.kernel.org Signed-off-by: Rob Herring <robh@kernel.org> Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Stephen Boyd <sboyd@kernel.org> Acked-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Acked-by: Kishon Vijay Abraham I <kishon@ti.com> Acked-by: Sebastian Reichel <sre@kernel.org> Acked-by: Maxime Ripard <maxime@cerno.tech> Acked-by: Vinod Koul <vkoul@kernel.org> Acked-by: Alexandre Belloni <alexandre.belloni@bootlin.com> Acked-by: Alain Volmat <alain.volmat@foss.st.com> Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> Link: https://lore.kernel.org/r/20210316194918.3528417-1-robh@kernel.org
78 lines
2.2 KiB
YAML
78 lines
2.2 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/iio/light/upisemi,us5182.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: UPISEMI us5182d I2C ALS and Proximity sensor
|
|
|
|
maintainers:
|
|
- Jonathan Cameron <jic23@kernel.org>
|
|
|
|
properties:
|
|
compatible:
|
|
const: upisemi,usd5182
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
upisemi,glass-coef:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description: |
|
|
glass attenuation factor - compensation factor of resolution 1000
|
|
for material transmittance.
|
|
default: 1000
|
|
|
|
upisemi,dark-ths:
|
|
$ref: /schemas/types.yaml#/definitions/uint16-array
|
|
minItems: 8
|
|
maxItems: 8
|
|
description:
|
|
16-bit thresholds (adc counts) corresponding to every scale.
|
|
|
|
upisemi,upper-dark-gain:
|
|
$ref: /schemas/types.yaml#/definitions/uint8
|
|
description: |
|
|
8-bit dark gain compensation factor(4 int and 4 fractional bits - Q4.4)
|
|
applied when light > threshold.
|
|
default: 0
|
|
|
|
upisemi,lower-dark-gain:
|
|
$ref: /schemas/types.yaml#/definitions/uint8
|
|
description: |
|
|
8-bit dark gain compensation factor(4 int and 4 fractional bits - Q4.4)
|
|
applied when light < threshold.
|
|
default: 0x16
|
|
|
|
upisemi,continuous:
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
description: |
|
|
This chip has two power modes: one-shot (chip takes one measurement and
|
|
then shuts itself down) and continuous (chip takes continuous
|
|
measurements). The one-shot mode is more power-friendly but the
|
|
continuous mode may be more reliable. If this property is specified
|
|
the continuous mode will be used instead of the default one-shot one for
|
|
raw reads.
|
|
|
|
additionalProperties: false
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
|
|
examples:
|
|
- |
|
|
i2c {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
|
|
light-sensor@39 {
|
|
compatible = "upisemi,usd5182";
|
|
reg = <0x39>;
|
|
upisemi,glass-coef = < 1000 >;
|
|
upisemi,dark-ths = /bits/ 16 <170 200 512 512 800 2000 4000 8000>;
|
|
upisemi,upper-dark-gain = /bits/ 8 <0x00>;
|
|
upisemi,lower-dark-gain = /bits/ 8 <0x16>;
|
|
};
|
|
};
|
|
...
|