=================================
AM65X_SR2 DMA Device Descriptions
=================================

Introduction
============

This chapter provides information on the DMA devices in the AM65X_SR2 SoC.  Some
System Firmware TISCI messages take device specific inputs. This chapter
provides information on the valid values for DMA TISCI message parameters.

.. _pub_soc_am65x_sr2_dma_device_ids:

DMA Device IDs
==============

Some System Firmware TISCI message APIs require the DMA device ID be provided as
part of the request. Based on :doc:`AM65X_SR2 Device IDs <devices>` these are
the valid DMA device IDs.

+---------------------------+-----------------+
| DMA Device Name           |   DMA Device ID |
+===========================+=================+
| AM6_DEV_NAVSS0_UDMAP0     |             188 |
+---------------------------+-----------------+
| AM6_DEV_MCU_NAVSS0_UDMAP0 |             194 |
+---------------------------+-----------------+

.. _pub_soc_am65x_sr2_dma_channels_and_flows:

DMA Channel and Flow Indices
============================

This section describes valid DMA channel indexes for each DMA channel type.
Receive flow index range type information is also described if applicable to the
DMA being described.


.. warning::

    Resources marked as reserved for use by DMSC **cannot** be assigned to a
    host within the RM Board Configuration resource assignment array.  The RM
    Board Configuration is rejected if an overlap with a reserved resource is
    detected.


**navss0_udmap0**

+-----------------------------------+--------------------------+
| Tx Channel Type                   | Tx Channel Index Range   |
+===================================+==========================+
| TX_HCHAN                          | 0 to 0                   |
| (**RESERVED BY SYSTEM FIRMWARE**) |                          |
+-----------------------------------+--------------------------+
| TX_HCHAN                          | 1 to 7                   |
+-----------------------------------+--------------------------+
| TX_CHAN                           | 8 to 119                 |
+-----------------------------------+--------------------------+
| TX_ECHAN                          | 120 to 151               |
+-----------------------------------+--------------------------+

+-----------------------------------+--------------------------+
| Rx Channel Type                   | Rx Channel Index Range   |
+===================================+==========================+
| RX_HCHAN                          | 0 to 1                   |
| (**RESERVED BY SYSTEM FIRMWARE**) |                          |
+-----------------------------------+--------------------------+
| RX_HCHAN                          | 2 to 7                   |
+-----------------------------------+--------------------------+
| RX_CHAN                           | 8 to 149                 |
+-----------------------------------+--------------------------+


**NOTE**: The host that owns configurable, also known as common or shared, flows
is able to delegate them to another host for configuration in order to aid some
use case configurations.  The configurable flows can be delegated using
:ref:`TISCI_MSG_RM_UDMAP_FLOW_DELEGATE <pub_rm_public_udmap_flow_delegate>`

+-----------------------------------+-----------------------+
| Rx Flow Type                      | Rx Flow Index Range   |
+===================================+=======================+
| DEFAULT                           | 0 to 1                |
| (**RESERVED BY SYSTEM FIRMWARE**) |                       |
+-----------------------------------+-----------------------+
| DEFAULT                           | 2 to 149              |
+-----------------------------------+-----------------------+
| CONFIGURABLE                      | 150 to 299            |
+-----------------------------------+-----------------------+


**mcu_navss0_udmap0**

+-------------------+--------------------------+
| Tx Channel Type   | Tx Channel Index Range   |
+===================+==========================+
| TX_HCHAN          | 0 to 1                   |
+-------------------+--------------------------+
| TX_CHAN           | 2 to 47                  |
+-------------------+--------------------------+

+-------------------+--------------------------+
| Rx Channel Type   | Rx Channel Index Range   |
+===================+==========================+
| RX_HCHAN          | 0 to 1                   |
+-------------------+--------------------------+
| RX_CHAN           | 2 to 47                  |
+-------------------+--------------------------+


**NOTE**: The host that owns configurable, also known as common or shared, flows
is able to delegate them to another host for configuration in order to aid some
use case configurations.  The configurable flows can be delegated using
:ref:`TISCI_MSG_RM_UDMAP_FLOW_DELEGATE <pub_rm_public_udmap_flow_delegate>`

+----------------+-----------------------+
| Rx Flow Type   | Rx Flow Index Range   |
+================+=======================+
| DEFAULT        | 0 to 47               |
+----------------+-----------------------+
| CONFIGURABLE   | 48 to 95              |
+----------------+-----------------------+

