文件

s函数SimStruct功能

关于SimStruct函数

的仿真软金宝app件®软件提供了一组用于访问S函数模拟数据结构的字段的功能(酝酿)。S函数回调方法使用这些功能来存储和检索有关S函数的信息。

语言支持金宝app

一些酝酿函数仅在Simulink软件支持的某些语言中可用。金宝app金宝app每一个的参考页酝酿宏或功能列出了可用的语言,并为这些语言提供语法。

笔记

大多数酝酿C中可用的功能实现为C宏。个人参考网页表明酝酿在调试模式下编译S-函数时成为函数的宏(mex-g.)。

simstruct.

该文件simstruc.h.是一个c语言头文件,用于定义Simulink数据结构和金宝app酝酿访问宏。它封装了所有与模型或s -函数相关的数据,包括块参数和输出。

有一个酝酿分配给Simulink模型的数据结构。金宝app模型中的每个s函数都有自己的s函数酝酿与它相关联的。这些的组织酝酿s很像一个目录树。这酝酿与模型相关联的是酝酿.这酝酿与s函数相关的s函数是孩子酝酿s。

用法中列出的Simstruct宏和函数

公共汽车

描述
ssGetBusElementComplexSignal 获取总线元素的信号复杂性。
ssgetbuselementDatatype. 获取总线元素的数据类型标识符。
ssgetbusementdimensions. 获取总线元素的尺寸。
ssgetbuselementName. 获取总线元素的名称。
ssGetBusElementNumDimensions 获取总线元素的维度数。
ssgetbuselementOffset. 从总线数据类型的开始到总线元素获取偏移量。
ssgetnumbusements. 获取总线信号中的元素数。
ssGetSFcnParamName 获取s函数块的块参数值。
ssisdatatypeabus. 确定数据类型标识符是否表示总线信号。
ssregistertypefroparameter. 在Simulink数据类型表中注册数据类型,该类型表中的参数指定。金宝app
ssSetBusInputAsStruct 指定是否将输入总线信号转换为从Virtual到NonVirtual的S-Function转换。
ssSetBusOutputAsStruct 指定来自s函数的输出总线信号必须是虚的还是非虚的。
sssetbusoutputObjectName. 指定定义输出总线信号的结构和类型的总线对象的名称。

数据类型

描述
ssGetDataTypeId 获取数据类型的ID。
ssgetdatatypeidAliasedThruto. 获取与数据类型别名关联的内置数据类型的ID。
ssGetDataTypeName 获取数据类型的名称。
ssgetDatatypesize. 获取数据类型的大小。
ssgetdatatypezero. 获取数据类型的0表示。
ssGetInputPortDataType 获取输入端口的数据类型。
ssgetnumdatatypes. 获取由S函数或模型定义的数据类型数。
ssgetoutputportdatatype. 获取输出端口的数据类型。
ssGetOutputPortSignal 获取任何类型的输出信号除外
ssGetSFcnParamDataType 获取参数的数据类型。
ssregisterdatatype. 注册数据类型。
sssetDatatypesize. 指定数据类型的大小。
ssSetDataTypeZero 指定数据类型的零表示形式。
ssSetInputPortDataType 指定输入端口接受的数据类型。
sssetoutputportDatatype. 指定输出端口的数据类型。

对话框参数

描述
ssGetDTypeIdFromMxArray 获取对话框参数的金宝appSimulink数据类型。
ssgetnumsfcnparams. 获取s函数所需的参数数量。
ssgetsfcnparam. 获取用户在S函数块对话框中输入的参数。
ssgetsfcnparamscount. 获取用户指定的参数的实际数量。
ssSetNumSFcnParams 设置s函数期望的参数个数。
ssSetSFcnParamTunable 指定对话框参数的可调性。

错误处理和状态

描述
ssGetErrorStatus 获取一个标识最后一个错误的字符矢量。
ssGetLocalErrorStatus 获取一个字符向量,该字符向量以线程安全的方式标识最后一个错误。
SSPrintf. 打印变量内容味精
ssseterrorstatus. 报告错误。
ssSetLocalErrorStatus 以线程安全的方式报告错误。
sswarning. 显示警告信息。

