xref: /linux/Documentation/devicetree/bindings/connector/gocontroll,moduline-module-slot.yaml (revision 184e56e77c06a7eef68a021e9d4b11a11a8ab096) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/connector/gocontroll,moduline-module-slot.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: GOcontroll Moduline Module slot
8
9maintainers:
10  - Maud Spierings <maudspierings@gocontroll.com>
11
12description:
13  The GOcontroll Moduline module slot represents a connector that fullfills the
14  Moduline slot specification, and can thus house any IO module that is also
15  built to this spec.
16
17properties:
18  compatible:
19    const: gocontroll,moduline-module-slot
20
21  reg:
22    maxItems: 1
23
24  interrupts:
25    description: indicates readiness, high means busy.
26    maxItems: 1
27  reset-gpios:
28    description: resets the module, active low.
29    maxItems: 1
30  sync-gpios:
31    description: sync line between all module slots.
32    maxItems: 1
33
34  vdd-supply:
35    description: low power 3v3 supply generally for the microcontroller.
36  vddp-supply:
37    description: medium power 5v0 supply for on module low power peripherals.
38  vddhpp-supply:
39    description: high power 6v-8v supply for on module high power peripherals.
40  power-supply:
41    description: high power 6v-30v supply for high power module circuits.
42
43  i2c-bus:
44    description: i2c bus shared between module slots and the SoC
45    $ref: /schemas/types.yaml#/definitions/phandle
46
47  slot-number:
48    description:
49      The number of the module slot representing the location of on the pcb.
50      This enables access to the modules based on slot location.
51    $ref: /schemas/types.yaml#/definitions/uint32
52
53  spi-max-frequency: true
54
55required:
56  - compatible
57  - reg
58  - reset-gpios
59  - interrupts
60  - sync-gpios
61  - i2c-bus
62  - slot-number
63
64additionalProperties: false
65
66examples:
67  - |
68    #include <dt-bindings/gpio/gpio.h>
69    #include <dt-bindings/interrupt-controller/irq.h>
70
71    spi {
72        #address-cells = <1>;
73        #size-cells = <0>;
74
75        connector@0 {
76            reg = <0>;
77            compatible = "gocontroll,moduline-module-slot";
78            reset-gpios = <&gpio5 10 GPIO_ACTIVE_LOW>;
79            sync-gpios = <&gpio4 16 GPIO_ACTIVE_HIGH>;
80            interrupt-parent = <&gpio4>;
81            interrupts = <5 IRQ_TYPE_EDGE_FALLING>;
82            vdd-supply = <&reg_3v3_per>;
83            vddp-supply = <&reg_5v0>;
84            vddhpp-supply = <&reg_6v4>;
85            i2c-bus = <&i2c2>;
86            slot-number = <1>;
87        };
88    };
89