Intel 80188EB User Manual

Intel 80188EB-Based
Fieldbus Round Card

User Manual

80188EB-Based Fieldbus Round Card User Manual

January 1998 Edition

Part Number 321019C-01

© Copyright 1996, 1998 National Instruments Corporation. All rights reserved.

Internet Support

[e-mail]

E-mail: [e-mail]
FTP Site: ftp.natinst.com
Web Address: http://www.natinst.com

Bulletin Board Support

BBS United States: [phone]
BBS United Kingdom: 01635 551422
BBS France: 01 48 65 15 59

Fax-on-Demand Support

[phone]

Telephone Support (U.S.)

Tel: [phone]
Fax: [phone]

International Offices

Australia 03 9879 5166, Austria 0662 45 79 90 0, Belgium 02 757 00 20, Brazil 011 288 3336,
Canada (Ontario) 905 785 0085, Canada (Québec) 514 694 8521, Denmark 45 76 26 00,
Finland0972572511, France0148142424, Germany0897413130,
Hong Kong 2645 3186, Israel 03 6120092, Italy 02 413091, Japan 03 5472 2970,
Korea 02 596 7456, Mexico 5 520 2635, Netherlands 0348 433466, Norway 32 84 84 00,
Singapore 2265886, Spain 91 640 0085, Sweden 08 730 49 70, Switzerland 056 200 51 51,
Taiwan 02 377 1200, United Kingdom 01635 523545

National Instruments Corporate Headquarters

6504 Bridge Point Parkway Austin, TX 78730-5039 Tel: [phone]

Important Information

Warranty

The Fieldbus Round Card is warranted against defects in materials and workmanship for a period of one year 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 an d work manship, fo r a pe riod of 90 days from date of shipment , as evi denced
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 subseq uent editio ns of th is do cum ent wi thout prio r not ice to ho lders of this edit ion. Th e
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.

XCEPT AS SPECIFIED HEREIN

E

SPECIFICALLY DISCLAIMS ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE

USTOMER’S RIGHT TO RECOVER DAMAGES CAUSED BY FAULT OR NEGLIGENCE ON THE PART OF NATIONAL

C

NSTRUMENTS SHALL BE LIMITED TO THE AMOUNT THERETOFORE PAID BY THE CUSTOMER

I

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

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.

ATIONAL INSTRUMENTS MAKES NO WARRANTIES, EXPRESS OR IMPLIED, AND

, N

.

ATIONAL INSTRUMENTS

. N

. This limitation of the liability of National

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

NI-FBUS™ is a trademark 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 perso nnel, and all traditi onal
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.

About This Manual

How to Use the Manual Set..........................................................................................vii

Organization of This Manual........................................................................................viii

Conventions Used in This Manual................................................................................viii

Related Documentation.......................................... .................................. .....................ix

Customer Communication............................................................................................ix

Chapter 1
Introduction

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

Hardware Overview......................................................................................................1-1

Software Overview .......................................................................................................1-2

Chapter 2

Contents

Hardware Installation

Install the Hardware......................................................................................................2-1

Chapter 3
Software Installation

Fieldbus Round Card Interface Kit Components..........................................................3-1

Install the Software.......................................................................................................3-1

Chapter 4
Interfacing to Your Round Card

Interfacing to the Hardware..........................................................................................4-1

Using the Software......................................... ...............................................................4-2

Overview ..................................................................... .................................. .4-2

Developing Your Round Card Application....................................................4-2

Writing Device Templates...............................................................4-3

Converting a Device Template to C Code .......................................4-3

Writing Function Block Callbacks...................................................4-4

Writing userStart and Registering Callbacks...................................4-4

©

National Instruments Corporation v 80188EB-Based Fieldbus Round Card User Manual

Contents

Generating Your Device Configuration........................................... 4-5

Converting Your Device Configuration to C Code......................... 4-5

Compiling, Linking, and Locating Your Program .......................... 4-5

Burn Your Flash ............................................ ... ...............................4-7

Appendix A
Data Link Configuration Section Format

Appendix B
System Management Configuration Section Format

Appendix C
Specifications

Appendix D
Customer Communication

Glossary

Figures

