[processor-sdk/pdk.git] / packages / ti / drv / sciclient / soc / sysfw / binaries / system-firmware-public-documentation / 5_soc_doc / am64x / ra_cfg.html
3 <!DOCTYPE html>
4 <!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
5 <!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
6 <head>
7 <meta charset="utf-8">
9 <meta name="viewport" content="width=device-width, initial-scale=1.0">
11 <title>AM64X Ring Accelerator Device Descriptions — TISCI User Guide</title>
16 <link rel="shortcut icon" href="../../_static/favicon.ico"/>
29 <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
33 <link rel="stylesheet" href="../../_static/theme_overrides.css" type="text/css" />
37 <link rel="index" title="Index"
38 href="../../genindex.html"/>
39 <link rel="search" title="Search" href="../../search.html"/>
40 <link rel="top" title="TISCI User Guide" href="../../index.html"/>
41 <link rel="up" title="Chapter 5: SoC Family Specific Documentation" href="../index.html"/>
42 <link rel="next" title="AM64X DMA Device Descriptions" href="dma_cfg.html"/>
43 <link rel="prev" title="AM64X Interrupt Management Device Descriptions" href="interrupt_cfg.html"/>
46 <script src="../../_static/js/modernizr.min.js"></script>
48 </head>
50 <body class="wy-body-for-nav" role="document">
51 <header id="tiHeader">
52 <div class="top">
53 <ul>
54 <li id="top_logo">
55 <a href="http://www.ti.com">
56 <img src="../../_static/img/ti_logo.png"/>
57 </a>
58 </li>
59 </ul>
60 </div>
61 <div class="nav"></div>
62 </header>
63 <div class="wy-grid-for-nav">
66 <nav data-toggle="wy-nav-shift" class="wy-nav-side">
67 <div class="wy-side-scroll">
68 <div class="wy-side-nav-search">
72 <a href="../../index.html" class="icon icon-home"> TISCI
76 </a>
81 <div class="version">
82 20.00.02
83 </div>
88 <div role="search">
89 <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
90 <input type="text" name="q" placeholder="Search docs" />
91 <input type="hidden" name="check_keywords" value="yes" />
92 <input type="hidden" name="area" value="default" />
93 </form>
94 </div>
97 </div>
99 <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
103 <ul class="current">
104 <li class="toctree-l1"><a class="reference internal" href="../../1_intro/index.html">Chapter 1: Introduction</a></li>
105 <li class="toctree-l1"><a class="reference internal" href="../../2_tisci_msgs/index.html">Chapter 2: TISCI Message Documentation</a></li>
106 <li class="toctree-l1"><a class="reference internal" href="../../3_boardcfg/index.html">Chapter 3: Board Configuration</a></li>
107 <li class="toctree-l1"><a class="reference internal" href="../../4_trace/index.html">Chapter 4: Interpreting Trace Data</a></li>
108 <li class="toctree-l1 current"><a class="reference internal" href="../index.html">Chapter 5: SoC Family Specific Documentation</a><ul class="current">
109 <li class="toctree-l2"><a class="reference internal" href="../index.html#am65x-sr1">AM65x SR1</a></li>
110 <li class="toctree-l2"><a class="reference internal" href="../index.html#am65x-sr2">AM65x SR2</a></li>
111 <li class="toctree-l2 current"><a class="reference internal" href="../index.html#am64x">AM64x</a><ul class="current">
112 <li class="toctree-l3"><a class="reference internal" href="hosts.html">AM64X Host Descriptions</a></li>
113 <li class="toctree-l3"><a class="reference internal" href="devices.html">AM64X Devices Descriptions</a></li>
114 <li class="toctree-l3"><a class="reference internal" href="clocks.html">AM64X Clock Identifiers</a></li>
115 <li class="toctree-l3"><a class="reference internal" href="pll_data.html">AM64X PLL Defaults</a></li>
116 <li class="toctree-l3"><a class="reference internal" href="resasg_types.html">AM64X Board Configuration Resource Assignment Type Descriptions</a></li>
117 <li class="toctree-l3"><a class="reference internal" href="interrupt_cfg.html">AM64X Interrupt Management Device Descriptions</a></li>
118 <li class="toctree-l3 current"><a class="current reference internal" href="#">AM64X Ring Accelerator Device Descriptions</a><ul>
119 <li class="toctree-l4"><a class="reference internal" href="#introduction">Introduction</a></li>
120 <li class="toctree-l4"><a class="reference internal" href="#ring-accelerator-device-ids">Ring Accelerator Device IDs</a></li>
121 <li class="toctree-l4"><a class="reference internal" href="#ring-accelerator-ring-indices">Ring Accelerator Ring Indices</a></li>
122 </ul>
123 </li>
124 <li class="toctree-l3"><a class="reference internal" href="dma_cfg.html">AM64X DMA Device Descriptions</a></li>
125 <li class="toctree-l3"><a class="reference internal" href="psil_cfg.html">AM64X PSI-L Device Descriptions</a></li>
126 <li class="toctree-l3"><a class="reference internal" href="proxy_cfg.html">AM64X Proxy Device Descriptions</a></li>
127 <li class="toctree-l3"><a class="reference internal" href="sec_proxy.html">AM64X Secure Proxy Descriptions</a></li>
128 <li class="toctree-l3"><a class="reference internal" href="processors.html">AM64X Processor Descriptions</a></li>
129 <li class="toctree-l3"><a class="reference internal" href="runtime_keystore.html">AM6 Runtime Keystore</a></li>
130 <li class="toctree-l3"><a class="reference internal" href="firewalls.html">AM64X Firewall Descriptions</a></li>
131 <li class="toctree-l3"><a class="reference internal" href="soc_devgrps.html">AM64X Device Group descriptions</a></li>
132 </ul>
133 </li>
134 <li class="toctree-l2"><a class="reference internal" href="../index.html#j721e">J721E</a></li>
135 <li class="toctree-l2"><a class="reference internal" href="../index.html#j721e-legacy">J721E Legacy</a></li>
136 <li class="toctree-l2"><a class="reference internal" href="../index.html#j7200">J7200</a></li>
137 </ul>
138 </li>
139 <li class="toctree-l1"><a class="reference internal" href="../../6_topic_user_guides/index.html">Chapter 6: Topic User Guides</a></li>
140 </ul>
144 </div>
145 </div>
146 </nav>
148 <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
151 <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
152 <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
153 <a href="../../index.html">TISCI</a>
154 </nav>
158 <div class="wy-nav-content">
159 <div class="rst-content">
166 <div role="navigation" aria-label="breadcrumbs navigation">
167 <ul class="wy-breadcrumbs">
168 <li><a href="../../index.html">Docs</a> »</li>
170 <li><a href="../index.html">Chapter 5: SoC Family Specific Documentation</a> »</li>
172 <li>AM64X Ring Accelerator Device Descriptions</li>
173 <li class="wy-breadcrumbs-aside">
177 </li>
178 </ul>
179 <hr/>
180 </div>
181 <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
182 <div itemprop="articleBody">
184 <div class="section" id="am64x-ring-accelerator-device-descriptions">
185 <h1>AM64X Ring Accelerator Device Descriptions<a class="headerlink" href="#am64x-ring-accelerator-device-descriptions" title="Permalink to this headline">¶</a></h1>
186 <div class="section" id="introduction">
187 <h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h2>
188 <p>This chapter provides information on the Ring Accelerator devices in the AM64X
189 SoC. Some System Firmware TISCI messages take device specific inputs. This
190 chapter provides information on the valid values for Ring Accelerator TISCI
191 message parameters.</p>
192 </div>
193 <div class="section" id="ring-accelerator-device-ids">
194 <span id="pub-soc-am64x-ra-device-ids"></span><h2>Ring Accelerator Device IDs<a class="headerlink" href="#ring-accelerator-device-ids" title="Permalink to this headline">¶</a></h2>
195 <p>Some System Firmware TISCI message APIs require the Ring Accelerator device ID
196 be provided as part of the request. Based on <a class="reference internal" href="devices.html"><span class="doc">AM64X Device IDs</span></a>
197 these are the valid Ring Accelerator device IDs.</p>
198 <table border="1" class="docutils">
199 <colgroup>
200 <col width="52%" />
201 <col width="48%" />
202 </colgroup>
203 <thead valign="bottom">
204 <tr class="row-odd"><th class="head">Ring Accelerator Device Name</th>
205 <th class="head">Ring Accelerator Device ID</th>
206 </tr>
207 </thead>
208 <tbody valign="top">
209 <tr class="row-even"><td>AM64X_DEV_DMASS0_BCDMA_0</td>
210 <td>26</td>
211 </tr>
212 <tr class="row-odd"><td>AM64X_DEV_DMASS0_PKTDMA_0</td>
213 <td>30</td>
214 </tr>
215 <tr class="row-even"><td>AM64X_DEV_DMASS0_RINGACC_0</td>
216 <td>33</td>
217 </tr>
218 </tbody>
219 </table>
220 </div>
221 <div class="section" id="ring-accelerator-ring-indices">
222 <span id="pub-soc-am64x-ra-rings"></span><h2>Ring Accelerator Ring Indices<a class="headerlink" href="#ring-accelerator-ring-indices" title="Permalink to this headline">¶</a></h2>
223 <p>This section describes valid Ring Accelerator ring indices for each ring type.
224 The ring index and type ID are used in some Ring Accelerator based TISCI
225 messages.</p>
226 <div class="admonition warning">
227 <p class="first admonition-title">Warning</p>
228 <p class="last">Resources marked as reserved for use by DMSC <strong>cannot</strong> be assigned to a
229 host within the RM Board Configuration resource assignment array. The RM
230 Board Configuration is rejected if an overlap with a reserved resource is
231 detected.</p>
232 </div>
233 <p><strong>DMASS0_BCDMA_0</strong></p>
234 <table border="1" class="docutils">
235 <colgroup>
236 <col width="47%" />
237 <col width="53%" />
238 </colgroup>
239 <thead valign="bottom">
240 <tr class="row-odd"><th class="head">Ring Type</th>
241 <th class="head">Ring Index Range</th>
242 </tr>
243 </thead>
244 <tbody valign="top">
245 <tr class="row-even"><td>BLOCK_COPY_CHAN</td>
246 <td>0 to 27</td>
247 </tr>
248 <tr class="row-odd"><td>SPLIT_TR_TX_CHAN</td>
249 <td>28 to 47</td>
250 </tr>
251 <tr class="row-even"><td>SPLIT_TR_RX_CHAN</td>
252 <td>48 to 67</td>
253 </tr>
254 </tbody>
255 </table>
256 <p><strong>DMASS0_PKTDMA_0</strong></p>
257 <table border="1" class="docutils">
258 <colgroup>
259 <col width="64%" />
260 <col width="36%" />
261 </colgroup>
262 <thead valign="bottom">
263 <tr class="row-odd"><th class="head">Ring Type</th>
264 <th class="head">Ring Index Range</th>
265 </tr>
266 </thead>
267 <tbody valign="top">
268 <tr class="row-even"><td>UNMAPPED_TX_CHAN</td>
269 <td>0 to 15</td>
270 </tr>
271 <tr class="row-odd"><td>CPSW_TX_CHAN</td>
272 <td>16 to 79</td>
273 </tr>
274 <tr class="row-even"><td>SAUL_TX_0_CHAN
275 (<strong>RESERVED BY SYSTEM FIRMWARE</strong>)</td>
276 <td>80 to 80</td>
277 </tr>
278 <tr class="row-odd"><td>SAUL_TX_0_CHAN</td>
279 <td>81 to 87</td>
280 </tr>
281 <tr class="row-even"><td>SAUL_TX_1_CHAN</td>
282 <td>88 to 95</td>
283 </tr>
284 <tr class="row-odd"><td>ICSSG_0_TX_CHAN</td>
285 <td>96 to 103</td>
286 </tr>
287 <tr class="row-even"><td>ICSSG_1_TX_CHAN</td>
288 <td>104 to 111</td>
289 </tr>
290 <tr class="row-odd"><td>UNMAPPED_RX_CHAN</td>
291 <td>112 to 127</td>
292 </tr>
293 <tr class="row-even"><td>CPSW_RX_CHAN</td>
294 <td>128 to 143</td>
295 </tr>
296 <tr class="row-odd"><td>SAUL_RX_0_CHAN
297 (<strong>RESERVED BY SYSTEM FIRMWARE</strong>)</td>
298 <td>144 to 144</td>
299 </tr>
300 <tr class="row-even"><td>SAUL_RX_1_CHAN</td>
301 <td>144 to 151</td>
302 </tr>
303 <tr class="row-odd"><td>SAUL_RX_0_CHAN</td>
304 <td>145 to 151</td>
305 </tr>
306 <tr class="row-even"><td>SAUL_RX_2_CHAN</td>
307 <td>152 to 159</td>
308 </tr>
309 <tr class="row-odd"><td>SAUL_RX_3_CHAN</td>
310 <td>152 to 159</td>
311 </tr>
312 <tr class="row-even"><td>ICSSG_0_RX_CHAN</td>
313 <td>160 to 223</td>
314 </tr>
315 <tr class="row-odd"><td>ICSSG_1_RX_CHAN</td>
316 <td>224 to 287</td>
317 </tr>
318 </tbody>
319 </table>
320 <p><strong>DMASS0_RINGACC_0</strong></p>
321 <table border="1" class="docutils">
322 <colgroup>
323 <col width="39%" />
324 <col width="61%" />
325 </colgroup>
326 <thead valign="bottom">
327 <tr class="row-odd"><th class="head">Ring Type</th>
328 <th class="head">Ring Index Range</th>
329 </tr>
330 </thead>
331 <tbody valign="top">
332 <tr class="row-even"><td>GENERIC_IPC</td>
333 <td>20 to 31</td>
334 </tr>
335 </tbody>
336 </table>
337 </div>
338 </div>
341 </div>
342 </div>
343 <footer>
345 <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
347 <a href="dma_cfg.html" class="btn btn-neutral float-right" title="AM64X DMA Device Descriptions" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
350 <a href="interrupt_cfg.html" class="btn btn-neutral" title="AM64X Interrupt Management Device Descriptions" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
352 </div>
355 <hr/>
357 <div role="contentinfo">
358 <p>
359 <a href="http://www.ti.com/corp/docs/legal/copyright.shtml">© Copyright 2016-2020</a>, Texas Instruments Incorporated. All rights reserved. <br>
360 <a href="http://www.ti.com/corp/docs/legal/trademark/trademrk.htm">Trademarks</a> | <a href="http://www.ti.com/corp/docs/legal/privacy.shtml">Privacy policy</a> | <a href="http://www.ti.com/corp/docs/legal/termsofuse.shtml">Terms of use</a> | <a href="http://www.ti.com/lsds/ti/legal/termsofsale.page">Terms of sale</a>
362 </p>
363 </div>
365 </footer>
367 </div>
368 </div>
370 </section>
372 </div>
378 <script type="text/javascript">
379 var DOCUMENTATION_OPTIONS = {
380 URL_ROOT:'../../',
381 VERSION:'20.00.02',
382 COLLAPSE_INDEX:false,
383 FILE_SUFFIX:'.html',
384 HAS_SOURCE: true
385 };
386 </script>
387 <script type="text/javascript" src="../../_static/jquery.js"></script>
388 <script type="text/javascript" src="../../_static/underscore.js"></script>
389 <script type="text/javascript" src="../../_static/doctools.js"></script>
390 <script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
392 <script src="http://www.ti.com/assets/js/headerfooter/analytics.js" type="text/javascript" charset="utf-8"></script>
398 <script type="text/javascript" src="../../_static/js/theme.js"></script>
403 <script type="text/javascript">
404 jQuery(function () {
405 SphinxRtdTheme.StickyNav.enable();
406 });
408 var menuHeight = window.innerHeight;
410 var contentOffset = $(".wy-nav-content-wrap").offset();
411 var contentHeight = $(".wy-nav-content-wrap").height();
412 var contentBottom = contentOffset.top + contentHeight;
414 function setNavbarTop() {
415 var scrollTop = $(window).scrollTop();
416 var maxTop = scrollTop + menuHeight;
418 // If past the header
419 if (scrollTop > contentOffset.top && maxTop < contentBottom) {
420 stickyTop = scrollTop - contentOffset.top;
421 } else if (maxTop > contentBottom) {
422 stickyTop = scrollTop - contentOffset.top - (maxTop - contentBottom);
423 } else {
424 stickyTop = 0;
425 }
427 $(".wy-nav-side").css("top", stickyTop);
428 }
430 $(document).ready(function() {
431 setNavbarTop();
432 $(window).scroll(function () {
433 setNavbarTop();
434 });
436 $('body').on("mousewheel", function () {
437 // Remove default behavior
438 event.preventDefault();
439 // Scroll without smoothing
440 var wheelDelta = event.wheelDelta;
441 var currentScrollPosition = window.pageYOffset;
442 window.scrollTo(0, currentScrollPosition - wheelDelta);
443 });
444 });
445 </script>
448 </body>
449 </html>