Imported from JXISH/SeeSharp-Academy (Seesharp Academy/Courses/0.5.0 AI Skills/Module Skills/DAQ/JY5113-driver/SKILL.md). Install upstream with npx skills add JXISH/SeeSharp-Academy --skill JY5113-driver. Copyright stays with the author.

JY5113 驱动开发指引

环境要求

• 驱动 DLL：C:\SeeSharp\JYTEK\Hardware\DAQ\JY5113\Bin\JY5113.dll（引用到 .csproj）
• XML 文档：C:\SeeSharp\JYTEK\Hardware\DAQ\JY5113\Bin\JY5113.xml（IntelliSense 支持）
• 目标框架：.NET Framework 4.x（x64 或 AnyCPU）
• 命名空间：using JY5113;
• 辅助组件：SeeSharpTools.JY.DSP.Fundamental（波形生成）、SeeSharpTools.JY.GUI（EasyChartX 波形控件）
• 板卡编号：通过 JYTEK 设备管理器查看的槽位号（Slot Number），如 0、1 等
• 范例工程：D:\JYTEK_Work\Examples\C#\DAQ\JY5113.Examples

硬件规格速查

产品型号

• PCIe-5113 / PXIe-5113：64-ch AI (16-bit, 1 MS/s)，4-ch AO，32 DIO，2 CTR，PCIe/PXIe 多功能 I/O 模块
• PCIe-5113s / PXIe-5113s：简化型，同系列规格（命名区分内部批次）

AIBandWidth 枚举值带下划线前缀：_39KHz / _15KHz / _80KHz。

通用编程范式

所有 Task 均遵循：创建 Task → 添加通道 → 配置参数 → Start() → 读/写数据 → Stop() → Channels.Clear()

var task = new JY5113AITask(0);                                 // 1. 按槽位号创建
task.AddChannel(0, -10, 10, AITerminal.RSE, AIBandWidth._80KHz); // 2. 添加通道（必须指定终端+带宽）
task.Mode = AIMode.Continuous;                                   // 3. 配置
task.SampleRate = 10000;
task.Start();                                                    // 4. 启动
// ... 读取数据 ...
task.Stop();                                                     // 5. 停止
task.Channels.Clear();                                           // 6. 清除通道

异常处理：始终捕获 JYDriverException（驱动层）和 Exception（系统层）。

模拟输入（AI）

任务类：JY5113AITask

关键属性

AddChannel 重载

// 单通道
aiTask.AddChannel(int chnId, double rangeLow, double rangeHigh, AITerminal terminal, AIBandWidth bandwidth);

// 多通道（相同量程）
aiTask.AddChannel(int[] chnsId, double rangeLow, double rangeHigh, AITerminal terminal, AIBandWidth bandwidth);

// 多通道（各自量程）
aiTask.AddChannel(int[] chnsId, double[] rangeLow, double[] rangeHigh, AITerminal terminal, AIBandWidth bandwidth);

// chnId = -1 → 添加全部通道
// rangeLow: -10 / -5 / -2.5    rangeHigh: 10 / 5 / 2.5
// AITerminal.RSE → 通道编号 0~63；AITerminal.Differential → 通道编号 0~31

AITerminal 枚举

JY5113 仅提供 RSE 与 Differential。

AIBandWidth 枚举

读取数据重载

// Single 模式
aiTask.ReadSinglePoint(ref double readValue, int channel);
aiTask.ReadSinglePoint(ref double[] readValue);      // 读所有通道

// Finite/Continuous — 单通道
aiTask.ReadData(ref double[] buf, int samplesPerChannel, int timeout);

// Finite/Continuous — 多通道（列存储，每列一个通道）
aiTask.ReadData(ref double[,] buf, int samplesPerChannel, int timeout);

// timeout = -1 → 永久等待

AI 四种模式速查

连续采集 Timer 模式（最常用）

timer.Enabled = false;
if (aiTask.AvailableSamples >= (ulong)readBuffer.Length)
{
    aiTask.ReadData(ref readBuffer, readBuffer.Length, -1);
    easyChartX1.Plot(readBuffer);
}
timer.Enabled = true;

数字触发配置

aiTask.Trigger.Type = AITriggerType.Digital;
aiTask.Trigger.Digital.Source = AIDigitalTriggerSource.PFI0;   // PFI0~PFI15 / PXI_Trig0~7
aiTask.Trigger.Digital.Edge = AIDigitalTriggerEdge.Rising;     // Rising / Falling

