Compute Cluster Register Configuration TISCI Description

Note

This document is only applicable to J721S2 and J784S4 SoC.

This chapter provides information on available TISCI messages for configuring compute cluster registers on K3 devices, including MSMC (Multicore Shared Memory Controller) timeout gasket registers and other compute cluster functionality.

For all supported platforms:

TISCI Message ID Message Name Available in GP Available in HS-FS
0xC125 TISCI_MSG_CONFIGURE_CC_REGISTER Yes Yes

API Description

TISCI_MSG_CONFIGURE_CC_REGISTER - Configure Compute Cluster Register

Usage

Message Type Secure
Secure Queue Only? Yes

Description

This message allows for reading from or writing to compute cluster registers that control various functionality, including MSMC timeout gasket behavior which can help detect a CPU crash in ASIL-B domain.

The following functions can be achieved with this message:
  • Setting/getting the MSMC gasket timeout value
  • Enabling the MSMC snoop timeout detection counter
  • Forcing the MSMC gasket timeout interrupt generation
  • Configuring other compute cluster registers

TISCI Message ID

TISCI_MSG_CONFIGURE_CC_REGISTER          (0xC125U)

Message to R/W to compute cluster configuration registers

Request

struct tisci_msg_cc_configuration_req

Request for TISCI_MSG_CONFIGURE_CC_REGISTER.

Parameter Type Description
hdr struct tisci_header TISCI header containing message information.
reg_addr u32 Physical address of the compute cluster register to configure.
reg_val u32 Value to write to the specified register.
req_type u8 Type of configuration request: 0xAA - Read register operation 0xBB - Write register operation

This message allows configuration of compute cluster registers

The request type parameter (req_type) must be one of the following values:

  • 0xAA : Read operation
  • 0xBB : Write operation

Response

struct tisci_msg_cc_configuration_resp

Response for TISCI_MSG_CONFIGURE_CC_REGISTER.

Parameter Type Description
hdr struct tisci_header TISCI header with status of the requested operation.
reg_val u32 Value read from register.

Contains the result of the compute cluster register configuration operation.

For both operations, the response will contain the current value of the requested register in the reg_val field. For write operations, the response indicates whether the write was successful.

Note

  1. Access to compute cluster registers is limited to a predefined set of registers for security reasons.
  2. Write operations are verified to ensure the value was correctly written to the register.