National Instruments 320727B-01 User Manual

Getting Started with Your GPIB-ENET and

™

the NI-488.2

Part Number 320727B-01

Software for Macintosh

January 1995 Edition

© Copyright 1994, 1995 National Instruments Corporation.

All Rights Reserved.

National Instruments Corporate Headquarters

6504 Bridge Point Parkway
Austin, TX 78730-5039
[phone]
Technical support fax: [phone]

[phone]

Branch Offices:

Australia [phone], Austria [phone], Belgium 02/757.00.20,
Canada (Ontario) [phone], Canada (Québec) [phone],
Denmark 45 76 26 00, Finland (90) 527 2321, France (1) 48 14 24 24,
Germany 089/741 31 30, Italy 02/48301892, Japan [phone],
Mexico 95 800 010 0793, Netherlands 03480-33466, Norway 32-84 84 00,
Singapore 2265886, Spain (91) 640 0085, Sweden 08-730 49 70,
Switzerland 056/20 51 51, Taiwan 02 377 1200, U.K. 0635 523545

Limited Warranty

The GPIB-ENET is warranted against defects in materials and workmanship for a period
of two years from the date of shipment, as evidenced by receipts or other documentation.
National Instruments will, at its option, repair or replace equipment that proves to be
defective during the warranty period. This warranty includes parts and labor.

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 manual is accurate. The
document has been carefully reviewed for technical accuracy. In the event that technical
or typographical errors exist, National Instruments reserves the right to make changes to
subsequent editions of this document without prior notice to holders of this edition. The
reader should consult National Instruments if errors are suspected. In no event shall
National Instruments be liable for any damages arising out of or related to this document
or the information contained in it.

EXCEPT AS SPECIFIED HEREIN, NATIONAL INSTRUMENTS MAKES NO

WARRANTIES
WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE

, EXPRESS OR IMPLIED, AND SPECIFICALLY DISCLAIMS ANY

.

CUSTOMER'S RIGHT TO RECOVER DAMAGES CAUSED BY FAULT OR NEGLIGENCE

ON THE PART OF
THERETOFORE PAID BY THE CUSTOMER
LIABLE FOR DAMAGES RESULTING FROM LOSS OF DATA
PRODUCTS
THE POSSIBILITY THEREOF

NATIONAL INSTRUMENTS SHALL BE LIMITED TO THE AMOUNT

. NATIONAL INSTRUMENTS WILL NOT BE

, PROFITS, USE OF

, OR INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN IF ADVISED OF

. This limitation of the liability of National Instruments will
apply regardless of the form of action, whether in contract or tort, including negligence.
Any action against National Instruments must be brought within one year after the cause
of action accrues. National Instruments shall not be liable for any delay in performance
due to causes beyond its reasonable control. The warranty provided herein does not
cover damages, defects, malfunctions, or service failures caused by owner's failure to
follow the National Instruments installation, operation, or maintenance instructions;
owner's modification of the product; owner's abuse, misuse, or negligent acts; and power
failure or surges, fire, flood, accident, actions of third parties, or other events outside
reasonable control.

Copyright

Under the copyright laws, this publication may not be reproduced or transmitted in any
form, electronic or mechanical, including photocopying, recording, storing in an
information retrieval system, or translating, in whole or in part, without the prior written
consent of National Instruments Corporation.

Trademarks

LabVIEW®, NI-488®, and NI-488.2™ are trademarks of National Instruments
Corporation.

Product and company names listed are trademarks or trade names of their respective
companies.

WARNING REGARDING MEDICAL AND CLINICAL

USE OF NATIONAL INSTRUMENTS PRODUCTS

National Instruments products are not designed with components and testing intended to
ensure a level of reliability suitable for use in treatment and diagnosis of humans.
Applications of National Instruments products involving medical or clinical treatment can
create a potential for accidental injury caused by product failure, or by errors on the part
of the user or application designer. Any use or application of National Instruments
products for or involving medical or clinical treatment must be performed by properly
trained and qualified medical personnel, and all traditional medical safeguards,
equipment, and procedures that are appropriate in the particular situation to prevent
serious injury or death should always continue to be used when National Instruments
products are being used. National Instruments products are NOT intended to be a
substitute for any form of established process, procedure, or equipment used to monitor
or safeguard human health and safety in medical or clinical treatment.

FCC/DOC Radio Frequency Interference Compliance

