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
22   users should set ADI registers to access analog chip. For hardware channels,
26   triggered by hardware components instead of ADI software channels.
28   Thus we introduce one property named "sprd,hw-channels" to configure hardware
33   Since we have multi-subsystems will use unique ADI to access analog chip, when
34   one system is reading/writing data by ADI software channels, that should be under
36   data by ADI software channels at the same time, or two parallel routine of setting
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:
62     const: adi
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>;