模拟触发配置

aiTask.Trigger.Type = AITriggerType.Analog;
aiTask.Trigger.Analog.Source = AIAnalogTriggerSource.Channel_0;   // Channel_0 ~ Channel_63
aiTask.Trigger.Analog.Comparator = AIAnalogTriggerComparator.Edge; // Edge / Hysteresis / Window
aiTask.Trigger.Analog.Edge.Slope = AIAnalogTriggerEdge.Rising;
aiTask.Trigger.Analog.Edge.Threshold = 2.5;

软触发配置

aiTask.Trigger.Type = AITriggerType.Soft;
aiTask.Start();
aiTask.SendSoftwareTrigger();

外部时钟配置

aiTask.SampleClock.Source = AISampleClockSource.External;
aiTask.SampleClock.External.Terminal = ClockTerminal.PFI0;
aiTask.SampleClock.External.ExpectedRate = 10000;

多卡同步

JY5113 支持多卡采样时钟 + 触发总线同步，信号通过 PXI_Trig0~7 在背板传递。

AI 多卡连续同步采集

// ===== 主卡配置（Slot 2）=====
var masterTask = new JY5113AITask(2);
masterTask.AddChannel(0, -10, 10, AITerminal.RSE, AIBandWidth._80KHz);
masterTask.Mode = AIMode.Continuous;
masterTask.SampleRate = 10000;
masterTask.Trigger.Type = AITriggerType.Immediate;
masterTask.Trigger.Mode = AITriggerMode.Start;

// 导出采样时钟 + 启动触发
masterTask.SignalExport.Add(AISignalExportSource.SampleClock, SignalExportDestination.PXI_Trig0);
masterTask.SignalExport.Add(AISignalExportSource.StartTrig,   SignalExportDestination.PXI_Trig1);

// ===== 从卡配置（Slot 4）=====
var slaveTask = new JY5113AITask(4);
slaveTask.AddChannel(0, -10, 10, AITerminal.RSE, AIBandWidth._80KHz);
slaveTask.Mode = AIMode.Continuous;

// 使用外部时钟（接收主卡的 PXI_Trig0）
slaveTask.SampleClock.Source = AISampleClockSource.External;
slaveTask.SampleClock.External.Terminal = ClockTerminal.PXI_Trig0;
slaveTask.SampleClock.External.ExpectedRate = 10000;

// 接收主卡的启动触发
slaveTask.Trigger.Type = AITriggerType.Digital;
slaveTask.Trigger.Mode = AITriggerMode.Start;
slaveTask.Trigger.Digital.Source = AIDigitalTriggerSource.PXI_Trig1;

// ===== 启动顺序：先启动从卡，再启动主卡 =====
slaveTask.Start();
masterTask.Start();

AI Reference 触发（预触发）多卡同步

masterTask.Trigger.Mode = AITriggerMode.Reference;
masterTask.Trigger.PreTriggerSamples = 1000;   // 必须 ≤ SamplesToAcquire
masterTask.Trigger.Type = AITriggerType.Digital;
masterTask.Trigger.Digital.Source = AIDigitalTriggerSource.PFI0;
masterTask.Trigger.Digital.Edge = AIDigitalTriggerEdge.Rising;

// 主卡通过 PXI_Trig1 把自身 ReferenceTrig 导出给从卡
masterTask.SignalExport.Add(AISignalExportSource.ReferenceTrig, SignalExportDestination.PXI_Trig1);

启动顺序：先从卡后主卡；关闭顺序反之（先主后从）。 SignalExport.Add(...) 可重复调用以导出多个信号。

模拟输出（AO）

任务类：JY5113AOTask

关键属性

AddChannel 方法

void AddChannel(int chnId)        // 通道 0~3，输出量程固定 ±10V
void AddChannel(int[] chnsId)
// chnId = -1 → 添加全部 4 通道

注：JY5113 AO AddChannel 不传量程参数（硬件固定 ±10V 单端输出）。

写入数据

// Single 模式
aoTask.WriteSinglePoint(double writeValue, int channel);
aoTask.WriteSinglePoint(double[] writeValue);     // 所有通道同时写

// Continuous/Finite — 多通道（列存储）
aoTask.WriteData(double[,] buf, int timeout);

// Continuous/Finite — 单通道
aoTask.WriteData(double[] buf, int timeout);

AO 连续环形输出标准流程

aoTask = new JY5113AOTask(0);
aoTask.AddChannel(0);                             // ±10V 固定量程
aoTask.Mode = AOMode.ContinuousWrapping;
aoTask.UpdateRate = 10000;

