background image

Appendix A

New NI-488M Functions

© National Instruments Corp.

A-3

AT-GPIB/NI-488M/AT&T UNIX

IBDEV(3)

(continued)

IBDEV(3)

If the 

ibdev

 call fails, a negative number is returned in place of

the device descriptor.  There are two distinct errors that can occur
with the 

ibdev

 call:

If no device is available or the specified 

boardindex

 refers

to a non-existent board, it returns the EDVR error.

If one of the last five parameters is an illegal value, it returns
with a good device descriptor and the EARG error.

Example

ibdev

 opens an available device and assigns it to access 

gpib0

(

boardindex

 = 0) with a primary address of 6 (

pad

 = 

6

), a

secondary address of hex 67 (

sad

 = 

0x67

), a timeout of 10 msec

(

tmo

 = 

7

), the END message enabled (

eot

 = 

1

) and the EOS

mode disabled (

eos

 = 

0

).

if ((ud = ibdev(0,6,0x67,7,1,0)) < 0) {

/* Handle GPIB error here. */
if (iberr == EDVR) {

/* Bad boardindex or no devices
 * available.
 */

}
else if (iberr == EARG) {

/* The call succeeded, but at least one
 * pad, sad, tmo, eos, or eot is incorrect.
 */

}

}

Summary of Contents for 181060-01

Page 1: ... Copyright 1992 1994 National Instruments Corporation All Rights Reserved Getting Started with Your AT GPIB and the NI 488M Software for AT T UNIX System V August 1994 Edition Part Number 320463 01 ...

Page 2: ...fices Australia 03 879 9422 Austria 0662 435986 Belgium 02 757 00 20 Canada Ontario 519 622 9310 Canada Québec 514 694 8521 Denmark 45 76 26 00 Finland 90 527 2321 France 1 48 14 24 24 Germany 089 741 31 30 Italy 02 48301892 Japan 03 3788 1921 Netherlands 03480 33466 Norway 32 848400 Spain 91 640 0085 Sweden 08 730 49 70 Switzerland 056 20 51 51 U K 0635 523545 ...

Page 3: ... National Instruments will pay the shipping costs of returning to the owner parts which are covered by warranty National Instruments believes that the information in this manual is accurate The document has been carefully reviewed for technical accuracy In the event that technical or typographical errors exist National Instruments reserves the right to make changes to subsequent editions of this d...

Page 4: ...er s modification of the product owner s abuse misuse or negligent acts and power failure or surges fire flood accident actions of third parties or other events outside reasonable control Copyright Under the copyright laws this publication may not be reproduced or transmitted in any form electronic or mechanical including photocopying recording storing in an information retrieval system or transla...

Page 5: ...r or application designer Any use or application of National Instruments products for or involving medical or clinical treatment must be performed by properly trained and qualified medical personnel and all traditional medical safeguards equipment and procedures that are appropriate in the particular situation to prevent serious injury or death should always continue to be used when National Instr...

Page 6: ... Communications This device complies with the limits for radio noise emissions from digital apparatus set out in the Radio Interference Regulations of the Canadian Department of Communications DOC Le présent appareil numérique n émet pas de bruits radioélectriques dépassant les limites applicables aux appareils numériques de classe B prescrites dans le règlement sur le brouillage radioélectrique é...

Page 7: ...not expressly approved by National Instruments could void the user s authority to operate the equipment under the FCC Rules If necessary consult National Instruments or an experienced radio television technician for additional suggestions The following booklet prepared by the FCC may also be helpful How to Identify and Resolve Radio TV Interference Problems This booklet is available from the U S G...

Page 8: ...ter 3 Software Installation and Configuration lists all the programs and files located on the distribution disk and contains steps for installing and configuring the NI 488M software and verifying the installation This chapter also contains other useful information including information for getting started with a GPIB application program the steps for removing the NI 488M software and the steps fo...

Page 9: ...erence or an introduction to a key concept monospace Lowercase text in this font denotes text or characters that are to be literally input from the keyboard sections of code programming examples and syntax examples This font is also used for the proper names of disk drives paths directories programs subprograms subroutines device names functions variables filenames and extensions and for statement...

