0001 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
0002 %YAML 1.2
0003 ---
0004 $id: http://devicetree.org/schemas/soundwire/soundwire-controller.yaml#
0005 $schema: http://devicetree.org/meta-schemas/core.yaml#
0006
0007 title: SoundWire Controller Generic Binding
0008
0009 maintainers:
0010 - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
0011 - Vinod Koul <vkoul@kernel.org>
0012
0013 description: |
0014 SoundWire busses can be described with a node for the SoundWire controller
0015 device and a set of child nodes for each SoundWire slave on the bus.
0016
0017 properties:
0018 $nodename:
0019 pattern: "^soundwire(@.*)?$"
0020
0021 "#address-cells":
0022 const: 2
0023
0024 "#size-cells":
0025 const: 0
0026
0027 patternProperties:
0028 "^.*@[0-9a-f],[0-9a-f]$":
0029 type: object
0030
0031 properties:
0032 compatible:
0033 pattern: "^sdw[0-9a-f]{1}[0-9a-f]{4}[0-9a-f]{4}[0-9a-f]{2}$"
0034 description: Is the textual representation of SoundWire Enumeration
0035 address. compatible string should contain SoundWire Version ID,
0036 Manufacturer ID, Part ID and Class ID in order and shall be in
0037 lower-case hexadecimal with leading zeroes.
0038 Valid sizes of these fields are
0039 Version ID is 1 nibble, number '0x1' represents SoundWire 1.0
0040 and '0x2' represents SoundWire 1.1 and so on.
0041 MFD is 4 nibbles
0042 PID is 4 nibbles
0043 CID is 2 nibbles
0044 More Information on detail of encoding of these fields can be
0045 found in MIPI Alliance DisCo & SoundWire 1.0 Specifications.
0046
0047 reg:
0048 maxItems: 1
0049 description:
0050 Link ID followed by Instance ID of SoundWire Device Address.
0051
0052 required:
0053 - compatible
0054 - reg
0055
0056 required:
0057 - "#address-cells"
0058 - "#size-cells"
0059
0060 additionalProperties: true
0061
0062 examples:
0063 - |
0064 soundwire@c2d0000 {
0065 #address-cells = <2>;
0066 #size-cells = <0>;
0067 reg = <0x0c2d0000 0x2000>;
0068
0069 speaker@0,1 {
0070 compatible = "sdw10217201000";
0071 reg = <0 1>;
0072 powerdown-gpios = <&wcdpinctrl 2 0>;
0073 #thermal-sensor-cells = <0>;
0074 #sound-dai-cells = <0>;
0075 };
0076
0077 speaker@0,2 {
0078 compatible = "sdw10217201000";
0079 reg = <0 2>;
0080 powerdown-gpios = <&wcdpinctrl 2 0>;
0081 #thermal-sensor-cells = <0>;
0082 #sound-dai-cells = <0>;
0083 };
0084 };
0085
0086 ...
