^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) %YAML 1.2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) ---
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) $id: http://devicetree.org/schemas/soundwire/soundwire-controller.yaml#
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) $schema: http://devicetree.org/meta-schemas/core.yaml#
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) title: SoundWire Controller Generic Binding
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) maintainers:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) - Srinivas Kandagatla <srinivas.kandagatla@linaro.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) - Vinod Koul <vkoul@kernel.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) description: |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) SoundWire busses can be described with a node for the SoundWire controller
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) device and a set of child nodes for each SoundWire slave on the bus.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) properties:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) $nodename:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) pattern: "^soundwire(@.*)?$"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) "#address-cells":
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) const: 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) "#size-cells":
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) const: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) patternProperties:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) "^.*@[0-9a-f],[0-9a-f]$":
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) type: object
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) properties:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) compatible:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) pattern: "^sdw[0-9a-f]{1}[0-9a-f]{4}[0-9a-f]{4}[0-9a-f]{2}$"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) description: Is the textual representation of SoundWire Enumeration
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) address. compatible string should contain SoundWire Version ID,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) Manufacturer ID, Part ID and Class ID in order and shall be in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) lower-case hexadecimal with leading zeroes.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) Valid sizes of these fields are
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) Version ID is 1 nibble, number '0x1' represents SoundWire 1.0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) and '0x2' represents SoundWire 1.1 and so on.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) MFD is 4 nibbles
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) PID is 4 nibbles
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) CID is 2 nibbles
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) More Information on detail of encoding of these fields can be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) found in MIPI Alliance DisCo & SoundWire 1.0 Specifications.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) reg:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) maxItems: 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) Link ID followed by Instance ID of SoundWire Device Address.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) required:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) - compatible
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) - reg
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) required:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) - "#address-cells"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) - "#size-cells"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) additionalProperties: true
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) examples:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) - |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) soundwire@c2d0000 {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) #address-cells = <2>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) #size-cells = <0>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) reg = <0x0c2d0000 0x2000>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) speaker@0,1 {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) compatible = "sdw10217201000";
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) reg = <0 1>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) powerdown-gpios = <&wcdpinctrl 2 0>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) #thermal-sensor-cells = <0>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) #sound-dai-cells = <0>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) speaker@0,2 {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) compatible = "sdw10217201000";
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) reg = <0 2>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) powerdown-gpios = <&wcdpinctrl 2 0>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) #thermal-sensor-cells = <0>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) #sound-dai-cells = <0>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) ...
Orange Pi5 kernel
Deprecated Linux kernel 5.10.110 for OrangePi 5/5B/5+ boards
3 Commits
0 Branches
0 Tags