函数调用

描述
sscallsystemwithtid. 执行连接到S函数的函数呼叫子系统。
ssdisablesystemwithtid. 禁用连接到此S函数块的函数呼叫子系统。
ssenablesystemwithtid. 启用连接到这个s -功能的函数调用子系统。
ssgetcallsystemnumfcncall-
目的地
获取函数调用目的地的数量。
ssgetexplicitfcssctrl. 确定此S函数是否明确启用并禁用其调用的函数呼叫子系统。
sssetcallsystemOutput. 指定输出端口元素发出函数调用。
sssetexplicitfcsctrl. 指定S函数是否明确启用并禁用其调用的函数呼叫子系统。

输入输出端口

I / O端口 - 信号规格

描述
ssAllowSignalsWithMoreThan2D 启用S​​函数以使用多维输入和输出信号。
ssGetInputPortComplexSignal 获取输入端口的数字类型(复杂或实数)。
ssGetInputPortDataType 获取输入端口的数据类型。
ssgetInputportDirectFeedThrough. 确定输入端口是否具有直接馈通。
ssgetInputPortFramedata. 确定端口是否接受信号帧。
ssGetInputPortOffsetTime 确定输入端口的偏移时间。
ssgetInputportRequiredContifuous. 确定输入端口的信号元素是否必须是连续的。
ssGetInputPortSampleTime 确定输入端口的采样时间。
ssGetInputPortSampleTimeIndex 获取输入端口的采样时间索引。
ssgetInputportunit. 获取输入端口的单位
ssGetOutputPortComplexSignal 获取输出端口的数值类型(复数或实值)。
ssgetoutputportdatatype. 获取输出端口的数据类型。
ssGetOutputPortFrameData 确定端口是否输出信号帧。
ssGetOutputPortOffsetTime 确定输出端口的偏移时间。
ssGetOutputPortSampleTime 确定输出端口的采样时间。
ssgetoutputportunit. 获取输出端口单位
ssregisterunitfromexpr. 从单位表达式注册单元
ssSetInputPortComplexSignal 设置输入端口的数字类型(实数或复数)。
ssSetInputPortDataType 设置输入端口的数据类型。
ssSetInputPortDirectFeedThrough 指定输入端口是直接馈通端口。
sssetInputportoffsettime. 指定输入端口的采样时间偏移量。
sssetInputPortRequiredContiful. 指定输入端口的信号元素必须是连续的。
sssetInputPortSampletime. 设置输入端口的采样时间。
sssetInputportunit. 指定输入端口的单位
sssetnuminputports. 设置S函数块上的输入端口数。
ssSetNumOutputPorts 指定S-Function块的输出端口数。
sssetonebasedindexinputport. 指定输入端口期望基于一个基于索引。
sssetonebasedIndexOutportport. 指定输出端口发出基于一个索引的索引。
ssSetOutputPortComplexSignal 指定端口的数字类型(实或复数)。
sssetoutputportDatatype. 指定输出端口的数据类型。
ssSetOutputPortOffsetTime 指定输出端口的采样时间偏移值。
sssetoutputportsampletime. 指定输出端口的采样时间。
ssSetOutputPortUnit 指定输出端口单位
ssSetZeroBasedIndexInputPort 指定输入端口期望基于零的索引。
ssSetZeroBasedIndexOutputPort 指定输出端口发出基于零的索引。

I / O端口 - 信号尺寸

