1 # SPDX-License-Identifier: (GPL-2.0-only OR BS
2 # Copyright (C) 2020 Texas Instruments Incorpo
3 # Author: Peter Ujfalusi <peter.ujfalusi@ti.com
4 %YAML 1.2
5 ---
6 $id: http://devicetree.org/schemas/dma/ti/k3-p
7 $schema: http://devicetree.org/meta-schemas/co
8
9 title: Texas Instruments K3 DMSS PKTDMA
10
11 maintainers:
12 - Peter Ujfalusi <peter.ujfalusi@gmail.com>
13
14 description: |
15 The Packet DMA (PKTDMA) is intended to perfo
16 mode channels of K3 UDMA-P.
17 PKTDMA only includes Split channels to servi
18
19 The peripherals can be PSI-L native or legac
20 with PDMAs. PDMA is tasked to act as a bridg
21 legacy peripheral.
22
23 PDMAs can be configured via PKTDMA split cha
24 with the configuration of the legacy periphe
25
26 allOf:
27 - $ref: /schemas/dma/dma-controller.yaml#
28 - $ref: /schemas/arm/keystone/ti,k3-sci-comm
29
30 properties:
31 compatible:
32 const: ti,am64-dmss-pktdma
33
34 "#dma-cells":
35 const: 2
36 description: |
37 The first cell is the PSI-L thread ID o
38 Valid ranges for thread ID depends on th
39 for source thread IDs (rx): 0 - 0x7fff
40 for destination thread IDs (tx): 0x8000
41
42 Please refer to the device documentation
43 the PSI-L peripheral chapter for the cor
44
45 The second cell is the ASEL value for th
46
47 reg:
48 minItems: 4
49 items:
50 - description: Packet DMA Control /Statu
51 - description: RX Channel Realtime Regis
52 - description: TX Channel Realtime Regis
53 - description: Ring Realtime Registers r
54 - description: Ring Configuration Regist
55 - description: TX Configuration Register
56 - description: RX Configuration Register
57 - description: RX Flow Configuration Reg
58
59 reg-names:
60 minItems: 4
61 items:
62 - const: gcfg
63 - const: rchanrt
64 - const: tchanrt
65 - const: ringrt
66 - const: ring
67 - const: tchan
68 - const: rchan
69 - const: rflow
70
71 msi-parent: true
72
73 ti,sci-rm-range-tchan:
74 $ref: /schemas/types.yaml#/definitions/uin
75 description: |
76 Array of PKTDMA split tx channel resourc
77 for this host
78 minItems: 1
79 # Should be enough
80 maxItems: 255
81 items:
82 maximum: 0x3f
83
84 ti,sci-rm-range-tflow:
85 $ref: /schemas/types.yaml#/definitions/uin
86 description: |
87 Array of PKTDMA split tx flow resource s
88 for this host
89 minItems: 1
90 # Should be enough
91 maxItems: 255
92 items:
93 maximum: 0x3f
94
95 ti,sci-rm-range-rchan:
96 $ref: /schemas/types.yaml#/definitions/uin
97 description: |
98 Array of PKTDMA split rx channel resourc
99 for this host
100 minItems: 1
101 # Should be enough
102 maxItems: 255
103 items:
104 maximum: 0x3f
105
106 ti,sci-rm-range-rflow:
107 $ref: /schemas/types.yaml#/definitions/uin
108 description: |
109 Array of PKTDMA split rx flow resource s
110 for this host
111 minItems: 1
112 # Should be enough
113 maxItems: 255
114 items:
115 maximum: 0x3f
116
117 required:
118 - compatible
119 - "#dma-cells"
120 - reg
121 - reg-names
122 - msi-parent
123 - ti,sci
124 - ti,sci-dev-id
125 - ti,sci-rm-range-tchan
126 - ti,sci-rm-range-tflow
127 - ti,sci-rm-range-rchan
128 - ti,sci-rm-range-rflow
129
130 unevaluatedProperties: false
131
132 examples:
133 - |+
134 cbass_main {
135 #address-cells = <2>;
136 #size-cells = <2>;
137
138 main_dmss {
139 compatible = "simple-mfd";
140 #address-cells = <2>;
141 #size-cells = <2>;
142 dma-ranges;
143 ranges;
144
145 ti,sci-dev-id = <25>;
146
147 main_pktdma: dma-controller@485c00
148 compatible = "ti,am64-dmss-pkt
149
150 reg = <0x0 0x485c0000 0x0 0x10
151 <0x0 0x4a800000 0x0 0x20
152 <0x0 0x4aa00000 0x0 0x40
153 <0x0 0x4b800000 0x0 0x40
154 <0x0 0x485e0000 0x0 0x20
155 <0x0 0x484a0000 0x0 0x40
156 <0x0 0x484c0000 0x0 0x20
157 <0x0 0x48430000 0x0 0x40
158 reg-names = "gcfg", "rchanrt",
159 "ring", "tchan", "
160
161 msi-parent = <&inta_main_dmss>
162 #dma-cells = <2>;
163
164 ti,sci = <&dmsc>;
165 ti,sci-dev-id = <30>;
166
167 ti,sci-rm-range-tchan = <0x23>
168 <0x24>
169 <0x25>
170 <0x26>
171 <0x27>
172 <0x28>
173 ti,sci-rm-range-tflow = <0x10>
174 <0x11>
175 <0x12>
176 <0x13>
177 <0x14>
178 <0x15>
179 ti,sci-rm-range-rchan = <0x29>
180 <0x2b>
181 <0x2d>
182 <0x2f>
183 <0x31>
184 <0x33>
185 <0x35>
186 <0x37>
187 ti,sci-rm-range-rflow = <0x2a>
188 <0x2c>
189 <0x2e>
190 <0x32>
191 <0x36>
192 <0x38>
193 };
194 };
195 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.