87 lines · yaml
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)2%YAML 1.23---4$id: http://devicetree.org/schemas/soundwire/soundwire-controller.yaml#5$schema: http://devicetree.org/meta-schemas/core.yaml#6 7title: SoundWire Controller Common Properties8 9maintainers:10 - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>11 - Vinod Koul <vkoul@kernel.org>12 13description: |14 SoundWire busses can be described with a node for the SoundWire controller15 device and a set of child nodes for each SoundWire slave on the bus.16 17properties:18 $nodename:19 pattern: "^soundwire(@.*)?$"20 21 "#address-cells":22 const: 223 24 "#size-cells":25 const: 026 27patternProperties:28 "^.*@[0-9a-f],[0-9a-f]$":29 type: object30 31 properties:32 compatible:33 pattern: "^sdw[0-9a-f]{1}[0-9a-f]{4}[0-9a-f]{4}[0-9a-f]{2}$"34 description: Is the textual representation of SoundWire Enumeration35 address. compatible string should contain SoundWire Version ID,36 Manufacturer ID, Part ID and Class ID in order and shall be in37 lower-case hexadecimal with leading zeroes.38 Valid sizes of these fields are39 Version ID is 1 nibble, number '0x1' represents SoundWire 1.040 and '0x2' represents SoundWire 1.1 and so on.41 MFD is 4 nibbles42 PID is 4 nibbles43 CID is 2 nibbles44 More Information on detail of encoding of these fields can be45 found in MIPI Alliance DisCo & SoundWire 1.0 Specifications.46 47 reg:48 maxItems: 149 description:50 Link ID followed by Instance ID of SoundWire Device Address.51 52 required:53 - compatible54 - reg55 56required:57 - "#address-cells"58 - "#size-cells"59 60additionalProperties: true61 62examples:63 - |64 soundwire@c2d0000 {65 #address-cells = <2>;66 #size-cells = <0>;67 reg = <0x0c2d0000 0x2000>;68 69 speaker@0,1 {70 compatible = "sdw10217201000";71 reg = <0 1>;72 powerdown-gpios = <&wcdpinctrl 2 0>;73 #thermal-sensor-cells = <0>;74 #sound-dai-cells = <0>;75 };76 77 speaker@0,2 {78 compatible = "sdw10217201000";79 reg = <0 2>;80 powerdown-gpios = <&wcdpinctrl 2 0>;81 #thermal-sensor-cells = <0>;82 #sound-dai-cells = <0>;83 };84 };85 86...87