// 生成波形数据
double[] writeBuf = new double[1000];
for (int i = 0; i < 1000; i++)
    writeBuf[i] = 5.0 * Math.Sin(2 * Math.PI * i / 1000);

// 先写数据再 Start（Wrapping 模式要求）
aoTask.WriteData(writeBuf, -1);
aoTask.Start();

AOMode 枚举

AOTriggerType 枚举

数字输入（DI）

任务类：JY5113DITask

JY5113 DI/DO 采用 按 line 操作。最多 16 条可硬件定时数字线。

关键属性

AddChannel 方法

void AddChannel(int lineId)         // 添加单条数字线
void AddChannel(int[] lineIds)
// lineId = -1 → 添加全部 16 线

读取数据

// Single — 读取指定 line
bool readValue = false;
diTask.ReadSinglePoint(ref readValue, lineId);

// Single — 读取所有已添加 line
bool[] readValues = new bool[16];
diTask.ReadSinglePoint(ref readValues);

// Finite / Continuous
diTask.ReadData(ref short[] buf, uint samplesPerChannel, int timeout);
diTask.ReadData(ref byte[]  buf, uint samplesPerChannel, int timeout);
diTask.ReadData(ref byte[,] buf, uint samplesPerChannel, int timeout);   // 多通道（列存储）

数字输出（DO）

任务类：JY5113DOTask

关键属性

AddChannel 方法

void AddChannel(int lineId)
void AddChannel(int[] lineIds)
// lineId = -1 → 添加全部 16 线

写入数据

// Single
doTask.WriteSinglePoint(bool value, int lineId);
doTask.WriteSinglePoint(bool[] values);       // 写所有已添加 line

// Finite / Continuous
doTask.WriteData(ushort[] buf, uint samplesPerChannel, int timeout);
doTask.WriteData(byte[]  buf, uint samplesPerChannel, int timeout);
doTask.WriteData(byte[,] buf, uint samplesPerChannel, int timeout);   // 多通道

计数器输入（CI）

任务类：JY5113CITask

构造：new JY5113CITask(int slotNumber, int counterId) — counterId 取 0 或 1（共 2 个 32 位计数器）。

CI 测量类型

关键属性（按测量类型选择相应子对象）

ciTask.Mode = CIMode.Single;         // Single / Finite / Continuous
ciTask.Type = CIType.EdgeCounting;

// 边沿计数专用
ciTask.EdgeCounting.Direction      = CountDirection.Up;       // Up / Down / External
ciTask.EdgeCounting.InitialCount   = 0;
ciTask.EdgeCounting.OutEvent.Threshold = 100;                 // 达到阈值输出信号
ciTask.EdgeCounting.OutEvent.IdleState = EdgeCntOunEvtIdleState.LowLevel;
ciTask.EdgeCounting.Pause.ActivePolarity = LevelPolarity.HighLevel;
ciTask.EdgeCounting.Pause.Terminal       = InputTerminal.PFI0;

读取方法

// EdgeCounting / QuadEncoder / TwoPulseEncoder
void ReadSinglePoint(ref uint count);
void ReadSinglePoint(ref int  count);
void ReadSinglePoint(ref uint[]   count, int samplesToRead, int timeout);
void ReadSinglePoint(ref uint[,]  count, int samplesToRead, int timeout);

// Frequency / Period / SemiPeriod
void ReadSinglePoint(ref double measurement, int timeout);
void ReadSinglePoint(ref double[]  m, int samplesToRead, int timeout);
void ReadSinglePoint(ref double[,] m, int samplesToRead, int timeout);

// Pulse / TwoEdgeSeparation
void ReadSinglePoint(ref double m1, ref double m2, int timeout);
void ReadSinglePoint(ref double[]  m1, ref double[]  m2, int samplesToRead, int timeout);
void ReadSinglePoint(ref double[,] m1, ref double[,] m2, int samplesToRead, int timeout);

计数器输出（CO）

任务类：JY5113COTask

构造：new JY5113COTask(int slotNumber, int counterId) — counterId 取 0 或 1。

coTask = new JY5113COTask(0, 0);
coTask.Mode         = COMode.Single;
coTask.IdleState    = COIdleState.LowLevel;
coTask.InitialDelay = 0;