描述
ssAddOutputDimsDependencyRule 注册一种处理当前尺寸更新的方法。
ssaddvariablesizebizesignalsruntimechecker. 注册一种检查当前输入维度的方法。
ssAllowSignalsWithMoreThan2D 使s功能能够处理多维信号。
ssGetCurrentInputPortDimensions 获取输入端口PIDX的当前大小DIDX。
ssGetCurrentInputPortWidth 获取输入端口PIDX处的信号的总宽度(元素总数)
ssgetcurrentOutportdportions. 获取输出端口PIDX时信号的当前大小的尺寸DIDX。
ssGetCurrentOutputPortWidth 获取输出端口PIDX处的信号的总宽度(元素总数)。
ssGetInputPortDimensions 获取输入端口接受的信号的尺寸。
ssgetInputportDimensionsize. 得到进入输入端口的信号的一维大小。
ssGetInputPortDimensionsMode 获取PIDX索引的输入端口的尺寸模式,
ssgetInputPortNumdimentions. 得到输入端口接收的信号的维数。
ssgetInputPortWidth. 确定输入端口的宽度。
ssGetOutputPortDimensions 获取留下输出端口的信号的尺寸。
ssGetOutputPortDimensionSize 得到离开输出端口的信号的一维大小。
ssgetoutputportDimensionsMode. 设置PIDX索引的输出端口的尺寸模式。
ssGetOutputPortNumDimensions 获取输出端口的维度数。
ssGetOutputPortWidth 确定输出端口的宽度。
sssetCurrentOutputPortDimensions. 设置端口pIdx输出信号的维度dIdx对应的当前大小。
sssetdworkRequireresetforSignalSize. 设置块标志,以便在子系统重置时重置dIndex DWork大小。
sssetinputportdimensionsinfo. 设置输入端口的维度。
sssetInputPortDimensionsMode. 设置由pIdx索引的输入端口的维度模式。
ssSetInputPortDimsSameAsOutputPortDims 将输出端口OUTIDX的尺寸设置为相等的输入端口INPIDX。
sssetInputPortMatrixDimensions. 指定接受矩阵信号的输入端口的维度信息。
ssSetInputPortVectorDimension 指定接受向量信号的输入端口的维度信息。
sssetInputPortWidth. 设置1-D(Vector)输入端口的宽度。
ssSetOutputPortDimensionInfo 指定输出端口的维度。
ssSetOutputPortDimensionsMode 设置PIDX索引的输出端口的尺寸模式。
sssetoutputportmatrixdimensions. 为发出矩阵信号的输出端口指定尺寸信息。
ssSetOutputPortVectorDimension 为发出矢量信号的输出端口指定尺寸信息。
sssetoutputportwidth. 指定一维(矢量)输出端口的宽度。
sssetoutputportmatrixdimensions. 指定2-D(矩阵)信号的尺寸。
ssregmdlsetinputportdimensionsmodefcn. 注册为每个输入端口处理维度模式传播的方法。
sssetsignalsizeComputeType. 设置输入信号的输出依赖性类型。
sssetvectormode. 指定S函数支持的向量模式。金宝app

I / O端口 - 信号访问

描述
ssGetInputPortBufferDstPort 确定正在覆盖输入端口的内存缓冲区的输出端口。
ssGetInputPortConnected 判断S-Function块端口是否连接到非虚拟块。
ssgetInputportimopts. 确定分配给s函数输入端口的内存的可重用性设置。
ssgetInputPortOverWortwarital. 判断输入端口是否可以被覆盖。
ssgetInputportRealsignal. 获取输入输入端口的真实连续信号的地址。
SSGETINPUTPORTREALSIGNALPTRS. 访问连接到输入端口的信号元素。
ssgetInputportSignal. 获取输入输入端口的连续信号的地址。
ssgetInputPortSignalPtrs. 获取指向非类型的输入信号元素的指针
ssgetnuminputports. 可以在任何例程中使用(除外)mdlInitializeSizes)确定块的输入端口有多少。
ssGetNumOutputPorts 可以在任何例程中使用(除外)mdlInitializeSizes)确定块有多少个输出端口。
ssGetOutputPortConnected 确定输出端口是否已连接到非宽度块。
ssgetoutputportbeingmerged. 确定此块的输出是否已连接到a合并堵塞。
ssgetoutputportimopts. 确定分配给S函数输出端口的内存的可重用性。
ssgetoutputportrealsignal. 访问连接到输出端口的信号的元素。
ssGetOutputPortSignal 获取由输出端口发出的信号元素向量。
sssetInputportimopts. 指定分配给S函数的输入端口的内存的可重用性。
ssSetInputPortOverWritable 指定输入端口是否被输出端口覆盖。
ssSetOutputPortOptimOpts 指定分配给S函数输出端口的内存的可重用性。
ssSetOutputPortOverwritesInputPort 指定输出端口是否可以使用输入端口共享其内存缓冲区。

