Resource Management Proxy TISCI Message Description

Introduction

This chapter provides information on usage of the RM Proxy management TISCI message API parameters.

TISCI Message ID Message Name
0x1300 TISCI_MSG_RM_PROXY_CFG
N/A TISCI_MSG_RM_PROXY_CFG Response

Proxy Valid Parameters Field Usage

Some proxy TISCI message APIs make use of a valid_params bit field. Bits within the valid_params field define whether or not individual TISCI message parameters are valid. When a bit corresponding to a parameter is set (to 1) the parameter is considered valid and will be programmed into its corresponding register field, assuming validation of the parameter passes. When a valid_params bit is not set, i.e. a value of 0, the corresponding register field is read and used within the validation process of the request. The register field for a parameter is not programmed if the corresponding valid_params bit is not set.

TISCI_MSG_RM_PROXY_CFG - Proxy Configuration

Proxy Configuration Request

The proxy_cfg TISCI message API is used to configure the channelized firewalls of a Navigator Subsystem proxy. The proxy index must be assigned to the host defined in the TISCI header via the RM board configuration resource assignment range list. The channelized firewalls covering the proxy error events are configured to only give DMSC write access. The proxy target data control region channelized firewalls are configured to give the assigned host read and write access.

Usage

Message Type Normal
Secure Queue Only? No

TISCI Message ID

TISCI_MSG_RM_PROXY_CFG          (0x1300U)

RM TISCI message to setup a Navigator Subsystem proxy for configuration

Proxy Configuration Message Parameters

struct tisci_msg_rm_proxy_cfg_req

Configures a Navigator Subsystem proxy

Parameter Type Description
hdr struct tisci_header Standard TISCI header
valid_params u32 Bitfield defining validity of proxy configuration 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 where proxy is located
index u16 Proxy index.

Configures the channelized firewalls of a Navigator Subsystem proxy. The firewalls are configured to all the header host access to the backing RAM and target data configuration registers. The proxy index must be assigned to the host defined in the TISCI header via the RM board configuration resource assignment range list.

Proxy Configuration Response

The proxy_cfg_response message returns the result status of the processed proxy_cfg message.

Proxy Configuration Response Message Parameters

struct tisci_msg_rm_proxy_cfg_resp

Response to configuring a proxy.

Parameter Type Description
hdr struct tisci_header Standard TISCI header