2. 测试环境搭建：vsomeip库编译与安装、CAPL/TSCL脚本环境配置、Python vsomeip库安装、Wireshark SOME/IP插件配置

环境搭建这件事，说白了就是给后续的自动化测试铺路。我见过太多团队，代码写得漂亮，结果环境配了一周还没跑通第一个用例。嗯，咱们今天就把这条路铺扎实。

先看一张整体架构图，心里有个谱：

2.1 vsomeip 库编译与安装

vsomeip 是 GENIVI 开源的 C++ SOME/IP 实现。我个人习惯把它作为中间件层，因为它的协议栈完整，而且社区活跃。编译它其实不复杂，但有几个坑得提前说。

2.1.1 依赖准备

先确认系统里装了这些：

• CMake ≥ 3.10
• Boost ≥ 1.55（主要用 system、thread、filesystem）
• g++ 支持 C++11 及以上
• libtool、automake、pkg-config

2.1.2 编译步骤

我从 GitHub 拉代码，然后走标准 CMake 流程：

# 克隆仓库
git clone https://github.com/GENIVI/vsomeip.git
cd vsomeip

# 创建构建目录
mkdir build && cd build

# 配置
cmake -DCMAKE_INSTALL_PREFIX=/usr/local ..

# 编译（-j 根据你机器核数调整）
make -j4

# 安装
sudo make install

我曾经在编译时遇到 Boost 找不到的问题，后来发现是 Boost 版本太新，vsomeip 的 CMakeLists.txt 里查找路径没覆盖到。解决办法是手动指定：

cmake -DBoost_NO_BOOST_CMAKE=ON -DBoost_NO_SYSTEM_PATHS=OFF ..

2.1.3 验证安装

装完后，检查库文件是否到位：

ldconfig -p | grep vsomeip
# 应该看到 libvsomeip.so 和 libvsomeip3.so

再跑一下自带的示例：

cd examples
./someip-echo-service &
./someip-echo-client

如果看到 "Received: Hello World" 之类的输出，说明库没问题。

2.2 CAPL / TSCL 脚本环境配置

CAPL 是 Vector 家的脚本语言，跑在 CANoe 或 vTESTstudio 上。TSCL 是 vTESTstudio 的测试序列语言。说白了，它们就是汽车电子测试的"方言"。

2.2.1 环境要求

组件	版本建议	用途
CANoe	≥ 15.0	运行 CAPL 脚本，模拟网络节点
vTESTstudio	≥ 4.0	编写 TSCL 测试序列，生成测试报告
Vector License	需包含 SOME/IP 选项	解锁 SOME/IP 协议支持

2.2.2 CAPL 工程配置

在 CANoe 里新建工程后，需要做这几步：

1. 添加网络节点：在 Simulation Setup 里拖一个 Network Node，关联你的 .can 或 .arxml 文件。
2. 配置 SOME/IP 协议：在节点属性里勾选 "Support SOME/IP"，并指定 Service ID 和 Method ID。
3. 编写 CAPL 脚本：在节点的 Event Procedure 里写代码。

一个简单的 CAPL 示例，用于发送 SOME/IP 请求：

variables
{
  long gRequestId;
}

on start
{
  // 创建一个 SOME/IP 请求事件
  gRequestId = SomeIpCreateEvent("MyService", "MyMethod");
  // 设置 payload
  SomeIpSetValue(gRequestId, "data", 0x1234);
  // 发送
  SomeIpSendEvent(gRequestId);
}

on SomeIpResponse *
{
  write("收到响应: ID=%d", SomeIpGetValue(this, "data"));
}

2.2.3 TSCL 测试序列

vTESTstudio 里用 TSCL 写测试用例，结构更清晰。我习惯把每个测试步骤封装成一个函数：

testcase TC_SOMEIP_EchoTest()
{
  dword responseData;
  
  // 步骤1: 发送请求
  SomeIpSendRequest("EchoService", "EchoMethod", 0xAA);
  
  // 步骤2: 等待响应（超时500ms）
  if (SomeIpWaitForResponse("EchoService", "EchoMethod", 500) == TRUE)
  {
    responseData = SomeIpGetResponseData("EchoService", "EchoMethod");
    if (responseData == 0xAA)
    {
      testStepPass("Echo 测试通过");
    }
    else
    {
      testStepFail("数据不匹配: 期望0xAA, 实际0x%X", responseData);
    }
  }
  else
  {
    testStepFail("超时未收到响应");
  }
}

2.3 Python vsomeip 库安装

Python 做自动化测试，优势是灵活、生态好。vsomeip 官方提供了 Python 绑定，但需要自己编译。

2.3.1 编译 Python 绑定

在 vsomeip 源码目录里，有一个 python 子目录：

cd vsomeip/python
mkdir build && cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local ..
make -j4
sudo make install

装完后，验证一下：

python3 -c "import vsomeip; print(vsomeip.__version__)"

如果报错 ModuleNotFoundError，检查 Python 路径：

export PYTHONPATH=/usr/local/lib/python3.8/site-packages:$PYTHONPATH

2.3.2 快速测试脚本

写一个简单的 Python 脚本来验证通信：

import vsomeip
import time

def main():
    app = vsomeip.Application("PythonClient")
    app.init()
    
    # 注册服务发现
    app.register_service(0x1234, 0x5678)
    
    # 发送 SOME/IP 请求
    payload = vsomeip.Payload()
    payload.set_data(bytes([0x01, 0x02, 0x03]))
    
    request = vsomeip.Message()
    request.set_service(0x1234)
    request.set_method(0x0001)
    request.set_payload(payload)
    
    app.send(request)
    print("请求已发送")
    
    time.sleep(1)
    app.stop()

if __name__ == "__main__":
    main()

2.4 Wireshark SOME/IP 插件配置

Wireshark 默认不带 SOME/IP 解析器，得装插件。我个人觉得这是调试阶段最实用的工具，没有之一。

2.4.1 安装插件

Wireshark 从 3.2 版本开始，官方插件仓库里就有 SOME/IP 解析器。安装方式：

1. 打开 Wireshark，点击 Tools → Lua → Manage Lua Plugins
2. 点击 Open Lua Plugins Folder
3. 把下载的 someip.lua 和 someip-sd.lua 放进去
4. 重启 Wireshark

如果你用旧版本，可以从 GitHub 手动下载：

git clone https://github.com/nickel1109/wireshark-someip-plugin.git
cp *.lua ~/.local/lib/wireshark/plugins/

2.4.2 验证插件

抓包后，在协议列里看到 SOME/IP 或 SOME/IP-SD，说明插件生效了。点开一个报文，应该能解析出 Service ID、Method ID、Payload 等字段。

2.4.3 配置显示过滤

调试时常用的过滤表达式：

过滤表达式	作用
someip	显示所有 SOME/IP 报文
someip-sd	只显示服务发现报文
someip.service_id == 0x1234	过滤特定 Service ID
someip.method_id == 0x0001	过滤特定 Method ID
someip.payload contains aa:bb	查找包含特定数据的报文