===================================
AM65X_SR2 PSI-L Device Descriptions
===================================

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

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

.. _pub_soc_am65x_sr2_psil_proxy_device_ids:

PSI-L Proxy Device IDs
======================

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

+---------------------------+-------------------------+
| PSI-L Proxy Device Name   |   PSI-L Proxy Device ID |
+===========================+=========================+
| AM6_DEV_NAVSS0            |                     118 |
+---------------------------+-------------------------+
| AM6_DEV_MCU_NAVSS0        |                     119 |
+---------------------------+-------------------------+

.. _pub_soc_am65x_sr2_psil_thread_ids:

PSI-L Source and Destination Thread IDs
=======================================

This section describes valid PSI-L source and destination thread IDs for each
thread type. The thread IDs are used in the PSI-L based TISCI messages.


.. warning::

    PSI-L threads marked as reserved for use by DMSC **cannot** be linked to
    another thread.

+-----------------------------------+------------------+
| Thread Type                       | Thread Range     |
+===================================+==================+
| udmap0_trstrm_tx                  | 0x8 to 0x8       |
+-----------------------------------+------------------+
| udmap0_cfgstrm_tx                 | 0x20 to 0x20     |
+-----------------------------------+------------------+
| udmap0_tx                         | 0x1000 to 0x1000 |
| (**Reserved by System Firmware**) |                  |
+-----------------------------------+------------------+
| udmap0_tx                         | 0x1001 to 0x1077 |
+-----------------------------------+------------------+
| saul0_rx                          | 0x4000 to 0x4000 |
| (**Reserved by System Firmware**) |                  |
+-----------------------------------+------------------+
| saul0_rx                          | 0x4001 to 0x4003 |
+-----------------------------------+------------------+
| icssg0_rx                         | 0x4100 to 0x4104 |
+-----------------------------------+------------------+
| icssg1_rx                         | 0x4200 to 0x4204 |
+-----------------------------------+------------------+
| icssg2_rx                         | 0x4300 to 0x4304 |
+-----------------------------------+------------------+
| pdma_main0_mcasp0_rx              | 0x4400 to 0x4400 |
+-----------------------------------+------------------+
| pdma_main0_mcasp1_rx              | 0x4401 to 0x4401 |
+-----------------------------------+------------------+
| pdma_main0_mcasp2_rx              | 0x4402 to 0x4402 |
+-----------------------------------+------------------+
| pdma_main1_spi0_rx                | 0x4500 to 0x4503 |
+-----------------------------------+------------------+
| pdma_main1_spi1_rx                | 0x4504 to 0x4507 |
+-----------------------------------+------------------+
| pdma_main1_spi2_rx                | 0x4508 to 0x450b |
+-----------------------------------+------------------+
| pdma_main1_spi3_rx                | 0x450c to 0x450f |
+-----------------------------------+------------------+
| pdma_main1_spi4_rx                | 0x4510 to 0x4513 |
+-----------------------------------+------------------+
| pdma_main1_usart0_rx              | 0x4514 to 0x4514 |
+-----------------------------------+------------------+
| pdma_main1_usart1_rx              | 0x4515 to 0x4515 |
+-----------------------------------+------------------+
| pdma_main1_usart2_rx              | 0x4516 to 0x4516 |
+-----------------------------------+------------------+
| pdma_debug_mcu_rx                 | 0x4600 to 0x4600 |
+-----------------------------------+------------------+
| pdma_debug_main_rx                | 0x4601 to 0x4601 |
+-----------------------------------+------------------+
| pdma_debug_cc_rx                  | 0x4602 to 0x4602 |
+-----------------------------------+------------------+
| cal0_rx                           | 0x4700 to 0x4707 |
+-----------------------------------+------------------+
| msmc0_rx                          | 0x4800 to 0x481f |
+-----------------------------------+------------------+
| udmap_tx                          | 0x6000 to 0x602f |
+-----------------------------------+------------------+
| pdma_cpsw0_rx                     | 0x7000 to 0x7000 |
+-----------------------------------+------------------+
| pdma_mcu0_adc12_rx                | 0x7100 to 0x7103 |
+-----------------------------------+------------------+
| pdma_mcu1_spi0_rx                 | 0x7200 to 0x7203 |
+-----------------------------------+------------------+
| pdma_mcu1_spi1_rx                 | 0x7204 to 0x7207 |
+-----------------------------------+------------------+
| pdma_mcu1_spi2_rx                 | 0x7208 to 0x720b |
+-----------------------------------+------------------+
| pdma_mcu1_mcan0_rx                | 0x720c to 0x720e |
+-----------------------------------+------------------+
| pdma_mcu1_mcan1_rx                | 0x720f to 0x7211 |
+-----------------------------------+------------------+
| pdma_mcu1_usart0_rx               | 0x7212 to 0x7212 |
+-----------------------------------+------------------+
| udmap0_rx                         | 0x9000 to 0x9001 |
| (**Reserved by System Firmware**) |                  |
+-----------------------------------+------------------+
| udmap0_rx                         | 0x9002 to 0x9095 |
+-----------------------------------+------------------+
| saul0_tx                          | 0xc000 to 0xc000 |
| (**Reserved by System Firmware**) |                  |
+-----------------------------------+------------------+
| saul0_tx                          | 0xc001 to 0xc001 |
+-----------------------------------+------------------+
| icssg0_tx                         | 0xc100 to 0xc108 |
+-----------------------------------+------------------+
| icssg1_tx                         | 0xc200 to 0xc208 |
+-----------------------------------+------------------+
| icssg2_tx                         | 0xc300 to 0xc308 |
+-----------------------------------+------------------+
| pdma_main0_mcasp0_tx              | 0xc400 to 0xc400 |
+-----------------------------------+------------------+
| pdma_main0_mcasp1_tx              | 0xc401 to 0xc401 |
+-----------------------------------+------------------+
| pdma_main0_mcasp2_tx              | 0xc402 to 0xc402 |
+-----------------------------------+------------------+
| pdma_main1_spi0_tx                | 0xc500 to 0xc503 |
+-----------------------------------+------------------+
| pdma_main1_spi1_tx                | 0xc504 to 0xc507 |
+-----------------------------------+------------------+
| pdma_main1_spi2_tx                | 0xc508 to 0xc50b |
+-----------------------------------+------------------+
| pdma_main1_spi3_tx                | 0xc50c to 0xc50f |
+-----------------------------------+------------------+
| pdma_main1_spi4_tx                | 0xc510 to 0xc513 |
+-----------------------------------+------------------+
| pdma_main1_usart0_tx              | 0xc514 to 0xc514 |
+-----------------------------------+------------------+
| pdma_main1_usart1_tx              | 0xc515 to 0xc515 |
+-----------------------------------+------------------+
| pdma_main1_usart2_tx              | 0xc516 to 0xc516 |
+-----------------------------------+------------------+
| msmc0_tx                          | 0xc800 to 0xc81f |
+-----------------------------------+------------------+
| udmap_rx                          | 0xe000 to 0xe02f |
+-----------------------------------+------------------+
| pdma_cpsw0_tx                     | 0xf000 to 0xf007 |
+-----------------------------------+------------------+
| pdma_mcu0_adc12_tx                | 0xf100 to 0xf103 |
+-----------------------------------+------------------+
| pdma_mcu1_spi0_tx                 | 0xf200 to 0xf203 |
+-----------------------------------+------------------+
| pdma_mcu1_spi1_tx                 | 0xf204 to 0xf207 |
+-----------------------------------+------------------+
| pdma_mcu1_spi2_tx                 | 0xf208 to 0xf20b |
+-----------------------------------+------------------+
| pdma_mcu1_mcan0_tx                | 0xf20c to 0xf20e |
+-----------------------------------+------------------+
| pdma_mcu1_mcan1_tx                | 0xf20f to 0xf211 |
+-----------------------------------+------------------+
| pdma_mcu1_usart0_tx               | 0xf212 to 0xf212 |
+-----------------------------------+------------------+