Figure 2-1. Top Side of 80188EB-Based Fieldbus Round Card.............................. 2-2

Figure 2-2. Bottom Side of 80188EB-Based Fieldbus Round Card........................ 2-3

Tables

Table 4-1. Memory Map of Round Card................................................................ 4-7

Table A-1. Valid Variable Names and Values for the Data Link Configuration.... A-1

Table B-1. Valid Variable Names and Values for the MIB Sections......................B-2

Table B-2. Valid Variable Names and Values for the FB Schedule Sections......... B-2

Table C-1. Fieldbu s Round Card Specifications..................................................... C-1

Table C-2. Fieldbu s Round Card Components........................................................ C-1

80188EB-Based Fieldbus Round Card User Manual vi

©

National Instruments Corporation

This manual contains instructions for installing, interfacing to, and
programming the National Instruments Fieldbus Round Card. The
Round Card software is intended for use with Windows 3.x,
Windows 95, or Windows NT.

This manual assumes that you are already familiar with the Windows
operating system you are using.

How to Use the Manual Set

About

This

Manual

Use the
your Fieldbus hardware, the Fieldbus Stack Interface Library, and the
NI-FBUS Function Block Shell software.

Use this
manual to install the Intel 80188EB-based Fieldbus Round Card.

Use the
the Motorola MC68331-based Fieldbus Round Card.

Use the
about writing Function Block server applications that are embedded in
the Fieldbus Round card.

Use the
NI-FBUS Monitor utility with your Fieldbus Round Card.

Use the
use the interactive Fieldbus dialog system with your Fieldbus Round Card.

Use the
NI-FBUS Configurator to configure your Fieldbus network.

Getting Started with Fieldbus

Intel 80188EB-Based Fieldbus Round Card User Manual

MC68331-Based Fieldbus Round Card User Manual

NI-FBUS Function Block Shell Reference Manual

NI-FBUS Monitor User Manual

NI-FBUS Communications Manager User Manual

NI-FBUS Configurator User Manual

manual to install and configure

to install

to learn

to learn to use the interactive

to learn to

to learn to use the

©

National Instruments Corporation vii 80188EB-Based Fieldbus Round Card User Manual

About This Manual

Organization of This Manual

This manual is organized as follows:

• Chapter 1,
includes a brief description of the Fieldbus Round Card hardware
and supplied software.

• Chapter 2,
install your Fieldbus Round Card.

• Chapter 3,
installing the software that came with your Fieldbus Round Card.

• Chapter 4,
connect the Fieldbus Round Card to any external electronics, and
how to develop your Field Device application to interface to the
NI-FBUS Function Block Shell.

• Appendix A,
how to structure the Data Link Configuration section of your
Device Configuration

• Appendix B,
explains how to structure the System Management Configuration
section of your Device Configuration

• Appendix C,
Fieldbus Round Card.

• Appendix D,
use to request help from National Instruments or to comment on our
products and manuals.

Introduction

Hardware Installation

Software Installation

Interfacing to Your Round Card

Data Link Configuration Section Format

System Management Configuration Section Format

Specifications

Customer Communication

, lists what you need to get started and

, contains instructions to help you

, contains instructions for

, describes how to

, explains

.ini file.

,

.ini file.

, describes the characteristics of the

, contains forms you can

Conventions Used in This Manual

The following conventions are used in this manual:

<> Angle brackets enclose the name of a key on the keyboard—for

example, <shift>. Angle brackets containing numbers separated by an
ellipsis represent a range of values associated with a bit or signal
name—for example, DBIO<3..0>.

This icon to the left of bold italicized text denotes a note, which alerts
you to important information.

This icon to the left of bold italicized text denotes a warni ng, which advises
you of precautions to take to avoid being electrically shocked.

©

80188EB-Based Fieldbus Round Card User Manual viii

National Instruments Corporation

About This Manual

bold Bold text denotes the names of menus, menu items, parameters, dialog

box, dialog box buttons or options, icons, windows, Windows 95 tabs,
or LEDs.

bold italic Bold italic text denotes a note, caution, or warning.

italic

italic monospace

monospace Text in this font denotes text or characters that you should literally enter