Page 10: ... degrees hex hexadecimal Hz hertz in inches M megabytes of memory m meters percent sec seconds Acronyms The following acronyms are used in this manual ANSI American National Standards Institute DMA direct memory access EMI electromagnetic interference GPIB General Purpose Interface IEEE 488 bus IEEE Institute of Electrical and Electronic Engineers I O input output EOI end or identify VDC volts dir...

Page 11: ... Programmable Instrumentation Customer Communication National Instruments wants to receive your comments on our products and manuals We are interested in the applications you develop with our products and we want to help if you have problems with them To make it easy for you to contact us this manual contains comment and configuration forms for you to complete These forms are in Appendix D Custome...

Page 12: ...rking Directory 3 2 B Install the Utility Files 3 3 C Install the C Library 3 3 D Ensure the Software and Hardware Settings Match 3 4 DMA Channel 3 4 Base I O Address and Interrupt Vector Number 3 5 E Install the NI 488M Driver 3 6 Step 3 Software Configuration 3 6 A Run ibconf 3 7 B Exit ibconf 3 7 Step 4 Installation Verification 3 8 Application Development 3 8 Steps for Removing the NI 488M Sof...

Page 13: ...T GPIB Parts Locator Diagram C 1 Figure C 2 Base I O Address Switch Settings C 4 Figure C 3 Interrupt Jumper Settings C 6 Figure C 4 DMA Channel Jumper Setting C 9 Figure C 5 DMA Jumper Setting for No DMA Channel C 10 Figure C 6 Ground Configuration Jumper Settings C 11 Tables Table 2 1 AT GPIB Default Settings 2 1 Table 3 1 Software Default Settings 3 4 Table C 1 Default Settings and Available Co...

Page 14: ...PC AT a high performance IEEE 488 Controller What Your Kit Should Contain Your NI 488M driver kit should contain the following components Component Part Number NI 488M Software Distribution Disks for the AT GPIB and the AT T UNIX System V 3 5 in Disk 5 25 in Disk 422865 55 420865 55 Getting Started with Your AT GPIB and the NI 488M Software for AT T UNIX System V 320463 01 NI 488M Software Referen...

Page 15: ...munications and bus management capabilities The NI 488M kit also includes a C language interface and an interactive control program Unpacking Your AT GPIB If you have not already unpacked your AT GPIB interface board follow these steps to unpack your board 1 Do not remove the board from its plastic bag at this point 2 Notice that your AT GPIB board is shipped packaged in an antistatic plastic bag ...

Page 16: ...stalling a second board refer to Appendix C to change these settings Otherwise proceed to the next paragraph The AT GPIB can be installed in any unused expansion slot in your computer After you change the settings if needed verify the switches and jumper settings and record the settings on the AT GPIB Hardware and Software Configuration Form located in Appendix D you are ready to install the AT GP...

Page 17: ...e opening on the back panel It may be a tight fit but do not force the board into place Make sure the board is securely installed 5 Screw the AT GPIB mounting bracket to the back panel rail of the computer 6 Replace the top cover 7 Plug the power cord into the wall outlet 8 Turn your computer back on The AT GPIB interface board is now installed and ready for verification testing Proceed to Chapter...

Page 18: ...ser privilege The AT T UNIX Link Kit which is needed for adding device drivers must already be installed Install the Link Kit now if you have not already done so The instructions in this chapter assume that your AT GPIB board is already installed If you have not installed your GPIB board install it now Refer to Chapter 2 Hardware Installation for instructions on how to install your hardware The NI...

Page 19: ...ard calls in C ibtsta Installation test part A ibtstb Installation test part B Step 2 Installation Follow these procedures to install the NI 488M software Note For the remainder of this chapter the word enter indicates that the user must type the indicated command line and press Return A Set Up a Working Directory 1 Log on as root 2 Create a working directory for example usr gpib and change to tha...

Page 20: ...opy files from drive 1 tar xvf dev dsk f1q15dt B Install the Utility Files 1 Copy the file ugpib h to usr include sys by entering the following command cp ugpib h usr include sys 2 Copy the files ibic ibconf ibtsta and ibtstb to a directory in the command search path for example usr bin by entering the following commands cp ibic usr bin cp ibconf usr bin cp ibtsta usr bin cp ibtstb usr bin C Insta...

