简介面向需要在 Matlab 与 LabWindows/CVI、LabVIEW 之间实现交互的工程与科研开发者重点解决跨软件数据交换与功能调用问题。包内共 21 个文件包含 C 源码、头文件、LabWindows/CVI 工程文件、编译中间文件与可执行演示程序并附有 bri、uir、fp 等配置辅助文件整体约 2.61MB结构清晰适合直接阅读和复现。已有 139 人学习说明该主题具备一定参考价值。资源演示了 matlabsrvr 与 MatlabTest 等工程之间的联动方式涉及 ActiveX 对象创建、方法调用与数据传递等关键操作。通过阅读和运行这些示例开发者可以快速掌握在 Matlab 中操作 LabWindows/CVI 或 LabVIEW 功能的流程也能理解如何在自动化测试中由 CVI 或 LabVIEW 负责硬件采集与实时控制Matlab 承担高级运算与报告生成从而搭建前后端分离的混合架构。其中 actxcontrol 等接口的用法和工程配置方式对从事测试测量、数据分析和设备控制的开发者尤具参考价值有助于缩短集成开发周期。1. 用 ActiveX 把 MATLAB 变成 CVI 的后端计算引擎做测试测量的人迟早会撞上这样一个问题LabWindows/CVI 写界面和采集流程很顺手但一碰到矩阵运算、滤波器设计、曲线拟合C 语言版本的实现又长又容易出数值误差而 MATLAB 算这些是强项却搞不定板卡驱动和实时采集。Matlab_TEST.rar这个工程包给的答案很直接用 ActiveX 把 MATLAB 挂到 CVI 进程里MATLAB 负责算CVI 负责采和显示。包里matlabsrvr.fp、matlabsrvr.c、MatlabTest.prj这几个文件其实就是一条完整的调用链路编译出来的MatlabTest.exe可以直接跑起来看效果。适合已经把 CVI 摸熟、想给现有测试程序加 MATLAB 算法模块的人也适合刚接触 ActiveX 混合编程、想找个最小可运行示例入手的开发者。注意一点这种方式不是在 MATLAB 里调 CVI 的库方向反了是 CVI 作为 ActiveX 客户端去驱动 MATLAB 的 Automation Server理解清楚这个关系后面才有得谈。2. 拆解 Matlab_TEST 工程从工程文件到 ActiveX 调用链2.1 工程包里每个文件是干什么的拿到压缩包先别急着编译把这几个文件的角色搞清楚能省不少排查时间。MatlabTest.prj是 LabWindows/CVI 的工程文件双击它就能在 CVI 里打开整个项目MatlabTest.uir是用户界面资源定义了主面板和按钮MatlabTest.c是主程序逻辑负责初始化和响应界面事件。真正关键的是matlabsrvr.c和matlabsrvr.h这一对文件封装了对 MATLAB ActiveX 服务的调用操作。matlabsrvr.fp是 CVI 的函数面板文件在 CVI 里按 CtrlF 打开 Library 时能看到这个 ActiveX 库的函数原型它告诉你matlabsrvr.h里每个函数接受什么参数、返回什么类型写代码时按 F1 能直接查不用来回翻文档。剩下的构建产物分两类一类是中间文件matlabsrvr.obj、matlabutil.nidobj、MatlabTest.nidobj是编译生成的删了也没关系Build 时会重新生成cvibuild.MatlabTest、Debug、build.ini是 CVI 的构建配置目录matalbsrvr.sub是子程序文件记录函数面板的二进制定义。另一类算结果文件MatlabTest.cdb是 CVI 的调试符号数据库MatlabTest.exe是最终可执行程序。最后那个and_lpp.m是 MATLAB 端的脚本CVI 调用 MATLAB 执行的就是这个文件里的逻辑改算法时主要动它。2.2 CVI 端初始化 MATLAB ActiveX Server 的完整流程整个调用过程可以分成四步初始化 ActiveX 运行环境、创建 MATLAB 的 COM 对象、用Execute方法执行 MATLAB 命令、在退出或出错时释放资源。下面是matlabsrvr.c里核心初始化代码的等价实现#include matlabsrvr.h #include cvirte.h #include utility.h static CAObjHandle hMatlab 0; // MATLAB ActiveX 对象句柄 int InitMatlabServer(void) { HRESULT hr 0; int err 0; // 1. 初始化 ActiveX 机制本身任何 COM 调用前都必须先执行 err CA_Init(); if (err 0) { MessagePopup(Error, CA_Init failed); return -1; } // 2. 创建 MATLAB.Application 实例CLSID 由系统注册表决定 hr CA_CreateObject(Matlab.Application, NULL, hMatlab); if (hr 0 || hMatlab 0) { MessagePopup(Error, Cannot create Matlab.Application object); return -1; } // 3. 将 MATLAB 窗口设为可见调试阶段方便看 MATLAB 命令行输出 err matlabsrvr_Execute(hMatlab, disp(CVI connected to MATLAB);); if (err 0) { MessagePopup(Error, Execute command failed); return -1; } return 0; }这段代码有三处值得注意。CA_Init()不是可选项它是 CVI 整个 ActiveX 子系统的前提漏掉的话后续所有 COM 调用都会返回ActiveX 未初始化这类错误而且这个错误在 CVI 的调试窗口里并不显眼经常被误判成 MATLAB 没装好。CA_CreateObject的参数Matlab.Application是 MATLAB 在注册表中的 ProgID这个字符串在 MATLAB 6.5 到 R2023b 之间都没变过但前提是你安装 MATLAB 时勾选了 COM 组件支持有些精简版 MATLAB 没有注册这个 ProgID创建会失败。matlabsrvr_Execute这个名字看起来像 CVI 自己的函数但实际上它是根据 MATLAB ActiveX 类型库自动生成的参数个数和类型在matlabsrvr.fp里有严格定义不能随意简化。2.3 执行 MATLAB 脚本并取回计算结果的参数约定创建对象只是第一步真正干活的是执行脚本和取结果。MATLAB 的 ActiveX 接口暴露了三个核心方法Execute执行命令、GetFullMatrix取矩阵数据、PutFullMatrix写矩阵数据。CVI 封装后用起来长这样int RunMatlabScript(const char* script) { int err 0; char resultBuf[8192] {0}; // 存放 MATLAB 命令行的文本输出 // Execute 返回 MATLAB 在命令窗口打印的所有内容 err matlabsrvr_Execute(hMatlab, script, resultBuf); if (err 0) { return -1; } // resultBuf 里可能是正常输出也可能是 MATLAB 的红色报错信息 if (strstr(resultBuf, Error) ! NULL) { printf(MATLAB runtime error: %s\n, resultBuf); return -1; } return 0; }matlabsrvr_Execute比想起来麻烦的一点是第三个参数它要求调用方先分配好缓冲区函数内部把 MATLAB 命令行的全部输出写进来缓冲区不够大会返回MB_BUFFER_TOO_SMALL之类的错误码。缓冲区开多大没有标准答案我一般给 8192大多数脚本命令的输出足够但如果你用 MATLAB 打印大矩阵的内容这个值就不够了需要根据实际情况调整。对于矩阵数据本身的交互CVI 的自动生成代码里通常没有直接封装GetFullMatrix因为 MATLAB COM 接口的方法签名在类型转换层不好处理。常见做法是绕一下在 MATLAB 脚本里把要传回的数据写入文本文件或二进制文件CVI 端用GetFileInfo和ReadFile去读。比如这样// CVI 端先执行 MATLAB 计算并保存结果 RunMatlabScript(x 0:0.01:1; y sin(2*pi*x); save(temp_data.mat, x, y);); // 然后从文件读回 FILE* fp fopen(temp_data.mat, rb); fread(buffer, sizeof(double), length, fp); fclose(fp);提示如果追求性能就放弃通用封装直接用import matlab.tlb重新生成一次接口代码然后手动把 VARIANT 指针接上GetFullMatrix。这样能把交互延迟从文件 IO 的毫秒级降到几十微秒但写起来痛苦适合一次搭好长期复用的场景。2.3.1 Put/GetFullMatrix 的直接封装方式如果确实需要在每次调用时传矩阵可以在 CVI 里用VARIANT手动构造参数调用生成的IDispatch接口方法。核心代码大致是VARIANT varOut, varIn; VariantInit(varOut); VariantInit(varIn); V_VT(varIn) VT_ARRAY | VT_R8; // 8 字节双精度数组 V_ARRAY(varIn) CreateSafeArray(NULL, dims, 2); // 维度在 dims 里定义 hr pMatlabDisp-Invoke(dispidPutFullMatrix, IID_NULL, LOCALE_USER_DEFAULT, DISPATCH_METHOD, params, varOut, NULL, NULL);这一层的手写 Invoke 代码很容易漏掉 SafeArray 的维度顺序和数组下界MATLAB 数组按列优先存储C 语言按行优先方向搞反了数据就错位了。如果你不是特别需要每次传几千个浮点数的场景建议还是用文件中转简单且不容易出隐蔽错误。3. 从工程包到可运行程序编译、配置与最小验证步骤3.1 编译环境的三个前提条件要编译MatlabTest.prj你的机器上得同时具备三样东西。第一是 NI LabWindows/CVI这个工程用 CVI 打开官方原版和 NI 官网试用版都行2013 以后的所有版本都能打开老工程只是链接器版本不同可能导致重编译后 exe 体积变大。第二是 MATLAB必须是完整安装不能是阉割版。判断标准很简单Windows 命令行里执行reg query HKCR\Matlab.Application能返回结果说明 COM 组件注册了返回错误就说明 MATLAB 没装 COM 支持或者被精简过。第三是 ActiveX 支持组件CVI 的完整安装包默认包含但如果当初安装时勾选了自定义组件并且没勾 ActiveX 相关项就需要重新运行安装程序补上。三个条件确认没问题后双击MatlabTest.prj在 CVI 的 Build 菜单下选Build MatlabTest.pri或者直接按 F7编译成功后Debug目录下会出现MatlabTest.exe。编译过程中最常见的错误是matlabsrvr.obj链不上原因多是类型库文件路径不对需要检查.prj里引用的.fp文件路径在不在工程目录里。3.2 安装到无 MATLAB 环境时的运行时依赖检查编译好的MatlabTest.exe不是绿色软件运行时依赖 CVI 运行时引擎和 MATLAB COM 组件。CVI 的运行时引擎在 CVI 安装目录的bin下有cvirte.dll发布程序时要把这些 DLL 一起带上或者让目标机器装上 NI 的 CVI Runtime Engine。MATLAB 这边的依赖是必须真装 MATLAB至少要有 MATLAB 的 COM 服务可用这是硬依赖绕不开。如果你的目标是给只在测量现场跑的机器而这些机器没装 MATLAB那就得换思路要么把 MATLAB 算法编译成独立组件要么在 MATLAB 里用 MATLAB Compiler 把算法打成 DLL 给 CVI 调用。那个方案的好处是部署机器只装 MCR 运行时体积小得多但开发和调试周期也更长。3.3 跑通 Demo 的最小步骤与验证方法拿到工程包后最快验证环境是否正常的路子是打开MatlabTest.prj先不编译直接按 F5 运行调试版本CVI 会启动MatlabTest.exe。确保 MATLAB 已经启动且能正常打开命令行窗口。如果 MATLAB 启动太慢可以先手动打开 MATLAB 再运行 CVI 程序这样CA_CreateObject会直接连到已运行的实例速度快不少。在主界面点击触发 MATLAB 调用的按钮正常情况下 MATLAB 窗口会显示脚本输出CVI 界面上也会回显结果。如果在第 2 步卡住停在CA_CreateObject出不来先确认 MATLAB 的 ProgID 是否注册成功。还有一种比较坑的情况机器上装了 64 位 CVI 和 32 位 MATLAB或者反过来ActiveX 跨位数调用经常失败。检查方法是看 MATLAB 的安装目录是Program Files还是Program Files (x86)CVI 也同理尽量让两者位数保持一致。# 快速检查 MATLAB COM ProgID 是否注册 reg query HKCR\Matlab.Application # 应有类似输出HKEY_CLASSES_ROOT\Matlab.Application REG_SZ MATLAB.Application注意如果reg query输出的是ERROR: The system was unable to find the specified registry key or value说明 MATLAB 没有注册 COM 服务。此时需要重装 MATLAB或者用matlab /regserver尝试重新注册具体命令取决于 MATLAB 版本。4. MATLAB 与 LabVIEW 的 ActiveX 通道和 CVI 方案的同与异4.1 两者的架构差异决定了脚本组织方式不同很多资料把 MATLAB 与 LabVIEW 的交互和 MATLAB 与 CVI 的交互混在一起讲仿佛只是换了个 IDE实际上差别不小。CVI 这边是 C 语言环境调用 MATLAB 的 ActiveX 对象是程序主动发起控制力最强适合算法逻辑复杂、需要精确控制调用顺序的场景。LabVIEW 那边虽然也走 ActiveX但 LabVIEW 的调用方式更像“在框图上拖节点填参数”本质上还是同一个 COM 接口只是封装层次不同。LabVIEW 调用 MATLAB 最常见的方式是MATLAB Script Node这个节点在函数选板的“数学→脚本与公式”里拖到程序框图后里面可以写 m 代码输入输出通过节点边框定义。它的实现机制也是 ActiveX底层同样需要 MATLAB 的 COM 服务可用。除了脚本节点也可以用Automation Open函数直接打开 MATLAB Application 对象然后调用Execute和GetFullMatrix方法这种玩法在 LabVIEW 和 CVI 里更接近但 LabVIEW 的社区方案普遍偏向脚本节点原因在于脚本节点在框图上更直观不需要手动处理 VARIANT。4.2 LabVIEW 端调用 MATLAB 的具体实现与参数传递用自动化方式在 LabVIEW 里走过的流程是先Automation Open打开Matlab.Application得到应用引用后Invoke Node调用Execute方法输入 m 代码字符串返回执行结果。拿矩阵数据时用GetFullMatrix方法传入x、base两个字符串和两个 Variant 数组的引用LabVIEW 会自动做数组类型转换比 CVI 手写 VARIANT 省事得多。参数传递上有一个地方要特别留意GetFullMatrix的base参数指定的是 MATLAB 工作区默认base指基础工作区但如果你在 MATLAB 函数里通过evalin切换了工作区这里就要对应调整。以下是一个最简单的 LabVIEW 调用 MATLAB 的伪代码逻辑Automation Open: Matlab.Application Invoke Node: Execute Input: a magic(4); b sum(a); GetFullMatrix: b, base, b_out Automation Close这段过程里Execute不会等待 MATLAB 执行结束就返回不实际上它是同步等待的Execute方法返回时脚本已经执行完毕不需要额外加延时。4.3 什么时候用 CVI 方案、什么时候用 LabVIEW 方案就工程选型而言三个维度可以参考。硬件驱动生态CVI 的优势在 NI-DAQ、GPIB、VISA 这些底层接口的 C 语言调用测试序列逻辑复杂、分支多时用 CVI 控制起来更方便。LabVIEW 的强项是数据流图和多线程并行采集 UI 刷新和控制循环天然分离适合实时性要求高的场景。算法耦合度如果 MATLAB 只是偶尔算个滤波系数CVI 和 LabVIEW 差别不大但如果要做闭环控制每个周期都要调用 MATLAB 算一次那 ActiveX 的进程间通信开销就躲不掉了这时候无论 CVI 还是 LabVIEW 都不合适应该考虑把 MATLAB 算法编译成独立组件。团队维护能力纯软件工程师更习惯 CVI 的 C 代码调试测试工程师往往更熟悉 LabVIEW。选型时要考虑后续谁维护这个程序否则项目交接容易出问题。5. 实测排错ActiveX 联调中的高频问题与定位方法5.1 MATLAB 对象创建失败的类型与解决路径CA_CreateObject失败在联调初期出现频率最高错误码本身看不出太多信息要看日志和经验。常见三类原因第一类MATLAB 版本位数不匹配。CVI 是 32 位程序就必须配 32 位 MATLAB实际上 LabWindows/CVI 到 2013 版本之后分 32 位和 64 位Matlab.Application这个 ProgID 由最后安装的 MATLAB 决定如果系统里同时装了 32 位和 64 位 MATLABProgID 指向哪一版取决于安装顺序。解决方法是卸载其一或者用matlab /regserver重新注册目标版本。第二类MATLAB COM 服务被安全软件拦截。有些企业的终端防护软件会阻止 MATLAB 进程创建 COM 对象现象是 MATLAB 命令行能打开但任何外部程序调用Matlab.Application都失败。定位方法是手动在 CVI 的调试窗口执行CA_CreateObject并步进看是否卡在权限申请上。第三类MATLAB 未完全启动就尝试连接。CA_CreateObject如果连到正在启动的 MATLAB可能返回REGDB_E_CLASSNOTREG或直接超时。稳妥的做法是先手动启动 MATLAB 并等命令行就绪再运行 CVI 程序。5.2 执行脚本报错但消息被吞掉的处理matlabsrvr_Execute返回成功但 MATLAB 端实际报错了这种情况最迷惑人。原因是 MATLAB 把错误文本也作为输出写入了返回缓冲区但错误不一定包含Error字样有的版本输出是中文“错误”有的是Undefined function开头。所以不要只搜Error关键字做判断。另一个坑是 MATLAB 脚本里用了cd切换目录但 ActiveX 方式启动的 MATLAB 工作目录和手动打开的不一样脚本里如果用了相对路径加载数据就会找不到文件。解决时统一在脚本开头用绝对路径或者cd(fileparts(mfilename(fullpath)))保证路径稳定。// 更稳妥的脚本执行封装不只看返回值还要完整打印输出 int RunMatlabScriptVerbose(const char* script) { char output[8192] {0}; int err matlabsrvr_Execute(hMatlab, script, output); printf(MATLAB output:\n%s\n, output); if (err 0 strlen(output) 0) { printf(AxitveX call failed, but MATLAB produced no output.\n); return -1; } return 0; }这么做虽然信息量变大了但有个缺点如果 MATLAB 命令输出超过 8192 字节后面的内容会被截断。遇到大矩阵打印时把output数组改成char*动态分配按输出大小扩展或者先调用一次numel估算大小再分配。5.3 调用过程中 CVI 界面卡死的场景CVI 调用 MATLAB 执行一个耗时的脚本时界面会卡住这是因为Execute是同步阻塞调用MATLAB 没算完之前不会返回控制权。如果你的脚本里有个大循环要跑几十秒用户体验极差。处理方式有两种各有利弊。方式一是把耗时脚本放到 MATLAB 端异步执行CVI 只负责发起然后用定时器每隔几百毫秒查询 MATLAB 的状态。ActiveX 接口的Execute不支持异步但可以变相实现用 MATLAB 的timer对象在 MATLAB 进程内部定时执行脚本CVI 只发一条start(timer(...))命令就返回。// MATLAB 端启动 timer 异步完成任务 RunMatlabScript(t timer(TimerFcn, (x,y)myjob(), StartDelay, 0.1); start(t););方式二是在 CVI 工程里把 MATLAB 调用放到单独的工作线程界面线程照常处理消息循环。CVI 的CmtScheduleThreadPoolFunction可以用来实现但要注意 ActiveX 的 COM 对象在线程间的封送Marshaling简单场景下在子线程里创建 MATLAB 对象比主线程创建再传给子线程更省事。5.4 用进程监控工具判断调用链路哪一环断了当错误信息不足以定位时用 Windows 自带的tasklist和任务管理器观察 MATLAB 进程状态能帮上忙。正常调用时CVI 程序启动后系统中会出现MATLAB.exe进程如果没出现说明CA_CreateObject阶段就失败了如果出现了但一直占 CPU 不返回说明脚本卡在某个循环或等待上。更细一点的工具是微软的Process MonitorProcmon能记录 MATLAB.exe 对注册表和文件系统的访问记录。比如脚本加载数据文件失败时Procmon 里能看到 MATLAB 访问某个不存在的路径返回NAME NOT FOUND。装不上 Procmon 的时候也可以用 MATLAB 命令行窗口看错误输出——前提是 CVI 创建的 MATLAB 窗口可见有些版本matlabsrvr_Visible属性能控制调试时把它设为 1 能看到实时输出发布时再设为 0。6. 进阶技巧用 matlabsrvr.fp 生成自己的 ActiveX 封装绕开文件 IO走到这一步文件中转和基本 Execute 都玩熟了真正的效率提升来自直接调用 MATLAB 的GetFullMatrix和PutFullMatrix。CVI 的 ActiveX 库生成器允许你基于matlab.tlbMATLAB 安装目录下bin\win64\matlab.tlb或bin\win32\matlab.tlb重新生成函数面板然后手动补上矩阵读写。具体做法是在 CVI 的Tools - ActiveX Automation Controller向导里选择 MATLAB 的类型库让 CVI 生成matlabutil.c和matlabutil.h里面的MLApp接口相比默认的matlabsrvr更完整包含GetFullMatrix和PutFullMatrix。有了这两个方法CVI 和 MATLAB 之间直接交换数组的效率比文件 IO 提升至少一个数量级。下面是一个完整的PutFullMatrix调用片段#include matlabutil.h #include cvirte.h #include stddef.h int SendArrayToMatlab(CAObjHandle hMatlab, const char* name, double* data, int rows, int cols) { VARIANT varReal, varImag; HRESULT hr 0; long dims[2]; VariantInit(varReal); VariantInit(varImag); dims[0] rows; dims[1] cols; // 构造实数矩阵的 VARIANT二维双精度数组按列优先填充 V_VT(varReal) VT_ARRAY | VT_R8; V_ARRAY(varReal) SafeArrayCreate(VT_R8, 2, dims); // 将 C 的行优先数据转换为 MATLAB 的列优先存储 double* pData NULL; SafeArrayAccessData(V_ARRAY(varReal), (void**)pData); for (int i 0; i rows; i) { for (int j 0; j cols; j) { pData[j * rows i] data[i * cols j]; } } SafeArrayUnaccessData(V_ARRAY(varReal)); // 虚部矩阵空数组MATLAB 端一般不需要 V_VT(varImag) VT_ARRAY | VT_R8 | VT_EMPTY; hr MLApp_PutFullMatrix(hMatlab, name, base, varReal, varImag); VariantClear(varReal); VariantClear(varImag); return (hr S_OK) ? 0 : -1; }这里最值得注意的就是行列顺序的转换MATLAB 的 SafeArray 按列优先Fortran 顺序存储C 语言按行优先。二维数组data[rows][cols]在内存里是 row0col0、row0col1、row1col0MATLAB 端要求的是 row0col0、row1col0、row0col1所以必须做一次索引重排。漏掉这一步的话传过去的矩阵是转置后的结果通常在数值上你一眼就能看出来不对劲但如果你传的是方阵转置不会报错也不会可视化异常数据对不上就非常难查输出错位几个位置你就得怀疑人生。收回来讲GetFullMatrix的用法是对称的用VariantInit初始化接收数组后调用MLApp_GetFullMatrix接着用SafeArrayAccessData拿到指针再按列优先转回行优先。写这种代码时总是建议配合维度查看首先在 MATLAB 端对传入的矩阵求和验证一下值对得上再往下接算法。最后说一个技巧如果你只需要在 CVI 里调用 MATLAB 而不需要反向传数据直接用matlabsrvr.fp生成的默认封装就够了把Execute的命令拼接写得规范些所有路径用绝对路径或genpath处理可以避免 80% 的联调问题。主动用上GetFullMatrix你能走通全双工的数据通道从一个只会发命令的客户端升级成 MATLAB 的正式计算对等体。本文还有配套的精品资源点击获取