第3章 CANoe工程创建

第三章 CANoe工程创建：新建工程、添加网络节点、配置总线参数

好，咱们正式开始动手了。

前两章聊了不少概念，你可能觉得有点虚。这一章，咱们直接打开CANoe，从零开始创建一个工程。我当年刚学的时候，对着软件界面愣了半天，不知道从哪下手。其实说白了，就三步：新建工程、加节点、配参数。走一遍，你就全明白了。

打开CANoe，你会看到一个启动界面。别被那些按钮吓到，咱们只关心一个——File → New。

点下去之后，会弹出一个对话框，让你选模板。我个人习惯选“CAN 500kBaud 1ch”这个模板。为什么？因为大部分车载网络，尤其是动力和车身系统，用的就是500k波特率。当然，如果你做的是LIN或者FlexRay，那就选对应的模板。但咱们从CAN开始，这个最通用。

小技巧： 我建议你给工程起个有意义的名字，比如“Demo_CAN_Project”。别用“test1”、“test2”这种，不然过两天你自己都分不清哪个是哪个。

新建完成后，你会看到CANoe的主界面。嗯，这里要注意，左边有个Simulation Setup窗口，右边是Measurement Setup。咱们先别管右边，重点在左边——这就是咱们搭网络的地方。

一个CAN网络，至少要有两个节点才能通信。你想想看，一个人自言自语那不叫网络。

在Simulation Setup窗口里，你会看到一个默认的总线（Bus）。右键点击总线，选择Insert Network Node。这时候会弹出一个对话框，让你给节点起名字。我一般叫“Node_1”、“Node_2”，简单明了。

加完节点后，你会发现每个节点下面还有几个子项：

我记得刚开始做项目时，有个同事把节点加上了，但忘了关联CAPL程序，结果仿真跑起来节点一动不动。他折腾了半天，最后发现是程序没挂上去。所以，加完节点后，记得右键点击节点的CAPL Program，选择Add，新建一个.can文件。哪怕里面暂时是空的，也得有这个文件。

  核心要点： 每个节点必须关联一个CAPL程序，否则它就是个“植物人”节点，不会发也不会收。

节点加好了，接下来就是让它们能“听懂”彼此的话。这就涉及到总线参数配置了。

双击Simulation Setup窗口里的总线（就是那条线），会弹出Bus Configuration对话框。这里有几个关键参数：

这里我要多说一句采样点。我曾经在一个项目里，因为采样点设成了50%，结果总线老是丢帧。查了两天，最后发现是采样点太靠前，信号还没稳定就采样了。后来改成87.5%，问题立刻消失。所以，采样点尽量靠后，这是经验之谈。

避坑指南： 我曾经遇到过，波特率设对了，但总线就是不通。后来发现是终端电阻没加。CAN总线两端必须各加一个120欧姆的电阻。在CANoe仿真里，你可以在总线配置里勾选“Termination”选项。别小看这个，少了它，信号反射会让你怀疑人生。

光说不练假把式。咱们现在就让Node_1发一条报文，Node_2收下来。

首先，在Node_1的CAPL程序里写一段发送代码：

on start
{
  message 0x100 msg;
  msg.dlc = 8;
  msg.byte(0) = 0xAA;
  msg.byte(1) = 0xBB;
  output(msg);
  write("Node_1 sent a message");
}

这段代码的意思是：仿真一开始，就发一条ID为0x100的报文，数据是0xAA和0xBB。

然后，在Node_2的CAPL程序里写接收代码：

on message 0x100
{
  write("Node_2 received: ID=0x%x, Data=0x%x 0x%x", this.id, this.byte(0), this.byte(1));
}

这段代码的意思是：只要收到ID为0x100的报文，就把ID和数据打印出来。

好，现在点击工具栏上的绿色三角（Start Simulation）。你会看到Write Window里打印出两行信息：一行是Node_1说“我发了”，一行是Node_2说“我收到了”。

嗯，到这里，你的第一个CAN网络就跑通了。是不是挺简单的？

你可能注意到了，咱们刚才直接写了报文ID和数据。但在实际项目中，没人这么干。为什么？因为一个项目里可能有几百条报文，每条报文里又有几十个信号。你靠脑子记？不现实。

所以，实际开发中会用DBC文件（CAN数据库文件）。它就像一本字典，定义了每条报文叫什么、ID是多少、每个信号在哪个字节、什么范围。

在CANoe里，你可以在Simulation Setup窗口的空白处右键，选择Insert CAN Database，然后加载你的.dbc文件。加载之后，节点就能直接通过信号名来读写数据，比如：

on message EngineData
{
  speed = this.Speed;  // Speed是DBC里定义的一个信号
}

我个人强烈建议，从一开始就养成用DBC的习惯。虽然咱们现在只是学习，但真实项目中，没有DBC你寸步难行。

进阶提示： 如果你手头没有现成的DBC文件，可以用CANoe自带的CANdb++工具自己创建一个。打开方式：Tools → CANdb++ Editor。在里面新建报文、新建信号，然后保存成.dbc文件。这个咱们后面章节会详细讲。

咱们这一章，从新建工程开始，到添加节点、配置总线参数，最后让两个节点成功通信。你想想看，其实核心就三件事：

下一章，咱们会深入CAPL语言本身，聊聊它的语法和事件模型。到时候你会发现，写CAPL其实跟写C语言差不多，但有几个坑，我当年踩过，得提前告诉你。

好了，去动手试试吧。有问题随时翻回来看看。