Page 21: ...ed your hardware with a setting other than the settings shown in Table 3 1 you must also configure the software to match your new setting s Table 3 1 Software Default Settings Software Default Settings Fields gpib0 gpib1 Base I O Address hex Interrupt Vector Number DMA Channel 2C0 11 5 240 10 6 Note The NI 488M software supports two boards gpib0 is the name of the first board and gpib1 is the name...

Page 22: ...ber Open the System file which contains the following lines ib Y 1 6 1 11 2C0 2DF 0 0 ib Y 1 6 1 10 240 25F 0 0 If you installed only one AT GPIB board change only the first line of information The sixth field is the interrupt vector number The seventh field is the starting I O address in hex of the board The eighth field is the ending I O address in hex of the board The seventh and eighth fields ...

Page 23: ...gs for information on changing the hardware settings Refer to Step D Ensure the Software and Hardware Settings Match for information on changing the software settings After the new kernel is successfully built restart the system to run on the new kernel by entering the following commands cd shutdown y g0 i6 Step 3 Software Configuration After the software is installed correctly run the software co...

Page 24: ...el For example if the kernel name is unix new enter the following command ibconf unix new B Exit ibconf Save the current configuration by typing y before exiting ibconf Even if you have not made any changes to the configuration settings you should still type a y to have ibconf create the special device files for example gpib0 gpib1 dev1 dev2 in the dev directory This completes the software install...

Page 25: ...onnect the bus analyzer to the GPIB board and then run ibtstb by entering the following command ibtstb If no error occurs the NI 488M driver is installed correctly Application Development Once the driver software has been installed and verified successfully you are ready to proceed with development of your NI 488M application software The file cib c is the interface between your C language applica...

Page 26: ...teps for Removing the NI 488M Software You may want to remove the NI 488M software at some time Here are the steps for removing the NI 488M software 1 Remove the driver from the kernel Go to the working directory usr gpib that you created earlier in this chapter under Step 2A Set Up a Working Directory and enter the following command ibremove Answer y to all the questions ibremove uses ibrmnod to ...

Page 27: ...d Software Configuration Form located in Appendix D 2 Remove the NI 488M driver with the old configuration by entering the following command ibremove Refer to Steps for Removing the NI 488M Software in this chapter for more information 3 Edit the Master and System files Refer to item 2 of Step 2D Ensure the Software and Hardware Settings Match in this chapter for more information on how to change ...

Page 28: ...e Installation and Configuration National Instruments Corp 3 11 AT GPIB NI 488M AT T UNIX 6 Run ibconf by entering the following command ibconf Refer to Step 3 Software Configuration in this chapter for more information ...

Page 29: ...rp A 1 AT GPIB NI 488M AT T UNIX Appendix A New NI 488M Functions This appendix describes three new NI 488M functions included in the NI 488M software These functions are not described in the NI 488M Software Reference Manual ...

Page 30: ...f String mode and byte respectively Refer to IBPAD IBSAD IBTMO IBEOT and IBEOS in the NI 488M Software Reference Manual for more information on each argument The ibdev command selects an unopened device opens it and initializes it You can use this function in place of ibfind ibdev returns a device descriptor of the first unopened user configurable device that it finds For this reason it is very im...

Page 31: ... EDVR error If one of the last five parameters is an illegal value it returns with a good device descriptor and the EARG error Example ibdev opens an available device and assigns it to access gpib0 boardindex 0 with a primary address of 6 pad 6 a secondary address of hex 67 sad 0x67 a timeout of 10 msec tmo 7 the END message enabled eot 1 and the EOS mode disabled eos 0 if ud ibdev 0 6 0x67 7 1 0 ...

Page 32: ... through 15 contains the GPIB control line state information Bits 16 through 31 are undefined The pattern of the defined bytes is as follows 7 6 5 4 3 2 1 0 EOI ATN SRQ REN IFC NRFD NDAC DAV To determine if a GPIB control line is asserted first check the appropriate bit in the lower byte to determine if the line can be monitored If the bit can be monitored indicated by a 1 in the appropriate bit p...

