77 lines
2.2 KiB
Markdown
77 lines
2.2 KiB
Markdown
# 接口与数据格式
|
||
|
||
## `IDigitizer`
|
||
|
||
| 成员 | 作用 | 前置条件 |
|
||
|---|---|---|
|
||
| `EnumerateDevicesAsync` | 枚举逻辑设备并读取物理 ID/型号 | 厂商运行库与驱动可用 |
|
||
| `OpenAsync` | 按 `DeviceInfo.LogicalId` 创建设备句柄 | 未打开或已关闭 |
|
||
| `ConfigureAsync` | 校验并写入 AD 参数 | 已打开、未采集 |
|
||
| `StartAcquisitionAsync` | 启动、软件触发并持续返回采样块 | 已打开且已配置 |
|
||
| `StopAsync` | 停止 AD 并释放 AD 资源 | 可重复调用 |
|
||
| `CloseAsync` | 先停止，再释放设备句柄 | 可重复调用 |
|
||
|
||
`Pcie8586Digitizer` 用于真卡；`SimulatedDigitizer` 用于无硬件开发和主项目数据链测试。
|
||
|
||
## 配置
|
||
|
||
```csharp
|
||
var config = new AcquisitionConfig(
|
||
ChannelCount: 4,
|
||
InputRange: InputRange.PlusMinus5V,
|
||
ClockDivider: 100,
|
||
Mode: AcquisitionMode.Continuous,
|
||
FiniteSamplesPerChannel: 10_000);
|
||
```
|
||
|
||
此配置启用 CH0–CH3，量程 ±5 V，采样率 1 MS/s。
|
||
|
||
## `SampleBlock`
|
||
|
||
```text
|
||
Channels[channel][sample] double，单位 V
|
||
SampleRateHz 每通道采样率
|
||
StartSampleIndex 此块首点在当前采集任务中的序号
|
||
Timestamp 软件生成块时的本机时间
|
||
ChannelCount 通道数
|
||
SamplesPerChannel 每通道点数
|
||
```
|
||
|
||
原始 DMA word 必须先截断到通道数的整数倍，再解交错。不能把返回的 word 数当作每通道点数。
|
||
|
||
## 文件输出
|
||
|
||
`WaveformWriter` 输出：
|
||
|
||
- `.bin`：小端 `float32`，按采样点交错。
|
||
- `.json`：通道数、采样率、量程、每通道点数、布局、单位和时间。
|
||
|
||
Python 读取示例：
|
||
|
||
```python
|
||
data = np.fromfile(path, dtype="<f4").reshape(-1, channel_count).T
|
||
```
|
||
|
||
结果形状为 `[通道][采样点]`。
|
||
|
||
## 资源生命周期示例
|
||
|
||
完整可运行版本见 `examples/ConsoleIntegration/Program.cs`。生产代码的核心要求是：
|
||
|
||
```csharp
|
||
try
|
||
{
|
||
await digitizer.OpenAsync(device, token);
|
||
await digitizer.ConfigureAsync(config, token);
|
||
await foreach (var block in digitizer.StartAcquisitionAsync(token))
|
||
{
|
||
await pipeline.WriteAsync(block, token);
|
||
}
|
||
}
|
||
finally
|
||
{
|
||
await digitizer.StopAsync();
|
||
await digitizer.CloseAsync();
|
||
}
|
||
```
|