2.2 Model connection and configuration

MxScript has the concept of the current model, and the current target in that model. All functions operate on the current model or target, and the selectTarget() function switches between multiple targets.

In contrast, iris.debug uses an object-oriented design, in which objects represent models and targets. These objects provide methods to interact with them. This design makes it much more practical to work with multiple targets or models. An example of where this design is useful is debugging a multi-processor system, where it is necessary to interact with multiple CPU targets.

The following table shows the MxScript functions that connect to and configure models, and their iris.debug equivalent:

Table 2-1 Model connection and configuration functions

MxScript function iris.debug equivalent
connectToModel(port) model = NetworkModel(host, port)


This function does not select the target.
closeModel() model.release()
debugIsim(isim) Not implemented
debugSystemC(simulation) Not implemented
getParameter(name) target.parameters["name"]
setParameter(name, value) target.parameters["name"] = value
getTargetList(filename) model.get_target_info()
getTargetName() target.instance_name

Either of the following:

  • target = model.get_target(name)
  • cpus = model.get_cpus()
loadApp(filename) target.load_application(filename)
saveState(filename) Not implemented
restoreState(filename) Not implemented
saveSession(filename) Not implemented
openSession(filename) Not implemented
setStateFile(filename) Not implemented
Non-ConfidentialPDF file icon PDF version101421_0100_01_en
Copyright © 2018, 2019 Arm Limited or its affiliates. All rights reserved.