EDA Simulator Link™ MQ

matlabtbeval - Call specified MATLAB function once and immediately on behalf of instantiated HDL module

Syntax

matlabtbeval <instance> [-socket <tcp_spec>]
[-mfunc <name>]

Arguments

<instance>

Specifies the instance of an HDL module that is associated with a MATLAB function. By default, matlabtbeval associates the HDL module instance with a MATLAB function that has the same name as the HDL module instance. For example, if the HDL module instance is myfirfilter, matlabtbeval associates the HDL module instance with the MATLAB function myfirfilter. Alternatively, you can specify a different MATLAB function with the -mfunc property.

-socket <tcp_spec>

Specifies TCP/IP socket communication for the link between the HDL simulator and MATLAB. For TCP/IP socket communication on a single computer, the <tcp_spec> can consist of just a TCP/IP port number or service name (alias). If you are setting up communication between computers, you must also specify the name or Internet address of the remote host. See Specifying TCP/IP Values for some valid tcp_spec examples.

For more information on choosing TCP/IP socket ports, see Choosing TCP/IP Socket Ports.

If you run the HDL simulator and MATLAB on the same computer, you have the option of using shared memory for communication. Shared memory is the default mode of communication and takes effect if you do not specify -socket <tcp-spec> on the command line.

Note   The communication mode that you specify with the matlabtbeval command must match what you specify for the communication mode when you call the hdldaemon command to start the MATLAB server. For more information on communication modes, see Communicating with MATLAB or Simulink and the HDL Simulator. For more information on establishing the MATLAB end of the communication link, see Starting the MATLAB Server.

-mfunc <name>

The name of the associated MATLAB function. If you omit this argument, matlabtbeval associates the HDL module instance with a MATLAB function that has the same name as the HDL module instance. For example, if the HDL module instance is myfirfilter, matlabtbeval associates the HDL module instance with the MATLAB function myfirfilter . If you omit this argument and matlabtbeval does not find a MATLAB function with the same name, the command displays an error message.

Description

The matlabtbeval command has the following characteristics:

• Starts the HDL simulator client component of the EDA Simulator Link MQ software.

• Associates a specified instance of an HDL design created in the HDL simulator with a MATLAB function.

• Executes the specified MATLAB function once and immediately on behalf of the specified module instance.

Note   The matlabtbeval command executes the MATLAB function immediately, while matlabtb provides several options for scheduling MATLAB function execution.

Note   For the HDL simulator to establish a communication link with MATLAB, the MATLAB hdldaemon must be running with the same communication mode and, if appropriate, the same TCP/IP socket port as you specify with the matlabtbeval command.

Examples

This example starts the HDL simulator client component of the link software, associates an instance of the module myfirfilter with the function myfirfilter.m, and uses a local TCP/IP socket-based communication link to TCP/IP port 4449 to execute the function myfirfilter.m:

 > matlabtbeval myfirfilter -socket 4449:

matlabtb

nomatlabtb