Page 33: ...T T UNIX IBLINES 3 continued IBLINES 3 Example Test for Remote Enable REN int clines if brd0 ibfind gpib0 0 error if ibsta iblines brd0 clines ERR error if clines 0x10 printf GPIB board cannot monitor REN exit if clines 0x1000 printf REN is asserted exit printf REN is not asserted ...

Page 34: ... sad parameter can be a value in hex 60 to 7E or one of the constants NO_SAD or ALL_SAD You can test for a Listener using only GPIB primary addressing by making sad NO_SAD or you can test all secondary addresses associated with a single primary address a total of 31 device addresses when you set sad ALL_SAD In this case ibln sends the primary address and all secondary addresses before waiting for ...

Page 35: ...I 488M Functions National Instruments Corp A 7 AT GPIB NI 488M AT T UNIX IBLN 3 continued IBLN 3 Example Test for a GPIB Listener at pad 2 and sad 0x60 ibln ud 2 0x60 listen if listen No Listener found at this address ...

Page 36: ...ed IEEE 488 Bus Turbo488 Clock 20 0 MHz NAT4882 Interface Controller Clock 20 0 MHz Transfer Rate Read from GPIB instrument Over 1 Mbytes sec Write to GPIB instrument Over 1 Mbytes sec GPIB commands 350 kbytes sec Actual speed may vary considerably from those shown due to instrumentation capabilities Power Requirement from PC AT I O Channel Bus 5 VDC 0 66A typical 1 50A maximum Physical Dimensions...

Page 37: ...8M AT T UNIX B 2 National Instruments Corp EMI Certification FCC Class B Operating Environment Component Temperature 0 to 70 C Relative Humidity 5 to 90 noncondensing Storage Environment Temperature 55 to 150 C Relative Humidity 5 to 90 noncondensing ...

Page 38: ...ains instructions for changing the configuration settings of your AT GPIB interface board You need to change the configuration settings only if the default settings conflict with another board in your system Figure C 1 shows the location of the AT GPIB configuration jumpers and switches Figure C 1 AT GPIB Parts Locator Diagram ...

Page 39: ... Available Configurations Base I O Address hex 2C0 100 to 3E0 DMA Channel 5 5 6 7 and Not Used Interrupt Line IRQ 11 3 4 5 6 7 9 10 11 12 14 15 and Not Used Base I O Address Selection The base I O address is determined by the switches at position U25 The switches are set at the factory for the base I O address 2C0 hex The AT GPIB uses the I O address space 2C0 through 2DF hex with this setting If ...

Page 40: ...esponds to address line A9 the next switch from the top 2 corresponds to address line A8 and so on The five least significant bits of the address A4 through A0 are used by the AT GPIB to select the appropriate GPIB adapter register and cannot be changed therefore bits A4 through A0 are always 00000 binary when determining the base I O address Press down on the side of the switch marked 1 to select...

Page 41: ...ss down Off 1 On 0 a Switch Set to Match Hardware Default Setting and Software Default Setting for gpib0 Base I O Address 2C0 hex b Switch Set to Match Software Default Setting for gpib1 Base I O Address 240 hex 1 3 2 4 5 9 8 7 6 5 ADDRESS Binary Hex 0 C 2 1 3 2 4 5 9 8 7 6 5 ADDRESS Binary Hex 0 4 2 1 0 1 0 1 1 0 0 0 0 0 0 1 0 0 1 0 0 0 0 0 0 1 0 U25 U25 Figure C 2 Base I O Address Switch Setting...

Page 42: ...10 11 12 14 and 15 If you install more than one AT GPIB interface board in your computer each board must be configured to use a unique interrupt request line The default AT GPIB interrupt request levels for the NI 488M for AT T UNIX software are shown in Table C 3 Table C 3 Default AT GPIB Interrupt Request Lines Board Default IRQ Line First AT GPIB gpib0 11 Second AT GPIB gpib1 10 Note Do not use...

Page 43: ... Jumper Set to Match Software Default Setting for gpib1 IRQ10 a Jumper Set to Hardware Default Setting and Software Default Setting for gpib0 IRQ11 IRQ 15 14 12 11 10 DRQ5 DRQ7 DACK7 DRQ6 DACK6 DACK5 IRQ 15 14 12 11 10 c Jumper Set to Interrupt Level 5 Figure C 3 Interrupt Jumper Settings To change to another interrupt line remove the jumper from its stored position and place it on the new posts ...

