📚 课程目录第4章 CAPL编程基础

4. CAPL编程基础

各位好，欢迎来到第四章。

说实话，CAPL 的基础语法学完，你大概能写个几十行的测试脚本了。但真正到了项目里，你会发现光靠几个变量和 if-else 根本不够用。数据怎么存？测试结果怎么落盘？怎么跟界面上的按钮联动？

这一章，我们就来解决这些实际问题。我会把我在几个量产项目里踩过的坑、总结出来的套路，都揉进下面的内容里。

4.1 数组与结构体：让数据管理更规整

先聊聊数组。CAPL 里的数组，跟 C 语言很像，但也有自己的脾气。

4.1.1 一维与多维数组

定义数组很简单，但要注意，CAPL 数组的下标是从 0 开始的。我见过不少新手在循环里把下标写成了从 1 开始，结果第一个元素永远读不到。

// 定义一个存放 10 个报文 ID 的数组
dword g_expectedIds[10] = {0x100, 0x200, 0x300, 0x400, 0x500, 0x600, 0x700, 0x800, 0x900, 0xAAA};

// 二维数组：模拟 3 个测试用例，每个用例有 4 个参数
byte g_testMatrix[3][4] = {
    {1, 2, 3, 4},
    {5, 6, 7, 8},
    {9, 10, 11, 12}
};

我的习惯： 定义数组时，我总会在注释里写清楚数组长度和用途。不然过两个月回来看代码，自己都懵。

4.1.2 结构体：把零散数据打包

结构体是 CAPL 里组织复杂数据的利器。比如你要描述一个节点的状态，有名字、有电压、有温度，用结构体就比用一堆散变量清爽得多。

// 定义结构体类型
struct NodeStatus {
    char    name[32];
    float   voltage;
    float   temperature;
    dword   errorCode;
};

// 声明并初始化
struct NodeStatus g_sensorNode = {"Sensor_A", 5.0, 85.5, 0x00};

我在项目里常用结构体来传递测试参数。比如一个测试用例的输入输出，打包成一个结构体，函数调用时传一个指针进去，代码干净，维护也方便。

注意： CAPL 的结构体不支持嵌套定义。你不能在一个结构体里再定义一个结构体成员。如果非要这么做，得用指针或者把数据打平。

4.2 文件 I/O 操作：把测试结果留下来

自动化测试跑完了，结果得存下来吧？不然怎么跟老板汇报？文件 I/O 就是干这个的。

4.2.1 打开与关闭文件

CAPL 用 fileOpen 和 fileClose 来操作文件。路径建议用绝对路径，或者用 FileSelectDialog 让用户自己选。

// 打开一个文件用于写入
dword fileHandle;
fileHandle = fileOpen("C:\\TestResults\\log.txt", "w");
if (fileHandle == 0) {
    write("文件打开失败！");
} else {
    fileWrite(fileHandle, "测试开始...\n");
    fileClose(fileHandle);
}

  避坑指南： 我曾经在项目里忘了关文件句柄，结果跑了一晚上测试，第二天发现磁盘空间满了。文件操作一定要成对出现：open 和 close。

4.2.2 读写 CSV 文件

CSV 是测试报告最常用的格式。我一般会封装一个写 CSV 的函数，把测试用例编号、时间戳、结果、备注都写进去。

void WriteCsvLine(dword handle, dword testId, float value, byte result) {
    char line[256];
    snprintf(line, elcount(line), "%d,%.2f,%d\n", testId, value, result);
    fileWrite(handle, line);
}

读文件时，用 fileGetString 逐行读取，然后用 strtok 或者自己写解析函数把字段拆开。注意，CAPL 的字符串处理能力有限，复杂解析建议在外部用 Python 做。

4.3 系统函数库调用：站在巨人的肩膀上

CAPL 自带了很多系统函数，覆盖了时间、数学、字符串、系统信息等方方面面。用好它们，能省下大量造轮子的时间。

4.3.1 常用系统函数一览

类别	函数名	功能说明
时间	`timeNow()`	获取当前系统时间（秒）
时间	`timeNowNS()`	获取纳秒级时间戳，用于高精度测量
数学	`abs()`, `sqrt()`, `sin()`	标准数学运算
字符串	`strlen()`, `strcmp()`, `strncpy()`	字符串长度、比较、复制
系统	`getLocalTimeString()`	获取格式化的本地时间字符串
系统	`setTimer()`	设置定时器，用于周期性任务

举个例子，我经常用 timeNowNS() 来测量总线响应时间。在发送报文前记一个时间戳，收到响应后再记一个，差值就是延迟。

int64 startTime, endTime;
startTime = timeNowNS();
// 发送请求报文
// ... 等待响应
endTime = timeNowNS();
write("响应延迟: %lld 纳秒", endTime - startTime);

4.3.2 调用外部 DLL

CAPL 还能调用 Windows 的 DLL 函数。这个功能很强大，但也很危险。我一般只在需要跟硬件驱动交互时才用。

// 声明外部函数
dll void MyExternalFunc(int param);

// 在事件中调用
on start {
    MyExternalFunc(42);
}

注意： 调用 DLL 时，参数类型和返回值类型必须严格匹配。我曾经因为传了一个 int 而 DLL 期望的是 long，导致程序直接崩溃。调试了半天才发现。

4.4 CAPL 与 Panel 交互：让测试界面活起来

Panel 是 CANoe 里的图形界面。你可以在上面放按钮、滑块、仪表盘，然后通过 CAPL 代码控制它们。说白了，就是给测试脚本加个可视化外壳。

4.4.1 从 Panel 读取控件值

最常用的交互方式，就是用户在 Panel 上点个按钮，或者调个滑块，CAPL 这边立刻响应。

// 在 Panel 上放了一个滑块，名字叫 "SpeedSlider"
// 在 CAPL 中读取它的值
on sysvar_update sysvar::Panel::SpeedSlider {
    float speed = @this;
    write("当前速度设定值: %.1f km/h", speed);
    // 根据速度值发送对应的 CAN 报文
}

4.4.2 用 CAPL 更新 Panel 显示

反过来，你也可以在 CAPL 里修改 Panel 上的控件。比如把测试结果实时显示在 Panel 的文本框里。

// 更新 Panel 上的文本显示
void UpdateResultDisplay(byte result) {
    if (result == 1) {
        sysvar::Panel::ResultText = "PASS";
    } else {
        sysvar::Panel::ResultText = "FAIL";
    }
}

我的经验： 在 Panel 上放一个“开始测试”按钮，一个“停止测试”按钮，再加一个状态指示灯。这样测试人员不用看代码，点几下鼠标就能跑完整套流程。我在上一个项目里就是这么做的，客户非常满意。

4.5 本章知识体系总览

下面这张图，把本章的核心知识点串了起来。你可以把它当作一张地图，随时回来对照。

好了，这一章的内容就到这里。数组和结构体帮你把数据管好，文件 I/O 让结果有地方去，系统函数库让你少写代码，Panel 交互让测试变得直观。这些东西组合起来，你就能搭建出一个像模像样的自动化测试框架了。