Italic text denotes emphasis, a cross reference, or an introduction to a
key concept. This font also denotes text from which you supply the
appropriate word or value, as in Windows 3.x.

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

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, and
for statements and comments taken from programs.

Related Documentation

The following document contains information that you may find helpful
as you read this manual:

Fieldbus Foundation Specification

•
items:

Fieldbus Foundation System Management Services

–

Function Block Application Process, Part 1

–

Function Block Application Process, Part 2

–

, which includes the following

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,

©

National Instruments Corporation ix 80188EB-Based Fieldbus Round Card User Manual

Customer Communication

, at the end of this manual.

Chapter

Introduction

This chapter lists what you need to get started and includes a brief
description of the Fieldbus Round Card hardware and supplied
software.

What You Need to Get Started

To install your Fieldbus Round Card Interface Kit, you need the
following items:

• Fieldbus Round Card

• Fieldbus Round Card Interface Kit distribution disk

• Windows 3.x, Windows 95, or Windows NT installed on your
computer

Hardware Overview

The Fieldbus Round Card is a stand-alone card that allows you to
interface to a network that complies with the Fieldbus Foundation H1
specification. The Fieldbus Round Card uses the Intel 80188EB
embedded processor and a programmable 256 KB × 8 Flash to run the
Stack Interface Library, Function Block Shell, and user applications. A
128 KB × 8 SRAM device on the card provides volatile memory.

1

The Intel 80188EB processor supports t wo serial ports. You can use one
serial port as a debug port and connect it to the COM port of the host
running the debugger software. A typical application for the other seri al
port would be to interface to a device running the serial HART protocol
or other proprietary serial protocol. Both serial ports provide
3 V-compatible signals. The Fieldbus Round Card is capable of
providing a 3.9 V at 8 mA power supply to p ower your el ectronics. The
serial ports and the 3.9 V output are accessible from a 2 × 4 female
connector.

©

National Instruments Corporation 1-1 80188EB-Based Fieldbus Round Card User Manual

Chapter 1 Introduction

The Fieldbus Round Card operates under one of two modes: PROG
mode and RUN mode. To select PROG mode, place jumper B on the
card. To select RUN mode, remove jumper B from the card.

When power is applied to the Fieldbus Round Card, th e processor reads
the p o s i t i o n o f j u m p e r B of W1 to check the mode. Whe n t h e c a r d i s i n
PROG mode, you can download your application from th e COM port of
the host computer connected to the debug serial port. When the card is
in RUN mode, the processor begins executing the application that is
loaded in the Flash.

Software Overview

The software supplied with the Fieldbus Round Card Interface Kit
includes the NI-FBUS Function Block Shell, which is an Application
Programmer’s Interface (API) designed to simplify Fieldbus device
development by providing a high-level interface to the Fieldbus
communications stack. In addition, you can use th e ser ial d river API to
make use of the Round Card’s interrupt-driven serial port. The serial
driver supports standard HART commands, as well as generic access to
the serial port to allow any other serial protocols. A linkable library
version of the Fieldbus protocol stack is also supplied. Link your
Function Block application with the Function Block Shell and the
protocol stack before downloading it to your Fieldbus Round Card.

80188EB-Based Fieldbus Round Card User Manual 1-2

©

National Instruments Corporation

Chapter

Hardware Installation

This chapter contains instructions to help you install your Fieldbus
Round Card.

Warning:

Install the Hardware

Several components on your Fieldbus Round Card can be damaged by
electrostatic discharge. To avoid such damage in handli ng the board, touch
the antistatic plastic package to a metal part of your computer chassis
before removing the board from the pa ckage.

Perform the following steps to install the Fieldbus Round Card.

1. Connect the Fieldbus cable to terminal J2 (see Figure 2-1) on the
Round Card. The positive (+) end of the cable should be connected
to terminal 0A and the negative (–) end of the cable should be
connected to terminal 1A . Ensure that the Fieldbus cable is
properly terminated.

2. Press the reset button on the Round Card, S1 (see Figure 2-1), to
reset the processor.

2

©

National Instruments Corporation 2-1 80188EB-Based Fieldbus Round Card User Manual