bindings/spi/sprd%2Cspi-adi.yaml

1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
3 ---
4 $id: http://devicetree.org/schemas/spi/sprd,spi-adi.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: Spreadtrum ADI controller
10   - Orson Zhai <orsonzhai@gmail.com>
11   - Baolin Wang <baolin.wang7@gmail.com>
12   - Chunyan Zhang <zhang.lyra@gmail.com>
15   ADI is the abbreviation of Anolog-Digital interface, which is used to access
16   analog chip (such as PMIC) from digital chip. ADI controller follows the SPI
20   ADI controller has 50 channels including 2 software read/write channels and
21   48 hardware channels to access analog chip. For 2 software read/write channels,
22   users should set ADI registers to access analog chip. For hardware channels,
25   then users can access the mapped analog chip address by this hardware channel
28   Thus we introduce one property named "sprd,hw-channels" to configure hardware
31   the analog chip address where user want to access by hardware components.
33   Since we have multi-subsystems will use unique ADI to access analog chip, when
37   ADI registers will make ADI controller registers chaos to lead incorrect results.
40   The new version ADI controller supplies multiple master channels for different
46   - $ref: /schemas/spi/spi-controller.yaml#
51       - sprd,sc9860-adi
52       - sprd,sc9863-adi
53       - sprd,ums512-adi
61   hwlock-names:
64   sprd,hw-channels:
65     $ref: /schemas/types.yaml#/definitions/uint32-matrix
71         - description: The hardware channel id which is used to transfer data
72             triggered by hardware automatically, channel id 0-1 are for software
73             use, 2-49 are hardware channels.
76         - description: The analog chip address where user want to access by
80   - compatible
81   - reg
82   - '#address-cells'
83   - '#size-cells'
88   - |
90         #address-cells = <2>;
91         #size-cells = <2>;
94             compatible = "sprd,sc9860-adi";
97             hwlock-names = "adi";
98             #address-cells = <1>;
99             #size-cells = <0>;
100             sprd,hw-channels = <30 0x8c20>;