[<prev] [next>] [thread-next>] [day] [month] [year] [list]
Message-ID: <20220111115919.14645-1-cristian.pop@analog.com>
Date: Tue, 11 Jan 2022 13:59:18 +0200
From: Cristian Pop <cristian.pop@...log.com>
To: <linux-iio@...r.kernel.org>, <linux-gpio@...r.kernel.org>,
<linux-kernel@...r.kernel.org>
CC: <jic23@...nel.org>, <devicetree@...r.kernel.org>,
<robh+dt@...nel.org>, Cristian Pop <cristian.pop@...log.com>
Subject: [PATCH v2 1/2] dt-bindings: iio: addac: one-bit-adc-dac yaml documentation
This adds device tree bindings for the one-bit-adc-dac.
Signed-off-by: Cristian Pop <cristian.pop@...log.com>
V1->V2
- I am aware of the recommendation of rename/move this driver. Should we
consider "drivers/io/gpio.c"?
- Add .yaml file
- Remove blank lines, remove unnecessary coma
- Remove macros for channels
- Check if channel is input for write_raw
- Use labels instead of extend_name
- Fix channel indexing
- Use "sizeof(*channels)" in devm_kcalloc()
- Remove assignment: " indio_dev->dev.parent = &pdev->dev;"
- Remove "platform_set_drvdata"
- Remove "adi" from compatible string since is not ADI specific driver.
---
.../bindings/iio/addac/one-bit-adc-dac.yaml | 89 +++++++++++++++++++
1 file changed, 89 insertions(+)
create mode 100644 Documentation/devicetree/bindings/iio/addac/one-bit-adc-dac.yaml
diff --git a/Documentation/devicetree/bindings/iio/addac/one-bit-adc-dac.yaml b/Documentation/devicetree/bindings/iio/addac/one-bit-adc-dac.yaml
new file mode 100644
index 000000000000..dbed0f3b1ca4
--- /dev/null
+++ b/Documentation/devicetree/bindings/iio/addac/one-bit-adc-dac.yaml
@@ -0,0 +1,89 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+# Copyright 2020 Analog Devices Inc.
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/iio/addac/one-bit-adc-dac.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Analog Devices one bit ADC DAC driver
+
+maintainers:
+ - Cristian Pop <cristian.pop@...log.com>
+
+description: |
+ One bit ADC DAC driver
+
+properties:
+ compatible:
+ enum:
+ - adi,one-bit-adc-dac
+
+ '#address-cells':
+ const: 1
+
+ '#size-cells':
+ const: 0
+
+ in-gpios:
+ description: Input GPIOs
+
+ out-gpios:
+ description: Output GPIOs
+
+required:
+ - compatible
+ - in-gpios
+ - out-gpios
+
+patternProperties:
+ "^channel@([0-9]|1[0-5])$":
+ type: object
+ description: |
+ Represents the external channels which are connected to the ADDAC.
+
+ properties:
+ reg:
+ maxItems: 1
+ description: |
+ The channel number.
+
+ label:
+ description: |
+ Unique name to identify which channel this is.
+
+ required:
+ - reg
+
+additionalProperties: false
+
+examples:
+ - |
+ one-bit-adc-dac@0 {
+ compatible = "one-bit-adc-dac";
+
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ in-gpios = <&gpio 17 0>, <&gpio 27 0>;
+ out-gpios = <&gpio 23 0>, <&gpio 24 0>;
+
+ channel@0 {
+ reg = <0>;
+ label = "i_17";
+ };
+
+ channel@1 {
+ reg = <1>;
+ label = "i_27";
+ };
+
+ channel@2 {
+ reg = <2>;
+ label = "o_23";
+ };
+
+ channel@3 {
+ reg = <3>;
+ label = "o_24";
+ };
+ };
--
2.17.1
Powered by blists - more mailing lists