模型参考

描述
ssrtwgenismodelreferencertwtarget. 确定模型参考金宝appSimulink Coder™目标是生成。
ssRTWGenIsModelReferenceSIMTarget 确定模型参考仿真目标是否正在生成。
sssetmodelreferenceNormalMode金宝appUpport. 指定s函数是否可以用于正常模式下的参考模型模拟。
sssetmodelreferencesampletimedefaultinherituces 指定包含此S函数的引用模型可以从其父模型继承其采样时间。
ssSetModelReferenceSampleTimeDisallowInheritance 指定在被引用模型中使用此s函数将阻止被引用模型从其父模型继承其样本时间。
sssetmodelreferencesampletimeinheritancerule. 指定在被引用模型中使用s函数是否会阻止被引用模型从父模型继承其样本时间。

运行时参数

这些宏允许您创建,更新和访问与块对话框参数对应的运行时参数。

描述
ssgetnumruntimeparams. 获取由这个s -函数创建的运行时参数的数量。
ssgetruntimeparaminfo. 获取指定运行时参数的属性。
ssregalltunableparamsasruntimeparams. 将所有可调对话框参数注册为运行时参数。
ssRegDlgParamAsRunTimeParam 注册运行时参数。
sssetnumruntimeparams. 指定此S函数要创建的运行时参数的数量。
sssetruntimeparaminfo. 指定指定运行时参数的属性。
ssupdatealltunableparamsasruntimeparams. 更新对应于可调谐对话框参数的所有运行时参数。
ssupdatedlgparamasruntimeparam. 更新运行时参数。
ssUpdateRunTimeParamData 更新指定运行时参数的值。
ssUpdateRunTimeParamInfo 从相应对话框参数的属性更新指定运行时参数的属性。

样品时间

描述
ssGetInputPortSampleTime 确定输入端口的采样时间。
ssGetInputPortSampleTimeIndex 获取输入端口的采样时间索引。
ssGetNumSampleTimes 获取S-Function的示例时间数量。
ssgetoffsettime. 确定一个s函数的采样时间偏移量。
ssGetOutputPortSampleTime 确定输出端口的采样时间。
ssGetPortBasedSampleTimeBlockIsTriggered 确定是否是使用基于端口的样本时间的块驻留在触发的子系统中。
ssGetSampleTime 确定S函数的样本时间之一。
ssGetTNext 在具有可变采样时间的离散S函数中获取下一个样本命中的时间。
SsiscontInuoustask. 确定指定的速率是否为连续速率。
Ssissamplehit. 确定S函数正在运行的采样率。
ssisspecialsamplehit. 确定当前样本时间是否达到两个指定的速率。
sssampleandoffsetariggered 确定采样时间和偏移值对是否指示触发的采样时间。
sssetInputPortSampletime. 设置输入端口的采样时间。
sssetmodelreferencesampletimedefaultinherituces 指定包含此S函数的引用模型可以从其父模型继承其采样时间。
ssSetModelReferenceSampleTimeDisallowInheritance 指定在被引用模型中使用此s函数将阻止被引用模型从其父模型继承其样本时间。
sssetmodelreferencesampletimeinheritancerule. 指定在被引用模型中使用s函数是否会阻止被引用模型从父模型继承其样本时间。
ssSetNumSampleTimes 设置S函数的采样时间数量。
sssetoffsettime. 指定采样时间的偏移量。
ssSetSampleTime 指定s函数的采样时间。
ssSetTNext 在s函数中指定下一个样本命中的时间。

模拟信息