// 输出频率 1 kHz、占空比 50%、共 100 个脉冲
var pulse = new COPulse(COPulseType.DutyCycleFrequency, 1000.0, 0.5, 100);
coTask.WriteSinglePoint(pulse);
coTask.Start();
coTask.WaitUntilDone(-1);
coTask.Stop();

COPulseType 三种构造方式

count = -1 表示无限循环输出。

COIdleState 枚举

录制模式（Record）

将 AI 数据流式写入文件，支持边录边预览：

aiTask = new JY5113AITask(0);
aiTask.AddChannel(0, -10, 10, AITerminal.RSE, AIBandWidth._80KHz);
aiTask.Mode = AIMode.Record;
aiTask.SampleRate = 500000;

aiTask.Record.FilePath   = @"C:\Data\signal.bin";
aiTask.Record.FileFormat = FileFormat.Bin;            // 仅支持 Bin
aiTask.Record.Mode       = RecordMode.Finite;         // Finite / Infinite
aiTask.Record.Length     = 10.0;                      // 录制时长（秒），Finite 有效

aiTask.Start();

// 预览
double[,] preview = new double[1000, 1];
aiTask.GetRecordPreviewData(ref preview, 1000, -1);
easyChartX1.Plot(preview);

// 等待录制完成
double recordedLen; bool recordDone;
do { aiTask.GetRecordStatus(out recordedLen, out recordDone); } while (!recordDone);

aiTask.Stop();
aiTask.Channels.Clear();

AIRecord 配置属性

常见错误处理

完整 API 参考

命名空间与引用

using JY5113;
// DLL：C:\SeeSharp\JYTEK\Hardware\DAQ\JY5113\Bin\JY5113.dll

JY5113AITask — 模拟输入任务

构造函数

new JY5113AITask(int slotNumber)
new JY5113AITask(string deviceName, int slotNumber)    // 指定设备名

主要属性

方法

// 添加通道（必须指定 AITerminal + AIBandWidth）
void AddChannel(int chnId,    double rangeLow,  double rangeHigh, AITerminal terminal, AIBandWidth bandwidth);
void AddChannel(int[] chnsId, double rangeLow,  double rangeHigh, AITerminal terminal, AIBandWidth bandwidth);
void AddChannel(int[] chnsId, double[] rangeLow, double[] rangeHigh, AITerminal terminal, AIBandWidth bandwidth);

// 控制
void Start();
void Stop();
void WaitUntilDone(int timeout);          // 仅 Finite 有效
void SendSoftwareTrigger();

// 读取数据
void ReadSinglePoint(ref double readValue, int channel);
void ReadSinglePoint(ref double[] readValues);
void ReadData(ref double[]  buf, int samplesPerChannel, int timeout);
void ReadData(ref double[,] buf, int samplesPerChannel, int timeout);

// 录制模式
void GetRecordPreviewData(ref double[]  buf, int samplesPerChannel, int timeout);
void GetRecordPreviewData(ref double[,] buf, int samplesPerChannel, int timeout);
void GetRecordStatus(out double recordedLength, out bool recordDone);

AIMode 枚举

AITriggerType 枚举

AITriggerMode 枚举

AITrigger 主要属性

数字触发

aiTask.Trigger.Digital.Source = AIDigitalTriggerSource.PFI0;   // PFI0~PFI15、PXI_Trig0~7
aiTask.Trigger.Digital.Edge   = AIDigitalTriggerEdge.Rising;   // Rising / Falling

模拟触发

aiTask.Trigger.Analog.Source     = AIAnalogTriggerSource.Channel_0;         // Channel_0 ~ Channel_63
aiTask.Trigger.Analog.Comparator = AIAnalogTriggerComparator.Edge;          // Edge / Hysteresis / Window

// Edge 模式
aiTask.Trigger.Analog.Edge.Slope     = AIAnalogTriggerEdge.Rising;
aiTask.Trigger.Analog.Edge.Threshold = 2.5;

// Hysteresis 模式
aiTask.Trigger.Analog.Hysteresis.Slope         = AIAnalogTriggerEdge.Rising;
aiTask.Trigger.Analog.Hysteresis.HighThreshold = 3.0;
aiTask.Trigger.Analog.Hysteresis.LowThreshold  = 1.0;

// Window 模式
aiTask.Trigger.Analog.Window.Condition     = AIAnalogWindowCondition.Entering;   // Entering / Leaving
aiTask.Trigger.Analog.Window.HighThreshold = 5.0;
aiTask.Trigger.Analog.Window.LowThreshold  = -5.0;

ClockTerminal 枚举（节选）

SignalExportDestination 枚举（节选）

