当前位置 博文首页 > seabluescn:C#通过NI-VISA操作Tektronix TBS 2000B系列示波器

    seabluescn:C#通过NI-VISA操作Tektronix TBS 2000B系列示波器

    作者:seabluescn 时间:2021-02-16 22:28

    一、概述

    本文描述采用C#语言访问控制Tektronix TBS 2000B 系列示波器。接口协议采用NI-VISA。

    最近一个项目需要和一款示波器进行通信,需要对示波器进行一些简单控制并获取到波形数据。经过一段时间研究,大致了解了相关操作,因为发现相关资料不是很多,所以把我了解的相关知识和大家分享一下。文末将提供本文涉及的相关文档、代码、安装程序的下载地址。

    正常情况下,我们如果需要和一个设备进行通信,首先需要知道PC通过什么方式和设备进行连接,通信协议是什么。由于工作需要和很多设备进行过连接,常用的连接方式主要有:网络连接、串口连接、USB接口连接等;通信协议都是自定义的协议文本。 本来以为这个项目首先得需要搞清楚示波器的通信协议,然后才能进行下一步开发,在官方网站下载了一些编程资料,发现该设备是可以通过VISA进行连接的,那什么是VISA呢?VISA是由National Instruments公司牵头,联合一些设备制造厂商共同指定的一个通用设备连接标准,不管设备通过何种方式进行连接,只要符合VISA规范就可以通过该标准协议进行连接,而NI-VISA就是NI公司实现的一个协议,通过这个协议接口,我们不用直接和设备进行通信,只需要通过NI-VISA提供的接口就可以访问设备,而常用的接口非常简单,主要就是OPEN、WRITE、READ等几个命令。符合规范的设备都会公开一份SCPI指令集的文档,只要仔细阅读该文档就可以实现设备的控制。在整个项目过程中,我仅仅通过几个官方网站下载的文档就完成项目开发,几乎没有什么障碍,在此不得不感慨我们的制造业和发达国家相比确实有很大差距,我们就缺少这样标准性的东西,什么事情都得从底层做起,很不科学。要是那些巨头们肯做一些这方面的工作就太好了,比做什么买菜、卖鱼的APP有意义得多了。

     

    二、连接

    示波器通过网络接口和PC进行连接

      

     配置示波器IP和PC在同一个网段,例如:192.168.11.11,在设置时注意IP内不要有0,然后在PC上先ping一下,看能否ping通。

     

     如果能ping通就在浏览器输入http://192.168.11.11看能否打开示波器主页,确认SCPI指令可以运行。

     

        

    三、安装驱动

    运行NI-VISA Runtime安装程序,选中运行时基础包和.NET支持包。 

      .NET支持包选.NET 4.0-4.5.1 Runtime Support(IVI),不选.NET XX Runtime Support(NS),NS的包是老版本。

    安装完成后形成两个包:Ivi.Visa和NationalInstruments.Visa

    其中Ivi.Visa有两个版本:

    32位位置:C:\Program Files (x86)\IVI Foundation\VISA\Microsoft.NET\Framework32\v2.0.50727\VISA.NET Shared Components 5.8.0

    64位位置:C:\Program Files\IVI Foundation\VISA\Microsoft.NET\Framework64\v2.0.50727\VISA.NET Shared Components 5.8.0

    NationalInstruments.Visa位置:C:\Windows\Microsoft.NET\assembly\GAC_MSIL\NationalInstruments.Visa\v4.0_17.0.0.0__2eaa5af0834e221d

     

    四、引用

    新建VS工程,按上述地址添加Ivi.Visa和NationalInstruments.Visa两个引用。Ivi.Visa的库根据需要可以选32位或64位。

    程序运行需要在目标机器安装运行时,所以引用的库不需要复制到项目文件夹。

        

    五、代码

     已经有网友把VISA接口调用进行了封装,我直接使用了相关代码,几乎一字未改,相关代码请查阅:https://www.cnblogs.com/cncc/p/7866899.html

    连接代码:

                string IP = this.txtIP.Text.Trim();
    
                string IpRegex = @"^((25[0-5]|2[0-4]\d|[01]?\d\d?)\.){3}(25[0-5]|2[0-4]\d|[01]?\d\d?)$";
    
                if (!Regex.IsMatch(IP, IpRegex))
                {
                    MessageBox.Show("IP地址不正确!");
                    return;
                }
    
                if (!PortUltility.OpenIPAddress(IP, out string fullAddress))
                {
                    MessageBox.Show("未找到设备!");
                    return;
                }
    
                try
                {
                    _portOperatorBase = new LANPortOperator(fullAddress);
                }
                catch (Exception ex)
                {
                    MessageBox.Show($"初始化设备失败:{ex.Message}");
                    return;
                }
    
                try
                {
                    _portOperatorBase.Timeout = 2000;
                    _portOperatorBase.Open();
                }
                catch (Exception ex)
                {
                    MessageBox.Show($"连接设备失败:{ex.Message}");
                    return;
                }
    
                EnabledControls(true);
                MessageBox.Show("连接成功!");
    View Code

    写指令一共有两种,一种不需要返回数据、一种需要返回数据,下发了需要返回数据的指令后才能进行读取指令,否则就会读取失败。

    读写指令如下:

            private void btnWrite_Click(object sender, EventArgs e)
            {
                string CmdStr = this.txtCommand.Text.Trim();
    
               
                try
                {
                    _portOperatorBase.WriteLine(CmdStr);
                    ShowLog($"[Write][{CmdStr}][Success]");
                }
                catch
                {
                    ShowLog($"[Write][{CmdStr}][ERROR]");
                }
            }
    
            private void btnReadString_Click(object sender, EventArgs e)
            {
                try
                {
                    var result = _portOperatorBase.Read();
                    ShowLog($"[Read][{result}][{result.Length}]");
                }
                catch (IOTimeoutException)
                {
                    ShowLog($"[Read][ERROR:Timeout]");
                }
                catch (Exception ex)
                {
                    ShowLog($"[Read][Exception:{ex.Message}]");
                }
            }
    View Code

    核心代码就这么多,剩下的就根据需要查询SCPI指令表就可以了。

     

    附录、相关SCPI指令

     以下指令仅适用于Tektronix TBS 2000B系列示波器。

    (一)       基本指令
    1.     身份
    WRITE:*IDN?
    
    READ:
    
    (二)       设置
    1.     默认设置
    RECAll:SETUp FACtory
    
    2.    通道控制
    Select:CH<x> ON/OFF
    
    3.    水平位置与比例
    HORizontal:POSition?
    
    HORizontal:POSition 10
    
     
    
    HORizontal:SCAle?
    
    400   单位是秒
    
    HORizontal:SCAle 0.2
    
     
    
    4.    垂直位置与比例
    CH1:POSition?
    
    CH1:POSition 1
    
     
    
    CH1:SCAle?
    
    CH1:SCAle 2.5
    
     
    
    5.    触发
    模式
    
    TRIGger:A:MODe?
    
    NORMAL
    
     
    
    触发类型
    
    TRIGger:A:TYPe?
    
    EDGE
    
     
    
    触发源
    
    TRIGger:A:EDGE:SOUrce CH1
    
     
    
    耦合:
    
    TRIGger:A:EDGE:COUPling g {DC|HFRej|LFRej|NOISErej}
    
     
    
    斜率
    
    TRIGger:A:EDGE:SLOpe {RISe|FALL}
    
     
    
    触发电平(当前)
    
    TRIGger:A:LEVel?
    
    2.0800
    
    TRIGger:A:LEVel 3.5
    
     
    
    触发电平(指定通道)
    
    TRIGger:A:LEVel:CH1?
    
    2.0800
    
    TRIGger:A:LEVel :CH1 3.5
    
     
    
    (三)       控制
    1.     设置/查询工作类型
    ACQuire:STOPAfter SEQuence
    
    ACQuire:STOPAfter RUNSTOP
    
    查询:ACQuire:STOPAfter?
    
    返回最后一次设置的工作类型
    
     
    
    2.    设置/查询运行状态
    ACQuire:STATE?
    
    0:Run或Single
    
    1:Stop
    
    设置:ACQuire:STATE ON/OFF
    
     
    
    3.    查询触发状态
    TRIGger:STATE?
    
    READY:等待触发
    
    SAVE:已经触发
    
     
    
    (四)       读取数据
    1.     设置数据来源(通道)
    DATA:SOURCE CH1
    
     
    
    2.    设置/读取记录宽度
    HORizontal:RECOrdlength?
    
    2000
    
     
    
    3.    读取波形数据宽度(仅读取,触发完成后有效)
    WFMOutpre:RECOrdlength?
    
    2000
    
    4.    设置传输数据窗口
    DATa:STARt 1    最小为1
    
    DATa:STOP 2000
    
    DATa:WIDth? 单个数据宽度(字节数)默认为1,可以修改为2字节,但高位始终为0
    
     
    
    5.    数据读取
    CURVe?
    
    Read(Bytes):返回指定长度的字节数据【LENGTH= N+(STOP-STARt+1)+1】
    
    数据为:帧头(N字节)+数据(STOP-STARt+1字节)+帧尾(1字节)。
    
    帧头为:#(1字节)+数据长度的长度(1字节)+数据长度(1~9字节)
    
    帧尾为:\n
    
    数据每个字节表示一个波形高度值,采用补码方式,即第一个位表示符号,范围从-128~127
    View Code

     

    相关文档、代码下载:https://gitee.com/seabluescn/tksamples.git

    bk