[PATCH 2/4] dt-bindings: iio: magnetometer: Add DT binding for Voltafield AF8133J

From: Ondřej Jirman
Date: Sun Feb 11 2024 - 15:52:42 EST


From: Icenowy Zheng <icenowy@xxxxxxx>

Voltafield AF8133J is a simple magnetometer sensor produced by Voltafield
Technology Corp, with dual power supplies (one for core and one for I/O)
and active-low reset pin.

The sensor has configurable range 1.2 - 2.2 mT and a software controlled
standby mode.

Add a device tree binding for it.

Signed-off-by: Icenowy Zheng <icenowy@xxxxxxx>
Signed-off-by: Ondřej Jirman <megi@xxxxxx>
---
.../iio/magnetometer/voltafield,af8133j.yaml | 58 +++++++++++++++++++
1 file changed, 58 insertions(+)
create mode 100644 Documentation/devicetree/bindings/iio/magnetometer/voltafield,af8133j.yaml

diff --git a/Documentation/devicetree/bindings/iio/magnetometer/voltafield,af8133j.yaml b/Documentation/devicetree/bindings/iio/magnetometer/voltafield,af8133j.yaml
new file mode 100644
index 000000000000..ab56c0f798ad
--- /dev/null
+++ b/Documentation/devicetree/bindings/iio/magnetometer/voltafield,af8133j.yaml
@@ -0,0 +1,58 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/iio/magnetometer/voltafield,af8133j.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Voltafield AF8133J magnetometer sensor
+
+maintainers:
+ - Ondřej Jirman <megi@xxxxxx>
+
+properties:
+ compatible:
+ - voltafield,af8133j
+
+ reg:
+ maxItems: 1
+
+ reset-gpios:
+ description: |
+ an pin needed for AF8133J to set the reset state. This should be usually
+ active low.
+
+ avdd-supply:
+ description: |
+ an optional regulator that needs to be on to provide AVDD power (Working
+ power, usually 3.3V) to the sensor.
+
+ dvdd-supply:
+ description: |
+ an optional regulator that needs to be on to provide DVDD power (Digital
+ IO power, 1.8V~AVDD) to the sensor.
+
+ mount-matrix:
+ description: an optional 3x3 mounting rotation matrix.
+
+required:
+ - compatible
+ - reg
+
+additionalProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/interrupt-controller/irq.h>
+ #include <dt-bindings/gpio/gpio.h>
+ i2c {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ magnetometer@1c {
+ compatible = "voltafield,af8133j";
+ reg = <0x1c>;
+ avdd-supply = <&reg_dldo1>;
+ dvdd-supply = <&reg_dldo1>;
+ reset-gpios = <&pio 1 1 GPIO_ACTIVE_LOW>;
+ };
+ };
--
2.43.0