AISignalExportSource 枚举

AIRecord 属性

JY5113AOTask — 模拟输出任务

构造与属性

new JY5113AOTask(int slotNumber)
new JY5113AOTask(string deviceName, int slotNumber)

方法

void AddChannel(int chnId);            // 0~3；-1=全部
void AddChannel(int[] chnsId);

void Start();  void Stop();
void WaitUntilDone(int timeout);

// Single
void WriteSinglePoint(double value, int channel);
void WriteSinglePoint(double[] values);

// Continuous / Finite
void WriteData(double[]  buf, int timeout);
void WriteData(double[,] buf, int timeout);

JY5113DITask — 数字输入任务

new JY5113DITask(int slotNumber)

void AddChannel(int lineId);           // -1 添加全部 16 线
void AddChannel(int[] lineIds);

void Start();  void Stop();

// Single
void ReadSinglePoint(ref bool readValue, int lineId);
void ReadSinglePoint(ref bool[] readValues);

// Finite / Continuous
void ReadData(ref short[] buf, uint samplesPerChannel, int timeout);
void ReadData(ref byte[]  buf, uint samplesPerChannel, int timeout);
void ReadData(ref byte[,] buf, uint samplesPerChannel, int timeout);

DIMode 枚举

JY5113DOTask — 数字输出任务

new JY5113DOTask(int slotNumber)

void AddChannel(int lineId);
void AddChannel(int[] lineIds);

void Start();  void Stop();  void WaitUntilDone(int timeout);

// Single
void WriteSinglePoint(bool value, int lineId);
void WriteSinglePoint(bool[] values);

// Continuous / Finite
void WriteData(ushort[] buf, uint samplesPerChannel, int timeout);
void WriteData(byte[]   buf, uint samplesPerChannel, int timeout);
void WriteData(byte[,]  buf, uint samplesPerChannel, int timeout);

DOMode 枚举

JY5113CITask — 计数器输入任务

new JY5113CITask(int slotNumber, int counterId)      // counterId: 0 或 1
new JY5113CITask(string deviceName, int counterId)

主要属性

EdgeCounting 子对象字段

ciTask.EdgeCounting.Direction         // CountDirection.Up / Down / External
ciTask.EdgeCounting.InitialCount
ciTask.EdgeCounting.OutEvent.Threshold
ciTask.EdgeCounting.OutEvent.IdleState   // EdgeCntOunEvtIdleState.LowLevel / HighLevel
ciTask.EdgeCounting.Pause.ActivePolarity // LevelPolarity.HighLevel / LowLevel / None
ciTask.EdgeCounting.Pause.Terminal       // InputTerminal.PFI0 ~ PFI15 / PXI_Trig0~7

读取重载

void ReadSinglePoint(ref uint count);
void ReadSinglePoint(ref int  count);
void ReadSinglePoint(ref uint[]  count, int samplesToRead, int timeout);
void ReadSinglePoint(ref uint[,] count, int samplesToRead, int timeout);

void ReadSinglePoint(ref double m, int timeout);
void ReadSinglePoint(ref double[]  m, int samplesToRead, int timeout);
void ReadSinglePoint(ref double[,] m, int samplesToRead, int timeout);

void ReadSinglePoint(ref double m1, ref double m2, int timeout);
void ReadSinglePoint(ref double[]  m1, ref double[]  m2, int samplesToRead, int timeout);
void ReadSinglePoint(ref double[,] m1, ref double[,] m2, int samplesToRead, int timeout);

JY5113COTask — 计数器输出任务

new JY5113COTask(int slotNumber, int counterId)   // counterId: 0 或 1

COPulse 构造

new COPulse(COPulseType.DutyCycleFrequency, double freq, double dutyCycle, int count);
new COPulse(COPulseType.HighLowTime,        double highTime, double lowTime,   int count);
new COPulse(COPulseType.HighLowTick,        double highTick, double lowTick,   int count);
// count = -1 → 无限循环

方法

void WriteSinglePoint(COPulse pulse);
void Start();  void Stop();  void WaitUntilDone(int timeout);

异常类 JYDriverException

try { /* ... */ }
catch (JYDriverException ex)
{
    MessageBox.Show(ex.Message);    // ex.ErrorCode, ex.ExceptionName
}

常见枚举值：OpenDeviceFailed / NoChannelAdded / BufferDataOverflow / ReadDataTimeout / TaskHasStartedCannotPerformTheSetOperation / SampleRateParameterInvalid / ChannelInputRangeParameterInvalid / TriggerParameterInvalid / SignalExportDestinationInvalid。

