S-Funciton应用实例

1、什么是S-
S-也叫做S函数，是的系统函数。用户可以根据自己的算法开发自己的模块。主要应用场景如下：
■ 用户根据自己的算法，开发并封装成的功能的模块。例如一些特殊的滤波算法、图像处理算法等；
■ 提供外部软件接口，例如【思想】最拿手的与联合仿真接口，去除Mask后本质上也是一个S函数；

文章插图
■ 与RTW文件数据交互，这样就能够在模块中配置并控制Coder生成的C代码。如配置单片机的CAN波特率、配置锁相环、定时器等；

文章插图
STM32的库模块
PS：其实一直很想介绍【代码生成-自定义目标代码的生成】，但是发现S函数是其关键，所以先介绍下背景知识。
S函数语言上支持M、C\C++、，除了快被扫进历史垃圾堆的其余三种语言都挺常用；

文章插图
以下的内容重点介绍属于Level 2的C Mex S函数。通过一个简单的例子，带领大家打造一个属于自己的模块。

文章插图
上图为本期例子，使用C语言封装一个y=(x1+x2)*2+k的s函数。其中x1与x2为外部输入的变量，而k为在模块GUI中设置的参数。
2、【.C】文件的结构

文章插图
以上是C Mex S中C文件的结构，除了文件头宏定义要设置模块的名称外，还有几个函数的内容需要编写。
下面对本例中用的三个函数做详细介绍：

文章插图

文章插图
在函数中我们只需要关心高亮部分代码，这里的API函数含义如下表：

文章插图
本例中虽然只使用了一个输入口，但是输入口的数据宽度设置为动态。使用的mux模块，实现多个变量的输入。当然也能设置多个Port，各Port的数据类型也可以自行定义，这里就希望大家能举一反三。

文章插图
imes函数设置S-模块的采样时间。这里是通用设置，没有特殊需求一般不改动它。

文章插图
本例的算法比较简单，所以直接在函数中实现并输出。如果你有比较复杂的算法，可以自定义一个c语言静态函数，在函数再去调用。
除了上面三个函数外还有一个很重要的函数()，负责把的数据写入RTW文件。在后面【代码生成-自定义目标代码的生成】会用到，本次内容就不详细介绍。

文章插图

文章插图
帮助文件
函数的详细功能描述、输入参数、其返回值类型及具体例子，可以在搜索中获得。
完成【.C文件】的编写后，需要在中调用编译器对【.C文件】进行编译。由于存在32位和64位，调用的编译器也不一样。32位直接使用自带的lcc-win32即可，64位则需要额外安装的VS的C++编译器。
3、编译

文章插图
通过mex -setup命令选择编译器