VISA 函数的运用解释

短命女 2022-08-05 00:51 1138阅读 0赞

# [ VISA操作 ][VISA_] #

VISA操作表

操作表：

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）：释放内存分配。

属性表：  
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）：释放内存分配。  
在VISA定义的操作函数列，只是VISA规范的一小部分，但有一些操作函数并没有在VISA规范中定义过，属于软件本身补充定义的，如打开资源管理器函数viOpenDefaultRM（）函数在仪器系统初始化时进行调用，建立仪器系统资源管理器与VISA软件的关联；viStatusDesc（）函数在VISA函数调用返回后调用，并将前一个VISA函数调用返回值作为输入参数，获取字符串形式的状态描述；viFindNext（）函数是viFindRsrc（）函数的补充，用于查寻VISA系统资源；viMemAlloc（）函数与viMemFree（）函数用于器件存储器内存操作。而对于VISA规范中的VISA仪器控制组织器资源与VISA特定接口仪器控制资源定义的操作，VISA1.1中均没有定义，这也为VISA软件今后的发展提供了方向。可以看到，应用VISA1.1函数，可以实现仪器系统基本编程要求，但对于特定的操作，尚需要进一步扩充，VISA软件本身是一个不断完善与发展的产物。如果要修改与开发VISA软件，必须遵循VISA规范，并基于VISA模型进行开发

三、 VISA（VPP-4）  
VISA：Virtual Instrumentation Software Architecture，即虚拟仪器软件结构，是VPP系统联盟制定的I/O接口软件标准及其相关规范的总称。  
VISA为虚拟仪器提供了标准化的I/O接口软件规范。VISA是整个工业界的统一的软件基础。  
虚拟仪器软件结构中的标准 I/O 接口软件称为VISA库。  
1. VISA的作用  
为整个工业界提供统一的软件基础  
对驱动程序、应用程序不必考虑接口类型  
仅规定为用户提供的标准函数，不对具体实现作任何说明  
用于编写符合VPP规范的仪器驱动程序，完成计算机与仪器之间的命令和数据传输，实现对仪器的控制。  
VISA库作为低层 I/O 接口软件，运行于计算机系统中。  
2. VISA的特点  
适用于各类仪器：VXI, PXI, GPIB, RS-232, TCP, USB… …  
与硬件接口无关  
既适用于单处理器结构又适用于多处理器或分布式结构  
适用于多种网络机制  
3. VISA库函数  
资源管理类函数  
viOpenDefaultRM (ViPSession Rsrc\_Manager\_Handle);  
viOpenDefaultRM(&defaultRMHandle);  
ViStatus viOpen (ViSession Rsrc\_Manager\_Handle, ViRsrc Instrument\_Descriptor, ViAccessMode Access\_Mode, ViUInt32 Open\_Timeout, ViPSession Instrument\_Handle);  
viOpen (defaultRMHandle, "VXI0::24::INSTR", VI\_NULL, VI\_NULL, &dmmHandle);  
ViStatus viClose (ViSession Session\_Handle);  
viClose(dmmHandle);

资源操作类函数  
寄存器基仪器通讯  
viIn8, viIn16, viIn32  
viIn16 (dmmHandle, VI\_A16\_SPACE, 0, &manufactureID);  
viOut8, viOut16, viOut32  
viOut16 (dmmHandle, VI\_A16\_SPACE, 4, 0);  
消息基仪器通讯  
viRead, viWrite  
viRead (dmmHandle, readbuf, 100, &count);  
viWrite (dmmHandle, writebuf, 100, &count);  
格式化I/O  
viPrintf, viScanf  
viPrintf (dmmHandle, "\*IDN?\\n");  
viScanf (dmmHandle, "%t", result);

资源模板  
事件处理  
viEnableEvent, viDisableEvent  
viInstallHandler, viUninstallHandler  
viWaitOnEvent  
资源属性  
viGetAttribute, viSetAttribute

用VISA函数操作仪器的步骤  
打开VISA资源管理器句柄，用到的函数：viOpenDefaultRM；  
打开仪器句柄，用到的函数：viFindRsrc、viFindNext、viOpen等；  
设置仪器状态、控制仪器操作、读取测量数据、处理仪器事件，用到的函数： viGetAttribute、viSetAttribute、viIn16、viOut16、viPrintf、viScanf、viInstallHandler、viUninstallHandler、viEnableEvent、viDisableEvent、viWaitOnEvent等；  
释放仪器句柄，用到的函数：viClose；  
释放VISA资源管理器句柄，用到的函数：viClose。

VISA函数应用举例  
void main(void)  
\{  
error=viOpenDefaultRM (&rsrcManager); /\*打开VISA资源管理器\*/  
//rsrcManager为得到的VISA资源管理器句柄  
if(error!=VI\_SUCCESS) /\*如果出错，弹出错误信息对话框，返回\*/  
\{ MessagePopup("Error","Open VISA Resource Manager Error!");  
return;  
\}  
error = viOpen (rsrcManager, "VXI0::16::INSTR", VI\_NULL, VI\_NULL, &instHandle); //instHandle为得到的仪器句柄

if(error!=VI\_SUCCESS)\{  
MessagePopup("Error","Open Instrument Error!");  
return;  
\}  
else\{ /\*获取仪器模块代码，设置仪器操作超时时间为2000毫秒\*/  
viGetAttribute (instHandle, VI\_ATTR\_MODEL\_CODE, &moduleID); viSetAttribute (instHandle, VI\_ATTR\_TMO\_VALUE, 2000);  
\}  
viClose(instHandle); /\*关闭仪器句柄和VISA资源管理器\*/  
viClose(rsrcManager);  
\}

[VISA_]: http://blog.csdn.net/lonelyboy34/article/details/8443275