Pico示波器触发设置API函数调用说明.docVIP

Pico示波器二次开发中关于触发设置的API函数介绍 虹科电子 Tom 2017/1/12 一、简单电平触发和简单边沿触发 使用到的API函数为PsX000SetSimpleTrigger; 简单触发的Direction包括两类：电平触发和边沿触发； 电平触发包括：Above（高于阈值），Below（低于阈值）； 边沿触发：Rising（上升沿电压穿过阈值），Falling（下降沿电压穿过阈值）Rising_OR_Falling（上升沿电压穿过阈值和下降沿电压穿过阈值时都触发）。 二、复杂触发 各个函数的作用简介： 1、SetTriggerChannelConditions： 设置示波器模拟输入通道，脉冲宽度限制器以及数字输入通道和外部触发输入端口（如果使用的示波器型号有的话）的触发条件。简单来说就是通过结构体来控制多个触发源是否使能或禁止，整个函数相当于简单触发里面enable这个参数。同时合理的搭配使用conditions这个数组和nConditions这个参 tTriggerConditions结构体 每个触发输入源有三种条件状态：True（真），False（假），DONT_CARE（忽略）。比如只使用A输入通道作为触发源，那么该结构体的第一个参数设置为True，其他都设置为DONT_CARE就行。并且需要修改SetTriggerChannelConditions这个函数的第三个参数nConditions为1。 需要使用外部触发，脉冲宽度触发或者数字输入触发的时候也需要将结构体里面相应的元素改为True。 图：使能输入通道A的触发，其他通道都“忽略”，nConditions应该设置为1 合理利用* conditions所指向的数组和nConditions这个参数创建通道之间的逻辑触发： 图：PicoScope6软件上面关于逻辑触发的设置 图：对于*conditions和nconditions这两个参数的解读 下面以只用A和B两个通道为例分别设置为不同的逻辑关系对应的数组元素和nConditions数值的设置进行介绍 PicoScope6软件默认是逻辑或的关系也就是，设置任何一个通道的触发条件，当其中一个通道的触发条件满足时，所有打开的通道都会开始采集。需要注意的是使用逻辑触发的时候需要给使用的通道都设置相应的阈值等，也就意味着SetTriggerChannelProperties函数里面涉及到的结构体以及nChannelProperties这两处也需要作相应的修改。 在程序中数字0对应的是DONT_CARE，1对应的是True，2对应的是False 2、SetTriggerChannelDirections 设置触发源的触发方向（更确切的说是设置触发源的触发形式），相当于简单触发函数里面Dircetions这个参数的作用。是设置除了脉冲宽度限制以及数字输入触发之外的其他所有触发源触发方向的函数 表：触发方向描述和使用的触发阈值 注：在理解上述表格中的触发方式时建议使用示波器标配的软件PicoScope6进行理解。 图：进入或者离开窗口触发的图形化解释 3、SetTriggerChannelProperties 这个函数的主要功能时设置触发的阈值，迟滞。其次也可以用于AUXOUT和自动触发的时间进行设置。 这个函数相当于简单触发函数里面autoTrigger_ms和threshold这两个参数完成的功能。 这个参数可以对模拟输入通道，外部触发输入，数字输入通道等触发源的阈值进行设置。 图：*channelProperties和nChannelProperties两个参数的解读 TRIGGER_CHANNEL_PROPERTIES structure 结构体里面的元素依次为上阈值，上阈值迟滞（与上阈值的的差距）——真正的上迟滞触发电压=thresholdUpper-thresholdUpperHysteresis，下阈值，下阈值迟滞（以上四个值都是ADC数值），通道，触发模式（电平触发和窗口触发两种模式窗口）； 重要： 需要注意的是：该函数给相应的通道设置阈值和迟滞，这些阈值和迟滞不仅可以用于水平触发和窗口触发，而且还可以作为脉冲宽度限制器和数字通道的触发阈值。 双阈值的使用：当使用电平触发和脉冲宽度触发的时候，一个阈值用于电平触发，另外一个阈值用于脉冲宽度限制器定位脉冲，并且两种触发用的阈值不能一样。对于窗口触发来说两个阈值分别定义了窗口的上下限，窗口触发和脉冲宽度限制器所用的阈值可以是同一个。至于哪个阈值用于电平或者窗口再或者是脉冲宽度限制器，是由触发方向决定的。触发方式和阈值设置好之后驱动会自己选择阈值。 图：A通道