qc_get_loaded_models :: QUARC MATLAB Functions

navigation bar

qc_get_loaded_models

Retrieves a list of the models that are loaded on a QUARC target.

Syntax

[models, err] = qc_get_loaded_models(model, options)      % Models loaded on the target associated with the model
[models, err] = qc_get_loaded_models(config_set, options) % Models loaded on the target associated with the configuration set
[models, err] = qc_get_loaded_models(target_uri, options) % Models loaded on target specified by the target URI
[models, err] = qc_get_loaded_models(options)             % Models loaded on target associated with the current model
[models, err] = qc_get_loaded_models(model)               % Models loaded on the target associated with the model
[models, err] = qc_get_loaded_models(config_set)          % Models loaded on the target associated with the configuration set
[models, err] = qc_get_loaded_models(target_uri)          % Models loaded on target specified by the target URI
[models, err] = qc_get_loaded_models                      % Models loaded on target associated with the current model

Description

Retrieves a list of the models that are loaded on a QUARC target. If a model is specified, then the target URI associated with the active configuration set of the model is used. If a configuration set is specified then its associated target URI is used. If a target URI is specified then it is used directly to access the target. If no target URI is specified then the target is identified by the settings for the active configuration of the currently selected model.

To get the arguments passed to the model as well, pass the string 'command' as an additional argument, so that the command line for each model is returned instead of the model names only.

Parameters

model

A string indicating the name of the model from which to identify the target eg. 'q_a_lpbk'.

config_set

A Simulink.ConfigSet configuration set from which to identify the target (see getConfigSet).

target_uri

A string containing the URI used for communicating with the QUARC Target Manager on the target.

options

A string indicating options. The only options currently supported are:

'command'

return the model name and arguments rather than just the model name

Outputs

models

A cell array of strings containing the names of the models that have been loaded on the target.

err

Returns 0 on success and a negative error code on failure. See qc_error and qc_get_error_message for handling error codes. If no err output is assigned it issues an error on failure.

Examples

models = qc_get_loaded_models; % Returns the models loaded to the current model's target