S-Function 的覆盖率

此示例显示如何配置使用 Legacy Code Tool 生成的 S-Function 以与覆盖率兼容。模型覆盖率工具支持以下 S-Function：

使用 Legacy Code Tool 生成，将 def.Options.supportCoverage 设置为 true，
使用 SFunctionBuilder 生成，并在 SFunctionBuilder 对话框的编译信息选项卡上选择启用对覆盖率的支持，或者
使用slcovmex函数进行编译。

打开示例模型

示例模型 slcoverage_lct_bus 包含使用 Legacy Code Tool 生成的 S-Function。S-Function 具有接收决策、条件和 MCDC 覆盖率的构造。

配置 S-Function 以与模型覆盖率兼容

文件 counterbus.h 和 counterbus.c 中的旧源代码实现了与 slcoverage_lct_bus/slCounter 中相同的算法。Legacy Code Tool 数据结构体定义如下：

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'};

为了使此 S-Function 与模型覆盖率兼容，请启用以下选项：

def.Options.supportCoverage = true;

使用 legacy_code 函数生成并编译 S-Function：

legacy_code('generate_for_sim', def);

### Start Compiling slcoverage_sfun_counterbus
mex -I/tmp/Bdoc25a_2874102_1427903/tpc3a144bd/slcoverage-ex71096464 -c /tmp/Bdoc25a_2874102_1427903/tpaa576e36_dbcb_492a_b7e0_23cca4abfb00/counterbus.c -outdir /tmp/Bdoc25a_2874102_1427903/tp31066f36_f8e7_4b17_95aa_d47b2ced2ac1
Building with 'gcc'.
MEX completed successfully.
mex -I/tmp/Bdoc25a_2874102_1427903/tpc3a144bd/slcoverage-ex71096464 /tmp/Bdoc25a_2874102_1427903/tpaa576e36_dbcb_492a_b7e0_23cca4abfb00/tp6e3bf6eb_7942_48d7_8a9d_74da6efefdc4.c /tmp/Bdoc25a_2874102_1427903/tp31066f36_f8e7_4b17_95aa_d47b2ced2ac1/counterbus.o -L/mathworks/devel/bat/filer/batfs2566-0/Bdoc25a.2874102.Bdoc25a.2873005.pass/build/runnable/matlab/bin/glnxa64 -lmwsl_sfcn_cov_bridge -output slcoverage_sfun_counterbus
Building with 'gcc'.
MEX completed successfully.
mex -I/tmp/Bdoc25a_2874102_1427903/tpc3a144bd/slcoverage-ex71096464 -c /tmp/Bdoc25a_2874102_1427903/tpc3a144bd/slcoverage-ex71096464/counterbus.c -outdir /tmp/Bdoc25a_2874102_1427903/tp31066f36_f8e7_4b17_95aa_d47b2ced2ac1
Building with 'gcc'.
MEX completed successfully.
mex -I/tmp/Bdoc25a_2874102_1427903/tpc3a144bd/slcoverage-ex71096464 /tmp/Bdoc25a_2874102_1427903/tpaa576e36_dbcb_492a_b7e0_23cca4abfb00/slcoverage_sfun_counterbus.c /tmp/Bdoc25a_2874102_1427903/tpaa576e36_dbcb_492a_b7e0_23cca4abfb00/tpe74aa56c_6dad_4346_849a_ab65dea5925f.c /tmp/Bdoc25a_2874102_1427903/tpaa576e36_dbcb_492a_b7e0_23cca4abfb00/tp2fd01e89_b3c0_468c_9799_3ec1a57bf73a.c /tmp/Bdoc25a_2874102_1427903/tp31066f36_f8e7_4b17_95aa_d47b2ced2ac1/counterbus.o -L/mathworks/devel/bat/filer/batfs2566-0/Bdoc25a.2874102.Bdoc25a.2873005.pass/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

启用 S-Function 覆盖率

要启用 S-Function 的覆盖率收集，请在配置参数对话框的覆盖率窗格中选择 C/C++ S-Function。或者，通过命令行设置选项：

set_param('slcoverage_lct_bus',...
          'CovMetricStructuralLevel', 'MCDC',...
          'RecordCoverage', 'on',...
          'CovSFcnEnable', 'on',...
          'CovSaveSingleToWorkspaceVar','on'...
          );

运行仿真并生成覆盖率报告

仿真模型以记录覆盖数据。仿真结束后，使用 cvhtml 生成覆盖结果的 HTML 报告，并在 HTML 查看器中打开该报告。

sim('slcoverage_lct_bus', 'StopTime', '20');
cvhtml('coverageResults', covdata);

从覆盖率数据对象中提取信息

cvdata 对象可用于提取 S-Function 的覆盖率信息，就像任何其他受支持的模型元素一样。例如，decisioninfo 命令从模块路径或模块句柄中提取覆盖率信息。输出是一个向量，包含单个模型对象的满意结果和总体结果。

cov = decisioninfo(covdata, ...
    'slcoverage_lct_bus/TestCounter/slcoverage_sfun_counterbus')

cov =

     3     4

然后，您可以使用此覆盖率信息来计算覆盖率模型对象的百分比：

percentCov = 100 * (cov(1)/cov(2))

percentCov =

    75

S-Function 覆盖率与模型覆盖率命令完全兼容，例如 decisioninfo、conditioninfo 和 mcdcinfo。