Coverage for S-Functions
This example shows how to configure an S-Function generated with the Legacy Code Tool to be compatible with coverage. The model coverage tool supports S-Functions that are:
Generated with the Legacy Code Tool, with
def.Options.supportCoverage
set totrue
,Generated with the SFunctionBuilder, with Enable support for coverage selected on the Build Info tab of the SFunctionBuilder dialog box, or
Compiled with the
slcovmex
function.
Open Example Model
The example model slcoverage_lct_bus contains an S-Function generated with the Legacy Code Tool. The S-Function has constructs that receive decision, condition, and MCDC coverage.
Configure S-Function to Be Compatible with Model Coverage
The legacy source code in the files counterbus.h, and counterbus.c implements the same algorithm as in slcoverage_lct_bus/slCounter. The Legacy Code Tool data structure is defined as follows:
load_system('slcoverage_lct_bus'); open_system('slcoverage_lct_bus/TestCounter'); load slcoverage_lct_data.mat def = legacy_code('initialize'); def.SFunctionName = 'slcoverage_sfun_counterbus'; def.OutputFcnSpec = ... ['void counterbusFcn(COUNTERBUS u1[1], ' ... 'int32 u2, COUNTERBUS y1[1], int32 y2[1])']; def.HeaderFiles = {'counterbus.h'}; def.SourceFiles = {'counterbus.c'};
To make this S-Function compatible with model coverage, enable the following option:
def.Options.supportCoverage = true;
Generate and compile the S-Function using the legacy_code
function:
legacy_code('generate_for_sim', def);
### Start Compiling slcoverage_sfun_counterbus mex -I/tmp/Bdoc24b_2679053_1170566/tp466e0ee9/slcoverage-ex71096464 -c /tmp/Bdoc24b_2679053_1170566/tp104664fd_6145_445b_be8c_95a89b6435d5/counterbus.c -outdir /tmp/Bdoc24b_2679053_1170566/tp6b0beff2_a087_497e_a94a_428f2bf2d431 Building with 'gcc'. MEX completed successfully. mex -I/tmp/Bdoc24b_2679053_1170566/tp466e0ee9/slcoverage-ex71096464 /tmp/Bdoc24b_2679053_1170566/tp104664fd_6145_445b_be8c_95a89b6435d5/tp89109906_9354_429b_86d9_0b11a8c4f128.c /tmp/Bdoc24b_2679053_1170566/tp6b0beff2_a087_497e_a94a_428f2bf2d431/counterbus.o -L/mathworks/devel/bat/filer/batfs2561-0/Bdoc24b.2679053/build/runnable/matlab/bin/glnxa64 -lmwsl_sfcn_cov_bridge -output slcoverage_sfun_counterbus Building with 'gcc'. MEX completed successfully. mex -I/tmp/Bdoc24b_2679053_1170566/tp466e0ee9/slcoverage-ex71096464 -c /tmp/Bdoc24b_2679053_1170566/tp466e0ee9/slcoverage-ex71096464/counterbus.c -outdir /tmp/Bdoc24b_2679053_1170566/tp6b0beff2_a087_497e_a94a_428f2bf2d431 Building with 'gcc'. MEX completed successfully. mex -I/tmp/Bdoc24b_2679053_1170566/tp466e0ee9/slcoverage-ex71096464 /tmp/Bdoc24b_2679053_1170566/tp104664fd_6145_445b_be8c_95a89b6435d5/slcoverage_sfun_counterbus.c /tmp/Bdoc24b_2679053_1170566/tp104664fd_6145_445b_be8c_95a89b6435d5/tp4211a033_fe27_461b_9f33_7173e4dd210c.c /tmp/Bdoc24b_2679053_1170566/tp104664fd_6145_445b_be8c_95a89b6435d5/tp1252d878_f67b_4736_962f_39b3f76ea1b8.c /tmp/Bdoc24b_2679053_1170566/tp6b0beff2_a087_497e_a94a_428f2bf2d431/counterbus.o -L/mathworks/devel/bat/filer/batfs2561-0/Bdoc24b.2679053/build/runnable/matlab/bin/glnxa64 -lmwsl_sfcn_cov_bridge -output slcoverage_sfun_counterbus Building with 'gcc'. MEX completed successfully. ### Finish Compiling slcoverage_sfun_counterbus ### Exit
Enable S-Function Coverage
To enable coverage collection for S-Functions, select C/C++ S-Functions in the Coverage pane of the Configurations Parameters dialog box. Alternatively, set the option through the command line:
set_param('slcoverage_lct_bus',... 'CovMetricStructuralLevel', 'MCDC',... 'RecordCoverage', 'on',... 'CovSFcnEnable', 'on',... 'CovSaveSingleToWorkspaceVar','on'... );
Run Simulation and Produce Coverage Report
Once you enable coverage data collection, coverage information is automatically recorded when you simulate the model. At the end of the simulation, you can generate an HTML report of coverage information, which is displayed in the built-in MATLAB® web browser.
sim('slcoverage_lct_bus', 'StopTime', '20'); cvhtml('coverageResults', covdata);
Extract Information from Coverage Data Objects
The cvdata
object can be used to extract coverage information for S-Functions, just like any other supported model element. For instance, the decisioninfo
command extracts coverage information from a block path or a block handle. The output is a vector containing the satisfied and total outcomes for a single model object.
cov = decisioninfo(covdata, ... 'slcoverage_lct_bus/TestCounter/slcoverage_sfun_counterbus')
cov = 3 4
You then use this coverage information to calculate the percentage of covered model objects:
percentCov = 100 * (cov(1)/cov(2))
percentCov = 75
S-Function coverage is fully compatible with the model coverage commands, such as decisioninfo
, conditioninfo
, and mcdcinfo
.