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

45 lines
2.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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