# Windows 测试与 USB 抓包指南

## 1. 已安装的工具

| 工具 | 位置 | 用途 |
|---|---|---|
| USBPcap 1.5.4 | `C:\Program Files\USBPcap\` | USB 抓包驱动 + USBPcapCMD.exe |
| Wireshark 4.6.7 | `C:\Program Files\Wireshark\` | 查看 .pcap 抓包文件 |
| libusb-1.0 (x64) | `csdk\third_party\libusb\win64\` | 本地构建用(TI CCS 的 64 位 DLL + dlltool 生成的导入库) |
| MinGW gcc 14.2 | `C:\mingw64\bin\gcc.exe` | 编译 |

注意:USBPcap/Wireshark 安装后**需要重启**才能加载驱动。
本机当前没有 VID 0x833C 设备 —— 插入相机后按下面流程测试。

## 2. 构建（Windows 无 CMake 环境时用 MinGW 直接编）

```powershell
$lb = "C:\Project\MAG160C\csdk\third_party\libusb\win64"
$srcs = @(
  "csdk\src\mag160c_error.c","csdk\src\mag160c_frame.c",
  "csdk\src\mag160c_temp.c","csdk\src\mag160c_tcm.c",
  "csdk\src\mag160c_ir.c")
gcc -std=c11 -Icsdk\include -Icsdk\src -I$lb `
    -DMAG160C_STATIC -DMAG160C_HAS_LIBUSB=1 -DMAG160C_HAS_THREADS=1 `
    $srcs csdk\tools\mag160c_cli.c $lb\libusb-1.0.x64.a `
    -o build-artifacts\csdk_cli_libusb.exe -lpthread
Copy-Item $lb\libusb-1.0.dll build-artifacts\
```

或装 CMake 后: `cmake -B build -S csdk && cmake --build build`（会自动用 third_party 里的 libusb）。

## 3. 无硬件验证（纯计算 + 协议构造）

```powershell
.\build-artifacts\csdk_cli_libusb.exe tcm-rotate 5
# 7e 00 07 85 02 77 00 01 00 05 7f
.\build-artifacts\csdk_cli_libusb.exe tcm-light green blink
# 7e 00 09 87 02 32 00 01 01 00 ff 00 35
.\build-artifacts\csdk_cli_libusb.exe frame-test
.\build-artifacts\csdk_cli_libusb.exe temp-test
.\build-artifacts\csdk_cli_libusb.exe ir-info   # 应显示 "no device with VID 0x833c"
```

## 4. 有硬件验证

插入相机（VID 0x833C）后：

```powershell
# 确认系统看到设备
Get-PnpDevice -PresentOnly | Where-Object { $_.InstanceId -match "833C" }

# 枚举 + 信息
.\build-artifacts\csdk_cli_libusb.exe ir-info

# 触发 FFC（会真实发包）
.\build-artifacts\csdk_cli_libusb.exe ffc

# 启动流（帧回调打印）+ 停止
.\build-artifacts\csdk_cli_libusb.exe start
.\build-artifacts\csdk_cli_libusb.exe stop
```

预期:ir-info 显示 width=160 height=120;FFC 返回 OK;start 后 USBPcap
抓包应看到 EP 0x03 上 `6b b6 b6 72` 或 `6b b6 b6 73` 的 8 字节写、EP 0x82 的响应读、
EP 0x81 上 `1b b1 b1 1b` 开头的帧流。

## 5. USB 抓包（USBPcap + Wireshark）

USBPcap 需要管理员权限。列出捕获设备：

```powershell
# 管理员 PowerShell
& "C:\Program Files\USBPcap\USBPcapCMD.exe" -d
```

输出示例:
```
1. \\.\USBPcap1  USB Root Hub (xHCI)
2. \\.\USBPcap2  USB Root Hub (xHCI)
...
```

开始抓包（抓所有 USB 根集线器，输出 pcap 文件）:

```powershell
# 管理员 PowerShell，抓 30 秒（-A 30）
& "C:\Program Files\USBPcap\USBPcapCMD.exe" -d "\\.\USBPcap1" -o C:\captures\mag1.pcap -A 30
& "C:\Program Files\USBPcap\USBPcapCMD.exe" -d "\\.\USBPcap2" -o C:\captures\mag2.pcap -A 30
```

另开一个窗口跑 `csdk_cli_libusb.exe ffc` / `start`，让包被捕获。

在 Wireshark 中打开 pcap，过滤：
- 找到相机设备（右键设备名查看）
- 过滤 `usb.idVendor == 0x833c`
- 看 bulk OUT 到 0x03 的 8 字节包、bulk IN 0x82 的响应、0x81 的帧流

也可以用 Wireshark 图形界面直接选 USBPcap 接口开始抓（需要重启后驱动生效）。

## 6. 抓包结果对照（逆向验证清单）

| 包 | 期望 |
|---|---|
| 链接后第一个命令 | `6b b6 b6 6f 00 00 00 00` (GET_INFO) |
| FFC | `6b b6 b6 72 <param 4B>` |
| Start | 50ms 后 `6b b6 b6 73 00 00 00 00` |
| Stop | `6b b6 b6 74 00 00 00 00` |
| 响应 | `5b b5 b5 5b` + 0x38 字节(payload +0x10=width, +0x14=height) |
| 帧流 | `1b b1 b1 1b` ... 数据在 +0x1c ... `1c b1 b1 1b` |

如与期望不符，将 pcap 保存到 `analysis/captures/` 并记录差异，用于修正协议。

## 2026-08-10 Post-reboot verification (USBPcap live capture)

- After a system reboot the USBPcap filter driver binds to the root hubs.
  On this machine the MAG160C device appears on \\\\.\USBPcap4 (AMD xHCI).
  Capture with: USBPcapCMD -d \\.\USBPcap4 -o out.pcap -A -s 65535
- The csdk's own traffic (analysis/captures/csdk_verified.pcap) matches the
  official demo byte-for-byte at the sequence level:
  66b -> 66c -> 66f -> FFC(0) x2 -> START -> frames (15 fps) -> STOP.
- USBPcap capture replaces the libusb0.dll shim for routine sniffing.