完整代码示例

均来自 JY5113.Examples 工程，提取核心逻辑并加中文注释。

示例 1：AI 单点采集（Console）

using System;
using JY5113;

Console.WriteLine("请输入板卡槽位号：");
int boardNum = Convert.ToInt32(Console.ReadLine());
var aiTask = new JY5113AITask(boardNum);

aiTask.Mode = AIMode.Single;
Console.WriteLine("请输入通道号：");
int channelID = Convert.ToInt32(Console.ReadLine());
aiTask.AddChannel(channelID, -10, 10, AITerminal.RSE, AIBandWidth._80KHz);

aiTask.Start();

double readValue = 0;
int flag = 1;
while (flag == 1)
{
    aiTask.ReadSinglePoint(ref readValue, channelID);
    Console.WriteLine($"通道 {channelID} 电压: {readValue} V");
    Console.WriteLine("是否继续读取? (1:是, 0:否)");
    flag = Convert.ToInt16(Console.ReadLine());
}

aiTask.Stop();
aiTask.Channels.Clear();

示例 2：AI 连续采集（WinForm + Timer）

private JY5113AITask aiTask;
private double[] readBuffer;

private void button_start_Click(object sender, EventArgs e)
{
    try
    {
        aiTask = new JY5113AITask(0);
        aiTask.AddChannel(0, -10, 10, AITerminal.RSE, AIBandWidth._80KHz);
        aiTask.Mode       = AIMode.Continuous;
        aiTask.SampleRate = 10000;
        aiTask.Start();

        readBuffer = new double[1000];
        timer_FetchData.Enabled = true;
    }
    catch (JYDriverException ex) { MessageBox.Show(ex.Message); }
}

private void timer_FetchData_Tick(object sender, EventArgs e)
{
    timer_FetchData.Enabled = false;
    try
    {
        if (aiTask.AvailableSamples >= (ulong)readBuffer.Length)
        {
            aiTask.ReadData(ref readBuffer, readBuffer.Length, -1);
            easyChartX1.Plot(readBuffer);
        }
    }
    catch (JYDriverException ex) { MessageBox.Show(ex.Message); return; }
    timer_FetchData.Enabled = true;
}

private void button_stop_Click(object sender, EventArgs e)
{
    timer_FetchData.Enabled = false;
    if (aiTask != null) { aiTask.Stop(); aiTask.Channels.Clear(); }
}

示例 3：AI 有限多通道采集

aiTask = new JY5113AITask(0);
int[] channels = { 0, 1, 2 };
aiTask.AddChannel(channels, -10, 10, AITerminal.RSE, AIBandWidth._80KHz);

aiTask.Mode             = AIMode.Finite;
aiTask.SamplesToAcquire = 1000;
aiTask.SampleRate       = 10000;
aiTask.Start();

aiTask.WaitUntilDone(-1);
double[,] data = new double[1000, 3];
aiTask.ReadData(ref data, 1000, -1);
easyChartX1.Plot(data);

aiTask.Stop();
aiTask.Channels.Clear();

示例 4：AI 数字触发连续采集

aiTask = new JY5113AITask(0);
aiTask.AddChannel(0, -10, 10, AITerminal.RSE, AIBandWidth._80KHz);
aiTask.Mode       = AIMode.Continuous;
aiTask.SampleRate = 50000;

aiTask.Trigger.Type            = AITriggerType.Digital;
aiTask.Trigger.Digital.Source  = AIDigitalTriggerSource.PFI0;
aiTask.Trigger.Digital.Edge    = AIDigitalTriggerEdge.Rising;
aiTask.Start();

示例 5：AI 模拟触发采集

aiTask.Trigger.Type                  = AITriggerType.Analog;
aiTask.Trigger.Analog.Source         = AIAnalogTriggerSource.Channel_0;
aiTask.Trigger.Analog.Comparator     = AIAnalogTriggerComparator.Edge;
aiTask.Trigger.Analog.Edge.Slope     = AIAnalogTriggerEdge.Rising;
aiTask.Trigger.Analog.Edge.Threshold = 2.5;
aiTask.Start();

示例 6：AI 外部时钟采集

aiTask.SampleClock.Source                = AISampleClockSource.External;
aiTask.SampleClock.External.Terminal     = ClockTerminal.PFI0;
aiTask.SampleClock.External.ExpectedRate = 10000;
aiTask.Start();