This equipment generates and uses radio frequency energy and, if not installed and used
in strict accordance with the instructions in this manual, may cause interference to radio
and television reception. This equipment has been tested and found to comply with the
following two regulatory agencies:

Federal Communications Commission

This device complies with Part 15 of the Federal Communications Commission (FCC)
Rules for a Class A digital device. Operation is subject to the following two conditions:

1. This device may not cause harmful interference in commercial environments.

2. This device must accept any interference received, including interference that may

cause undesired operation.

Canadian Department of 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 A prescrites dans le règlement sur le
brouillage radioélectrique édicté par le ministère des communications du Canada.

Instructions to Users

These regulations are designed to provide reasonable protection against harmful
interference from the equipment to radio reception in commercial areas. Operation of
this equipment in a residential area is likely to cause harmful interference, in which case
the user will be required to correct the interference at his own expense.

There is no guarantee that interference will not occur in a particular installation.
However, the chances of interference are much less if the equipment is installed and used
according to this instruction manual.

If the equipment does cause interference to radio or television reception, which can be
determined by turning the equipment on and off, one or more of the following
suggestions may reduce or eliminate the problem.

• Operate the equipment and the receiver on different branches of your AC electrical

system.

• Move the equipment away from the receiver with which it is interfering.

• Reorient or relocate the receiver’s antenna.

• Be sure that the equipment is plugged into a grounded outlet and that the grounding

has not been defeated with a cheater plug.

Notice to user: Changes or modifications 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. Government Printing Office, Washington, DC 20402, Stock
Number 004-000-00345-4.

Contents

About This Manual ............................................................................................. xi

How to Use This Manual Set......................................................................... xi

Organization of This Manual......................................................................... xii

Conventions Used in This Manual................................................................. xiii

Related Documentation ................................................................................. xiii

Customer Communication ............................................................................. xiv

Chapter 1
Introduction

Chapter 2
Hardware Configuration and Installation

............................................................................................................ 1-1

What You Need to Get Started ...................................................................... 1-1

Optional Equipment....................................................................................... 1-2

Multiple-Computer Software License ............................................. 1-2

Software Description ..................................................................................... 1-2

Optional Programming Tools ........................................................................ 1-3

Hardware Description .................................................................................... 1-3

The Top Panel LEDs ....................................................................... 1-4

The Side Panel Connectors ............................................................. 1-5

The Back Panel Switches ................................................................ 1-6

The Bottom Panel Identification Label ........................................... 1-6

................................................. 2-1

Configure the Hardware................................................................................. 2-1

Determine Network Addresses........................................................ 2-1

Configure the DIP Switch ............................................................... 2-2

Select the Operating Mode................................................ 2-3

Select the Method for Configuring the IP Address........... 2-3

Set the Ethernet Port Configuration ................................................ 2-3

Connect the Hardware ................................................................................... 2-4

Step 1. Connect the Cables ........................................................... 2-4

Step 2. Switch on Your GPIB-ENET............................................ 2-5

Chapter 3
Software Installation and Configuration

NI-488.2 Software Components .................................................................... 3-1

Install the Software ........................................................................................ 3-2

Step 1. Install the NI-488.2 Files and Folders ................................ 3-2

Step 2. Run the NI-488 Config Control Panel ............................... 3-4

Step 3. Restart Your Macintosh ..................................................... 3-5

Configure the Software (Optional) ................................................................ 3-6

© National Instruments Corp. vii GPIB-ENET for Macintosh

................................................... 3-1

Contents

Chapter 4
Installation Verification and Troubleshooting

Troubleshooting Hardware Problems ............................................................ 4-1

Verify the Software Installation..................................................................... 4-1

Troubleshooting Software Problems ............................................................. 4-2

READY LED Signaling................................................................................. 4-3

Step 1. Count the Long Flashes..................................................... 4-3

Step 2. Count the Short Flashes .................................................... 4-3

Step 3. Record Your Status Code Number ................................... 4-4

Common Questions ....................................................................................... 4-4

Chapter 5
Using Your NI-488.2 Software

Introduction to IBIC 488.2............................................................................. 5-1

General Programming Considerations........................................................... 5-1

........................................................................ 5-1

Appendix A
Hardware Specifications

................................................................................... A-1

Appendix B
Utilities

...................................................................................................................... B-1

IPassign Utility............................................................................................... B-1

Update Utility................................................................................................. B-2

......................................... 4-1

Appendix C
Customer Communication

