MTB CAT1 Peripheral driver library
MS CTL (Master Security Controller)

General Description

MS CTL is the Master Security Controller which helps to protect the transactions initiated on the bus.

MSC is instantiated on non-CPU paths to provide security extension attributes and to add TrustZone-M capability. MSC Driver provides APIs to configure access rights to the given master for each Protection Context. Maximum of 32 masters are supported. It also provides API to set the active PC.

The functions and other declarations used in this driver are in cy_ms_ctl.h. You can include cy_pdl.h (ModusToolbox only) to get access to all functions and declarations in the PDL.

You can use this driver to protect the transactions initiated on the bus.

CAT1D devices support multiple CPU subsystems, viz. SYSCPUSS and APPCPUSS. Each subsystem has its own version of MS_CTL IP within it. In order to support MS_CTL IP in the APPCPUSS, new set of APIs with suffix V1 are added.

Following APIs are used for MS_CTL IP in CAT1D device SYSCPUSS
Cy_Ms_Ctl_ConfigBusMaster
Cy_Ms_Ctl_ConfigMscAcgResp
Cy_Ms_Ctl_SetActivePC
Cy_Ms_Ctl_GetActivePC
Cy_Ms_Ctl_SetPcHandler
Cy_Ms_Ctl_GetPcHandler

Following APIs are used for MS_CTL IP in CATD device APPCPUSS
Cy_Ms_Ctl_ConfigBusMasterV1
Cy_Ms_Ctl_ConfigMscAcgRespV1
Cy_Ms_Ctl_SetActivePCV1
Cy_Ms_Ctl_GetActivePCV1

More Information

For more information on the MSC , refer to the technical reference manual (TRM).

MISRA-C Compliance

The mSc driver does not have any specific deviations.

Changelog

VersionChangesReason for Change
1.1 Added support for CAT1D devices, Corrected typo in API Support for CAT1D devices
1.0 Initial version

API Reference

 Macros
 
 Functions
 
 Enumerated Types