SSPC-Tester/Driver/PCIE8586/DriverIntegrationPackage/README.md

45 lines
2.1 KiB
Markdown
Raw Permalink Normal View History

# 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)。