saveParamSet

Save real-time application parameter values

Since R2021a

Syntax

saveParamSet(target_object,filename,page,options)

Description

saveParamSet(target_object,filename,page,options) saves the parameter values from the given memory page of the loaded real-time application into a parameter set file on the Speedgoat^® target computer.

You also can save a parameter set from a real-time application from the RTOS command line. For more information, see Execute Target Computer RTOS Commands at Target Computer Command Line and Target Computer Command-Line Interface.

Examples

Save Parameters from Application to Parameter Set File

Save parameters from the loaded application slrt_ex_osc_outport to a file named 'myParamSet'.

tg = slrealtime;
mdlSTF = getSTFName(tg);
mdlName = 'slrt_ex_osc_outport';
openExample(mdlName);
set_param(mdlName,"SystemTargetFile",mdlSTF);
slbuild(mdlName);
load(tg,mdlName);
paramSetName = 'myParamSet';
saveParamSet(tg,paramSetName,1);
myParamSet = importParamSet(tg,paramSetName);

Input Arguments

target_object — Object that represents target computer

slrealtime.Target object

Provides access to methods that manipulate the target computer properties.

Example: tg

filename — Name of a parameter set file on the Speedgoat target computer

character vector | string scalar

Enter the name of the parameter set file from the target computer file system.

Example: 'outportTypes'

Data Types: char | string

page — Memory page number

0 (default) | int8

(Optional.) Select memory page of the loaded real-time application for parameters.

Example: 0

options — Overwrite option enable

false (default) | true

(Optional.) If false, the saveParamSet function generates an error when overwriting an existing parameter set. If true, the saveParamSet function overwrites an existing parameter set without issuing an error.

Example: saveParamSet(tg,paramSetName,1,'overwrite',true)

Version History

Introduced in R2021a

R2024b: Add Overwrite Option

Previous to R2024b, the saveParamSet function would overwrite existing an existing parameter set without issuing an error. In R2024b, the default operation of the saveParamSet function is to generate an error when overwriting an existing parameter set. A new option can direct the saveParamSet function to overwrite an existing parameter set without issuing an error.