Home

NI-488.2 User Manual

1. Exit Figure 3 2 GPIB Explorer Linux National Instruments Corporation 3 3 NI 488 2 User Manual Chapter 3 GPIB Explorer Mac OS X and Linux Add a New GPIB Interface NI 488 2 User Manual To add a new GPIB interface to your system complete the following steps Non Plug and Play Interfaces For Example GPIB ENET 100 1 2 3 Start GPIB Explorer as described in the Starting GPIB Explorer section Click New Follow the prompts to add your GPIB interface to the system Plug and Play Interfaces For Example PCI GPIB 1 2 Close GPIB Explorer if it is running Physically add the interface into your system making sure to shut down the system if your interface is not hot swappable Refer to the GPIB Hardware Guide for more details on how to do this To view the document you need Acrobat Reader which you can download from www adobe com Mac OS X The GPIB Hardware Guide is installed with NI 488 2 To access this document double click Applications National Instruments NI 488 2 Documentation Linux The GPIB Hardware Guide is installed with NI 488 2 It is in the usr local natinst ni4882 docs directory Start GPIB Explorer as described in the Starting GPIB Explorer section You should see your interface in the list of configured interfaces 3 4 ni com Chapter 3 GPIB Explorer Mac OS X and Linux Delete a GPIB Interface To remove a GPIB interface from your system complete the fo
2. Make sure there is a GPIB interface in your computer that is properly configured both in hardware and software using a valid base I O address by running the NI 488 2 Troubleshooting Utility as follows Windows 1 Select Start Programs National Instruments Measurement amp Automation 2 Select Help Troubleshooting NI 488 2 Troubleshooting Utility Mac OS X Run Applications National Instruments NI 488 2 Troubleshoot Linux Enter the following command lt InstallDir gt natinst ni4882 bin gpibtsw where lt Instal11Dir gt is the directory where you chose to install the NI 488 2 software The default is usr local NI 488 2 User Manual EOIP occurs when an asynchronous I O operation has not finished before some other call is made During asynchronous I O you can only use ibstop ibnotify ibwait and ibon1 or perform other non GPIB operations If any other call is attempted EOIP is returned C 6 ni com Solutions ECAP 11 Appendix C Error Codes and Solutions Resynchronize the driver and the application before making any further NI 488 2 calls Resynchronization is accomplished by using one of the following functions ibnotify callback If the Ibsta value passed to the ibnotify callback contains CMPL the driver and application are resynchronized ibnotify If the returned Ibsta contains CMPL the driver and application are resynchronized ibwait If the returned Ibsta contains CMPL the drive
3. My Listen Address A GPIB command used to address a device to be a Listener It can be any one of the 31 primary addresses My Secondary Address The GPIB command used to address a device to be a Listener or a Talker when extended two byte addressing is used The complete address is a MLA or MTA address followed by an MSA address There are 31 secondary addresses for a total of 961 distinct listen or talk addresses for devices My Talk Address A GPIB command used to address a device to be a Talker It can be any one of the 31 primary addresses The concurrent processing of more than one program or task Not Data Accepted One of the three GPIB handshake lines See also handshake Not Ready For Data One of the three GPIB handshake lines See also handshake The process of polling all configured devices at once and reading a composite poll response See also serial poll Personal computer Peripheral Component Interconnect See programmed I O Parallel Poll Configure The GPIB command used to configure an addressed Listener to participate in polls Parallel Poll Disable The GPIB command used to disable a configured device from participating in polls There are 16 PPD commands Parallel Poll Enable The GPIB command used to enable a configured device to participate in polls and to assign a DIO response line There are 16 PPE commands G 6 ni com PPU programmed I O R resynchronize RQS SDC semapho
4. Run the NI 488 2 Troubleshooting Utility Windows 1 Select Start Programs National Instruments Measurement amp Automation 2 Select Help Troubleshooting NI 488 2 Troubleshooting Utility Mac OS X Run Applications National Instruments NI 488 2 Troubleshoot Linux Enter the following command lt InstallDir gt natinst ni4882 bin gpibtsw where lt InstallDir gt is the directory where you chose to install the NI 488 2 software The default is usr local What information should I have before I call National Instruments Before you call National Instruments record the results of the NI 488 2 Troubleshooting Utility How can I determine if my GPIB hardware and the NI 488 2 software are installed properly Run the NI 488 2 Troubleshooting Utility as described previously on this page The Troubleshooting Utility tests your GPIB interface and displays the results How many GPIB interfaces can I configure for use with the NI 488 2 software You can configure the NI 488 2 software to communicate with up to 100 GPIB interfaces D 2 ni com Windows Appendix D Common Questions How can I determine which version of the NI 488 2 software I have installed To view the NI 488 2 software version complete the following steps 1 Select Start Programs National Instruments Measurement amp Automation to start Measurement amp Automation Explorer 2 Expand the Software directory by clicking the n
5. symbol leads you through nested menu items and dialog box options to a final action The sequence File Page Setup Options directs you to pull down the File menu select the Page Setup item and select Options from the last dialog box This icon denotes a note which alerts you to important information Bold text denotes items that you must select or click in the software such as menu items and dialog box options Bold text also denotes parameter names IEEE 488 and IEEE 488 2 refer to the ANSI IEEE Standard 488 1 2003 and the ANSI TEEE Standard 488 2 1992 respectively which define the GPIB xii ni com italic monospace monospace bold monospace italic Platform About This Manual Italic text denotes variables emphasis a cross reference or an introduction to akey concept Italic text also denotes text that is a placeholder for a word or value that you must supply Text in this font denotes text or characters that you should enter 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 operations variables filenames and extensions Bold text in this font denotes the messages and responses that the computer automatically prints to the screen This font also emphasizes lines of code that are different from the other examples Italic text in this font d
6. OS Dees iestovidectesh tuetectesd eSesn td Tis sLens a a cena atone eevee e 3 2 MAU Ks es scass sche es wets E ae E E ties Nanas A eee aes 3 3 Adda New GPIB Interface vc sie errn uisud e ta evtverns Severna ects 3 4 Delete GPIB Interface n Sees R A E ONN 3 5 View NI 488 2 Software Versionsnr eeeeseeseceeeseceseesecesececeseeeceseceesesesseseaeenees 3 5 View or Change GPIB Interface Settings eee cece eeeeeeceeceeeseeeeseseeeeaeeseeeaeeaeens 3 6 Access Additional Help and Resources ceceeeeseeseesceseesseesecseeeaeessessecnesesesseseaeesees 3 8 NI 488 2 Help sic eaaa cc iain te canta E E E RE R 3 8 National Instruments GPIB Web Site oo cece eseeeeeneeeseeeeensetseeeseteees 3 8 View or Change GPIB ENET 100 Network Settings 00 0 eee ee eeeeeeeeeeeneeeeeeeeeees 3 8 D Vice Cone Surat oner renieu eui i e a ovtverns Meurer eevee 3 9 Update GPIB ENET 100 Firmware ce eccseseeeecseeseesesesseseeeeensenees 3 9 Chapter 4 Developing Your NI 488 2 Application Interactive Instrument Control 0 0 cece eee esseeeeeececeeseeesecseeeaeeseeseesseceeeeaeenseeasenseeaes 4 1 Choosing Your Programming Methodology cee ceceeeesceeeceeceseseeeeseseeeeseeseeeseeseees 4 2 Choosing a Method to Access the NI 488 2 Driver cece eeeereeteees 4 2 WiIndOWS cick evita nani eee ea ee 4 2 MacOS Xina teas dees Petes eee saci EE E teste EARE E 4 4 DAU Xs estestebe Beds tetas i Pee ele ees een eet dee EIS 4 5 Choosing How to Use the NI 488 2 API ooo ec ee
7. char response Addr4882_t AddressList 2 The following command clears the GPIB SendIFC 0 The value of sense is compared with the ist bit of the device and determines whether the data line is asserted PPollConfig 0 3 5 1 National Instruments Corporation 8 19 NI 488 2 User Manual Chapter 8 NI 488 2 Programming Techniques NI 488 2 User Manual Conduct the parallel poll using PPo11 store the response and check the response for a certain value In the following example because DIOS is asserted by the device if ist is 1 the program checks bit 4 hex 10 in the response to determine the value of ist PPoll 0 amp response If response has bit 4 hex 10 set the ist bit of the device at that time is equal to 1 If it does not appear the ist bit is equal to 0 Check the bit in the following statement if response amp 0x10 printf The ist equals 1 n else printf The ist equals 0 n Unconfigure the device for parallel polling using PPol1Unconfig as shown in the following example In this example the NOADDR constant must appear at the end of the array to signal the end of the address list If NOADDR is the only value in the array all devices receive the parallel poll disable message AddressList 0 3 AddressList 1 NOADDR PPollUnconfig 0 AddressList 8 20 ni com GPIB Basics The ANSI TEEE Standard 488 1 2003 also known as the General
8. is set in ibsta then print an error message that the call failed and exit the program ibwrt ud SEND DATA 9L if Ibsta amp ERR printf unable to write to device n return 0 set up the asynchronous event notification on RQS ibnotify ud RQS MyCallback NULL if Ibsta amp ERR printf ibnotify call failed n return 0 while ReadingsTaken lt 1000 amp amp DeviceError Your application does useful work here For example it might process the device readings or do any other useful work disable notification ibnotify ud 0 NULL NULL Call the ibonl function to disable the hardware and software ibonl ud 0 return 1 int __stdcall MyCallback int LocalUd unsigned long LocallIbsta unsigned long LocallIberr unsigned long LocalIbcnt void RefData char SpollByte National Instruments Corporation 8 7 NI 488 2 User Manual Chapter 8 NI 488 2 Programming Techniques char ReadBuffer 40 If the ERR bit is set in LocalIbsta then print an error message and return if LocalIbsta amp ERR printf GPIB error d has occurred No more callbacks n Localliberr DeviceError TRUE return 0 Read the serial poll byte from the device If the ERR bit is set in LocalIbsta then print an error message and return LocaliIbsta ibrsp LocalUd amp SpollByte if LocalIbsta amp ERR printf ibrsp failed No more callb
9. select Run as Administrator X My System Measurement amp Automation Explorer ss Eje x File Edit View Tools Help Configuration A Bshow Help E amp My System GJ Devices and Interfaces Software National Instruments i peas Measurement amp Automation Explorer a What is Measurement amp Automation Explorer Measurement amp Automation Explorer MAX provides access to your National Instruments products What do you want to do Manage my devices and interfaces Ma Manage virtual channels or tasks for my de create sc i Configure rr Import export my device configuration file e my installed National Instruments software for my virtual instruments IVI instrument drivers 3 Note Some categories are device specific For example the IVI category appears only if you have IVI installed a x Alen fn SE DAT PNE A REAL PREN EERE PA EY PST RAM PORTO WERE EOC POPE 2 Category Help Figure 2 1 Measurement amp Automation Explorer NI 488 2 User Manual 2 2 ni com Chapter 2 Measurement amp Automation Explorer Windows Troubleshoot NI 488 2 Problems To troubleshoot NI 488 2 problems run the NI 488 2 Troubleshooting Utility as follows 1 Start Measurement amp Automation Explorer as described in the Starting Measurement amp Automation Explorer section 2 Select Help Troubleshooting
10. time you make a device level call If the current CIC does not pass control the NI 488 2 driver returns the ECIC error code to your application If this happens you could send a device specific command requesting control for the GPIB interface Then use a board level ibwait command to wait for CIC National Instruments Corporation 8 11 NI 488 2 User Manual Chapter 8 NI 488 2 Programming Techniques Talker Listener Applications Serial Polling Although designed for Controller In Charge applications you can also use the NI 488 2 software in most non Controller situations These situations are known as Talker Listener applications because the interface is not the GPIB Controller A Talker Listener application typically uses ibwait with a mask of 0 to monitor the status of the interface Then based on the status bits set in Ibsta the application takes whatever action is appropriate For example the application could monitor the status bits TACS Talker Active State and LACS Listener Active State to determine when to send data to or receive data from the Controller The application could also monitor the DCAS Device Clear Active State and DTAS Device Trigger Active State bits to determine if the Controller has sent the device clear DCL or SDC or trigger GET messages to the interface If the application detects a device clear from the Controller it might reset the internal state of message buffers If it detects a trigg
11. 13 2000 dev brd END or EOS detected SRQI 12 1000 brd SRQ interrupt received RQS 11 800 dev Device requesting service National Instruments Corporation 4 7 NI 488 2 User Manual Chapter 4 Developing Your NI 488 2 Application Table 4 1 Status Word Layout Continued Bit Hex Mnemonic Pos Value Type Description CMPL 8 100 dev brd T O completed LOK 7 80 brd Lockout State REM 6 40 brd Remote State CIC 5 20 brd Controller In Charge ATN 4 10 brd Attention is asserted TACS 3 8 brd Talker LACS 2 4 brd Listener DTAS 1 2 brd Device Trigger State DCAS 0 1 brd Device Clear State The language header file defines each Ibsta status bit You can test for an Ibsta Status bit being set using the bitwise and operator amp in C C For example the Ibsta ERR bit is bit 15 of Ibsta To check for an NI 488 2 error use the following statement after each NI 488 2 call if Ibsta amp ERR printf NI 488 2 error encountered Error Function Iberr If the ERR bit is set in Ibsta an NI 488 2 error has occurred When an error occurs the error type is specified by Iberr To check for an NI 488 2 error use the following statement after each NI 488 2 call if Ibsta amp ERR printf NI 488 2 error d encountered Iberr 3 Note The value in Iberr is meaningful as an error only when the ERR bit is set in Ibsta indicating that an
12. 2 User Manual 7 8 ni com Chapter 7 Table 7 3 Syntax for Multi Device NI 488 2 Calls in Interactive Control Syntax Description AllSpoll addrlist DevClear address Serial poll multiple devices Clear a device DevClearList addrlist Clear multiple devices EnableLocal addrlist Enable local control EnableRemote addrlist Enable remote control FindLstn padlist limit Find all Listeners FindRQS addrlist Find device asserting SRQ PassControl address Pass control to a device PPoll Parallel poll devices PPollConfig address dataline lineSense Configure device for parallel poll PPollUnconfig addrlist Unconfigure device for parallel poll RcevRespMsg count termination Receive response message ReadStatusByte address Serial poll a device Receive address count termination Receive data from a device ReceiveSetup address Receive setup ResetSys addrlist Reset multiple devices Send address buffer eotmode Send data to a device Sendcmds buffer Send command bytes SendDataBytes buffer eotmode Send data bytes SendIFC Send interface clear SendList addrlist buffer eotmode Send data to multiple devices SendLLoO Put devices in local lockout SendSetup addrlist Send setup SetRWLS addrlist Put devices in remote with lockout state Tes
13. 5 3 termination method 5 3 NI 488 2 User Manual l 2 configuration errors 5 2 GPIB error codes table C 1 NI Spy utility 5 1 6 3 timing errors 5 2 using global status functions 5 1 deleting GPIB interface 3 5 DevClear function 7 9 DevClearList function 4 13 7 9 device level calls and bus management 8 11 diagnostic tools NI resources E 1 direct entry with C accessing gpib 32 dll exports 4 16 exporting pointers to global variables and function calls 4 15 documentation accessing NI 488 2 documentation xi accessing NI 488 2 Help xii conventions used in manual xii NI resources E 1 related documentation xiii DOS support enabling or disabling 2 12 drivers NI resources E 1 DTAS status word condition 4 8 B 1 B 5 dynamic link library 4 2 E EABO error code C 5 EADR error code C 4 EARG error code C 4 EARM error code C 9 EBUS error code C 8 ECAP error code C 7 ECIC error code C 3 EDVR error code C 2 EFSO error code C 7 EHDL error code C 10 ELCK error code C 9 END status word condition 4 7 B 1 B 2 ENEB error code C 6 ENOL error code C 3 ni com EOI end or identify line table A 4 EOIP error code C 6 EOS EOS comparison method 8 1 EOS read method 8 2 EOS write method 8 2 EPWR error code C 11 ERR status word condition 4 7 B 1 B 2 error codes debugging applications 5 1 error codes and solutions EABO C 5 EADR C 4 EARG C 4 EARM C 9 EBUS C 8 ECAP C 7 ECIC C 3
14. Before exiting your application you need to free gpib 32 d11 with the following command FreeLibrary Gpib32Lib For more examples of directly accessing gpib 32 d11 refer to the direct entry sample programs d11ldevquery c and d114882query c installed with the NI 488 2 software For more information about direct entry refer to the online help for your development environment Language Specific Programming Instructions for Mac OS X The following information describes how to develop compile and link your Mac OS X NI 488 2 applications Before you compile your application remember to include the following line at the beginning of your program include lt NI488 ni488 h gt To compile and link your application using the CodeWarrior or Project Builder environments include NI488 framework into your CodeWarrior or Project Builder project The framework is located at Library Frameworks To compile and link your application in a Terminal Shell type the following code on the command line cc cprog c framework NI488 Language Specific Programming Instructions for Linux The following information describes how to develop compile and link your Linux NI 488 2 applications Before you compile your application remember to include the following line at the beginning of your program include lt ni488 h gt Your application must link with the NI 488 2 dynamic library libgpibapi so There are two ways to load a dyn
15. EDVR C 2 EFSO C 7 EHDL C 10 ELCK C 9 ENEB C 6 ENOL C 3 EOIP C 6 EPWR C 11 ERST C 11 ESAC C 5 ESRQ C 8 ETAB C 9 EWIP C 10 GPIB error codes table C 1 error conditions communication errors repeat addressing 5 3 termination method 5 3 configuration errors 5 2 Interactive Control utility 7 11 timing errors 5 2 error function Iberr 4 8 error tracking with NI Spy 6 2 National Instruments Corporation l 3 Index error type reporting 4 8 ERST error code C 11 ESAC error code C 5 ESRQ error code C 8 ETAB error code C 9 Ethernet Device Configuration utility 2 13 3 9 Event Status bit ESB 8 13 EWIP error code C 10 examples NI resources E 1 execute function n times n function Interactive Control utility 7 10 execute indirect file function Interactive Control utility 7 10 execute previous function n times n function Interactive Control utility 7 10 exit or quit q function Interactive Control utility 7 10 F FindLstn function 4 12 FindRQS function finding first device requesting service 8 16 frequently asked questions D 1 functions See global functions G global functions debugging applications 5 1 error function Iberr 4 8 global variables status word Ibsta 4 7 writing multithreaded NI 488 2 applications 8 9 GPIB configuration controlling more than one interface 1 2 NI 488 2 User Manual Index linear and star system configu
16. Purpose Interface Bus GPIB describes a standard interface for communication between instruments and controllers from various vendors It contains information about electrical mechanical and functional specifications GPIB is a digital 8 bit parallel communications interface that supports both interlocked and noninterlocked handshaking The interlocked handshake also known as three wire handshake allows for data transfer rates of 1 Mbyte s and higher The noninterlocked handshake also known as HS488 allows for data transfer rates up to 8 Mbytes s The bus supports one System Controller usually a computer and up to 14 additional instruments The ANSI IEEE Standard 488 2 1992 extends IEEE 488 1 by defining a bus communication protocol a common set of data codes and formats and a generic set of common device commands Talkers Listeners and Controllers GPIB devices can be Talkers Listeners or Controllers A Talker sends out data messages Listeners receive data messages The Controller usually a computer manages the flow of information on the bus It defines the communication links and sends GPIB commands to devices Some devices are capable of playing more than one role A digital voltmeter for example can be a Talker and a Listener If your system has a National Instruments GPIB interface and software installed it can function as a Talker Listener and Controller Controller In Charge and System Controller You can
17. before the settings are xl EE GPIB Board Settings This section provides access to all GPIB board settings Some settings such as Hardv re Model and Serial Number are for information only and cannot be changed E ZA Figure 2 5 GPIB Interface Properties in Measurement amp Automation Explorer 4 Optional Change the settings for your interface and click Save to apply the settings Change GPIB Permissions NI 488 2 allows administrators to allow nonadministrators to make changes to GPIB settings This is controlled using the Measurement amp Automation Explorer menu item at Tools NI 488 2 Require Administrator Privileges This menu is enabled only if you run MAX as an administrator In either case a check next to the menu indicates that you can change GPIB settings only when you run MAX as an administrator NI 488 2 User Manual 2 10 ni com Chapter 2 Measurement amp Automation Explorer Windows To toggle between the different modes complete the following steps 1 Start MAX as an administrator as described in the Starting Measurement amp Automation Explorer section 3 Note You must choose to run as Adminstrator to run in administrator mode To do this right click on the Measurement amp Automation Explorer icon and select Run as Administrator 2 Select Tools NI 488 2 Require Administrator Privileges from the menu 3 Enable or disable the requirement in the NI 488 2 Settings dialog
18. both ASCII and Unicode versions of these functions The ASCII versions are named ibfindA ibrdfA and ibwrt fA The Unicode versions are named ibfindw ibrdfw and ibwrt fw You can use either the Unicode or ASCII versions of these functions with Windows In addition to pointers to the status variables and a handle to the loaded gpib 32 d11 you must define the direct entry prototypes for the functions you use in your application For the prototypes for each function exported by gpib 32 d11 refer to the NI 488 2 Help For instructions on accessing the online help refer to the Using the NI 488 2 Documentation section in About This Manual The direct entry sample programs illustrate how to use direct entry to access gpib 32 d11 For more information about direct entry refer to the online help for your development environment Directly Accessing the gpib 32 dll Exports Make sure that the following lines are included at the beginning of your C application ifdef _ cplusplus extern C endif include lt windows h gt include ni488 h ifdef _ cplusplus endif 4 16 ni com Chapter 4 Developing Your NI 488 2 Application In your Win32 application you need to load gpib 32 d11 before accessing the gpib 32 d11 exports The following code fragment shows you how to call the LoadLibrary function to load gpib 32 d11 and check for an error HINSTANCE Gpib32Lib NULL Gpib32Lib LoadLibrary GPIB 32 DLL if Gpib32Lib N
19. choosing how to use 4 5 dynamic link library 4 2 ni com NI 488 2 calls examples in Interactive Control utility 7 2 Interactive Control utility syntax board level calls table 7 7 device level calls table 7 6 multi device calls table 7 9 parallel polling multi device calls 8 19 SRQ and serial polling 8 15 NI 488 2 Communicator 2 6 sample screen figure 2 7 NI 488 2 programming techniques Borland C C 4 14 direct entry with C 4 15 Linux 4 19 Mac OS X 4 19 Microsoft Visual C C 4 14 Visual Basic 4 15 NI 488 2 Troubleshooting Utility 2 3 example figure 2 3 NRFD not ready for data line table A 3 0 online help accessing 2 13 3 8 Linux xii Mac OS X xii Windows xii NI Spy online help 2 9 6 2 NI 488 2 Help 2 13 3 8 P parallel polling implementing 8 17 using NI 488 2 calls multi device 8 19 traditional 8 18 PPoll routine 8 20 National Instruments Corporation l 7 Index PPollConfig routine 8 19 PPollUnconfig routine 8 20 primary GPIB address A 2 programming examples NI resources E 1 programming methodology choosing 4 2 programming models requirements for applications using multiple interfaces 4 11 requirements for multiple device applications 4 11 requirements for single device applications 4 9 Q q exit or quit function Interactive Control utility 7 10 R ReadStatusByte routine 8 15 Receive function 4 13 recording calls in NI Spy 6 3 re
20. communicating with the GPIB device until you are finished Cleanup Step 4 Place the Device Offline before Exiting Your Application Use ibon1 to put the device handle offline before you exit the application Applications That Use Multiple Interfaces or Communicate with Multiple GPIB Devices This section describes items you should include in your application and provides general program steps with an NI 488 2 example Items to Include Include the following items in your application e Header files In a C application include the header file ni4882 h which contains prototypes for the NI 488 2 calls and constants that you can use in your application e Error checking Check for errors after each NI 488 2 call e Error handling Declare and define a function to handle NI 488 2 errors This function takes the device offline and closes the application If the function is declared as void gpiberr char msg function prototype National Instruments Corporation 4 11 NI 488 2 User Manual Chapter 4 Developing Your NI 488 2 Application NI 488 2 User Manual then your application invokes it as follows if Ibsta amp ERR gpiberr NI 488 2 error General Program Steps and Examples The following steps show you how to use the multi device NI 488 2 calls in your application The NI 488 2 software includes the 4882query source code examples to demonstrate these principles Initialization Step 1 B
21. error has occurred For more information about error codes and solutions refer to Chapter 5 Debugging Your Application or Appendix C Error Codes and Solutions NI 488 2 User Manual 4 8 ni com Chapter 4 Developing Your NI 488 2 Application Count Function Ibent The count function is updated after each read write or command function In addition Ibcnt is updated after specific 488 2 style functions in certain error cases Refer to the NI 488 2 Help function reference for an explanation of how each function uses the count function Ibcnt is defined to be the type unsigned long If you are reading data the count variables indicate the number of bytes read If you are sending data or commands the count variables reflect the number of bytes sent Using Interactive Control to Communicate with Devices Before you begin writing your application you might want to use the Interactive Control utility to communicate with your instruments interactively by typing in commands from the keyboard rather than from an application You can use the Interactive Control utility to learn to communicate with your instruments using the NI 488 2 API For specific device communication instructions refer to the user manual that came with your instrument For information about using the Interactive Control utility and detailed examples refer to Chapter 7 Interactive Control Utility Programming Models Applications That Communicate wi
22. functions that perform rudimentary GPIB functions If you use these functions you need to understand GPIB management details such as how to address talkers and listeners Refer to Appendix A GPIB Basics for some details on GPIB management National Instruments Corporation 4 5 NI 488 2 User Manual Chapter 4 Developing Your NI 488 2 Application The set of low level functions are called board level functions They access the interface directly and require you to handle the addressing and bus management protocol These functions give you the flexibility and control to handle situations such as the following e Communicating with non compliant non IEEE 488 2 devices e Altering various low level interface configurations e Managing the bus in non typical ways Board level functions that an NI 488 2 application might use include the following ibcmd ibrd ibwrt and ibconfig For a detailed list refer to the NI 488 2 Help For instructions on accessing the online help refer to the Using the NI 488 2 Documentation section in About This Manual Using Multiple Interfaces and or Multiple Devices When your system includes an interface that must access multiple devices use the multi device NI 488 2 calls which can perform the following tasks with a single call e Find the Listeners on the bus using FindLstn e Find a device requesting service using FindRQS e Determine the state of the SRQ line or wait for SRQ to be asserted usi
23. given unit descriptor only one thread calls ibwait at a time using that descriptor C 10 ni com Appendix C Error Codes and Solutions ERST 27 ERST results when an event notification was cancelled due to a reset of the interface An ibwait call pending in the driver returns ERST in the following situations e Another thread in the same process calls ibon1 using the same unit descriptor as ibwait e Another thread or another process issues a board level ibon1 1 An ibnotify Callback may be invoked with ERST in the following situations e Another process issues a board level ibon1 1 Solutions Do not call ibon1 with ibwait calls still pending in the driver Prevent other applications from calling ibon1 by locking the interface with iblck EPWR 28 EPWR results when an interface loses power This often results when the system goes to and returns from a standby state Solutions Take all handles offline and reinitialize the application Quit the application and restart Disable standby and hibernate modes on the PC National Instruments Corporation C 11 NI 488 2 User Manual Common Questions This appendix answers some common questions about the NI 488 2 software General GPIB Questions How many devices can I configure for use with the NI 488 2 software You can configure the NI 488 2 software to use up to 1 024 logical devices The maximum number of physical devices you should connect to a s
24. it immediately updates ibsta and returns If you want to use ibwait to wait for one or more events to occur pass a wait mask to the function The wait mask should always include the TIMO event otherwise your application is suspended indefinitely until one of the wait mask events occurs Asynchronous Event Notification in NI 488 2 Applications NI 488 2 applications can asynchronously receive event notifications using the ibnotify function This function is useful if you want your application to be notified asynchronously about the occurrence of one or more GPIB events For example you might choose to use ibnoti fy if your application only needs to interact with your GPIB device when it is requesting service After calling ibnotify your application does not need to check the status of your GPIB device Then when your GPIB device requests service the NI 488 2 driver automatically notifies your application that the event has occurred by invoking a callback function The callback function is registered with the NI 488 2 driver when the ibnotify call is made Calling the ibnotify Function NI 488 2 User Manual ibnotify has the following function prototype unsigned long ibnotify int ud unit descriptor int mask bit mask of GPIB events GpibNotifyCallback_t Callback callback function void RefData user defined reference data 8 4 ni com Chapter 8 NI 488 2 Programming Techniques Both board level and device leve
25. of floats Note The following example is written using the GpibNotifyCallback_t definition for Windows Refer to the gpib header file ni4882 h for the proper definition of the Callback thread for your platform Other than a possible minor change in the definition of the Callback thread this example will work on all platforms include lt stdio h gt include ni4882 h int __stdcall MyCallback int LocalUd unsigned long LocalIbsta unsigned long Localliberr unsigned long LocalIbcnt void RefData int ReadingsTaken 0 float Readings 1000 BOOL DeviceError FALSE char expectedResponse 0x43 int main int ud ud Assign a unique identifier to the device and store it in the variable ud ibdev opens an available device and assigns it to access GPIBO with a primary address of 1 a secondary address of 0 a timeout of 10 seconds the END message enabled and the EOS mode disabled If ud is less than zero then print an error message that the call failed and exit the program ibdev 0 connect board Ly primary address of GPIB device 0z secondary address of GPIB device T10s 10 second I O timeout NI 488 2 User Manual 8 6 ni com Chapter 8 NI 488 2 Programming Techniques 1 EOT mode turned on 0 EOS mode disabled if ud lt 0 printf ibdev failed n return 0 Issue a request to the device to send the data If the ERR bit
26. the EnableLocal or ibloc call is inoperative for that interface LOK is set whenever the GPIB interface detects that the Local Lockout LLO message has been sent either by the GPIB interface or by another Controller LOK is cleared when the System Controller unasserts the Remote Enable REN GPIB line National Instruments Corporation B 3 NI 488 2 User Manual Appendix B Status Word Conditions REM brd CIC brd REM indicates whether the interface is in the remote state REM is set whenever the Remote Enable REN GPIB line is asserted and the GPIB interface detects that its listen address has been sent either by the GPIB interface or by another Controller REM is cleared in the following situations e When REN becomes unasserted e When the GPIB interface as a Listener detects that the Go to Local GTL command has been sent either by the GPIB interface or by another Controller e When the ibloc function is called while the LOK bit is cleared in the status word ATN brd CIC indicates whether the GPIB interface is the Controller In Charge CIC is set when the SendIFC or ibsic call is executed either while the GPIB interface is System Controller or when another Controller passes control to the GPIB interface CIC is cleared either when the GPIB interface detects Interface Clear IFC from the System Controller or when the GPIB interface passes control to another device TACS brd ATN indicates the state of th
27. the status word Ibsta before attempting these calls If it does not appear you can perform an ibwait for CIC call to delay further processing until control is passed to the interface 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 ENOL can occur in situations where the GPIB interface is not the CIC and the Controller asserts ATN before the write call in progress has ended National Instruments Corporation C 3 NI 488 2 User Manual Appendix C Error Codes and Solutions Solutions EADR 3 Possible solutions for this error are as follows e Make sure that the GPIB address of your device matches the GPIB address of the device to which you want to write data e Use the appropriate hex code in ibcmd to address your device e Check your cable connections and make sure at least two thirds of your devices are powered on e Call ibconfig with the IbcPAD or IbcSAD if necessary options to match the configured address to the device switch settings Solutions EARG 4 EADR occurs when the GPIB interface is CIC and is not properly addressing itself before read and write functions This error is usually associated with boa
28. these documents online insert your NI 488 2 software distribution CD and select the View Documentation option The View Documentation utility helps you find the documentation that you want to view You can also view these documents at ni com To view these documents online insert your NI 488 2 software distribution CD and open the Documentation folder You can also view these documents at ni com To view these documents online insert your NI 488 2 software distribution CD and browse to the Documentation directory You can also view these documents at ni com National Instruments Corporation xi NI 488 2 User Manual About This Manual Accessing the NI 488 2 Help Conventions The NI 488 2 Help addresses questions you might have about NI 488 2 and includes a function reference and troubleshooting information Windows Select Start Programs National Instruments Measurement amp Automation Select Help Help Topics NI 488 2 Mac OS X Select Applications National Instruments NI 488 2 Explore GPIB Select Help Help Topics NI 488 2 Linux Run GPIB Explorer by entering the following command lt InstallDir gt natinst ni4882 bin gpibexplorer lt InstallDir gt is the directory where you chose to install the NI 488 2 software The default is usr local Select Help Help Topics NI 488 2 3 bold TEEE 488 and TEEE 488 2 NI 488 2 User Manual The following conventions appear in this manual The
29. to the folder 3 Select your GPIB interface and click NI Spy in the toolbar Mac OS X and Linux To start NI Spy complete the following steps 1 Start GPIB Explorer as described in Chapter 3 GPIB Explorer Mac OS X and Linux 2 From the menu bar select Tools NI Spy National Instruments Corporation 6 1 NI 488 2 User Manual Chapter 6 NI Spy Utility Monitoring API Calls with NI Spy To display NI 488 2 API calls as they are made do the following 1 On the NI Spy toolbar click the blue arrow button to start a capture 2 Start the NI 488 2 application you want to monitor NI Spy records and displays all NI 488 2 calls as shown in Figure 6 1 NI Spy capture on E x File Edit Yiew Spy Help Ea ey me x 2 ibdev 0 0x0100 0 TT 0x0100 0x0004 08 50 08 749 ibwrt UDO IDN 5 0x5 0x0100 0x0005 08 50 14 157 ibrd UDO National Inst 100 0x64 0x2100 0x003E 08 50 16 720 ibwrt UDO conf dc max 11 0xB 0x0100 0x0008 08 50 34 396 ibwrt UDO meas dc 8 0x8 0x0100 0x0008 08 50 46 894 ibrd UDO 5 7319 100 0x64 0x2100 Ox0007 08 50 49 908 iF Captured F Displayed 7 Figure 6 1 NI 488 2 Calls Recorded by NI Spy Shown on Windows Using the NI Spy Online Help To view the built in context sensitive online help for the NI Spy utility select Help Help Topics in NI Spy You can also view the online help by clicking on the question mark button on the NI Spy t
30. 2 Measurement amp Automation Explorer Windows Access Additional Help and Resources To access additional help and resources for the NI 488 2 software and your GPIB hardware refer to the following sections NI 488 2 Help The NI 488 2 Help addresses questions you might have about NI 488 2 and includes a function reference and troubleshooting information You can access the NI 488 2 Help as follows 1 Start Measurement amp Automation Explorer as described in the Starting Measurement amp Automation Explorer section 2 Select Help Help Topics NI 488 2 National Instruments GPIB Web Site You can access the National Instruments GPIB Web site as follows 1 Start Measurement amp Automation Explorer as described in the Starting Measurement amp Automation Explorer section 2 Select Help National Instruments on the Web GPIB Home Page View or Change GPIB ENET 100 Network Settings To view or change the network settings of your GPIB ENET 100 refer to the following sections For more information about your GPIB ENET 100 network settings refer to the GPIB ENET 100 information in the GPIB Hardware Guide Device Configuration Use the NI Ethernet Device Configuration utility if you need to manually configure the network parameters of the GPIB ENET 100 If your network uses DHCP the network configuration is performed automatically at startup and you do not need to run this utility unless you want to change the hos
31. 2 User Manual 7 6 ni com Chapter 7 Interactive Control Utility Table 7 1 Syntax for Device Level Traditional NI 488 2 Calls in Interactive Control Continued Syntax Description ibwait mask Wait for selected event where mask is a hex or decimal integer or a list of mask bit mnemonics such as ibwait TIMO CMPL ibwrt wrtbuf Write data ibwrta wrtbuf ibwrtf flname Write data asynchronously Write data from a file where 1name is pathname of file to write Table 7 2 Syntax for Board Level Traditional NI 488 2 Calls in Interactive Control Syntax Description ibask option Return configuration information where option is a mnemonic for a configuration parameter ibcac v Become active Controller ibemd cmdbuf Send commands ibcmda cmdbuf Send commands asynchronously ibconfig option Alter configurable parameters where option is mnemonic for value a configuration parameter ibdma v Enable disable DMA ibeos v Change disable EOS message ibeot v Enable disable END message ibfind udname Return unit descriptor where udname is the symbolic name of interface for example gpib0 ibgts v Go from Active Controller to standby ibist v Set clear ist iblck v Acquire or release an exclusive interface lock for the current process LockWaitTime iblines Read the state of all GPIB control lines ibln pad s
32. 21 ETAB occurs only during the FindLstn and FindRQS functions ETAB indicates that there was some problem with a table used by these functions e In the case of FindLstn ETAB means that the given table did not have enough room to hold all the addresses of the Listeners found e Inthe case of FindRQS ETAB means that none of the devices in the given table were requesting service In the case of FindLstn increase the size of result arrays In the case of FindRQs check to see if other devices not used by your application are asserting SRQ Disconnect them from the GPIB if necessary Solutions EARM 22 ELCK indicates that the requested operation could not be performed because of an existing lock by another process accessing the same interface ELCK is also returned when a process attempts to unlock an interface for which it currently has no lock Call iblck to lock the interface If iblck continues to return ELCK lengthen the LockWaitTime and wait for the other process to relinquish its interface lock Ensure that you have successfully locked the interface prior to unlocking it EARM indicates that ibnotify s asynchronous event notification mechanism failed to rearm itself This generally occurs when an ibnotify Callback has attempted to rearm itself by returning an illegal value or when a fatal driver error EDVR has occurred National Instruments Corporation C 9 NI 488 2 User Manual Appendix C Error Codes and So
33. 4 7 B 1 TACS B 4 TIMO B 2 stuck SRQ state 8 14 support technical E 1 syntax in Interactive Control utility 7 4 System Controller A 1 T TACS status word condition 4 8 B 1 B 4 talk address A 2 Talker Listener applications 8 12 Talkers A 1 technical support E 1 terminating data transfers 8 1 termination methods errors caused by 5 3 TestSRQ routine 8 16 ThreadIbcnt function 8 10 ThreadIberr function 8 10 ThreadIbsta function 8 10 timing errors 5 2 TIMO status word condition 4 7 B 1 B 2 training and certification NI resources E 1 troubleshooting example Troubleshooting Utility results figure 2 3 NI resources E 1 under Measurement amp Automation Explorer 2 3 using NI 488 2 Troubleshooting Utility 2 3 turn OFF display function Interactive Control utility 7 10 turn ON display function Interactive Control utility 7 10 V Visual Basic programming instructions 4 15 ni com Index W waiting for GPIB conditions ibwait 8 4 WaitSRQ routine 8 16 Web resources E 1 National Instruments Corporation 1 9 NI 488 2 User Manual
34. E 488 2 Devices The IEEE 488 2 standard refined the bit assignments in the status byte In addition to setting bit 6 when requesting service IEEE 488 2 devices also use two other bits to specify their status Bit 4 the Message Available bit MAV is set when the device is ready to send previously queried data Bit 5 the Event Status bit ESB is set if one or more of the enabled IEEE 488 2 events occurs These events include power on user request command error execution error device dependent error query error request control and operation complete The device can assert SRQ when ESB or MAV are set or when a manufacturer defined condition occurs Automatic Serial Polling If you want your application to conduct a serial poll automatically when the SRQ line is asserted you can enable automatic serial polling The autopolling procedure occurs as follows 1 To enable autopolling use the board level configuration function ibconfig with option IbcAUTOPOLL or the GPIB Configuration utility Autopolling is enabled by default 2 When the SRQ line is asserted the driver automatically serial polls the open devices 3 Each positive serial poll response bit 6 or hex 40 is set is stored in a queue associated with the device that requested service The RQS bit of the device status word Ibsta is set National Instruments Corporation 8 13 NI 488 2 User Manual Chapter 8 NI 488 2 Programming Techniques 4 The polling cont
35. E i 6 2 Locating Errors with NUS pyiiti ec tndetat ones EE aie on ee Baie 6 2 Debugging Existing Applications occ eccseeseeseceecesecseeeseeseeesecseeeaeeeesaeeasenseeaeenes 6 3 Viewing Properties for Recorded Calls oe eeeeseeseeeseeseceseeeeesecaecesecseeeeseeesseeaees 6 3 Exiting NIS py cite eet iS Aaa Re te at ee Reb Re ee a 6 3 Performance Considerations sssccc ciecusesstecesennderwsecaeuedesee at ees E E KEER 6 3 National Instruments Corporation vij NI 488 2 User Manual Contents Chapter 7 Interactive Control Utility OCT VIEW 8 anonn na n E E A haagiaa ethan tis ta bavnenta evagaatunints enoesaaces 7 1 Getting Started with Interactive Control ei eeeecceeeeeseceeeeseeeeesecesesseesaeeseeeseeneens 7 1 Interactive Control Syntax einn eevee eh ee See jee dees ee 7 4 N mber SyntaK aeeoa E EAE AE EE E E a en 7 4 String S VOL Kaen anna a a ae Robes vate ied Pa es Seen de 7 5 Address Syntax tevtecst ie vcacs ses iine ies sea EA EA E AE 7 5 Interactive Control Commands seri nosenie eenen inae E aean 7 5 SIII RA WOE EA ENSE RTTA O PN DEE OE EE EA N R AE T 7 11 Error Informati n ar E T EEA E T E ES 7 11 Co nt D Orma OM vies itne Tea KE EAE tes ces A EOT E A EER E 7 12 Chapter 8 NI 488 2 Programming Techniques Termination of Data Transfers 0 0 0 eee eeeecseseeeeeseceeeeseeseeeseceeeeaeeseeeaeeseeeaesaeeeaeeaeenas 8 1 High Speed Data Transfers HS488 0 cece eee ceeceseeseeeseseeeesecseesaeeseceeeeaeensesseenseeaes 8 2
36. EM ig Configure EOS Show Sample Exit Figure 2 3 NI 488 2 Communicator Type a command in the Send String field and do one of the following e To write a command to the instrument then read a response back click the Query button To write a command to the instrument click the Write button e To read a response from the instrument click the Read button To view sample C C code that performs a simple query of a GPIB instrument click the Show Sample button Advanced Communication For advanced interactive communication with GPIB instruments use the Interactive Control utility as follows 1 National Instruments Corporation Start Measurement amp Automation Explorer as described in the Starting Measurement amp Automation Explorer section Expand the Devices and Interfaces directory by clicking the next to the folder Right click on your GPIB interface and select Interactive Control from the drop down menu that appears Interactive Control automatically opens a session to the selected GPIB interface At the command prompt type NI 488 2 API calls to communicate interactively with the your instrument For example you might use ibdev ibclr ibwrt ibrd and ibonl 2 7 NI 488 2 User Manual Chapter 2 Measurement amp Automation Explorer Windows To view the online help for Interactive Control type he1p at the Interactive Control command prompt For more information on us
37. ER SYSTEM IS CUSTOMIZED AND DIFFERS FROM NATIONAL INSTRUMENTS TESTING PLATFORMS AND BECAUSE A USER OR APPLICATION DESIGNER MAY USE NATIONAL INSTRUMENTS PRODUCTS IN COMBINATION WITH OTHER PRODUCTS IN A MANNER NOT EVALUATED OR CONTEMPLATED BY NATIONAL INSTRUMENTS THE USER OR APPLICATION DESIGNER IS ULTIMATELY RESPONSIBLE FOR VERIFYING AND VALIDATING THE SUITABILITY OF NATIONAL INSTRUMENTS PRODUCTS WHENEVER NATIONAL INSTRUMENTS PRODUCTS ARE INCORPORATED IN A SYSTEM OR APPLICATION INCLUDING WITHOUT LIMITATION THE APPROPRIATE DESIGN PROCESS AND SAFETY LEVEL OF SUCH SYSTEM OR APPLICATION Contents About This Manual Using the NI 488 2 Documentation eee eeeeeeeseeeetseeeeeeees Accessing the NI 488 2 Help 0 0 eceesecceseceseeseeseeeseeeeees CONVENTIONS 4c atieirat aeea ie E bBo E S R eter bene as Related Documentation eee eescessceeseceseeceseceeeesneeeaeeeseeseneeeaeersas Chapter 1 Introduction Setting Up and Configuring Your System eect eeeees Controlling More Than One Interface eee eee Configuration Requirement 00 00 eee eeeseeeeeeseeseeeseeeees Chapter 2 Measurement amp Automation Explorer Windows OVERVIEW e aa tend E ERA de Biel deena Starting Measurement amp Automation Explorer eee Troubleshoot NI 488 2 Problems cceeseesccsreeeneeeeeeeeaeeeseeeneeeeaes Add a New GPIB Interface nre e R E EERE Remove a GPIB Interface nnii a e e si ei Scan for GPIB Instruments 0 ce ceeeesceeseeeeecene
38. Enabling HS488 iii 24 8 aabch ta Meek ihn eat ea ey 8 2 System Configuration Effects on HS488 ooo eee eee sseceeeseeeeeeeeeseeseees 8 3 Waiting for GPIB Conditions eee on n a E ES e aS 8 4 Asynchronous Event Notification in NI 488 2 Applications sssseesseseseeeseerereereeese 8 4 Calling the ibnotify Function eee ee eeeesecseeeeceseeseseeeeseseaeeaeeseeeeeeees 8 4 ibnotify Programming Example cece ee eeseeseeeeeneceeeeeeesecseceseeseeeaeeaees 8 6 Writing Multithreaded NI 488 2 Applications 0 sees eeceseeseeecseceseenseeseeneeeseeeaes 8 9 Device Level Calls and Bus Management 00 eee eee eeeeseceeeeseeseeeseeseeesecseeesesseeeaes 8 11 Talker Listener Applications 0 0 eee e A E a 8 12 Serial Pollin nterni irai Eee KRR AE eben pden su E Na 8 12 Service Requests from IEEE 488 Devices sssessesesseesseersersrsrsresrsresrssrsresrs 8 13 Service Requests from IEEE 488 2 Devices 0 eee eeseeeeeeeeeeeeeeeseeeeeeeees 8 13 Automatic Serial Polling saros eines eanna a as 8 13 stuck SRO State oen r Ea A ERA 8 14 Autopolling and Interrupts eseseesseeesseeessesrsersrsersresreersesrsresrrsrseese 8 14 SRQ and Serial Polling with Device Level Traditional NI 488 2 Calls 8 15 SRQ and Serial Polling with Multi Device NI 488 2 Calls eee 8 15 Example 1 Using FindRQS o oo ecceceseeseeeeeteeeeseeseeeseeseeeseeseens 8 16 Example 2 Using AlSpoll oo eee eeceeecreeneeeneeeeeeseeseeeaeeseee 8 17 Parallel P
39. GPIB If it is disabled the EOI line is not asserted with the last byte of a write You can use the ibconfig IbcEOS function to enable disable or configure the EOS modes EOS mode configuration includes the following information e A 7 bit or 8 bit EOS byte e EOS comparison method This indicates whether the EOS byte has seven or eight significant bits For a 7 bit EOS byte the eighth bit of the EOS byte is ignored e EOS write method TIf this is enabled the GPIB EOI line is automatically asserted when the EOS byte is written to the GPIB If the buffer passed into an ibwrt call contains five occurrences of the EOS byte the EOI line is asserted as each of the five EOS bytes are written to the GPIB If an ibwrt buffer does not contain an occurrence of the EOS byte the EOI line is not asserted unless the EOT mode is National Instruments Corporation 8 1 NI 488 2 User Manual Chapter 8 NI 488 2 Programming Techniques enabled in which case the EOI line is asserted with the last byte of the write e EOS read method TIf this is enabled ibrd ibrda and ibrdf calls are terminated when the EOS byte is detected on the GPIB when the GPIB EOI line is asserted or when the specified count is reached If the EOS read method is disabled ibrd ibrda and ibrdf calls terminate only when the GPIB EOI line is asserted or the specified count has been read You can use the ibconfig function to configure the software to indicate w
40. Give the GPIB interface System Controller capability by calling the Ibcsc option in ibconfig or by using Measurement amp Automation Explorer to configure that capability into the software Solutions EABO indicates that an I O operation has been canceled usually due to a timeout condition Other causes are calling ibstop 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 Possible solutions for this error are as follows e Use the correct byte count in input functions or have the Talker use the END message to signify the end of the transfer e Lengthen the timeout period for the I O operation using the IbcTMO option in ibconfig e Make sure that you have configured your device to send data before you request data National Instruments Corporation C 5 NI 488 2 User Manual Appendix C Error Codes and Solutions ENEB 7 Solutions EOIP 10 ENEB occurs when a GPIB interface is configured for use by the system but the driver cannot find the interface This problem happens when the interface is not physically plugged into the system the I O address specified during configuration does not match the actual interface setting or there is a system conflict with the base I O address
41. I 488 2 Calls in Interactive Control Syntax Description ibask option ibeclr Return configuration information where option is a mnemonic for a configuration parameter Clear specified device ibconfig option value Alter configurable parameters where option is mnemonic for a configuration parameter ibdev BdIndx pad sad tmo eot eos Open an unused device ibdev parameters are BdIndx pad sad tmo eot eos ibeos v Change disable EOS message ibeot v Enable disable END message ibfind devname Return unit descriptor where devname is the symbolic name of the device template to use for example dvm ibloc Go to local ibnotify mask Start an asynchronous wait for selected events where mask is a hex or decimal integer or a list of mask bit mnemonics for example ibnotify TIMO CMPL ibonl v Place device online or offline ibpad v Change primary address ibpct Pass control ibppc v Parallel poll configure ibrd count Read data where count is the bytes to read ibrda count Read data asynchronously where count is the bytes to read ibrdf flname Read data to file where 1name is pathname of file to read ibrpp Conduct a parallel poll ibrsp Return serial poll byte ibsad v Change secondary address ibstop Abort asynchronous operation ibtmo v Change disable time limit ibtrg Trigger selected device NI 488
42. NI 488 2 NI 488 2 User Manual August 2008 lt 7 NATIONAL ULAG IE INSTRUMENTS Worldwide Technical Support and Product Information ni com National Instruments Corporate Headquarters 11500 North Mopac Expressway Austin Texas 78759 3504 USA Tel 512 683 0100 Worldwide Offices Australia 1800 300 800 Austria 43 662 457990 0 Belgium 32 0 2 757 0020 Brazil 55 11 3262 3599 Canada 800 433 3488 China 86 21 5050 9800 Czech Republic 420 224 235 774 Denmark 45 45 76 26 00 Finland 358 0 9 725 72511 France 01 57 66 24 24 Germany 49 89 7413130 India 91 80 41190000 Israel 972 3 6393737 Italy 39 02 41309277 Japan 0120 527196 Korea 82 02 3451 3400 Lebanon 961 0 1 33 28 28 Malaysia 1800 887710 Mexico 01 800 010 0793 Netherlands 31 0 348 433 466 New Zealand 0800 553 322 Norway 47 0 66 90 76 60 Poland 48 22 3390150 Portugal 351 210 311 210 Russia 7 495 783 6851 Singapore 1800 226 5886 Slovenia 386 3 425 42 00 South Africa 27 0 11 805 8197 Spain 34 91 640 0085 Sweden 46 0 8 587 895 00 Switzerland 41 56 2005151 Taiwan 886 02 2377 2222 Thailand 662 278 6777 Turkey 90 212 279 3031 United Kingdom 44 0 1635 523545 For further support information see the Technical Support and Professional Services appendix To comment on National Instruments documentation refer to the National Instruments Web site at ni com info and enter the info code feedback 2002 2008 National Instruments Corporation All rights res
43. NI 488 2 Troubleshooting Utility The Troubleshooting Utility tests your GPIB interface and displays the results as shown in Figure 2 2 y NI 488 2 Troubleshooting Utility 5 xj Select tests to run by placing a checkmark in the leftmost column Details Software NI 488 2 Version 2 60 C GPIBO GPIB USB HS Serial number 011464C8 Pass Why isn t my GPIB hardware listed m Highlighted result details NI 488 2 is ready to use Tutorial Close Figure 2 2 NI 488 2 Troubleshooting Utility National Instruments Corporation 2 3 NI 488 2 User Manual Chapter 2 Measurement amp Automation Explorer Windows Add a New GPIB Interface For plug and play interfaces such as PCI or USB the system automatically detects and installs the hardware To add a new GPIB ENET 100 to your system complete the following steps 1 Start Measurement amp Automation Explorer as described in the Starting Measurement amp Automation Explorer section 2 Right click on the Devices and Interfaces folder and select Create New 3 Inthe Create New dialog window select the GPIB ENET 100 item and click Finish The Add GPIB ENET 100 Wizard appears 4 Follow the prompts in the Add GPIB ENET 100 Wizard to add your interface 5 Measurement amp Automation Explorer automatically updates the list of installed GPIB interfaces You also can select View Refresh to update the list Rem
44. RODUCTS ARE NOT DESIGNED WITH COMPONENTS AND TESTING FOR A LEVEL OF RELIABILITY SUITABLE FOR USE IN OR IN CONNECTION WITH SURGICAL IMPLANTS OR AS CRITICAL COMPONENTS IN ANY LIFE SUPPORT SYSTEMS WHOSE FAILURE TO PERFORM CAN REASONABLY BE EXPECTED TO CAUSE SIGNIFICANT INJURY TO A HUMAN 2 IN ANY APPLICATION INCLUDING THE ABOVE RELIABILITY OF OPERATION OF THE SOFTWARE PRODUCTS CAN BE IMPAIRED BY ADVERSE FACTORS INCLUDING BUT NOT LIMITED TO FLUCTUATIONS IN ELECTRICAL POWER SUPPLY COMPUTER HARDWARE MALFUNCTIONS COMPUTER OPERATING SYSTEM SOFTWARE FITNESS FITNESS OF COMPILERS AND DEVELOPMENT SOFTWARE USED TO DEVELOP AN APPLICATION INSTALLATION ERRORS SOFTWARE AND HARDWARE COMPATIBILITY PROBLEMS MALFUNCTIONS OR FAILURES OF ELECTRONIC MONITORING OR CONTROL DEVICES TRANSIENT FAILURES OF ELECTRONIC SYSTEMS HARDWARE AND OR SOFTWARE UNANTICIPATED USES OR MISUSES OR ERRORS ON THE PART OF THE USER OR APPLICATIONS DESIGNER ADVERSE FACTORS SUCH AS THESE ARE HEREAFTER COLLECTIVELY TERMED SYSTEM FAILURES ANY APPLICATION WHERE A SYSTEM FAILURE WOULD CREATE A RISK OF HARM TO PROPERTY OR PERSONS INCLUDING THE RISK OF BODILY INJURY AND DEATH SHOULD NOT BE RELIANT SOLELY UPON ONE FORM OF ELECTRONIC SYSTEM DUE TO THE RISK OF SYSTEM FAILURE TO AVOID DAMAGE INJURY OR DEATH THE USER OR APPLICATION DESIGNER MUST TAKE REASONABLY PRUDENT STEPS TO PROTECT AGAINST SYSTEM FAILURES INCLUDING BUT NOT LIMITED TO BACK UP OR SHUT DOWN MECHANISMS BECAUSE EACH END US
45. ULL return FALSE For the prototypes for each function refer to the NI 488 2 Help For instructions on accessing the online help refer to the Using the NI 488 2 Documentation section in About This Manual For functions that return an integer value like ibdev or ibwrt the pointer to the function needs to be cast as follows int _stdcall Pname where Pname is the name of the pointer to the function For functions that do not return a value like FindLstn or SendList the pointer to the function needs to be cast as follows void _stdcall Pname where Pname is the name of the pointer to the function They are followed by the function s list of parameters as described in the NI 488 2 Help For instructions on accessing the online help refer to the Using the NI 488 2 Documentation section in About This Manual Following is an example of how to cast the function pointer and how the parameter list is set up for ibdev and ibon1 functions int _stdcall Pibdev int ud int pad int sad int tmo int eot int eos int _stdcall Pibonl int ud int v Next your Win32 application needs to use Get ProcAddress to get the addresses of the global status variables and functions your application needs The following code fragment shows you how to get the addresses of the pointers to the status variables and any functions your application needs Pointers to NI 488 2 global status variables int Pibsta int Pi
46. You can perform the following GPIB related tasks in GPIB Explorer e Add or remove GPIB interfaces e Reconfigure GPIB interface settings e Launch the NI 488 2 Troubleshooting Wizard to troubleshoot GPIB and NI 488 2 problems e Launch NI Spy to monitor NI 488 2 calls to GPIB interfaces e Locate additional help resources for GPIB and NI 488 2 National Instruments Corporation 3 1 NI 488 2 User Manual Chapter 3 GPIB Explorer Mac OS X and Linux Starting GPIB Explorer Mac OS X To start GPIB Explorer from the Finder double click on Applications National Instruments NI 488 2 Explore GPIB Figure 3 1 shows GPIB Explorer in Mac OS X A080 GPIB Explorer The interfaces listed below are currently installed GPIB Name Interface Type GPIBO PCI GPIB GPIB1 PCI GPIB Delete GPIB2 GPIB ENET 100 Properties oftware e Si NI 488 2 High Performance GPIB Figure 3 1 GPIB Explorer Mac OS X NI 488 2 User Manual 3 2 ni com Chapter 3 GPIB Explorer Mac OS X and Linux Linux To start GPIB Explorer enter the following command usr local natinst ni4882 bin gpibexplorer Figure 3 2 shows GPIB Explorer in Linux v GPIB Explorer File Tools Help x The interfaces listed below are currently installed GPIB Name Interface Type New PCI GPIB GPIB USB HS Delete Properties oftware e Si Refresh iier N oo 2 High Performance GPIB
47. acks n DeviceError TRUE return 0 If the returned status byte equals the expected response then the device has valid data to send otherwise it has a fault condition to report if SpollByte expectedResponse printf Device returned invalid response Status byte 0x x n SpollByte DeviceError TRUE return 0 Read the data from the device If the ERR bit is set in LocallIbsta then print an error message and return LocaliIbsta ibrd LocalUd ReadBuffer 40L if LocalIbsta amp ERR printf ibrd failed No more callbacks n DeviceError TRUE return 0 The string returned by ibrd is a binary string whose length is specified by the byte count in ThreadIbcnt However many GPIB instruments return ASCII data strings and this example makes this assumption Because of this it is possible to add a NULL character to the end of the data received and use the printf function to display the ASCII data The following code NI 488 2 User Manual 8 8 ni com Chapter 8 NI 488 2 Programming Techniques illustrates that ReadBuffer ThreadIbcnt 0 Convert the data into a numeric value sscanf ReadBuffer f amp Readings ReadingsTaken Display the data printf Reading f n Readings ReadingsTaken ReadingsTaken 1 if ReadingsTaken gt 1000 return 0 else Issue a request to the device to send the
48. actual number of bytes sent or received regardless of the existence of an error condition If one of the addresses in an address list to a multi device NI 488 2 call is invalid then the error is EARG and the Interactive Control utility displays the index of the invalid address as the count The count has a different meaning depending on which NI 488 2 call is made For the correct interpretation of the count return refer to the function descriptions in the N 488 2 Help For instructions on accessing the online help refer to the Using the NI 488 2 Documentation section in About This Manual NI 488 2 User Manual 7 12 ni com NI 488 2 Programming Techniques This chapter describes techniques for using some NI 488 2 calls in your application For more information about each function refer to the N 488 2 Help For instructions on accessing the online help refer to the Using the NI 488 2 Documentation section in About This Manual Termination of Data Transfers GPIB data transfers are terminated either when the GPIB EOI line is asserted with the last byte of a transfer or when a preconfigured end of string EOS character is transmitted By default EOI is asserted with the last byte of writes and the EOS modes are disabled You can use the ibconfig IbcEOT function to enable or disable the end of transmission EOT mode If EOT mode is enabled the GPIB EOI line is asserted when the last byte of a write is sent out on the
49. ad Check for presence of device on the GPIB at pad sad ibloc Go to local National Instruments Corporation 7 7 NI 488 2 User Manual Chapter 7 Interactive Control Utility Table 7 2 Syntax for Board Level Traditional NI 488 2 Calls in Interactive Control Continued Syntax Description ibnotify mask Start an asynchronous wait for selected events where mask is a hex or decimal integer or a list of mask bit mnemonics for example ibnotify TIMO CMPL ibonl v Place device online or offline ibpad v Change primary address ibppc v Parallel poll configure ibrd count Read data where count is the bytes to read ibrda count Read data asynchronously where count is the bytes to read ibrdf flname Read data to file where 1name is pathname of file to read ibrpp Conduct a parallel poll ibrsc v Request release system control ibrsv v Request service ibsad v Change secondary address ibsic Send interface clear ibsre v Set clear remote enable line ibstop Abort asynchronous operation ibtmo v Change disable time limit ibwait mask Wait for selected event where mask is a hex or decimal integer or a list of mask bit mnemonics such as ibwait TIMO CMPL ibwrt wrtbuf Write data ibwrta wrtbuf Write data asynchronously ibwrtf flname Write data from a file where 1name is pathname of file to write NI 488
50. amic library on Linux static and dynamic To have the library statically loaded at the time National Instruments Corporation 4 19 NI 488 2 User Manual Chapter 4 Developing Your NI 488 2 Application NI 488 2 User Manual your application starts compile and link your application as shown in the following examples gcc prog c lgpibapi or g prog cpp lgpibapi To have the library dynamically loaded on demand when your application accesses the library include cib o during the link phase of your application as shown in the following examples gcc prog c cib o ldl or g prog cpp cib o ldl cib ois in lt InstallDir gt natinst ni4882 1lib where lt InstallDir gt is the directory where you chose to install the NI 488 2 software The default is usr local The file cib o contains code to dynamically load the library The advantage of the latter way of compiling and linking your application is that it allows your application to run regardless of whether the NI 488 2 software is installed as long as it does not make any NI 488 2 calls 4 20 ni com Debugging Your Application This chapter describes several ways to debug your application NI Spy The NI Spy utility monitors NI 488 2 API calls made by NI 488 2 applications If an application does not have built in error detection handling you can use NI Spy to determine which NI 488 2 call is failing For more information about using NI Spy select Help H
51. are not using secondary addressing the secondary address is 0 For example if the primary address is 1 then the 16 bit value 4 12 ni com Chapter 4 Developing Your NI 488 2 Application is 0x01 otherwise if the primary address is 1 and the secondary address is 0x67 then the 16 bit value is 0x6701 Step 3 Initialize the Devices Use DevClearList to clear the devices on the GPIB The first argument is the GPIB interface number The second argument is the list of GPIB addresses that were found to be listening as determined in Step 2 Device Communication Step 4 Communicate with the Devices Communicate with the devices by sending them the IDN query and then reading back the responses Many devices respond to this query by returning a description of the device Refer to the documentation that came with your GPIB devices to see specific instruction on the proper way to communicate with them Step 4a Use SendList to send the IDN query command to multiple GPIB devices The address is the list of GPIB devices to be queried The buffer that you pass to SendList is the command message to the device Step 4b Use Receive for each device to read the responses from each device Continue communicating with the GPIB devices until you are finished Cleanup Step 5 Place the Interface Offline before Exiting Your Application Use ibon1 to put the interface offline before you exit the application National Instruments Cor
52. bcTMO option in the ibconfig function EBUS results if a timeout occurred while sending these command bytes EBUS can occur if there are no functioning devices present on the GPIB Possible solutions for this error are as follows e Verify that the instrument is operating correctly e Check your cable connections and make sure at least two thirds of your devices are powered on e Ifthe timeout period is too short for the driver to send command bytes increase the timeout period NI 488 2 User Manual ESRQ can only be returned by a device level ibwait call with RQS set in the mask ESRQ indicates that a wait for RQS is not possible because the GPIB SRQ line is stuck on This situation can be caused by the following events e Usually a device unknown to the software is asserting SRQ Because the software does not know of this device it can never serial poll the device and unassert SRQ e A GPIB bus tester or similar equipment might be forcing the SRQ line to be asserted e A cable problem might exist involving the SRQ line Although the occurrence of ESRQ warns you of a definite GPIB problem it does not affect GPIB operations except that you cannot depend on the Tbsta RQS bit while the condition lasts C 8 ni com Solutions ETAB 20 Appendix C Error Codes and Solutions Check to see if other devices not used by your application are asserting SRQ Disconnect them from the GPIB if necessary Solutions ELCK
53. berr National Instruments Corporation 4 17 NI 488 2 User Manual Chapter 4 Developing Your NI 488 2 Application NI 488 2 User Manual long Pibcntl static int __stdcall Pibdev int ud int pad int sad int tmo int eot int eos static int __stdcall Pibonl1 int ud int v Pibsta int GetProcAddress Gpib32Lib LPCSTR user_ibsta Piberr int GetProcAddress Gpib32Lib LPCSTR user_iberr Pibentl long GetProcAddress Gpib32Lib LPCSTR user_ibcnt Pibdev int __stdcall int int int int int int GetProcAddress Gpib32Lib LPCSTR ibdev Pibonl int __stdcall int int GetProcAddress Gpib32Lib LPCSTR ibonl If Get ProcAddress fails it returns a NULL pointer The following code fragment shows you how to verify that none of the calls to Get ProcAddress failed if Pibsta NULL Piberr NULL Pibentl NULL Pibdev NULL Pibonl NULL Free the GPIB library FreeLibrary Gpib32Lib printf GetProcAddress failed Your Win32 application needs to dereference the pointer to access either the status variables or function The following code shows you how to call a function and access the status variable from within your application dvm Pibdev 0 1 0 T10s 1 0 if Pibsta amp ERR printf Call failed 4 18 ni com Chapter 4 Developing Your NI 488 2 Application
54. bit EOS Compare Secondary None x fo EOS Byte VO Timeout 10sec x JY System Controller Figure 3 4 Properties Dialog Box Linux 3 Optional Change the settings for your interface then click the OK button National Instruments Corporation 3 7 NI 488 2 User Manual Chapter 3 GPIB Explorer Mac OS X and Linux Access Additional Help and Resources To access additional help and resources for the NI 488 2 software and your GPIB hardware refer to the following sections NI 488 2 Help The NI 488 2 Help addresses questions you might have about NI 488 2 and includes a function reference and troubleshooting information You can access the NI 488 2 Help as follows 1 Start GPIB Explorer as described in the Starting GPIB Explorer section 2 Select Help Help Topics NI 488 2 from the menu bar National Instruments GPIB Web Site 1 Start GPIB Explorer as described in the Starting GPIB Explorer section 2 Select Help National Instruments on the Web GPIB Home Page from the menu bar to access the National Instruments Web site for GPIB View or Change GPIB ENET 100 Network Settings To view or change the network settings of your GPIB ENET 100 refer to the following sections For more information about your GPIB ENET 100 network settings refer to the GPIB ENET 100 information in the GPIB Hardware Guide To view the GPIB Hardware Guide you need Adobe Acrobat Reader which you can download from
55. box and click OK View GPIB Instrumentation Information To view information about your GPIB instruments complete the following steps 1 National Instruments Corporation Start Measurement amp Automation Explorer as described in the Starting Measurement amp Automation Explorer section Expand the Devices and Interfaces directory by clicking the next to the folder Select your GPIB interface Measurement amp Automation Explorer displays the connected instruments in the right window pane If you have not already done so scan for connected instruments Right click on your GPIB interface and select Scan for Instruments from the drop down menu that appears Refer to the Scan for GPIB Instruments section earlier in this chapter for more information Double click on the instrument displayed in the right window pane Measurement amp Automation Explorer lists all the attributes for the instrument such as the primary address the secondary address if applicable the instrument s response to the identification query IDN and the GPIB interface number to which the device is connected 2 11 NI 488 2 User Manual Chapter 2 Measurement amp Automation Explorer Windows Change GPIB Device Templates For older NI 488 2 applications you might need to modify one of the device templates to find a given GPIB instrument by name for example ibfind fluke45 Older applications still use ibfind instead of
56. ce level handle that you can use for further NI 488 2 calls To clear the device use ibclr as follows ud0 ibclr 0100 cmpl To write data to the device use ibwrt Make sure that you refer to the documentation that came with your GPIB instrument for recognized command messages ud0 ibwrt enter string 0100 cmpl count 5 XTDN Or equivalently udO ibwrt IDN 0100 cmpl count 5 To read data from your device use ibrd The data that is read from the instrument is displayed For example to read 29 bytes enter the following ud0 ibrd enter byte count 29 0100 cmpl1 count 29 46 4c 55 4B 45 2C 20 34 FLUKE 4 35 2C 20 34 37 39 30 31 5 47901 37 33 2C 20 31 2E 36 20 73 1 6 44 31 2E 30 OA D 10 7 3 NI 488 2 User Manual Chapter 7 Interactive Control Utility 6 Or equivalently ud0 ibrd 29 0100 cmpl count 29 46 4C 55 4B 45 2C 20 34 FLUKE 4 35 2C 20 34 37 39 30 31 5 47901 37 33 2C 20 31 2E 36 20 73 1 6 44 31 2E 30 OA D 10 When you finish communicating with the device make sure you put it offline using the ibon1 command as follows ud0 ibonl 0 0100 cmpl The ibonl command properly closes the device handle and the udo prompt is no longer available To exit Interactive Control type q Interactive Control Syntax Number Syntax NI 488 2 User Manual The following special rules apply to making calls from the Interactive Control utility The ud or B
57. data and rearm callback on RQS LocaliIbsta ibwrt LocalUd SEND DATA 9L if LocalIbsta amp ERR printf ibwrt failed No more callbacks n DeviceError TRUE return 0 else return RQS Writing Multithreaded NI 488 2 Applications If you are writing a multithreaded NI 488 2 application and you plan to make all of your NI 488 2 calls from a single thread you can safely continue to use the NI 488 2 global functions Ibsta Iberr and Ibent The NI 488 2 global functions are defined on a per process basis so each process accesses its own copy of the NI 488 2 globals If you are writing a multithreaded NI 488 2 application and you plan to make NI 488 2 calls from more than a single thread you cannot safely continue to use the traditional NI 488 2 global functions without some form of synchronization for example semaphores mutexes critical sections To understand why refer to the following example National Instruments Corporation 8 9 NI 488 2 User Manual Chapter 8 NI 488 2 Programming Techniques NI 488 2 User Manual Assume that a process has two separate threads that make NI 488 2 calls thread 1 and thread 2 Just as thread 1 is about to examine one of the NI 488 2 globals it gets preempted and thread 2 is allowed to run Thread 2 proceeds to make several NI 488 2 calls that automatically update the NI 488 2 globals Later when thread 1 is allowed to run the NI 488 2 global that it
58. e GPIB Attention ATN line ATN is set whenever the GPIB ATN line is asserted and it is cleared when the ATN line is unasserted NI 488 2 User Manual TACS indicates whether the GPIB interface is addressed as a Talker TACS is set whenever the GPIB interface detects that its talk address and secondary address if enabled has been sent either by the GPIB interface itself or by another Controller TACS is cleared whenever the GPIB interface detects the Untalk UNT command its own listen address a talk address other than its own talk address or Interface Clear IFC B 4 ni com Appendix B Status Word Conditions LACS brd LACS indicates whether the GPIB interface is addressed as a Listener LACS is set whenever the GPIB interface detects that its listen address and secondary address if enabled has been sent either by the GPIB interface itself or by another Controller LACS is also set whenever the GPIB interface shadow handshakes as a result of the ibgts function LACS is cleared whenever the GPIB interface detects the Unlisten UNL command its own talk address Interface Clear IFC or that the ibgts function has been called without shadow handshake DTAS brd DTAS indicates whether the GPIB interface has detected a device trigger command DTAS is set whenever the GPIB interface as a Listener detects that the Group Execute Trigger GET command has been sent by another Controller DTAS is cleared on any call imm
59. e and it does not respond it might not be recognizing the end of the command In that case you need to send a termination message such as lt CR gt lt LF gt after a write command as follows ibwrt dev COMMAND x0D x0A 9 Other Errors If you experience other errors in your application refer to the NJ 488 2 Help It includes extensive troubleshooting information and the answers to frequently asked questions For instructions on accessing the online help refer to the Using the NI 488 2 Documentation section in About This Manual National Instruments Corporation 5 3 NI 488 2 User Manual NI Spy Utility This chapter introduces you to NI Spy a utility that monitors and records multiple National Instruments APIs for example NI 488 2 and NI VISA Overview NI Spy monitors records and displays the NI 488 2 calls made from NI 488 2 applications You can use it to troubleshoot errors in your application and to verify the communication with your GPIB instrument NI Spy shows which NI 488 2 calls are being used to communicate with your instrument If your application is not working properly you can use NI Spy to search for failed NI 488 2 calls Starting NI Spy Windows To start NI Spy complete the following steps 1 Start Measurement amp Automation Explorer as described in Chapter 2 Measurement amp Automation Explorer Windows 2 Expand the Devices and Interfaces directory by clicking the next
60. eady not ready to receive a not ready for data message byte Also used by the Talker to signal high speed HS488 GPIB transfers NDAC Listening device has has not accepted a message not data accepted byte DAV Talking device indicates signals on data lines are data valid stable valid data Interface Management Lines Five hardware lines manage the flow of information across the bus Table A 2 summarizes the GPIB interface management lines Table A 2 GPIB Interface Management Lines Line Description ATN Controller drives ATN true when it sends attention commands and false when it sends data messages IFC System Controller drives the IFC line to initialize interface clear the bus and make itself CIC REN System Controller drives the REN line to place remote enable devices in remote or local program mode National Instruments Corporation A 3 NI 488 2 User Manual Appendix A GPIB Basics Table A 2 GPIB Interface Management Lines Continued Line Description SRQ Any device can drive the SRQ line to service request asynchronously request service from the Controller EOI Talker uses the EOI line to mark the end of a data end or identify message Controller uses the EOI line when it conducts a parallel poll NI 488 2 User Manual A 4 ni com Status Word Conditions This appendix gives a detailed description of the condition
61. ecome Controller In Charge CIC Use SendIFC to initialize the bus and the GPIB interface so that the GPIB interface is Controller In Charge CIC The only argument of SendIFC is the GPIB interface number typically 0 for GPIBO Step 2 Determine the GPIB Address of Your Device Use FindLstn to find all the devices attached to the GPIB The FindLstn function requires the following parameters e Interface number typically 0 for GPIBO e A list of primary addresses terminated with the NOADDR constant e A list for reported GPIB addresses of devices found listening on the GPIB e Limit which is the number of the GPIB addresses to report Use FindLstn to test for the presence of all of the primary addresses that are passed to it If a device is present at a particular primary address then the primary address is stored in the GPIB addresses list Otherwise all secondary addresses of the given primary address are tested and the GPIB address of any devices found is stored in the GPIB addresses list When you have the list of GPIB addresses you can determine which one corresponds to your instrument and use it for subsequent calls Alternately if you already know your GPIB device s primary and secondary address you can create an appropriate GPIB address to use in subsequent NI 488 2 calls as follows a GPIB address is a 16 bit value that contains the primary address in the low byte and the secondary address in the high byte If you
62. ediately following an ibwait or ibnotify call if the DTAS bit is set in the ibwait mask parameter DCAS brd DCAS indicates whether the GPIB interface has detected a device clear command DCAS is set whenever the GPIB interface detects that the Device Clear DCL command has been sent by another Controller or whenever the GPIB interface as a Listener detects that the Selected Device Clear SDC command has been sent by another Controller If you use the ibwait or ibnotify function to wait for DCAS and the wait is completed DCAS is cleared from Ibsta after the next NI 488 2 call The same is true of reads and writes If you call a read or write function such as ibwrt or Send and DCAS is set in Ibsta the I O operation is aborted DCAS is cleared from Ibsta after the next NI 488 2 call National Instruments Corporation B 5 NI 488 2 User Manual Error Codes and Solutions This appendix lists a description of each error some conditions under which it might occur and possible solutions Table C 1 lists the GPIB error codes Table C 1 GPIB Error Codes Error Mnemonic Value Meaning EDVR 0 System error ECIC 1 Function requires GPIB interface to be CIC ENOL 2 No Listeners on the GPIB EADR 3 GPIB interface not addressed correctly EARG 4 Invalid argument to function call ESAC 5 GPIB interface not System Controller as required EABO 6 I O operation aborted timeout ENEB 7 No
63. eeeecseeeseeseeeseeeeeneeneees 4 5 Communicating with a Single GPIB Device eee 4 5 Using Multiple Interfaces and or Multiple Devices 0 0 0 0 4 6 Checking Status with Global Functions 000 0 ec eeceseeceseeseceeeeseeeeecseceseeseesaeeseenaeeaeens 4 6 Status Word bsta ises en lesen e E E de E di teste aa a 4 7 Error Function Iberr 0 0 cccccscccacsceseesetevseccaeasetvesssecevedesensanshveschaeesbieesventets 4 8 Count Function Tbetis a E EE E EE 4 9 Using Interactive Control to Communicate with Devices ssseesessesseersererrersreereerses 4 9 Programining Mod ls serie none irra eaa a her en 4 9 Applications That Communicate with a Single GPIB Device 4 9 Items to In l de n rainne an EEE A 4 9 General Program Steps and Examples sseessseessereseersrsersreerrersreees 4 10 Applications That Use Multiple Interfaces or Communicate with Multiple GPIB Devices 0 0 eeceseeeeeeseeseeeseeseeeseceeesecseenaetaeenaes 4 11 Ttems to Incliide 2132 5 kins e E EE peneets 4 11 General Program Steps and Examples ceeseeeeseeeeeeseeeeeeeees 4 12 NI 488 2 User Manual vi ni com Contents Language Specific Programming Instructions for Windows 1 00 0 eeeeseeseeereeeees 4 14 Microsoft Visual C C Version 6 0 or Later cccccccssccsesceeeeseeeesseeenseees 4 14 Borland C C Version 5 0 2 or Later cccccccccessceeesseceesteeessneeeseeeesseeeees 4 14 Visual Basic Version 6 0 nuce n E E E 4 15 Direc
64. eeseceeeeeeeeeeeeneeeeaes Instruments Not Found cecceeceeeseceseeeeeeeseeeseeeeeeeeeeees Too Many Listeners on the GPIB eee eee eeeee tees Communicate with Your Instrument 0 ec eeeeeeeeseeeeeeeeeeeteeeeeeeaes Basic Communication Query Write Read eeeeeeeeeee Advanced Communication ccecceseesrecsneeeseeeeeeeseeeneeees View NI 488 2 Software Version ccecccesceseeeeseeeseeeeeeceeeeseeenseeee Monitor Record and Display NI 488 2 Calls eee ee eeeeeeeees View or Change GPIB Interface Settings 0 eee eeeeeeeeeeeeees Change GPIB Permissions eceeeesesseceseeseeeseceeceseeseeeseseeeeseesaes View GPIB Instrumentation Information ccc eeeeeeeeseeeeneeeneeeees Change GPIB Device Templates 00 0 0 eee eeeeceeseeseeeeeeeeeseeneeeaes Enable Disable NI 488 2 DOS Support eee ee eeeeeereeeeeeeees Access Additional Help and Resources ecceseeeeseeeneeeneeeeneeeeeee NIE48822 Hel pis stiecsis hace desert dock eb eavteed E EAR aN National Instruments GPIB Web Site eee eeeeeeseeeteeeee View or Change GPIB ENET 100 Network Settings Device Configuration siess cece non e E Update GPIB ENET 100 Firmware seeseeseeseeeeeeeeeere National Instruments Corporation v NI 488 2 User Manual Contents Chapter 3 GPIB Explorer Mac OS X and Linux Starting GPIB Explorer lt ecesca ccscecescdeeteescsseeepectessdeestescsadeednasesdisestaneea dbebaecasdetavaeesedes 3 2 Mac
65. elp Topics in NI Spy or refer to Chapter 6 NI Spy Utility Global Status Functions At the end of each NI 488 2 call the global status functions Ibsta Iberr and Ibcnt are updated If you are developing an NI 488 2 application you should check for errors after each NI 488 2 call If a NI 488 2 call failed the high bit of Tbsta the ERR bit is set For a failed NI 488 2 call Iberr contains a value that defines the error In some error cases the value in Ibcnt contains even more error information Once you know which NI 488 2 call fails refer to Appendix B Status Word Conditions and Appendix C Error Codes and Solutions for help understanding why the NI 488 2 call failed This information is also available in the N 488 2 Help For instructions on accessing the online help refer to the Using the NI 488 2 Documentation section in About This Manual NI 488 2 Error Codes The error function Iberr is meaningful only when the ERR bit in the status function Ibsta is set For a detailed description of each error and possible solutions refer to Appendix C Error Codes and Solutions National Instruments Corporation 5 1 NI 488 2 User Manual Chapter 5 Debugging Your Application Configuration Errors Several applications require customized configuration of the NI 488 2 driver For example you might want to terminate reads on a special end of string character or you might require secondary addressing In these cas
66. emoved e Most functions with an ibconfig have been removed Using ibconfig is recommended for new code Existing functions redirect to using ibconfig using macros These are the affected functions ibpad ibsad ibtmo ibeot ibrsc ibsre ibeos ibdma ibist ibrsv e Many macro definitions have been improved for programmatic safety National Instruments Corporation 4 3 NI 488 2 User Manual Chapter 4 Developing Your NI 488 2 Application NI 488 2 User Manual Modifying existing applications to use the NI4882 API should require minimal changes In most cases using the new include file ni4882 h instead of windows h and ni488 h and linking to the new object file ni4882 obj instead of gpib 32 o0bj is sufficient to compile your application There may still be warnings due to changes to the status variable type s signed property Complications may arise in several uncommon use cases The following issues have been encountered e Storing function pointers for the ibnotify callback This causes a type mismatch on the assignment To solve this fix the function prototype of the callback to use unsigned long for the status parameters e Using function pointers to ibfind This causes a preprocessor error because the ibfind macro requires a one parameter argument To solve this point to ibfindA or ibfindw depending on the unicode convention in your application e Configuration functions
67. ength In addition to using ibconfig to configure your GPIB interface for HS488 the Controller In Charge must send out GPIB command bytes interface messages to configure other devices for HS488 transfers 8 2 ni com Chapter 8 NI 488 2 Programming Techniques If you are using device level calls the NI 488 2 software automatically sends the HS488 configuration message to devices If you enabled the HS488 protocol in the GPIB Configuration utility the NI 488 2 software sends out the HS488 configuration message when you use ibdev to bring a device online If you call ibconfig to change the GPIB cable length the NI 488 2 software sends out the HS488 message again the next time you call a device level function If you are using board level traditional NI 488 2 calls or multi device NI 488 2 calls and you want to configure devices for high speed you must send the HS488 configuration messages using ibcmd or SendCmds The HS488 configuration message is made up of two GPIB command bytes The first byte the Configure Enable CFE message hex 1F places all HS488 devices into their configuration mode Non HS488 devices should ignore this message The second byte is a GPIB secondary command that indicates the number of meters of cable in your system It is called the Configure CFGn message Because HS488 can operate only with cable lengths of 1 to 15 m only CFGn values of 1 through 15 hex 61 through 6F are valid If the cable length was con
68. enotes text that is a placeholder for a word or value that you must supply Text in this font denotes a specific platform and indicates that the text following it applies only to that platform Related Documentation The following documents contain information that you may find helpful as you read this manual e ANSI TEEE Standard 488 1 2003 IEEE Standard Digital Interface for Programmable Instrumentation e ANSI TEEE Standard 488 2 1992 IEEE Standard Codes Formats Protocols and Common Commands National Instruments Corporation xiii NI 488 2 User Manual Introduction This chapter describes how to set up your GPIB system Setting Up and Configuring Your System Devices are usually connected with a cable assembly consisting of a shielded 24 conductor cable with both a plug and receptacle connector at each end With this design you can link devices in a linear configuration a star configuration or a combination of the two configurations Figure 1 1 shows the linear and star configurations Device A oD gt Device A Device D Device B Eo aw fee Device C Device B Device C a Linear Configuration b Star Configuration Figure 1 1 Linear and Star System Configuration National Instruments Corporation 1 1 NI 488 2 User Manual Chapter 1 Introduction Controlling More Than One Interface Figure 1 2 shows an example of a multi interface
69. er message from the Controller the application might begin an operation such as taking a voltage reading if the application is acting as a voltmeter For designing more complex GPIB devices you can use our NI Device product Please refer to our web site for more information NI 488 2 User Manual You can use serial polling to obtain specific information from GPIB devices when they request service When the GPIB SRQ line is asserted it signals the Controller that a service request is pending The Controller must then determine which device asserted the SRQ line and respond accordingly The most common method for SRQ detection and servicing is the serial poll This section describes how to set up your application to detect and respond to service requests from GPIB devices 8 12 ni com Chapter 8 NI 488 2 Programming Techniques Service Requests from IEEE 488 Devices IEEE 488 devices request service from the GPIB Controller by asserting the GPIB SRQ line When the Controller acknowledges the SRQ it serial polls each open device on the bus to determine which device requested service Any device requesting service returns an 8 bit status byte with bit 6 set and then unasserts the SRQ line Devices not requesting service return a status byte with bit 6 cleared Manufacturers of IEEE 488 devices use the remaining seven bits to communicate the reason for the service request or to summarize the state of the device Service Requests from IEE
70. erstands refer to the documentation that came with your GPIB instrument Most instruments respond to the IDN command by returning an identification string Basic Communication Query Write Read To establish basic communication with your instrument use the NI 488 2 Communicator as follows NI 488 2 User Manual 1 Start Measurement amp Automation Explorer as described in the Starting Measurement amp Automation Explorer section Expand the Devices and Interfaces directory by clicking the next to the folder Select your GPIB interface If you have not already done so scan for connected instruments Right click on your GPIB interface and select Scan for Instruments from the drop down menu that appears Refer to the Scan for GPIB Instruments section for more information Measurement amp Automation Explorer displays the connected instruments below your GPIB interface Right click on your GPIB instrument in the left window pane and select Communicate with Instrument from the drop down menu that appears 2 6 ni com 6 Chapter 2 Measurement amp Automation Explorer Windows The NI 488 2 Communicator dialog box appears as shown in Figure 2 3 NI 488 2 Communicator 15 xi GPIBO Instrument O Primary Address 2 Globals m Status a e x mjm Send String IDN ibsta 0100 zh A MoO Query Write Read iberr None END ibentl 4 SRAI Configured nas String Received CMPL ri Haji R
71. erved 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 Instruments 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 document 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
72. es you can either reconfigure from your application using the ibconfig function or reconfigure using the GPIB Configuration utility 3 Note National Instruments recommends using ibconfig to modify the configuration Timing Errors If your application uses ibconfig it works properly regardless of the previous configuration For more information about using ibconfig refer to the description of ibconfig in the NI 488 2 Help For instructions on accessing the online help refer to the Using the NI 488 2 Documentation section in About This Manual NI 488 2 User Manual If your application fails but the same calls issued interactively in the Interactive Control utility are successful your program might be issuing the NI 488 2 calls too quickly for your device to process and respond to them This problem can also result in corrupted or incomplete data This is only a problem with noncompliant GPIB devices A well behaved IEEE 488 device does not experience timing errors If your device is not well behaved you can test for and resolve the timing error by single stepping through your program and inserting finite delays between each NI 488 2 call One way to do this is to have your device communicate its status whenever possible Although this method is not possible with many devices it is usually the best option Your delays are controlled by the device and your application can adjust itself and work independently on any platform Other delay
73. esult in an error TIMO dev brd TIMO indicates that the timeout period has expired TIMO is set in the status word following any synchronous I O functions for example ibcmd ibrd ibwrt Receive Send and Sendcmds if the timeout period expires before the I O operation has completed TIMO is also set in the status word following an ibwait or ibnotify call if the TIMO bit is set in the mask parameter and the timeout period expires before any other specified mask bit condition occurs TIMO is cleared in all other circumstances END dev brd END indicates either that the GPIB EOI line has been asserted or that the EOS byte has been received if the software is configured to terminate a read on an EOS byte If the GPIB interface is performing a shadow handshake as a result of the ibgts function any other function can return a status word with the END bit set if the END condition occurs before or during that call END is cleared when any I O operation is initiated Some applications might need to know the exact I O read termination mode of a read operation EOI by itself the EOS character by itself or EOI plus the EOS character You can use the ibconfig function option IbcEndBitIsNorma1 to enable a mode in which the END bit is set only when EOI is asserted In this mode if the I O operation completes because of the EOS character by itself END is not set The application should check the last byte of the received buffer to
74. evice that a transmission has ended The two most common EOS characters are r and n r represents a carriage return character and n represents a linefeed character You can use these special characters to insert the carriage return and linefeed characters into a string as in IDN r n Some of the NI 488 2 calls have an address or address list parameter An address is a 16 bit representation of the GPIB device address The primary address is stored in the low byte and the secondary address if any is stored in the high byte For example a device at primary address 6 and secondary address 0x67 has an address of 0x6706 A NULL address is represented as Oxffff An address list is represented by a comma separated list of addresses such as 1 0xb706 3 Interactive Control Commands Tables 7 1 and 7 2 summarize the syntax of the traditional NI 488 2 calls in the Interactive Control utility Table 7 3 summarizes the syntax of the multi device NI 488 2 calls in the Interactive Control utility Table 7 4 summarizes the auxiliary functions that you can use in the Interactive Control utility For more information about the function parameters use the online help available by typing in help If you enter only the function name the Interactive Control utility prompts you for parameters National Instruments Corporation 7 5 NI 488 2 User Manual Chapter 7 Table 7 1 Interactive Control Utility Syntax for Device Level Traditional N
75. ext to the folder 3 Click on NI 488 2 Measurement amp Automation Explorer displays the version number of the NI 488 2 software in the right window pane What do I do if my GPIB hardware is listed in the Windows Device Manager with a circled X or an exclamation point overlaid on it Refer to the Troubleshooting topics in the NI 488 2 Help for information about what might cause this problem If you cannot resolve the problem contact National Instruments How can I determine which type of GPIB hardware I have installed Select Start Programs National Instruments Measurement amp Automation and expand the Devices and Interfaces directory by clicking the next to the folder Measurement amp Automation Explorer lists your installed GPIB hardware under Devices and Interfaces Are interrupts and DMA required for the NI 488 2 software Generally plug in interface cards such as the PCI GPIB require interrupt resources in your computer Remote interfaces such as the GPIB USB and GPIB ENET products do not require interrupt resources in your computer There may be exceptions to this statement Refer to the general readme file Readme txt located on your installation CD or in the installation directory for the latest interface options supported by the current version of NI 488 2 DMA is not required for the NI 488 2 software National Instruments Corporation D 3 NI 488 2 User Manual Technical Support and Profess
76. f display used for buffers Valid options are full brief ascii and off Default is full q Exit or quit NI 488 2 User Manual 7 10 ni com Chapter 7 Interactive Control Utility Status Word In the Interactive Control utility all NI 488 2 calls except ibfind and ibdev return the status word Ibsta in two forms a hex value in square brackets and a list of mnemonics in parentheses In the following example the status word is on the second line showing that the write operation completed successfully ud0 ibwrt IDN 0100 cmpl count 5 udo For more information about Ibsta refer to Appendix B Status Word Conditions Error Information If an NI 488 2 call completes with an error the Interactive Control utility displays the relevant error mnemonic In the following example an error condition EBUS has occurred during a data transfer ud0 ibwrt IDN 8100 err cmpl error EBUS count 1 udo In this example the addressing command bytes could not be transmitted to the device This indicates that either the GPIB device is powered off or the GPIB cable is disconnected For a detailed list of the error codes and possible solutions refer to Appendix C Error Codes and Solutions National Instruments Corporation 7 11 NI 488 2 User Manual Chapter 7 Interactive Control Utility Count Information When an I O function completes the Interactive Control utility displays the
77. figured properly in the GPIB Configuration utility you can determine how many meters of cable are in your system by calling ibask option IbaHSCableLength in your application For more information about CFE and CFGn messages refer to the Multiline Interface Messages topic in the NI 488 2 Help For instructions on accessing the online help refer to the Using the NI 488 2 Documentation section in About This Manual System Configuration Effects on HS488 Maximum HS488 data transfer rates can be limited by your host computer and GPIB system setup For example when using a PC compatible computer with PCI bus the maximum obtainable transfer rate is 8 Mbytes s but when using another bus such as USB or Ethernet the maximum data transfer rate depends on the maximum transfer rate of that bus The same IEEE 488 cabling constraints for a 350 ns T1 delay apply to HS488 As you increase the amount of cable in your GPIB configuration the maximum data transfer rate using HS488 decreases For example two HS488 devices connected by two meters of cable can transfer data faster than four HS488 devices connected by 4 m of cable National Instruments Corporation 8 3 NI 488 2 User Manual Chapter 8 NI 488 2 Programming Techniques Waiting for GPIB Conditions You can use the ibwait function to obtain the current ibsta value or to suspend your application until a specified condition occurs on the GPIB If you use ibwait with a parameter of zero
78. fter you save your data select File Exit to exit the NI Spy utility Performance Considerations NI Spy can slow down the performance of your NI 488 2 application and certain configurations of NI Spy have a larger impact on performance than others For example configuring NI Spy to record calls to an output file or to use full buffers might have a significant impact on the performance of both your application and your system For this reason use NI Spy only while you are debugging your application or in situations where performance is not critical National Instruments Corporation 6 3 NI 488 2 User Manual Interactive Control Utility This chapter introduces you to the Interactive Control utility which lets you communicate with GPIB devices interactively Overview With the Interactive Control utility you communicate with the GPIB devices through functions you interactively type in at the keyboard For specific information about communicating with your particular device refer to the documentation that came with the device You can use the Interactive Control utility to practice communication with the instrument troubleshoot problems and develop your application The Interactive Control utility helps you to learn about your instrument and to troubleshoot problems by displaying the following information on your screen after you enter a command e Results of the status word Ibsta in hexadecimal notation e Mnemonic con
79. have multiple Controllers on the GPIB but only one Controller at a time can be the active Controller or Controller In Charge CIC The CIC can be either active or inactive standby Control can pass from the current CIC to an idle Controller but only the System Controller usually a GPIB interface can make itself the CIC National Instruments Corporation A 1 NI 488 2 User Manual Appendix A GPIB Basics GPIB Addressing All GPIB devices and interfaces must be assigned a unique GPIB address A GPIB address is made up of two parts a primary address and an optional secondary address The primary address is a number in the range 0 to 30 The Controller uses this address to form a talk or listen address that is sent over the GPIB when communicating with a device Most devices just use primary addressing The GPIB Controller manages the communication across the GPIB by using the addresses to designate which devices should be listening or talking at any given moment Typically your computer is the GPIB Controller and it manages communication with your GPIB device by sending messages to it and receiving messages from it A talk address is formed by setting bit 6 the TA Talk Active bit of the GPIB address A listen address is formed by setting bit 5 the LA Listen Active bit of the GPIB address For example if a device is at address 1 the Controller sends hex 41 address 1 with bit 6 set to make the device a Talker Because the C
80. he GPIB composed of a primary address MLA and MTA and perhaps a secondary address MSA The GPIB board has both a GPIB address and an I O address Refers to the National Instruments family of GPIB interfaces Go To Local The GPIB command used to place an addressed Listener in local front panel control mode The mechanism used to transfer bytes from the source handshake function of one device to the acceptor handshake function of another device DAV NRFD and NDAC three GPIB lines are used in an interlocked fashion to signal the phases of the transfer so that bytes can be sent asynchronously for example without a clock at the speed of the slowest device For more information about handshaking refer to the ANSI TEEE Standard 488 1 2003 NI 488 2 User Manual Glossary hex high level function HS488 T O T O address ibent Tbent ibentl iberr NI 488 2 User Manual Hexadecimal A number represented in base 16 For example decimal 16 is hex 10 See device level function A high speed data transfer protocol for IEEE 488 This protocol increases performance for GPIB reads and writes up to 8 Mbytes s depending on your system Hertz Input output In this manual it is the transmission of commands or messages between the system via the GPIB board and other devices on the GPIB The address of the GPIB board from the point of view of the CPU as opposed to the GPIB address of the GPIB board Als
81. he Interactive Control utility enter the following command lt InstallDir gt natinst ni4882 bin gpibintctrl where lt Instal11Dir gt is the directory where you chose to install the NI 488 2 software The default is usr local 2 At the command prompt type NI 488 2 API calls to communicate interactively with your instrument For example you might use ibdev ibclr ibwrt ibrd and ibonl Choosing Your Programming Methodology Based on your development environment you can select a method for accessing the driver and based on your NI 488 2 programming needs you can choose how to use the NI 488 2 API Choosing a Method to Access the NI 488 2 Driver NI 488 2 User Manual Windows Applications using the older GPIB32 API can access the NI 488 2 dynamic link library DLL gpib 32 d11 either by using an NI 488 2 application interface or by direct access Applications using the new NI4882 API can access the NI 488 2 dynamic link library DLL ni42882 d11 by using an NI 488 2 application interface only NI 488 2 Application Interfaces You can use an application interface if your program is written in Microsoft Visual C C 6 0 or later Borland C C 5 02 or later Microsoft Visual Basic 6 0 or any NET programming language Otherwise you must access gpib 32 d11 directly For more information about application interfaces refer to NI 488 2 Application Interface Files in the NI 488 2 Help Direct Entry Access Y
82. her NI 488 2 operations while it is using ibnotify use the per thread NI 488 2 globals that are provided by the ThreadIbsta ThreadIberr and ThreadIbcnt functions described in the Writing Multithreaded NI 488 2 Applications section of this chapter In addition if your application needs to share global variables with the callback use a synchronization primitive for example a semaphore to protect access to any globals For more information about the use of synchronization primitives refer to the documentation about using operating system synchronization objects that came with your development tools National Instruments Corporation 8 5 NI 488 2 User Manual Chapter 8 NI 488 2 Programming Techniques ibnotify Programming Example 3 The following code is an example of how you can use ibnotify in your application Assume that your GPIB device is a multimeter that you program to acquire a reading by sending SEND DATA The multimeter requests service when it has a reading ready and each reading is a floating point value In this example globals are shared by the Callback thread and the main thread and the access of the globals is not protected by synchronization In this case synchronization of access to these globals is not necessary because of the way they are used in the application only a single thread is writing the global values and that thread only adds information increases the count or adds another reading to the array
83. hether the GPIB EOI line was asserted when the EOS byte was read in Use the IbcEndBitIsNormal option to configure the software to report only the END bit in Ibsta when the GPIB EOI line is asserted By default END is reported in Ibsta when either the EOS byte is read in or the EOI line is asserted during a read High Speed Data Transfers HS488 Enabling HS488 NI 488 2 User Manual National Instruments has designed a high speed data transfer protocol for IEEE 488 called HS488 This protocol increases performance for GPIB reads and writes up to 8 Mbytes s depending on your system HS488 is part of the IEEE 488 1 2003 standard thus you can mix IEEE 488 1 IEEE 488 2 and HS488 devices in the same system If HS488 is enabled HS488 compliant interfaces implement high speed transfers automatically when communicating with HS488 instruments If you attempt to enable HS488 on a GPIB interface that does not have HS488 capable hardware the ECAP error code is returned To enable HS488 for your GPIB interface use the ibconfig function option IbcHSCableLength The value passed to ibconfig should specify the number of meters of cable in your GPIB configuration If you specify a cable length that is much smaller than what you actually use the transferred data could become corrupted If you specify a cable length longer than what you actually use the data is transferred successfully but more slowly than if you specified the correct cable l
84. ialPollResponse SRQ and Serial Polling with Multi Device NI 488 2 Calls The NI 488 2 software includes a set of multi device NI 488 2 calls that you can use to conduct SRQ servicing and serial polling Calls pertinent to SRQ servicing and serial polling are Al1Spol11 ReadStatusByte FindRQS Test SRQ and WaitSRQ Following are descriptions of each of the calls e Al11Spo11 can serial poll multiple devices with a single call It places the status bytes from each polled instrument into a predefined array Then you must check the RQS bit bit 6 or hex 40 of each status byte to determine whether that device requested service e ReadStatusByte is similar to Al1Spo11 except that it only serial polls a single device It is similar to the device level NI 488 2 ibrsp function National Instruments Corporation 8 15 NI 488 2 User Manual Chapter 8 NI 488 2 Programming Techniques NI 488 2 User Manual FindRQS serial polls a list of devices until it finds a device that is requesting service or until it has polled all of the devices on the list The call returns the index and status byte value of the device requesting service e TestSRQ determines whether the SRQ line is asserted and returns to the program immediately e WaitSRQ is similar to Test SRQ except that WaitSRQ suspends the application until either SRQ is asserted or the timeout period is exceeded The following examples use these calls to detect SRQ and then determ
85. ibrd UDO National Inst 100 0x64 0x2100 0x003E 08 50 16 720 ibwrt UDO conf dc max 11 0xB 0x0100 0x0008 08 50 34 396 ibwrt UDO meas dc 8 0x8 0x0100 0x0008 08 50 46 894 ibrd UDO 5 7319 100 0x64 0x2100 Ox0007 08 50 49 908 fig Captured F Displayed 7 Figure 2 4 NI 488 2 Calls Recorded by NI Spy For more information about using NI Spy select Help Help Topics in NI Spy or refer to Chapter 6 NI Spy Utility View or Change GPIB Interface Settings The default behavior of NI 488 2 software is to allow only administrators to make changes to the GPIB interface settings You can change this behavior by following the instructions described in the Change GPIB Permissions section To view or change your interface settings complete the following steps 1 Start Measurement amp Automation Explorer as described in the Starting Measurement amp Automation Explorer section Note You must choose to run as Adminstrator to allow changes to GPIB Interface Settings To do this right click on the Measurement amp Automation Explorer icon and select Run as Administrator 2 Expand the Devices and Interfaces directory by clicking the next to the folder National Instruments Corporation 2 9 NI 488 2 User Manual Chapter 2 Measurement amp Automation Explorer Windows 3 Select your GPIB interface in the left window pane of Measurement amp Automation Explorer The interface properties a
86. ically determine the GPIB address of your GPIB device as described in Step 2 Determine the GPIB Address of Your Device in the Applications That Use Multiple Interfaces or Communicate with Multiple GPIB Devices section later in this chapter e Secondary address for the GPIB instrument 0 if the GPIB instrument does not use secondary addressing e Timeout period typically set to T10s which is 10 seconds e End of transfer mode typically set to 1 so that EOI is asserted with the last byte of writes e EOS detection mode typically 0 if the GPIB instrument does not use EOS characters A successful ibdev call returns a device handle ud that is used for all device level traditional NI 488 2 calls that communicate with the GPIB instrument Step 2 Clear the Device Use ibclr to clear the device This resets the device s internal functions to the default state 4 10 ni com Chapter 4 Developing Your NI 488 2 Application Device Communication Step 3 Communicate with the Device Communicate with the device by sending it the IDN query and then reading back the response Many devices respond to this query by returning a description of the device Refer to the documentation that came with your GPIB device to see specific instructions on the proper way to communicate with it Step 3a Use ibwrt to send the IDN query command to the device Step 3b Use ibrd to read the response from the device Continue
87. iewing or changing GPIB interface settings 2 9 viewing or changing GPIB ENET 100 network settings configuring network parameters 2 13 updating GPIB ENET 100 firmware 2 14 Message Available bit MAV 8 13 messages sending across GPIB data lines A 3 handshake lines A 3 interface management lines A 3 Microsoft Visual Basic programming instructions 4 15 Microsoft Visual C C programming instructions 4 14 multiple interfaces or multiple devices 4 6 multithreaded NI 488 2 applications writing 8 9 NI 488 2 User Manual l 6 n execute function n times function Interactive Control utility 7 10 n execute previous function n times function Interactive Control utility 7 10 National Instruments GPIB web site 2 13 3 8 support and services E 1 NDAC not data accepted line table A 3 NI Spy utility debugging applications 5 1 6 3 exiting 6 3 locating errors 6 2 monitoring API calls with 6 2 monitoring recording and displaying NI 488 2 calls on Windows 2 8 online help 6 2 overview 6 1 performance considerations 6 3 saving captured data to a file 6 3 starting 6 1 viewing properties for recorded calls 6 3 NI support and services E 1 NI 488 2 common questions D 1 device level calls and bus management 8 11 SRQ and serial polling with device level NI 488 2 calls 8 15 SRQ and serial polling with multi device NI 488 2 calls 8 15 viewing version 2 8 3 5 NI 488 2 API choosing how to access 4 2
88. ility 7 10 filename execute indirect file function Interactive Control utility 7 10 turn ON display function Interactive Control utility 7 10 turn OFF display function Interactive Control utility 7 10 A accessing NI 488 2 driver 4 2 Active Controller A 1 adding new GPIB interface in GPIB Explorer 3 4 in Measurement amp Automation Explorer 2 4 address syntax in Interactive Control utility 7 5 AllSpoll function serial polling multiple devices with a single call 8 17 application debugging global status functions 5 1 NI Spy utility 5 1 NI 488 2 error codes 5 1 application development communicating with instruments multiple interfaces or multiple devices 4 11 single GPIB device 4 9 using Interactive Control utility 4 1 using NI 488 2 Communicator 2 6 general program steps and examples multiple interface or multiple device applications 4 12 single device applications 4 10 National Instruments Corporation items to include multiple interface or multiple device applications 4 11 single device applications 4 9 talker listener applications 8 12 application interfaces 4 2 asynchronous event notification in NI 488 2 applications calling ibnotify function 8 4 ibnotify programming example 8 6 ATN attention line table A 3 ATN status word condition 4 8 B 1 B 4 automatic serial polling enabling 8 13 stuck SRQ state 8 14 autopolling and interrupts 8 14 auxiliary functions Inte
89. 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 THERETOFORE 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 includi
90. ine which device requested service In these examples three devices are present on the GPIB at addresses 3 4 and 5 and the GPIB interface is designated as bus index 0 The first example uses FindRQS to determine which device is requesting service and the second example uses Al1Spo11 to serial poll all three devices Both examples use Wait SRQ to wait for the GPIB SRQ line to be asserted Example 1 Using FindROS This example shows you how to use FindRQS to find the first device that is requesting service void GetASerialPollResponse char DevicePad char DeviceResponse char SerialPollResponse 0 int WaitResult Addr4882_t Addrlist 4 3 4 5 NOADDR WaitSRQ 0 amp WaitResult if WaitResult printf SRQ is asserted n FindROQS 0 AddrList amp SerialPollResponse if Ibsta amp ERR printf Device at pad x returned byte Sx n AddrList Ibcnt int SerialPollResponse DevicePad AddrList Ibcnt DeviceResponse SerialPollResponse return 8 16 ni com Chapter 8 NI 488 2 Programming Techniques Example 2 Using AllSpoll This example shows you how to use Al1Spo11 to serial poll three devices with a single call void GetAllSerialPollResponses Addr4882_t AddrList short ResponseList int WaitResult WaitSRQ 0 amp WaitResult if WaitResult printf SRQ is asserted n AllSpoll 0 AddrList ResponseList if Ibsta amp ERR fo
91. ing properly as follows Windows 1 Select Start Programs National Instruments Measurement amp Automation 2 Select Help Troubleshooting NI 488 2 Troubleshooting Utility Mac OS X Run Applications National Instruments NI 488 2 Troubleshoot Linux Enter the following command lt InstallDir gt natinst ni4882 bin gpibtsw where lt Instal1Dir gt is the directory where you chose to install NI 488 2 The default is usr local C 2 ni com Appendix C Error Codes and Solutions e Use the unit descriptor returned from ibdev or ibfind as the first parameter in subsequent traditional NI 488 2 calls Examine the variable before the failing function to make sure its value has not been corrupted ECIC 1 ECIC is returned when one of the following functions is called while the interface is not CIC e Any device level traditional NI 488 2 calls that affect the GPIB e Any board level traditional NI 488 2 calls that issue GPIB command bytes ibcmd ibcmda ibln and ibrpp e ibcac and ibgts e Any NI 488 2 multi device calls that issue GPIB command bytes Sendcmds PPoll Send and Receive Solutions Possible solutions for this error are as follows e Use ibsic or SendIFC to make the GPIB interface become CIC on the GPIB e Use the IbcSc option in ibconfig to make sure your GPIB interface is configured as System Controller e In multiple CIC situations always be certain that the CIC bit appears in
92. ing this utility refer to Chapter 7 Interactive Control Utility View NI 488 2 Software Version To view the NI 488 2 software version complete the following steps 1 Start Measurement amp Automation Explorer as described in the Starting Measurement amp Automation Explorer section 2 Expand the Software directory by clicking the next to the folder 3 Click NI 488 2 Measurement amp Automation Explorer displays the version number of the NI 488 2 software in the right window pane Monitor Record and Display NI 488 2 Calls To monitor NI 488 2 calls use NI Spy as follows 1 Start Measurement amp Automation Explorer as described in the Starting Measurement amp Automation Explorer section 2 Expand the Devices and Interfaces directory by clicking the next to the folder 3 Select your GPIB interface in the left window pane of Measurement amp Automation Explorer 4 On the toolbar click the NI Spy button to open the application 5 On the NI Spy toolbar click the blue arrow button to start a capture NI 488 2 User Manual 2 8 ni com Chapter 2 Measurement amp Automation Explorer Windows 6 Start the NI 488 2 application that you want to monitor NI Spy records and displays all NI 488 2 calls as shown in Figure 2 4 NI Spy capture on p lol x lal slaj sle aixi 2l 0x0100 0 08 PEPE ibelr UDO 0x0100 0x0004 08 50 08 749 ibwrt UDO IDN 5 0x5 0x0100 0x0005 08 50 14 157
93. ingle GPIB interface is 14 or fewer depending on your system configuration When should I use the Interactive Control utility You can use the Interactive Control utility to test and verify instrument communication troubleshoot problems and develop your application For more information refer to Chapter 7 Interactive Control Utility How do I use an NI 488 2 application interface For information about using NI 488 2 application interfaces refer to Chapter 4 Developing Your NI 488 2 Application What do I need to know to communicate properly with my GPIB instrument Refer to the documentation that came with your instrument The command sequences that you use depend on the specific instrument The documentation for each instrument should include the GPIB commands that you need to communicate with your instrument In most cases device level traditional NI 488 2 calls are sufficient for communicating with instruments For more information refer to Chapter 4 Developing Your NI 488 2 Application National Instruments Corporation D 1 NI 488 2 User Manual Appendix D Common Questions NI 488 2 User Manual How do I check for errors in my NI 488 2 application Examine the value of Ibsta after each NI 488 2 call If a call fails the ERR bit of Ibsta is set and an error code is stored in Iberr For more information about global status functions refer to Chapter 5 Debugging Your Application How do I troubleshoot problems
94. inues until SRQ is unasserted or an error condition is detected 5 To empty the queue use the ibrsp function ibrsp returns the first queued response Other responses are read in first in first out FIFO fashion If the RQS bit of the status word is not set when ibrsp is called a serial poll is conducted and returns the response received To prevent queue overflow empty the queue as soon as an automatic serial poll occurs 6 Ifthe RQS bit of the status word is still set after ibrsp is called the response byte queue contains at least one more response byte If this happens continue to call ibrsp until the RQS bit is cleared from the status word Stuck SRQ State If autopolling is enabled and the GPIB interface detects an SRQ the driver serial polls all open devices connected to that interface The serial poll continues until either SRQ unasserts or all the devices have been polled If no device responds positively to the serial poll or if SRQ remains in effect because of a faulty instrument or cable a stuck SRQ state is in effect If this happens during an ibwait for RQS the driver reports the ESRQ error If the stuck SRQ state happens no further polls are attempted until an ibwait for RQS is made When ibwait is issued the stuck SRQ state is terminated and the driver attempts a new set of serial polls Autopolling and Interrupts If autopolling is enabled the NI 488 2 software can perform autopolling after any device level ca
95. ion project file Direct Entry with C Direct entry is available for only the 32 bit gpib 32 d11 and not for ni4882 d1l The following sections describe how to use direct entry with C gpib 32 dll Exports gpib 32 d11 exports pointers to the global variables and all of the NI 488 2 calls Pointers to the global variables ibsta iberr ibcnt and ibcnt1 are accessible through these exported variables int user_ibsta int user_iberr int user_ibcent long user_ibentl Except for the functions that have string parameters such as ibfind ibrdf and ibwrtf all the NI 488 2 call names are exported from National Instruments Corporation 4 15 NI 488 2 User Manual Chapter 4 Developing Your NI 488 2 Application NI 488 2 User Manual gpib 32 d11 Thus to use direct entry to access a particular function and to get a pointer to the exported function you just need to call GetProcAddress passing the name of the function as a parameter For more information about the parameters to use when you invoke the function refer to the NJ 488 2 Help For instructions on accessing the online help refer to the Using the NI 488 2 Documentation section in About This Manual The functions such as ibfind ibrdf and ibwrt all require an argument that is a name ibfind requires an interface or device name and ibrdf and ibwrtf require a file name Because Windows supports both ASCII 8 bit and Unicode 16 bit characters gpib 32 d11 exports
96. ional Services Visit the following sections of the award winning National Instruments Web site at ni com for technical support and professional services National Instruments Corporation Support Technical support at ni com support includes the following resources Self Help Technical Resources For answers and solutions visit ni com support for software drivers and updates a searchable KnowledgeBase product manuals step by step troubleshooting wizards thousands of example programs tutorials application notes instrument drivers and so on Registered users also receive access to the NI Discussion Forums at ni com forums NI Applications Engineers make sure every question submitted online receives an answer Standard Service Program Membership this program entitles members to direct access to NI Applications Engineers via phone and email for one to one technical support as well as exclusive access to on demand training modules via the Services Resource Center NI offers complementary membership for a full year after purchase after which you may renew to continue your benefits For information about other technical support options in your area visit ni com services or contact your local office at ni com contact Training and Certification Visit ni com training for self paced training eLearning virtual classrooms interactive CDs and Certification program information You also can register for instructo
97. is ready to examine is no longer in a known state and its value is no longer reliable The previous example illustrates a well known multithreading problem It is unsafe to access process global functions from multiple threads of execution You can avoid this problem in two ways e Use synchronization to protect access to process global functions e Do not use process global functions If you choose to implement the synchronization solution you must ensure that the code making NI 488 2 calls and examining the NI 488 2 globals modified by a NI 488 2 call is protected by a synchronization primitive For example each thread might acquire a semaphore before making a NI 488 2 call and then release the semaphore after examining the NI 488 2 globals modified by the call For more information about the use of synchronization primitives refer to your operating system documentation about synchronization objects supported by your operating system If you choose not to use process global functions you can access per thread copies of the NI 488 2 global variables using a special set of NI 488 2 calls Whenever a thread makes an NI 488 2 call the driver keeps a private copy of the NI 488 2 globals for that thread The following code shows the set of functions you can use to access these per thread NI 488 2 global functions unsigned long ThreadIbsta return thread specific Ibsta unsigned long ThreadIberr return thread specific Iberr u
98. ity 7 10 Help See online help high speed data transfers HS488 cable length 8 2 enabling HS488 8 2 system configuration effects 8 3 HS488 See high speed data transfers ibask function 8 3 ibclr function clearing a device 4 10 using in Interactive Control utility example 7 3 Ibcnt or ibent 4 9 ibconfig function determining assertion of EOI line 8 2 enabling autopolling 8 13 enabling high speed data transfers 8 2 ibconfig changing cable length 8 2 ibdev function opening devices 4 10 using in Interactive Control utility example 7 3 ni com Iberr or iberr determining error type 4 8 ibnotify asynchronous event notification 8 4 ibnotify function calling 8 4 programming example 8 6 ibonl function placing device offline 4 11 using in Interactive Control utility example 7 4 ibppc function 8 18 ibrd function reading response from device 4 11 using in Interactive Control utility example 7 3 ibrpp function 8 19 ibrsp function automatic serial polling 8 14 conducting single serial poll 8 15 Ibsta or ibsta bit layout definitions 4 7 B 1 return value information 4 7 ibwait function causing autopolling 8 14 Talker Listener applications 8 12 waiting for GPIB conditions 8 4 ibwrt function sending IDN query to device 4 11 using in Interactive Control utility example 7 3 TEEE 488 and IEEE 488 2 xii IFC interface clear line table A 3 instrument drivers NI resources E 1 In
99. l Measurement amp Automation Explorer Windows This chapter describes Measurement amp Automation Explorer an interactive utility you can use with the NI 488 2 software for Windows Mac OS X and Linux NI 488 2 for Mac OS X and NI 488 2 for Linux have a similar program called GPIB Explorer For more information refer to Chapter 3 GPIB Explorer Mac OS X and Linux Overview You can perform the following GPIB related tasks in Measurement amp Automation Explorer e Establish basic communication with your GPIB instruments e Scan for instruments connected to your GPIB interface e Launch the NI 488 2 Troubleshooting Utility to troubleshoot GPIB and NI 488 2 problems e Launch NI Spy to monitor NI 488 2 or VISA API calls to GPIB interfaces e View information about your GPIB hardware and NI 488 2 software e Reconfigure GPIB interface settings e Locate additional help resources for GPIB and NI 488 2 National Instruments Corporation 2 1 NI 488 2 User Manual Chapter 2 Measurement amp Automation Explorer Windows Starting Measurement amp Automation Explorer To start Measurement amp Automation Explorer select Start Programs National Instruments Measurement amp Automation Figure 2 1 shows Measurement amp Automation Explorer Note You must choose to run as Adminstrator to allow changes to GPIB Interface Settings To do this right click on the Measurement amp Automation Explorer icon and
100. l ibnotify calls are supported by the NI 488 2 driver If you are using device level calls you can call ibnotify with a device handle for ud and a mask of RQS CMPL END or TIMO If you are using board level calls you can call ibnotify with a board handle for ud and a mask of any values except RQS The ibnot ify mask bits are identical to the ibwait mask bits In the example of waiting for your GPIB device to request service you might choose to pass ibnotify a mask with RQS for device level or SRQI for board level The callback function that you register with the ibnotify call is invoked by the NI 488 2 driver when one or more of the mask bits passed to ibnotify is TRUE The callback function is of type GPIBNotifyCallback_t and is defined in the gpib header file ni4882 h The callback function is passed a unit descriptor the current values of the NI 488 2 global variables and the user defined reference data that was passed to the original ibnotify call The NI 488 2 driver interprets the return value for the callback as a mask value that is used to automatically rearm the callback if it is non zero For a complete description of ibnotify refer to the NI 488 2 Help For instructions on accessing the online help refer to the Using the NI 488 2 Documentation section in About This Manual 3 Note The ibnotify callback is executed in a separate thread of execution from the rest of your application If your application will be performing ot
101. lated documentation xiii REM status word condition 4 8 B 1 B 4 removing GPIB interface in Measurement amp Automation Explorer 2 4 REN remote enable line table A 3 repeat addressing 5 3 repeat previous function function Interactive Control utility 7 10 RQS status word condition 4 7 B 1 B 3 S scanning for GPIB instruments 2 5 instruments not found 2 5 too many Listeners on GPIB 2 5 secondary GPIB address A 2 NI 488 2 User Manual Index SendIFC function 4 12 SendList function 4 13 serial polling automatic serial polling 8 13 autopolling and interrupts 8 14 detecting an SRQ state 8 14 service requests IEEE 488 devices 8 13 IEEE 488 2 devices 8 13 using AllSpoll function 8 17 using FindRQS function 8 16 with device level NI 488 2 calls 8 15 with multi device NI 488 2 calls 8 15 service requests serial polling IEEE 488 devices 8 13 IEEE 488 2 devices 8 13 set 488 2 function Interactive Control utility 7 10 set udname function Interactive Control utility 7 10 software NI resources E 1 SRQ service request line table A 4 SRQI status word condition 4 7 B 1 B 3 starting GPIB Explorer 3 2 status of devices or interfaces global functions 4 6 status word Ibsta 4 7 ATN B 4 CIC B 4 CMPL B 3 DCAS B 5 DTAS B 5 END B 2 ERR B 2 Interactive Control utility 7 11 LACS B 5 LOK B 3 REM B 4 RQS B 3 SRQI B 3 NI 488 2 User Manual l 8 status word layout table
102. lication needs Both of these sets the traditional calls and the multi device calls are compatible across computer platforms and operating systems so you can port programs to other platforms with little or no source code modification For most applications the traditional NI 488 2 calls are sufficient If you have a complex configuration with one or more interfaces and multiple devices use the multi device NI 488 2 calls Whichever option you choose bus management operations necessary for device communication are performed automatically The following sections describe some differences between the traditional NI 488 2 calls and the multi device NI 488 2 calls Communicating with a Single GPIB Device If your system has only one device attached to each interface the traditional NI 488 2 calls are probably sufficient for your programming needs A typical NI 488 2 application with a single device has three phases e Initialization use ibdev to get a handle and use ibc1r to clear the device e Device Communication use ibwrt ibrd ibtrg ibrsp and ibwait to communicate with the device e Cleanup use ibon1 to put the handle offline Refer to the sample applications that are installed with the NI 488 2 software to see detailed examples for different GPIB device types For NI 488 2 applications that need to control the GPIB in non typical ways for example to communicate with non compliant GPIB devices there is a set of low level
103. ll provided that no GPIB I O is currently in progress Because the driver uses interrupts an automatic serial poll can occur even when your application is not making any calls to the NI 488 2 software Autopolling can also occur when a device level ibwait for RQS is in progress Autopolling is not allowed when an application calls a board level traditional or multi device NI 488 2 call or the stuck SRQ ESRQ condition occurs NI 488 2 User Manual 8 14 ni com Chapter 8 NI 488 2 Programming Techniques SRQ and Serial Polling with Device Level Traditional NI 488 2 Calls You can use the device level traditional NI 488 2 call ibrsp to conduct a serial poll ibrsp conducts a single serial poll and returns the serial poll response byte to the application If automatic serial polling is enabled the application can use ibwait to suspend program execution until RQS appears in the status word Ibsta The program can then call ibrsp to obtain the serial poll response byte The following example shows you how to use the ibwait and ibrsp functions in a typical SRQ servicing situation when automatic serial polling is enabled include ni4882 h char GetSerialPollResponse int DeviceHandle char SerialPollResponse 0 ibwait DeviceHandle TIMO RQS if Ibsta amp RQS printf Device asserted SRQ n Use ibrsp to retrieve the serial poll response ibrsp DeviceHandle amp SerialPollResponse return Ser
104. llowing steps Non Plug and Play Interfaces For Example GPIB ENET 100 1 Start GPIB Explorer as described in the Starting GPIB Explorer section 2 Click on your GPIB interface and select Delete 3 When prompted click the Yes button to confirm the removal of your interface Plug and Play Interfaces For Example PCI GPIB 1 Close GPIB Explorer if it is running 2 Physically remove the interface from your system making sure to shut down the system if your interface is not hot swappable Refer to the GPIB Hardware Guide for more details on how to do this To view the document you need Acrobat Reader which you can download from www adobe com Mac OS X The GPIB Hardware Guide is installed with NI 488 2 To access this document double click Applications National Instruments NI 488 2 Documentation Linux The GPIB Hardware Guide is installed with NI 488 2 It is in the usr local natinst ni4882 docs directory 3 Start GPIB Explorer as described in the Starting GPIB Explorer section The interface you just removed should not be in the list of configured interfaces View NI 488 2 Software Version To view the NI 488 2 software version complete the following steps 1 Start GPIB Explorer as described in the Starting GPIB Explorer section 2 Launch the About GPIB Explorer window Click Help About GPIB Explorer from the menu bar The About GPIB Explorer window displays the version number of the NI 488 2 softwa
105. lutions Solutions EHDL 23 Ensure that the value being returned by your Callback function is a valid ibnotify mask value Return a zero value from your Callback function to unregister the asynchronous event notification mechanism Then call ibnotify to re enable notification Solutions EWIP 26 EHDL results when an invalid handle is passed to a function call The following are some examples e A valid board handle is passed in as a handle parameter to a device level NI 488 function or a valid device handle is passed in as a handle parameter to a board level NI 488 function e An invalid board or device unit descriptor is passed as input to any NI 488 2 function e A boardID outside the range of 0 99 is passed in to a traditional NI 488 board level function or NI 488 2 routine e ibconfig or ibask is called with a device unit descriptor and a board only configuration option or with a board unit descriptor and a device only configuration option Do not use a device descriptor in a board function or vice versa Make sure that the board index passed to the NI 488 2 call is valid Solutions NI 488 2 User Manual EWIP indicates that an ibwait call is already in progress on the specified unit descriptor This error occurs when one thread within a process calls ibwait ona given descriptor when another thread within the same process is already performing an ibwait using that same descriptor Make sure that for any
106. mechanisms can exhibit differing behaviors on different platforms and thus might not eliminate timing errors 5 2 ni com Chapter 5 Debugging Your Application Communication Errors The following sections describe communication errors you might encounter in your application Repeat Addressing Devices adhering to the IEEE 488 2 standard should remain in their current state until specific commands are sent across the GPIB to change their state However some devices require GPIB addressing before any GPIB activity Therefore you might need to configure your NI 488 2 driver to perform repeat addressing if your device does not remain in its currently addressed state You can either reconfigure from your application using ibconfig or reconfigure using Measurement amp Automation Explorer 3 Note National Instruments recommends using ibconfig to modify the configuration If your application uses ibconfig it works properly regardless of the previous configuration For more information about ibconfig refer to the description of ibconfig in the NMI 488 2 Help For instructions on accessing the online help refer to the Using the NI 488 2 Documentation section in About This Manual Termination Method You should be aware of the data termination method that your device uses By default your NI 488 2 software is configured to send EOI on writes and terminate reads on EOI or a specific byte count If you send a command string to your devic
107. nexistent GPIB interface EOIP 10 Asynchronous I O in progress ECAP 11 No capability for operation EFSO 12 File system error EBUS 14 GPIB bus error ESRQ 16 SRQ stuck in ON position ETAB 20 Table problem ELCK 21 GPIB interface is locked and cannot be accessed EARM 22 ibnotify callback failed to rearm National Instruments Corporation C 1 NI 488 2 User Manual Appendix C Error Codes and Solutions EDVR 0 Table C 1 GPIB Error Codes Continued Error Mnemonic Value Meaning EHDL 23 Input handle is invalid EWIP 26 Wait in progress on specified input handle ERST 27 The event notification was cancelled due to a reset of the interface EPWR 28 The interface lost power Solutions NI 488 2 User Manual EDVR is returned when the interface or device name passed to ibfind or the interface index passed to ibdev cannot be accessed The global function Ibcnt contains an error code This error occurs when you try to access an interface or device that is not installed or configured properly EDVR is also returned if there is an internal driver error Possible solutions for this error are as follows Use ibdev to open a device without specifying its symbolic name Use only device or interface names that are configured in the GPIB Configuration utility as parameters to the ibfind function Use the NI 488 2 Troubleshooting Utility to ensure that each interface you want to access is work
108. ng Test SRQ or WaitSRQ e Address multiple devices to receive a command using SendList You can mix board level traditional NI 488 2 calls with the multi device NI 488 2 calls to have access to all the NI 488 2 functionality Checking Status with Global Functions NI 488 2 User Manual For applications accessing the NI4882 API each NI 488 2 call updates three global functions to reflect the status of the device or board you are using These global status functions are the status word Ibsta the error function Iberr and the count function Ibcnt They contain useful information about the performance of your application Your application should check these functions after each NI 488 2 call For more information about each status function refer to the following sections For applications accessing the older GPIB32 API including the Visual Basic 6 0 application interface use the equivalent global variables These global status variables are the status word ibsta the error variable iberr and the count variables ibent and ibcnt1 ibent is defined to be the type int while ibcnt1 is the size of type long int For all cases 4 6 ni com Chapter 4 Developing Your NI 488 2 Application if the sizes of ibcnt and ibcnt1 are the same ibcnt and ibcnt1 are equal For cross platform compatibility all applications should use ibentl For applications accessing the newer NI4882 API use the global function calls rather than the gl
109. ng photocopying recording storing in an information retrieval system or translating in whole or in part without the prior written consent of National Instruments Corporation National Instruments respects the intellectual property of others and we ask our users to do the same NI software is protected by copyright and other intellectual property laws Where NI software may be used to reproduce software or other materials belonging to others you may use NI software only to reproduce materials that you may reproduce in accordance with the terms of any applicable license or other legal restriction Trademarks National Instruments NI ni com and LabVIEW are trademarks of National Instruments Corporation Refer to the Terms of Use section on ni com legal for more information about National Instruments trademarks Other product and company names mentioned herein are trademarks or trade names of their respective companies Members of the National Instruments Alliance Partner Program are business entities independent from National Instruments and have no agency partnership or joint venture relationship with National Instruments Patents For patents covering National Instruments products technology refer to the appropriate location Help Patents in your software the patents txt file on your media or the National Instruments Patent Notice at ni com patents WARNING REGARDING USE OF NATIONAL INSTRUMENTS PRODUCTS 1 NATIONAL INSTRUMENTS P
110. nsigned long ThreadIbcnt return thread specific Ibcnt In your application instead of accessing the per process NI 488 2 globals substitute a call to get the corresponding per thread NI 488 2 global For example the following line of code if Ibsta amp ERR could be replaced by if ThreadIbsta amp ERR 8 10 ni com Chapter 8 NI 488 2 Programming Techniques B Note Ifyou are using ibnotify in your application refer to the Asynchronous Event Notification in NI 488 2 Applications section of this chapter the ibnotify callback is executed in a separate thread that is created by the NI 488 2 driver Therefore if your application makes NI 488 2 calls from the ibnotify callback function and makes NI 488 2 calls from other places you must use the ThreadIbsta ThreadIberr and ThreadIbcnt functions described in this section instead of the per process NI 488 2 globals Device Level Calls and Bus Management The device level traditional NI 488 2 calls are designed to perform all of the GPIB management for your application However the NI 488 2 driver can handle bus management only when the GPIB interface is CIC Controller In Charge Only the CIC is able to send command bytes to the devices on the bus to perform device addressing or other bus management activities If your GPIB interface is configured as the System Controller default it automatically makes itself the CIC by asserting the IFC line the first
111. o called port address or board address After each NI 488 2 I O call this global variable contains the actual number of bytes transmitted On systems with a 16 bit integer such as MS DOS ibcnt is a 16 bit integer and ibcnt1 is a 32 bit integer For cross platform compatibility use ibcnt1 unless using the newer NI4882 API For accessing the newer NI4882 API use the global function Ibcnt instead After each NI 488 2 call this global function contains the actual number of bytes transmitted The Ibcnt function returns a 32 bit integer For accessing the newer NI4882 API this function is recommended instead of the global variables ibcnt and ibcntl After each NI 488 2 I O call this global variable contains the actual number of bytes transmitted On systems with a 16 bit integer such as MS DOS ibcnt is a 16 bit integer and ibcnt1 is a 32 bit integer For cross platform compatibility use ibcnt1 unless using the newer NI4882 API For accessing the newer NI4882 API use the global function Ibcnt instead A global variable that contains the specific error code associated with a function call that failed For accessing the newer NI4882 API use the global function Iberr instead G 4 ni com Tberr ibsta Ibsta IEEE interface message ISA ist L LAD Listener LLO low level function MAV National Instruments Corporation G 5 Glossary A global function that contains the specific error code associated
112. o that the user does not have to be concerned with bus management or other GPIB protocol matters The GPIB lines that are used to transmit command or data bytes from one device to another Dynamic link library Direct memory access High speed data transfer between the GPIB board and memory that is not handled directly by the CPU Not available on some systems See also programmed I O Device driver software installed within the operating system A message that signals the end of a data string END is sent by asserting the GPIB End or Identify EOD line with the last data byte A GPIB line that signals either the last byte of a data message END or the parallel poll Identify IDY message G 2 ni com EOS or EOS Byte EOT ESB FIFO GET GPIB GPIB address GPIB board GTL H handshake National Instruments Corporation G 3 Glossary A 7 or 8 bit end of string character that is sent as the last byte of a data message End of transmission The Event Status bit Part of the IEEE 488 2 defined status byte which is received from a device responding to a serial poll First in first out Group Execute Trigger The GPIB command used to trigger a device or internal function of an addressed Listener General Purpose Interface Bus This is the common name for the communications interface system defined in ANSI IEEE Standard 488 1 2003 and ANSI IEEE Standard 488 2 1992 The address of a device on t
113. oardId parameter is implied by the Interactive Control prompt therefore it is never included in the call Except for reads the count parameter to calls is unnecessary because buffer lengths are automatically determined by Interactive Control Function return values are handled automatically by Interactive Control In addition to printing out the return ibsta value for the function it also prints other return values If you do not know what parameters are appropriate to pass to a given function call type in the function name and press lt Enter gt The Interactive Control utility then prompts you for each required parameter You can enter numbers in either hexadecimal or decimal format Hexadecimal numbers You must prefix hexadecimal numbers with 0x For example ibpad 0x16 sets the primary address to 16 hexadecimal 22 decimal 7 4 ni com String Syntax Address Syntax Chapter 7 Interactive Control Utility Decimal numbers Enter the number only For example ibpad 22 sets the primary address to 22 decimal You can enter strings as an ASCII character sequence hex bytes or special symbols ASCII character sequence You must enclose the entire sequence in quotation marks Hex byte You must use a backslash character and an x followed by the hex value For example hex 40 is represented by x40 Special symbols Some instruments require special termination or end of string EOS characters that indicate to the d
114. obal variables The global functions replace the global variables with the newer NI4882 API 3 Note If your application is a multithreaded application refer to the Writing Multithreaded NI 488 2 Applications section in Chapter 8 NI 488 2 Programming Techniques Status Word Ibsta All calls update a global status function Ibsta which contains information about the state of the GPIB and your GPIB hardware You can examine various status bits in Ibsta and use that information to make decisions about continued processing If you check for possible errors after each call using the Ibsta ERR bit debugging your application is much easier When using the GPIB32 API ibsta is the global variable Each bit in Ibsta can be set for device level traditional NI 488 2 calls dev board level traditional NI 488 2 calls and multi device NI 488 2 calls brd or all dev brd Ibsta is a 32 bit value A bit value of one 1 indicates that a certain condition is in effect A bit value of zero 0 indicates that the condition is not in effect Table 4 1 shows the condition that each bit position represents the bit mnemonics and the type of calls for which the bit can be set For a detailed explanation of each status condition refer to Appendix B Status Word Conditions Table 4 1 Status Word Layout Bit Hex Mnemonic Pos Value Type Description ERR 15 8000 dev brd NI 488 2 error TIMO 14 4000 dev brd Time limit exceeded END
115. olling using the ibppc function unless the device can configure itself for parallel polling ibppc requires an 8 bit value to designate the data line number the ist sense and whether the function configures the device for the parallel poll The bit pattern is as follows 0 1 1 ES D2 Di DO Eis to disable parallel polling and 0 to enable parallel polling for that particular device S is 1 if the device is to assert the assigned data line when ist is 1 and 0 if the device is to assert the assigned data line when ist is 0 D2 through DO determine the number of the assigned data line The physical line number is the binary line number plus one For example DIO3 has a binary bit pattern of 010 The following example code configures a device for parallel polling using traditional NI 488 2 calls The device asserts DIO7 if its ist is 0 In this example the ibdev command opens a device that has a primary address of 3 has no secondary address has a timeout of 3 s asserts EOI with the last byte of a write operation and has EOS characters disabled include ni4882 h dev ibdev 0 3 0 T3s 1 0 The following call configures the device to respond to the poll on DIO7 and to assert the line in the case when its ist is 0 Pass the binary bit pattern 0110 0110 or hex 66 to ibppc ibppc dev 0x66 If the GPIB interface configures itself for a parallel poll you should still use the ibppc function Pass the interface index or an in
116. ontroller is usually at primary address 0 it sends hex 20 address 0 with bit 5 set to make itself a Listener Figure A 1 shows the configuration of the GPIB address bits Bit Position 7 6 5 4 3 2 1 0 Meaning 0 TA LA GPIB Primary Address range 0 30 Figure A 1 GPIB Address Bits With some devices you can use secondary addressing A secondary address is a number in the range hex 60 to hex 7E When you use secondary addressing the Controller sends the primary talk or listen address of the device followed by the secondary address of the device Sending Messages across the GPIB NI 488 2 User Manual Devices on the bus communicate by sending messages Signals and lines transfer these messages across the GPIB interface which consists of 16 signal lines and 8 ground return shield drain lines The 16 signal lines are discussed in the following sections A 2 ni com Appendix A GPIB Basics Data Lines Eight data lines DIO1 through DIO8 carry both data and command messages Handshake Lines Three hardware handshake lines asynchronously control the transfer of message bytes between devices This process is a three wire interlocked handshake and it guarantees that devices send and receive message bytes on the data lines without transmission error Table A 1 summarizes the GPIB handshake lines Table A 1 GPIB Handshake Lines Line Description NRFD Listening device is r
117. oolbar and then clicking on the area of the screen about which you have a question Locating Errors with NI Spy All NI 488 2 calls returned with an error are displayed in red within the main NI Spy window NI 488 2 User Manual 6 2 ni com Chapter 6 NI Spy Utility Debugging Existing Applications If the application does not have built in error detection handling you can use NI Spy to determine which NI 488 2 call is failing Once you know which NI 488 2 call fails refer to Appendix B Status Word Conditions and Appendix C Error Codes and Solutions for help understanding why the NI 488 2 call failed This information is also available in the N 488 2 Help For instructions on accessing the online help refer to the Using the NI 488 2 Documentation section in About This Manual Viewing Properties for Recorded Calls To see the detailed properties of any call recorded in the main NI Spy window double click on the call The NI Spy Property Sheet window appears It contains general input output and buffer information as applicable to each call Exiting NI Spy When you exit NI Spy its current configuration is saved and used to configure NI Spy when you start it again Unless you save the data captured in NI Spy before you exit that information is lost To save the captured data stop the capture by clicking on the red circled X button on the toolbar Then select File Save As to save the data in a spy file A
118. ose onn eerie secs rcs suscy eons dutevee E E EAE Eea seus eevee evevtegs 8 17 Implementing a Parallel Pollo eee eee eseeseceeetseceseeseeeseeaeceeeeaesneeeaeenaes 8 17 Parallel Polling with Traditional NI 488 2 Calls eee 8 18 Parallel Polling with Multi Device NI 488 2 Calls oo ee 8 19 NI 488 2 User Manual viii ni com Contents Appendix A GPIB Basics Appendix B Status Word Conditions Appendix C Error Codes and Solutions Appendix D Common Questions Appendix E Technical Support and Professional Services Glossary Index National Instruments Corporation ix NI 488 2 User Manual About This Manual This manual describes the features and functions of the NI 488 2 software You can use the NI 488 2 software with Windows 2000 XP Vista Mac OS X and Linux Using the NI 488 2 Documentation Windows Mac OS X Linux The following NI 488 2 documentation is available with your NI 488 2 software distribution CD e The Getting Started Installation Guide briefly describes how to install the NI 488 2 software and your GPIB hardware e This manual describes the features and functionality of the NI 488 2 software e The GPIB Hardware Guide contains detailed instructions on how to install and configure your GPIB hardware This guide also includes hardware specifications and compliance information To view these documents you need Adobe Acrobat Reader which you can download from www adobe com To view
119. ou can access the DLL directly from any programming environment that allows you to request addresses of variables and calls that a DLL exports gpib 32 d11 exports pointers to each of the global variables and all the NI 488 2 calls 4 2 ni com Chapter 4 Developing Your NI 488 2 Application For more information about direct entry access refer to Directly Accessing the gpib 32 dll Exports in the NI 488 2 Help Differences Between the GPIB32 API and NI4882 API The NI 488 2 for Windows 2 6 release has introduced a new API as part of the 64 bit application interface Every effort has been made to have the new NI4882 API closely match the existing GPIB32 API while incorporating API design best practices To use the new API you must recompile applications using the new header and object files The following list describes the major changes in the NI4882 API e Judicious application of the const keyword has been added where appropriate e Wide variants of functions now use the wchar_t instead of unsigned short type e Functions taking in parameters that describe a pointer length now use size_t types e Status variables now use the unsigned long type ThreadIbcnt1 has been removed Macros redirect calls to ThreadIbcnt e Global status functions have been added These are Ibsta Iberr and Ibcnt New code should use these functions instead of ibsta iberr or ibcnt ibentl e Long term deprecated functions have been completely r
120. ove a GPIB Interface NI 488 2 User Manual To remove a Plug and Play interface from your computer disconnect it making sure to turn off the computer if the interface requires it To remove a GPIB ENET 100 interface from your computer you must manually delete it from within Measurement amp Automation Explorer by completing the following steps 1 Start Measurement amp Automation Explorer as described in the Starting Measurement amp Automation Explorer section 2 Expand Devices and Interfaces by clicking the next to the folder 3 Right click on your GPIB ENET 100 interface and select Delete from the context menu 4 When prompted confirm your selection 5 Select View Refresh to update the list of interfaces in Measurement amp Automation Explorer 2 4 ni com Chapter 2 Measurement amp Automation Explorer Windows Scan for GPIB Instruments To scan for instruments connected to your GPIB interface or to add a new instrument to your system complete the following steps 1 Make sure that your instrument is powered on and connected to your GPIB interface Start Measurement amp Automation Explorer as described in the Starting Measurement amp Automation Explorer section Expand the Devices and Interfaces directory by clicking the next to the folder Right click on your GPIB interface and select Scan for Instruments from the drop down menu that appears Measurement amp Automation Explorer di
121. pen either an interface handle or device handle to use for further NI 488 2 calls Use ibdev to open a device handle ibfind to open an interface handle or the set 488 2 command to switch to a 488 2 prompt The following example uses ibdev to open a device assigns it to access interface gpib0 chooses a primary address of 6 with no secondary address sets a timeout of 10 seconds T10s 13 enables the END message and disables the EOS mode ibdev enter board index 0 enter primary address 6 enter secondary address 0 enter timeout 13 enter EOI on last byte flag 1 enter end of string mode byte 0 udo 7 2 ni com Chapter 7 Interactive Control Utility Note If you type a command and no parameters Interactive Control prompts you for the necessary arguments If you already know the required arguments you can type them at the command prompt as follows sibdev 0 6 0 13 1 0 ud0 Note If you do not know the primary and secondary address of your GPIB instrument use Interactive Control to discover it First select 488 2 style by entering set 488 2 where represents the board number 0 99 to which you have connected your device Then use the FindLstn command to discover the address of your device For help using FindLstn enter help findlstn at the command prompt 2 National Instruments Corporation After you successfully complete ibdev you have a ud prompt The new prompt udo represents a devi
122. poration 4 13 NI 488 2 User Manual Chapter 4 Developing Your NI 488 2 Application Language Specific Programming Instructions for Windows The following sections describe how to develop compile and link your Windows NI 488 2 applications using various programming languages Microsoft Visual C C Version 6 0 or Later Before you compile your application include the following line at the beginning of your program include ni4882 h The NIEXTCCOMPILERSUPP environment variable is provided as an alias to the location of C language support files You can use this variable when compiling and linking an application With Microsoft Visual C Version 6 0 or higher to compile and link a Win32 console application named cprog in a DOS shell using the environment variable NIEXTCCOMPILERSUPP type in the following on the command line cl I SNIEXTCCOMPILERSUPP include cprog c SNTEXTCCOMPILERSUPP 11b32 msve ni4882 obj MD With Microsoft Visual C Version 8 0 or higher to compile and link a Win64 console application named cprog in a DOS shell using the environment variable NIEXTCCOMPILERSUPP type in the following on the command line cl I SNIEXTCCOMPILERSUPP include cprog c SNTEXTCCOMPILERSUPP 11b64 msve ni4882 obj MD Borland C C Version 5 0 2 or Later NI 488 2 User Manual Before you compile your Win32 C application make sure that the following line is included at
123. ppear in the right window pane of Measurement amp Automation Explorer as shown in Figure 2 5 GPIBO GPIB USB HS Measurement amp Automation Explorer File Edit View Tools Help loxi Configuration 9 My System Devices and Interfaces SB fGPIBO GPI 5 Instrument 0 RH GPIB1 GPIB ENET 100 H 6 Software 9 Remote Systems Kf Revert Restore Defaults A Scan for Instruments gt Hide Help Name Value Bh Interface Information GPIB Hardware Model Serial Number IP Address General Settings GPIB Interface ID Primary Address Secondary Address System Controller T O Timeout Autopolling Termination Settings Send EOI at End of Write Terminate Read on EOS Instrument GPIB USB HS 011B2453 Not Applicable GPIBO 7 13 10 sec 7 Vv Vv r SAD Identification Instrument 0 GE Properties None National Instrui gt I Back Eal GPIB Interface Basics Use the drop dovm lists checkboxes and text boxes to change the GPIB board settings Select Save when the settings are correct or Revert to go back to the previous settings You can also use the Restore Defaults button to change the board settings to a standard set of values Changes to board settings do not affect open handles to this interface You must close all existing handles to this interface
124. r i 0 AddrList i NOADDR i printf Device at pad x returned byte x n AddrList i ResponseList i return Parallel Polling Although parallel polling is not widely used it is a useful method for obtaining the status of more than one device at the same time The advantage of parallel polling is that a single parallel poll can easily check up to eight individual devices at once In comparison eight separate serial polls would be required to check eight devices for their serial poll response bytes The value of the individual status bit ist determines the parallel poll response Implementing a Parallel Poll You can implement parallel polling with either the traditional or multi device NI 488 2 calls If you use multi device NI 488 2 calls to execute parallel polls you do not need extensive knowledge of the parallel polling messages However you should use the traditional NI 488 2 calls for parallel polling when the GPIB interface is not the Controller and the interface must configure itself for a parallel poll and set its own individual status bit ist National Instruments Corporation 8 17 NI 488 2 User Manual Chapter 8 NI 488 2 Programming Techniques NI 488 2 User Manual Parallel Polling with Traditional NI 488 2 Calls Complete the following steps to implement parallel polling using traditional NI 488 2 calls Each step contains example code 1 Configure the device for parallel p
125. r and application are resynchronized ibstop The I O is canceled the driver and application are resynchronized ibonl The I O is canceled and the interface is reset the driver and application are resynchronized Solutions EFSO 12 ECAP results when your GPIB interface 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 Check the validity of the call or make sure your GPIB interface and the driver both have the needed capability Solutions EFSO results when an ibrdf or ibwrtf call encounters a problem performing a file operation Specifically this error indicates that the function is unable to open create seek write or close the file being accessed Possible solutions for this error are as follows e Make sure the filename path and drive that you specified are correct National Instruments Corporation C 7 NI 488 2 User Manual Appendix C Error Codes and Solutions EBUS 14 e Make sure that the access mode of the file is correct e Make sure there is enough room on the disk to hold the file Solutions ESRQ 16 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 default configuration or the I
126. r led hands on courses at locations around the world System Integration If you have time constraints limited in house technical resources or other project challenges National Instruments Alliance Partner members can help To learn more call your local NI office or visit ni com alliance E 1 NI 488 2 User Manual Appendix E Technical Support and Professional Services If you searched ni com and could not find the answers you need contact your local office or NI corporate headquarters Phone numbers for our worldwide offices are listed at the front of this manual You also can visit the Worldwide Offices section of ni com niglobal to access the branch office Web sites which provide up to date contact information support phone numbers email addresses and current events NI 488 2 User Manual E 2 ni com Glossary Symbol Prefix Value n nano 10 m milli 10 3 M mega 106 A acceptor handshake Listeners use this GPIB interface function to receive data and all devices access board ANSI API application interface ASCII asynchronous automatic serial polling base I O address BIOS board level function National Instruments Corporation G 1 use it to receive commands See also source handshake and handshake The GPIB board that controls and communicates with the devices on the bus that are attached to it American National Standards Institute Application Programming In
127. ractive Control utility 7 10 Borland C C programming instructions 4 14 buffer option function Interactive Control utility 7 10 bus extenders and expanders 1 3 bus management and device level calls 8 11 C CIC status word condition 4 8 B 1 B 4 CMPL status word condition 4 8 B 1 B 3 communicating with instruments advanced communication 2 7 multiple devices 4 6 multiple interfaces 4 6 single GPIB device 4 5 using Interactive Control utility 4 9 NI 488 2 User Manual Index using Measurement amp Automation Explorer 2 6 using NI 488 2 Communicator 2 6 communication errors repeat addressing 5 3 termination method 5 3 configuration See also Interactive Control utility controlling more than one interface 1 1 1 2 errors 5 2 linear and star system configuration figure 1 1 multiboard system example figure 1 2 requirements 1 2 system configuration effects on HS488 1 3 Configure CFGn message 8 3 Configure Enable CFE message 8 3 Controller in Charge CIC active or inactive A 1 bus management 8 11 System Controller as CIC A 1 Controllers definition A 1 conventions used in the manual xii count information in Interactive Control utility 7 12 D data lines A 3 data transfers high speed HS488 terminating 8 1 DAV data valid line table A 3 DCAS status word condition 4 8 B 1 B 5 debugging checking NI 488 2 error codes 5 1 communication errors repeat addressing
128. ration figure 1 1 requirements 1 2 interface management lines A 3 overview A 1 sending messages across A 2 Talkers Listeners and Controllers A 1 GPIB addresses address bit configuration figure A 2 primary and secondary A 2 syntax in Interactive Control utility 7 5 GPIB Configuration utility changing GPIB device templates 2 12 starting 2 12 GPIB device templates modifying 2 12 GPIB Explorer accessing additional help and resources 3 8 GPIB web site 3 8 online help 3 8 adding new GPIB interface 3 4 deleting a GPIB interface 3 5 GPIB interface settings 3 5 3 6 GPIB ENET 100 network settings updating GPIB ENET 100 firmware 3 9 using NI Ethernet Device Configuration utility 3 9 Linux startup screen figure 3 3 Mac OS X startup screen figure 3 2 starting 3 2 viewing NI 488 2 software version 3 5 GPIB Hardware Guide xi GPIB instrumentation information 2 11 GPIB interface settings viewing or changing 3 6 under Mac OS X 3 5 under Windows 2 9 GPIB web site 2 13 3 8 gpib 32 dll exports NI 488 2 User Manual l 4 accessing directly 4 16 using to invoke functions 4 15 GPIB ENET 100 network settings viewing or changing 2 13 3 8 configuring network parameters 2 13 3 9 updating GPIB ENET 100 firmware 2 14 3 9 H handshake lines A 3 help technical support E 1 Help display Interactive Control utility online help function table 7 10 Help option function Interactive Control util
129. rd level functions EADR is also returned by the function ibgts when the shadow handshake feature is requested and the GPIB ATN line is already unasserted In this case the shadow handshake is not possible and the error is returned to notify you of that fact Possible solutions for this error are as follows e Make sure that the GPIB interface is addressed correctly before calling ibrd ibwrt RcvRespMsg or SendDataBytes e Avoid calling ibgts except immediately after an ibcmd call ibcmd causes ATN to be asserted NI 488 2 User Manual EARG results when an invalid argument is passed to a function call The following are some examples e ibconfig with the IbcTMo option called with a value not in the range 0 through 17 e ibconfig with the IbcEOS option called with meaningless bits set in the high byte of the second parameter e ibconfig with the IbcPAD or IbcSAD option called with invalid addresses C 4 ni com Solutions ESAC 5 Appendix C Error Codes and Solutions e ibppc called with invalid parallel poll configurations e A multi device NI 488 2 call made with an invalid address e PPollConfig called with an invalid data line or sense bit Make sure that the parameters passed to the NI 488 2 call are valid Solutions EABO 6 ESAC results when ibsic ibsre SendIFC EnableRemote or the IbcSRE option in ibconfig is called when the GPIB interface does not have System Controller capability
130. re serial poll service request source handshake SPD SPE SRQ National Instruments Corporation G 7 Glossary Parallel Poll Unconfigure The GPIB command used to disable any device from participating in polls Low speed data transfer between the GPIB interface and memory in which the CPU moves each data byte according to program instructions See also DMA When the driver indicates to the application that asynchronous I O operations have completed Request Service Seconds Selected Device Clear The GPIB command used to reset internal or device functions of an addressed Listener See also DCL An object that maintains a count between zero and some maximum value limiting the number of threads that are simultaneously accessing a shared resource The process of polling and reading the status byte of one device at a time See also parallel poll See SRQ The GPIB interface function that transmits data and commands Talkers use this function to send data and the Controller uses it to send commands See also acceptor handshake and handshake Serial Poll Disable The GPIB command used to cancel an SPE command Serial Poll Enable The GPIB command used to enable a specific device to be polled That device must also be addressed to talk See also SPD Service Request The GPIB line that a device asserts to notify the CIC that the device needs servicing NI 488 2 User Manual Glossary status byte sta
131. re installed on your computer National Instruments Corporation 3 5 NI 488 2 User Manual Chapter 3 GPIB Explorer Mac OS X and Linux View or Change GPIB Interface Settings To view or change your interface settings complete the following steps 1 NI 488 2 User Manual Start GPIB Explorer as described in the Starting GPIB Explorer section Click on your GPIB interface and click Properties The Properties dialog box appears Mac OS X Figure 3 3 shows the Properties dialog box for a GPIB ENET 100 for Mac OS X Oc GPIB Configuration f ni a88 2 settings Advanced Network Settings GPIB ENET 100 MiP Address Hostname 137 128 57 39 Interface Name Termination Methods GPIBO iv Send EO at end of Write GPIB Address Terminate Read on EOS Primary E Set EOI with EOS on Write 8 8 bit EOS Compare Secondary 1 O Timeout 10sec iv wv System Controller Help J Cancel ff OK Y s A Figure 3 3 Properties Dialog Box Mac OS X 3 6 ni com Chapter 3 GPIB Explorer Mac OS X and Linux Linux Figure 3 4 shows the Properties dialog box for a GPIB ENET 100 for Linux NI 488 2 Settings Advanced Network Settings yx GPIB ENET 100 i Address Hostname nienetBBSFF9 Interface Mame Termination Methods aries x J7 Send EOI at end of Write GPIB Address I Terminate Read On EOS J Set EOI with EOS on Write 8
132. s reported in the status word Ibsta or ibsta For information about how to use Ibsta or ibsta in your application program refer to the N 488 2 Help For instructions on accessing the online help refer to the Using the NI 488 2 Documentation section in About This Manual Each bit in Ibsta or ibsta can be set for device calls dev board calls brd or both dev brd Table B 1 shows the status word layout Table B 1 Status Word Layout Mnemonic Bit Pos Hex Value Type Description ERR 15 8000 dev brd NI 488 2 error TIMO 14 4000 dev brd Time limit exceeded END 13 2000 dev brd END or EOS detected SRQI 12 1000 brd SRQ interrupt received RQS 11 800 dev Device requesting service CMPL 8 100 dev brd T O completed LOK 7 80 brd Lockout State REM 6 40 brd Remote State CIC 5 20 brd Controller In Charge ATN 4 10 brd Attention is asserted TACS 3 8 brd Talker LACS 2 4 brd Listener DTAS 1 2 brd Device Trigger State DCAS 0 1 brd Device Clear State National Instruments Corporation B 1 NI 488 2 User Manual Appendix B Status Word Conditions ERR dev brd ERR is set in the status word following any call that results in an error You can determine the particular error by examining the error function Iberr Appendix C Error Codes and Solutions describes error codes that are recorded in Iberr along with possible solutions ERR is cleared following any call that does not r
133. see if it is the EOS character NI 488 2 User Manual B 2 ni com SRQI brd Appendix B Status Word Conditions RQS dev SRQI indicates that a GPIB device is requesting service SRQI is set when the GPIB interface is CIC and the GPIB SRQ line is asserted SRQI is cleared either when the GPIB interface ceases to be the CIC or when the GPIB SRQ line is unasserted RQS appears in the status word only after a device level call and indicates that the device is requesting service RQS is set whenever one or more positive serial poll response bytes have been received from the device A positive serial poll response byte always has bit 6 asserted Automatic serial polling must be enabled it is enabled by default for RQS to automatically appear in Ibsta You can also wait for a device to request service regardless of the state of automatic serial polling by calling ibwait with a mask that contains RQS Do not issue an ibwait call on RQS fora device that does not respond to serial polls Use ibrsp to acquire the serial poll response byte that was received RQS is cleared when all of the stored serial poll response bytes have been reported to you through the ibrsp function CMPL dev brd LOK brd CMPL indicates the condition of I O operations It is set whenever an T O operation is complete CMPL is cleared while the I O operation is in progress LOK indicates whether the interface is in a lockout state While LOK is set
134. show up in NI Spy as ibconfig calls This is because macros redirect those calls to use ibconfig Avoid confusion by using ibconfig directly In most cases applications written in the NI4882 API will continue to work on older versions of the NI 488 2 for Windows software back to version 1 7 Certain new ibask and ibconfig options break this backwards compatibility and those options are easily avoidable by using alternative options Existing applications using the GPIB32 API continue to execute unchanged The GPIB32 API will continue to exist but are available only for 32 bit applications Applications written in the NI4882 API compile on both 32 bit and 64 bit environments To port an application to a 64 bit environment requires that the application migrate to the NI4882 API and be recompiled The following NI4882 API constructs break API compatibility with older versions of NI 488 2 for Windows e ibask IbaEOS e ibconfig IbcEOS Mac OS X NI 488 2 has NI488 framework Carbon framework for Mac OS X which you can use from your C C applications 4 4 ni com Chapter 4 Developing Your NI 488 2 Application Linux NI 488 2 has libgpibapi so a dynamic library you can use from your C C applications Refer to the Language Specific Programming Instructions for Linux section for more details on how to develop your application Choosing How to Use the NI 488 2 API The NI 488 2 API has two subsets of calls to meet your app
135. splays the connected instruments in the right window pane Instruments Not Found If Measurement amp Automation Explorer reports that it did not find any instruments make sure that your GPIB instruments are powered on and properly connected to the GPIB interface with a GPIB cable Then scan for instruments again as described in the Scan for GPIB Instruments section Too Many Listeners on the GPIB If Measurement amp Automation Explorer reports that it found too many Listeners on the GPIB refer to the following possible solutions National Instruments Corporation If you have a running GPIB Analyzer with the GPIB handshake option enabled disable the GPIB handshake option in the GPIB Analyzer If you have a GPIB extender in your system Measurement amp Automation Explorer cannot detect any instruments connected to your GPIB interface Instead you can verify communication with your instruments using the Interactive Control utility To do so select Tools NI 488 2 Interactive Control For more information about verifying instrument communication type help at the Interactive Control command prompt 2 5 NI 488 2 User Manual Chapter 2 Measurement amp Automation Explorer Windows Communicate with Your Instrument To establish basic or advanced communication with your instruments refer to the following sections For more information about instrument communication and a list of the commands that your instrument und
136. stant of each bit set in Ibsta e Mnemonic value of the error function Iberr if an error exists the ERR bit is set in Tbsta e Count value for each read write or command function e Data received from your instrument Getting Started with Interactive Control This section shows you how to use the Interactive Control utility to test a sequence of NI 488 2 calls For help on any Interactive Control command type help followed by the command For example type help ibdev or help devclear National Instruments Corporation 7 1 NI 488 2 User Manual Chapter 7 Interactive Control Utility To start the Interactive Control utility complete the following steps Win 1 dows Select Start Programs National Instruments Measurement amp Automation to start Measurement amp Automation Explorer Expand the Devices and Interfaces directory by clicking the next to the folder Right click on your GPIB interface and select Interactive Control from the drop down menu that appears Mac OS X Double click on Applications National Instruments NI 488 2 Interactive Control Linux Enter the following command lt InstallDir gt natinst ni4882 bin gpibintctrl where lt Insta11Dir gt is the directory where you chose to install the NI 488 2 software The default is usr local To use the Interactive Control utility to test a sequence of NI 488 2 calls complete the following steps 1 NI 488 2 User Manual O
137. system configuration gpib0 is a PCI GPIB and is the access interface for the voltmeter gpib1 is a GPIB ENET 100 and is the access interface for the plotter and printer One eee 99999 GPIB z Digital Voltometer Another GPIB Printer Figure 1 2 Example of Multiboard System Configuration Configuration Requirements To achieve the high data transfer rate that the GPIB was designed for you must limit the number of devices on the bus and the physical distance between devices The following restrictions are typical e A maximum separation of 4 m between any two devices and an average separation of 2 m over the entire bus e A maximum total cable length of 20 m e A maximum of 15 devices or controllers connected to each bus with at least two thirds powered on NI 488 2 User Manual 1 2 ni com Chapter 1 Introduction For high speed HS488 operation the following restrictions apply e All devices in the system must be powered on e Cable lengths must be as short as possible with up to a maximum of 15 m of cable for each system e There must be at least one equivalent device load per meter of cable If you want to exceed these limitations you can use a bus extender to increase the cable length or a bus expander to increase the number of device loads You can order bus extenders and expanders from National Instruments National Instruments Corporation 1 3 NI 488 2 User Manua
138. t Entry Wt C rehear weniti sce ieee sa aed Ea EEA E SERE RA 4 15 gpib 32 dll EXports iisi iriri stissi ease ets sess cbdasusss ira ns a aaas 4 15 Directly Accessing the gpib 32 dll Exports ssssssseeeseeeseeesreereeeersees 4 16 Language Specific Programming Instructions for Mac OS X ssseseeesseereerererereesre 4 19 Language Specific Programming Instructions for Linux ssesessseeeseeseersreersrrsreerseesrsee 4 19 Chapter 5 Debugging Your Application NEES DY k are aira aaiae a aa E a a p a aa E g 5 1 Global Status Functions aA aa e e a a EE EE E 5 1 NI 488 2 Error Codes nnna nna a A T A TRAS 5 1 Configuration Errors 2 sione iA cece EE AE A EREE I EEE ERE ERE 5 2 Timing Errors erenn E A A E E TANT 5 2 Comm nicatiom Error Sreser serer oieee i A ee AE EEE EES rE RTE EE aaa 5 3 Repeat Addressing ennenen nam WE nine Wai wil dt tte 5 3 Termination Method sanna eocesvcees tees sts a a t estes venec 5 3 Other Eaa oE led se ceds oda evades aves Soca avec E E ha desiev in eevee E 5 3 Chapter 6 NI Spy Utility CV ELVIS W AET ech feasts clea OE seeeuen sea dveceadoia dec ueutin E EE 6 1 Starting NI SPY 24 sss kets heehee see aE ee A nie Res 6 1 WIDOWS 133 siseesue o i E E AE E E E E ESEE OER EE E ey 6 1 Mac OS X and LINUX o a a incantation ee 6 1 Monitoring API Calls with NI Spy eseeseeeesseessesesesrestsresresrsresresrsresreresresterenresreersresesee 6 2 Using the NI Spy Online Helpisto eiiis irnieneiis irainei aii e a a
139. tSRQ National Instruments Corporation Test for service request 7 9 NI 488 2 User Manual Interactive Control Utility Chapter 7 Interactive Control Utility Table 7 3 Syntax for Multi Device NI 488 2 Calls in Interactive Control Continued Syntax Description TestSys addrlist Cause multiple devices to perform self tests Trigger address Trigger a device TriggerList addrlist Trigger multiple devices WaitSRQ Wait for service request Table 7 4 Auxiliary Functions in Interactive Control Function Description set udname Select active device or interface where udname is the symbolic name of the new device or interface for example dev1 or gpib0 Call ibfind or ibdev initially to open each device or interface set 488 2 v Start using multi device NI 488 2 calls for interface v help Display the Interactive Control utility online help help option Display help information about option where option is any NI 488 2 or auxiliary call for example help ibwrt or help set Repeat previous function Turn OFF display Turn ON display n function Execute function n times where function represents the correct Interactive Control function syntax n Execute previous function n times filename Execute indirect file where filename is the pathname of a file that contains Interactive Control functions to be executed buffer option Set type o
140. teractive Control utility auxiliary functions table 7 10 commands 7 5 communicating with instruments 4 1 4 9 count 7 12 error information 7 11 getting started 7 1 National Instruments Corporation l 5 Index NI 488 2 addresses 7 5 function examples 7 2 numbers 7 4 strings 7 5 overview 7 1 status word Ibsta 7 11 summary 2 7 syntax addresses 7 5 board level traditional NI 488 2 calls table 7 7 device level traditional NI 488 2 calls table 7 6 multi device NI 488 2 calls table 7 9 numbers 7 4 strings 7 5 interface management lines A 3 K KnowledgeBase E 1 L LACS status word condition 4 8 B 1 B 5 Linux GPIB Explorer 3 1 programming instructions 4 19 listen address A 2 Listeners 8 12 A 1 too many found on GPIB 2 5 LOK status word condition 4 8 B 1 B 3 Mac OS X GPIB Explorer 3 1 programming instructions 4 19 Measurement amp Automation Explorer NI 488 2 User Manual Index accessing additional help and resources 2 13 accessing online help 2 13 adding new GPIB interface 2 4 changing GPIB device templates 2 12 communicating with instruments 2 6 enabling disabling NI 488 2 DOS support 2 12 monitoring recording and displaying NI 488 2 calls 2 8 opening screen figure 2 2 overview 2 1 removing GPIB interface 2 4 scanning for GPIB instruments 2 5 starting 2 2 viewing GPIB instrumentation information 2 11 viewing NI 488 2 software version 2 8 v
141. terface Formerly called language interface Code that enables an application program that uses NI 488 2 calls to access the driver American Standard Code for Information Interchange An action or event that occurs at an unpredictable time with respect to the execution of a program A feature of the GPIB software in which serial polls are executed automatically by the driver whenever a device asserts the GPIB SRQ line Also called autopolling See I O address Basic Input Output System A rudimentary function that performs a single operation NI 488 2 User Manual Glossary CFE CFGn CIC CPU D DAV DCL device level function DIO1 through DIO8 DLL DMA driver E END or END Message EOI NI 488 2 User Manual Configuration Enable The GPIB command which precedes CFGn and is used to place devices into their configuration mode These GPIB commands CFG1 through CFG15 follow CFE and are used to configure all devices for the number of meters of cable in the system so HS488 transfers occur without errors Controller In Charge The device that manages the GPIB by sending interface messages to other devices Central processing unit Data Valid One of the three GPIB handshake lines See also handshake Device Clear The GPIB command used to reset the device or internal functions of all devices See also SDC A function that combines several rudimentary board operations into one function s
142. terface unit descriptor value as the first argument in ibppc Also if the individual status bit ist of the interface needs to be changed use the IbcIst option with the ibconfig function 8 18 ni com Chapter 8 NI 488 2 Programming Techniques In the following example the GPIB interface is to configure itself to participate in a parallel poll It asserts DIOS when ist is 1 if a parallel poll is conducted ibppc 0 0x6C ibconfig 0 IbcIst 1 2 Conduct the parallel poll using ibrpp and check the response for a certain value The following example code performs the parallel poll and compares the response to hex 10 which corresponds to DIOS If that bit is set the ist of the device is 1 ibrpp dev amp ppr if ppr amp 0x10 printf ist 1 n 3 Unconfigure the device for parallel polling with ibppc Notice that any value having the parallel poll disable bit set bit 4 in the bit pattern disables the configuration so you can use any value between hex 70 and 7E ibppc dev 0x70 Parallel Polling with Multi Device NI 488 2 Calls Complete the following steps to implement parallel polling using multi device NI 488 2 calls Each step contains example code 1 Configure the device for parallel polling using the PPol1Config call unless the device can configure itself for parallel polling The following example configures a device at address 3 to assert data line 5 DIOS when its ist value is 1 include ni4882 h
143. th a Single GPIB Device This section describes items you should include in your application and provides general program steps with an NI 488 2 example Items to Include Include the following items in your application e Header files In a C application include the header file ni4882 h which contains prototypes for the NI 488 2 calls and constants that you can use in your application e Error checking Check for errors after each NI 488 2 call e Error handling Declare and define a function to handle NI 488 2 errors This function takes the device offline and closes the application If the function is declared as void gpiberr char msg function prototype National Instruments Corporation 4 9 NI 488 2 User Manual Chapter 4 NI 488 2 User Manual Developing Your NI 488 2 Application then your application invokes it as follows if Ibsta amp ERR gpiberr NI 488 2 error General Program Steps and Examples The following steps show you how to use the traditional NI 488 2 device level calls in your application The NI 488 2 software includes the devquery source code example to demonstrate these principles Initialization Step 1 Open a Device Use ibdev to open a device handle The ibdev function requires the following parameters e Connect board index typically 0 for GPIBO e Primary address for the GPIB instrument refer to the instrument user manual or use the FindLstn function to dynam
144. the preferred ibdev to obtain a device handle In new applications avoid using ibfind to obtain device handles and use ibdev instead You can use ibdev to dynamically configure your GPIB device handle ibdev also eliminates unneccessary device name requirements If you must modify a device template run the GPIB Configuration utility 1 Start Measurement amp Automation Explorer as described in the Starting Measurement amp Automation Explorer section Select Help Help Topics NI 488 2 to view the NI 488 2 Help Search for the topic named How do I change a GPIB Device Template and click the link to open the GPIB Configuration utility Double click the device template you want to modify such as DEV1 Rename the template as described in your application documentation Click the OK button twice to save your changes and exit Enable Disable NI 488 2 DOS Support 3 Note NI 488 2 DOS support is not available on Windows Vista or later operating systems To enable or disable NI 488 2 DOS support complete the following steps 1 NI 488 2 User Manual Start Measurement amp Automation Explorer as described in the Starting Measurement amp Automation Explorer section Click on your GPIB interface and select Tools NI 488 2 DOS Support from the Explorer menu Enable or disable DOS support in the NI 488 2 Settings dialog box and click OK If you are prompted to do so restart your system 2 12 ni com Chapter
145. the beginning of your program include ni4882 h The NIEXTCCOMPILERSUPP environment variable is provided as an alias to the location of C language support files You can use this variable when compiling and linking an application 4 14 ni com Chapter 4 Developing Your NI 488 2 Application To compile and link a Win32 console application named cprog in a DOS shell using the environment variable NIEXTCCOMPILERSUPP type in the following on the command line bec32 I SNIEXTCCOMPILERSUPP S include w32 cprog c SNTEXTCCOMPILERSUPP 1ib32 borland ni4882 ob3j Borland CodeGear does not have a 64 bit compiler at the time of this writing Visual Basic Version 6 0 With Visual Basic you can access the traditional NI 488 2 calls as subroutines using the BASIC keyword CALL followed by the traditional NI 488 2 call name or you can access them using the i1 set of functions With some of the NI 488 2 calls for example ibrd and Receive the length of the string buffer is automatically calculated within the actual function or subroutine which eliminates the need to pass in the length as an extra parameter For more information about function syntax for Visual Basic refer to the NI 488 2 Help For instructions on accessing the online help refer to the Using the NI 488 2 Documentation section in About This Manual Before you run your Visual Basic application include the niglobal bas and vbib 32 bas files in your applicat
146. tname Consult your network administrator if you do not know whether your network uses DHCP 1 Start Measurement amp Automation Explorer as described in the Starting Measurement amp Automation Explorer section 2 Expand the Devices and Interfaces directory by clicking the next to the folder National Instruments Corporation 2 13 NI 488 2 User Manual Chapter 2 Measurement amp Automation Explorer Windows 3 Right click on your GPIB ENET 100 interface and select Device Configuration from the drop down menu that appears For more information about the NI Ethernet Device Configuration utility refer to the GPIB ENET 100 information in the GPIB Hardware Guide Update GPIB ENET 100 Firmware You can run the Firmware Update utility in Measurement amp Automation Explorer as follows 1 Start Measurement amp Automation Explorer as described in the Starting Measurement amp Automation Explorer section 2 Expand the Devices and Interfaces directory by clicking the next to the folder 3 Right click on your GPIB ENET 100 interface and select Update Firmware from the drop down menu that appears For more information about the Firmware Update utility refer to the GPIB ENET 100 information in the GPIB Hardware Guide NI 488 2 User Manual 2 14 ni com GPIB Explorer Mac OS X and Linux This chapter describes GPIB Explorer an interactive utility you can use with the NI 488 2 software for Mac OS X and Linux
147. trument Control Before you write your NI 488 2 application you might want to use the Interactive Control utility to communicate with your instruments interactively by typing individual commands rather than issuing them from an application You can also use the Interactive Control utility to learn to communicate with your instruments using the NI 488 2 API For specific device communication instructions refer to the documentation that came with your instrument For information about using the Interactive Control utility and detailed examples refer to Chapter 7 Interactive Control Utility To view the online help for Interactive Control type help at the Interactive Control command prompt Windows 1 2 3 Mac OS X 1 2 National Instruments Corporation Select Start Programs National Instruments Measurement amp Automation to start Measurement amp Automation Explorer Select Tools NI 488 2 Interactive Control At the command prompt type NI 488 2 API calls to communicate interactively with your instrument For example you might use ibdev ibclr ibwrt ibrd and ibonl Double click on Applications National Instruments NI 488 2 Interactive Control At the command prompt type NI 488 2 API calls to communicate interactively with your instrument For example you might use ibdev ibclr ibwrt ibrd and ibonl 4 1 NI 488 2 User Manual Chapter 4 Developing Your NI 488 2 Application Linux 1 To launch t
148. tus word synchronous System Controller T TAD Talker TCT timeout TLC ud UNL UNT NI 488 2 User Manual The IEEE 488 2 defined data byte sent by a device when it is serially polled See Ibsta Refers to the relationship between the GPIB driver functions and a process when executing driver functions is predictable the process is blocked until the driver completes the function The single designated Controller that can assert control become CIC of the GPIB by sending the Interface Clear IFC message Other devices can become CIC only by having control passed to them Talk Address See also MTA A GPIB device that sends data messages to Listeners Take Control The GPIB command used to pass control of the bus from the current Controller to an addressed Talker A feature of the GPIB driver that prevents I O functions from hanging indefinitely when there is a problem on the GPIB An integrated circuit that implements most of the GPIB Talker Listener and Controller functions in hardware Unit descriptor A variable name and first argument of each function call that contains the unit descriptor of the GPIB interface or other GPIB device that is the object of the function Unlisten The GPIB command used to unaddress any active Listeners Untalk The GPIB command used to unaddress an active Talker G 8 ni com Index Symbols repeat previous function function Interactive Control ut
149. with a function call that failed For accessing the newer NI4882 API this function is recommended instead of the global variable iberr At the end of each function call this global variable status word contains status information For accessing the newer NI4882 API use the global function Ibsta instead At the end of each function call this global function contains status information For accessing the newer NI4882 API this function is recommended instead of the global variable ibsta Institute of Electrical and Electronic Engineers A broadcast message sent from the Controller to all devices and used to manage the GPIB Industry Standard Architecture An Individual Status bit of the status byte used in the Parallel Poll Configure function Listen Address See also MLA A GPIB device that receives data messages from a Talker Local Lockout The GPIB command used to tell all devices that they may or should ignore remote GPIB data messages or local front panel controls depending on whether the device is in local or remote program mode A rudimentary board or device function that performs a single operation Meters The Message Available bit is part of the IEEE 488 2 defined status byte which is received from a device responding to a serial poll NI 488 2 User Manual Glossary MLA MSA MTA multitasking NDAC NRFD P parallel poll PC PCI PIO PPC PPD PPE NI 488 2 User Manual
150. www adobe com Mac OS X The GPIB Hardware Guide is installed with NI 488 2 To access this document double click on Applications National Instruments NI 488 2 Documentation Linux The GPIB Hardware Guide is installed with NI 488 2 It is in the usr local natinst ni4882 docs directory NI 488 2 User Manual 3 8 ni com Chapter 3 GPIB Explorer Mac OS X and Linux Device Configuration Mac OS X To run the NI Ethernet Device Configuration utility from the Finder double click on Applications National Instruments NI 488 2 EthernetConfig Linux To run the NI Ethernet Device Configuration utility enter the following command usr local natinst ni4882 bin ethernetconfig For more information about the NI Ethernet Device Configuration utility refer to the GPIB ENET 100 information in the GPIB Hardware Guide Update GPIB ENET 100 Firmware Mac OS X To run the Firmware Update utility double click on Applications National Instruments NI 488 2 FirmwareUpdate Linux To run the Firmware Update utility enter the following command usr local natinst ni4882 bin firmwareupdate For more information about the Firmware Update utility refer to the GPIB ENET 100 information in the GPIB Hardware Guide National Instruments Corporation 3 9 NI 488 2 User Manual Developing Your NI 488 2 Application This chapter describes how to develop an NI 488 2 application using the NI 488 2 API Interactive Ins

NI-488.2 User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents