Resource Management PSI-L TISCI Message Description¶
Introduction¶
This chapter provides information on usage of the RM PSI-L management TISCI message API parameters.
| TISCI Message ID | Message Name |
|---|---|
| 0x1280 | PSI-L Pair |
| 0x1281 | PSI-L Unpair |
PSI-L Pair¶
The psil pair TISCI message API is used to pair a SoC Navigator Subsystem source thread to a destination thread. Pairing the threads enables both threads and the source thread’s registers are programmed using the destination thread’s thread width and credit count capabilities. UDMAP channels mapped to PSI-L source and destination threads in the pair request will have their THRD_ID register programmed with the remote thread ID value.
The host requesting a psil pair operation for threads mapped to UDMAP channels must be the owner, or the supervisor of the host owning, the UDMAP channels. Therefore, psil pair operations for UDMAP mapped threads must take place after the channel(s) are allocated and configured. For threads not mapped to UDMAP channels, the host requesting the psil pair operation must have access through the region firewall covering the entity to which the thread is mapped.
The psil pair API can be used to pair source and destination threads within any Navigator Subsystem on the device.
Usage¶
| Message Type | Normal |
| Secure Queue Only? | No |
PSI-L Pair Message Parameters¶
| Parameter | Type | Valid Values | Description |
|---|---|---|---|
| hdr | Generic TISCI message header (8 bytes) | Valid Host IDs | Generic TISCI message header. Contains the message ID, host ID, sequence number, and any flags |
| nav_id | u32 | Valid Navigator Subsystem Device IDs | The SoC-specific Device ID of the Navigator subsystem in which the PSI-L proxy is located. |
| src_thread | u32 | Valid Navigator Subsystem PSI-L Source Thread Indices | Specifies the PSI-L source thread ID to be paired to the destination ID. |
| dst_thread | u32 | Valid Navigator Subsystem PSI-L Destination Thread Indices | Specifies the PSI-L destination thread ID to be aired to the source thread ID. |
PSI-L Unpair¶
The psil unpair TISCI message API is used to unpair a SoC Navigator Subsystem source thread from a destination thread. Unpairing the threads disables both threads and clears the source thread’s registers. UDMAP channels mapped to PSI-L source and destination threads in the unpair request will have their THRD_ID register cleared.
The host requesting a psil unpair operation for threads mapped to UDMAP channels must be the owner, or the supervisor of the host owning, the UDMAP channels. Therefore, psil unpair operations for UDMAP mapped threads must take place before the channel(s) are freed. For threads not mapped to UDMAP channels, the host requesting the psil unpair operation must have access through the region firewall covering the entity to which the thread is mapped.
The psil unpair API can be used to unpair source and destination threads within any Navigator Subsystem on the device.
Usage¶
| Message Type | Normal |
| Secure Queue Only? | No |
PSI-L Unpair Message Parameters¶
| Parameter | Type | Valid Values | Description |
|---|---|---|---|
| hdr | Generic TISCI message header (8 bytes) | Valid Host IDs | Generic TISCI message header. Contains the message ID, host ID, sequence number, and any flags |
| nav_id | u32 | Valid Navigator Subsystem Device IDs | The SoC-specific Device ID of the Navigator subsystem in which the PSI-L proxy is located. |
| src_thread | u32 | Valid Navigator Subsystem PSI-L Source Thread Indices | Specifies the PSI-L source thread ID to be unpaired from the destination ID. |
| dst_thread | u32 | Valid Navigator Subsystem PSI-L Destination Thread Indices | Specifies the PSI-L destination thread ID to be unpaired from the source thread ID. |