第一章：CANalyzer基础与CAPL概述

各位同学，欢迎来到《CANalyzer自动分析脚本编写实战》的第一课。我是你们的老朋友，一个在汽车电子行业摸爬滚打了十几年的工程师。今天咱们不聊虚的，直接上手，把CANalyzer这个工具和CAPL这门语言先摸个透。

1.1 CANalyzer工具界面介绍

第一次打开CANalyzer，你可能会觉得界面有点复杂。别慌，我刚开始用的时候也懵。说白了，它就是个专门看汽车网络数据的“示波器”，只不过功能强大得多。

咱们先看几个核心区域：

• Measurement Setup（测量设置）：这是你的工作台。所有的数据窗口、分析模块都从这里拖拽出来。我个人习惯把常用的几个窗口固定在这里，比如Trace窗口、Graphics窗口。
• Simulation Setup（仿真设置）：写CAPL脚本的地方。你在这里添加网络节点，每个节点可以挂载一个CAPL程序。
• Trace窗口：实时显示总线上的报文。你想想看，所有ECU在聊什么，这里一目了然。
• Graphics窗口：把信号画成曲线，看趋势用的。做标定或者分析抖动时，这个窗口特别好使。

嗯，这里要注意一点：千万别在没保存工程文件的情况下直接关掉CANalyzer。我曾经有一次调了一下午的脚本，结果软件崩了，全没了。从那以后，我养成了随手Ctrl+S的习惯。

1.2 CAPL语言概述

CAPL，全称是Communication Access Programming Language。名字挺长，但你别被吓到。它其实就是个事件驱动的C语言变种。

什么叫事件驱动？说白了就是：当某个事情发生时，执行某段代码。比如：

• 当收到ID为0x123的报文时，执行A函数
• 当定时器到时间了，执行B函数
• 当按键被按下时，执行C函数

这和咱们平时写单片机程序不太一样。单片机是主循环一直跑，而CAPL是“没事就歇着，有事才干活”。

我遇到过不少新手，上来就想写个while(1)循环。在CAPL里，这基本行不通。你得换个思路：把逻辑拆成一个个小事件。

特性	说明
语法风格	类似C语言，但简化了很多
变量类型	支持int、float、char，还有专用的message类型
事件类型	报文事件、定时器事件、按键事件、错误事件等
调试方式	用write()函数打印到Write窗口

1.3 第一个CAPL脚本：Hello World

光说不练假把式。咱们直接写个Hello World，感受一下CAPL的“味道”。

打开CANalyzer，在Simulation Setup里添加一个Network Node。双击节点，进入CAPL Browser。然后敲入下面的代码：

/* 第一个CAPL脚本：Hello World */
variables
{
  int counter = 0;  // 计数器，记录发送次数
}

on start
{
  write("Hello World! CAPL脚本已启动");
  write("当前时间: %d ms", timeNow());
}

on key 'a'
{
  counter++;
  write("按键 'a' 被按下，这是第 %d 次", counter);
}

on timer myTimer
{
  write("定时器到期，当前计数值: %d", counter);
}

on start
{
  setTimer(myTimer, 1000);  // 启动定时器，1秒后触发
}

这段代码干了三件事：

1. 程序启动时：打印Hello World，并启动一个1秒的定时器
2. 按下键盘'a'键时：计数器加1，并打印当前次数
3. 定时器到期时：打印当前计数值

你可能会问：为什么定时器只触发一次？因为CAPL的定时器默认是单次的。如果你想让它循环触发，得在定时器事件里重新setTimer。

我个人建议，刚开始学的时候，多写几个这样的小脚本。把on key、on timer、on message这几个事件都试一遍。等你熟悉了事件驱动的思路，后面写复杂脚本就顺了。

好了，第一章的内容就到这里。咱们把CANalyzer的界面认了个脸熟，也知道了CAPL是个事件驱动的语言，还亲手写了第一个Hello World脚本。下一章，我会带你深入报文事件，看看怎么抓取和分析总线上的数据。

记住：工具是死的，思路是活的。多动手，多踩坑，你也能成为CANalyzer高手。