Page 44: ...hown in Table C 4 You must change the DMA channel setting on the hardware to match the software DMA channel setting Table C 4 Default AT GPIB DMA Channel Board Default DMA Channel First AT GPIB gpib0 5 Second AT GPIB gpib1 6 Check to determine that the default DMA channel setting is not already used by equipment already installed in your computer If any equipment in your computer uses this DMA cha...

Page 45: ...ACK5 DRQ5 6 DACK6 DRQ6 7 DACK7 DRQ7 You must position two jumpers to select a DMA channel One jumper selects the DMA Request line and the other selects the DMA Acknowledge line You must move these two jumpers as a pair and the DMA Acknowledge and DMA Request lines that you select must have the same numeric suffix for proper operation Figure C 4 shows jumper positions for selecting DMA channels 5 a...

Page 46: ...o Hardware Default Setting and Software Setting for gpib0 DMA Channel 5 Figure C 4 DMA Channel Jumper Setting If you do not want to use DMA for GPIB transfers the AT GPIB alternatively can use programmed I O GPIB transfers you can logically disconnect the AT GPIB from the DMA lines by selecting NONE for the DMA channel of the AT GPIB when you run ibconf refer to Chapter 3 for information on runnin...

Page 47: ... use DMA for GPIB transfers The jumpers can be stored on the board in the positions shown in Figure C 5 Removing the jumpers disables the ability of the AT GPIB to assert a DRQ line on the PC AT I O channel Make sure that you make a corresponding change to the software DMA channel setting during the software installation discussed in Chapter 3 Key used to set the interrupt line DRQ7 DACK7 DRQ6 DAC...

Page 48: ...re C 6 W1 a Connect Logic Ground to Shield Ground default W1 b Disconnect Logic Ground from Shield Ground Figure C 6 Ground Configuration Jumper Settings Note The AT GPIB was tested for compliance with FCC standards with the shield ground connected to logic ground Removing the jumper may cause EMI emissions to exceed any or all of the applicable standards Reset Software Settings and Rebuild Kernel...

Page 49: ...le Monday through Friday from 8 00 a m to 6 00 p m central time In other countries contact the nearest branch office You may fax questions to us at any time Corporate Headquarters 512 795 8248 Technical support fax 800 328 2203 512 794 5678 Branch Offices Phone Number Fax Number Australia 03 879 9422 03 879 9179 Austria 0662 435986 0662 437010 19 Belgium 02 757 00 20 02 757 03 11 Denmark 45 76 26 ...

Page 50: ...ns engineers answer your questions more efficiently If you are using any National Instruments hardware or software products related to this problem include the configuration forms from their user manuals Include additional pages if necessary Name Company Address Fax Phone Computer brand Model Processor Operating system Speed MHz RAM MB Display adapter Mouse yes no Other adapters installed Hard dis...

Page 51: ...National Instruments software product Version Configuration The problem is List any error messages The following steps will reproduce the problem ...

Page 52: ...r current configuration Completing this form accurately before contacting National Instruments for technical support helps our applications engineers answer your questions more efficiently National Instruments Products Hardware AT GPIB Revision Hardware Settings Base I O Address Interrupt Line DMA Channel 1st AT GPIB 2nd AT GPIB Software NI 488M Software Revision Version Number on Distribution Med...

Page 53: ...rsion AT T UNIX System V Version Computer Make and Model Microprocessor Clock Frequency Type of Video Board Installed Type of other boards installed and their respective hardware settings Board Type Base I O Address Interrupt Level DMA Channel ...

Page 54: ...with our products This information helps us provide quality products to meet your needs Title Getting Started with Your AT GPIB and the NI 488M Software for AT T UNIX System V Edition Date August 1994 Part Number 320463 01 Please comment on the completeness clarity and organization of the manual continues ...

Page 55: ...be the errors Thank you for your help Name Title Company Address Phone Mail to Technical Publications National Instruments Corporation 6504 Bridge Point Parkway MS 53 02 Austin TX 78730 5039 Fax to Technical Publications National Instruments Corporation MS 53 02 512 794 5678 ...

Reviews: