Detailed Description

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.

Parameters

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.

Parameters

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

Field Documentation

◆ hdr

struct tisci_header tisci_msg_rm_psil_pair_req::hdr

◆ nav_id

uint32_t tisci_msg_rm_psil_pair_req::nav_id

◆ src_thread

uint32_t tisci_msg_rm_psil_pair_req::src_thread

◆ dst_thread