............................................................................... C-1

Glossary.................................................................................................................... G-1

Index.......................................................................................................................... I-1

GPIB-ENET for Macintosh v iii © National Instruments Corp.

Contents

Figures

Figure 1-1. GPIB-ENET Top Panel....................................................................... 1-4

Figure 1-2. GPIB-ENET Side Panel ...................................................................... 1-5

Figure 1-3. GPIB-ENET Back Panel..................................................................... 1-6

Figure 1-4. GPIB-ENET Identification Label ....................................................... 1-6

Figure 2-1. Default Mode Switch Settings (All Switches OFF)............................ 2-2

Figure 2-2. Default Ethernet Port Configuration Switch Setting

for Either Type of GPIB-ENET .......................................................... 2-4

Figure 2-3. AUI Ethernet Port Configuration Switch Setting

for Either Type of GPIB-ENET .......................................................... 2-4

Figure 3-1. Settings Dialog Box ............................................................................ 3-3

Figure 3-2. Installation Dialog Box ....................................................................... 3-3

Figure 3-3. File and Folder Organization after Installation ................................... 3-4

Figure 3-4. NI-488 Config Control Panel .............................................................. 3-5

Tables

Table 1-1. LED Descriptions................................................................................ 1-4

Table 2-1. Configuration Parameters for the GPIB-ENET Switches................... 2-2

Table 4-1. Sample READY LED Signals and the Corresponding

Status Code Numbers.......................................................................... 4-4

Table A-1. Electrical Characteristics..................................................................... A-1

Table A-2. Environmental Characteristics............................................................ A-1

Table A-3. Physical Characteristics ...................................................................... A-1

© National Instruments Corp. ix GPIB-ENET for Macintosh

About This Manual

This manual contains instructions for installing and configuring the National Instruments
GPIB-ENET and NI-488.2 software for Macintosh. This manual is meant to be used with
the NI-488.2 User Manual for Macintosh and the NI-488.2 Function Reference Manual
for Macintosh.

This manual assumes that you are familiar with the Macintosh and with Ethernet and
Internet networks, and that your Macintosh is connected to an Ethernet network. This
manual also assumes you have MacTCP installed on your Macintosh, which is required
before you can use the driver software for the GPIB-ENET. You must order the TCP/IP
Connection for Macintosh software separately from Apple Computer, Inc.

How to Use This Manual Set

Getting Started

Manual

Installation and

Configuration

Experienced

Users

Novice

Users

NI-488.2 User

Manual for

Macintosh

Application
Development
and Examples

NI-488.2 Function
Reference Manual

for Macintosh

Function
and Routine
Descriptions

Use this getting started manual to install and configure your GPIB hardware and
NI-488.2 software.

© National Instruments Corp. xi GPIB-ENET for Macintosh

About This Manual

Use the NI-488.2 User Manual for Macintosh to learn the basics of GPIB and how to
develop an application program. The user manual also contains debugging information
and detailed examples.

Use the NI-488.2 Function Reference Manual for Macintosh for specific NI-488 function
and NI-488.2 routine information, such as format, parameters, and possible errors.

Organization of This Manual

This manual is organized as follows:

• Chapter 1, Introduction, lists what you need to get started and optional equipment
you can order, and briefly describes the NI-488.2 software, the GPIB-ENET
hardware, and its assigned Ethernet address.

• Chapter 2, Hardware Configuration and Installation, gives instructions for
configuring the 10Base-T and coax versions of the GPIB-ENET. It also describes
how to connect the GPIB-ENET to a Macintosh computer or local Ethernet network,
switch on the GPIB-ENET, and power on your system.

• Chapter 3, Software Installation and Configuration, contains instructions for
installing and configuring your NI-488.2 software.

• Chapter 4, Installation Verification and Troubleshooting, describes how to verify the
software installation, troubleshoot hardware and software problems, and interpret the
READY LED status messages.

• Chapter 5, Using Your NI-488.2 Software, describes the IBIC 488.2 utility and
lists some general programming considerations.

• Appendix A, Hardware Specifications, lists the electrical, environmental, and
physical characteristics of the GPIB-ENET and the recommended operating
conditions.

• Appendix B, Utilities, contains information on the IPassign and Update utilities
for the GPIB-ENET.

• Appendix C, Customer Communication, contains forms you can use to request help
from National Instruments or to comment on our products and manuals.

