This file contains:
WARNING!!: Autogenerated file from SYSFW. DO NOT MODIFY!!
System Firmware TISCI RM PSI-L Messaging
TISCI Protocol Definitions for PSI-L messages
Pairs a PSI-L source thread to a destination thread
Pairs the specified PSI-L source thread to the specified destination thread as long as both threads are unused. A thread is determined to be in use if the thread is enabled in the non-real-time registers. The source thread's width and credit count parameters are set to the destination thread's capabilities. Both the source and destination threads are non-real-time enabled on successful pairing.
The host requesting the pair operation for threads mapped to UDMAP channels must be the owner, or the supervisor of the host owning, the UDMAP channels. Therefore, pair 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 unpair operation must have access through the region firewall covering the entity to which the thread is mapped.
The PSI-L configuration proxy used to pair the source and destination threads is based on the Navigator Subsystem specified by nav_id.
hdr | Standard TISCI header |
nav_id | SoC device ID of Navigator Subsystem whose PSI-L config proxy is used to pair the source and destination threads. |
src_thread | PSI-L source thread ID within the PSI-L System thread map. |
UDMAP transmit channels mapped to source threads will have their TCHAN_THRD_ID register programmed with the destination thread if the pairing is successful.
dst_thread | PSI-L destination thread ID within the PSI-L System thread map. PSI-L destination threads start at index 0x8000. The request is NACK'd if the destination thread is not greater than or equal to 0x8000. |
UDMAP receive channels mapped to destination threads will have their RCHAN_THRD_ID register programmed with the source thread if the pairing is successful.
Data Fields | |
struct tisci_header | hdr |
uint32_t | nav_id |
uint32_t | src_thread |
uint32_t | dst_thread |
struct tisci_header tisci_msg_rm_psil_pair_req::hdr |
uint32_t tisci_msg_rm_psil_pair_req::nav_id |
uint32_t tisci_msg_rm_psil_pair_req::src_thread |
uint32_t tisci_msg_rm_psil_pair_req::dst_thread |