[机械/仪表]第三章 虚拟仪器系统IO接口软件

[机械/仪 表 关于同志近三年现实表现材料材料类招标技术评分表图表与交易pdf视力表打印pdf用图表说话 pdf ]第三章 虚拟仪器系统IO接口软件 标 题: 第三章 虚拟仪器系统I/O接口软件 发信站: 饮水思源 (2003年05月04日13:17:43 星期天), 站内信件 第三章 虚拟仪器系统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、 事件 报告 软件系统测试报告下载sgs报告如何下载关于路面塌陷情况报告535n,sgs报告怎么下载竣工报告下载 ; 6、 并行与存取控制; 7、 缺省值设置。 第二步是在资源管理器基础上，列出了各种仪器各自的操作功能，并实现操作功能 的合并。在这个基础上实现的资源实质可以包括不同格式的操作，如读资源包括了 消息基器件的读，也包括了寄存器基器件的读;既可以包括同步读操作，又可以包 括异步读操作。每一个资源内部，实质是各种操作的集合。这种资源在VISA中即为 仪器控制资源，包含各种仪器操作的资源称为通用资源，而将无法合并的功能，称 为特定仪器资源。 第三步，需要定义与创建一个用API实现的资源，为用户提供单一的控制所有VISA 仪器控制资源的方法，在VISA中称为仪器控制资源组织器。 与自顶向下的构成方式相比，VISA的构成模型是从仪器操作本身开始的，它实现的 统一是深入到操作功能中去而不是停留于仪器类型之上。在VISA的结构中，仪器类 型的区别体现到统一格式的资源中的操作的选取，对于VISA使用者来说，形式上与 用法上是单一的。在理论层次上，自顶向下的方法属于归纳范畴，而自底向上的方 法则属于演绎范畴。因此，自顶向下是对过去所有仪器类型的 总结 初级经济法重点总结下载党员个人总结TXt高中句型全总结.doc高中句型全总结.doc理论力学知识点总结pdf ，而不可能提供 扩展接口，而自底向上的结构是从共性到个性的推广，它的兼容性不仅仅是过去、 现在，还可以包括将来。正由于这种自底向上的设计方法，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资源 模板 个人简介word模板免费下载关于员工迟到处罚通告模板康奈尔office模板下载康奈尔 笔记本 模板 下载软件方案模板免费下载 、 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接口资源定义的操作如下:无 3.3.4 VISA仪器控制组织器资源 VISA仪器控制组织器资源在资源模板的基础上，扩展了自己的属性、事件与操作， 实现多仪器控制资源的管理机制，使多个仪器合理地分配通信通道，进行多对话通 道操作。组织器所定义的资源即为VISA仪器控制组织器资源。 n VISA仪器控制组织器资源(VI_RSRC_VISA_IC_ORG): 1. 资源概述:为多仪器的控制资源提供存取能力。 2. 资源属性表及属性描述: 属性名 描述 VI_ATTR_ACC_MODE 操作模式 VI_ATTR_RESOURCES 资源名列表 3. VISA仪器控制组织器资源定义的事件如下所示:无 4. VISA仪器控制组织器资源定义的操作如下: viGetRsrcSession(sesn，refName，accessMode，vi) 4.1. viGetRsrcSession(sesn，refName，accessMode，vi) 1) 目标:返回一特定VISA仪器控制组织器的资源对话通道 2) 参数表: 参数名 输入/输出方向 数据类型 描述 sesn 输入 ViSession 组织器对话通道标识符 refName 输入 ViRsrc 资源名 accessMode 输入 ViAccessMode 存取模式 vi 输出 ViSession 资源对话通道标识符 3) 返回状态值: 完成代码: VI_SUCCESS 资源关联完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_ABORT 传送时用户退出 VI_ERROR_INV_REF_NAME 资源名不当 4) 描述:该操作用于VISA仪器控制组织器对话通道获取资源的存取能力。 5) 相关项:viAttachRsrc()、viDetachRsrc()。 6) 实现要求:viClose()将关闭所有由viGetRsrcSession()打开的资源通道 。 3.3.5 VISA特定接口仪器控制资源 在VISA资源模板的基础上，VISA特定接口仪器控制资源定义了仪器控制特有的属性 、事件与操作。在仪器控制资源中定义的功能是特定的仪器功能，每个控制与操作 功能都有明确的仪器对象。 VISA特定接口仪器控制资源中包括: n GPIB总线接口控制资源 n VXI总线器件配置资源 n VXI总线接口控制资源 n VXI总线零槽资源 n VXI总线系统中断资源 n VXI总线信号处理器资源 n VXI总线信号资源 n VXI总线中断资源 n VXI总线扩展接口资源 n 异步串行总线接口控制资源 下面分别对各个资源进行详尽描述。 n GPIB总线接口控制资源(VI_RSRC_GPIB_INTF): 1. 资源概述:对GPIB总线进行存取，实现GPIB器件的状态并行轮询及远程/当地控 制操作。 2. 资源属性表及属性描述: 属性名 描述 VI_ATTR_GPIB_ATN ATN线当前状态 VI_ATTR_GPIB_BUS_TIMING 接口资源握手延时值 VI_ATTR_GPIB_DATA GPIB数据线(D0,D7)状态 VI_ATTR_GPIB_DAV DAV线当前状态 VI_ATTR_GPIB_EOI EOI线当前状态 VI_ATTR_GPIB_GLOB_TLC_MODE 接口当前讲者/听者/控者模式 VI_ATTR_GPIB_HS488_CBL_LEN HS488电缆长度 VI_ATTR_GPIB_IFC IFC线当前状态 VI_ATTR_GPIB_LOCAL_PP 是否允许并行轮询 VI_ATTR_GPIB_NDAC NDAC线当前状态 VI_ATTR_GPIB_NRFD NRFD线当前状态 VI_ATTR_GPIB_REM REM线当前状态 VI_ATTR_GPIB_SRQ SRQ线当前状态 VI_ATTR_PHYS_ADDR 器件地址 VI_ATTR_SYS_CNTLR 是否置为系统控者 VI_ATTR_7_8_BIT_CMP 终止符有效位 VI_ATTR_SEND_END_ON 终止符是否插入EOI _TERMCHAR_EN VI_ATTR_GPIB_IST 是否允许并行轮询 VI_ATTR_GPIB_SES_ADDR GPIB对话通道地址 VI_ATTR_GPIB_SES_STAT 32位状态变量 VI_ATTR_GPIB_TLC_MODE 对话通道当前讲者/听者/控制模式 VI_ATTR_PROTOCOL 协议 VI_ATTR_SEND_END 写操作最后一个字节是否插入EOI VI_ATTR_TERMCHAR 终止符 VI_ATTR_TERMCHAR_EN 终止符是否有效 VI_ATTR_TMO_UNIT 超时值单位 VI_ATTR_TMO 超时值 VI_ATTR_TRANSPORT 传送机制 3. GPIB总线接口控制资源定义的事件如下所示: 事件 说明 VI_EVENT_GPIB_REM GPIB REM线有效引发事件 VI_EVENT_GPIB_ATN GPIB ATN线有效引发事件 VI_EVENT_GPIB_TALK 对话通道置为讲者引发事件 VI_EVENT_GPIB_LISTEN 对话通道置为听者引发事件 VI_EVENT_GPIB_CIC 对话通道置为责任控者引发事件 VI_EVENT_GPIB_LOK 对话通道处于锁定状态 VI_EVENT_GPIB_END 对话通道接收到EOI VI_EVENT_GPIB_CMPL 对话通道完成一个传送 VI_EVENT_GPIB_DCAS 对话通道处于器件清除激活状态(DCAS) VI_EVENT_GPIB_DTAS 对话通道处于器件触发激活状态(DTAS) VI_EVENT_GPIB_SPAS 对话通道处于串行轮询激活状态(SPAS) 4. GPIB总线接口控制资源定义的操作如下: viGPIBRead(vi，buf，count，retCount) viGPIBReadAsync(vi，buf，count，jobId) viGPIBReadStatus(vi，jobId，status) viGPIBWrite(vi，buf，count，retCount) viGPIBWriteAsync(vi，buf，count，jobId) viGPIBWriteStatus(vi，jobId，status) viGPIBCommand(vi，buf，count，retCount) viGPIBCommandAsync(vi，buf，count，jobId) viGPIGCommandStatus(vi，jobId，status) viSendIFC(vi) viTakeControl(vi，sync) viGoToStandby(vi，shake) viListen(vi，address) viLocal(vi) viRemoteEnable(vi，rem) viPPollConfig(vi，address，ppc) viPPoll(vi，result) 4.1. viGPIBRead(vi，buf，count，retCount) 1) 目标:从GPIB总线读取数据 2) 参数表:与viRead()一致。 3) 返回状态值: 完成代码: VI_SUCCESS 数据读取完成 VI_SUCCESS_TERM_CHAR 特定终止符被读取 VI_SUCCESS_MAX_CNT 读取的字节数与count数相同 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_TMO 超时错误 VI_ERROR_ABORT 传送时用户退出 VI_ERROR_CLR_ABORT 传送时器件清除 VI_ERROR_NADDRESSED 接口没有置为听状态 4) 描述:该操作将从器件中读取的值放在buf。 5) 相关项:参见viGPIBReadAsync()、viGPIBReadStatus()。 6) 实现要求:无。 4.2. viGPIBReadAsync(vi，buf，count，jobId) 1) 目标:从GPIB总线异步读取数据 2) 参数表:与viReadAsync()一致。 3) 返回状态值: 完成代码: VI_SUCCESS 异步数据读取完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_QUEUE_ERROR 不能进行异步操作排队 4) 描述:该操作将从器件中读取的值放在buf。 5) 相关项:参见viGPIBRead()、viGPIBReadStatus()。 6) 实现要求:无。 4.3. viGPIBReadStatus(vi，jobId，jobStatus) 1) 目标:获取GPIB读操作状态 2) 参数表:与viReadStatus()一致。 3) 返回状态值: 完成代码: VI_SUCCESS 状态获取完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_INV_JOBID 作业标识符不当 4) 描述:当操作为同步时，标识符唯一确定，为VI_SYNC;当操作为异步时，标 识符为操作的输出参数值。 5) 相关项:参见viGPIBReadAsync()、viGPIBRead()。 6) 实现要求:无。 4.4. viGPIBWrite(vi，buf，count，retCount) 1) 目标:将数据同步写入到GPIB总线中 2) 参数表:与viWrite()一致。 3) 返回状态值: 完成代码: VI_SUCCESS 数据写入完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_TMO 超时错误 VI_ERROR_ABORT 传送时用户退出 VI_ERROR_CLR_ABORT 传达时器件清除 VI_ERROR_NADDRESSED 接口未置为听者状态 VI_ERROR_NLISTENERS 没有听者状态被检测到 4) 描述:该操作将位于buf中的数据写入到GPIB总线中去，任一写资源通道只能 登录一个同步写操作。 5) 相关项:参见viGPIBWriteAsync()、viGPIBWriteStatus()。 6) 实现要求:无。 4.5. viGPIBWriteAsync(vi，buf，count，jobId) 1) 目标:将数据异步写入到GPIB总线中 2) 参数表:与viWriteAsync()一致。 3) 返回状态值: 完成代码: VI_SUCCESS 异步写操作完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_QUEUE_ERROR 不能进行写操作排队 4) 描述:该操作将位于buf中的数据写入到GPIB总线中去，任一写资源通道可以 登录多个异步写操作，进行排队处理。 5) 相关项:参见viGPIBWrite()、viGPIBWriteStatus()。 6) 实现要求:无。 4.6. viGPIBWriteStatus(vi，jobId，jobStatus) 1) 目标:获取GPIB写操作状态 2) 参数表:与viWriteStatus()一致。 3) 返回状态值: 完成代码: VI_SUCCESS 状态获取完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_INV_JOBID 作业标识符不当 4) 描述:当操作为同步时，标识符唯一确定，为VI_SYNC;当操作为异步时，标 识符为操作的输出参数值。 5) 相关项:参见viGPIBWrite()、viGPIBWriteAsync()。 6) 实现要求:无。 4.7. viGPIBCommand(vi，buf，count，retCount) 1) 目标:将命令同步写入到GPIB总线中 2) 参数表:与viGPIBWrite()一致。 3) 返回状态值: 完成代码: VI_SUCCESS 发送命令完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_TMO 超时错误 VI_ERROR_ABORT 传送时用户退出 VI_ERROR_NCIC vi未表示为当前责任控者 VI_ERROR_NLISTENERS 没有听者状态被检测到 4) 描述:该操作将位于buf中的命令写入到GPIB总线中去。 5) 相关项:参见viGPIBCommandAsync()、viGPIBCommandStatus()。 6) 实现要求:无。 4.8. viGPIBCommandAsync(vi，buf，count，jobId) 1) 目标:将命令异步写入到GPIB总线中 2) 参数表:与viGPIBWriteAsync()一致。 3) 返回状态值:与viGPIBWriteAsync()一致。 4) 描述:该操作将位于buf中的命令异步写入到GPIB总线中去。 5) 相关项:参见viGPIBCommand()、viGPIBCommandStatus()。 6) 实现要求:无。 4.9. viGPIBCommandStatus(vi，jobId，jobStatus) 1) 目标:获取GPIB命令操作状态 2) 参数表:与viGPIBWriteStatus()一致。 3) 返回状态值:与viGPIBWriteStatus()一致。 4) 描述:当操作为同步时，标识符唯一确定，为VI_SYNC;当操作为异步时，标 识符为操作的输出参数值。 5) 相关项:参见viGPIBCommand()、viGPIBCommandAsync()。 6) 实现要求:无。 4.10. viSendIFC(vi) 1) 目标:置GPIB IFC线有效至少100微秒 2) 参数表: 参数名 输入/输出方向 数据类型 描述 vi 输入 ViSession 对话通道标识符(句柄) 3) 返回状态值: 完成代码: VI_SUCCESS 置GPIB IFC线完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_NSYS_CNTLR vi不能置为系统控者 4) 描述:该操作只有在当前vi为系统控者时才有效。 5) 相关项:无。 6) 实现要求:无。 4.11. viTakeControl(vi，sync) 1) 目标:取得GPIB总线控制同步操作 2) 参数表: 参数名 输入/输出方向 数据类型 描述 vi 输入 ViSession 对话通道标识符(句柄) sync 输入 ViBoolean 同步操作还是异步操作 3) 返回状态值: 完成代码: VI_SUCCESS 控制取得完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_NCIC vi不能置为责任控者 4) 描述:该操作通过将ATN接口线置高以取得总线控制权，该操作是对于vi置为 责任控者时才有效。 5) 相关项:无。 6) 实现要求:无。 4.12. viGoToStandby(vi，shake) 1) 目标:使GPIB ATN接口线无效，接受者可以任意握手 2) 参数表: 参数名 输入/输出方向 数据类型 描述 vi 输入 ViSession 对话通道标识符(句柄) shake 输入 ViBoolean ATN线无效后是否接受者执行握手 3) 返回状态值: 完成代码: VI_SUCCESS 总线旁路完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_NCIC vi不能置为责任控者 VI_ERROR_BAD_ADDR_STATE ATN线已经置为无效 4) 描述:该操作是对于vi置为责任控者时才有效。 5) 相关项:无。 6) 实现要求:当接受者握手被执行，接口需要延时一段时间才会进行数据传送。 4.13. viListen(vi，address) 1) 目标:检查GPIB总线上听者器件是否存在 2) 参数表: 参数名 输入/输出方向 数据类型 描述 vi 输入 ViSession 对话通道标识符(句柄) address 输入 ViPhysAddr GPIB器件地址 3) 返回状态值: 完成代码: VI_SUCCESS 操作完成 VI_SUCCESS_DEV_NPRESENT 操作完成，但器件没有在特定地址上 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_NCIC vi不能置为责任控者 VI_ERROR_INV_ADDR 地址表示不正确 4) 描述:该操作只有当vi置为责任控者且address表示的地址不代表vi时才有效 。 5) 相关项:无。 6) 实现要求:无。 4.14. viLocal(vi) 1) 目标:置接口为当地模式 2) 参数表: 参数名 输入/输出方向 数据类型 描述 vi 输入 ViSession 对话通道标识符(句柄) 3) 返回状态值: 完成代码: VI_SUCCESS 操作完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 4) 描述:当接口处于锁定状态时，该操作无效。 5) 相关项:无。 6) 实现要求:无。 4.15. viRemoteEnable(vi，rem) 1) 目标:控制GPIB REM接口线状态 2) 参数表: 参数名 输入/输出方向 数据类型 描述 vi 输入 ViSession 对话通道标识符(句柄) rem 输入 ViBoolean REM接口线状态 3) 返回状态值: 完成代码: VI_SUCCESS 操作完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_NSYS_CNTLR vi不能置为系统控者 4) 描述:该操作只有当vi置为系统控者时才有效。 5) 相关项:无。 6) 实现要求:无。 4.16. viPPollConfig(vi，address，ppc) 1) 目标:设置GPIB器件为并行轮询 2) 参数表: 参数名 输入/输出方向 数据类型 描述 vi 输入 ViSession 对话通道标识符(句柄) address 输入 ViPhysAddr GPIB器件地址 ppc 输入 ViUInt8 必须包括PPE或PPD命令 3) 返回状态值: 完成代码: VI_SUCCESS 操作完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_TMO 超时错误 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_NCIC vi不能置为责任控者 VI_ERROR_INV_ADDR 地址表示不正确 VI_ERROR_LOCAL_CONFIG 在远程控制状态下进行当地配置 VI_ERROR_INV_PPC ppc不能包括一个正确的并行轮询配置 4) 描述:该操作只有当vi置为责任控者时才有效。 5) 相关项:参见viPPoll()。 6) 实现要求:无。 4.17. viPPoll(vi，，result) 1) 目标:并行轮询GPIB器件 2) 参数表: 参数名 输入/输出方向 数据类型 描述 vi 输入 ViSession 对话通道标识符(句柄) result 输出 ViPUInt8 结果地址 3) 返回状态值: 完成代码: VI_SUCCESS 并行轮询完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_TMO 超时错误 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_NCIC vi不能置为责任控者 4) 描述:该操作只有当vi置为责任控者时才有效。 5) 相关项:参见viPPollConfig()。 6) 实现要求:无。 n VXI总线器件配置资源(VI_RSRC_VXI_DEV_CONF): 1. 资源概述:可实现VXI总线器件的初始化操作。 2. 资源属性表及属性描述: 属性名 描述 VI_ATTR_ASYNC_MODE_CNTRL 异步模式控制命令响应 VI_ATTR_CMDR_LA VXI总线控制器地址 VI_ATTR_DEV_CLASS VXI仪器类型 VI_ATTR_DEV_LA 器件地址 VI_ATTR_DEV_SUBCLASS 扩展型器件附加寄存器值 VI_ATTR_EXTDR_INFO 主机箱扩展器信息 VI_ATTR_MAINFRAME_LA 主机箱地址 VI_ATTR_MANF_ID VXI器件制造厂家标识符 VI_ATTR_MANF_NAME VXI器件制造厂家名 VI_ATTR_MEM_ATTR_REG 属性寄存器 VI_ATTR_MEM_BASE 内存基地址 VI_ATTR_MEM_SIZE 内存大小 VI_ATTR_MEM_SPACE 内存空间类型 VI_ATTR_MODEL_CODE 器件标号 VI_ATTR_MODEL_NAME 器件名 VI_ATTR_PASS_STATUS 器件自检通过状态 VI_ATTR_PROT_REG 消息基器件协议寄存器 VI_ATTR_PROT_RESP 读协议响应值 VI_ATTR_RDY_STATUS 器件就绪状态 VI_ATTR_RESP_EN 从机响应 VI_ATTR_SERV_AREA 从机空间大小 VI_ATTR_SERV_LIST 从机列表 VI_ATTR_SLOT 器件槽位号 VI_ATTR_SLOT0_LA 零槽器件地址 VI_ATTR_VXI_INTERRUPTERS 器件中断矢量 VI_ATTR_VXI_INTR_HNDLRS 中断处理矢量 3. VXI总线器件配置资源定义的事件如下所示:无 4. VXI总线器件配置资源定义的操作如下: viAssertSoftReset(vi) 4.1. viAssertSoftReset(vi) 1) 目标:执行软件复位 2) 参数表: 参数名 输入/输出方向 数据类型 描述 vi 输入 ViSession 对话通道标识符(句柄) 3) 返回状态值: 完成代码: VI_SUCCESS 软复位完成 VI_SUCCESS_DEV_FAILED 软复位完成，但器件无法通过自检 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_BERR 总线错误 4) 描述:该操作执行器件软件复位。 5) 相关项:无。 6) 实现要求:无。 n VXI总线接口控制资源(VI_RSRC_VXI_INTF): 1. 资源概述:用于配置VXI总线属性。 2. 资源属性表及属性描述: 属性名 描述 VI_ATTR_FAIR_RQST_TMO 公平请求超时值 VI_ATTR_HW_SOFTRESET_EN 硬件是否允许软复位 VI_ATTR_PHYS_ADDR 器件地址 VI_ATTR_RELS_MECH 总线释放机制 VI_ATTR_DEV_SUBCLASS 扩展型器件附加寄存器值 VI_ATTR_RQST_LEVEL 请求优先级 VI_ATTR_SYSFAIL_TMO SYSFAIL超时值 VI_ATTR_VXIBUS_TMO VXI总线超时值 VI_ATTR_VXI_INTR_STATUS 中断与信号位矢量 VI_ATTR_VXI_RETRY_EN 是否允许VXI总线背板重入 VI_ATTR_TRIG_STATUS 触发线位矢量 VI_ATTR_UTIL_BUS_STATUS 失败线位矢量 3. VXI总线接口控制资源定义的事件如下所示: 事件 说明 VI_EVENT_SOFTRESET 软复位引发事件 4. VXI总线接口控制资源定义的操作如下:无 n VXI零槽资源(VI_RSRC_VXI_SLOT_0): 1. 资源概述:描述VXI总线系统零槽功能。 2. 资源属性表及属性描述: 属性名 描述 VI_ATTR_ARBITRATION 总线仲裁模式 VI_ATTR_CLK10_LOCATION CLK10信号来源 VI_ATTR_CLK10_OPERATIONAL CLK10是否被操作 VI_ATTR_MODID VXI总线背板MODID线状态 VI_ATTR_PHSY_ADDR 器件地址 3. VXI总线接口控制资源定义的事件如下所示:无 4. VXI总线接口控制资源定义的操作如下:无 n VXI总线系统中断资源(VI_RSRC_VXI_SYS_INTR): 1. 资源概述:处理系统中断(ACFAIL、SYSFAIL与SYSRESET)。 2. 资源属性表及属性描述: 属性名 描述 VI_ATTR_HW_ACFAIL_EN 是否可以感知ACFAIL中断 VI_ATTR_HW_SYSFAIL_EN 是否可以感知SYSFAIL中断 VI_ATTR_HW_SYSRESET_EN 是否可以感知SYSRESET中断 3. VXI总线系统中断资源定义的事件如下所示: 事件 说明 VI_EVENT_ACFAIL ACFAIL系统中断事件 VI_EVENT_SYSFAIL SYSFAIL系统中断事件 VI_EVENT_SYSRESET SYSRESET系统中断事件 4. VXI总线系统中断资源定义的操作如下: viAssertUtilBusSignal(vi，interrupt，mode) 4.1. viAssertUtilBusSignal(vi，interrupt，mode) 1) 目标:确认特定应用总线中断 2) 参数表: 参数名 输入/输出方向 数据类型 描述 vi 输入 ViSession 对话通道标识符(句柄) interrupt 输入 ViUInt16 应用总线中断 mode 输入 ViUInt16 执行模式 3) 返回状态值: 完成代码: VI_SUCCESS 应用总线中断确认完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_NSUP_OPER 硬件不支持操作 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_INV_MODE 模式参数不合法 4) 描述:该操作可以确认三种系统中断，即为VI_ACFAIL、VI_SYSFAIL与 VI_SYSRESET，其中mode参数只在VI_SYSRESET状态下有效，可分为 VI_KEEP_CONFIG(不改变原来配置)、VI_NO_LOCAL_RESET(复位VXI电路但不复位 当地CPU)及VI_RESET_LOCAL_CPU(复位当地CPU)。 5) 相关项:无。 6) 实现要求:无。 n VXI总线信号处理器资源(VI_RSRC_VXI_SIG_PROCESSOR): 1. 资源概述:提供器件之间中断及信号通讯接口。 2. 资源属性表及属性描述: 属性名 描述 VI_ATTR_ASYNC_MODE_CNTRL 异步模式控制命令响应 VI_ATTR_SIGP_MASK 信号处理器事件过滤器 VI_ATTR_SUGGESTED_INTR_ID 器件中断号 3. VXI总线信号处理器资源定义的事件如下所示: 事件 说明 VI_EVENT_SIGNALP VXI总线信号或中断引发事件 4. VXI总线信号处理器资源定义的操作如下: viSendVXISignal(vi，StatusID) 4.1. viSendVXISignal(vi，StatusID) 1) 目标:确认中断或向信号寄存器的写操作 2) 参数表: 参数名 输入/输出方向 数据类型 描述 vi 输入 ViSession 对话通道标识符(句柄) statusID 输入 ViUInt16 信号值 3) 返回状态值: 完成代码: VI_SUCCESS 写操作完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_BERR 总线错误 4) 描述:该操作的写入模式为异步方式。 5) 相关项:无。 6) 实现要求:缺省状态为VXI总线信号。 n VXI总线信号资源(VI_RSRC_VXI_SIG): 1. 资源概述:监视送入当地控制器的信号。 2. 资源属性表及属性描述: 属性名 描述 VI_ATTR_HW_SIG_SENSE_EN 状态属性 VI_ATTR_SIG_RETRY_EN 在总线错误时进行信号重入 VI_ATTR_VXI_SIG_MASK 信号过滤屏蔽 3. VXI总线信号资源定义的事件如下所示: 事件 说明 VI_EVENT_SIGNAL 写入一当地信号寄存器引发事件 4. VXI总线信号资源定义的操作如下:无。 n VXI总线中断资源(VI_RSRC_VXI_INTR): 1. 资源概述:监视中断线状态。 2. 资源属性表及属性描述: 属性名 描述 VI_ATTR_HW_INTR_SENSE_EN 中断是否有效 VI_ATTR_INTR_ACK_MODE 中断响应模式 VI_ATTR_VXI_INTR_LINE 对应中断线 VI_ATTR_INTR_TYPE 中断类型 VI_ATTR_VXI_INTR_MASK 中断过滤屏蔽 3. VXI总线中断资源定义的事件如下所示: 事件 说明 VI_EVENT_VXI_INTR 中断引发事件 4. VXI总线中断资源定义的操作如下: viAssertVXIInterrupt(vi，statusId) viDeassertVXIInterrupt(vi) viAcknowledgeVXIInterrupt(vi，statusId) 4.1. viAssertVXIInterrupt(vi，StatusID) 1) 目标:确认中断线有效 2) 参数表: 参数名 输入/输出方向 数据类型 描述 vi 输入 ViSession 对话通道标识符(句柄) statusID 输入 ViUInt32 状态值 3) 返回状态值: 完成代码: VI_SUCCESS 中断确认完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_NSUP_OPER 没有对应的中断器支持 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_INTR_PENDING VXI中断仍在登录 4) 描述:该操作确认VXI总线中断。 5) 相关项:无。 6) 实现要求:无。 4.2. viDeassertVXIInterrupt(vi) 1) 目标:取消中断线确认 2) 参数表: 参数名 输入/输出方向 数据类型 描述 vi 输入 ViSession 对话通道标识符(句柄) 3) 返回状态值: 完成代码: VI_SUCCESS 中断确认取消完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_NSUP_OPER 没有对应的中断器支持 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 4) 描述:该操作只可用于调试目的。 5) 相关项:无。 6) 实现要求:无。 4.3. viAcknowledgeVXIInterrupt(vi，StatusID) 1) 目标:手动响应中断线 2) 参数表: 参数名 输入/输出方向 数据类型 描述 vi 输入 ViSession 对话通道标识符(句柄) statusID 输出 ViPUInt32 状态值 3) 返回状态值: 完成代码: VI_SUCCESS 中断线响应完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_NSUP_OPER 没有对应的中断器支持 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_BERR 总线错误 4) 描述:该操作只能用于调试目的。 5) 相关项:无 6) 实现要求:无。 n VXI总线扩展接口资源(VI_RSRC_VXI_EXTDR): 1. 资源概述:实现VXI总线主机笨扩展信号的配置。 2. 资源属性表及属性描述: 属性名 描述 VI_ATTR_ECL_TRIG_P2 扩展器件P2 ECL触发器是否有效 VI_ATTR_ECL_TRIG_P3 扩展器件P3 ECL触发器是否有效 VI_ATTR_INTR_DIR 中断级方向 VI_ATTR_INTR_LEVELS_EN 中断级是否有效 VI_ATTR_TRIG_DIR ECL/TTL触发线方向 VI_ATTR_TTL_TRIG_P2 扩展器件P2 TTL触发器是否有效 VI_ATTR_UTIL_BUS_DIR 应用总线方向 3. VXI总线扩展接口资源定义的事件如下所示:无 4. VXI总线扩展接口资源定义的操作如下:无 n 异步串行总线接口控制资源(VI_RSRC_ASRL_INTF): 1. 资源概述:进行异步串行接口存取操作。 2. 资源属性表及属性描述: 属性名 描述 VI_ATTR_ASRL_BAUD 波特率 VI_ATTR_ASRL_DATA_BITS 数据位 VI_ATTR_ASRL_PARITY 检验极性 VI_ATTR_ASRL_STOP_BITS 停止位 VI_ATTR_ASRL_FLOW_CNTRL 数据流控制 VI_ATTR_ASRL_FLOW_IN 数据输入流 VI_ATTR_ASRL_FLOW_OUT 数据输出流 VI_ATTR_ASRL_ON_LIMIT 数据输入流允许 VI_ATTR_ASRL_OFF_LIMIT 数据输入流不允许 VI_ATTR_ASRL_XON_CHAR 开启流控制 VI_ATTR_ASRL_XOFF_CHAR 关闭流控制 VI_ATTR_ASRL_IN_BUF_SIZE 接收缓冲区大小 VI_ATTR_ASRL_AVAIL_NUM 接收缓冲区字节个数 VI_ATTR_ASRL_LOCAL_ECHO 是否对每个字符都响应 VI_ATTR_ASRL_RTS_STATE RTS信号状态 VI_ATTR_ASRL_CTS_STATE CTS信号状态 VI_ATTR_ASRL_DTR_STATE DTR信号状态 VI_ATTR_ASRL_DSR_STATE DSR信号状态 VI_ATTR_ASRL_DCD_STATE DCD信号状态 VI_ATTR_ASRL_RI_STATE RI信号状态 VI_ATTR_ASRL_BUS_STATE 所有总线信号状态 VI_ATTR_ASRL_ON_PARITY 极性校验有效 VI_ATTR_ASRL_ON_FRAMING 帧校验有效 VI_ATTR_ASRL_REPLACE_CHAR 输入字符替代字符 VI_ATTR_ASRL_DISCARD_NULL 空字符是否需要丢弃 VI_ATTR_TMO_UNIT 超时值单位 VI_ATTR_TMO 超时值 VI_ATTR_ASRL_ABORT_DCD 当DCD无效时是否需要退出 VI_ATTR_ASRL_ABORT_PARITY 极性校验错误是否需要退出 VI_ATTR_ASRL_END_IN 读操作终止方式 VI_ATTR_ASRL_TERMCHAR 终止符 VI_ATTR_ASRL_END_OUT 写操作终止方式 VI_ATTR_ASRL_END_OUT_CHAR 写操作终止符 3. 异步串行总线接口控制资源定义的事件如下所示: 事件 说明 VI_EVENT_IO_COMPLETION 异步读写操作完成 VI_EVENT_ASRL_DATA_AVAIL 接收缓冲区已有N个字符 VI_EVENT_ASRL_STRING_ARRIVED 接收缓冲区接收到特定字符 VI_EVENT_ASRL_END_ARRIVED 接收缓冲区接收到END字符 VI_EVENT_ASRL_FLOWIN_CHANGED 输入流控制方式改变 VI_EVENT_ASRL_FLOWOUT 输出流控制方式改变 _CHANGED VI_EVENT_ASRL_RTS_CHANGED RTS状态改变 VI_EVENT_ASRL_CTS_CHANGED CTS状态改变 VI_EVENT_ASRL_DSR_CHANGED DSR状态改变 VI_EVENT_ASRL_DTR_CHANGED DTR状态改变 VI_EVENT_ASRL_DCD_CHANGED DCD状态改变 VI_EVENT_ASRL_RI_CHANGED RI状态改变 VI_EVENT_ASRL_RING RI输入信号沿被检测到 VI_EVENT_ASRL_PARITY_ERR 极性校验错误引发事件 VI_EVENT_ASRL_FRAMING_ERR 帧校验错误引发事件 VI_EVENT_ASRL_OVERRUN_ERR 超限错误 VI_EVENT_ASRL_OVERFLOW_ERR 溢出错误 4. 异步串行总线接口控制资源定义的操作如下: viAsrlRead(vi，buf，count，retCount) viAsrcReadAsync(vi，buf，count，jobId) viAsrcReadStatus(vi，jobId，status) viAsrcWrite(vi，buf，count，retCount) viAsrcWriteAsync(vi，buf，count，jobId) viAsrcWriteStatus(vi，jobId，status) viAsrcSendBreak(vi，unit，length) 4.1. viAsrlRead(vi，buf，count，retCount) 1) 目标:从异步串行总线同步读取数据 2) 参数表:与viRead()一致。 3) 返回状态值: 完成代码: VI_SUCCESS 传送完成 VI_SUCCESS_TERM_CHAR 特定终止符被读取 VI_SUCCESS_MAX_CNT 读取的字节数与count数相同 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_TMO 超时错误 VI_ERROR_ABORT 传送时用户退出 VI_ERROR_ASRL_NO_DCD DCD无效 VI_ERROR_ASRL_PARITY 极性校验错误 VI_ERROR_ASRL_FRAMING 帧校验错误 VI_ERROR_ASRL_OVERRUN 超限错误 VI_ERROR_ASRL_OVERFLOW 溢出错误 4) 描述:该操作将从器件中读取的值放在buf。 5) 相关项:参见viAsrlReadAsync()、viAsrlReadStatus()。 6) 实现要求:无 4.2. viAsrlReadAsync(vi，buf，count，jobId) 1) 目标:从异步串行总线异步读取数据 2) 参数表:与viReadAsync()一致。 3) 返回状态值: 完成代码: VI_SUCCESS 传送完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_QUEUE_ERROR 不能进行异步操作排队 4) 描述:该操作将从器件中读取的值放在buf。 5) 相关项:参见viAsrlRead()、viAsrlReadStatus()。 6) 实现要求:无 4.3. viAsrlReadStatus(vi，jobId，jobStatus) 1) 目标:获取异步串行总线读操作状态 2) 参数表:与viReadStatus()一致。 3) 返回状态值: 完成代码: VI_SUCCESS 状态获取完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_INV_JOBID 作业标识符不当 4) 描述:当操作为同步时，标识符唯一确定，为VI_SYNC;当操作为异步时，标 识符为操作的输出参数值。 5) 相关项:参见viAsrlReadAsync()、viAsrlRead()。 6) 实现要求:无。 4.4. viAsrlWrite(vi，buf，count，retCount) 1) 目标:将数据同步写入到异步串行总线中 2) 参数表:与viWrite()一致。 3) 返回状态值: 完成代码: VI_SUCCESS 传送完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_TMO 超时错误 VI_ERROR_ABORT 传送时用户退出 VI_ERROR_ASRL_NO_DCD DCD信号无效 4) 描述:该操作将位于buf中的数据写入到异步串行总线中去。 5) 相关项:参见viAsrlWriteAsync()、viAsrlWriteStatus()。 6) 实现要求:无。 4.5. viAsrlWriteAsync(vi，buf，count，jobId) 1) 目标:将数据异步写入到异步串行总线中。 2) 参数表:与viWriteAsync()一致 3) 返回状态值: 完成代码: VI_SUCCESS 异步写操作完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_QUEUE_ERROR 不能进行写操作排队 4) 描述:该操作将位于buf中的数据写入到异步串行总线中去。 5) 相关项:参见viAsrlWrite()、viAsrlWriteStatus()。 6) 实现要求:无。 4.6. viAsrlWriteStatus(vi，jobId，jobStatus) 1) 目标:获取异步串行写操作状态 2) 参数表:与viWriteStatus()一致。 3) 返回状态值: 完成代码: VI_SUCCESS 状态获取完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_INV_JOBID 作业标识符不当 4) 描述:当操作为同步时，标识符唯一确定，为VI_SYNC;当操作为异步时，标 识符为操作的输出参数值。 5) 相关项:参见viAsrlWrite()、viAsrlWriteAsync()。 6) 实现要求:无。 4.7. viAsrlSendBreak(vi，unit，length) 1) 目标:发送时间间隔 2) 参数表: 参数名 输入/输出方向 数据类型 描述 vi 输入 ViSession 资源对话通道标识符 unit 输入 ViUint16 间隔时间单位，可取:VI_PICO_SEC(皮秒)、VI_NANO_ SEC (纳秒)、VI_MICRO_SEC(微秒)、VI_MILLI_SEC(毫秒)、VI_SEC(秒)、 VI_ASRL_FRAME_TIME length 输入 ViUInt32 间隔时间长度 3) 返回状态值: 完成代码: VI_SUCCESS 间隔发送完成 错误代码: VI_ERROR_INV_SESSION vi不能标识正当对话通道 VI_ERROR_RSRC_LOCKED 存取锁定模式不支持特定操作 VI_ERROR_ABORT 传送时用户退出 4) 描述:该操作向异步串行接口发送一个间隔，数据传送中保持的时间间隔可以 为一帧或更长。 5) 相关项:无。 6) 实现要求:无。 3.4 VISA的软件实现 在前一节中，详细给出了VISA资源定义规范，但事实上，前一节中描述的VISA资源 所含的属性、事件与操作在目前还没有能够完全实现，它只为一个统一的、开放的 I/O接口软件库定义了一个标准规范与目标。目前真正已经用软件实现了的只是 VISA规范定义的一个子集，无论是资源属性、事件与操作均只包含规范定义的一部 分，并且软件实现的一部分函数定义与VISA规范定义也不完全相同。目前，世界上 只有HP公司与NI公司推出了自己的VISA软件，下面介绍的是HP公司的VISA软件(当 前版本为Version1.1)所包含的VISA资源属性、事件与操作，这是虚拟仪器设计人 员进行虚拟仪器驱动程序开发的真正基础与参考文本。下面也分别按资源类给出相 应的属性表、事件表与操作表。 属性表: 1、VISA资源模板: VI_ATTR_MAX_QUEUE_LENGTH 任一时间特定对话通道最大事件排队长度 VI_ATTR_RM_SESSION 资源管理器对话通道 VI_ATTR_RSRC_IMPL_VERSION 资源版本 VI_ATTR_RSRC_LOCK_STATE 资源存取锁定模式(取值为表中所列三种) VI_ATTR_RSRC_MANF_ID 生产厂家标号 VI_ATTR_RSRC_MANF_NAME 生产厂家名 VI_ATTR_RSRC_NAME 资源名 VI_ATTR_RSRC_SPEC_VERSION VISA规范版本 VI_ATTR_USER_DATA 资源特定对话通道所用的私有数据 2、仪器控制资源: 通用仪器控制属性: VI_ATTR_INTF_TYPE 对话通道接口类型 VI_ATTR_INTF_NUM 接口板号 VI_ATTR_IO_PROT I/O协议 VI_ATTR_RD_BUF_OPER_MODE 读缓冲区操作模式 VI_ATTR_SEND_END_EN 最后一个字节是否有END字符 VI_ATTR_SUPPRESS_END_EN 是否禁止END字符 VI_ATTR_TERMCHAR 终止符 VI_ATTR_TERMCHAR_EN 是否允许终止符 VI_ATTR_TMO_VALUE 超时值 VI_ATTR_TRIG_ID 当前触发机制 VI_ATTR_WR_BUF_OPER_MODE 写缓冲区操作模式 GPIB仪器控制属性: VI_ATTR_GPIB_PRIMARY_ADDR GPIB主地址 VI_ATTR_GPIB_SECONDARY GPIB副地址 _ADDR VI_ATTR_INTF_PAERNT_NUM GPIB板号 VXI仪器控制属性: VI_ATTR_MAINFRAME_LA 主机箱地址 VI_ATTR_MANF_ID VXI器件制造厂家标识符 VI_ATTR_MEM_BASE 内存基地址 VI_ATTR_MEM_SIZE 内存大小 VI_ATTR_MEM_SPACE 内存空间类型 VI_ATTR_MODEL_CODE 器件标号 VI_ATTR_SLOT VXI器件槽位 VI_ATTR_VXI_LA VXI器件逻辑地址 VI_ATTR_CMDR_LA VXI总线控制器地址 VI_ATTR_IMMEDIATE_SERV 是否为立即从者 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_SRC_INCREMENT 源偏移量 VI_ATTR_DEST_INCREMENT 目标偏移量 VI_ATTR_WIN_ACCESS 当前窗存取模式 VI_ATTR_WIN_BASE_ADDR 总线基地址 VI_ATTR_WIN_SIZE 当前窗长度 异步串行仪器控制属性: VI_ATTR_ASRL_AVAIL_NUM 接收缓冲区字节个数 VI_ATTR_ASRL_BAUD 波特率 VI_ATTR_ASRL_DATA_BITS 数据位 VI_ATTR_ASRL_END_IN 读操作终止方式 VI_ATTR_ASRL_END_OUT 写操作终止方式 VI_ATTR_ASRL_FLOW_CNTRL 数据流控制 VI_ATTR_ASRL_PARITY 检验极性 VI_ATTR_ASRL_STOP_BITS 停止位 VI_ATTR_DEST_INCREMENT 目标偏移量 VI_ATTR_FDC_CHNL FDC数据传送通道 VI_ATTR_FDC_GEN_SIGNAL_EN 是否允许通过FDC传送数据 VI_ATTR_FDC_MODE FDC模式 VI_ATTR_FDC_USE_PAIR 一对或一个FDC有效 对于属性的操作，一般用viSetAttribute(ViSession/ViEvent/ViFindList vi, ViAttr attribute, ViAttrState attrState)及viGetAttribute( ViSession/ViEvent/ViFindList vi, ViAttr attribute, ViPAttrState attrState)来进行属性设置与获取，属性的主体可以是器件句柄类型、事件类型 、资源对象类型等，应该分情况对待。如例3.6与例3.7的事件中断子程序中的属性 主体即为事件类型。 事件表: VI_EVENT_SERVICE_REQ 服务请求通知事件 VI_EVENT_VXI_SIGP VXI总线信号或中断引发事件 VI_EVENT_TRIG 硬件触发产生 VI_EVENT_IO_COMPLETION 异步I/O操作已完成 事件处理方式分事件排队方式与事件回调方式，具体见例3.4~例3.7。 操作表: 1、VISA资源模板: viClose(vi):关闭特定的对话通道。 viGetAttribute(vi，attribute，attrState):获取资源属性状态值。 viSetAttribute(vi，attribute，attrState):设置资源属性状态值。 viStatusDesc(vi，status，desc):获取返回状态描述字符串。 viTerminate(vi，degree，jobId):请求VISA资源终止一个或所有对话通道的正 常运行。 viLock(vi，lockType，timeout，requestId，accessKey):设置资源存取模式 。 viUnlock(vi):取消资源存取模式。 viEnableEvent(vi，eventType，mechanism，context):允许特定事件通知。 viDisableEvent(vi，eventType，mechanism):不允许特定事件通知。 viDiscardEvents(vi，eventType，mechanism):刷新一个对话通道上事件发生 。 viWaitOnEvent(vi，ineventTypeList，timeout，outEventType，outContext) :等待特定事件的发生。 viInstallHandler(vi，eventType，handler，userHandle):安装回调事件句柄 。 viUnInstallHandler(vi，eventType，handler，userHandle):卸载回调事件句 柄。 2、VISA资源管理器: viOpenDefaultRM(sesn):打开缺省资源管理器资源对话通道。 viOpen(sesn，rsrcname，accessMode，timeout，vi):打开特定资源的对话通 道。 viFindRsrc(sesn，expr，findList，retcnt，instrDesc):查询VISA系统进行 资源定位。 viFindNext(findList，instrDesc):返回前一个查询操作查得的资源。 3、仪器控制管理: viRead(vi，buf，count，retCount):从器件同步读取数据。 viReadAsync(vi，buf，count，jobId):从器件异步读取数据。 viWrite(vi，buf，count，retCount):将数据同步写入到器件中。 viWriteAsync(vi，buf，count，jobId):将数据异步写入到器件中。 viAssertTrigger(vi，protocol):用特定协议确认硬件或软件触发。 viReadSTB(vi，status):读取服务请求状态字节。 viClear(vi):清除器件。 viSetBuf(vi，mask，size):设置格式化I/O缓冲区大小。 viFlush(vi，mask):手动刷新格式化I/O缓冲区。 viPrintf(vi，writeFmt，arg1，arg2„):按设定格式将数据传送到器件中。 viVPrintf(vi，writeFmt，params):按设定格式将数据传送到器件中。 viScanf(vi，readFmt，arg1，arg2„):按设定格式从器件中读取数据。 viVScanf(vi，readFmt，params):按设定格式从器件中读取数据。 viQuery(vi，writeFmt，readFmt，arg1，arg2„):按设定格式对器件进行数据 读写。 viVQuery(vi，writeFmt，readFmt，params):按设定格式对器件进行数据读写 。 viIn8(vi，space，offset，value):从接口总线读取8位(字节)单位。 viIn16(vi，space，offset，value):从接口总线读取16位(字)单位数据。 viIn32(vi，space，offset，value):从接口总线读取32位(双字)单位数据。 viOut8(vi，space，offset，value):向接口总线写入8位(字节)单位数据。 viOut16(vi，space，offset，value):向接口总线写入16位(字)单位数据。 viOut32(vi，space，offset，value):向接口总线写入32位(双字)单位数据 。 viMoveIn8(vi，space，offset，length，buf8):从器件存储器向当地存储器移 动8位(字节)单位数据。 viMoveIn16(vi，space，offset，length，buf8):从器件存储器向当地存储器 移动16位(字)单位数据。 viMoveIn32(vi，space，offset，length，buf8):从器件存储器向当地存储器 移动32位(双字)单位数据。 viMoveOut8(vi，space，offset，length，buf8):从当地存储器向器件存储器 移动8位(字节)单位数据。 viMoveOut16(vi，space，offset，length，buf8):从当地存储器向器件存储器 移动16位(字)单位数据。 viMoveOut32(vi，space，offset，length，buf8):从当地存储器向器件存储器 移动32位(双字)单位数据。 viMapAddress(vi，mapSpace，mapBase，mapSize，access，suggested， address):映射内存空间。 viUnMapAddress(vi):取消内存映射。 viPeek8(vi，addr，val8):从特定地址读8位数据。 viPeek16(vi，addr，val16):从特定地址读16位数据。 viPeek32(vi，addr，val32):从特定地址读32位数据。 viPoke8(vi，addr，val8):向特定地址写8位数据。 viPoke16(vi，addr，val16):向特定地址写16位数据。 viPoke32(vi，addr，val32):向特定地址写32位数据。 viMemAlloc(vi，size，offset):从器件存储器分配内存。 viMemFree(vi，offset):释放内存分配。 在VISA1.1中定义的操作函数列，只是VISA规范的一小部分，但有一些操作函数并 没有在VISA规范中定义过，属于软件本身补充定义的，如打开资源管理器函数 viOpenDefaultRM()函数在仪器系统初始化时进行调用，建立仪器系统资源管理 器与VISA软件的关联;viStatusDesc()函数在VISA函数调用返回后调用，并将前 一个VISA函数调用返回值作为输入参数，获取字符串形式的状态描述; viFindNext()函数是viFindRsrc()函数的补充，用于查寻VISA系统资源; viMemAlloc()函数与viMemFree()函数用于器件存储器内存操作。而对于VISA 规范中的VISA仪器控制组织器资源与VISA特定接口仪器控制资源定义的操作， VISA1.1中均没有定义，这也为VISA软件今后的发展提供了方向。可以看到，应用 VISA1.1函数，可以实现仪器系统基本编程要求，但对于特定的操作，尚需要进一 步扩充，VISA软件本身是一个不断完善与发展的产物。如果要修改与开发VISA软件 ，必须遵循VISA规范，并基于VISA模型进行开发。 目前世界上，生产VXI仪器模块、机箱及应用程序等的生产厂家与设计单位层出不 穷，但是，将VISA正式作为产品推出的只有HP公司与NI公司，它们一直从VTL( VISA过渡库)到版本1.1，也均只实现了VISA规范定义中的一部分函数。从理论上 说，VISA软件应该不能由生产厂家提供，而是应该作为标准库为所有仪器生产厂家 与集成单位所共享，但事实上由于商业等因素，VISA软件也同样被作为一个独立的 产品提供，并依靠它的基础性与统一性，各自为HP公司和NI公司占领自动测试领域 市场，作为一个市场竞争强有力的装器。况且，这两家推出的VISA软件之间也不尽 兼容，安装了HP公司的VISA软件，再去安装NI公司的相关软件，计算机系统往往会 给出警告提示，严重时会导致整个系统的崩溃。可以这么说，VISA软件的开发与硬 件零槽控制模块的开发技术作为商业秘密垄断在国外少家几家公司手中，会成为我 国产业真正实现自主化的障碍，剖析VISA软件的实质并进行自主的开发，是今后的 研究重点。 目前，我国有些研究单位与生产厂家也开始在探索零槽控制模块的研制开发工作， 并形成了一些产品，但大部分还是采用了GPIB—VXI接口模式，市场性价比并不高 ，对于VISA软件的开发，由于是一种基础性的研究，资金、人员、精力投入量大， 产出的效益并不直接，因此各单位也并没有轻易入手。在本书的讨论中，也并没有 包括VISA软件的开发，而只作为知识的延伸进行讨论，希望今后可以在这方面得到 进一步的条件进行开发研制工作。 VISA软件的开发，应基于自底向上的模型结构展开，先定义一个资源模板的子集， 如资源开启、资源寻找、资源属性操作、资源关闭等函数，在这些函数设计中，重 点是对于输入参数分析，并在程序中加以多情况散转处理。然后，在资源模板基础 上，定义一个VISA资源管理器，包括资源管理器操作与特定资源的查询，这部分函 数集主要完成对仪器系统控制器的交互操作。下一步，定义出仪器控制函数集，主 要包括读功能、写功能、格式化I/O功能、触发功能、状态/服务请求功能、器件存 取功能等，这些操作属于器件基本共有性操作，在函数实现时也同时必须进行分情 况散转处理。而其它一些属于特定仪器特有的操作，可以列出另外一个函数子集， 进行特定器件的控制与操作。这几部分函数子集组合成一个完整的函数集，即 VISA软件函数库。以上所述的仅是基本的设计思路，具体的开发工作应结合系统控 制器的开发一起进行。 符合VPP规范的虚拟仪器驱动程序的开发，一般要求底层I/O接口软件调用VISA函数 ，但有些应用程序的设计跳过虚拟仪器驱动程序的间接调用而直接调用VISA函数， 同样也是可以的，只是程序模块化不够清晰。另外，虚拟仪器系统软件结构中的 I/O接口软件并不一定只限于VISA软件，它只是一个最优选择而并非唯一，事实上 Windows中的API也承担着计算机系统的I/O接口软件的作用，对于计算机资源的操 作，也可以通过直接调用API函数实现，这种模式同样符合扩展了的虚拟仪器系统 框架。从本质上说，虚拟仪器系统软件结构的实质是为了实现对最终用户的方便易 用，而并不一定拘泥于具体形式。 附录3.1:visatype.h文件 /*----------------------------------------------*/ /* 由VXI即插即用系统联盟提供 */ /*标题:VISATYPE.H */ /*目标:提供VISA基本数据类型及宏定义 */ /*---------------------------------------------*/ #ifndef __VISATYPE_HEADER__ #define __VISATYPE_HEADER__ #if (defined(WIN32) || defined(_WIN32) || defined(__WIN32__) || defined(__NT__)) && !defined(_NI_mswin16_) #define _VI_FAR #define _VI_FUNC __stdcall #define _VI_FUNCC __cdecl #define _VI_FUNCH __stdcall #define _VI_SIGNED signed #elif defined(_CVI_) && defined(_NI_i386_) #define _VI_FAR #define _VI_FUNC _pascal #define _VI_FUNCC #define _VI_FUNCH _pascal #define _VI_SIGNED signed #elif (defined(_WINDOWS) || defined(_Windows)) && !defined(_NI_mswin16_) #define _VI_FAR _far #define _VI_FUNC _far _pascal _export #define _VI_FUNCC _far _cdecl _export #define _VI_FUNCH _far _pascal #define _VI_SIGNED signed #elif (defined(hpux) || defined(__hpux)) && (defined(__cplusplus) || defined(__cplusplus__)) #define _VI_FAR #define _VI_FUNC #define _VI_FUNCC #define _VI_FUNCH #define _VI_SIGNED #else #define _VI_FAR #define _VI_FUNC #define _VI_FUNCC #define _VI_FUNCH #define _VI_SIGNED signed #endif #define _VI_ERROR (-2147483647L-1) /* 0x80000000 */ #define _VI_PTR _VI_FAR * /*- VISA数据类型 --------------------------------------------------------------*/ typedef unsigned long ViUInt32; typedef ViUInt32 _VI_PTR ViPUInt32; typedef ViUInt32 _VI_PTR ViAUInt32; typedef _VI_SIGNED long ViInt32; typedef ViInt32 _VI_PTR ViPInt32; typedef ViInt32 _VI_PTR ViAInt32; typedef unsigned short ViUInt16; typedef ViUInt16 _VI_PTR ViPUInt16; typedef ViUInt16 _VI_PTR ViAUInt16; typedef _VI_SIGNED short ViInt16; typedef ViInt16 _VI_PTR ViPInt16; typedef ViInt16 _VI_PTR ViAInt16; typedef unsigned char ViUInt8; typedef ViUInt8 _VI_PTR ViPUInt8; typedef ViUInt8 _VI_PTR ViAUInt8; typedef _VI_SIGNED char ViInt8; typedef ViInt8 _VI_PTR ViPInt8; typedef ViInt8 _VI_PTR ViAInt8; typedef char ViChar; typedef ViChar _VI_PTR ViPChar; typedef ViChar _VI_PTR ViAChar; typedef unsigned char ViByte; typedef ViByte _VI_PTR ViPByte; typedef ViByte _VI_PTR ViAByte; typedef void _VI_PTR ViAddr; typedef ViAddr _VI_PTR ViPAddr; typedef ViAddr _VI_PTR ViAAddr; typedef float ViReal32; typedef ViReal32 _VI_PTR ViPReal32; typedef ViReal32 _VI_PTR ViAReal32; typedef double ViReal64; typedef ViReal64 _VI_PTR ViPReal64; typedef ViReal64 _VI_PTR ViAReal64; typedef ViPByte ViBuf; typedef ViPByte ViPBuf; typedef ViPByte _VI_PTR ViABuf; typedef ViPChar ViString; typedef ViPChar ViPString; typedef ViPChar _VI_PTR ViAString; typedef ViString ViRsrc; typedef ViString ViPRsrc; typedef ViString _VI_PTR ViARsrc; typedef ViUInt16 ViBoolean; typedef ViBoolean _VI_PTR ViPBoolean; typedef ViBoolean _VI_PTR ViABoolean; typedef ViInt32 ViStatus; typedef ViStatus _VI_PTR ViPStatus; typedef ViStatus _VI_PTR ViAStatus; typedef ViUInt32 ViVersion; typedef ViVersion _VI_PTR ViPVersion; typedef ViVersion _VI_PTR ViAVersion; typedef ViUInt32 ViObject; typedef ViObject _VI_PTR ViPObject; typedef ViObject _VI_PTR ViAObject; typedef ViObject ViSession; typedef ViSession _VI_PTR ViPSession; typedef ViSession _VI_PTR ViASession; /*- 完成代码 ----------------------------------------------*/ #define VI_SUCCESS (0L) /*- 其它VISA定义 ----------------------------------------------*/ #define VI_NULL (0) #define VI_TRUE (1) #define VI_FALSE (0) /*- 宏定义 -------------------------------------------------------------*/ #define VISAFN _VI_FUNC #define ViPtr _VI_PTR #endif /*- 结束--------------------------------------------*/ 附录3.2:visa.h文件 /*-----------------------------------------------*/ /* 由VXI即插即用系统联盟提供 */ /*标题:VISA.H */ /*目标:VISA数据类型、属性、事件及操作定义 */ /*----------------------------------------------*/ #ifndef __VISA_HEADER__ #define __VISA_HEADER__ #include #include "visatype.h" #define VI_SPEC_VERSION (0x00100100L) #if defined(__cplusplus) || defined(__cplusplus__) extern "C" { #endif #if defined(_CVI_) #pragma EnableLibraryRuntimeChecking #endif /*- VISA数据类型 -----------------------------------------------------------*/ typedef ViObject ViEvent; typedef ViEvent _VI_PTR ViPEvent; typedef ViObject ViFindList; typedef ViFindList _VI_PTR ViPFindList; typedef ViUInt32 ViEventType; typedef ViEventType _VI_PTR ViPEventType; typedef ViUInt32 ViAttrState; typedef void _VI_PTR ViPAttrState; typedef ViString ViKeyId; typedef ViPString ViPKeyId; typedef ViUInt32 ViJobId; typedef ViJobId _VI_PTR ViPJobId; typedef ViUInt32 ViAccessMode; typedef ViUInt32 ViBusAddress; typedef ViBusAddress _VI_PTR ViPBusAddress; typedef ViUInt32 ViBusSize; typedef ViUInt32 ViAttr; typedef ViUInt32 ViEventFilter; typedef va_list ViVAList; typedef ViStatus (_VI_FUNCH _VI_PTR ViHndlr) (ViSession vi, ViEventType eventType, ViEvent event, ViAddr userHandle); /*- 资源管理器功能-----------------------------------------*/ #if (defined(__MWERKS__) && defined(__MC68K__)) || (defined(__SC__) && defined(__CFM68K__)) #pragma lib_export on #endif ViStatus _VI_FUNC viOpenDefaultRM (ViPSession vi); #define viGetDefaultRM(vi) viOpenDefaultRM(vi) ViStatus _VI_FUNC viFindRsrc(ViSession sesn, ViString expr, ViPFindList vi, ViPUInt32 retCnt, ViChar _VI_FAR desc[]); ViStatus _VI_FUNC viFindNext(ViFindList vi, ViChar _VI_FAR desc[]); ViStatus _VI_FUNC viOpen(ViSession sesn, ViRsrc name, ViAccessMode mode, ViUInt32 timeout, ViPSession vi); /*- 资源模板功能----------------------------------------------------*/ ViStatus _VI_FUNC viClose(ViObject vi); ViStatus _VI_FUNC viSetAttribute (ViObject vi, ViAttr attrName, ViAttrState attrValue); ViStatus _VI_FUNC viGetAttribute(ViObject vi, ViAttr attrName, void _VI_PTR attrValue); ViStatus _VI_FUNC viStatusDesc (ViObject vi, ViStatus status, ViChar _VI_FAR desc[]); ViStatus _VI_FUNC viTerminate(ViObject vi, ViUInt16 degree, ViJobId jobId); ViStatus _VI_FUNC viLock (ViSession vi, ViAccessMode lockType, ViUInt32 timeout, ViKeyId requestedKey, ViChar _VI_FAR accessKey[]); ViStatus _VI_FUNC viUnlock(ViSession vi); ViStatus _VI_FUNC viEnableEvent(ViSession vi, ViEventType eventType, ViUInt16 mechanism, ViEventFilter context); ViStatus _VI_FUNC viDisableEvent(ViSession vi, ViEventType eventType, ViUInt16 mechanism); ViStatus _VI_FUNC viDiscardEvents (ViSession vi, ViEventType eventType, ViUInt16 mechanism); ViStatus _VI_FUNC viWaitOnEvent (ViSession vi, ViEventType inEventType, ViUInt32 timeout, ViPEventType outEventType, ViPEvent outContext); ViStatus _VI_FUNC viInstallHandler(ViSession vi, ViEventType eventType, ViHndlr handler, ViAddr userHandle); ViStatus _VI_FUNC viUninstallHandler(ViSession vi, ViEventType eventType, ViHndlr handler, ViAddr userHandle); /*- 基本I/O操作---------------------------------------------------*/ ViStatus _VI_FUNC viRead(ViSession vi, ViPBuf buf, ViUInt32 cnt, ViPUInt32 retCnt); ViStatus _VI_FUNC viReadAsync(ViSession vi, ViPBuf buf, ViUInt32 cnt, ViPJobId jobId); ViStatus _VI_FUNC viWrite(ViSession vi, ViBuf buf, ViUInt32 cnt, ViPUInt32 retCnt); ViStatus _VI_FUNC viWriteAsync(ViSession vi, ViBuf buf, ViUInt32 cnt, ViPJobId jobId); ViStatus _VI_FUNC viAssertTrigger (ViSession vi, ViUInt16 protocol); ViStatus _VI_FUNC viReadSTB(ViSession vi, ViPUInt16 status); ViStatus _VI_FUNC viClear(ViSession vi); /*- 格式化I/O操作-----------------------------------------------*/ ViStatus _VI_FUNC viSetBuf (ViSession vi, ViUInt16 mask, ViUInt32 size); ViStatus _VI_FUNC viFlush (ViSession vi, ViUInt16 mask); ViStatus _VI_FUNCC viPrintf (ViSession vi, ViString writeFmt, ...); ViStatus _VI_FUNC viVPrintf(ViSession vi, ViString writeFmt, ViVAList params); ViStatus _VI_FUNCC viScanf (ViSession vi, ViString readFmt, ...); ViStatus _VI_FUNC viVScanf(ViSession vi, ViString readFmt, ViVAList params); ViStatus _VI_FUNCC viQueryf(ViSession vi, ViString writeFmt, ViString readFmt, ...); ViStatus _VI_FUNC viVQueryf(ViSession vi, ViString writeFmt, ViString readFmt, ViVAList params); /*- 存储器 I/O操作 ---------------------------------------------------*/ ViStatus_VI_FUNC viIn8(ViSession vi, ViUInt16 space, ViBusAddress offset, ViPUInt8 val8); ViStatus _VI_FUNC viOut8(ViSession vi, ViUInt16 space, ViBusAddress offset, ViUInt8 val8); ViStatus _VI_FUNC viIn16(ViSession vi, ViUInt16 space, ViBusAddress offset, ViPUInt16 val16); ViStatus _VI_FUNC viOut16(ViSession vi, ViUInt16 space, ViBusAddress offset, ViUInt16 val16); ViStatus _VI_FUNC viIn32(ViSession vi, ViUInt16 space, ViBusAddress offset, ViPUInt32 val32); ViStatus _VI_FUNC viOut32(ViSession vi, ViUInt16 space, ViBusAddress offset, ViUInt32 val32); ViStatus _VI_FUNC viMoveIn8(ViSession vi, ViUInt16 space, ViBusAddress offset, ViBusSize length, ViAUInt8 buf8); ViStatus _VI_FUNC viMoveOut8 (ViSession vi, ViUInt16 space, ViBusAddress offset, ViBusSize length, ViAUInt8 buf8); ViStatus _VI_FUNC viMoveIn16(ViSession vi, ViUInt16 space, ViBusAddress offset, ViBusSize length, ViAUInt16 buf16); ViStatus _VI_FUNC viMoveOut16 (ViSession vi, ViUInt16 space, ViBusAddress offset, ViBusSize length, ViAUInt16 buf16); ViStatus _VI_FUNC viMoveIn32 (ViSession vi, ViUInt16 space, ViBusAddress offset, ViBusSize length, ViAUInt32 buf32); ViStatus _VI_FUNC viMoveOut32(ViSession vi, ViUInt16 space, ViBusAddress offset, ViBusSize length, ViAUInt32 buf32); ViStatus _VI_FUNC viMove(ViSession vi, ViUInt16 srcSpace, ViBusAddress srcOffset, ViUInt16 srcWidth, ViUInt16 destSpace, ViBusAddress destOffset, ViUInt16 destWidth, ViBusSize srcLength); ViStatus _VI_FUNC viMoveAsync(ViSession vi, ViUInt16 srcSpace, ViBusAddress srcOffset, ViUInt16 srcWidth, ViUInt16 destSpace, ViBusAddress destOffset, ViUInt16 destWidth, ViBusSize srcLength, ViPJobId jobId); ViStatus _VI_FUNC viMapAddress(ViSession vi, ViUInt16 mapSpace, ViBusAddress mapOffset, ViBusSize mapSize, ViBoolean access,ViAddr suggested, ViPAddr address); ViStatus _VI_FUNC viUnmapAddress (ViSession vi); void _VI_FUNC viPeek8 (ViSession vi, ViAddr address, ViPUInt8 val8); void _VI_FUNC viPoke8 (ViSession vi, ViAddr address, ViUInt8 val8); void _VI_FUNC viPeek16 (ViSession vi, ViAddr address, ViPUInt16 val16); void _VI_FUNC viPoke16 (ViSession vi, ViAddr address, ViUInt16 val16); void _VI_FUNC viPeek32 (ViSession vi, ViAddr address, ViPUInt32 val32); void _VI_FUNC viPoke32 (ViSession vi, ViAddr address, ViUInt32 val32); /*- 共享内存操作 ------------------------------------------------*/ ViStatus _VI_FUNC viMemAlloc(ViSession vi, ViBusSize size, ViPBusAddress offset); ViStatus _VI_FUNC viMemFree (ViSession vi, ViBusAddress offset); #if (defined(__MWERKS__) && defined(__MC68K__)) || (defined(__SC__) && defined(__CFM68K__)) #pragma lib_export off #endif /*- 属性 --------------------------------------------------------------*/ #define VI_ATTR_RSRC_NAME (0xBFFF0002L) #define VI_ATTR_RSRC_IMPL_VERSION (0x3FFF0003L) #define VI_ATTR_RSRC_LOCK_STATE (0x3FFF0004L) #define VI_ATTR_MAX_QUEUE_LENGTH (0x3FFF0005L) #define VI_ATTR_USER_DATA (0x3FFF0007L) #define VI_ATTR_FDC_CHNL (0x3FFF000DL) #define VI_ATTR_FDC_MODE (0x3FFF000FL) #define VI_ATTR_FDC_GEN_SIGNAL_EN (0x3FFF0011L) #define VI_ATTR_FDC_USE_PAIR (0x3FFF0013L) #define VI_ATTR_SEND_END_EN (0x3FFF0016L) #define VI_ATTR_TERMCHAR (0x3FFF0018L) #define VI_ATTR_TMO_VALUE (0x3FFF001AL) #define VI_ATTR_GPIB_READDR_EN (0x3FFF001BL) #define VI_ATTR_IO_PROT (0x3FFF001CL) #define VI_ATTR_ASRL_BAUD (0x3FFF0021L) #define VI_ATTR_ASRL_DATA_BITS (0x3FFF0022L) #define VI_ATTR_ASRL_PARITY (0x3FFF0023L) #define VI_ATTR_ASRL_STOP_BITS (0x3FFF0024L) #define VI_ATTR_ASRL_FLOW_CNTRL (0x3FFF0025L) #define VI_ATTR_RD_BUF_OPER_MODE (0x3FFF002AL) #define VI_ATTR_WR_BUF_OPER_MODE (0x3FFF002DL) #define VI_ATTR_SUPPRESS_END_EN (0x3FFF0036L) #define VI_ATTR_TERMCHAR_EN (0x3FFF0038L) #define VI_ATTR_DEST_ACCESS_PRIV (0x3FFF0039L) #define VI_ATTR_DEST_BYTE_ORDER (0x3FFF003AL) #define VI_ATTR_SRC_ACCESS_PRIV (0x3FFF003CL) #define VI_ATTR_SRC_BYTE_ORDER (0x3FFF003DL) #define VI_ATTR_SRC_INCREMENT (0x3FFF0040L) #define VI_ATTR_DEST_INCREMENT (0x3FFF0041L) #define VI_ATTR_WIN_ACCESS_PRIV (0x3FFF0045L) #define VI_ATTR_WIN_BYTE_ORDER (0x3FFF0047L) #define VI_ATTR_CMDR_LA (0x3FFF006BL) #define VI_ATTR_MAINFRAME_LA (0x3FFF0070L) #define VI_ATTR_WIN_BASE_ADDR (0x3FFF0098L) #define VI_ATTR_WIN_SIZE (0x3FFF009AL) #define VI_ATTR_ASRL_AVAIL_NUM (0x3FFF00ACL) #define VI_ATTR_MEM_BASE (0x3FFF00ADL) #define VI_ATTR_ASRL_CTS_STATE (0x3FFF00AEL) #define VI_ATTR_ASRL_DCD_STATE (0x3FFF00AFL) #define VI_ATTR_ASRL_DSR_STATE (0x3FFF00B1L) #define VI_ATTR_ASRL_DTR_STATE (0x3FFF00B2L) #define VI_ATTR_ASRL_END_IN (0x3FFF00B3L) #define VI_ATTR_ASRL_END_OUT (0x3FFF00B4L) #define VI_ATTR_ASRL_RI_STATE (0x3FFF00BFL) #define VI_ATTR_ASRL_RTS_STATE (0x3FFF00C0L) #define VI_ATTR_WIN_ACCESS (0x3FFF00C3L) #define VI_ATTR_RM_SESSION (0x3FFF00C4L) #define VI_ATTR_VXI_LA (0x3FFF00D5L) #define VI_ATTR_MANF_ID (0x3FFF00D9L) #define VI_ATTR_MEM_SIZE (0x3FFF00DDL) #define VI_ATTR_MEM_SPACE (0x3FFF00DEL) #define VI_ATTR_MODEL_CODE (0x3FFF00DFL) #define VI_ATTR_SLOT (0x3FFF00E8L) #define VI_ATTR_INTF_INST_NAME (0xBFFF00E9L) #define VI_ATTR_IMMEDIATE_SERV (0x3FFF0100L) #define VI_ATTR_INTF_PARENT_NUM (0x3FFF0101L) #define VI_ATTR_RSRC_SPEC_VERSION (0x3FFF0170L) #define VI_ATTR_INTF_TYPE (0x3FFF0171L) #define VI_ATTR_GPIB_PRIMARY_ADDR (0x3FFF0172L) #define VI_ATTR_GPIB_SECONDARY_ADDR (0x3FFF0173L) #define VI_ATTR_RSRC_MANF_NAME (0xBFFF0174L) #define VI_ATTR_RSRC_MANF_ID (0x3FFF0175L) #define VI_ATTR_INTF_NUM (0x3FFF0176L) #define VI_ATTR_TRIG_ID (0x3FFF0177L) #define VI_ATTR_GPIB_UNADDR_EN (0x3FFF0184L) #define VI_ATTR_JOB_ID (0x3FFF4006L) #define VI_ATTR_EVENT_TYPE (0x3FFF4010L) #define VI_ATTR_SIGP_STATUS_ID (0x3FFF4011L) #define VI_ATTR_RECV_TRIG_ID (0x3FFF4012L) #define VI_ATTR_INTR_STATUS_ID (0x3FFF4023L) #define VI_ATTR_STATUS (0x3FFF4025L) #define VI_ATTR_RET_COUNT (0x3FFF4026L) #define VI_ATTR_BUFFER (0x3FFF4027L) #define VI_ATTR_RECV_INTR_LEVEL (0x3FFF4041L) /*- 事件类型 -------------------------------------------------------------*/ #define VI_EVENT_IO_COMPLETION (0x3FFF2009L) #define VI_EVENT_TRIG (0xBFFF200AL) #define VI_EVENT_SERVICE_REQ (0x3FFF200BL) #define VI_EVENT_VXI_SIGP (0x3FFF2020L) #define VI_ALL_ENABLED_EVENTS (0x3FFF7FFFL) /*- 完成及错误代码----------------------------------------------*/ #define VI_SUCCESS_EVENT_EN (0x3FFF0002L) /* 3FFF0002, 1073676290 */ #define VI_SUCCESS_EVENT_DIS (0x3FFF0003L) /* 3FFF0003, 1073676291 */ #define VI_SUCCESS_QUEUE_EMPTY (0x3FFF0004L) /* 3FFF0004, 1073676292 */ #define VI_SUCCESS_TERM_CHAR (0x3FFF0005L) /* 3FFF0005, 1073676293 */ #define VI_SUCCESS_MAX_CNT (0x3FFF0006L) /* 3FFF0006, 1073676294 */ #define VI_SUCCESS_DEV_NPRESENT (0x3FFF007DL) /* 3FFF007D, 1073676413 */ #define VI_SUCCESS_QUEUE_NEMPTY (0x3FFF0080L) /* 3FFF0080, 1073676416 */ #define VI_SUCCESS_NESTED_SHARED (0x3FFF0099L) /* 3FFF0099, 1073676441 */ #define VI_SUCCESS_NESTED_EXCLUSIVE (0x3FFF009AL) /* 3FFF009A, 1073676442 */ #define VI_SUCCESS_SYNC (0x3FFF009BL) /* 3FFF009B, 1073676443 */ #define VI_WARN_CONFIG_NLOADED (0x3FFF0077L) /* 3FFF0077, 1073676407 */ #define VI_WARN_NULL_OBJECT (0x3FFF0082L) /* 3FFF0082, 1073676418 */ #define VI_WARN_NSUP_ATTR_STATE (0x3FFF0084L) /* 3FFF0084, 1073676420 */ #define VI_WARN_UNKNOWN_STATUS (0x3FFF0085L) /* 3FFF0085, 1073676421 */ #define VI_WARN_NSUP_BUF (0x3FFF0088L) /* 3FFF0088, 1073676424 */ #define VI_ERROR_SYSTEM_ERROR (_VI_ERROR+0x3FFF0000L) /* BFFF0000, -1073807360 */ #define VI_ERROR_INV_OBJECT (_VI_ERROR+0x3FFF000EL) /* BFFF000E, -1073807346 */ #define VI_ERROR_RSRC_LOCKED (_VI_ERROR+0x3FFF000FL) /* BFFF000F, -1073807345 */ #define VI_ERROR_INV_EXPR (_VI_ERROR+0x3FFF0010L) /* BFFF0010, -1073807344 */ #define VI_ERROR_RSRC_NFOUND (_VI_ERROR+0x3FFF0011L) /* BFFF0011, -1073807343 */ #define VI_ERROR_INV_RSRC_NAME (_VI_ERROR+0x3FFF0012L) /* BFFF0012, -1073807342 */ #define VI_ERROR_INV_ACC_MODE (_VI_ERROR+0x3FFF0013L) /* BFFF0013, -1073807341 */ #define VI_ERROR_TMO (_VI_ERROR+0x3FFF0015L) /* BFFF0015, -1073807339 */ #define VI_ERROR_CLOSING_FAILED (_VI_ERROR+0x3FFF0016L) /* BFFF0016, -1073807338 */ #define VI_ERROR_INV_DEGREE (_VI_ERROR+0x3FFF001BL) /* BFFF001B, -1073807333 */ #define VI_ERROR_INV_JOB_ID (_VI_ERROR+0x3FFF001CL) /* BFFF001C, -1073807332 */ #define VI_ERROR_NSUP_ATTR (_VI_ERROR+0x3FFF001DL) /* BFFF001D, -1073807331 */ #define VI_ERROR_NSUP_ATTR_STATE (_VI_ERROR+0x3FFF001EL) /* BFFF001E, -1073807330 */ #define VI_ERROR_ATTR_READONLY (_VI_ERROR+0x3FFF001FL) /* BFFF001F, -1073807329 */ #define VI_ERROR_INV_LOCK_TYPE (_VI_ERROR+0x3FFF0020L) /* BFFF0020, -1073807328 */ #define VI_ERROR_INV_ACCESS_KEY (_VI_ERROR+0x3FFF0021L) /* BFFF0021, -1073807327 */ #define VI_ERROR_INV_EVENT (_VI_ERROR+0x3FFF0026L) /* BFFF0026, -1073807322 */ #define VI_ERROR_INV_MECH (_VI_ERROR+0x3FFF0027L) /* BFFF0027, -1073807321 */ #define VI_ERROR_HNDLR_NINSTALLED (_VI_ERROR+0x3FFF0028L) /* BFFF0028, -1073807320 */ #define VI_ERROR_INV_HNDLR_REF (_VI_ERROR+0x3FFF0029L) /* BFFF0029, -1073807319 */ #define VI_ERROR_INV_CONTEXT (_VI_ERROR+0x3FFF002AL) /* BFFF002A, -1073807318 */ #define VI_ERROR_ABORT (_VI_ERROR+0x3FFF0030L) /* BFFF0030, -1073807312 */ #define VI_ERROR_RAW_WR_PROT_VIOL (_VI_ERROR+0x3FFF0034L) /* BFFF0034, -1073807308 */ #define VI_ERROR_RAW_RD_PROT_VIOL (_VI_ERROR+0x3FFF0035L) /* BFFF0035, -1073807307 */ #define VI_ERROR_OUTP_PROT_VIOL (_VI_ERROR+0x3FFF0036L) /* BFFF0036, -1073807306 */ #define VI_ERROR_INP_PROT_VIOL (_VI_ERROR+0x3FFF0037L) /* BFFF0037, -1073807305 */ #define VI_ERROR_BERR (_VI_ERROR+0x3FFF0038L) /* BFFF0038, -1073807304 */ #define VI_ERROR_INV_SETUP (_VI_ERROR+0x3FFF003AL) /* BFFF003A, -1073807302 */ #define VI_ERROR_QUEUE_ERROR (_VI_ERROR+0x3FFF003BL) /* BFFF003B, -1073807301 */ #define VI_ERROR_ALLOC (_VI_ERROR+0x3FFF003CL) /* BFFF003C, -1073807300 */ #define VI_ERROR_INV_MASK (_VI_ERROR+0x3FFF003DL) /* BFFF003D, -1073807299 */ #define VI_ERROR_IO (_VI_ERROR+0x3FFF003EL) /* BFFF003E, -1073807298 */ #define VI_ERROR_INV_FMT (_VI_ERROR+0x3FFF003FL) /* BFFF003F, -1073807297 */ #define VI_ERROR_NSUP_FMT (_VI_ERROR+0x3FFF0041L) /* BFFF0041, -1073807295 */ #define VI_ERROR_LINE_IN_USE (_VI_ERROR+0x3FFF0042L) /* BFFF0042, -1073807294 */ #define VI_ERROR_SRQ_NOCCURRED (_VI_ERROR+0x3FFF004AL) /* BFFF004A, -1073807286 */ #define VI_ERROR_INV_SPACE (_VI_ERROR+0x3FFF004EL) /* BFFF004E, -1073807282 */ #define VI_ERROR_INV_OFFSET (_VI_ERROR+0x3FFF0051L) /* BFFF0051, -1073807279 */ #define VI_ERROR_INV_WIDTH (_VI_ERROR+0x3FFF0052L) /* BFFF0052, -1073807278 */ #define VI_ERROR_NSUP_OFFSET (_VI_ERROR+0x3FFF0054L) /* BFFF0054, -1073807276 */ #define VI_ERROR_NSUP_VAR_WIDTH (_VI_ERROR+0x3FFF0055L) /* BFFF0055, -1073807275 */ #define VI_ERROR_WINDOW_NMAPPED (_VI_ERROR+0x3FFF0057L) /* BFFF0057, -1073807273 */ #define VI_ERROR_NLISTENERS (_VI_ERROR+0x3FFF005FL) /* BFFF005F, -1073807265 */ #define VI_ERROR_NCIC (_VI_ERROR+0x3FFF0060L) /* BFFF0060, -1073807264 */ #define VI_ERROR_NSUP_OPER (_VI_ERROR+0x3FFF0067L) /* BFFF0067, -1073807257 */ #define VI_ERROR_ASRL_PARITY (_VI_ERROR+0x3FFF006AL) /* BFFF006A, -1073807254 */ #define VI_ERROR_ASRL_FRAMING (_VI_ERROR+0x3FFF006BL) /* BFFF006B, -1073807253 */ #define VI_ERROR_ASRL_OVERRUN (_VI_ERROR+0x3FFF006CL) /* BFFF006C, -1073807252 */ #define VI_ERROR_NSUP_ALIGN_OFFSET (_VI_ERROR+0x3FFF0070L) /* BFFF0070, -1073807248 */ #define VI_ERROR_USER_BUF (_VI_ERROR+0x3FFF0071L) /* BFFF0071, -1073807247 */ #define VI_ERROR_RSRC_BUSY (_VI_ERROR+0x3FFF0072L) /* BFFF0072, -1073807246 */ #define VI_ERROR_NSUP_WIDTH (_VI_ERROR+0x3FFF0076L) /* BFFF0076, -1073807242 */ #define VI_ERROR_INV_PARAMETER (_VI_ERROR+0x3FFF0078L) /* BFFF0078, -1073807240 */ #define VI_ERROR_INV_PROT (_VI_ERROR+0x3FFF0079L) /* BFFF0079, -1073807239 */ #define VI_ERROR_INV_SIZE (_VI_ERROR+0x3FFF007BL) /* BFFF007B, -1073807237 */ #define VI_ERROR_WINDOW_MAPPED (_VI_ERROR+0x3FFF0080L) /* BFFF0080, -1073807232 */ #define VI_ERROR_NIMPL_OPER (_VI_ERROR+0x3FFF0081L) /* BFFF0081, -1073807231 */ #define VI_ERROR_INV_LENGTH (_VI_ERROR+0x3FFF0083L) /* BFFF0083, -1073807229 */ #define VI_ERROR_SESN_NLOCKED (_VI_ERROR+0x3FFF009CL) /* BFFF009C, -1073807204 */ #define VI_ERROR_MEM_NSHARED (_VI_ERROR+0x3FFF009DL) /* BFFF009D, -1073807203 */ /*- 其它VISA定义 --------------------------------------------------*/ #define VI_VERSION_MAJOR(ver) ((((ViVersion)ver) & 0xFFF00000UL) >> 20) #define VI_VERSION_MINOR(ver) ((((ViVersion)ver) & 0x000FFF00UL) >> 8) #define VI_VERSION_SUBMINOR(ver) ((((ViVersion)ver) & 0x000000FFUL) ) #define VI_ERROR_INV_SESSION (VI_ERROR_INV_OBJECT) #define VI_FIND_BUFLEN (256) #define VI_INTF_GPIB (1) #define VI_INTF_VXI (2) #define VI_INTF_GPIB_VXI (3) #define VI_INTF_ASRL (4) #define VI_NORMAL (1) #define VI_FDC (2) #define VI_HS488 (3) #define VI_ASRL488 (4) #define VI_FDC_NORMAL (1) #define VI_FDC_STREAM (2) #define VI_LOCAL_SPACE (0) #define VI_A16_SPACE (1) #define VI_A24_SPACE (2) #define VI_A32_SPACE (3) #define VI_UNKNOWN_LA (-1) #define VI_UNKNOWN_SLOT (-1) #define VI_UNKNOWN_LEVEL (-1) #define VI_QUEUE (1) #define VI_HNDLR (2) #define VI_SUSPEND_HNDLR (4) #define VI_ALL_MECH (0xFFFF) #define VI_ANY_HNDLR (0) #define VI_TRIG_SW (-1) #define VI_TRIG_TTL0 (0) #define VI_TRIG_TTL1 (1) #define VI_TRIG_TTL2 (2) #define VI_TRIG_TTL3 (3) #define VI_TRIG_TTL4 (4) #define VI_TRIG_TTL5 (5) #define VI_TRIG_TTL6 (6) #define VI_TRIG_TTL7 (7) #define VI_TRIG_ECL0 (8) #define VI_TRIG_ECL1 (9) #define VI_TRIG_PROT_DEFAULT (0) #define VI_TRIG_PROT_ON (1) #define VI_TRIG_PROT_OFF (2) #define VI_TRIG_PROT_SYNC (5) #define VI_READ_BUF (1) #define VI_WRITE_BUF (2) #define VI_READ_BUF_DISCARD (4) #define VI_WRITE_BUF_DISCARD (8) #define VI_ASRL_IN_BUF (16) #define VI_ASRL_OUT_BUF (32) #define VI_ASRL_IN_BUF_DISCARD (64) #define VI_ASRL_OUT_BUF_DISCARD (128) #define VI_FLUSH_ON_ACCESS (1) #define VI_FLUSH_WHEN_FULL (2) #define VI_FLUSH_DISABLE (3) #define VI_NMAPPED (1) #define VI_USE_OPERS (2) #define VI_DEREF_ADDR (3) #define VI_TMO_IMMEDIATE (0L) #define VI_TMO_INFINITE (0xFFFFFFFFL) #define VI_INFINITE (VI_TMO_INFINITE) #define VI_NO_LOCK (0) #define VI_EXCLUSIVE_LOCK (1) #define VI_SHARED_LOCK (2) #define VI_LOAD_CONFIG (4) #define VI_NO_SEC_ADDR (0xFFFF) #define VI_ASRL_PAR_NONE (0) #define VI_ASRL_PAR_ODD (1) #define VI_ASRL_PAR_EVEN (2) #define VI_ASRL_PAR_MARK (3) #define VI_ASRL_PAR_SPACE (4) #define VI_ASRL_STOP_ONE (10) #define VI_ASRL_STOP_TWO (20) #define VI_ASRL_FLOW_NONE (0) #define VI_ASRL_FLOW_XON_XOFF (1) #define VI_ASRL_FLOW_RTS_CTS (2) #define VI_ASRL_END_NONE (0) #define VI_ASRL_END_LAST_BIT (1) #define VI_ASRL_END_TERMCHAR (2) #define VI_ASRL_END_BREAK (3) #define VI_STATE_ASSERTED (1) #define VI_STATE_UNASSERTED (0) #define VI_STATE_UNKNOWN (-1) #define VI_BIG_ENDIAN (0) #define VI_LITTLE_ENDIAN (1) #define VI_DATA_PRIV (0) #define VI_DATA_NPRIV (1) #define VI_PROG_PRIV (2) #define VI_PROG_NPRIV (3) #define VI_BLCK_PRIV (4) #define VI_BLCK_NPRIV (5) #define VI_D64_PRIV (6) #define VI_D64_NPRIV (7) #define VI_WIDTH_8 (1) #define VI_WIDTH_16 (2) #define VI_WIDTH_32 (4) #if defined(__cplusplus) || defined(__cplusplus__) } #endif #endif /*- 结束 ------------------------------------*/ -- ※ 来源:?饮水思源 bbs.sjtu.edu.cn?[FROM: 210.32.190.9]