描述
ssgetblockreduction. 在仿真开始之前确定块是否已请求块降低,并且在仿真环路开始后它实际上已经减少。
ssGetErrorStatus 获取一个标识最后一个错误的字符矢量。
ssGetFixedStepSize 获取包含S函数的模型的固定步长。
ssgetmaxstepsize. 获取包含S函数的模型的最大步长大小。
ssgetminstepsize. 得到包含s函数的模型的最小步长。
ssgetsimmode. 确定正在调用S函数的上下文:正常仿真,外部模式仿真,模型编辑器等。
ssGetSimStatus 确定当前模拟状态。
ssgetsolverMode. 获取用于解决S函数的求解模式。
ssgetsolvername. 获取用于模拟的求解器的名称。
ssGetStateAbsTol 获得模型的变步长求解器在指定状态下使用的绝对公差。
ssgetstoprequested 获取仿真停止请求标志的值。
SSGett. 获取当前基础模拟时间。
ssgettasktime. 获取当前任务的时间。
ssGetTFinal 获取当前模拟的结束时间。
ssGetTNext 获取下一个样本命中的时间。
ssgettstart. 获取当前模拟的开始时间。
ssisexternalsim 确定模型是否在外部模式下运行。
SSISFIRSTINITCOND. 确定当前模拟时间是否等于模拟开始时间。
ssIsMajorTimeStep 确定当前时间步是一个主要时间步长。
ssIsMinorTimeStep 确定当前时间步长是否是次要时间步长。
SsisvariaBlestepsolver. 确定当前求解器是可变步骤求解器。
ssrtwgenisaccelerator 确定模型是否在Accelerator模式下运行。
sssetstateabstol. 设置变量步骤求解器将应用于S函数状态的绝对公差的值。
sssetblockreduction. 请求Simulink尝试减金宝app少块。
SssetoperatingPoint Compliance 指定Simulink如何金宝app在保存和恢复包含S函数的模型的模拟状态时处理S函数。
ssSetOperatingPointVisibility 指定s函数的仿真状态在模型的仿真状态中是否可见(可访问)。
ssSetSolverNeedsReset 要求Si金宝appmulink重置求解器。
ssSetStopRequested 要求Si金宝appmulink在当前时间步骤结束时终止模拟。

国家和工作量

描述
ssgetcontstates. 获得S函数的连续状态。
ssGetDiscStates 获得S函数的离散状态。
ssgetdwork. 得到一个DWork向量。
ssgetdworkcomplexsignal. 确定dwork矢量的元素是真实的还是复杂的数字。
ssgetdworkDatatype. 获取dwork矢量的数据类型。
ssgetdworkname. 获取dwork矢量的名称。
ssGetDWorkUsageType 确定如何在S函数中使用DWORK矢量。
ssgetdworkusedasdstate. 确定dwork矢量是否用作离散状态向量。
ssgetdworkwidth. 获得dwork矢量的大小。
ssgetdx. 求s函数连续状态的导数。
ssGetIWork 获取S函数的整数值(INT_T.向量)工作。
ssgetiworkvalue. 从块的整数工作向量获取值。
SSgetModevector. 得到s函数的模态功向量。
ssGetModeVectorValue 获取块模式向量的一个元素。
ssGetNonsampledZCs 得到s函数的过零信号向量。
ssgetnumcontstates. 确定S函数具有的连续状态的数量。
ssGetNumDiscStates 确定s函数的离散状态数。
ssGetNumDWork 获取块使用的数据类型工作向量的数量。
ssgetnumiwork. 求s函数的整功向量的大小。
ssgetnummode. 确定S函数模式向量的大小。
ssGetNumNonsampledZCs 确定s函数检测到的非抽样过零的次数。
ssgetnumpwork. 确定S函数指针工作向量的大小。
ssgetnumrwork. 确定S函数真实值的大小(real_t.向量)工作。
ssgetpwork. 获取s函数指针(void *向量)工作。
ssgetpworkvalue. 从指针工作向量获得指针。
SSGETREADISCSTATES. 得到真实的(real_t.)S函数的离散状态向量的值。
ssgetrwork. 获得S函数的真实值(real_t.向量)工作。
SSGetRworkValue. 获取S函数真实值的工作向量的元素。
ssSetDWorkComplexSignal 指定数据类型工作向量的元素是实的还是复杂的。
sssetdworkDatatype. 指定数据类型工作向量的数据类型。
sssetdworkname. 指定数据类型工作向量的名称。
ssSetDWorkUsageType 指定DWORK VECTOR如何在S函数中使用。
sssetdworkusedasdstate. 指定将数据类型工作向量用作离散状态向量。
sssetdworkwidth. 指定数据类型工作向量的宽度。
ssSetIWorkValue 设置块整数工作向量的元素。
ssSetModeVectorValue 设置块的模式向量的一个元素。
sssetnumcontstates. 指定s函数的连续状态数。
sssetnumdiscstates. 指定S函数具有的离散状态的数量。
sssetnumdwork. 指定块使用的数据类型工作向量的数量。
ssSetNumIWork 指定s函数整数的大小(INT_T.向量)工作。
sssetnummode. 指定S函数具有的操作模式的数量。
sssetnumnonsampledzcs. 指定S函数检测到的过零点的数量。
sssetnumpwork. 指定S函数指针的大小(void *向量)工作。
sssetnumrwork. 指定s函数实值的大小(real_t.向量)工作。
sssetpworkvalue. 设置块的指针工作向量的元素。
sssetrworkValue. 设置块的浮点工作向量的元素。