• The Glossary contains an alphabetical list and description of terms used in this
manual, including abbreviations, acronyms, metric prefixes, mnemonics, and
symbols.

•The Index contains an alphabetical list of key terms and topics in this manual,
including the page where you can find each one.

GPIB-ENET for Macintosh xii © National Instruments Corp.

About This Manual

Conventions Used in This Manual

The following conventions are used in this manual.
bold Bold text denotes commands, menus, menu items, options,

screen button names, checkboxes, and LEDs.

italic Italic text denotes emphasis, a cross reference, or an

introduction to a key concept.

bold italic Bold italic text denotes a note, caution, or warning.
monospace Text in this font denotes the proper names of programs, utility

names, filenames, folder names, device names, and icon
names.

italic monospace

IEEE 488 and IEEE 488 and IEEE 488.2 refer to the ANSI/IEEE Standard
IEEE 488.2 488.1-1987 and ANSI/IEEE Standard 488.2-1987,

Abbreviations, acronyms, metric prefixes, mnemonics, symbols and terms are listed in
the Glossary.

Italic text in this font denotes that you must supply the
appropriate words or values in the place of these items.

respectively, which define the GPIB.

Related Documentation

The following documents contain information that you may find helpful as you read this
manual:

• ANSI/IEEE Standard 488.1-1987, IEEE Standard Digital Interface for

Programmable Instrumentation

• ANSI/IEEE Standard 488.2-1987, IEEE Standard Codes, Formats, Protocols, and
Common Commands

• ANSI/IEEE Standard 802.3-1988, Information Processing Systems, Local Area
Networks, Part 3

Additionally, you might need to refer to your MacTCP or LocalTalk documentation.

© National Instruments Corp. xiii GPIB-ENET for Macintosh

About This Manual

Customer Communication

National Instruments wants to receive your comments on our products and manuals. We
are interested in the applications you develop with our products, and we want to help 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 C, Customer Communication, at the end of this manual.

GPIB-ENET for Macintosh x iv © National Instruments Corp.

Chapter 1 Introduction

This chapter lists what you need to get started and optional equipment you can order,
gives instructions for inspecting your GPIB-ENET, and briefly describes the NI-488.2
software, the GPIB-ENET hardware, and its assigned Ethernet address.

What You Need to Get Started

One of the following boxes:

GPIB-ENET - 10Base-T Version (100 to 120 VAC)
GPIB-ENET - 10Base-T Version (220 to 240 VAC)
GPIB-ENET - Coax Version (100 to 120 VAC)
GPIB-ENET - Coax Version (220 to 240 VAC)

One of the following power cords:

U.S.A. standard power cord
Switzerland power cord
Australian power cord
Universal European power cord
North American power cord
U.K. power cord

3.5 in. NI-488.2 Software for Macintosh Distribution Disk

TCP/IP driver software installed

MacTCP-TCP/IP Driver Software

© National Instruments Corp. 1-1 GPIB-ENET for Macintosh

Introduction Chapter 1

Optional Equipment

You can call National Instruments to order any of the following optional equipment.

• Ethernet Cables:

Twisted Pair (10Base-T) Cables – 1 m, 5 m, or 10 m
Coax (10Base-2) Cables – 1 m, 5 m, or 10 m
AUI (10Base-5) Cables – 1 m, 5 m, or 10 m

• Shielded GPIB Cables*:

Type X1 Single-Shielded GPIB Cables – 1 m, 2 m, or 4 m
Type X2 Double-Shielded GPIB Cables – 1 m, 2 m, or 4 m

* To meet FCC emission limits for this Class A device, you must use a shielded

(Type X1 or X2) GPIB cable. Operating this equipment with a non-shielded GPIB
cable may cause interference to radio and television reception in commercial areas.

Multiple-Computer Software License

A multiple-computer software license is also available so that one or more hosts on a
single physical network can access one or more GPIB-ENET boxes. Contact National
Instruments for more information regarding the software license.

Software Description

The NI-488.2 software is a comprehensive set of programs and drivers that comes with
your kit. It simplifies the job of programming the GPIB-ENET to function as an IEEE

488.2 (GPIB) Controller with complete communication and bus management capabilities.

The NI-488.2 software also comes with an interactive debugger and the Microsoft
QuickBASIC, Macintosh Programmer's Workshop (MPW) C, THINK C, and
Metrowerks CodeWarrior C language interfaces.

GPIB-ENET for Macintosh 1-2 © National Instruments Corp.