# PCIe8586 驱动接入包

本目录用于整体复制到主项目。它来自已经通过调试工具测试的 PCIe8586 采集实现，包含可复用 C# 驱动层、采集支持代码、接入示例、AI 开发指导和厂商开发参考文件。

## 目录

```text
DriverIntegrationPackage/
├─ AI_INTEGRATION_GUIDE.md       AI/开发者实施接入时的主指导文档
├─ docs/
│  ├─ API_AND_DATA_FORMAT.md     接口、参数、采样数据和文件格式
│  ├─ DEPLOYMENT.md              驱动、DLL、位数和发布要求
│  └─ reference/                 厂商 PCIe8582/8584/8586 手册
├─ examples/ConsoleIntegration/  最小完整调用示例
├─ native/README.md              ACTS1000_64.dll 放置说明
├─ src/Pcie8586.Driver/          可直接 ProjectReference 的 .NET 类库
└─ vendor/
   ├─ include/ACTS1000.h         厂商 C 接口声明
   └─ lib/x64/ACTS1000_64.lib    原生 C/C++ x64 导入库
```

## 最快接入

1. 将整个目录复制进主项目仓库。
2. 主项目添加项目引用：

   ```xml
   <ProjectReference Include="相对路径\DriverIntegrationPackage\src\Pcie8586.Driver\Pcie8586.Driver.csproj" />
   ```

3. 主项目和最终进程必须为 `x64`，运行环境为 Windows。
4. 在目标机安装厂商 PCIe8586 驱动，并确保进程能加载 `ACTS1000_64.dll`。
5. 按 `examples/ConsoleIntegration/Program.cs` 的生命周期调用。

类库源码沿用已验证调试工具的命名空间 `Pcie8586Probe.*`，以保持代码与测试版本一致。主项目可以先原样接入，确认真卡采集后再统一重命名。

## 边界

- `ACTS1000_64.lib` 只供原生 C/C++ 链接，C# 项目不需要引用它。
- 仓库中没有厂商运行时 `ACTS1000_64.dll`，也没有 `.sys/.inf/.cat` 驱动安装文件，不能用本目录代替厂商驱动安装包。
- UI、ScottPlot 和 CommunityToolkit.Mvvm 没有进入接入包。
- 当前真卡配置使用板载时钟、内部时基、软件触发、DC 耦合和 1 MΩ 输入。

实施接入前请先阅读 [AI_INTEGRATION_GUIDE.md](AI_INTEGRATION_GUIDE.md)。