Embedded IDE Link™ MU

ghsmulti - Object to communicate with Green Hills MULTI^® IDE

Syntax

id = ghsmulti
id = ghsmulti('propertyname1',propertyvalue1,'propertyname2',propertyvalue2,…,'timeout',value)

Description

id = ghsmulti returns object id that communicates with a target processor. Before you use this command for the first time, use ghsmulticonfig to configure your MULTI software installation to identify the location of your MULTI software, your processor configuration, your debug server and the host name and port number of the Embedded IDE Link MU service.

ghsmulti creates an interface between MATLAB^® and Green Hills MULTI. If this is the first time you have used ghsmulti, you must supply the properties and property values shown in following table as input arguments:

When you invoke ghsmulti, it starts the Embedded IDE Link MU service. If you selected the Show server status window option on the Embedded IDE Link MU Configuration dialog box (refer to ghsmulticonfig) when you configured your MULTI installation, the service appears in your Microsoft Windows task bar. If you clear Show server status window, the service does not appear.

Parameters that you pass as input arguments to ghsmulti are interpreted as object property definitions. Each property definition consists of a property name followed by the desired property value (often called a PV, or property name/property value, pair).

Note   The output (left-hand argument) object name you provide for ghsmulti cannot begin the an underscore, such as _id.

id = ghsmulti('hostname','name','portnum','number',...) returns a ghsmulti object id that you use to interact with a processor in the IDE from the MATLAB command prompt. If you enter a hostname or portnum that are not the same as the ones you provided when you configured your MULTI installation, Embedded IDE Link™ MU software returns an error that it could not connect to the specified host and port and does not create the object.

You use the debugging methods (refer to Debug Operations for the methods available) with this object to access memory and control the execution of the processor. ghsmulti also enables you to create an array of objects for a multiprocessor board, where each object refers to one processor on the board. When id is an array of objects, any method called with id as an input argument is sent sequentially to all processors connected to the ghsmulti object. Green Hills MULTI provides the communication between the IDE and the processor.

After you build the ghsmulti object id, you can review the object property values with get, but you cannot modify the hostname and portnum property values. You can use set to change the value of other properties.

id = ghsmulti('propertyname1',propertyvalue1,'propertyname2',propertyvalue2,…,'timeout',value) sets the global time-out value in seconds to value in id. MATLAB waits for the specified time-out period to get a response from the IDE application. If the IDE does not respond within the allotted time-out period, MATLAB exits from the evaluation of this function.

Examples

This example demonstrates ghsmulti using default values.

id = ghsmulti('hostname','localhost','portnum',4444);

returns a handle to the default host and port number—localhost and 4444.

id=ghsmulti('hostname','localhost','portnum',4444)

MULTI Object:
  Host Name        : localhost
  Port Num         : 4444
  Default timeout  : 10.00 secs
  MULTI Dir        : C:\ghs\multi500\ppc\

See Also

ghsmulticonfig

getbuildopt

ghsmulticonfig