| # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) |
| %YAML 1.2 |
| --- |
| $id: http://devicetree.org/schemas/soundwire/soundwire-controller.yaml# |
| $schema: http://devicetree.org/meta-schemas/core.yaml# |
| |
| title: SoundWire Controller Generic Binding |
| |
| maintainers: |
| - Srinivas Kandagatla <srinivas.kandagatla@linaro.org> |
| - Vinod Koul <vkoul@kernel.org> |
| |
| description: | |
| SoundWire busses can be described with a node for the SoundWire controller |
| device and a set of child nodes for each SoundWire slave on the bus. |
| |
| properties: |
| $nodename: |
| pattern: "^soundwire(@.*)?$" |
| |
| "#address-cells": |
| const: 2 |
| |
| "#size-cells": |
| const: 0 |
| |
| patternProperties: |
| "^.*@[0-9a-f],[0-9a-f]$": |
| type: object |
| |
| properties: |
| compatible: |
| pattern: "^sdw[0-9a-f]{1}[0-9a-f]{4}[0-9a-f]{4}[0-9a-f]{2}$" |
| description: Is the textual representation of SoundWire Enumeration |
| address. compatible string should contain SoundWire Version ID, |
| Manufacturer ID, Part ID and Class ID in order and shall be in |
| lower-case hexadecimal with leading zeroes. |
| Valid sizes of these fields are |
| Version ID is 1 nibble, number '0x1' represents SoundWire 1.0 |
| and '0x2' represents SoundWire 1.1 and so on. |
| MFD is 4 nibbles |
| PID is 4 nibbles |
| CID is 2 nibbles |
| More Information on detail of encoding of these fields can be |
| found in MIPI Alliance DisCo & SoundWire 1.0 Specifications. |
| |
| reg: |
| maxItems: 1 |
| description: |
| Link ID followed by Instance ID of SoundWire Device Address. |
| |
| required: |
| - compatible |
| - reg |
| |
| required: |
| - "#address-cells" |
| - "#size-cells" |
| |
| additionalProperties: true |
| |
| examples: |
| - | |
| soundwire@c2d0000 { |
| #address-cells = <2>; |
| #size-cells = <0>; |
| reg = <0x0c2d0000 0x2000>; |
| |
| speaker@0,1 { |
| compatible = "sdw10217201000"; |
| reg = <0 1>; |
| powerdown-gpios = <&wcdpinctrl 2 0>; |
| #thermal-sensor-cells = <0>; |
| #sound-dai-cells = <0>; |
| }; |
| |
| speaker@0,2 { |
| compatible = "sdw10217201000"; |
| reg = <0 2>; |
| powerdown-gpios = <&wcdpinctrl 2 0>; |
| #thermal-sensor-cells = <0>; |
| #sound-dai-cells = <0>; |
| }; |
| }; |
| |
| ... |
