第三章 虚拟仪器系统I/O接口软件——VISA
VISA是虚拟仪器系统的I/O接口软件,为虚拟仪器系统的统一性和扩展性奠定了基础。本章介绍了VISA的概念和特点,论述了VISA的结构模型,重点分析了VISA资源与资源类的定义与描述,并结合实例,详细讨论了各资源的属性、事件与操作规范与软件实现。在本章结束,还讨论了VISA的实际设计思路与方法。
3.1 VISA的概念与特点
3.1.1 VISA的由来
随着虚拟仪器系统的出现与发展,I/O接口软件作为虚拟仪器系统软件结构中承上启下的一层,其模型化与标准化越来越重要。I/O接口软件驻留于虚拟仪器系统的系统管理器——计算机系统中,是实现计算机系统与仪器之间命令与数据传输的桥梁和纽带。许多仪器生产厂家在推出硬件接口电路的同时,也纷纷推出了不同结构的I/O接口软件,有的只针对某类仪器(如NI公司用于控制GPIB仪器的NI-488及用于控制VXI仪器的NI-VXI),有的在向统一化的方向靠拢(如HP公司的SICL—标准仪器控制语言),这些都是在仪器生产厂家内部通用的、优秀的I/O接口软件。
一般的I/O接口软件的结构都采用了自顶向下的设计模型:首先列出该I/O接口软件需要控制的所有仪器类型,然后列出了各类仪器的所有控制功能,最后将各类仪器控制功能中相同的操作功能尽可能地以统一的形式进行合并,并将统一的功能函数称为核心功能函数(如将GPIB仪器的读/写与RS232串行仪器的读/写统一为一个核心功能函数)。所有统一形式的核心函数与其它无法合并的、与仪器类型相关的操作功能函数一起构成了自顶向下的I/O接口软件,实现不同类型的仪器的互操作性与兼容性。然而,这种构成方法只适用于消息基器件的互操作性(如消息读、消息写、软件触发、状态获取、异步事件处理等功能),对于如中断处理、内存映射、接口配置、硬件触发等属于器件特有的操作,根本无法得到统一的核心函数,消息基器件与寄存器基器件无法在自顶向下的I/O接口软件中得到统一。核心函数集在整个I/O接口软件中只有一个小子集,特定操作函数集是一个大子集。自顶向下结构的I/O接口软件实质上是建立在仪器类型层的叠加,并没有真正实现接口软件的统一性。同时应该说,自顶向下的设计方法为真正统一的I/O接口软件的设计与实现提供了经验借鉴与尝试。VPP联盟在考察了多个I/O接口软件之后,提出了一种自底向上的I/O接口软件模型,也就是VISA。
3.1.2 VISA模型结构
VISA是虚拟仪器软件结构(Virtual Instrument Software Architecture)的缩写,实质是一个I/O接口软件及其规范的总称。一般情况下,将这个I/O接口软件称为VISA。
如上所说,VISA的构成是采用了自底向上的结构。与自顶向下的方法不同的是,VISA的实现首先定义了管理所有资源的资源(在这儿,资源的概念相当于面向对象程序设计中的对象,具体的定义与描述见下节),这个资源称为VISA资源管理器,它用于管理、控制与分配VISA资源的操作功能。各种操作功能主要包括:
1、 资源寻址;
2、 资源创建与删除;
3、 资源属性的读取与修改;
4、 操作激活;
5、 事件报告;
6、 并行与存取控制;
7、 缺省值设置。
第二步是在资源管理器基础上,列出了各种仪器各自的操作功能,并实现操作功能的合并。在这个基础上实现的资源实质可以包括不同格式的操作,如读资源包括了消息基器件的读,也包括了寄存器基器件的读;既可以包括同步读操作,又可以包括异步读操作。每一个资源内部,实质是各种操作的集合。这种资源在VISA中即为仪器控制资源,包含各种仪器操作的资源称为通用资源,而将无法合并的功能,称为特定仪器资源。
第三步,需要定义与创建一个用API实现的资源,为用户提供单一的控制所有VISA仪器控制资源的方法,在VISA中称为仪器控制资源组织器。
与自顶向下的构成方式相比,VISA的构成模型是从仪器操作本身开始的,它实现的统一是深入到操作功能中去而不是停留于仪器类型之上。在VISA的结构中,仪器类型的区别体现到统一格式的资源中的操作的选取,对于VISA使用者来说,形式上与用法上是单一的。在理论层次上,自顶向下的方法属于归纳范畴,而自底向上的方法则属于演绎范畴。因此,自顶向下是对过去所有仪器类型的总结,而不可能提供扩展接口,而自底向上的结构是从共性到个性的推广,它的兼容性不仅仅是过去、现在,还可以包括将来。正由于这种自底向上的设计方法,VISA为虚拟仪器系统软件结构提供了一个共同的、统一的基础,来自于不同供应厂家的不同的仪器软件,可以运行于同一平台之上了。
VISA的结构模型如图3.1所示。
图3.1 VISA结构模型概图
VISA结构模型自下往上,构成一个金字塔结构,最底层为资源管理器,其上为I/O级资源、仪器级资源与用户自定义资源集。其中,用户自定义资源集的定义,在VISA规范中并没有规定,它是VISA的可变层,实现了VISA的可扩展性与灵活性,而在金字塔顶的用户层应用,是用户利用VISA资源实现的应用程序,其本身并不属于VISA资源。
3.1.3 VISA的特点
基于自底向上结构模型的VISA创造了一个统一形式的I/O控制函数集,它是所有现存的I/O接口软件的功能超集,在形式上与其它I/O接口软件十分相似。一方面,对于初学者或是简单任务的设计者来说,VISA提供了简单易用的控制函数集,在应用形式上相当简单。另一方面,对于复杂系统的组建者来说,VISA提供了非常强大的仪器控制功能与资源管理功能,能提供仪器间的互操作性与兼容性。它是易用性、可扩展性、互操作性、兼容性的完全统一体。
与其它现存的I/O接口软件相比,VISA具有以下几个特点:
1、 VISA的I/O控制功能适用于各种仪器类型,VISA包含了VXI仪器、GPIB仪器、RS232串行接口仪器等各类仪器的控制操作,也包含了消息基器件、寄存器基器件、存贮器件等仪器的操作,其形式上是统一的。
2、 VISA的I/O控制功能适用于各种仪器硬件接口类型,以VXI仪器系统为例,无论采用嵌入式计算机结构、GPIB接口外挂式结构、MXI接口外挂式结构,还是采用IEEE1394接口外挂式结构,对于VXI仪器的操作函数是一样的。同样,无论VXI仪器在系统中的逻辑地址是多少,仪器操作函数也是一样的。
3、 VISA的I/O控制功能适用于单处理器系统结构,也适用于多处理器结构或分布式网络结构。
4、 VISA的I/O控制功能适用于多种网络机制,无论虚拟仪器系统网络构成为VXI多机箱扩展网络还是以太网,仪器操作是一致的。
5、 VISA的I/O软件库的源代码是唯一的,其与操作系统及编程语言无关,只是提供了不同形式的API文件作为系统的引出。
由于VISA结构考虑到了多种仪器类型与网络机制的兼容性,因此以VISA I/O接口软件为基础的虚拟仪器系统,不仅可以与过去已有的仪器系统(如GPIB仪器系统及串行接口仪器系统)结合,也完全可以将仪器系统从过去的集中式结构过渡到分布式结构。VISA的兼容性与互操作性,保证了新一代仪器完全可以加入到虚拟仪器系统中去,同时也保证了仪器系统的投资者不会因为新仪器的出现而将过去的系统抛弃,从而可以不使投资浪费。系统集成时,不必再选择某家特殊的软件和硬件产品,可以根据自己的需要,在所有的VPP产品中作出最佳选择,系统的兼容性与强健性大大增强了,系统的标准化与统一性也找到了最基础的保障。
3.1.4 VISA应用实例
下面通过分别调用非VISA的I/O接口软件与VISA函数,对GPIB器件与VXI消息基器件进行简单的读/写操作(主要完成向器件发送查询器件标识符命令,并从器件读回响应值操作过程),进行VISA与其它I/O接口软件的异同点比较。所有例子中采用的编程语言均为C语言。
例3.1 用非VISA的I/O接口软件(NI公司的NI-488)实现对GPIB器件的读/写操作:
程序说明:
1、 声明区:声明程序中所有变量的数据类型,用C语言数据类型声明。
2、 开启区:进行GPIB器件初始化,确定GPIB器件地址,并为每个器件返回一个对应的器件句柄。在初始化过程中,器件句柄作为器件的标志以输出参数形式被返回,在其它的I/O功能函数中,器件句柄则作为函数的输入参数,以标志特定的GPIB器件。
3、 器件I/O区:在本例程中,器件I/O主要完成命令发送,并从GPIB器件中读回响应数据。主要完成向器件发送查询器件标识符命令,用标准命令符“*IDN?”,并从器件读回响应值,即器件的标识符。在NI-488函数集中,分别用ibwrt函数与ibrd函数进行器件写操作与读操作。
4、 关闭区:GPIB的I/O软件将本身的数据结构存于内存中,当系统关闭时,所有仪器全部自动关闭,无需对I/O软件本身作关闭操作。也就是说,GPIB的I/O软件(如NI-488)无关闭机制。
例3.1 用NI-488实现对GPIB仪器的读/写操作
例3.2 用非VISA的I/O接口软件(NI公司的NI-VXI)实现对VXI消息基器件的读/写操作:
例3.2 用NI-VXI实现对GPIB器件的读/写操作程序说明:
1、 声明区:声明程序中所有变量的数据类型,用C语言数据类型声明。
2、 开启区:进行VXI消息基器件初始化,确定VXI消息基器件的逻辑地址。在对VXI器件操作中,逻辑地址取代了GPIB器件操作中的器件句柄,作为器件操作的标志,在初始化操作中返回唯一的值。
3、 器件I/O区:在本例程中,主要完成对命令发送,并从VXI消息基器件读回响应数据。同样完成向器件发送查询器件标识符命令,用标准命令符“*IDN?”,并从器件读回响应值,即器件的标识符。由初始化得到的器件逻辑地址在器件I/O操作中作为函数的输入参数被使用。程序通过对逻辑地址的处理,完成对器件的一对一操作。在VXI消息基器件的操作中,分别用WSwrt函数与WSrd函数进行器件的写操作与读操作,其中这两个函数中的mode参数均表示数据传输方式,retCount参数表示实际传送的字节数。
4、 关闭区:对于VXI器件,存在着一个关闭机制,要求在结束器件操作的时候,同时关闭I/O接口软件。
例3.3 用VISA I/O接口软件实现对GPIB器件与VXI消息基器件的读/写操作:
例3.3 用VISA实现对GPIB器件与VXI消息基器件的读/写操作
程序说明:
1、 声明区:声明程序中所有变量的数据类型。与以上两例不同的是,在这儿声明的数据类型均为VISA数据类型,其是与编程语言无关的。而VISA数据类型与编程语言数据类型的对应说明,均包含在特定文件中。如VISA数据类型的C语言形式的包含头文件为本章附录文件visatype.h和visa.h。由于程序中没有涉及到具体某种语言的数据类型,故程序本身具有良好的兼容性与可移植性,各种编程语言调用VISA的数据类型与操作函数的参数调用格式相差甚少。
2、 开启区:进行消息基器件初始化,建立资源管理器及器件与VISA的通信关系。对所有器件进行初始化均调用viOpenDefaultRM()与viOpen()函数。在此例中,对于GPIB器件的初始化与对于VXI器件的初始化的函数调用形式是一致的,只是输入参数中器件描述符的值区别。在调用viOpen()函数时,器件硬件接口形式(计算机结构形式)是无需特别说明的,该初始化过程完全适用于各种器件硬件接口类型。初始化过程中返回的vi参数,类似于器件句柄,可作为器件操作的标志与数据传递的中介。
3、 器件I/O区:在本例程中,主要完成对器件发送命令,并从器件读回响应数据。对于GPIB的读/写操作与对于VXI消息基器件的读/写操作,调用的VISA函数是一样的。其中vi是操作函数的输入参数。
4、 关闭区:在器件操作结束时,调用viClose()函数,关闭器件及资源管理器与VISA的关联。
通过以上三个例程的分析,可以发现两个事实:
第一、VISA函数的调用与其它接口软件函数的调用形式上并无太多不同,学习功能强大的VISA软件并不比一般的I/O接口软件任务重。而且VISA的函数参数意义明确,结构一致,在理解与应用仪器程序时,效率较高。
第二、VISA用户只需学习了VISA函数应用格式,就可以对多种仪器实现统一控制,不必再象以前学会了用NI-488对GPIB器件操作之后,还得学会NI-VXI对VXI器件进行操作。与其它的I/O接口软件相比,VISA体现的多种结构与类型的统一性,使不同仪器软件可以运行在同一平台上,为虚拟仪器系统软件结构提供了坚实的基础。
3.2 VISA资源描述
3.2.1 VISA资源类与资源
自底向上的VISA模型内部是由面向对象程序(OOP)软件模块构成的。在VISA中,最基本的软件模块是定义在资源类上的资源。
VISA的资源类概念类似于面向对象程序设计方法中类的概念。类是一个实例外观和行为的描述。类通过构造函数来建立新的实例,因为不管怎样,先得建立一个实例才能使用它、操作它。当向类提出要建立一个实例的要求时,它会通过一个特定的构造函数创建并初始化一个新的实例。然而,类并不对销毁一个实例负责,这就要求实例要自己负责,它们通过调用一个方法来申请自我的销毁。类的声明定义了类的实例结构以及一组可以由该实例执行的有效操作。VISA资源类是一种抽象化的器件特点功能描述,是对资源精确描述的专用术语。
VISA的资源概念类似于面向对象程序设计方法中对象的概念。对象实例不仅包含数据实体,而且是一个服务提供者。做为一个数据实体,一个对象很象一个记录,由一些相同或不同类型的域构成。这些域的整体被称为一个对象的状态。改变这些域的值,逻辑上讲就是改变一个对象的状态。作为服务提供者,或者说是一个过程实体,一个对象是一些在其域上进行操作的方法或子程序的集合。从这个角度看来,它有点象一个子例程库。方法定义了对象的行为,激活一个对象方法的实际结果就是让对象做一个动作。这两种互相补充的角色使对象这种概念变得非常强大。使用对象,可以使抽象非常方便:一个对象的内部可以看成一个“黑匣子”,只能通过精心设计的由方法组成的接口来访问。对象的可见部分成为它的协议。
VISA中资源与OOP对象一样,也由三个要素组成:属性集、事件集与操作集。以读资源为例,其属性集包括结束字符串、超时值及协议等,事件集包括用户退出事件,操作集包括各种端口读取操作。
3.2.2 VISA资源描述格式
VISA资源是独立于编程语言与操作系统的,在VISA本身的资源定义与描述中并不包含任何操作系统或编程语言相关的限制。VISA源代码是唯一的,只为不同的操作系统编程语言提供了不同的API接口。VISA资源类共分为五大类:VISA资源模板、VISA资源管理器、VISA仪器控制资源、VISA仪器控制组织器、VISA特定接口仪器控制资源。在每一类中定义与描述的VISA资源都遵循同样的格式。VISA资源描述格式
如表3.1所示。
VISA资源描述格式是一种抽象定义,与具体编程语言无关,资源内所有元件的定义也均与编程语言无关。VISA通过提供不同的API接口,适用于不同的操作系统与编程环境。在不同的编程语言环境之中调用VISA,均需在应用程序头部引入说明文件。在C语言环境下,VISA资源说明文件为visatype.h和visa.h文件(详见本章附录)。唯一的VISA源程序通过不同的引入接口与文件说明,实现了不同环境下的适用性。VISA资源描述格式不仅适用于现在VISA包含的所有资源,也为VISA将来资源扩充定义了一个标准格式。现定义的VISA资源类型定义如表3.2所示。
X.1 资源概述
X.2 资源属性表及属性描述
X.3 资源事件集
X.4 资源操作集
所含每个操作包括:
X.4.Y 名字(含形参名)
X.4.Y.1 目标
X.4.Y.2 参数表
X.4.Y.3 返回状态值
X.4.Y.4 描述
X.4.Y.5 相关操作项
X.4.Y.6 实现要求
表3.1 VISA资源描述格式
资源 缩写名 标准名
VISA资源管理器资源 VRM VI_RSRC_VISA_RM
VISA仪器控制组织器资源 VICO VI_RSRC_VISA_IC_ORG
写资源 WR VI_RSRC_WR
读资源 RD VI_RSRC_RD
格式化I/O资源 FIO VI_RSRC_FMT_IO
触发资源 TRIG VI_RSRC_TRIG
清除资源 CLR VI_RSRC_CLR
状态/服务请求资源 SRQ VI_RSRC_SRQ
高级存取资源 HILA VI_RSRC_HL_ACC
低级存取资源 LOLA VI_RSRC_LL_ACC
器件特定命令资源 DEVC VI_RSRC_DEV_CMD
CPU接口资源 CPUI VI_RSRC_CPU_INTF
GPIB总线接口控制资源 GBIC VI_RSRC_GPIB_INTF
VXI总线器件配置资源 VXDC VI_RSRC_VXI_DEV_CONF
VXI总线接口控制资源 VXIC VI_RSRC_VXI_INTF
VXI总线零槽资源 VXS0 VI_RSRC_VXI_SLOT_0
VXI总线系统中断资源 VXSI VI_RSRC_SYS_INTR
VXI总线信号处理器资源 VXSP VI_RSRC_SIG_PROCESSOR
VXI总线信号资源 VXS VI_RSRC_VXI_SIG
VXI总线中断资源 VXIN VI_RSRC_VXI_INTR
VXI总线扩展器接口资源 VXEI VI_RSRC_VXI_EXTDR
异步串行总线接口控制资源 ASIC VI_RSRC_ASRL_INTF
表3.2 VISA资源类型定义
下面对VISA资源描述格式中各部分进行逐一分析:
1、 资源概述:简要说明资源所要实现的功能,一般不针对特定仪器类型或接口进行描述,只提供一个通用概念。
2、 资源属性表及属性描述:资源属性表列出了资源所有属性,并在以后的属性描述中作较详细的说明。资源属性表如表3.3所示。
属性符号名 存取特性 数据类型 取值范围 读/写特性 私有/公有特性
表3.3 VISA资源属性表
l 属性符号名:用于标识属性。
l 存取特性:包括读/写特性与私有/公有特性。读/写特性可选择R/W(可读可写)与RO(只读);私有/公有特性可选择Local(对话通道私有)与Global(资源内所有对话通道公有)。
l 数据类型:VISA数据类型是独立于编程语言定义的,在具体编程中调用VISA函数进行实际操作时,VISA数据类型与具体数据类型将一一映射。VISA定义了两类数据类型:基本数据类型与复杂数据类型。分别见表3.4和表3.5。
l 取值范围:定义了该属性数据的取值范围。
基本数据类型 数据类型描述 基本数据类型 数据类型描述
ViChar 字符类型 ViInt32 32位整型
ViPChar 字符指针类型 ViPInt32 32位整型指针类型
ViByte 字节类型 ViInt64 64位整型
ViPByte 字节指针类型 ViPInt64 64位整型指针类型
ViString 字符串类型 ViUInt8 8位无符号整型
ViPString 字符串指针类型 ViPUInt8 8位无符号整型指针类型
ViBoolean 布尔类型 ViUInt16 16位无符号整型
ViPBoolean 布尔指针类型 ViPUInt16 16位无符号整型指针类型
ViInt8 8位整型 ViUInt32 32位无符号整型
ViPInt8 8位整型指针类型 ViPUInt32 32位无符号整型指针类型
ViInt16 16位整型 ViUInt64 64位无符号整型
ViPInt16 16位整型指针类型 ViPUInt64 64位无符号整型指针类型
ViReal32 32位实型 ViReal64 64位实型
ViPReal32 32位实型指针类型 ViPReal64 64位实型指针类型
表3.4 VISA基本数据类型
复杂数据类型 数据类型描述 复杂数据类型 数据类型描述
ViRsrc 资源标识类型 ViHndlr 操作句柄类型
ViPRsrc ViRsrc指针类型 ViPHndlr ViHndlr指针类型
ViStatus 返回状态值类型 ViVAList 参数列类型
ViPStatus ViStatus指针类型 ViJobId 操作请求类型
ViBuf 数据块类型 ViPJobId ViJobId指针类型
ViPBuf ViBuf指针类型 ViJobStatus 操作请求状态类型
ViAddr 逻辑地址类型 ViPJobStatus ViJobStatus指针类型
ViPAddr ViAddr指针类型 ViSpaceInfo 内存映射类型
ViSession 资源对话通道类型 ViPhysAddr 物理地址类型
ViPSession ViSession指针类型 ViSigMask 信号过滤类型
ViVersion 资源版本类型 ViIntrMask 中断屏蔽类型
ViPVersion ViVersion指针类型 ViBusAddress 总线地址类型
ViObject 资源对象类型 ViBusSize 地址长度类型
ViPObject ViObject指针类型 ViAttr 资源属性类型
ViRsrcList 资源标识列类型 ViAttrState 资源属性值类型
ViClass 资源类类型 ViLock 资源进程/线程管理类型
ViEvent 资源事件类型 ViPLock ViLock指针类型
ViPEvent ViEvent指针类型 ViEventType 资源事件类型类型
ViAccessMode 控制存取机制类型 ViPEventType ViEventType 指针类型
表3.5 VISA复杂数据类型
3、 资源事件集:VISA定义了一种运行机制,用于在一定条件下通知应用程序一个行为的发生,这些条件与发生被称为VISA事件。VISA事件模型如图3.2所示。
VISA事件模型由三部分组成。1)事件捕捉与通知:资源感知到事件发生,并与对话通道相联系;2)事件请求与处理:告知应用程序事件已发生,VISA定义了事件处理机制;3)事件响应:根据协议对事件进行响应。
图3.2 VISA事件模型
根据VISA事件引发的原因,事件类型可分为以下几种:
l 由硬件请求产生:如GPIB器件SRQ信号有效。
l 由硬件响应产生:如VXI总线中的SYSFAIL线有效。
l 由于资源行为的起始与结束所产生:如应用程序想知道系统服务是处于在线状态还是离线状态。
l 由于资源转换到不正常操作,必须终止正常操作所产生的事件。
l 在应用程序正常运行过程中的错误散转情况。
在VISA中,定义了两种事件处理机制。一种是事件排队方式(Queuing),它主要分两步进行:首先允许特定事件的处理机制,然后在一定时刻点去查询事件是否已经发生(调用VISA中的viWaitOnEvent()函数,事件类型见VI_EVENT_类参数),在事件发生之后,必须关闭特定事件的处理机制,以防止资源溢出。例3.4所示为用事件排队方式处理VISA事件。
例3.4 排队方式处理VISA事件
另一种事件处理方式为回调方式(Callback),也即中断方式。它首先安装回调句柄,然后在程序中允许事件处理机制,并应编写相应的中断子程序。利用回调方式进行处理的事件类型主要有以下几种:
l VI_EVENT_SERVICE_REQ:该事件表示VXI器件服务请求
l VI_EVENT_TRIG:该事件表示从VXI器件接收到硬件触发信号
l VI_EVENT_VXI_SIGP:该事件表示从VXI器件接收到总线信号或总线中断信号
例3.5、例3.6与例3.7分别是利用回调方式对各种类型事件进行处理的实例,其中
例3.5是对HP公司推出的VXI数字万用表模块进行服务请求事件的处理,而例3.6与
例3.7是对浙江大学数字所自主开发的VXI数字输入/输出模块进行触发事件与总线中断事件处理。事实上,这几种事件处理示例可直接推广应用到其它的消息基器件与寄存器基器件中。
例3.5 利用回调方式对VXI模块进行服务请求事件处理:
例3.5 回调方式进行服务请求事件处理
在这种模式中,主程序安装的事件句柄类型为VI_EVENT_SERVICE_REQ,并须将服务请求使能。当服务请求事件发生时,安装的事件句柄被激活,系统进入中断子程序。中断子程序首先对事件类型进行判断,然后进行具体事件处理。在主程序退回时,必须关闭事件允许机制,并将安装的事件句柄进行卸载。
例3.6 利用回调方式对VXI模块进行触发事件处理:
例3.6 回调方式进行触发事件处理
在这种模式中,主程序安装的事件句柄类型为VI_EVENT_TRIG,并须将服务请求使能。本主程序利用设置仪器属性的方式进行触发总线的选择与有效,并利用软件进行同步触发信号线TTL0。当触发事件发生时,安装的事件句柄被激活,系统进入中断子程序。中断子程序首先对事件类型进行判断,然后进行具体事件处理。需要注意的是,在中断子程序中获取事件的句柄不再是仪器句柄vi,而是ViEvent类型的事件句柄ctx。在主程序退回时,必须将安装的事件句柄进行卸载。
例3.7 利用回调方式对VXI模块进行总线中断事件处理:
例3.7 回调方式进行总线中断事件处理
在这种模式中,主程序安装的事件句柄类型为VI_EVENT_VXI_SIGP,并须将服务请求使能。本主程序直接对器件内部控制寄存器进行写操作,允许中断产生并强制中断产生。当触发事件发生时,安装的事件句柄被激活,系统进入中断子程序。中断子程序首先对事件类型进行判断,然后进行具体事件处理。同样,在中断子程序中获取事件的句柄不再是仪器句柄vi,而是ViEvent类型的事件句柄ctx。在主程序退回时,必须将安装的事件句柄进行卸载。
4、 资源操作集:包括了一系列VISA资源操作。而每个操作又分别包括以下各项:
l 名字(含形参名):用于操作函数原型的简单描述。
l 目标:简要描述相应的操作功能。
l 参数表:列出了操作中所有参数的相关信息,包括参数名、输入/输出方向、参数数据类型及参数描述。操作参数表如表3.6所示。
参数名 输入/输出方向 数据类型 描述
表3.6资源操作参数表
l 返回状态值:VISA资源操作返回状态值类型是唯一的,即为ViStatus。操作返回状态值包括完成代码与错误代码两类。
l 描述:对每个函数的功能及其中关键参数的含义等作较详细的描述。
l 相关操作项:可参考的其它相关操作。
l 实现要求:操作实现时应满足的一些条件与备注要求。
3.3 VISA资源定义
3.3.1 VISA资源模板
VISA资源模板相当于面向对象程序(OOP)中的基类,VISA其它资源类全部是它的子类。VISA资源模板上本身没有定义资源,它定义的是公共属性、事件与操作,所有VISA资源全部继承了资源模板的属性、事件与操作。在其它VISA资源定义中,实际上是定义了资源特有的属性、事件与操作,VISA资源真正拥有的属性、事件与操作包括资源模板定义的公共部分与资源特有的私有部分。
VISA资源模板中主要定义了以下几个共性功能:
l 资源定位与查寻
l 资源创建与删除
l 资源属性读取与修改
l 资源存取模式与权限控制
l 基本通讯服务(包括操作激活与事件报告)
VISA资源模板的定义也包括相应的属性、事件与操作,各自的描述格式与定义方式与其它VISA资源描述是一致的,这主要是为了其他资源可以方便地从基类继承所有属性、事件与操作。
资源模板定义的属性如表3.7所示:
属性符号名 存取特性 数据类型 取值范围
读写特性 公私特性
VI_ATTR_RSRC_CLASS 只读 公有 ViClass 无
VI_ATTR_RSRC_NAME 只读 公有 ViString 无
VI_ATTR_RSRC_VERSION 只读 公有 ViVersion 无
VI_ATTR_RSRC_LOCK_STATE 只读 公有
ViUInt16 VI_NO_LOCKVI_NON_EXCLUSIVE_LOCKVI_EXCLUSIVE_LOCK
VI_ATTR_MAX_QUEUE_LENGTH 可读可写 私有 ViUInt32 无
VI_ATTR_QUEUE_TRIP_POINT 可读可写 私有 ViUInt32 无
VI_ATTR_USER_DATA 可读可写 私有 ViAddr 无
表3.7 VISA资源模板属性表
VISA资源模板属性描述:
属性名 描述
VI_ATTR_RSRC_CLASS 资源所属类的标识符
VI_ATTR_RSRC_NAME 资源名标识符
VI_ATTR_RSRC_VERSION 资源版本标识符
VI_ATTR_RSRC_LOCK_STATE 资源存取锁定模式(取值为表3.7中所列三种)
VI_ATTR_MAX_QUEUE_LENGTH 任一时间特定对话通道最大排队的事件长度
VI_ATTR_QUEUE_TRIP_POINT 排队事件的触发点
VI_ATTR_USER_DATA 资源特定对话通道所用的私有数据
资源模板定义的事件如下所示:
事件 说明
VI_EVENT_ALERT 通知应用程序对话通道或资源退出、复位或关闭
VI_EVENT_RSRC_ACTIVE 通知应用程序资源已激活
VI_EVENT_RSRC_INACTIVE 通知应用程序资源未被激活
VI_EVENT_RSRC_LOCK_CHANGED 通知应用程序存取锁定状态已更新
VI_EVENT_QUEUE_FULL 通知应用程序等待操作事件队列已满
VI_EVENT_QUEUE_TRIP 通知应用程序事件等待操作触发点已到
VI_EVENT_RSRC_AVAILABLE 通知应用程序特定资源已有效
资源模板定义的操作如下:
viFindRsrc(vi,expr,accessLink)
viOpen(sesn,rsrcname,accessMode,timeout,vi)
viClose(vi)
viTerminate(vi,target,degree,jobId,immediate,flagFlushData)
viAttachRsrc(vi,rsrcName,refName)
viDetachRsrc(vi,refName)
viSetAttribute(vi,attribute,attrState)
viSetRsrcAttribute(vi,rsrcName,attribute,attrState)
viGetAttribute(vi,attribute,attrState)
viGetRsrcAttribute(vi,attribute,attrState)
viLock(vi,lockType,shareType,timeout,lockId)
viLockRsrc(vi,rsrcName,lockType,shareType,timeout,lockId)
viUnlock(vi,lockId)
viUnlockRsrc(vi,rsrcName,lockId)
viEnableEvent(vi,eventType,mechanism,context)
viDisableEvent(vi,eventType,mechanism)
viQueryEventMech(vi,eventType,mechanism)
viInstallHandler(vi,eventType,handler,userHandle)
viUnInstallHandler(vi,eventType,handler,userHandle)
viQueryHandlers(vi,eventType,handlers,userHandle)
viAcknowledgeEvent(vi,eventType,context)
viWaitOnEvent(vi,eventType,timeout,outContext)
viWaitOnMultipleEvent(vi,eventTypeList,timeout,outContext,outEventType)
viDiscardEvents(vi,eventType,mechanism)
viGetEventInfo(vi,eventType,context,rsrcName,info)
viRaiseEvent(vi,eventType,context,target)
viEventHandler(vi,eventType,context,userHandle)
下面将分别对各个操作作一详细描述。
1、 viFindRsrc(vi,expr,accessLink)
1) 目标:查询VISA系统,进行资源定位
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 资源对话通道标识符
expr 输入 ViString 用于资源名匹配的表达式
accessLink 输出 ViRsrcList 资源所在位置列表
3) 返回状态值:
完成代码:
VI_SUCCESS 资源查寻到
错误代码:
VI_ERROR_INV_SESSION vi(句柄)不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_EXPR 查找表达式不规范
VI_ERROR_RSRC_NFOUND 查找表达式无法与资源名匹配
4) 描述:该操作用于查询资源名与表达式相匹配的资源,并确定资源位置。
5) 相关项:参见viAttachRsrc()、viOpen()。
6) 实现要求:输出参数accessLink应含所有相匹配的资源个数。
2、 viOpen(sesn,rsrcName,accessMode,timeout,vi)
1) 目标:打开特定资源的对话通道
2) 参数表:
参数名 输入/输出方向 数据类型 描述
sesn 输入 ViSession VISA资源管理器
rsrcName 输入 ViRsrc 资源名
accessMode 输入 ViAccessMode 资源存取锁定模式
timeout 输入 ViUInt32 操作超时值
vi 输出 ViPSession 对话通道标识符(句柄)
3) 返回状态值:
完成代码:
VI_SUCCESS 对话通道打开完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_INV_RSRC_NAME 资源名语法错误
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_ACC_MODE 不合法的存取模式
VI_ERROR_NSUP_ACC_MODE 存取模式不被支持
VI_ERROR_RSRC_NFOUND 系统中未能找到该资源
VI_ERROR_TMO 操作超时
4) 描述:该操作用于开启特定资源的一个对话通道,它返回的对话通道标识符可作为以后操作的软件句柄。参数中的accessMode应在几种存取模式中选取(VI_NO_LOCK、VI_EXCLUSIVE_LOCK、VI_NON_EXCLUSIVE_LOCK)。
5) 相关项:参见viClose()。
6) 实现要求:sesn参数一般用缺省VISA资源管理器viDefaultRM代入,因此在调用viOpen()函数之前一般已先调用了viOpenDefaultRM()函数用于打开缺省的资源管理器。
3、 viClose(vi)
1) 目标:关闭特定的对话通道
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
3) 返回状态值:
完成代码:
VI_SUCCESS 对话通道关闭完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_CLOSE_FAILED 无法释放与该对话通道相关联的内存数据结构
4) 描述:该操作用于关闭与资源相关联的对话通道,并释放内存数据。
5) 相关项:参见viOpen()。
6) 实现要求:当一个对话通道在执行viClose()操作时,不仅应关闭该通道,并应释放所有通道的数据。
4、 viAttachRsrc(vi,rsrcName,refName)
1) 目标:通过对话通道,建立两资源之间的关联
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
rsrcName 输入 ViRsrc 相关联的资源名
refName 输入/输出 ViPRsrc 相关联的资源别名
3) 返回状态值:
完成代码:
VI_SUCCESS 资源关联完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_INV_RSRC_NAME 资源名语法错误
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_DUPLICATE refName参数中的资源已存在
_REF_NAME
VI_ERROR_ATTACH_REFUSED 资源无法被关联
4) 描述:该操作用于关联两个资源,用vi标识的对话通道可以存取相关联资源的所有属性与操作。
5) 相关项:参见viDetachRsrc()、viGetRsrcSession()。
6) 实现要求:资源间应通过关联方式实现对话。
5、 viDetachRsrc(vi,refName)
1) 目标:取消资源之间的关联
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
refName 输入/输出 ViPRsrc 相关联的资源别名
3) 返回状态值:
完成代码:
VI_SUCCESS 取消资源关联完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_RSRC_NFOUND 资源未能找到
VI_ERROR_INV_RSRC_NAME 资源名语法错误
4) 描述:该操作用于取消资源之间关联,一旦关联取消,相关联资源的所有属性与操作不能再被存取。
5) 相关项:参见viAttachRsrc()。
6) 实现要求:资源无法拒绝取消关联的请求。
6、 viTerminate(vi,target,degree,jobId,immediate,flagFlushData)
1) 目标:请求VISA资源终止一个或所有对话通道的正常运行
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
target 输入 ViBoolean 请求目标(资源或通道)
degree 输入 ViUInt16 请求类型,正常类型有VI_ABORT、VI_RESET、VI_FAIL、
VI_KILL
jobId 输入 ViJobId 操作标识符
immediate 输入 ViBoolean 请求是否立即有效
flagFlushData 输入 ViBoolean 资源是否放弃应用数据
3) 返回状态值:
完成代码:
VI_SUCCESS 请求服务完成
VI_SUCCESS_STATE_UNKNOWN 请求服务完成,但资源可能处于不一致状态
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_DEGREE 请求类型不合法
VI_ERROR_INV_JOB_ID 操作类型或标识符不合法
4) 描述:该操作用于请求资源去终止一个或所有对话通道的正常运行,请求类型可分为VI_ABORT(退出)、VI_RESET(复位)、VI_FAIL(失败)及VI_KILL(停止所有资源操作)四种。
5) 相关项:参见VI_EVENT_ALERT事件描述。
6) 实现要求:当VISA资源激活viTerminate()操作时,资源不能进行其它操作。
7、 viGetAttribute(vi,attribute,attrState)
viGetRsrcAttribute(vi,rsrcName,attribute,attrState)
1) 目标:获取资源属性状态值
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
rsrcName 输入 ViRsrc 资源名
attribute 输入 ViAttr 资源属性
attrState 输出 ViPAttrState 资源属性状态值
3) 返回状态值:
完成代码:
VI_SUCCESS 获取属性完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_INV_RSRC_NAME 资源名语法错误
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_NSUP_ATTR 资源属性未定义
4) 描述:viGetAttribute()取回当前资源属性状态值,而viGetRsrcAttribute()取回其它资源的公有属性状态值。
5) 相关项:参见viSetAttribute()、viSetrsrcAttribute()、viLock()、viUnLock()。
6) 实现要求:无论资源锁定状态如何,viGetRsrcAttribute()操作都可以取回资源公有属性状态值。
8、 viSetAttribute(vi,attribute,attrState)
viSetRsrcAttribute(vi,rsrcName,attribute,attrState)
1) 目标:设置资源属性状态值
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
rsrcName 输入 ViRsrc 资源名
attribute 输入 ViAttr 资源属性
attrState 输入 ViAttrState 资源属性状态值
3) 返回状态值:
完成代码:
VI_SUCCESS 属性设置完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_INV_RSRC_NAME 资源名语法错误
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_NSUP_ATTR 资源属性未定义
VI_ERROR_NSUP_ATTR_STATE 资源属性状态值不支持
VI_ERROR_NSUP_ATTR 资源属性为只读状态
_READONLY
4) 描述:viSetAttribute()设置当前资源属性状态值,而viSetRsrcAttribute()设置其它资源的公有属性状态值。
5) 相关项:参见viGetAttribute()、viGetrsrcAttribute()、viLock()、viUnLock()。
6) 实现要求:当资源处于锁定状态时,无法进行属性状态值设置。
9、 viLock(vi,lockType,shareType,timeout,lockId)
viLockRsrc(vi,rsrcName,lockType,shareType,timeout,lockId)
1) 目标:设置资源存取模式
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
rsrcName 输入 ViRsrc 资源名
lockType 输入 ViUInt16 锁定类型(独占或非独占)
shareType 输入 ViUInt16 锁定共享类型
timeout 输入 ViUInt32 操作超时值
lockId 输入/输出 ViPLock 当锁定设置成功后,资源返回的唯一锁定标识符
3) 返回状态值:
完成代码:
VI_SUCCESS 锁定模式设置完成
VI_SUCCESS_SHARE_LOCK 锁定模式设置完成,并被多个对话通道共享
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_INV_RSRC_NAME 资源名语法错误
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_LOCK_TYPE 锁定模式不当
VI_ERROR_INV_LOCK_ID 锁定标识符不当
VI_ERROR_NSHARABLE lockID不能用于非共享模式
VI_ERROR_LOCK_CHANGE 由于对话通道已被锁定,不能从非独占锁定状
_FAILED 态改变到独占状态
4) 描述:该操作用于设置资源锁定模式,必须区分锁定类型与共享类型。共享类型的设置只对于独占锁定状态有关,所有非独占性锁定状态均为共享。
5) 相关项:参见viUnLock()、viUnLockRsrc()。
6) 实现要求:当锁定模式为非独占型时,shareType参数可忽略。
10、 viUnLock(vi,lockId)
viUnLockRsrc(vi,rsrcName,lockId)
1) 目标:取消资源存取模式
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
rsrcName 输入 ViRsrc 资源名
lockId 输入 ViLock 锁定标识符
3) 返回状态值:
完成代码:
VI_SUCCESS 取消锁定模式完成
VI_WARN_NON_EXCLUSIVE 调用成功,但资源仍被非独占型锁定
_LOCK
VI_WARN_EXCLUSIVE_LOCK 调用成功,但资源仍被独占型锁定
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_INV_LOCK_ID 锁定标识符不当
VI_ERROR_LOCK_NOWNER 锁定并非来自于特定通道vi
4) 描述:该操作用于取消以前设置的资源锁定模式。
5) 相关项:参见viLock()、viLockRsrc()。
6) 实现要求:注意不同的参数输入对应于不同的返回状态。
11、 viEnableEvent(vi,eventType,mechanism,context)
1) 目标:允许特定事件通知
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
eventType 输入 ViEventType 事件标识符
mechanism 输入 ViUInt16 事件处理机制
context 输入 ViEvent 事件信息
3) 返回状态值:
完成代码:
VI_SUCCESS 事件通知允许
VI_SUCCESS_EVENT_EN 至少一种事件处理机制被允许
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_EVENT 特定事件不存在或不被支持
VI_ERROR_INV_MECH 事件处理机制不合法
VI_ERROR_HNDLR_NINSTALLED 特定事件句柄未被安装
4) 描述:该操作允许特定事件的通知,应用程序可采用事件排队或回调(中断)方式处理该事件。
5) 相关项:参见viEventHandler()、viInstallHandler()、viUnInstallHandler()。
6) 实现要求:若事件句柄未被安装,则在回调(中断)方式中返回错误值。
12、 viDisableEvent(vi,eventType,mechanism)
1) 目标:不允许特定事件通知
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
eventType 输入 ViEventType 事件标识符
mechanism 输入 ViUInt16 事件处理机制
3) 返回状态值:
完成代码:
VI_SUCCESS 事件通知不允许
VI_SUCCESS_EVENT_DIS 至少一种事件处理机制不被允许错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_EVENT 特定事件不存在或不被支持
VI_ERROR_INV_MECH 事件处理机制不合法
4) 描述:该操作取消特定事件的服务通知。
5) 相关项:参见viEventHandler()、viInstallHandler()、viUnInstallHandler()。
6) 实现要求:若一个对话通道上的事件处理机制不允许,事件登录还将保留。
13、 viQueryEventMech(vi,eventType,mechanism)
1) 目标:查询事件处理机制
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
eventType 输入 ViEventType 事件标识符
mechanism 输出 ViUInt16 事件处理机制
3) 返回状态值:
完成代码:
VI_SUCCESS 事件查询完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_EVENT 特定事件不存在或不被支持
4) 描述:该操作查询特定事件处理机制,所有事件处理机制返回值以“位或”操作值形式给出。
5) 相关项:参见viEventHandler()、viInstallHandler()、viUnInstallHandler()。
6) 实现要求:无。
14、 viInstallHandler(vi,eventType,handler,userHandle)
1) 目标:安装事件回调句柄
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
eventType 输入 ViEventType 事件标识符
handler 输入 ViHndlr 应用程序中的事件句柄
userHandle 输入 ViAddr 事件句柄值
3) 返回状态值:
完成代码:
VI_SUCCESS 安装事件句柄完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_EVENT 特定事件不存在或不被支持
4) 描述:该操作允许应用程序去安装事件处理句柄,句柄由输入参数handler唯一确定,事件类型包括资源事件(VI_RSRC_EVENT)、系统事件(VI_SYS_EVENT)、异常事件(VI_EXCEPTION),当事件类型参数设为所有事件(VI_ALL_EVENTS)时,以上三种类型事件句柄均被设置。
5) 相关项:参见viEventHandler()、viUnInstallHandler()。
6) 实现要求:无。
15、 viUninstallHandler(vi,eventType,handler,userHandle)
1) 目标:卸载事件回调句柄
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
eventType 输入 ViEventType 事件标识符
handler 输入 ViHndlr 应用程序中的事件句柄
userhandle 输入 ViAddr 事件句柄值
3) 返回状态值:
完成代码:
VI_SUCCESS 卸载事件句柄完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_EVENT 特定事件不存在或不被支持
VI_ERROR_INV_HNDLR_REF 句柄参数与所有已安装的句柄不匹配
4) 描述:该操作允许应用程序去卸载事件处理句柄,句柄由输入参数handler唯一确定,事件类型包括资源事件(VI_RSRC_EVENT)、系统事件(VI_SYS_EVENT)、异常事件(VI_EXCEPTION),当事件类型参数设为所有事件(VI_ALL_EVENTS)时,以上三种类型事件句柄均被卸载。
4) 相关项:参见viEventHandler()、viEnableEvent()。
5) 实现要求:卸装的句柄一定要先安装。
16、 viQueryHandlers(vi,eventType,handlers,userHandle)
1) 目标:查询事件已安装句柄
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
eventType 输入 ViEventType 事件标识符
handlers 输出 ViPHndlr 应用程序中的事件句柄
userHandle 输出 ViAddr 事件句柄值
3) 返回状态值:
完成代码:
VI_SUCCESS 查询事件句柄完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_EVENT 特定事件不存在或不被支持
4) 描述:该操作查询一种事件类型的所有已安装的事件句柄。
5) 相关项:参见viInstallHandler()、viUnInstallHandler()。
6) 实现要求:无。
17、 viAcknowledgeEvent(vi,eventType,context)
1) 目标:对事件通知作响应
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
eventType 输入 ViEventType 事件标识符
context 输入 ViEvent 事件信息
3) 返回状态值:
完成代码:
VI_SUCCESS 事件响应完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_EVENT 特定事件不存在或不被支持
VI_ERROR_INV_CONTEXT 事件信息不合法
4) 描述:该操作响应已经报告的事件发生,事件发生由信息结构唯一确定。
5) 相关项:参见viEventHandler()、viInstallHandler()。
6) 实现要求:资源将在接收到所有通知后才对事件作出响应。
18、 viWaitOnEvent(vi,eventType,timeout,outContext)
viWaitOnMultipleEvents(vi,eventTypeList,timeout,outContext,
outEventType)
1) 目标:等待特定事件的发生
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
eventType 输入 ViPEventType 事件标识符
eventTypeList 输入 ViPUInt16 事件标识符列表
timeout 输入 ViUInt32 操作超时值
outContext 输出 ViPEvent 事件信息
outEventType 输出 ViEventType 返回事件类型
3) 返回状态值:
完成代码:
VI_SUCCESS 事件等待完成
VI_SUCCESS_QUEUE_EMPTY 事件等待完成,事件队列空
VI_WARN_QUEUE_TRIP 事件等待完成。队列中有多个事件
VI_WARN_QUEUE_FULL 事件等待完成。队列已满
VI_WARN_QUEUE_OVERFLOW 事件等待完成。队列溢出且有事件丢失
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_EVENT 特定事件不存在或不被支持
VI_ERROR_INV_CONTEXT 事件信息不合法
VI_ERROR_TMO 操作超时
VI_ERROR_QUEUE_TRIP 队列中事件过多
VI_ERROR_QUEUE_FULL 队列满
VI_ERROR_QUEUE_OVERFLOW 队列事件溢出
4) 描述:viWaitOnEvent()等待一个事件,viWaitOnMultipleEvents()等待多个事件。
5) 相关项:参见viEnableEvent()。
6) 实现要求:当超时值为VI_INFINITE时,则会无限制等待下去。
19、 viDiscardEvents(vi,eventType,mechanism)
1) 目标:刷新一个对话通道上的事件发生
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
eventType 输入 ViEventType 事件标识符
mechanism 输入 ViUInt16 事件处理机制
3) 返回状态值:
完成代码:
VI_SUCCESS 事件刷新完成
VI_SUCCESS_QUEUE_EMPTY 事件刷新完成,事件队列空
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_EVENT 特定事件不存在或不被支持
VI_ERROR_INV_MECH 事件处理机制不当
4) 描述:该操作刷新队列中所有事件发生与事件登录,所有未被处理事件的信息也将被丢掉。
5) 相关项:参见viEnableEvent()。
6) 实现要求:该操作会引起事件丢失。
20、 viGetEventInfo(vi,eventType,context,rsrcName,info)
1) 目标:获取前一个事件发生的信息
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
eventType 输入 ViEventType 事件标识符
context 输入/输出 ViEvent 事件信息
rsrcName 输出 ViString 资源名
info 输出 ViAddr 异常事件信息
3) 返回状态值:
完成代码:
VI_SUCCESS 命令传递完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_EVENT 特定事件不存在或不被支持
4) 描述:该操作用于取回事件处理信息,返回信息包括一个事件信息数据结构。
5) 相关项:参见viRaiseEvent()。
6) 实现要求:无。
21、 viRaiseEvent(vi,eventType,context,target)
1) 目标:通知资源或对话通道事件已发生
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
eventType 输入 ViEventType 事件标识符
context 输入 ViEvent 事件信息
target 输入 ViBoolean 请求目标(资源或通道)
3) 返回状态值:
完成代码:
VI_SUCCESS 通知事件发生完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_TARGET 请求目标不当
VI_ERROR_INV_EVENT 特定事件不存在或不被支持
VI_ERROR_INV_CONTEXT 事件信息不当
VI_ERROR_QUEUE_FULL 事件队列满
VI_ERROR_NENABLED 当前无法感知事件
4) 描述:该操作用于通知资源或通道事件已发生,可以生成除了异常事件之外的所有类型事件。
5) 相关项:参见viEnableEvent()、viWaitOnEvent。
6) 实现要求:该操作可用于模拟一个事件。
22、 viEventHandler(vi,eventType,context,userHandle)
1) 目标:事件服务过程原型
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
eventType 输入 ViEventType 事件标识符
context 输入 ViEvent 事件信息
userHandle 输入 ViAddr 事件句柄值
3) 返回状态值:
完成代码:
VI_SUCCESS 事件处理完成
错误代码:
VI_ERROR_ABORT 终止操作引发异常
VI_ERROR_RESET 终止所有操作,复位至缺省状态
VI_ERROR_FAIL 终止对话通道所有操作
VI_ERROR_KILL 终止对话通道所有操作,并自动关闭通道
4) 描述:该操作在通道接收到一个事件并处理该事件时被调用。
5) 相关项:无。
6) 实现要求:在多个句柄情况下,只有所有句柄运行都终止时,正常运行才终止。
3.3.2 VISA资源管理器资源
VISA资源管理器(VI_RSRC_VISA_RM)是VISA各资源的中间调度器,其在VISA各子系统元件在整个系统中配合工作中起着重要作用。资源管理器的基本功能包括:
1) 分配资源地址
2) 分配资源识别号(ID)
3) 进行操作调用
4) 进行事件管理
图3.3体现了VISA资源管理器在系统配置中的中间调度作用。
图3.3 VISA资源管理器与其它资源的关系示图
根据VISA规范,VISA资源管理器资源继承了资源模板定义的所有属性、事件与操作,在资源模板基础上本身没有加以扩展自己的属性、事件与操作。但资源管理器资源具有自己的语义,在系统资源中起着根资源的作用。
3.3.3 VISA仪器控制资源
在VISA资源模板的基础上,VISA仪器控制资源定义了仪器控制特有的属性、事件与操作。在仪器控制资源中定义的功能是通用的仪器功能,它适用于各种仪器类型。
VISA仪器控制资源中包括:
n 写资源
n 读资源
n 格式化I/O资源
n 触发资源
n 状态/服务请求资源
n 清除资源
n 高级存取资源
n 低级存取资源
n 器件特定命令资源
n CPU接口资源
VISA仪器控制各资源的关系如图3.4所示。
图3.4 VISA仪器控制资源关系概图
在VISA仪器控制资源中,CPU接口资源是相对独立的,它与其它仪器控制资源无内部联系。这并不是说CPU接口资源不能与其它资源相互调用,但它不能调用其它仪器控制资源的相关操作,也不能被其它仪器控制资源调用其相关操作。而如格式化I/O资源的操作是依赖于写资源及读资源操作的,它们之间存在着内部关联性。同样,触发资源、状态/服务请求资源及清除资源与器件特定命令资源,高级存取资源与低级存取资源之间也存在着内部关联性。
n 写资源(VI_RSRC_WR):
1. 资源概述:控制器向器件传送任意数据块,器件可以将接收到的数据块解释为消息、命令或二进制编码数据。
2. 资源属性表及属性描述:
属性名 描述
VI_ATTR_FDC_ACCESS_MODE FDC(高速数据通道)缓冲区存取模式
VI_ATTR_FDC1_SUPP FDC版本1是否有效
VI_ATTR_FDC2_SUPP FDC版本2是否有效
VI_ATTR_FDC_CHNL FDC数据传送通道
VI_ATTR_FDC_GEN_SIGNAL_EN 是否允许通过FDC传送数据
VI_ATTR_FDC_MODE FDC模式
VI_ATTR_FDC_USE_PAIR 一对或一个FDC有效
VI_ATTR_FDC_USE_VER FDC协议版本
VI_ATTR_INP_RDY_NOTIFY_EN 数据有效是否被通知
VI_ATTR_NRDY_ABORT_EN 器件不再接收数据时是否被通知
VI_ATTR_PHYS_ADDR 器件地址
VI_ATTR_REPEAT_ADDR_EN 是否使用重复地址
VI_ATTR_SEND_END_ON 终止符是否被确认
_TERMCHAR_EN
VI_ATTR_SEND_END_ON 是否将END作为终止符
VI_ATTR_TERMCHAR 终止符
VI_ATTR_TMO_UNIT 超时值单位
VI_ATTR_TMO_VALUE 超时值
VI_ATTR_TRANSFER_MECH 传送机制(DMA或PIO)
VI_ATTR_WR_PROT 传送协议
VI_ATTR_CMDR_SERV 主从模式
VI_ATTR_ASRL_BAUD 波特率
VI_ATTR_ASRL_DATA_BITS 数据位
VI_ATTR_ASRL_PARITY 校验极性
VI_ATTR_ASRL_STOP_BITS 停止位
VI_ATTR_ASRL_FLOW_CNTRL 数据流控制状态
3. 写资源定义的事件如下所示:
事件 说明
VI_EVENT_IO_COMPLETION 异步I/O操作已完成
4. 写资源定义的操作如下:
viWrite(vi,buf,count,retCount)
viWriteAsync(vi,buf,count,jobId)
viWriteStatus(vi,jobId,jobStatus)
4.1. viWrite(vi,buf,count,retCount)
1) 目标:将数据同步写入到器件中
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
buf 输入 ViBuf 数据块位置
count 输入 ViUInt32 写入的字节数
retCount 输出 ViPUInt32 实际传送字节数
3) 返回状态值:
完成代码:
VI_SUCCESS 同步写操作完成
VI_WARN_NRDY_ABORT 同步写操作退出,器件未准备好输入数据
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_TMO 超时错误
VI_ERROR_RAW_WR_PROT 传送时写协议被破坏
_VIOL
VI_ERROR_RAW_RD_PROT 传送时读协议被破坏
_VIOL
VI_ERROR_OUTP_PROT_VIOL 传送时输出协议错误
VI_ERROR_INP_PROT_VIOL 传送时输入协议错误
VI_ERROR_BERR 传送时总线错误
VI_ERROR_ABORT 传送时用户退出
VI_ERROR_IN_PROGRESS 同步写已执行
VI_ERROR_INV_SETUP 设置错误,不能开始写操作
4) 描述:该操作将位于buf中的数据写入到器件中去,任一写资源通道只能登录一个同步写操作。
5) 相关项:参见viWriteAsync()、viTerminate()、viWriteStatus()、viRead()、viReadAsync()。
6) 实现要求:无。
4.2. viWriteAsync(vi,buf,count,jobId)
1) 目标:将数据异步写入到器件中
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
buf 输入 ViBuf 数据块位置
count 输入 ViUInt32 写入的字节数
jobId 输出 ViPjobId 异步写操作作业标识符
3) 返回状态值:
完成代码:
VI_SUCCESS 异步写操作完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_QUEUE_ERROR 不能进行写操作排队
4) 描述:该操作将位于buf中的数据异步写入到器件中去,任一写资源通道可以登录多个异步写操作,进行排队处理。
5) 相关项:参见viWrite()、viTerminate()、viWriteStatus()、viRead()、viReadAsync()。
6) 实现要求:无。
4.3. viWriteStatus(vi,jobId,jobStatus)
1) 目标:获取写操作状态
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
jobId 输入 VijobId 写操作作业标识符
jobStatus 输出 ViPJobstatus 写操作状态
3) 返回状态值:
完成代码:
VI_SUCCESS 状态获取完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_JOBID 作业标识符不当
4) 描述:当操作为同步时,标识符唯一确定,为VI_SYNC;当操作为异步时,标识符为操作的输出参数值。
5) 相关项:参见viWriteAsync()。
6) 实现要求:无。
n 读资源(VI_RSRC_RD):
1. 资源概述:控制器从器件读出任意数据块,控制器可以将接收到的数据块解释为消息、命令或二进制编码数据。
2. 资源属性表及属性描述:
属性名 描述
VI_ATTR_FDC_ACCESS_MODE FDC(高速数据通道)缓冲区存取模式
VI_ATTR_FDC1_AVAIL FDC版本1是否有效
VI_ATTR_FDC2_AVAIL FDC版本2是否有效
VI_ATTR_FDC_CHNL FDC数据传送通道
VI_ATTR_FDC_GEN_SIGNAL_EN 是否允许通过FDC传送数据
VI_ATTR_FDC_MODE FDC模式
VI_ATTR_FDC_USE_PAIR 一对或一个FDC有效
VI_ATTR_FDC_USE_VER FDC协议版本
VI_ATTR_PHYS_ADDR 器件地址
VI_ATTR_7_8_BIT_CMP 终止符有效位
VI_ATTR_NRDY_ABORT_EN 器件不再输出数据时是否被通知
VI_ATTR_OUTP_RDY_NOTIFY_EN 数据有效是否被通知
VI_ATTR_RD_PROT 传送协议
VI_ATTR_REPEAT_ADDR_EN 是否使用重复地址
VI_ATTR_SUPPRESS_END_ON 终止符是否被禁止
VI_ATTR_TERMCHAR 终止符
VI_ATTR_TERMCHAR_EN 终止符是否被允许
VI_ATTR_TMO_UNIT 超时值单位
VI_ATTR_TMO_VALUE 超时值
VI_ATTR_TRANSFER_MECH 传送机制(DMA或PIO)
VI_ATTR_CMDR_SERV 主从模式
VI_ATTR_ASRL_BAUD 波特率
VI_ATTR_ASRL_DATA_BITS 数据位
VI_ATTR_ASRL_PARITY 校验极性
VI_ATTR_ASRL_STOP_BITS 停止位
VI_ATTR_ASRL_FLOW_CNTRL 数据流控制状态
3. 读资源定义的事件如下所示:
事件 说明
VI_EVENT_IO_COMPLETION 异步I/O操作已完成
4. 读资源定义的操作如下:
viRead(vi,buf,count,retCount)
viReadAsync(vi,buf,count,jobId)
viReadStatus(vi,jobId,jobStatus)
4.1. viRead(vi,buf,count,retCount)
1) 目标:从器件同步读取数据
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
buf 输出 ViBuf 数据块位置
count 输入 ViUInt32 读出的字节数
retCount 输出 ViPUInt32 实际传送字节数
3) 返回状态值:
完成代码:
VI_SUCCESS 同步读数据完成
VI_SUCCESS_TERM_CHAR 特定终止符被读取
VI_SUCCESS_MAX_CNT 读取的字节数与count数相同
VI_WARN_NRDY_ABORT 传送退出,器件未准备好输出数据
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_TMO 超时错误
VI_ERROR_RAW_WR_PROT 传送时写协议被破坏
_VIOL
VI_ERROR_RAW_RD_PROT 传送时读协议被破坏
_VIOL
VI_ERROR_OUTP_PROT_VIOL 传送时输出协议错误
VI_ERROR_INP_PROT_VIOL 传送时输入协议错误
VI_ERROR_BERR 传送时总线错误
VI_ERROR_ABORT 传送时用户退出
VI_ERROR_IN_PROGRESS 同步写已执行
VI_ERROR_INV_SETUP 设置错误,不能开始写操作
4) 描述:该操作将从器件中读取的值放在buf,任一读资源通道只能登录一个同步读操作。
5) 相关项:参见viWriteAsync()、viTerminate()、viWriteStatus()、viReadAsync()、viReadStatus()。
6) 实现要求:当满足以下三种情况的一种或几种时,被认为读操作完成:一是结束标号被读取,二是特定终止符被读取,三是读取的字节数与所需字节数相同。
4.2. viReadAsync(vi,buf,count,jobId)
1) 目标:从器件异步读取数据
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
buf 输出 ViBuf 数据块位置
count 输入 ViUInt32 读出的字节数
jobId 输出 ViPjobId 异步读操作作业标识符
3) 返回状态值:
完成代码:
VI_SUCCESS 异步读操作完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_QUEUE_ERROR 不能进行读操作排队
4) 描述:该操作将从器件读取的数据放于buf中,任一读资源通道可以登录多个异步读操作,进行排队处理。
5) 相关项:参见viWrite()、viTerminate()、viWriteAsync()、viRead()、viReadStatus()。
6) 实现要求:无。
4.3. viReadStatus(vi,jobId,jobStatus)
1) 目标:获取读操作状态
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
jobId 输入 VijobId 读操作作业标识符
jobStatus 输出 ViPJobstatus 读操作状态
3) 返回状态值:
完成代码:
VI_SUCCESS 状态获取完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_JOBID 作业标识符不当
4) 描述:当操作为同步时,标识符唯一确定,为VI_SYNC;当操作为异步时,标识符为操作的输出参数值。
5) 相关项:参见viReadAsync()。
6) 实现要求:无。
n 格式化I/O资源(VI_RSRC_FMT_IO):
1. 资源概述:数据流格式化I/O操作,可进行格式化的器件读写操作,并可进行缓冲区的I/O格式化。
2. 资源属性表及属性描述:
属性名 描述
VI_ATTR_7_8_BIT_CMP 终止符位数
VI_ATTR_END_ON_TERMCHAR_EN 在GPIB系统中,EOI终止符是否被确认
VI_ATTR_NRDY_ABORT 器件不再输出数据时是否被通知
VI_ATTR_PROT 读/写协议
VI_ATTR_RD_BUF_OPER_MODE 读缓冲区操作模式
VI_ATTR_RD_SIZE 读缓冲区大小
VI_ATTR_REPEAT_ADDR 是否使用重复地址
VI_ATTR_RETURN_MODE 读/写操作返回模式
VI_ATTR_SEND_END_EN 是否将END作为终止符
VI_ATTR_SUPPRESS_END 是否禁止END作为终止符
VI_ATTR_TERMCHAR 终止符
VI_ATTR_TMO_UNIT 超时值单位
VI_ATTR_TMO_VALUE 超时值
VI_ATTR_TRANSFER_MECH 传送机制(DMA或PIO)
VI_ATTR_WR_BUF_OPER_MODE 写缓冲区操作模式
VI_ATTR_WR_BUF_SIZE 写缓冲区大小
VI_ATTR_ASRL_BAUD 波特率
VI_ATTR_ASRL_DATA_BITS 数据位
VI_ATTR_ASRL_PARITY 校验极性
VI_ATTR_ASRL_STOP_BITS 停止位
VI_ATTR_ASRL_FLOW_CNTRL 数据流控制状态
3. 格式化I/O资源定义的事件如下所示:无
4. 格式化I/O资源定义的操作如下:
viSetBuf(vi,mask,size)
viSetUBuf(vi,mask,size,buf)
viFlush(vi,mask)
viPrintf(vi,writeFmt,arg1,arg2…)
viVPrintf(vi,writeFmt,params)
viSPrintf(vi,buf,writeFmt,arg1,arg2…)
viSVPrintf(vi,buf,writeFmt,params)
viBWrite(vi,buf,count,retCount)
viScanf(vi,readFmt,arg1,arg2…)
viVScanf(vi,readFmt,params)
viSScanf(vi,buf,readFmt,arg1,arg2…)
viSVScanf(vi,buf,readFmt,params)
viBRead(vi,buf,count,retCount)
viQueryf(vi,writeFmt,readFmt,arg1,arg2…)
viVQueryf(vi,writeFmt,readFmt,params)
4.1. viSetBuf(vi,mask,size)
1) 目标:设置格式化I/O缓冲区大小
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
mask 输入 ViPUInt16 缓冲区类型
size 输入 ViPUInt32 缓冲区大小
3) 返回状态值:
完成代码:
VI_SUCCESS 缓冲区大小设置完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_ALLOC_MEM 系统无法分配缓冲区
VI_ERROR_INV_MASK 缓冲区类型设置错误
4) 描述:该操作改变读/写缓冲区大小,缓冲区类型可取VI_READ及VI_WRITE。
5) 相关项:参见viSefUBuf()、viFlush()。
6) 实现要求:调用该操作会刷新相关缓冲区。
4.2. viSetUBuf(vi,mask,size,buf)
1) 目标:设置格式化I/O用户缓冲区
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
mask 输入 ViPUInt16 缓冲区类型
size 输入 ViPUInt32 缓冲区大小
buf 输入 ViBuf 实际缓冲区地址
3) 返回状态值:
完成代码:
VI_SUCCESS 用户缓冲区设置完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_MASK 缓冲区类型设置错误
4) 描述:该操作为格式化I/O开辟一个缓冲区,该缓冲区不能用作其它用途。
5) 相关项:参见viSefBuf()。
6) 实现要求:调用该操作会刷新相关缓冲区。
4.3. viFlush(vi,mask)
1) 目标:手工刷新格式化I/O缓冲区
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
mask 输入 ViPUInt16 缓冲区类型
3) 返回状态值:
完成代码:
VI_SUCCESS 缓冲区刷新完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_IO I/O错误
VI_ERROR_TMO 超时错误
VI_ERROR_ABORT 在操作结束前收到退出信号
VI_ERROR_INV_MASK 缓冲区类型设置错误
4) 描述:该操作手动刷新相关读/写缓冲区内容。
5) 相关项:参见viSefBuf()、viSefUBuf()。
6) 实现要求:若对一空缓冲区进行刷新操作,相当于没有动作。
4.4. viPrintf(vi,writeFmt,arg1,arg2…)
1) 目标:按设定格式将数据传送到器件中
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
writeFmt 输入 ViString 参数格式
arg1,arg2… 输入 各个所需参数
3) 返回状态值:
完成代码:
VI_SUCCESS 参数成功地格式化
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_IO I/O错误
VI_ERROR_TMO 超时错误
VI_ERROR_ABORT 在操作结束前收到退出信号
VI_ERROR_FILE_NOPEN 文件没有打开或文件存取特性不当
VI_ERROR_NSUP_FMT 参数格式不当
4) 描述:该操作以一定格式将数据传送到器件中,viWrite()实际上是完成低层I/O操作。任一对话通道不能同时进行viWrite()及viPrintf()操作。
5) 相关项:参见viSPrintf()、viVPrintf()、viSVPrintf()、viBWrite()。
6) 实现要求:输入参数与其格式必须匹配。
4.5. viSPrintf(vi,buf,writeFmt,arg1,arg2…):与viPrintf()不同的只在于viSPrintf()将数据写入buf参数的缓冲区而非器件中。
4.6. viVPrintf(vi,writeFmt,params):与viPrintf()不同的只在于viVPrintf()中参数以列表形式给出。
4.7. viSVPrintf(vi,buf,writeFmt,params):与viPrintf()不同的只在于viSVPrintf()中参数以列表形式给出,并写入到缓冲区中。
4.8. viBWrite(vi,buf,count,retCount):与viWrite()不同的只在于viBWrite()将数据写入到缓冲区而不是器件中去。
4.9. viScanf(vi,readFmt,arg1,arg2…)
1) 目标:按设定格式从器件中读取数据
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
readFmt 输入 ViString 参数格式
arg1,arg2… 输出 各个所得参数值
3) 返回状态值:
完成代码:
VI_SUCCESS 数据成功地格式化并被读取
VI_SUCCESS_END_RECV END标志被接收到
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_IO I/O错误
VI_ERROR_TMO 超时错误
VI_ERROR_ABORT 在操作结束前收到退出信号
VI_ERROR_FILE_NOPEN 文件没有打开或文件存取特性不当
VI_ERROR_NSUP_FMT 参数格式不当
4) 描述:该操作以一定格式从器件中读取数据,viRead()实际上是完成低层I/O操作。任一对话通道不能同时进行viRead()及viScanf()操作。
5) 相关项:参见viSScanf()、viVScanf()、viSVScanf()、viBRead()。
6) 实现要求:输出参数与其格式必须匹配。
4.10. viSScanf(vi,buf,readFmt,arg1,arg2…):与viScanf()不同的只在于viSScanf()从buf参数的缓冲区中读出数据而非从器件中读取。
4.11. viVScanf(vi,readFmt,params):与viScanf()不同的只在于viVScanf()中参数以列表形式给出。
4.12. viSVScanf(vi,buf,readFmt,params):与viScanf()不同的只在于viSVScanf()中参数以列表形式给出,并从缓冲区中读取。
4.13. viBRead(vi,buf,count,retCount):与viRead()不同的只在于viBRead()从缓冲区而不是从器件中读取数据。
4.14. viQuery(vi,writeFmt,readFmt,arg1,arg2…)
1) 目标:按设定格式对器件进行数据读写
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
writeFmt 输入 ViString 写参数格式
readFmt 输入 ViString 读参数格式
arg1,arg2… 输入、输出 各个所需或所得参数值
3) 返回状态值:
完成代码:
VI_SUCCESS 参数成功地格式化并被读取或写入
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_IO I/O错误
VI_ERROR_INV_FMT 格式错误
VI_ERROR_TMO 超时错误
VI_ERROR_ABORT 在操作结束前收到退出信号
VI_ERROR_FILE_NOPEN 文件没有打开或文件存取特性不当
VI_ERROR_NSUP_FMT 参数格式不合法
4) 描述:该操作与器件进行数据交换,输入或输出是需要根据参数格式类型来定的,实际上包括了读与写操作。
5) 相关项:参见viBRead()、viBWrite()、viVQueryf()。
6) 实现要求:输入/输出参数与其格式必须匹配。
4.15. viVQueryf(vi,writeFmt,readFmt,params):与viQueryf()不同的是viVQueryf()参数以列表形式给出。
n 触发资源(VI_RSRC_TRIG):
1. 资源概述:监视与控制器件及接口的触发进程。
2. 资源属性表及属性描述:
属性名 描述
VI_ATTR_HW_TRIG_SENSE_EN 触发是否会引发CPU中断
VI_ATTR_TRIG_ASSERT_MODE 触发确认模式
VI_ATTR_TRIG_MAP_ROUTE 触发映射
VI_ATTR_TMO_UNIT 超时值单位
VI_ATTR_TMO_VALUE 超时值
VI_ATTR_TRIG_LINE 当前资源特定触发线
3. 触发资源定义的事件如下所示:
事件 说明
VI_EVENT_TRIG 硬件触发产生
4. 触发资源定义的操作如下:
viAssertTrigger(vi,protocol)
viMapTrigger(vi,srcTrig,destTrig,mode)
viUnmapTrigger(vi,srcTrig,destTrig)
4.1. viAssertTrigger(vi,protocol)
1) 目标:用特定协议确认硬件或软件触发
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
protocol 输入 ViUInt16 触发协议
3) 返回状态值:
完成代码:
VI_SUCCESS 特定触发确认
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_PROT 协议不当
VI_ERROR_NSUP_OPER 硬件不支持
VI_ERROR_TMO 超时错误
VI_ERROR_LINE_IN_USE 触发线正被使用
VI_ERROR_LINE_NCONFIG 触发线未配置
VI_ERROR_OPER_NCOMPLETE 上一个操作未完成
VI_ERROR_ACK_PENDING 上个响应正在登录,使这个操作退出
4) 描述:该操作包括的触发协议有:缺省协议、协议开启、协议关闭、协议开始、协议结束、协议同步、协议半同步、协议异步、协议半同步并等待响应、协议异步并等待响应等。
5) 相关项:参见viMapTrigger()、viUnmapTrigger()。
6) 实现要求:无。
4.2. viMapTrigger(vi,trig,direction,mode)
1) 目标:将特定触发、时钟或前面板信号映射到另一信号
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
trig 输入 ViString 映射源或目标触发线
direction 输入 ViUInt16 映射方向
mode 输入 ViUInt16 信号调理方式
3) 返回状态值:
完成代码:
VI_SUCCESS 两个信号映射成功
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_NSUP_MODE 不支持特定模式
VI_ERROR_NUSP_SRC_TRIG 触发信号源不支持
VI_ERROR_NUSP_DEST_TRIG 触发信号目标不支持
VI_ERROR_TRIG_MAPPED 目标触发器已被映射
4) 描述:映射信号包括特定触发信号、时钟信号或外部信号等。
5) 相关项:参见viUnmapTrigger()、viAssertTrigger()。
6) 实现要求:无。
4.3. viUnmapTrigger(vi,trig)
1) 目标:取消信号之间的映射
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
trig 输入 ViString 被映射的触发线
3) 返回状态值:
完成代码:
VI_SUCCESS 两个信号映射取消成功
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_NUSP_SRC_TRIG 触发信号源不支持
VI_ERROR_NUSP_DEST_TRIG 触发信号目标不支持
VI_ERROR_TRIG_NMAPPED 特定触发信号当前未被映射
4) 描述:映射信号包括特定触发信号、时钟信号或外部信号等。
5) 相关项:参见viMapTrigger()、viAssertTrigger()。
6) 实现要求:无。
n 状态/服务请求资源(VI_RSRC_SRQ):
1. 资源概述:包括两个作用:一是作为服务请求的响应者,可监测系统的服务请求并获得状态信息;二是作为服务请求的发生者,可产生服务请求并提供状态信息。
2. 资源属性表及属性描述:
属性名 描述
VI_ATTR_AUTOPOLL_EN 资源操作模式
VI_ATTR_STB 服务请求状态
VI_ATTR_TMO_UNIT 超时值单位
VI_ATTR_TMO_VALUE 超时值
3. 状态/服务请求资源定义的事件如下所示:
事件 说明
VI_EVENT_SERVICE_REQ 服务请求通知事件
4. 状态/服务请求资源定义的操作如下:
viReadSTB(vi,status)
viRequestServ(vi,request,status)
4.1. viReadSTB(vi,status)
1) 目标:读取服务请求状态字节
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
status 输出 ViUInt16 服务请求状态
3) 返回状态值:
完成代码:
VI_SUCCESS 服务请求状态字节读取完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_SRQ_NOCCURRED 服务请求未收到
VI_ERROR_TMO 超时错误
VI_ERROR_BERR 总线错误
4) 描述:该操作从一个服务请求者(消息基器件)中读取服务请求状态。
5) 相关项:参见viEventHandler()、viSetAttribute()、viGetAttribute()。
6) 实现要求:无。
4.2. viRequestServ(vi,request,status)
1) 目标:向服务提供者(命令者)确认服务请求
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
request 输入 ViBoolean 服务请求目的
status 输入 ViUInt16 服务请求状态
3) 返回状态值:
完成代码:
VI_SUCCESS 服务请求完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_SERVICE_REQ 服务请求状态字节与请求参数不一致
VI_ERROR_TMO 超时错误
VI_ERROR_BERR 总线错误
4) 描述:该操作用于当前器件向服务提供者发送服务请求。
5) 相关项:参见VI_EVENT_SRQ_SERVICED事件。
6) 实现要求:无。
n 清除资源(VI_RSRC_CLR):
1. 资源概述:向器件发送清除命令。
2. 资源属性表及属性描述:
属性名 描述
VI_ATTR_HW_SENSE_EN 硬件是否对接收到指令敏感
VI_ATTR_PHYS_ADDR 器件地址
VI_ATTR_TMO_UNIT 超时值单位
VI_ATTR_TMO_VALUE 超时值
3. 清除资源定义的事件如下所示:
事件 说明
VI_EVENT_CLEAR 器件清除命令接收事件
4. 清除资源定义的操作如下:
viClear(vi)
4.1. viClear(vi)
1) 目标:清除器件
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
3) 返回状态值:
完成代码:
VI_SUCCESS 器件清除完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_BERR 总线错误
VI_ERROR_TMO 超时错误
4) 描述:该操作向器件发送一个清除命令。
5) 相关项:无。
6) 实现要求:无。
n 高级存取资源(VI_RSRC_HL_ACC):
1. 资源概述:在接口级对器件的寄存器进行存取操作。
2. 资源属性表及属性描述:
属性名 描述
VI_ATTR_BUS_TYPE 接口总线类型
VI_ATTR_PHYS_ADDR 器件地址
VI_ATTR_TYPE 高级存取对象类型(器件还是接口)
VI_ATTR_DEST_ACCESS_PRIV 写操作特性
VI_ATTR_DEST_BYTE_ORDER 写操作字节顺序
VI_ATTR_DO_RETRY 是否允许软件重入
VI_ATTR_SRC_ACCESS_PRIV 读操作特性
VI_ATTR_SRC_BYTE_ORDER 读操作字节顺序
VI_ATTR_USE_BLOCK 是否允许块传送
VI_ATTR_TRANSFER_MECH 传送机制
VI_ATTR_SRC_INCREMENT 源偏移量
VI_ATTR_DEST_INCREMENT 目标偏移量
3. 高级存取资源定义的事件如下所示:无
4. 高级存取资源定义的操作如下:
viIn(vi,space,offset,width,value)
viIn8(vi,space,offset,value)
viIn16(vi,space,offset,value)
viIn32(vi,space,offset,value)
viIn64(vi,space,offset,value)
viOut(vi,space,offset,width,value)
viOut8(vi,space,offset,value)
viOut16(vi,space,offset,value)
viOut32(vi,space,offset,value)
viOut64(vi,space,offset,value)
viMove(vi,srcspace,srcOffset,srcWidth,destspace,destOffset,
destWidth,length)
4.1. viIn(vi,space,offset,width,value)
viIn8(vi,space,offset,value)
viIn16(vi,space,offset,value)
viIn32(vi,space,offset,value)
viIn64(vi,space,offset,value)
1) 目标:从接口总线读取8,16,32或64位字
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
space 输入 ViUInt16 地址空间类型
offset 输入 ViUInt32 读取接口/器件偏移量
width 输入 ViUInt16 读取数据长度
value 输出 ViBuf、ViPUInt(8、16、32、64) 读取数据
3) 返回状态值:
完成代码:
VI_SUCCESS 读操作完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_BERR 总线错误
VI_ERROR_INV_SPACE 地址空间不合法
VI_ERROR_INV_OFFSET 偏移量不合法
VI_ERROR_NSUP_BYTE_ORDER 不支持特定字节顺序
VI_ERROR_NSUP_OFFSET 硬件不支持特定地址偏移量
VI_ERROR_NSUP_PRIV 硬件不支持存取特性
4) 描述:该操作用特定数据长度与地址空间读取位于一定地址的数据值。其中viIn8()、viIn16()、viIn32()、viIn64分别规定数据长度为8、16、32与64位。
5) 相关项:viOut()。
6) 实现要求:参数value值viBuf对应viIn(),viPUInt8对应viIn8(),viPUInt16对应viIn16(),viPUInt32对应viIn32(),viPUInt64对应viIn64()。
4.2. viOut(vi,space,offset,width,value)
viOut8(vi,space,offset,value)
viOut16(vi,space,offset,value)
viOut32(vi,space,offset,value)
viOut64(vi,space,offset,value)
1) 目标:向接口总线写入8,16,32或64位字
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
space 输入 ViUInt16 地址空间类型
offset 输入 ViUInt32 写入接口/器件偏移量
width 输入 ViUInt16 写入数据长度
value 输入 ViBuf、ViPUInt(8、16、32、64) 写入数据
3) 返回状态值:
完成代码:
VI_SUCCESS 写操作完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_BERR 总线错误
VI_ERROR_INV_SPACE 地址空间不当
VI_ERROR_INV_OFFSET 偏移量不当
VI_ERROR_NSUP_BYTE_ORDER 不支持特定字节顺序
VI_ERROR_NSUP_OFFSET 硬件不支持特定地址偏移量
VI_ERROR_NSUP_PRIV 硬件不支持存取特性
4) 描述:该操作用特定数据长度与地址空间将数据写入到一定地址中。其中viOut8()、viOut16()、viOut32()、viOut64分别规定数据长度为8、16、32与64位。
5) 相关项:viIn()。
6) 实现要求:参数value值viBuf对应viOut(),viPUInt8对应viOut8(),viPUInt16对应viOut16(),viPUInt32对应viOut32(),viPUInt64对应viOut64()。
4.3. viMove(vi,srcSpace,srcOffset,srcWidth,destSpace,destOffset,destWidth,length)
1) 目标:移动数据块
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
srcSpace 输入 ViUInt16 源空间地址
srcOffset 输入 ViUInt32 源偏移量
srcWidth 输入 ViUInt16 源数据长度
destSpace 输入 ViUInt16 目标空间地址
destOffset 输入 ViUInt32 目标偏移量
destWidth 输入 ViUInt16 目标数据长度
length 输入 ViUInt32 传送数据个数
3) 返回状态值:
完成代码:
VI_SUCCESS 数据块移动完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_BERR 总线错误
VI_ERROR_INV_SPACE 地址空间不当
VI_ERROR_INV_OFFSET 偏移量不当
VI_ERROR_INV_WIDTH 数据长度不当
VI_ERROR_NSUP_BYTE_ORDER 不支持特定字节顺序
VI_ERROR_NSUP_OFFSET 硬件不支持特定地址偏移量
VI_ERROR_NSUP_VAR_WIDTH 源与目标数据长度不一致
VI_ERROR_NSUP_PRIV 硬件不支持存取特性
4) 描述:该操作将数据从源地址移动到目标地址。源与目标数据长度必须一致。
5) 相关项:无。
6) 实现要求:无。
n 低级存取资源(VI_RSRC_LL_ACC):
1. 资源概述:在寄存器级对器件的寄存器进行存取操作。
2. 资源属性表及属性描述:
属性名 描述
VI_ATTR_BUS_TYPE 接口总线类型
VI_ATTR_TMO_UNIT 超时值单位
VI_ATTR_TMO_VALUE 超时值
VI_ATTR_ACC_PRIV 存取特性
VI_ATTR_ADDR_SPACE 地址空间
VI_ATTR_BLOCK 块传送允许
VI_ATTR_BYTE_PREFETCH 是否允许预取操作
VI_ATTR_VIRT_BASE 虚拟基地址
VI_ATTR_WIN_BASE_ADDR 总线基地址
VI_ATTR_WIN_OWNER 用户存取特性
VI_ATTR_WR_POST 写登记是否允许
VI_ATTR_A16_SPC_INFO A16空间映射信息
VI_ATTR_A24_SPC_INFO A24空间映射信息
VI_ATTR_A32_SPC_INFO A32空间映射信息
3. 低级存取资源定义的事件如下所示:
事件 说明
VI_EVENT_BERR 总线错误发生事件
4. 低级存取资源定义的操作如下:
viMap(vi,mapSpace,mapBase,mapSize,owner,suggested,address)
viUnMap(vi)
viPoke(vi,addr,width,value)
viPoke8(vi,addr,value)
viPoke16(vi,addr,value)
viPoke32(vi,addr,value)
viPoke64(vi,addr,value)
viPeek(vi,addr,width,value)
viPeek8(vi,addr,value)
viPeek16(vi,addr,value)
viPeek32(vi,addr,value)
viPeek64(vi,addr,value)
4.1. viMap(vi,mapSpace,mapBase,mapSize,access,suggested,address)
1) 目标:内存空间映射
2) 参数表:
参数名 输入/输出方向 数据类型 描述
Vi 输入 ViSession 对话通道标识符(句柄)
MapSpace 输入 ViUInt16 映射地址空间
MapBase 输入 ViBusAddress 内存偏移量
MapSize 输入 ViBusSize 映射内存大小
Access 输入 ViBoolean 映射特性
Suggested 输入 ViBuf 映射是否允许确认
Address 输出 ViPBuf 映射地址
3) 返回状态值:
完成代码:
VI_SUCCESS 地址映射完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_INV_SPACE 地址空间不当
VI_ERROR_INV_OFFSET 偏移量不当
VI_ERROR_NSUP_BYTE_ORDER 不支持特定字节顺序
VI_ERROR_NSUP_OFFSET 硬件不支持特定地址偏移量
VI_ERROR_NSUP_PRIV 硬件不支持存取特性
VI_ERROR_TMO 超时错误
4) 描述:该操作进行特定内存空间映射。
5) 相关项:参见viUnmap()。
6) 实现要求:在由于资源限制致使viMap()不能立即执行,则其将沉睡到资源有效或超时情况发生。
4.2. viUnMap(vi)
1) 目标:取消内存映射
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
3) 返回状态值:
完成代码:
VI_SUCCESS 映射取消完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_WINDOW_NMAPPED 标识符不当
4) 描述:该操作应与映射操作一一对应。
5) 相关项:参见viMap()。
6) 实现要求:无。
4.3. viPoke(vi,addr,width,value)、viPoke8(vi,addr,value)
viPoke16(vi,addr,value)、viPoke32(vi,addr,value)
viPoke64(vi,addr,value)
1) 目标:写数据
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
addr 输入 ViBuf 数据存储地址
width 输入 ViUInt16 数据长度
value 输入 ViBuf、ViUInt8、ViUInt16、ViUInt32、ViUInt64 存储数据值
3) 返回状态值:无
4) 描述:该操作将数据写入到addr参数表示的地址中。
5) 相关项:参见viPeek()。
6) 实现要求:数据类型viBuf对应viPoke(),viUInt8对应viPoke8(),viUInt16对应viPoke16(),viUInt32对应viPoke32(),viUInt64对应viPoke64()。
4.4. viPeek(vi,addr,width,value)、viPeek8(vi,addr,value)
viPeek16(vi,addr,value)、viPeek32(vi,addr,value)
viPeek64(vi,addr,value)
1) 目标:读数据
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
addr 输入 ViBuf 数据存储地址
width 输入 ViUInt16 数据长度
value 输出 ViBuf、ViUInt8、ViUInt16、ViUInt32、ViUInt64 存储数据值
3) 返回状态值:无
4) 描述:该操作从addr参数表示的地址中读取数据。
5) 相关项:参见viPoke()。
6) 实现要求:其中数据类型viBuf对应viPeek(),viPUInt8对应viPeek8(),viPUInt16对应viPeek16(),viPUInt32对应viPeek32(),viPUInt64对应viPeek64()。
n 器件特定命令资源(VI_RSRC_DEV_CMD):
1. 资源概述:允许发送与接收命令,并取得命令请求与命令反应,在检查到协议错误时产生一个协议错误信息。
2. 资源属性表及属性描述:
属性名 描述
VI_ATTR_HW_EN 硬件允许与否
VI_ATTR_TMO_UNIT 超时值单位
VI_ATTR_TMO_VALUE 超时值
VI_ATTR_PHYS_ADDR 器件地址
3. 器件特定命令资源定义的事件如下所示:
事件 说明
VI_EVENT_DEV_CMD 接收到命令或查询事件
4. 器件特定命令资源定义的操作如下:
viSendCommand(vi,command,param)
viQueryRequest(vi,operationMode,command,param,len,response)
viGenProtError(vi,protError)
4.1. viSendCommand(vi,command,param)
1) 目标:向器件发送命令
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
command 输入 ViUInt32 命令列表
param 输入 ViAddr 参数值
3) 返回状态值:
完成代码:
VI_SUCCESS 命令发送完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_TMO 超时错误
VI_ERROR_BERR 总线错误
VI_ERROR_RAW_RD_PROT_VIOL读协议错误
VI_ERROR_RAW_WR_PROT_VIOL写协议错误
VI_ERROR_OUTP_PROT_VIOL 输出协议错误
VI_ERROR_INP_PROT_VIOL 输入协议错误
4) 描述:该操作向器件发送特定命令,命令包括:获取硬件版本信息、获取软件版本信息、发送字串命令、发送长字串命令、发送扩展字串命令、发这GPIB命令及发送接口缺省命令。
5) 相关项:参见viQueryRequest()。
6) 实现要求:无。
4.2. viQueryRequest(vi,operationMode,command,param,len,response)
1) 目标:请求查询并返回响应值
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
operationMode 输入 ViUInt16 操作类型
command 输入 ViUInt32 命令列表
param 输入 ViAddr 参数值
len 输入/输出 ViUInt32 响应者数据长度
response 输出 ViAddr 命令响应
3) 返回状态值:
完成代码:
VI_SUCCESS 查询完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作
VI_ERROR_CMD_TMO 命令发送超时错误
VI_ERROR_RESP_TMO 命令响应超时错误
VI_ERROR_BERR 总线错误
VI_ERROR_ABORT 传送时用户退出
VI_ERROR_RAW_RD_PROT_VIOL读协议错误
VI_ERROR_RAW_WR_PROT_VIOL写协议错误
VI_ERROR_OUTP_PROT_VIOL 输出协议错误
VI_ERROR_INP_PROT_VIOL 输入协议错误
VI_ERROR_NSUP_COMMAND 命令未收到
VI_ERROR_RESP_PENDING 前个响应正在登录
4) 描述:该操作可以向器件发送命令或接收上一个命令的响应。参数operationMode表明了操作类型。
5) 相关项:参见viSendCommand()。
6) 实现要求:无。
4.3. viGenProtError(vi,protError)
1) 目标:产生一个协议错误
2) 参数表:
参数名 输入/输出方向 数据类型 描述
vi 输入 ViSession 对话通道标识符(句柄)
protError 输入 ViUInt16 产生的协议错误
3) 返回状态值:
完成代码:
VI_SUCCESS 协议错误产生完成
错误代码:
VI_ERROR_INV_SESSION vi不能标识正当对话通道
VI_ERROR_NSUP_SERV_OP 从机功能不支持
4) 描述:该操作产生的协议错误包括:清除任一协议错误状态、前一个响应正在登录引发的多个查询错误、命令未被识别、输入协议错误、输出协议错误、读协议错误与写协议错误等。
5) 相关项:无。
6) 实现要求:无。
n CPU接口资源(VI_RSRC_CPU_INTF):
1. 资源概述:可实现对当地控制器的接口配置。
2. 资源属性表及属性描述:
属性名 描述
VI_ATTR_HW_INTR_LEVEL CPU板中断级
VI_ATTR_IO_BASE CPU I/O基地址
VI_ATTR_LOCAL_BUS_TMO 当地总线超时期间
VI_ATTR_MEM_BASE 内存基地址
VI_ATTR_MSTR_DMA_CHNL 主机DMA通道
VI_ATTR_SLAVE_DMA_CHNL 从机DMA通道
VI_ATTR_SYSRESET_RESET_PC SYSRESET是否会使当地控制器复位
VI_ATTR_LOCAL_BYTE_ORDER 接口控制器的字节顺序
3. CPU接口资源定义的事件如下所示:无
4. CPU接口资源定义的操作如下:无