3. CAPL 基础语法：数据类型、变量、常量与运算符

各位工程师朋友，欢迎来到第三章。从这一章开始，我们正式进入 CAPL 的语法世界。

我个人觉得，学一门语言，最核心的就是搞懂两件事：数据长什么样，以及怎么操作这些数据。说白了，就是数据类型和运算符。CAPL 虽然是为 CAN 总线量身定做的，但它的语法基础跟 C 语言非常像。如果你有 C 语言基础，这一章会过得很快；如果没有，也别慌，跟着我一步步来。

3.1 数据类型：选对容器才能装对东西

CAPL 的数据类型，说白了就是给数据分门别类。你想想看，一个 CAN 报文里的信号，可能是 1 个字节的发动机转速，也可能是 4 个字节的车辆 VIN 码。不同的数据，就得用不同的类型来装。

我刚开始用 CAPL 时，犯过一个低级错误：用 byte 类型去存一个超过 255 的数值，结果数据直接溢出，排查了半天。嗯，这里要注意——选错类型，后果很严重。

3.1.1 整数类型

3.1.2 浮点类型

浮点数用来处理带小数点的数值，比如车速 12.5 km/h、电压 3.3 V。

3.2 变量声明与作用域

变量，就是用来存数据的容器。声明变量时，你得告诉 CAPL 三件事：类型、名字，以及在哪里能用（作用域）。

3.2.1 变量声明

语法很简单：类型 变量名;。也可以在声明时直接赋初值。

// 声明但不赋值
byte engineTemp;
word rpm;
int errorCount;

// 声明并赋初值
float voltage = 12.5;
long totalFrames = 0;
dword timestamp = 0x00000000;

3.2.2 作用域规则

CAPL 的变量作用域分三种：

• 全局变量：在所有函数外面声明，整个文件都能用。适合存系统状态、累计数据。
• 局部变量：在函数或事件处理程序内部声明，只有该函数能用。适合临时计算。
• 事件变量：在 on * 事件块内部声明，只在该事件触发时有效。

// 全局变量
byte g_systemState = 0;
long g_messageCount = 0;

on start
{
  // 局部变量
  int localCounter = 0;
  localCounter = 5;
  g_systemState = 1;  // 可以访问全局变量
}

on message 0x100
{
  // 事件变量
  word msgId = this.id;
  g_messageCount++;   // 全局变量累加
}

3.3 常量与枚举

常量就是固定不变的值。枚举则是一组有名字的整型常量，让代码更可读。

3.3.1 常量声明

用 const 关键字声明常量，一旦赋值就不能修改。

const byte MAX_RETRY = 3;
const word CAN_ID_ENGINE = 0x100;
const float PI = 3.14159;

3.3.2 枚举类型

枚举让代码更语义化。比如表示系统状态，用 0、1、2 不如用 IDLE、RUNNING、ERROR 直观。

enum SystemState
{
  IDLE = 0,
  RUNNING = 1,
  ERROR = 2,
  SLEEP = 3
};

// 使用枚举
SystemState currentState = IDLE;

on message 0x200
{
  if (currentState == RUNNING)
  {
    // 处理运行状态
  }
}

3.4 运算符

运算符就是用来操作数据的工具。CAPL 支持 5 类运算符，跟 C 语言几乎一样。

3.4.1 算术运算符

3.4.2 关系运算符

用来比较两个值，结果要么是 1（真），要么是 0（假）。

3.4.3 逻辑运算符

用于组合多个条件判断。

3.4.4 位运算符

位运算直接操作二进制位，在 CAN 信号解析中非常常用。

3.4.5 赋值运算符

除了基本的 =，CAPL 还支持复合赋值运算符，简化代码。

3.5 综合示例：一个简单的 CAN 报文计数器

把这一章的知识串起来，写一个实用的脚本：统计 CAN 总线上的报文数量，并区分不同 ID 的报文。

/* 全局变量与常量 */
const dword MONITOR_ID = 0x100;
long g_totalCount = 0;
word g_specificCount = 0;

/* 枚举：系统状态 */
enum MonitorState
{
  MONITOR_OFF = 0,
  MONITOR_ON = 1
};

MonitorState g_state = MONITOR_OFF;

on start
{
  g_state = MONITOR_ON;
  write("报文监控已启动");
}

on message *
{
  if (g_state == MONITOR_ON)
  {
    g_totalCount++;
    
    if (this.id == MONITOR_ID)
    {
      g_specificCount++;
    }
  }
}

on key 'r'
{
  write("总报文数: %ld", g_totalCount);
  write("特定ID(0x%X)报文数: %d", MONITOR_ID, g_specificCount);
}

on key 'c'
{
  g_totalCount = 0;
  g_specificCount = 0;
  write("计数器已清零");
}

3.6 本章小结

这一章的内容比较多，但都是基本功。我建议你动手敲一遍代码，把每个数据类型都声明一下，每个运算符都试一下。光看是记不住的，得亲手写。

记住几个关键点：

• 选数据类型时，先想清楚数值范围，别溢出
• 全局变量加 g_ 前缀，局部变量不加，一眼区分
• 常量和枚举让代码更可读，别偷懒
• 位运算是 CAN 信号解析的利器，多练练