示例 7：AI 多卡连续同步（主 / 从）

// 主卡 Slot 2
var masterTask = new JY5113AITask(2);
masterTask.AddChannel(0, -10, 10, AITerminal.RSE, AIBandWidth._80KHz);
masterTask.Mode = AIMode.Continuous;
masterTask.SampleRate = 10000;
masterTask.Trigger.Type = AITriggerType.Immediate;
masterTask.Trigger.Mode = AITriggerMode.Start;
masterTask.SignalExport.Add(AISignalExportSource.SampleClock, SignalExportDestination.PXI_Trig0);
masterTask.SignalExport.Add(AISignalExportSource.StartTrig,   SignalExportDestination.PXI_Trig1);

// 从卡 Slot 4
var slaveTask = new JY5113AITask(4);
slaveTask.AddChannel(0, -10, 10, AITerminal.RSE, AIBandWidth._80KHz);
slaveTask.Mode = AIMode.Continuous;
slaveTask.SampleClock.Source = AISampleClockSource.External;
slaveTask.SampleClock.External.Terminal     = ClockTerminal.PXI_Trig0;
slaveTask.SampleClock.External.ExpectedRate = 10000;
slaveTask.Trigger.Type = AITriggerType.Digital;
slaveTask.Trigger.Mode = AITriggerMode.Start;
slaveTask.Trigger.Digital.Source = AIDigitalTriggerSource.PXI_Trig1;

slaveTask.Start();   // 先从卡
masterTask.Start();  // 再主卡

示例 8：AO 单点输出

var aoTask = new JY5113AOTask(0);
aoTask.AddChannel(0);              // ±10V 固定量程
aoTask.Mode = AOMode.Single;
aoTask.Start();

aoTask.WriteSinglePoint(5.0, 0);
System.Threading.Thread.Sleep(1000);
aoTask.WriteSinglePoint(-5.0, 0);

aoTask.Stop();
aoTask.Channels.Clear();

示例 9：AO 连续环形输出（正弦波）

private JY5113AOTask aoTask;

private void button_start_Click(object sender, EventArgs e)
{
    aoTask = new JY5113AOTask(0);
    aoTask.AddChannel(0);
    aoTask.Mode       = AOMode.ContinuousWrapping;
    aoTask.UpdateRate = 10000;

    int samples = 10000;
    double[] buf = new double[samples];
    for (int i = 0; i < samples; i++)
        buf[i] = 5.0 * Math.Sin(2 * Math.PI * i / samples);

    aoTask.WriteData(buf, -1);    // Wrapping 模式：先写再 Start
    aoTask.Start();
}

private void button_stop_Click(object sender, EventArgs e)
{
    if (aoTask != null) { aoTask.Stop(); aoTask.Channels.Clear(); }
}

示例 10：DI 单点采集（按 line）

var diTask = new JY5113DITask(0);
diTask.AddChannel(-1);             // 添加全部 16 线
diTask.Mode = DIMode.Single;
diTask.Start();

bool[] readValues = new bool[16];
diTask.ReadSinglePoint(ref readValues);
for (int i = 0; i < 16; i++)
    Console.WriteLine($"Line {i}: {readValues[i]}");

diTask.Stop();
diTask.Channels.Clear();

示例 11：DO 单点输出

var doTask = new JY5113DOTask(0);
doTask.AddChannel(-1);             // 全部 16 线
doTask.Mode = DOMode.Single;
doTask.Start();

bool[] writeValues = new bool[16];
for (int i = 0; i < 16; i++) writeValues[i] = (i % 2 == 0);
doTask.WriteSinglePoint(writeValues);

// 单条线更新
doTask.WriteSinglePoint(true, 3);

doTask.Stop();
doTask.Channels.Clear();

示例 12：CI 边沿计数

private JY5113CITask ciTask;

private void button_start_Click(object sender, EventArgs e)
{
    ciTask = new JY5113CITask(0, 0);    // 计数器 0
    ciTask.Mode = CIMode.Single;
    ciTask.Type = CIType.EdgeCounting;

    ciTask.EdgeCounting.Direction    = CountDirection.Up;
    ciTask.EdgeCounting.InitialCount = 0;
    ciTask.Start();

    timer_FetchData.Enabled = true;
}

private void timer_FetchData_Tick(object sender, EventArgs e)
{
    uint count = 0;
    ciTask.ReadSinglePoint(ref count);
    textBox_count.Text = count.ToString();
}