代码生成

描述
ssGetDWorkRTWIdentifier 在由关联的s -函数生成的代码中获取用于声明DWork向量的标识符。
ssgetdworkrtwidentifiermustresolvetosignalObject. 获取一个标志,指示DWork向量是否解析为金宝appsimulink.signal.目的。
ssgetdworkrtwstorageclass. 获取从关联的S函数生成的代码中的dwork矢量的存储类。
ssGetDWorkRTWTypeQualifier 获取C类型限定符(例如,常量),用于在由相关的s -函数生成的代码中声明DWork向量。
ssgetnuminputports. 获取块具有的输入端口数量
ssGetNumOutputPorts 获取块具有的输出端口数量
ssgetplacementgroup. 获取块的放置组的名称。
ssrtwgeniscodegen. 确定加速器未使用的任何代码生成。
sssetarraylayoutforcodegen. 指定s函数的阵列布局。
sssetdworkrtwidentifier 设置用于声明从关联的S函数生成的代码中的dwork矢量的标识符。
sssetdworkrtwidentifiermustresolvetosignalobject. 指定DWOORK VECTOR是否解决了金宝appsimulink.signal.目的。
sssetdworkrtwstorageclass. 在从关联的S函数生成的代码中设置Dwork矢量的存储类。
sssetdworkrtwtypequalifier 设置C类型限定符(例如,常量),用于在由相关的s -函数生成的代码中声明DWork向量。
sssetplacementgroup. 指定块的放置组的名称。
ssWriteRTW2dMatParam 向S函数写入Si金宝appmulink Matrix参数model.rtw.文件。
ssWriteRTWMx2dMatParam 写一个matlab.®s函数的矩阵参数model.rtw.文件。
ssWriteRTWMxVectParam 用MATLAB写出s函数的矢量参数model.rtw.文件。
sswritertwparameters. 将可调参数写入s函数model.rtw.文件。
sswritertwparamsettings. 将S函数的参数写入设置model.rtw.文件。
ssWriteRTWScalarParam 向S函数写一个标量参数model.rtw.文件。
sswritertwstr. 向S函数写一个字符向量model.rtw.文件。
ssWriteRTWStrParam 向S函数写一个字符向量参数model.rtw.文件。
sswritertwstrvectparam. 向S函数写一个字符矢量矢量参数model.rtw.文件。
sswritertwvectparam. 向S函数写入Si金宝appmulink Vector参数model.rtw.文件。
sswritertwworkvect. 将S函数的工作向量写入model.rtw.文件。

各种各样的

描述
sscallexternalmodefcn. 调用S函数的外部模式功能。
ssgetmodelname. 获取包含S-Function的S-Function块或模型的名称。
ssgetpartents 得到s函数的父函数。
SSGetPath. 得到s函数的路径或包含s函数的模型。
SSGETROTSS. 返回根(型号)酝酿
ssgetuserdata. 访问用户数据。
ssSetExternalModeFcn 指定S函数的外部模式功能。
ssSetOptions 设置各种模拟选项。
sssetplacementgroup. 指定接收器或源s -函数的执行顺序。
sssetuserdata. 指定用户数据。
ss金宝appsupportsmultipleexecinstances. 允许s函数在For Each子系统中运行。