MATLAB: Where can I find more information on writing a TLC file for a function-call subsystem

simulink coder

I would like to write a block TLC file for my S-Function that has a function call output. However, I am confused about which of the following TLC functions I should use in the block TLC file to execute the function call subsystem:

LibCallFCSS
LibExecuteFcnCall

Also I would like to know what the purpose of the following functions is:

ssSetEnableFcnIsTrivial(S,1);
ssSetDisableFcnIsTrivial(S,1);

Best Answer

Information on these functions is missing from the documentation for Real-Time Workshop 7.1 (R2008a). Here is additional information on these functions:

1. What is the difference between the LibCallFCSS and LibExecuteFcnCall TLC Library functions?

LibCallFCSS can be only be invoked from within a block scope as opposed to LibExecuteFcnCall. Also, LibExecuteFcnCall is more robust and has a simpler interface. Therefore, it is recommended to use LibExecuteFcnCall while writing your own TLCs.

2. What is the purpose of the ssSetEnableFcnIsTrivial and ssSetDisableFcnIsTrivial functions?

The purpose of these functions is to indicate whether the S-Function is trivial, or in other words, does nothing more than to enable or disable its attached function-call subsystem (using ssEnableSystemWithTid and ssDisableSystemWithTid within mdlEnable and mdlDisable respectively) and thus can lead to the generation of more efficient code.

Related Solutions

MATLAB: Do I get an “Attempt to call a non-function value” error when implementing the example TLC script in the Real-Time Workshop 6.5 (R2006b) documentation

This bug has been fixed in Release 2007a (R2007a). For previous product releases, read below for any possible workarounds:

This is a bug in the Real-Time Workshop 6.5 (R2006b) documentation. The script that outputs the name of each block in a model should actually be as follows:

%addincludepath "matlabroot/rtw/c/tlc/lib"
%addincludepath "matlabroot/rtw/c/tlc/mw"
%addincludepath "matlabroot/rtw/c/tlc/blocks"
%assign Accelerator = 0     %%Needed to avoid error in utillib 
%include "utillib.tlc"
%include "modelrefutil.tlc"    %%Needed to avoid error in utillib 
%selectfile STDOUT 
%with CompiledModel     
      %foreach sysIdx = NumSystems
          %assign ss = System[sysIdx]
          %with ss 
              %foreach blkIdx = NumBlocks
                  %assign block = Block[blkIdx]
                  %<LibGetFormattedBlockPath(block)>
              %endforeach

          %endwith

      %endforeach
   %endwith

MATLAB: Is there a TLC function “LibBlockIWorkAddr” or “LibBlockRWorkAddr” in the Real-Time Workshop

There is no specific function for this purpose; however you can prepend an ampersand (&) in front of "LibBlockIWork" to achieve the same effect.

For example, this is done in the random number block in $MATLABROOT/rtw/c/tlc/blocks/randnum.tlc in this fashion:

 uint32_T *RandSeed = (uint32_T *) &%<LibBlockIWork(RandSeed, "", "", 0)>;

Best Answer

Related Solutions

MATLAB: Do I get an “Attempt to call a non-function value” error when implementing the example TLC script in the Real-Time Workshop 6.5 (R2006b) documentation

MATLAB: Is there a TLC function “LibBlockIWorkAddr” or “LibBlockRWorkAddr” in the Real-Time Workshop

Related Question