如何使用你的NIVeristandmodelframework.doc

如何使用你的NIVeristandmodelframework使用NI VeriStand模型框架模型是现实世界系统的数学表示.模型通过模仿模型化系统的行为方式产生输出来对刺激做出反应NI VeriStand是一个基于配置的测试软件，可以用来运行模型仿真，探测模型信号，设置模型参数，或者与您的仿真模型交互。本指南描述如何使用NI VeriStand Model Framework 编译您的现有的C/C+模型代码,这样您就可以在NI VeriStand软件中加载您的模型.NI VeriStand通过调用各种方法加载已编译的模型或模型dll模型DLL中的入口点函数。NI VeriStand Model Framework是一个C文件(codegen.c）和一个相关的头文件（NIVERISTAND_API。h ）您可以使用它将这些函数添加到您创建的模型中。本指南描述了框架代码如何与您的模型代码交互，如何配置您的模型代码，以及如何使用NI VeriStand Model Framework来编译模型您的模型。内容交互的框架代码和模型代码 2管理执行时间 2配置您的模型代码 3创建头文件 3使用符号来访问参数值 3使用NI VeriStand Model Framework类型定义 4使用NI VeriStand Model Framework编译您的模型 5安装模板和示例文件 5相关的文档 5框架代码和模型代码的交互使用NI VeriStand Model Framework编译您的模型之后，您可以在niveristand中运行编译好的模型DLL.NI VeriStand在确定性时间循环中加载NI VeriStand Model Framework中的函数。然后,您模型代码中的函数转换用户定义的数据类型，初始化您模型，并获取一个时间步长。在NI VeriStand中，时间步长是所有任务必须完成的最小时间单位。下图显示了NI VeriStand，模型框架代码以及您模型中的代码在一个时间步长中如何进行交互。图1所示。NI VeriStand、框架代码和模型代码的交互。NI VeriStandFramework Code TimeModel Code管理执行时间在一个时间步长里中,NI VeriStand Model Framework代码运行在您的模型代码之前和之后。在模型代码之后运行的框架代码在模型代码运行完成之前不能运行.如果你的组合模型DLL代码超过指定时间运行，NI VeriStand将关闭仿真。分配的运行时间由模型的交互及系统中的硬件决定。为了避免NI VeriStand关闭您的仿真，在编写您的模型运行或执行部分的函数时，请记住以下几点： 除了运行您的模型外，NI VeriStand必须完成诸如处理输入数据和返回输出数据这样的任务。您系统中的输入和输出数量可能会增加你必须分配给时间步长的时间. 如果您的系统包含多个模型,那么所有的模型都可能需要在给定的时间步长中执行任务。配置您的模型代码您模型DLL的代码必须包含某些头文件，NI VeriStand可以识别的导入、导出符号和函数。NI VeriStand Model Framework导入这些头文件、符号和函数名,所以它们必须存在于您的模型代码中。创建头文件您必须为NI VeriStand Model Framework创建头文件，model.h。该model。h文件包含您模型中的参数类型定义，并且必须在模型中包含所有用户可见的参数。您可以使用在xxxModelInterfacecustomsinewave 目录中的model。h文件，其中xxx是NI Veristand的根目录，作为创建自己文件的示例.你必须使用model.h作为您头文件的文件名。图2。示例model.h文件使用符号访问参数值NI VeriStand Model Framework实例化了参数类型定义作为rtParameter写在您创建的model.h中,也就是你的模型代码只需要导入此符号，就可以访问参数值，如下面的示例代码所示。图3.使用readParam符号的示例因为您既可以从参数中读取值，也可以向参数中写入值，NI VeriStand Model Framework双缓冲参数,创建一个“读取端"和“写入端”。这可以防止写操作中断读操作,或者相反，因为这两个操作从来没有操作过内存中相同的值。当NI VeriStand Model Framework向参数写入值时，它就会写到双缓冲区的“写入端”。当框架读取时一个来自参数的值，它从双缓冲区的“读取端"读取。您的模型代码只应该访问“读取端"。使用NI VeriStand Model Framework类型定义NI VeriStand Model Framework的头文件，NIVERISTAND_API.h，包括类型定义您的模型代码可以用于定义模型的向外组件的属性，例如作为参数、信号和外部I/O。参数和信号属性都有一个地址字段，而外部I/O没有。对于信号，地址字段是指向信号值所存储的位置.对于参数,地址字段是在model。h中参数结构的偏移量。在下面的示例代码中，&rtSignal。sinewave定义了信号的地址域.Figure 4. Address of a Signal图4。信号地址在下面的示例代码中，offsetof（Parameters，sinewave_sine_Amp）定义了一个参数的地址字段.图5。参数地址使用NI VeriStand Model Framework编译您的模型在您创建model.h头文件和更新您的模型代码使用NI VeriStand Model Framework需要的符号以后，您可以用Framework编译您的模型代码来创建一个NI VeriStand可以加载的模型DLL。使用您的模型代码以及NI VeriStand Model Framework，编译codegen.c（此文件位于xxxModelInterfacecustom目录中）来构建您的模型。NI VeriStand Model Framework添加到编译后的模型DLL里的函数在NIVERISTAND_API.h中定义。该。h文件位于xxx ModelInterface目录。NI VeriStand使用了这个框架函数连接到您模型代码中的函数.安装的模板和示例文件参考template.c 文件，位于xxxModelInterfacecustom目录,用于列出在依靠NI VeriStand Model Framework构建模型之前必须添加到模型代码中的所有代码.参考sinewave。c 文件，位于xxxModelInterfacecustomsinewave目录，可以作为一个使用NI VeriStand Model Framework编译以创建模型DLL的模型代码示例。注意:这些文件,以及本指南前面提到的文件，是随同NI VeriStand Model Framework一起安装的。如果无法找到这些文件，请再次运行NI VeriStand安装程序从下表中选择NI VeriStand xxxx Model Framework（其中xxxx是版本号)要安装的特性列表。您不需要重新安装NI VeriStand来安装NI VeriStand Model Framework。相关的文档参考NI VeriStand帮助，选择帮助»查找NI VeriStand帮助，获取更多关于在NI VeriStand中运行模型的信息。