MATLAB: What is the correct way to add to the include path in the S-Function Builder block in Simulink 6.1 (R14SP1)

automatic;builderdocinc_paths-functionsfunctionbuilderincludepathsimulink

In the S-Function Builder Dialog Box documentation, under the Libraries Pane section:

web([docroot,'/toolbox/simulink/sfg/sfunc_c14.html#107343'])

it says:

 You can also use this field to specify search paths for libraries,
 object files, header files and source files. To do this, 
 enter the tag LIB_PATH, INC_PATH, or SRC_PATH, respectively,
 followed by a comma- or semicolon-separated list of paths.

Also, in the Setting the Include Path documentation:

web([docroot,'/toolbox/simulink/sfg/sfunc_c4.html#108671'])

it says to set the 'SfunctionBuilderIncludePath' property to add include files. Which of these is the correct way to specify paths to header files to be included in the S-function?

Best Answer

This bug has been fixed in Release 14 Service Pack 3 (R14SP3). As of R14SP3, It is recommened to specify search paths for libraries, object files, header files and source files by entering the tag LIB_PATH, INC_PATH, or SRC_PATH, respectively.

For previous product releases, read below for any possible workarounds:

This has been verified as an error within the documentation for Simulink in the Building S-Functions Automatically section. The proper way to set the include path for header files is to set the 'SfunctionBuilderIncludePath' property as described in the following documentation page. Type the following in the MATLAB command window to access the page:

web([docroot,'/toolbox/simulink/sfg/sfunc_c4.html#108671'])

Related Solutions

MATLAB: Am I unable to simulate the model in accelerator mode when I have custom C-files specified in the S-Function Builder block in Simulink

This bug has been fixed in Release 14 Service Pack 3 (R14SP3). For previous product releases, read below for any possible workarounds:

This is a bug in Simulink Performance Tool in the way that the Simulink Accelerator handles file names from the S-Function Builder block.

To work around this issue, try to specify all the S-Function modules prior to simulation.

Enter the following at the MATLAB command prompt:

set_param('$MODELNAME/S-Function Builder','SFunctionModules','<$SFUN_NAME>_wrapper $EXTERN_CODE')

where $MODELNAME is the model name.

where $SFUN_NAME is the S-function name

where $EXTERN_CODE is the library C-files, without the .c extension.

For example, I have a model named "test3", an S-function named "mysfun" and a library C-file named "afun", I would enter the following at the MATLAB command prompt:

set_param('test3/S-Function Builder','SFunctionModules','mysfun_wrapper afun')

Note that the S-Function Builder block always creates an S-function wrapper so we must specify both the wrapper and external C-files.

For more information about this, refer to the MATLAB documentation "Writing S-Functions for Real Time Workshop" by executing the following command at the MATLAB prompt:

web([docroot '/toolbox/rtw/rtw_ug/sfcn_rtw.html#67544'])

MATLAB: Does Accelerator Mode not include file(s) provided in the custom code configurations

We have identified two ways of having your required files linked while running in accelerator mode. I have listed these below:

1. Manually edit the makeInfo.includePath and makeInfo.sources section of the file "libs\timesn\rtwmakecfg.m" to reflect the following:

makeInfo.includePath = {pwd};
makeInfo.sources = {'filename1', 'filename2'};

Note: if you have a custom S-function created without the S-function builder, you may need to create the rtwmakecfg.m manually and put it in the same directory as the S-function itself. To have an additional include directory, the function would look like:

function makeInfo = rtwmakecfg()
makeInfo.Name        = 'MyCustomConfig';
makeInfo.includePath = {'YOUR_PATH_NAME'};
end

2. Build the S-Function using S-Function builder block and under the libraries pane, include the following:

...\filename1
...\filename2

Note: include the full path to the source files

Note: define the input and output data types under the data properties pane

Best Answer

Related Solutions

MATLAB: Am I unable to simulate the model in accelerator mode when I have custom C-files specified in the S-Function Builder block in Simulink

MATLAB: Does Accelerator Mode not include file(s) provided in the custom code configurations

Related Question