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 TISCI_MSG_RM_PSIL_PAIR
0x1281 TISCI_MSG_RM_PSIL_UNPAIR
0x1282 TISCI_MSG_RM_PSIL_READ
0x1283 TISCI_MSG_RM_PSIL_WRITE

TISCI_MSG_RM_PSIL_PAIR - 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

TISCI Message ID

TISCI_MSG_RM_PSIL_PAIR          (0x1280U)

RM TISCI message to pair PSI-L source and destination threads

PSI-L Pair Message Parameters

struct tisci_msg_rm_psil_pair_req

Pairs a PSI-L source thread to a destination thread

Parameter Type Description
hdr struct tisci_header Standard TISCI header
nav_id u32 SoC device ID of Navigator Subsystem whose PSI-L config proxy is used to pair the source and destination threads.
src_thread u32 PSI-L source thread ID within the PSI-L System thread map.
dst_thread u32 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.

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 @ref nav_id. UDMAP transmit channels mapped to source threads will have their TCHAN_THRD_ID register programmed with the destination thread if the pairing is successful. UDMAP receive channels mapped to destination threads will have their RCHAN_THRD_ID register programmed with the source thread if the pairing is successful.

struct tisci_msg_rm_psil_pair_resp

Response to pairing a PSI-L source thread to a destination thread

Parameter Type Description
hdr struct tisci_header Standard TISCI header

TISCI_MSG_RM_PSIL_UNPAIR - 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

TISCI Message ID

TISCI_MSG_RM_PSIL_UNPAIR          (0x1281U)

RM TISCI message to unpair PSI-L source and destination threads

PSI-L Unpair Message Parameters

struct tisci_msg_rm_psil_unpair_req

Unpairs a PSI-L source thread from a destination thread

Parameter Type Description
hdr struct tisci_header Standard TISCI header
nav_id u32 SoC device ID of Navigator Subsystem whose PSI-L config proxy is used to unpair the source and destination threads.
src_thread u32 PSI-L source thread ID within the PSI-L System thread map.
dst_thread u32 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.

Unpairs the specified PSI-L source thread from the specified destination the thread. The source thread’s width and credit count parameters are cleared. Both the source and destination threads are non-real-time disabled on successful unpairing. The host requesting the unpair operation for threads mapped to UDMAP channels must be the owner, or the supervisor of the host owning, the UDMAP channels. Therefore, 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 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 unpair the source and destination threads is based on the Navigator Subsystem specified by @ref nav_id. UDMAP transmit channels mapped to source threads will have their TCHAN_THRD_ID register cleared if the unpairing is successful. UDMAP receive channels mapped to destination threads will have their RCHAN_THRD_ID register cleared if the unpairing is successful.

struct tisci_msg_rm_psil_unpair_resp

Response to unpairing a PSI-L source thread from a destination thread

Parameter Type Description
hdr struct tisci_header Standard TISCI header

TISCI_MSG_RM_PSIL_READ - PSI-L Thread Configuration Register Read

The psil read TISCI message API is used to read a PSI-L thread’s configuration registers via a PSI-L configuration proxy.

Usage

Message Type Normal
Secure Queue Only? No

TISCI Message ID

TISCI_MSG_RM_PSIL_READ          (0x1282U)

RM TISCI message to read PSI-L thread RT registers via the PSI-L proxy

Message Data Structures

struct tisci_msg_rm_psil_read_req

Reads the specified thread real-time configuration register from a specified PSI-L thread using the PSI-L configuration proxy. The host requesting the read operation for threads mapped to UDMAP channels must be the owner, or the supervisor of the host owning, the UDMAP channels. For threads not mapped to UDMAP channels, the host requesting the read operation must have access through the region firewall covering the entity to which the thread is mapped. The PSI-L configuration proxy used to read thread’s configuration registers is based on the Navigator Subsystem specified by @ref nav_id.

Parameter Type Description
hdr struct tisci_header Standard TISCI header
valid_params u32 Bitfield defining validity of PSI-L read parameters. This field is unused at the moment but exists if expansion of the API is needed in the future.
nav_id u16 SoC device ID of Navigator Subsystem whose PSI-L config proxy is used to read from the thread.
thread u16 PSI-L thread ID within the PSI-L System thread map.
taddr u16 Thread’s configuration register address to read.

struct tisci_msg_rm_psil_read_resp

Response to reading a PSI-L thread real-time register

Parameter Type Description
hdr struct tisci_header Standard TISCI header
data u32 Register value returned by read operation

TISCI_MSG_RM_PSIL_WRITE - PSI-L Thread Configuration Register Write

The psil write TISCI message API is used to write a PSI-L thread’s configuration registers via a PSI-L configuration proxy.

Usage

Message Type Normal
Secure Queue Only? No

TISCI Message ID

TISCI_MSG_RM_PSIL_WRITE          (0x1283U)

RM TISCI message to write PSI-L thread RT registers via the PSI-L proxy

Message Data Structures

struct tisci_msg_rm_psil_write_req

Write to the specified thread real-time configuration register in a specified PSI-L thread using the PSI-L configuration proxy. The host requesting the read operation for threads mapped to UDMAP channels must be the owner, or the supervisor of the host owning, the UDMAP channels. For threads not mapped to UDMAP channels, the host requesting the write operation must have access through the region firewall covering the entity to which the thread is mapped. The PSI-L configuration proxy used to write thread’s configuration registers is based on the Navigator Subsystem specified by @ref nav_id. A read back verify is not performed for thread registers written via the PSI-L configuration proxy. The configuration register field formats are not fully known by the PSI-L driver. Therefore, it is up to the application to utilize @ref tisci_msg_rm_psil_read_req to read back and verify what was written.

Parameter Type Description
hdr struct tisci_header Standard TISCI header
valid_params u32 Bitfield defining validity of PSI-L write parameters. This field is unused at the moment but exists if expansion of the API is needed in the future.
nav_id u16 SoC device ID of Navigator Subsystem whose PSI-L config proxy is used to write to the thread.
thread u16 PSI-L thread ID within the PSI-L System thread map.
taddr u16 Thread’s configuration register address to write.
data u32 32-bit word to write to the thread configuration register.

struct tisci_msg_rm_psil_write_resp

Response to writing a PSI-L thread real-time register

Parameter Type Description
hdr struct tisci_header Standard TISCI header