4. CANoe TSN工程配置基础

在CANoe中搭建TSN测试工程，第一步不是写CAPL，也不是点“Start”，而是把“网络长什么样、谁在说话、走哪条通道、带什么标签”这四件事在Configuration里如实描述出来。CANoe的TSN能力建立在以太网仿真之上，因此工程配置的实质，是把一个真实的TSN网络映射成CANoe可识别、可调度、可观测的对象模型。本节围绕网络拓扑建模、节点配置、以太网通道参数、VLAN与优先级设置、CAPL节点挂载五件事展开，它们共同决定后续gPTP同步、流量调度和抓包分析能否成立。

一、网络拓扑建模：先画“物理连接”，再谈“逻辑通信”

在CANoe的Simulation Setup中，拓扑建模的最小单元是Network Node（节点）与Bus（总线/网段）。对TSN而言，通常至少需要三个对象：一个作为TSN Talker的端节点、一个作为Listener的端节点、以及一个或多个TSN Switch（桥）。Switch在CANoe中既可以由内置的以太网交换机模型承担，也可以用带多端口的仿真节点模拟。建模时要注意：每个物理端口对应一个独立的Ethernet Channel，端口之间的连线代表链路，而不是逻辑连接。若把两个Talker直接连到同一通道而不经过Switch，就无法验证TSN的队列调度与门控行为。

一个典型的教学拓扑可以这样组织：PC侧CANoe通过一个Ethernet Channel连接Switch的Port 1，Switch的Port 2接Talker节点，Port 3接Listener节点，Port 4可留作镜像或备用。这样在Trace窗口中，每个端口都能独立观察收发方向，便于后续判断报文是在入口被整形，还是在出口被门控。

二、节点配置：把“设备”变成“可仿真的对象”

拓扑画好后，每个Network Node需要绑定一个仿真节点或真实ECU。在CANoe中，节点配置的核心是“协议栈 + 通信参数 + 数据库”。对于TSN节点，协议栈至少包含Ethernet、VLAN、IP（可选）、UDP/TCP（按业务）以及gPTP。若节点需要参与时间同步，必须在节点属性中启用gPTP并指定其角色（Master/Slave/Boundary）。

节点配置中容易忽略的是MAC地址与VLAN成员关系。CANoe允许为每个节点指定固定MAC，也可以由系统自动分配。教学示例中，建议Talker使用02:00:00:00:00:01，Listener使用02:00:00:00:00:02，Switch各端口使用独立MAC。VLAN成员关系则决定该节点能收发哪些VLAN的帧，若Talker只加入VLAN 10，它发出的无标签帧会被Switch按PVID处理，这一点在排障时非常关键。

三、以太网通道参数：速率、双工与硬件映射

每个Ethernet Channel都有独立的参数集。在CANoe的Hardware配置中，需要把通道映射到实际的VN系列以太网接口或虚拟通道。关键参数包括：链路速率（100 Mbps / 1 Gbps）、双工模式、是否启用硬件时间戳、以及是否开启抓包缓存。TSN测试对时间戳精度敏感，若使用gPTP，应优先选择支持硬件时间戳的接口，并在通道属性中勾选“Hardware Timestamp”。

此外，通道的“发送模式”也影响测试：若选择“Simulated”，报文只在CANoe内部循环；若选择“Real”，则通过物理接口发出。做TSN门控验证时，通常需要真实链路，否则队列调度行为无法体现。建议在工程中为每个通道单独命名，例如ETH_Switch_Port2，便于在CAPL和Trace中引用。

四、VLAN与优先级设置：让帧“带标签说话”

TSN的调度基础是IEEE 802.1Q的VLAN Tag，其中PCP（Priority Code Point）3 bit决定优先级，VID（VLAN ID）12 bit决定广播域。在CANoe中，VLAN配置通常通过数据库（如ARXML或CANoe自带的Ethernet数据库）或节点属性完成。若没有数据库，也可以在CAPL中手工构造带Tag的帧。

教学示例中，可以定义两条业务流：控制流使用VLAN 10、PCP 6，视频流使用VLAN 20、PCP 4。Switch的出口队列按PCP映射到8个队列，PCP 6进入高优先级队列，PCP 4进入中优先级队列。这样在门控列表（Gate Control List）中，就可以为高优先级队列分配更长的开门时间。配置时要注意：PCP只在带Tag的帧中有效，若帧未打标签，Switch会使用端口的PVID和默认优先级。

五、CAPL节点挂载：把代码放到正确的“耳朵”上

CAPL程序不是挂在工程上，而是挂在具体的Network Node上。在Simulation Setup中双击节点，选择“CAPL Program”并关联.can文件。挂载后，该节点的on message、on timer、on key等事件才会被触发。对于TSN测试，常见的CAPL节点包括：Talker发送节点、Listener接收校验节点、以及gPTP监控节点。

挂载时要注意事件作用域：on message ETH.*只能收到本节点所在通道的帧；若需要跨通道观察，应使用on message *或通过Switch的镜像端口。此外，CAPL中访问VLAN字段可以使用this.vlan或直接操作ethernetPacket结构。一个常见的错误是：CAPL节点挂在了错误的通道上，导致发送的帧没有进入预期的VLAN，Trace中看不到Tag，误判为Switch配置问题。

六、配置完成后的自检清单

在点击Start之前，建议按以下顺序快速核对：拓扑中Switch是否显式存在；每个节点的MAC是否唯一；通道是否映射到正确的硬件接口；VLAN成员关系是否与业务流一致；PCP是否在数据库或CAPL中正确设置；CAPL节点是否挂在目标通道上。完成这些检查后，再启动测量，Trace窗口中应能看到带VLAN Tag的帧按预期周期出现，gPTP报文的时间戳也应稳定递增。若某条流缺失，优先检查该流所在节点的通道绑定和VLAN成员关系，而不是直接修改Switch门控参数。

本节配置是后续所有TSN测试的底座。拓扑、节点、通道、VLAN、CAPL五者之间是“物理承载—逻辑标识—代码触发”的递进关系，任何一层错位，都会让上层测试结果失去意义。