National Instruments GPIB-PC

Section Four A BASICA/QuickBASIC GPIB-PC Function Calls

©National Instruments Corp. 4A-63 GPIB-PC User Manual

QuickBASIC Version 2.0 or 3.0,

replace line 190 with:

190 CALL IBRDIA (TAPE%,VARPTR(RD%(0)),CNT%)

QuickBASIC Version 4.0,

replace line 190 with:

190 CALL IBRDIA (BD%,RD%(),CNT%)

2. To terminate the read on an end-of-string character, see IBEOS

examples.

Contents

Main Page Limited Warranty Copyright Trademarks WARNING REGARDING MEDICAL AND CLINICAL USE OF NATIONAL INSTRUMENTS PRODUCTS Preface Introduction to the GPIB History of the GPIB The GPIB-PC Family What Your Package Should Contain Who Are Our Users? How to Get Started About the Manual Organization of the Manual Customer Support Contents Section One - Operation of the GPIB Section Two - Installation and Configuration Section Three - GPIB-PC Functions Introduction Page Section Four - GPIB-PC Functions Overview Section Four A - BASICA/QuickBASIC GPIB-PC Function Calls Section Five - IBIC Section Six - Applications Monitor Appendix A - Multiline Interface Messages Appendix B - Common Errors and Their Solutions Page Illustrations Section One - Operation of the GPIB Types of Messages Talkers, Listeners, and Controllers The Controller-In-Charge and System Controller GPIB Signals and Lines Data Lines Handshake Lines Interface Management Lines Physical and Electrical Characteristics Operation of the GPIB Section One Figure 1.1 - GPIB Connector and the Signal Assignment GPIB-PC User Manual 1-6 National Instruments Corp. Page Page Configuration Requirements Related Documents Section Two - Installation and Configuration Installing the Hardware The GPIB-PC Software Package Additional Programs and Files Installing the Software Step 1 - Preparation Step 2 - Run IBSTART Step 3 - Run IBCONF (optional) IBCONF Step 4 - Reboot Step 5 - Test Software Installation More About IBCONF Characteristics of the Instruments Characteristics of each GPIB-PC Default Configurations Primary Default Characteristics Running IBCONF Upper and Lower Levels of IBCONF Page Device and Board Characteristics Page Page Page Exiting IBCONF Page Using Your GPIB-PC Section Three - GPIB-PC Functions Introduction Introduction to the GPIB-PC Functions High-Level Functions Low-Level Functions Calling Syntax Group I IBRD (bd,buf,cnt) IBWRT (bd,buf,cnt) IBFIND (bdname,bd) Group II IBRSP (bd,spr) IBCLR (bd) IBTRG (bd) IBLOC (bd) Group III Page IBTMO (bd,v) IBONL (bd,v) IBPCT (bd) Group IV Purpose of Board Functions Multiboard Capability Page Section Three GPIB-PC Functions Introduction National Instruments Corp. 3-11 GPIB-PC User Manual Boards Devices Figure 3.1 - Multiboard GPIB System Page Page More About Device and Board Functions Group V IBRSV (bd,v) IBLOC (bd) Page Group VI IBEOT (bd,v) Page Section Four - GPIB-PC Functions Overview General Programming Information Status Word Page Page Page Error Codes Page Page Page Page Count Variable Read and Write Termination Device Function Calls Automatic Serial Polling Page Page BASICA Files QuickBASIC Files Programming Preparations for BASICA Programming Preparations for QuickBASIC BASICA/QuickBASIC GPIB-PC I/O Functions BASICA/QuickBASIC "ON SRQ" Capability Page Page Page Page Page New GPIB-PC Functions Page Page GPIB-PC Function Descriptions Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page BASICA/QuickBASIC GPIB Programming Examples Page BASICA Example Program - Device Page BASICA Example Program - Board Page Page QuickBASIC Example Program - Device Page Page QuickBASIC Example Program - Board Page Page Section Five - IBIC Running IBIC ibic Using HELP Using IBFIND :ibfind dev1 :ibfind gpib0 Using IBWRT ibwrt "F3R5T1" ibrd 20 Using IBRD How to Exit IBIC Important Programming Note ibwrt "F3R5T1\r\n" Using SET IBIC Functions and Syntax Other IBIC Functions and Syntax Page Status Word ibwrt "f2t3x" Error Code ibwrt "f2t3x" Byte Count Auxiliary Functions SET (Select Device or Board) HELP (Display Help Information) ! (Repeat Previous Function) ibsic ! - (Turn OFF Display) + (Turn ON Display) n* (Repeat Function n Times) 5*ibwrt "Hello" 20* ! 10* ! $ (Execute Indirect File) $ usrfile 3*$ usrfile PRINT (Display the ASCII String) print "hello" print "and\r\n\x67\x6f\x6f\x64\x62\x79\x65" E or Q (exit or quit) IBIC Sample Programs Device Function Calls ibclr :ibfind dvm Page ibrsp ibrd 18 Board Function Calls ibsre 1 ibcmd "?_@!" ibwrt "F3R7T3" ibcmd "\x08" ibwait (TIMO SRQI) ibcmd "?_\x18A" ibrd 1 ibcmd "\x19" ibrd 20 ibsic Page Section Six - Applications Monitor Installing the Applications Monitor IBTRAP Page Page Applications Monitor Options Page Main Commands Session Summary Screen Configuring the Trap Mask Configuring the Monitor Mode Page Page Multiline Interface Messages Appendix A GPIB-PC User Manual A-2 National Instruments Corp. Multiline Interface Messages Appendix A Multiline Interface Messages National Instruments Corp. A-3 GPIB-PC User Manual Multiline Interface Messages Multiline Interface Messages Appendix A GPIB-PC User Manual A-4 National Instruments Corp. Interface Message Reference List Appendix A Multiline Interface Messages National Instruments Corp. A-5 GPIB-PC User Manual Interface Message Reference List (Continued) EDVR(0) ECIC(1) ENOL(2) EADR(3) EARG(4) ESAC(5) EABO(6) ENEB(7) EOIP(10) ECAP(11) EFSO(12) EBUS(14) ESTB(15) ESRQ(16) Other Error Conditions Page Page Appendix C - Differences Between Software Revisions Revision B and Revision C Interrupts Startup Program Configuration Program Revision C and Revision D Page Appendix D - Using your Printer with the GPIB-PC Installation Page Appendix E - Application Notes Application Note 1 - Computer to Computer Data Transfer ibfind SLAVE ibfind GPIB0:: Step 1. Configure the Computers Step 2. Establish Communication Step 3. Transfer Data ibwrt "hello" ibrd 5 Appendix F Customer Communication Documentation Comment Form Page Glossary Page Page Page Page Page Page Index A B C D E F G H I L M N O P Q R T U W