xref: /linux/Documentation/devicetree/bindings/iio/dac/st,stm32-dac.yaml (revision 001821b0e79716c4e17c71d8e053a23599a7a508) 
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/iio/dac/st,stm32-dac.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: STMicroelectronics STM32 DAC
8
9description: |
10  The STM32 DAC is a 12-bit voltage output digital-to-analog converter. The DAC
11  may be configured in 8 or 12-bit mode. It has two output channels, each with
12  its own converter.
13  It has built-in noise and triangle waveform generator and supports external
14  triggers for conversions. The DAC's output buffer allows a high drive output
15  current.
16
17maintainers:
18  - Fabrice Gasnier <fabrice.gasnier@foss.st.com>
19
20properties:
21  compatible:
22    enum:
23      - st,stm32f4-dac-core
24      - st,stm32h7-dac-core
25
26  reg:
27    maxItems: 1
28
29  resets:
30    maxItems: 1
31
32  clocks:
33    maxItems: 1
34
35  clock-names:
36    items:
37      - const: pclk
38
39  vref-supply:
40    description: Phandle to the vref input analog reference voltage.
41
42  '#address-cells':
43    const: 1
44
45  '#size-cells':
46    const: 0
47
48  access-controllers:
49    minItems: 1
50    maxItems: 2
51
52additionalProperties: false
53
54required:
55  - compatible
56  - reg
57  - clocks
58  - clock-names
59  - vref-supply
60  - '#address-cells'
61  - '#size-cells'
62
63patternProperties:
64  "^dac@[1-2]+$":
65    type: object
66    description:
67      A DAC block node should contain at least one subnode, representing an
68      DAC instance/channel available on the machine.
69
70    properties:
71      compatible:
72        const: st,stm32-dac
73
74      reg:
75        description: Must be either 1 or 2, to define (single) channel in use
76        enum: [1, 2]
77
78      '#io-channel-cells':
79        const: 1
80
81    additionalProperties: false
82
83    required:
84      - compatible
85      - reg
86      - '#io-channel-cells'
87
88examples:
89  - |
90    // Example on stm32mp157c
91    #include <dt-bindings/clock/stm32mp1-clks.h>
92    dac: dac@40017000 {
93      compatible = "st,stm32h7-dac-core";
94      reg = <0x40017000 0x400>;
95      clocks = <&rcc DAC12>;
96      clock-names = "pclk";
97      vref-supply = <&vref>;
98      #address-cells = <1>;
99      #size-cells = <0>;
100
101      dac@1 {
102        compatible = "st,stm32-dac";
103        #io-channel-cells = <1>;
104        reg = <1>;
105      };
106
107      dac@2 {
108        compatible = "st,stm32-dac";
109        #io-channel-cells = <1>;
110        reg = <2>;
111      };
112    };
113
114...
115