Fast Models Reference Manual - ARM Information Center

Peripheral and Interface Components
5.9.2 Responsibilities of the SCADI caller
Synchronous interface means that the caller of SCADI functions is always responsible for
ensuring that the simulation is in a stable state. Being in a stable state means that the simulation
does not advance while the call is being made. The caller is also responsible for meeting all host
thread and synchronization requirements of any external bus slaves that are directly or indirectly
connected to the memory bus.
5.9.3 Obtaining the SCADI interface
You can obtain the SCADI interface from the same CAInterface pointers that are used to obtain
the CADI and the MTI interfaces. This is done using the CAInterface::ObtainInterface()
method. The interface names for the normal CADI and MTI interfaces are CADI::IFNAME() and
ComponentTraceInterface::IFNAME() respectively.
The interface name for the SCADI interface to be passed into ObtainInterface() is
“eslapi.SCADI2”, the interface revision is 0. There are no IFNAME() and IFREVISION() static
functions defined for SCADI, and a plain string constant and integer constant (0) has to be used
instead.
The pointer returned by CAInterface::ObtainInterface("eslapi.SCADI2") must be cast into an
eslapi::CADI class pointer, that is, the same class as for eslapi.CADI2, the normal CADI interface
class.
Access to SCADI from within LISA components
To get access to the SCADI interface of the LISA component itself you can use the getSCADI()
function. This returns the SCADI interface of the LISA component itself. To get access to the
SCADI interfaces of other components in the system, you can use the getGlobalInterface()
function. This returns a CAInteraface pointer. You then have to use the ObtainInterface()
function on that pointer to obtain the SystemTraceInterface. This interface provides a list of all
components in the system which provide trace data. This list can also be used to gain access to
the SCADI interfaces of all these components. See Example code.
Access to SCADI from within System C
Access to the SCADI interfaces from within a System C system work similar to the LISA
components: The generated System C platform (the generated System C wrapper around the
Fast Model subsystem) provides a getGlobalInterface() function which returns a CAInterface
pointer. This can be used to retrieve the SCADI interfaces in the same way as in the LISA case.
See Example code.
Access to SCADI from MTI plugins
MTI plugins can gain access to SCADI interfaces by using the CAInterface pointer, which is
passed as a parameter to the RegisterSimulation() function. This pointer has the same semantics
as the CAInterface pointer returned by the getGlobalInterface() functions in the System C or
LISA use cases.
Example code
This example code demonstrates how to use getGlobalInterface() to retrieve a SCADI interface
pointer of a specific component. From LISA it is getGlobalInterface(), from within System C
it is assumed that you have a pointer to the Fast Models platform called platform. From within
a MTI plug-in you do not have to call getGlobalInterface(), and you can use the CAInterface
pointer passed to RegisterSimulation().
ARM DUI 0423J Copyright © 2008-2011 ARM. All rights reserved. 5-168
ID051811
Non-Confidential