xref: /linux/Documentation/devicetree/bindings/spi/qcom,spi-qup.yaml (revision d6a4371c3cdd4febb6ccb860832409fd9a61e12a)
1*d6a4371cSKrzysztof Kozlowski# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2*d6a4371cSKrzysztof Kozlowski%YAML 1.2
3*d6a4371cSKrzysztof Kozlowski---
4*d6a4371cSKrzysztof Kozlowski$id: http://devicetree.org/schemas/spi/qcom,spi-qup.yaml#
5*d6a4371cSKrzysztof Kozlowski$schema: http://devicetree.org/meta-schemas/core.yaml#
6*d6a4371cSKrzysztof Kozlowski
7*d6a4371cSKrzysztof Kozlowskititle: Qualcomm Universal Peripheral (QUP) Serial Peripheral Interface (SPI)
8*d6a4371cSKrzysztof Kozlowski
9*d6a4371cSKrzysztof Kozlowskimaintainers:
10*d6a4371cSKrzysztof Kozlowski  - Andy Gross <agross@kernel.org>
11*d6a4371cSKrzysztof Kozlowski  - Bjorn Andersson <bjorn.andersson@linaro.org>
12*d6a4371cSKrzysztof Kozlowski  - Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
13*d6a4371cSKrzysztof Kozlowski
14*d6a4371cSKrzysztof Kozlowskidescription:
15*d6a4371cSKrzysztof Kozlowski  The QUP core is an AHB slave that provides a common data path (an output FIFO
16*d6a4371cSKrzysztof Kozlowski  and an input FIFO) for serial peripheral interface (SPI) mini-core.
17*d6a4371cSKrzysztof Kozlowski
18*d6a4371cSKrzysztof Kozlowski  SPI in master mode supports up to 50MHz, up to four chip selects,
19*d6a4371cSKrzysztof Kozlowski  programmable data path from 4 bits to 32 bits and numerous protocol variants.
20*d6a4371cSKrzysztof Kozlowski
21*d6a4371cSKrzysztof KozlowskiallOf:
22*d6a4371cSKrzysztof Kozlowski  - $ref: /schemas/spi/spi-controller.yaml#
23*d6a4371cSKrzysztof Kozlowski
24*d6a4371cSKrzysztof Kozlowskiproperties:
25*d6a4371cSKrzysztof Kozlowski  compatible:
26*d6a4371cSKrzysztof Kozlowski    enum:
27*d6a4371cSKrzysztof Kozlowski      - qcom,spi-qup-v1.1.1 # for 8660, 8960 and 8064
28*d6a4371cSKrzysztof Kozlowski      - qcom,spi-qup-v2.1.1 # for 8974 and later
29*d6a4371cSKrzysztof Kozlowski      - qcom,spi-qup-v2.2.1 # for 8974 v2 and later
30*d6a4371cSKrzysztof Kozlowski
31*d6a4371cSKrzysztof Kozlowski  clocks:
32*d6a4371cSKrzysztof Kozlowski    maxItems: 2
33*d6a4371cSKrzysztof Kozlowski
34*d6a4371cSKrzysztof Kozlowski  clock-names:
35*d6a4371cSKrzysztof Kozlowski    items:
36*d6a4371cSKrzysztof Kozlowski      - const: core
37*d6a4371cSKrzysztof Kozlowski      - const: iface
38*d6a4371cSKrzysztof Kozlowski
39*d6a4371cSKrzysztof Kozlowski  dmas:
40*d6a4371cSKrzysztof Kozlowski    maxItems: 2
41*d6a4371cSKrzysztof Kozlowski
42*d6a4371cSKrzysztof Kozlowski  dma-names:
43*d6a4371cSKrzysztof Kozlowski    items:
44*d6a4371cSKrzysztof Kozlowski      - const: tx
45*d6a4371cSKrzysztof Kozlowski      - const: rx
46*d6a4371cSKrzysztof Kozlowski
47*d6a4371cSKrzysztof Kozlowski  interrupts:
48*d6a4371cSKrzysztof Kozlowski    maxItems: 1
49*d6a4371cSKrzysztof Kozlowski
50*d6a4371cSKrzysztof Kozlowski  reg:
51*d6a4371cSKrzysztof Kozlowski    maxItems: 1
52*d6a4371cSKrzysztof Kozlowski
53*d6a4371cSKrzysztof Kozlowskirequired:
54*d6a4371cSKrzysztof Kozlowski  - compatible
55*d6a4371cSKrzysztof Kozlowski  - clocks
56*d6a4371cSKrzysztof Kozlowski  - clock-names
57*d6a4371cSKrzysztof Kozlowski  - interrupts
58*d6a4371cSKrzysztof Kozlowski  - reg
59*d6a4371cSKrzysztof Kozlowski
60*d6a4371cSKrzysztof KozlowskiunevaluatedProperties: false
61*d6a4371cSKrzysztof Kozlowski
62*d6a4371cSKrzysztof Kozlowskiexamples:
63*d6a4371cSKrzysztof Kozlowski  - |
64*d6a4371cSKrzysztof Kozlowski    #include <dt-bindings/clock/qcom,gcc-msm8996.h>
65*d6a4371cSKrzysztof Kozlowski    #include <dt-bindings/interrupt-controller/arm-gic.h>
66*d6a4371cSKrzysztof Kozlowski
67*d6a4371cSKrzysztof Kozlowski    spi@7575000 {
68*d6a4371cSKrzysztof Kozlowski        compatible = "qcom,spi-qup-v2.2.1";
69*d6a4371cSKrzysztof Kozlowski        reg = <0x07575000 0x600>;
70*d6a4371cSKrzysztof Kozlowski        interrupts = <GIC_SPI 95 IRQ_TYPE_LEVEL_HIGH>;
71*d6a4371cSKrzysztof Kozlowski        clocks = <&gcc GCC_BLSP1_QUP1_SPI_APPS_CLK>,
72*d6a4371cSKrzysztof Kozlowski                 <&gcc GCC_BLSP1_AHB_CLK>;
73*d6a4371cSKrzysztof Kozlowski        clock-names = "core", "iface";
74*d6a4371cSKrzysztof Kozlowski        pinctrl-names = "default", "sleep";
75*d6a4371cSKrzysztof Kozlowski        pinctrl-0 = <&blsp1_spi1_default>;
76*d6a4371cSKrzysztof Kozlowski        pinctrl-1 = <&blsp1_spi1_sleep>;
77*d6a4371cSKrzysztof Kozlowski        dmas = <&blsp1_dma 12>, <&blsp1_dma 13>;
78*d6a4371cSKrzysztof Kozlowski        dma-names = "tx", "rx";
79*d6a4371cSKrzysztof Kozlowski        #address-cells = <1>;
80*d6a4371cSKrzysztof Kozlowski        #size-cells = <0>;
81*d6a4371cSKrzysztof Kozlowski    };
82