private void button_stop_Click(object sender, EventArgs e)
{
    timer_FetchData.Enabled = false;
    if (ciTask != null) ciTask.Stop();
}

示例 13：CI 频率测量

ciTask = new JY5113CITask(0, 0);
ciTask.Mode = CIMode.Single;
ciTask.Type = CIType.Frequency;
ciTask.Start();

double freq;
ciTask.ReadSinglePoint(ref freq, -1);
Console.WriteLine($"频率: {freq:F2} Hz");

ciTask.Stop();

示例 14：CO 脉冲输出

var coTask = new JY5113COTask(0, 0);       // 计数器 0
coTask.Mode         = COMode.Single;
coTask.IdleState    = COIdleState.LowLevel;
coTask.InitialDelay = 0;

// 1 kHz / 50% 占空比 / 100 个脉冲
var pulse = new COPulse(COPulseType.DutyCycleFrequency, 1000.0, 0.5, 100);
coTask.WriteSinglePoint(pulse);
coTask.Start();
coTask.WaitUntilDone(-1);
coTask.Stop();

示例 15：CO 连续脉冲输出

coTask = new JY5113COTask(0, 0);
coTask.Mode      = COMode.ContinuousWrapping;
coTask.IdleState = COIdleState.LowLevel;

var pulse = new COPulse(COPulseType.DutyCycleFrequency, 1000.0, 0.5, -1);  // 无限
coTask.WriteSinglePoint(pulse);
coTask.Start();

// 运行中更新参数
coTask.WriteSinglePoint(new COPulse(COPulseType.DutyCycleFrequency, 2000.0, 0.3, -1));

示例 16：Record 有限录制

aiTask = new JY5113AITask(0);
aiTask.AddChannel(0, -10, 10, AITerminal.RSE, AIBandWidth._80KHz);
aiTask.Mode       = AIMode.Record;
aiTask.SampleRate = 500000;

aiTask.Record.FilePath = @"C:\Data\record.bin";
aiTask.Record.Mode     = RecordMode.Finite;
aiTask.Record.Length   = 10.0;
aiTask.Start();

// 轮询录制状态 + 预览
double recordedLen; bool recordDone;
double[,] preview = new double[1000, 1];
do
{
    aiTask.GetRecordStatus(out recordedLen, out recordDone);
    if (aiTask.AvailableSamples >= 1000)
        aiTask.GetRecordPreviewData(ref preview, 1000, 1000);
} while (!recordDone);

aiTask.Stop();
aiTask.Channels.Clear();

示例 17：Record 无限录制

aiTask = new JY5113AITask(0);
for (int i = 0; i < 4; i++)
    aiTask.AddChannel(i, -10, 10, AITerminal.RSE, AIBandWidth._80KHz);

aiTask.Mode       = AIMode.Record;
aiTask.SampleRate = 500000;

aiTask.Record.FilePath = @"C:\Data\infinite.bin";
aiTask.Record.Mode     = RecordMode.Infinite;      // 手动 Stop 才会停止
aiTask.Start();

// 界面 Timer 持续预览
// button_Stop_Click 里调用 aiTask.Stop(); aiTask.Channels.Clear();

综合技巧

量程选择

// 选择略大于信号峰值的量程以提高精度
aiTask.AddChannel(0, -10,  10,  AITerminal.RSE,          AIBandWidth._80KHz);  // 大信号
aiTask.AddChannel(1, -2.5, 2.5, AITerminal.Differential, AIBandWidth._15KHz);  // 小信号 + 带宽限制降噪

多通道数据解析

double[,] buf = new double[1000, 3];  // 1000 点、3 通道
aiTask.ReadData(ref buf, 1000, -1);
double[] ch0 = new double[1000];
for (int i = 0; i < 1000; i++) ch0[i] = buf[i, 0];

窗体关闭资源释放

private void MainForm_FormClosing(object sender, FormClosingEventArgs e)
{
    try
    {
        if (timer_FetchData != null) timer_FetchData.Enabled = false;
        if (aiTask != null) { aiTask.Stop(); aiTask.Channels.Clear(); }
        if (aoTask != null) { aoTask.Stop(); aoTask.Channels.Clear(); }
        if (diTask != null) { diTask.Stop(); diTask.Channels.Clear(); }
        if (doTask != null) { doTask.Stop(); doTask.Channels.Clear(); }
        if (ciTask != null) ciTask.Stop();
        if (coTask != null) coTask.Stop();
    }
    catch (JYDriverException ex) { MessageBox.Show(ex.Message); }
}