Measure GPIB User Manual
Contents
1. 3 4 Table 3 3 Advanced Instrument Setup Options 3 5 Table 3 4 GPIB Tasks Dialog Box Options 3 7 Table 3 5 Capture Task Dialog Box Options 3 8 Table 3 6 Transmission Task Dialog Box Options 3 11 Table 3 7 Define Fields Dialog Box Options 3 13 Table A 1 Measure Return Values A 1 Table A 2 GetGPIBError Error Codes A 1 National Instruments Corporation ix Measure GPIB User Manual The Measure GPIB User Manual describes how to install set up and use the Measure GPIB Add In for Microsoft Excel You should be familiar with the operation of Microsoft Excel your computer and your computer s memory system Organization of This Manual The Measure GPIB User Manual is organized as follows Chapter 1 Introduction describes the procedures for installing and uninstalling Measure for Windows and for adding and removing the2. x Customer Communication xi Chapter 1 Introduction 1 1 Installing Measure 1 1 Manually Adding or Removing the GPIB Add In 1 1 Uninstalling Measure 1 2 Chapter 2 Getting Started with GPIB Tasks 2 1 Instruments 2 1 Example Configure the Fluke 45 Multimeter 2 2 Example Test the Instrument Connection 2 3 Tasks 2 4 Capture Tasks 2 4 Fields
3. 2 6 Parsing by Custom defined Delimiters 2 6 Parsing by Width 2 6 Parsing by the Default Delimiter 2 7 Transmission Tasks 2 7 Example Create an Instrument Configure Task 2 8 Example Create an Instrument Read Task 2 9 Example Run Your GPIB Tasks 2 10 Example Add Tasks to the GPIB Menu 2 12 Communication Strings 2 12 Table of Contents Measure GPIB User Manual National Instruments Corporation vi Chapter 3 GPIB Task Reference 3 1 GPIB Instrument Setup Dialog Box 3 1 Instrument Test Dialog Box 3 3 Advanced Instrument Setup Dialog Box 3 4 Tasks Dialog
4. Width Sets the width of the currently selected field Include Determines whether Measure should store the currently selected field in the spreadsheet or ignore it once it is read National Instruments Corporation 4 1 Measure GPIB User Manual Using Measure GPIB Tasks with VBA This chapter describes the functions that the GPIB Add In adds to Visual Basic for Applications VBA the programming language built into Microsoft Excel Calling Functions from VBA There are two ways to execute the VBA functions provided by the GPIB Add In 1 Use the Excel method Application Run As long as the GPIB Add In is added as an add in the functions are called using the following syntax result Application Run FunctionName argument1 argument2 argument3 A few examples are listed below result Application Run GPIB Read some data sheet1 a1 a50 result Application Run GPIB xla CloseGPIBInstrument MyInstrument Application Run GPIB Read some data Note ignores return value 2 Add a reference to the GPIB Add In then call the functions directly To add a reference you must have a module open instead of a worksheet To insert a new module select Insert Macro Module To add a reference to the GPIB Add In select Tools References Put a check in the checkbox next to GPIB xla and click on OK Chapter 4 Using Measure GPIB Tasks with VBA Measure G
5. You can correct the EDMA problem in the hardware by using the Device Manager to reconfigure the hardware to not use a DMA resource ECAP 11 ECAP results when your GPIB board lacks the ability to carry out an operation or when a particular capability has been disabled in the software and a call is made that requires the capability Solutions Check the validity of the call or make sure your GPIB interface board and the driver both have the needed capability EBUS 14 EBUS results when certain GPIB bus errors occur during device functions All device functions send command bytes to perform addressing and other bus management Devices are expected to accept these command bytes within the time limit specified by the timeout value EBUS results if a timeout occurred while sending these command bytes Appendix A Error Codes and Solutions National Instruments Corporation A 5 Measure GPIB User Manual Solutions Verify that the instrument is operating correctly Check for loose or faulty cabling or several powered off instruments on the GPIB If the timeout period is too short for the driver to send command bytes increase the timeout period in the Advanced Settings dialog box National Instruments Corproation B 1 Measure GPIB User Manual Customer Communication For your convenience this appendix contains forms to help you gather the information necessary to help us solve technical problems you mig
6. 7455 Mexico 95 800 010 0793 5 520 3282 Netherlands 0348 433466 0348 430673 Norway 32 84 84 00 32 84 86 00 Singapore 2265886 2265887 Spain 91 640 0085 91 640 0533 Sweden 08 730 49 70 08 730 43 70 Switzerland 056 20 51 51 056 200 51 55 Taiwan 02 377 1200 02 737 4644 U K 01635 523545 01635 523154 Technical Support Form Photocopy this form and update it each time you make changes to your software or hardware and use the completed copy of this form as a reference for your current configuration Completing this form accurately before contacting National Instruments for technical support helps our applications engineers answer your questions more efficiently If you are using any National Instruments hardware or software products related to this problem include the configuration forms from their user manuals Include additional pages if necessary Name Company Address Fax Phone Computer brand Model Processor Operating system Windows 3 1 Windows for Workgroups 3 11 Windows NT 3 1 Windows NT 3 5 Windows 95 other include version number Version of Excel look at Excel s About box 5 0 5 0c other Clock Speed MHz RAM MB Display adapter Mouse yes no Other adapters installed Hard disk capacity MB Brand Instruments used National Instruments hardware product model Revision Configuration National Instruments software product Version Configuration The problem is Lis
7. Box 3 6 Capture Task Dialog Box 3 7 Transmission Task Dialog Box 3 10 Define Fields Dialog Box 3 12 Chapter 4 Using Measure GPIB Tasks with VBA 4 1 Calling Functions from VBA 4 1 GPIB Add In Functions 4 2 Appendix A Error Codes and Solutions Appendix B Customer Communication Glossary Index Figures Figure 1 1 GPIB Add Ins Dialog Box 1 2 Figure 2 1 GPIB Instrument Setup Dialog Box 2 3 Figure 2 2 GPIB Instrument Test Dialog Box 2 4 Figure 2 3 Capture Task Switching the Fluke 45 to Volts DC 2 9 Figure 2 4 Capture Task Reading Data from
8. Manual Edition Date August 1996 Part Number 321295A 01 Please comment on the completeness clarity and organization of the manual If you find errors in the manual please record the page numbers and describe the errors Thank you for your help Name Title Company Address Phone Mail to Technical Publications Fax to Technical Publications National Instruments Corporation National Instruments Corporation 6504 Bridge Point Parkway MS 53 02MS 53 02 Austin TX 78730 5039 512 794 5678 National Instruments Corporation G 1 Measure GPIB User Manual Prefix Meaning Value p n m k M pico nano micro milli kilo mega 10 12 10 9 10 6 10 3 103 106 A Add In A software package designed to integrate into Microsoft Excel B Bit A single value of 1 or 0 A byte consists of 8 bits Byte The standard method of representing numbers or characters in computers Eight binary digits bits make up a byte C Capture Task A task used to retrieve data from an instrument and store it in a range in the Excel worksheet Command String A string sent to an instrument Glossary Measure GPIB User Manual G 2 National Instruments Corporation E Escape Sequence A special string used to represent an unprintable character For example 10 is the escape sequence for a linefeed character F Field A field is a division of a line of data Li
9. Value For a list of return values see Table A 1 Measure Return Values in Appendix A Error Codes and Solutions National Instruments Corporation A 1 Measure GPIB User Manual Error Codes and Solutions This appendix describes the errors that can be encountered while using the GPIB Add In some conditions under which they might occur and possible solutions The following table lists the possible return values for GPIB Table A 1 Measure Return Values Return Value Error Description 0 MEASURE_OK The task ran successfully 1000 MEASURE_NOTFOUND The given task was not found 1001 MEASURE_INVALIDRANGE The given range is invalid 1002 MEASURE_TIMEDOUT The task timed out while waiting for data from the instrument 1003 MEASURE_INTERRUPTED The user interrupted the task 1005 MEASURE_ERROR An error occurred while communicating with the instrument Call GetMeasureGPIBError to determine the error The following table lists the possible return values for GetMeasureGPIBError Table A 2 GetMeasureGPIBError Return Values Error Mnemonic Error Value Meaning EDVR 0 System error ECIC 1 Function requires GPIB board to be CIC ENOL 2 No Listeners on the GPIB Appendix A Error Codes and Solutions Measure GPIB User Manual A 2 National Instruments Corporation EABO 6 I O operation aborted timeout ENEB 7 Nonexistent GPIB board EDMA 8 DMA error ECAP 11 No capability for o
10. close the Add Ins dialog box Chapter 1 Introduction Measure GPIB User Manual 1 2 National Instruments Corporation You also can remove the GPIB Add In manually To do so complete the followiong steps 1 From the GPIB Add Ins dialog box shown in Figure 1 1 click on the checkbox next to the item Measure GPIB Add In 2 When you have removed the check mark click on OK to close the dialog box Figure 1 1 GPIB Add Ins Dialog Box Uninstalling Measure To uninstall Measure remove the Serial Add In the Data Acquisition Add In and the GPIB Add In from the Add ins list in Excel Double click the Uninstall icon in the Measure folder to remove Measure from your computer National Instruments Corporation 2 1 Measure GPIB User Manual Getting Started with GPIB Tasks This chapter explains how to get started with GPIB tasks It describes instruments tasks and how the GPIB Add In of Measure for Windows allows you to communicate from MS Excel to instruments connected to a GPIB card in your computer Measure sends commands to your instruments reads data from your instruments and stores it in a spreadsheet or takes data from a spreadsheet and sends it to your instruments Objects in Measure called tasks are the method of communication You can define one or more tasks for each instrument Once you have created a task you can run it from the GPIB Tasks dialog box from the GPIB menu or from any Visual Basic for Applic
11. response string is given Measure sends it to the instrument 9 If a delay is given Measure waits the given number of milliseconds before continuing 10 The sequence starts again at step 3 using the next row in the range to store the captured data The task finishes when all rows in the range are used or no range is given If no range is given Measure executes the sequence one time and ignores any data received from the instrument This is a convenient way to send simple commands to the instrument Chapter 2 Getting Started with GPIB Tasks Measure GPIB User Manual 2 6 National Instruments Corporation Fields When an instrument reads data using a capture task it is useful to parse the data and separate it into fields A capture task allows you to parse captured data using delimiters such as a comma or semicolon or by defining the width of each field If no fields are defined Measure places all data received before the end of line string into one cell In the following three examples one parses by custom defined delimiters another by width and the third by the default delimiter Parsing by Custom defined Delimiters Assume you have an instrument that returns a measurement of two coordinates x and y The instrument returns a string of the form x y 13 10 where x and y each can be from 1 to 5 digits In this case the best parsing method is to use delimiters The simplest solution is to create two fields The first
12. the Fluke 45 2 10 Figure 2 5 VBA Code to Read Data From the Fluke 45 2 11 Figure 3 1 GPIB Instrument Setup Dialog Box 3 1 Figure 3 2 Instrument Test Dialog Box 3 3 Figure 3 3 Advanced Instrument Setup Dialog Box 3 5 Figure 3 4 GPIB Tasks Dialog Box 3 6 Figure 3 5 Capture Task Dialog Box 3 8 Figure 3 6 Transmission Task Dialog Box 3 10 Table of Contents National Instruments Corporation vii Measure GPIB User Manual Figure 3 7 Define Fields Dialog Box 3 12 Tables Table 2 1 GBIB Commands 2 13 Table 3 1 GPIB Instrument Setup Options 3 2 Table 3 2 Instrument Test Options
13. B Setup Instruments or clicking on the Edit Instruments button from the Tasks dialog box Figure 3 1 shows the GPIB Instrument Setup dialog box Figure 3 1 GPIB Instrument Setup Dialog Box Chapter 3 GPIB Task Reference Measure GPIB User Manual 3 2 National Instruments Corporation The Instruments list box contains an entry for each instrument defined in Measure The controls in the Port Setup group box apply to the instrument currently selected in the list box Table 3 1 GPIB Instrument Setup Options provides a description of all the options available from the GPIB Instrument Setup dialog box Table 3 1 GPIB Instrument Setup Options Option Description New Adds a new instrument The maximum number of instruments is 50 Delete Deletes the currently selected instrument Test Tests communications with the instrument Find Instruments Locates all instruments connected to the computer and adds them to Measure Board Index The index of the GPIB card in the computer connected to the GPIB bus the instrument is connected to Primary Address The instrument s primary address This address usually is set on the front panel of the instrument Secondary Address The instrument s secondary address Most instruments do not support a secondary address Advanced Setup Brings up the Advanced Setup dialog box Use the Advanced Setup dialog box to configure the EOS end of string character and EOI end of informati
14. ERETOFORE PAID BY THE CUSTOMER NATIONAL INSTRUMENTS WILL NOT BE LIABLE FOR DAMAGES RESULTING FROM LOSS OF DATA PROFITS USE OF PRODUCTS OR INCIDENTAL OR CONSEQUENTIAL DAMAGES EVEN IF ADVISED OF THE POSSIBILITY THEREOF This limitation of the liability of National Instruments will apply regardless of the form of action whether in contract or tort including negligence Any action against National Instruments must be brought within one year after the cause of action accrues National Instruments shall not be liable for any delay in performance due to causes beyond its reasonable control The warranty provided herein does not cover damages defects malfunctions or service failures caused by owner s failure to follow the National Instruments installation operation or maintenance instructions owner s modification of the product owner s abuse misuse or negligent acts and power failure or surges fire flood accident actions of third parties or other events outside reasonable control Copyright Under the copyright laws this publication may not be reproduced or transmitted in any form electronic or mechanical including photocopying recording storing in an information retrieval system or translating in whole or in part without the prior written consent of National Instruments Corporation Trademarks Measure is a trademark of National Instruments Corporation Product and company names listed are trademarks or trade names of their
15. GPIB Add in Chapter 2 Getting Started with GPIB Tasks explains how to get started with GPIB tasks It describes instruments tasks and how the GPIB Add in of Measure for Windows allows you to communicate from MS Excel to instruments connected to a GPIB card in your computer Chapter 3 GPIB Task Reference describes and outlines procedures for using every menu and dialog box available in the GPIB Add In Chapter 4 Using Measure GPIB Tasks with VBA describes the functions that the GPIB Add In adds to Visual Basic for Applications VBA the programming language built into Microsoft Excel Appendix A Error Messages describes the errors that can be encountered while using the GPIB Add In some conditions under which they might occur and possible solutions About This Manual Measure GPIB User Manual National Instruments Corporation x Appendix B Customer Communication contains forms you can use to request help from National Instruments or to comment on our products and manuals The Glossary contains an alphabetical list and description of terms used in this manual including abbreviations acronyms metric prefixes mnemonics and symbols The Index contains an alphabetical list of key terms and topics in this manual including the page where you can find each one Conventions Used in This Manual The following conventions are used in this manual bold Bold text denotes a paramet
16. In N New Capture button Tasks dialog box 2 4 3 7 New option GPIB Instrument Setup dialog box 3 2 New Transmit button Tasks dialog box 2 4 3 7 nonprinting characters entering 2 12 Number of Fields option 3 13 Index National Instruments Corporation I 5 Measure GPIB User Manual P parsing fields by custom defined delimiters 2 6 by width 2 6 to 2 7 using default delimiter 2 7 Parsing Method Delimiters option 3 13 Parsing Method Width option 3 13 Primary Address option 3 2 R Read GPIB button 3 3 3 4 Receive edit box 3 3 3 4 reference adding to GPIB Add In 4 1 to 4 2 removing GPIB Add In manually 1 1 to 1 2 Repeat Count option 3 11 Response String option Capture Task dialog box 3 9 Transmission Task dialog box 3 12 Result range option 3 9 return values for Measure table A 1 Run button 3 7 running tasks 2 10 to 2 12 S Secondary Address option 3 2 Send Data button 3 3 3 4 SRQ command table 2 13 strings specifying in communications 2 12 to 2 13 T Task Name option Capture Task dialog box 3 8 Transmission Task dialog box 3 11 tasks adding to GPIB menu 2 12 capture tasks parsing fields 2 6 to 2 7 purpose 2 4 steps in task 2 5 creating instrument configure task 2 8 to 2 9 instrument read task 2 9 to 2 10 definition 2 4 Fluke 45 Multimeter example configuring 2 2 to 2 3 testing the instrument connection 2 3 to 2 4 running 2 10 to 2 12 transmission tasks d
17. Measure GPIB User Manual August 1996 Edition Part Number 321295A 01 Copyright 1995 1996 National Instruments Corporation All rights reserved Internet Support Email measure support natinst com National Instruments Home Page http www natinst com FTP Site ftp natinst com Bulletin Board Support BBS United States 512 794 5422 or 800 327 3077 BBS United Kingdom 01635 551422 BBS France 1 48 65 15 59 FaxBack Support 512 418 1111 Telephone Support U S Tel 512 795 8248 Fax 512 794 5678 International Offices Australia 03 9 879 9422 Austria 0662 45 79 90 0 Belgium 02 757 00 20 Canada Ontario 519 622 9310 Canada Quebec 514 694 8521 Denmark 45 76 26 00 Finland 90 527 2321 France 1 48 14 24 24 Germany 089 741 31 30 Hong Kong 2645 3186 Italy 02 413091 Japan 03 5472 2970 Korea 02 596 7456 Mexico 95 800 010 0793 Netherlands 0348 433466 Norway 32 84 84 00 Singapore 2265886 Spain 91 640 0085 Sweden 08 730 49 70 Switzerland 056 200 51 51 Taiwan 02 377 1200 U K 01635 523545 National Instruments Corporate Headquarters 6504 Bridge Point ParkwayAustin TX 78730 5039 Tel 512 794 0100 Important Information Warranty The media on which you receive National Instruments software are warranted not to fail to execute programming instructions due to defects in materials and workmanship for a period of 90 days from date of shipment as evidenced by receipts or other documentation National Inst
18. PIB User Manual 4 2 National Instruments Corporation Now the functions from the GPIB Add In are called directly as in the following examples result GPIB Read some data sheet1 a1 a50 result CloseGPIBInstrument MyInstrument RunGPIBTask Read some data Note ignores return value Note The file gpib_con txt contains the constants returned by the Measure VBA functions GPIB Add In Functions The GPIB Add In defines the following four functions that are called from a VBA module CheckSRQ CloseGPIBInstrument GetMeasureGPIBError GPIB Each function is listed below with details of its use CheckSRQ Checks whether the specified instrument has raised the SRQ line on the GPIB bus to request service Syntax Function CheckSRQ sInstrumentName as string bSRQ as Boolean as Integer Parameters Parameter Name Description sInstrumentName Name of the instrument that asserts SRQ bSRQ Returned by CheckSRQ It contains True if the instrument asserted SRQ False otherwise Chapter 4 Using Measure GPIB Tasks with VBA National Instruments Corporation 4 3 Measure GPIB User Manual Return Value For a list of return values see Table A 1 Measure Return Values in Appendix A Error Codes and Solutions CloseGPIBInstrument Closes the specified instrument if it is open Syntax Function CloseGPIBInstrument sInstrumentName as String as Integer Par
19. ______________________________________ Operating System Mode __________________________________________________________ Programming Language __________________________________________________________ Programming Language Version ___________________________________________________ Other Boards in System __________________________________________________________ Base I O Address of Other Boards __________________________________________________ DMA Channels of Other Boards ___________________________________________________ Interrupt Level of Other Boards ____________________________________________________ For each instrument you are using Name of instrument ______________________________________________________________ Manufacturer of instrument________________________________________________________ Parity None Even Odd Mark Space Baud rate ______________________________________________________________________ Stop bits_______________________________________________________________________ Data bits_______________________________________________________________________ Flow control Hardware Software None Version of Measure look at the about box ___________________________________________ Documentation Comment Form National Instruments encourages you to comment on the documentation supplied with our products This information helps us provide quality products to meet your needs Title Measure GPIB User
20. ach of the following steps occurs once for each row in the spreadsheet range 3 If the corresponding checkbox is checked Measure triggers the instrument 4 If the corresponding checkbox is checked Measure waits for the instrument to assert SRQ to request service before continuing 5 If a command string is given Measure sends it to the instrument 6 The data from the first column of the current row of the range is sent to the instrument If no range is given this step is skipped Chapter 2 Getting Started with GPIB Tasks Measure GPIB User Manual 2 8 National Instruments Corporation 7 If an end of line string is given Measure sends the end of line string to the instrument 8 If a response string is given Measure waits for the instrument to send the response string 9 If a delay is given Measure waits the given number of milliseconds before continuing 10 The sequence starts again with step 3 using the next row in the range The sequence completes when all rows in the range are used or no range is given 11 If a repeat count is given steps 3 10 are repeated the given number of times If no range is given Measure executes the sequence one time and ignores any data received from the instrument This is a convenient way to send simple commands to the instrument Example Create an Instrument Configure Task Now that you have configured and tested the instrument you can create the necessary tasks In th
21. ameters Parameter Name Description sInstrumentName Name of the instrument to close Return Value For a list of return values see Table A 1 Measure Return Values in Appendix A Error Codes and Solutions GetMeasureGPIBError This function should be called after a Measure function returns MEASURE_ERROR Syntax Function GetMeasureGPIBError as Integer Parameters This function has no parameters Return Value If there was no error 0 is returned Otherwise Measure returns the GPIB error For a list of possible return values see Table A 2 GetMeasureGPIBError Return Values in Appendix A Error Codes and Solutions Chapter 4 Using Measure GPIB Tasks with VBA Measure GPIB User Manual 4 4 National Instruments Corporation GPIB Executes the named task If sRange is not given the default range of the task is used Otherwise the given range is used Syntax Function GPIB sTaskName As String Optional sRange As Variant Optional ReferenceStyle As Variant As Integer Parameters Parameter Name Description sTaskName Name of the task to run sRange String representing the range to use when running the task sRange should be of the form sheetname a1 a50 where sheetname is optional If sRange is omitted Measure uses the range defined for the task in the dialog box ReferenceStyle Either xlA1 or xlR1C1 specifies the reference style of the range passed in The default reference style is xlA1 Return
22. ations VBA code the programming language built into Microsoft Excel Throughout this chapter examples and step by step instructions are given to help you get started with GPIB tasks Measure adds four VBA functions allowing more sophisticated communication between the computer and the GPIB device For more information about these functions see Chapter 4 Using Measure GPIB Tasks with VBA Instruments In Measure an instrument is a name given to the information about a physical device such as the GPIB address and communications settings You must configure an instrument before Measure can use it After you configure an instrument you can create tasks to interact with the instrument The sections below present two examples of setting up and collecting data from an instrument Chapter 2 Getting Started with GPIB Tasks Measure GPIB User Manual 2 2 National Instruments Corporation Example Configure the Fluke 45 Multimeter This example outlines the steps for setting up and collecting data from a Fluke 45 Multimeter using GPIB Both menu driven and VBA operations are illustrated The workbook containing this example is distributed with Measure as the file gpbflk45 xls The Fluke 45 Multimeter is capable of measuring AC amp DC voltage AC amp DC current and frequency among other things The goal of this example is to switch the multimeter to Volts DC mode and read the voltage 10 times at one second intervals The foll
23. e bottom of the screen corresponding to the worksheet you were on when you added the module as shown in Figure 2 5 9 The data is in the range a1 a10 on the worksheet Example Add Tasks to the GPIB Menu You can add tasks that are run often to the GPIB menu To add a task to the menu complete the following steps 1 Select GPIB Tasks 2 Click on the Edit Menu button to display the Edit Menu Tasks dialog box Use this dialog box to add or remove tasks When both the Edit Menu Tasks and the Tasks dialog boxes are closed using their OK buttons the tasks are added under the GPIB menu 3 To run a task select it from the menu When running tasks from the menu the current selection on the spreadsheet is used as the range of the task If there is no selection on the active spreadsheet the range specified in the dialog box is used Communication Strings When communicating with GPIB instruments it is often necessary to specify characters that are difficult to print A good example is the carriage return character ASCII 13 For this reason any time a string is requested in a text box Measure accepts a special sequence of characters to specify unprintable characters The sequence consists of a backslash followed by up to three numbers representing the base 10 ASCII numeric value of the character For instance the carriage return character ASCII 13 is represented by the string 13 or 013 To specify the common carriage ret
24. e task For example setting the repeat count to 5 causes Measure to execute the task five times If the repeat count is 0 Measure runs the task indefinitely When Measure executes a task clicking on Q interrupts the task Trigger Instrument Specifies that Measure should trigger the instrument before continuing the task Wait for SRQ Specifies that Measure should wait for the instrument to assert SRQ to request service before continuing the task Command String The first string sent to the instrument during each iteration of a task This field can be left blank Refer to the section in Chapter 2 on communication strings for help creating this string Transmission Range Measure executes the task sequence once for each row in this range If the range is blank Measure executes the sequence once Leaving the range blank is useful for sending commands that set the instrument to a certain mode See the Ranges section for help on specifying the range End of line String The end of line string is sent to the instrument after the data from the transmission range is sent This field can be left blank Refer to the section on Communication Strings for help creating this string Chapter 3 GPIB Task Reference Measure GPIB User Manual 3 12 National Instruments Corporation Response String After transmitting the command string data from the range and the end of line string Measure waits for the instrument to respond with a response str
25. efinition 2 7 steps in task 2 7 to 2 8 Tasks dialog box 2 4 GPIB task reference 3 6 to 3 7 Close Instrument 3 7 Delete 3 7 Description 3 7 Edit 3 7 Edit Instruments 3 7 Edit Menu 3 7 Instrument list box 3 7 New Capture 3 7 New Transmit 3 7 Run 3 7 Tasks list box 3 7 illustration 3 6 running tasks from 2 10 Tasks list box 3 7 technical support B 1 to B 2 Test option 3 2 testing instrument connection 2 3 to 2 4 Timeout option Capture Task dialog box 3 9 Transmission Task dialog box 3 11 Transmission Range option 3 11 Transmission Task dialog box 3 10 to 3 12 Clear instrument 3 11 Command String 3 11 Delay 3 12 Description 3 11 Index Measure GPIB User Manual I 6 National Instruments Corporation Display status 3 11 End of line String 3 11 illustration 3 10 Repeat Count 3 11 Response String 3 12 Task Name 3 11 Timeout 3 11 Transmission Range 3 11 Trigger Instrument 3 11 Wait for SRQ 3 11 transmission tasks definition 2 7 steps in task 2 7 to 2 8 Transmit edit box 3 3 3 4 TRIG command table 2 13 Trigger Instrument option Capture Task dialog box 3 9 Transmission Task dialog box 3 11 U uninstalling Measure 1 2 V Visual Basic for Applications VBA calling functions from VBA 4 1 to 4 2 GPIB Add In functions CheckSRQ 4 2 to 4 3 CloseGPIBInstrument 4 3 GetMeasureGPIBError 4 3 GPIB 4 4 W Wait for SRQ option Capture Task dialog box 3 9 Transmission Task d
26. elds than were defined originally The default delimiter is especially useful when an instrument sends multiple fields delimited by the same delimiter For example data of the form x1 x2 x3 x4 x5 x6 x7 x8 x9 x10 could be parsed in two ways First you could create 10 fields all delimited by commas A simpler solution would be to create no fields at all but set the default delimiter to a comma It is important to understand how Measure parses the data using each of the two solutions When you create 10 fields Measure reads 10 fields from the instrument no matter how many columns in the range you provide to store the result However if an end of line character is encountered before all 10 fields are read Measure stops reading the current row and continues with the next row If you use a default delimiter Measure continues to read fields for the current row until an end of line character is encountered or data for every column in the range has been read Transmission Tasks A transmission task reads data from a spreadsheet range and sends the data to an instrument A transmission task is a repeating process that reads data from a spreadsheet and sends it to an instrument When a transmission task begins the following steps occur 1 If the Clear Instrument checkbox is checked Measure clears the instrument 2 If an initialization command is given Measure sends it to the instrument A transmission task is complete when e
27. er or the introduction of menus menu items or dialog box buttons or options italic Italic text denotes emphasis a cross reference or an introduction to a key concept bold italic Bold italic text denotes a note caution or warning monospace Text in this font denotes text or characters that are to be literally input from the keyboard sections of code programming examples and syntax examples This font is also used for the proper names of disk drives paths directories programs subprograms subroutines device names functions variables filenames and extensions and for statements and comments taken from program code The symbol leads you through nested menu items and dialog box options to a final action The sequence Files Page Setup Options Substitute Fonts directs you to pull down the File menu select the Page Setup item select Options and finally select the Substitute Fonts option from the last dialog box Note This icon to the left of bold italicized text denotes a note which alerts you to important information About This Manual National Instruments Corporation xi Measure GPIB User Manual Customer Communication National Instruments wants to receive your comments on our products and manuals We are interested in the applications you develop with our products and we want to help you if you have problems with them To make it easy for you to contact us this manual contains comment and
28. ess 3 2 Secondary Address 3 2 Test 3 2 Instrument Test dialog box 3 3 to 3 4 Read GPIB 3 4 Receive edit box 3 3 3 4 Send Data 3 4 Transmit edit box 3 3 3 4 Tasks dialog box Close Instrument 3 7 Delete 3 7 Description 3 7 Edit 3 7 Edit Instruments 3 7 Edit Menu 3 7 Instrument list box 3 7 New Capture 3 7 New Transmit 3 7 Run 3 7 Tasks list box 3 7 Transmission Task dialog box 3 10 to 3 12 Clear instrument 3 11 Command String 3 11 Delay 3 12 Description 3 11 Display status 3 11 End of line String 3 11 Repeat Count 3 11 Response String 3 12 Task Name 3 11 Timeout 3 11 Transmission Range 3 11 Trigger Instrument 3 11 Wait for SRQ 3 11 I Include option Define Fields dialog box 3 13 installation adding GPIB Add In manually 1 1 to 1 2 Measure for Windows 1 1 removing GPIB Add In manually 1 1 to 1 2 uninstalling Measure 1 2 instrument configure task creating 2 8 to 2 9 Instrument list box 3 7 Instrument Test dialog box Fluke 45 Multimeter example 2 3 to 2 4 GPIB task reference 3 3 to 3 4 Read GPIB 3 4 Receive edit box 3 3 3 4 Send Data 3 3 3 4 Transmit edit box 3 3 3 4 illustration 3 3 instruments configuring Fluke 45 multimeter example 2 2 creating instrument configure task 2 8 to 2 9 creating instrument read task 2 9 to 2 10 definition 2 1 testing the instrument connection 2 3 to 2 4 L LOCAL command table 2 13 M Measure GPIB Add In See GPIB Add
29. field has a comma as a delimiter and the second field has 13 10 as its delimiter In this case no end of line characters are used because the fields you defined completely define the data sent by the instrument Parsing by Width When an Ohaus scale is asked for its current weight it responds with a 20 character string of the following format Field Polarity Weight Blank Mode Stability Address Cr Lf Length 1 8 1 5 1 2 2 Picking out the weight field from this string is accomplished easily by parsing by width because you know the location and width of the data you want There are several variations on the solution but the simplest solution is to create two fields field one being one character wide and field two being eight characters wide Additionally the end of line character must be set to 13 10 to indicate the end of a string All characters between the weight field and 13 10 are thrown away because no fields were defined for them Another solution is to define three fields field one being one character wide field two being eight characters wide and field three being eleven characters wide In this case no end of line characters are necessary because the string returned from the scale is 20 characters wide Chapter 2 Getting Started with GPIB Tasks National Instruments Corporation 2 7 Measure GPIB User Manual Parsing by the Default Delimiter Using the default delimiter you can parse data into more fi
30. for help creating this string Result range The data read from the instrument is parsed into fields and stored in a row of this range Measure executes the task sequence once for each row in this range If this field is left blank Measure executes this sequence once ignoring any data that is read from the instrument Leaving the range blank is useful for sending commands that set the instrument to a certain mode See the section on Ranges for help on specifying the range End of line string If no end of line string is defined and no fields are defined but you have specified a range to store the results Measure waits for a Carriage Return 13 Line Feed 10 or the EOI signal from the device EOI When any of these standard termination characters are encountered Measure places all data before the termination characters in the specified worksheet cell and throws away the termination characters Response string Measure sends this string to the instrument after the end of line string is encountered or after all fields have been read if the end of line string was not defined This field can be left blank Delay This field determines how long Measure waits before starting the process again with the next row in the range Time is accurate to approximately 100 ms Define Fields Click on this button to open the Define Fields dialog box Chapter 3 GPIB Task Reference Measure GPIB User Manual 3 10 National Instruments Corporati
31. g on the Read Data button to read the port again Of course if you are just following these steps as a tutorial and do not actually have a Fluke 45 Multimeter there will not be any response 4 Close the Instrument Test dialog box by clicking on the OK button Chapter 2 Getting Started with GPIB Tasks Measure GPIB User Manual 2 4 National Instruments Corporation Figure 2 2 GPIB Instrument Test Dialog Box Tasks Operations done on instruments are called tasks There are two types of tasks capture tasks and transmission tasks Before you create a task you must configure an instrument To create a task complete the following steps 1 Select GPIB Tasks to open the Tasks dialog box 2 Select the correct instrument from the Instrument drop down box and click on the New Capture or New Transmit button to create a new task The Edit Capture Task dialog box or the Edit Transmit Task dialog box appears Capture Tasks A capture task is a repeating process that reads data from an instrument parses the data into fields and stores the data in a spreadsheet range When a capture task begins the following steps occur Chapter 2 Getting Started with GPIB Tasks National Instruments Corporation 2 5 Measure GPIB User Manual 1 If the Clear Instrument checkbox is checked Measure clears the instrument 2 If an initialization command is given Measure sends it to the instrument A capture task is complete when each
32. he support directories Appendix B Customer Communication Measure GPIB User Manual National Instruments Corporation B 2 FaxBack Support FaxBack is a 24 hour information retrieval system containing a library of documents on a wide range of technical information You can access FaxBack from a touch tone telephone at the following numbers 512 418 1111 E Mail Support currently U S only You can submit technical support questions to the appropriate applications engineering team through e mail at the Internet addresses listed below Remember to include your name address and phone number so we can contact you with solutions and suggestions measure support natinst com Fax and Telephone Support National Instruments has branch offices all over the world Use the list below to find the technical support number for your country If there is no National Instruments office in your country contact the source from which you purchased your software to obtain support Telephone Fax Australia 03 9 879 9422 03 9 879 9179 Austria 0662 45 79 90 0 0662 45 79 90 19 Belgium 02 757 00 20 02 757 03 11 Canada Ontario 519 622 9310 Canada Quebec 514 694 8521 514 694 4399 Denmark 45 76 26 00 45 76 26 02 Finland 90 527 2321 90 502 2930 France 1 48 14 24 24 1 48 14 24 14 Germany 089 741 31 30 089 714 60 35 Hong Kong 2645 3186 2686 8505 Italy 02 413091 02 41309215 Japan 03 5472 2970 03 5472 2977 Korea 02 596 7456 02 596
33. ht have as well as a form you can use to comment on the product documentation Filling out a copy of the Technical Support Form before contacting National Instruments helps us help you better and faster National Instruments provides comprehensive technical assistance around the world In the U S and Canada applications engineers are available Monday through Friday from 8 00 a m to 6 00 p m central time In other countries contact the nearest branch office You may fax questions to us at any time Electronic Services Bulletin Board Support National Instruments has BBS and FTP sites dedicated for 24 hour support with a collection of files and documents to answer most common customer questions From these sites you can also download the latest instrument drivers updates and example programs For recorded instructions on how to use the bulletin board and FTP services and for BBS automated information call 512 795 6990 You can access these services at United States 512 794 5422 or 800 327 3077 Up to 14 400 baud 8 data bits 1 stop bit no parity United Kingdom 01635 551422 Up to 9 600 baud 8 data bits 1 stop bit no parity France 1 48 65 15 59 Up to 9 600 baud 8 data bits 1 stop bit no parity FTP Support To access our FTP site log on to our Internet host ftp natinst com as anonymous and use your Internet address such as joesmith anywhere com as your password The support files and documents are located in t
34. ialog box 3 11 width parsing fields by 2 6 to 7
35. ing The timeout value determines how long Measure waits without signaling an error If this field is blank Measure skips this step of the sequence Refer to the section on communication strings for help creating this string Delay This field determines how long Measure waits before starting the process again with the next row in the range Time is accurate to approximately 100 ms Define Fields Dialog Box Use the Define Fields dialog box shown in Figure 3 7 to set up how the GPIB Add In parses data using a capture task To reach this dialog box click on the Define Fields button from the GPIB Capture Task dialog box Figure 3 7 Define Fields Dialog Box The options available from the Define Fields dialog box are shown in Table 3 7 Chapter 3 GPIB Task Reference National Instruments Corporation 3 13 Measure GPIB User Manual Table 3 7 Define Fields Dialog Box Options Option Description Number of Fields Determines how many fields the data breaks into List Box Contains an entry for each field that has been defined Parsing Method Width If selected Measure parses data into fields based on the width given for each field Parsing Method Delimiters If selected Measure parses data into fields based on the delimiter for each field Default Delimiters Sets the delimiter Measure uses by default Field Delimiter Sets the delimiter that Measure uses to determine the end of this field Field
36. ions available from the GPIB Tasks dialog box are shown in Table 3 4 Chapter 3 GPIB Task Reference National Instruments Corporation 3 7 Measure GPIB User Manual Table 3 4 GPIB Tasks Dialog Box Options Option Description Instrument list box Contains all the instruments defined in Measure Tasks list box Contains all the tasks defined for the currently selected instrument Edit Instruments Edits the instruments defined in Measure Close Instrument Closes the instrument selected in the instrument list box Create a Task Capture Creates a new capture task for the currently selected instrument There are a maximum of 200 tasks per instrument Create a Task Transmit Creates a new transmit task for the currently selected instrument There are a maximum of 200 tasks per instrument Run Runs the currently selected task Edit Edits the currently selected task Delete Deletes the currently selected task Description Contains the description of the currently selected task Edit Menu Edits the list of tasks that appear on the GPIB menu Capture Task Dialog Box Use the Capture Task dialog box to edit capture tasks To reach this dialog box click on New Capture from the Tasks dialog box or select a capture task on the Tasks dialog box and click on the Edit button Chapter 3 GPIB Task Reference Measure GPIB User Manual 3 8 National Instruments Corporation Figure 3 5 Capture Task Dialog Box The o
37. is example create a task to switch the multimeter to Volts DC mode Because this task is a simple command to the instrument you can create either a capture task or a transmission task In this case complete the following steps to create a capture task 1 Select GPIB Tasks 2 Select Fluke 45 from the Instrument drop down list 3 Click on the New Capture button and the Capture Task dialog box appears shown in Figure 2 3 4 Type Switch to Volts DC in the Task Name field 5 Type vdc in the Transmit this command string field 6 Click on the OK button to close this dialog box Chapter 2 Getting Started with GPIB Tasks National Instruments Corporation 2 9 Measure GPIB User Manual Figure 2 3 Capture Task Switching the Fluke 45 to Volts DC Example Create an Instrument Read Task Now complete the following steps to create a task to capture the data 1 Click on the New Capture button and the Capture Task dialog box appears shown in Figure 2 4 2 Type Read in the Task Name field 3 Type val1 in the Transmit this command string field 4 Type a1 a10 in the Store the result in this range field 5 Type 10 in the Wait for this end of line string field 6 Type 1000 in the Delay before restarting sequence field 7 Click on the OK button to close this dialog box Chapter 2 Getting Started with GPIB Tasks Measure GPIB User Manual 2 10 National Instruments Corporation Figure 2 4 Ca
38. n 3 7 EDMA error code A 4 EDVR error code A 2 e mail support B 2 End of line String option Capture Task dialog box 3 9 Transmission Task dialog box 3 11 End Of String Character option 3 5 ENEB error code A 3 ENOL error code A 2 to A 3 EOI Assert EOI at the end of each command option 3 5 Assert EOI when Measure sends EOS option 3 5 EOI command table 2 13 EOS Compare 7 bits of EOS rather than 8 option 3 5 End Of String Character option 3 5 error codes and solutions EABO A 3 EBUS A 4 to A 5 ECAP A 4 ECIC A 2 EDMA A 4 EDVR A 2 ENEB A 3 ENOL A 2 to A 3 GetMeasureGPIBError error codes table A 1 to A 2 Measure return values table A 1 F fax and telephone support B 2 FaxBack support B 2 Field Delimiter option 3 13 Field Width option 3 13 Index National Instruments Corporation I 3 Measure GPIB User Manual fields parsing by custom defined delimiters 2 6 by width 2 6 to 2 7 using default delimiter 2 7 purpose and use 2 6 Find and Add Instruments option 3 2 Fluke 45 Multimeter example configuring 2 2 to 2 3 creating instrument configure task 2 8 to 2 9 creating instrument read task 2 9 to 2 10 running defined tasks 2 10 to 2 12 testing instrument connection 2 3 to 2 4 FTP support B 1 G GetMeasureGPIBError function description 4 3 error codes table A 1 to A 2 GPIB Add In adding GPIB Add In manually 1 1 to 1 2 communications strings 2 12 to 2 13 overview 2 1 rem
39. n Capture Task dialog box 3 9 Transmission Task dialog box 3 11 Close Instrument option 3 7 CloseGPIBInstrument function 4 3 CLR command table 2 13 Command String option Capture Task dialog box 3 9 Transmission Task dialog box 3 11 communication strings 2 12 to 2 13 Index Measure GPIB User Manual I 2 National Instruments Corporation Compare 7 bits of EOS rather than 8 option 3 5 customer communication x xi B 1 to B 2 D Default Delimiters option 3 13 Define Fields dialog box 3 12 to 3 13 Default Delimiters 3 13 Field Delimiter 3 13 Field Width 3 13 illustration 3 12 Include 3 13 List Box 3 13 Number of Fields 3 13 Parsing Method Delimiters 3 13 Parsing Method Width 3 13 Define Fields option Capture Task dialog box 3 9 Delay option Capture Task dialog box 3 9 Transmission Task dialog box 3 12 Delete button GPIB Instrument Setup dialog box 3 2 Tasks dialog box 3 7 delimiters parsing fields by custom defined delimiters 2 6 parsing fields by default delimiter 2 7 Description field Capture Task dialog box 3 8 Tasks dialog box 3 7 Transmission Task dialog box 3 11 Display status option Capture Task dialog box 3 8 Transmission Task dialog box 3 11 documentation conventions used in manual x organization of manual ix x E EABO error code A 3 EBUS error code A 4 to A 5 ECAP error code A 4 ECIC error code A 2 Edit button 3 7 Edit Instruments option 3 7 Edit Menu butto
40. nes are separated into fields using one of the Serial Add In parsing techniques I Instrument In Measure a name given to information about the serial port settings of a real instrument L Line A line is a unit of data demarcated by end of line strings A line of data generally corresponds to a row of a transmit or capture range M MB megabytes of memory P Parse Parsing consists of breaking up lines of data into smaller more manageable units called fields In the Serial Add In you can parse a line of data based on width or using delimiters R Range A group of rows and columns on a spreadsheet Response When capturing data from an instrument the response is the character that Measure sends to the instrument after every line is received When transmitting data to an instrument the response is the character that Measure waits for from the instrument before sending another line of data Glossary National Instruments Corporation G 3 Measure GPIB User Manual S Synchronous A method of data communications in which a prearranged number of bits are transferred per second Synchronization occurs before and after the transmission of blocks of data rather than before and after every character There are no start bits or stop bits as there are in asynchronous communications Transmitted bits either represent information or are parity bits See Asynchronous T Transmission Task A task used to send data fr
41. ns available from the Advanced Instrument Setup dialog box are shown in Table 3 3 Table 3 3 Advanced Instrument Setup Options Option Description End Of String Character Used to help Measure know when to assert the EOI line when transmitting data to the instrument Assert EOI when Measure sends EOS Specifies whether Measure asserts the GPIB EOI line when Measure sends the EOS character Assert EOI at the end of each command Specifies whether Measure asserts the GPIB EOI line each time Measure sends a command For example in a capture task Measure would assert EOI after sending the string specified in the Transmit this command string field and after sending the string specified in the Transmit this response string Compare 7 bits of EOS rather than 8 Specifies how many bits of EOS Measure compares in determining when an EOS character is being transmitted or received GPIB Driver Timeout Specifies the timeout used when Measure makes calls to the GPIB driver Chapter 3 GPIB Task Reference Measure GPIB User Manual 3 6 National Instruments Corporation Tasks Dialog Box Use the Tasks dialog box shown in Figure 3 4 to manage tasks associated with instruments From this dialog box tasks are created run edited or deleted Also the GPIB Instrument Setup dialog box is brought up to edit instruments and the Menu Tasks dialog box is brought up to edit the menu Figure 3 4 GPIB Tasks Dialog Box The opt
42. of the following steps occurs once for each row in the spreadsheet range 3 If the corresponding checkbox is checked Measure triggers the instrument 4 If the corresponding checkbox is checked Measure waits for the instrument to assert SRQ to request service before continuing 5 If a command string is given Measure sends it to the instrument 6 Measure reads data from the instrument If fields are defined the data is parsed into fields If an end of line string is defined Measure continues to step 7 when the end of line string is encountered If no end of line string is defined Measure continues to step 7 when all the defined fields are read Notice that delimiting characters take precedence over end of line strings If no end of line string is defined and no fields are defined but you have specified a range to store the results Measure waits for a Carriage Return 13 Line Feed 10 or the EOI signal from the device EOI When any of these standard termination characters are encountered Measure puts all data before the termination characters in the specified worksheet cell and throws away the termination characters 7 The received data is stored in the current row of the given range If fields are defined the data is stored in columns that correspond to the fields If no fields are defined all received data is put in the first column of the current row If no range is given any data received is thrown away 8 If a
43. om an Excel worksheet to an instrument V Visual Basic for The programming language built into Microsoft Applications VBA Excel National Instruments Corporation I 1 Measure GPIB User Manual A adding GPIB Add In manually 1 1 to 1 2 adding tasks to GPIB menu 2 12 Advanced Instrument Setup dialog box 3 4 to 3 5 Assert EOI at the end of each command 3 5 Assert EOI when Measure sends EOS 3 5 Compare 7 bits of EOS rather than 8 3 5 End Of String Character 3 5 GPIB Driver Timeout 3 5 Advanced Setup option GPIB Instrument Setup dialog box 3 2 ASCII values entering 2 12 Assert EOI at the end of each command option 3 5 Assert EOI when Measure sends EOS option 3 5 B backslash character entering ASCII values 2 12 entering GPIB commands table 2 13 Board Index option 3 2 bulletin board support B 1 C Capture Task dialog box 3 7 to 3 9 Clear instrument 3 9 Command string 3 9 Define Fields 3 9 Delay 3 9 Description 3 8 Display status 3 8 End of line string 3 9 illustration 3 8 Response string 3 9 Result range 3 9 Task Name 3 8 Timeout 3 9 Trigger Instrument 3 9 Wait for SRQ 3 9 capture tasks creating instrument configure task 2 2 to 2 3 instrument read task 2 9 to 2 10 procedure for 2 4 to 2 5 fields 2 6 parsing by custom defined delimiters 2 6 parsing by default delimiter 2 7 parsing by width 2 6 to 2 7 purpose 2 4 CheckSRQ function 4 2 to 4 3 Clear instrument optio
44. on Transmission Task Dialog Box Use the Transmission Task dialog box shown in Figure 3 6 to edit capture tasks To reach this dialog box click on New Transmit from the Tasks dialog box or select a transmit task on the Tasks dialog and click on the Edit button Figure 3 6 Transmission Task Dialog Box The options available from the Transmission Task dialog box are shown in Table 3 6 Chapter 3 GPIB Task Reference National Instruments Corporation 3 11 Measure GPIB User Manual Table 3 6 Transmission Task Dialog Box Options Option Description Task Name The task name must be entered and no two tasks can have the same name Description The description appears in the Description field of the Tasks dialog box and if this task is added to the menu the description appears on the status bar when this task is selected This field can be left blank Display status If checked Measure displays the Status dialog box while the task is running Measure displays the current progress of a running task on the status bar regardless of the state of this checkbox Clear instrument Specifies that Measure should send a GPIB Clear command to the instrument before running the task Timeout Determines how long Measure waits for an instrument to send data Setting the timeout to zero causes Measure to wait indefinitely When Measure executes a task clicking on Q interrupts the task Repeat Count Determines how many times to run th
45. on settings Chapter 3 GPIB Task Reference National Instruments Corporation 3 3 Measure GPIB User Manual Instrument Test Dialog Box Use the Instrument Test dialog box to test communications between Measure and the instrument You can reach this dialog box shown in Figure 3 2 by clicking the Test button on the Instrument Setup dialog box Figure 3 2 Instrument Test Dialog Box Data typed in the Transmit edit box is sent to the instrument when you click on the Send Data button or press the Enter key while the cursor is in the Transmit edit box If you press the Enter key Measure sends the text in the Transmit edit box along with a carriage return linefeed string 13 10 After transmitting the data Measure waits for about 1 second then displays any data received from the instrument in the Receive edit box Occasionally the instrument takes more than 1 second to respond In that case press the Read Data button to query the instrument for data again Chapter 3 GPIB Task Reference Measure GPIB User Manual 3 4 National Instruments Corporation Table 3 2 Instrument Test Options provides a description of all the options available from the Instrument Test dialog box Table 3 2 Instrument Test Options Option Description Transmit edit box Type the text to send to the instrument in this edit box If the Enter key is pressed Measure sends the text in this edit box and a carriage return linefeed string 13 10
46. oving GPIB Add In manually 1 1 to 1 2 GPIB commands specifying with backslash table 2 13 GPIB Driver Timeout option 3 5 GPIB function 4 4 GPIB Instrument Setup dialog box Fluke 45 Multimeter example 2 3 GPIB task reference 3 1 to 3 2 Advanced Setup 3 2 Board Index 3 2 Delete 3 2 Find and Add Instruments 3 2 New 3 2 Primary Address 3 2 Secondary Address 3 2 Test 3 2 illustration 2 3 3 1 GPIB menu adding tasks 2 12 Instruments 2 2 Tasks 2 4 GPIB task reference Advanced Instrument Setup dialog box 3 4 to 3 5 Assert EOI at the end of each command 3 5 Assert EOI when Measure sends EOS 3 5 Compare 7 bits of EOS rather than 8 3 5 End Of String Character 3 5 GPIB Driver Timeout 3 5 Capture Task dialog box 3 7 to 3 9 Clear instrument 3 9 Command string 3 9 Define Fields 3 9 Delay 3 9 Description 3 8 Display status 3 8 End of line string 3 9 Response string 3 9 Result range 3 9 Task Name 3 8 Timeout 3 9 Trigger Instrument 3 9 Wait for SRQ 3 9 Define Fields dialog box 3 12 to 3 13 Default Delimiters 3 13 Field Delimiter 3 13 Field Width 3 13 Include 3 13 List Box 3 13 Number of Fields 3 13 Parsing Method Delimiters 3 13 Parsing Method Width 3 13 GPIB Instrument Setup dialog box 3 1 to 3 2 Advanced Setup 3 2 Board Index 3 2 Delete 3 2 Find and Add Instruments 3 2 Index Measure GPIB User Manual I 4 National Instruments Corporation New 3 2 Primary Addr
47. owing two Fluke 45 commands are used in this example 1 Computer transmits vdc The multimeter switches to Volts DC mode 2 Computer transmits val1 The multimeter returns its value at that instance as a string of the form 9 99999E9 10 The combination 10 represents the linefeed character ASCII 10 returned from the instrument Before you can create the tasks you need you must configure the instrument 1 Select GPIB Instruments to show the GPIB Instrument Setup dialog box shown in Figure 2 1 2 Click on the New button and type the name of the instrument Fluke 45 3 Select the Board Index Primary Address and Secondary Address where the Fluke 45 is located Now you have set up the Fluke 45 for communication with Measure Chapter 2 Getting Started with GPIB Tasks National Instruments Corporation 2 3 Measure GPIB User Manual Figure 2 1 GPIB Instrument Setup Dialog Box Example Test the Instrument Connection After setting up the instrument you can test that the instrument is connected and set up properly from the Instrument Setup dialog box 1 Press the Test button to display the Instrument Test dialog box shown in Figure 2 2 From this dialog box you can send commands to the instrument and view its response 2 In the Transmit field type val1 and press Enter 3 The Fluke 45 Multimeter should respond with the current voltage reading If no response appears from the instrument try clickin
48. peration EBUS 14 GPIB bus error EDVR 0 EDVR is returned when the board specified cannot be accessed This error occurs when you try to access a board or device that is not installed or configured properly Solutions Use the GPIB Configuration utility to ensure that each board you want to access is configured properly ECIC 1 ECIC is returned when the GPIB board specified by board index in the Instrument Setup dialog box is not the system controller Solutions Make sure the GPIB board you specify by board index in the Instrument Setup dialog box is the system controller Use the GPIB Configuration utility to ensure that the board you want to use to access the instrument is configured as system controller ENOL 2 ENOL usually occurs when a write operation is attempted with no Listeners addressed For a device write ENOL indicates that the GPIB address configured for that device in the software does not match the GPIB address of any device connected to the bus that the GPIB cable is not connected to the device or that the device is not powered on Appendix A Error Codes and Solutions National Instruments Corporation A 3 Measure GPIB User Manual ENOL can occur in situations where the GPIB board is not the CIC and the Controller asserts ATN before the write call in progress has ended Solutions Make sure that the GPIB address of your device matches the GPIB address of the device to
49. ptions available from the Capture Task dialog box are shown in Table 3 5 Table 3 5 Capture Task Dialog Box Options Option Description Task Name The task name must be entered and no two tasks can have the same name Description The description appears in the Description field of the Tasks dialog box and if this task is added to the menu the description appears on the status bar when this task is selected This field can be left blank Display status If checked Measure displays the Status dialog box while the task is running Measure always displays the current progress of a running task on the status bar regardless of the state of this checkbox Chapter 3 GPIB Task Reference National Instruments Corporation 3 9 Measure GPIB User Manual Clear instrument Specifies that Measure should send a GPIB Clear command to the instrument before running the task Timeout Determines how long Measure waits for an instrument to send data Setting the timeout to zero causes Measure to wait indefinitely When Measure executes a task clicking on Q interrupts that task Trigger Instrument Specifies that Measure should trigger the instrument before continuing the task Wait for SRQ Specifies that Measure should wait for the instrument to assert SRQ to request service before continuing the task Command string The command string is sent to the instrument This field can be left blank Refer to the section on communications strings
50. pture Task Reading Data from the Fluke 45 Example Run Your GPIB Tasks Two tasks are defined now Switch to Volts DC and Read To run the tasks from the Tasks dialog box complete the following steps 1 Highlight Switch to Volts DC and click on Run to run the task that tells the multimeter to measure volts DC 2 Highlight Read and click on Run to run the task that reads 10 values from the multimeter 3 When the Read task is finished Measure copies the data received into the range a1 a10 4 Click on OK to close the dialog box Chapter 2 Getting Started with GPIB Tasks National Instruments Corporation 2 11 Measure GPIB User Manual To run the tasks using VBA complete the following steps 1 Close the Tasks dialog box by clicking on OK 2 Select Macro from the Insert menu in Excel 3 Select Module from the popup menu that appears 4 Type the following code in the module Sub Sample Dim result As Integer result Application Run GPIB Switch to Volts DC result Application Run GPIB Read End Sub Your computer screen should appear as shown in Figure 2 5 Figure 2 5 VBA Code to Read Data From the Fluke 45 5 Select Tools Macro 6 Select Sample from the list box 7 Click on Run to execute the subroutine Chapter 2 Getting Started with GPIB Tasks Measure GPIB User Manual 2 12 National Instruments Corporation 8 Click on the tab at th
51. respective companies WARNING REGARDING MEDICAL AND CLINICAL USE OF NATIONAL INSTRUMENTS PRODUCTS National Instruments products are not designed with components and testing intended to ensure a level of reliability suitable for use in treatment and diagnosis of humans Applications of National Instruments products involving medical or clinical treatment can create a potential for accidental injury caused by product failure or by errors on the part of the user or application designer Any use or application of National Instruments products for or involving medical or clinical treatment must be performed by properly trained and qualified medical personnel and all traditional medical safeguards equipment and procedures that are appropriate in the particular situation to prevent serious injury or death should always continue to be used when National Instruments products are being used National Instruments products are NOT intended to be a substitute for any form of established process procedure or equipment used to monitor or safeguard human health and safety in medical or clinical treatment National Instruments Corporation v Measure GPIB User Manual About This Manual ix Organization of This Manual ix Conventions Used in This Manual
52. ruments will at its option repair or replace software media that do not execute programming instructions if National Instruments receives notice of such defects during the warranty period National Instruments does not warrant that the operation of the software shall be uninterrupted or error free A Return Material Authorization RMA number must be obtained from the factory and clearly marked on the outside of the package before any equipment will be accepted for warranty work National Instruments will pay the shipping costs of returning to the owner parts which are covered by warranty National Instruments believes that the information in this manual is accurate The document has been carefully reviewed for technical accuracy In the event that technical or typographical errors exist National Instruments reserves the right to make changes to subsequent editions of this document without prior notice to holders of this edition The reader should consult National Instruments if errors are suspected In no event shall National Instruments be liable for any damages arising out of or related to this document or the information contained in it EXCEPT AS SPECIFIED HEREIN NATIONAL INSTRUMENTS MAKES NO WARRANTIES EXPRESS OR IMPLIED AND SPECIFICALLY DISCLAIMS ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE CUSTOMER S RIGHT TO RECOVER DAMAGES CAUSED BY FAULT OR NEGLIGENCE ON THE PART OF NATIONAL INSTRUMENTS SHALL BE LIMITED TO THE AMOUNT TH
53. t any error messages The following steps will reproduce the problem Hardware and Software Configuration Form Record the settings and revisions of your hardware and software on the line to the right of each item Complete a new copy of this form each time you revise your software or hardware configuration and use this form as a reference for your current configuration Completing this form accurately before contacting National Instruments for technical support helps our applications engineers answer your questions more efficiently National Instruments Products GPIB Hardware Revision _________________________________________________________ Interrupt Level of Hardware _______________________________________________________ DMA Channels of Hardware ______________________________________________________ Base I O Address of Hardware _____________________________________________________ NI 488 Driver Version ___________________________________________________________ Other Products Computer Make and Model _______________________________________________________ Microprocessor _________________________________________________________________ Clock Frequency ________________________________________________________________ Type of Video Board Installed _____________________________________________________ Operating System _______________________________________________________________ Operating System Version __________________
54. technical support forms for you to complete These forms are in Appendix B Customer Communication at the end of this manual National Instruments Corporation 1 1 Measure GPIB User Manual Introduction This chapter describes the procedures for installing and uninstalling Measure for Windows and for adding and removing the GPIB Add In Installing Measure If you have already installed Measure for Windows and want to add the GPIB Add In skip below to the section Manually Adding or Removing the GPIB Add In Otherwise to install Measure for Windows insert the installation disk and run a setup exe from the taskbar in Windows 95 or from the Program Manager for other versions of Microsoft Windows Use the setup program to install the Data Acquisition Add In the Serial Add In the GPIB Add In or any combination of the three add ins The setup program stores all the necessary files in a directory you specify and installs Measure as an Excel add in Manually Adding or Removing the GPIB Add In To add the GPIB Add In manually complete the following steps 1 Start Excel and select Tools Add Ins which brings up the GPIB Add Ins dialog box shown in Figure 1 1 2 Click on the Browse button and select the path where the setup program installed Measure The default directory is measure 3 Enter GPIB xla in the File Name edit box and press Enter The item Measure GPIB Add In appears in the list box 4 Click on OK to
55. to the instrument Measure then waits approximately a second reads the GPIB bus and puts the results in the Receive edit box If the instrument takes longer than a second to respond you have to click on the Read Data button to read the data from the instrument Receive edit box When data is read from the instrument Measure places it here Typing in this edit box has no effect Send Data Click on this button to send the data in the Transmit edit box Measure sends the data waits approximately 1 second reads the instrument and puts the results in the Receive edit box Read Data Click on this button to force Measure to read any data available from the instrument The data is added to the data in the Receive edit box Data is only read from the instrument when this button is clicked or data is transmitted to the instrument either by clicking on the Send Data button or pressing the Enter key in the Transmit edit box Note The Receive edit box displays only the first 255 characters received Advanced Instrument Setup Dialog Box Use the Advanced Instrument Setup dialog box to configure advanced communications parameters for an instrument You can reach this dialog box shown in Figure 3 3 by clicking on the Advanced Setup button from the GPIB Instrument Setup dialog box Chapter 3 GPIB Task Reference National Instruments Corporation 3 5 Measure GPIB User Manual Figure 3 3 Advanced Instrument Setup Dialog Box The optio
56. urn line feed pair use the string 13 10 To specify the backslash character use For example the string 13 specifies a backslash and a carriage return while 13 specifies a backslash followed by a 1 and a 3 You can specify several important GPIB commands in a similar manner Table 2 1 GPIB Commands provides several GPIB commands and their descriptions Chapter 2 Getting Started with GPIB Tasks National Instruments Corporation 2 13 Measure GPIB User Manual Table 2 1 GBIB Commands Command Description TRIG Specifies that Measure should trigger the instrument when it encounters this string SRQ Specifies that Measure should wait until the instrument asserts SRQ requesting service CLR Specifies that Measure should send the GPIB clear command to the instrument LOCAL Specifies that Measure should put the instrument into local mode EOI Specifies that Measure should wait for EOI to be raised by the instrument or Measure should raise EOI on the character before the EOI when transmitting National Instruments Corporation 3 1 Measure GPIB User Manual GPIB Task Reference This chapter describes and outlines procedures for using every menu and dialog box available in the GPIB Add In GPIB Instrument Setup Dialog Box Use the GPIB Instrument Setup dialog box to configure the communication parameters of instruments that are used with Measure You can reach this dialog box by either selecting GPI
57. which you want to write data Check your cable connections and make sure at least two thirds of your devices are powered on EABO 6 EABO indicates that an I O operation has been canceled usually due to a timeout condition or receiving the Device Clear message from the CIC while performing an I O operation Frequently the I O is not progressing the Listener is not continuing to handshake or the Talker has stopped talking or the byte count in the call which timed out was more than the other device was expecting Solutions Increase the timeout period in the Advanced Settings dialog box Make sure that you have configured your device to send data before you request data ENEB 7 ENEB occurs when no GPIB board exists at the board index specified in the Instrument Setup dialog box This problem happens when the board is not physically plugged into the system the I O address specified during configuration does not match the actual board setting or there is a system conflict with the base I O address Solutions Make sure there is a GPIB board in your computer that is properly configured both in hardware and software using a valid base I O address Appendix A Error Codes and Solutions Measure GPIB User Manual A 4 National Instruments Corporation EDMA 8 EDMA occurs if a system DMA error is encountered when the NI 488 2M software attempts to transfer data over the GPIB using DMA Solutions
Download Pdf Manuals
Related Search