This manual, Writing FCode 3.x Programs, replaces all previous manuals describing writing FCode programs. IEEE Standard 1275-1994 is based on the Sun(TM) OpenBoot(TM) 2.x implementation. OpenBoot 3.x from Sun is compliant with IEEE Standard 1275.
Throughout this book, the reference to FCode PROM might refer to any type of ROM device (ROM, PROM, FlashPROM, etc.).
This manual is written for designers of SBus interface cards and other devices that use the FCode programming language. It is written for those designers who have some familiarity with SBus card design requirements and Forth programming. The sample code in this book is not guaranteed to be free of bugs.
The material in this manual is for developers of FCode applications for SBus peripherals on OpenBoot 3.x. With proper programming precautions, these applications should run on OpenBoot 3.x and earlier versions. By following the IEEE 1275 standard, the same FCode application can also run on non-SPARC systems which are IEEE 1275-compliant. The FCode language is defined by IEEE Standard 1275-1994 Standard for Boot Firmware.
This manual is written for designers who have read and understood the corresponding SBus specifications and SBus binding to IEEE Standard 1275- 1994 1.2 (or later).
This manual does not cover all you need to know to write FCode drivers for SBus cards. The following books are also useful.
For information about SBus and OpenBoot:
For further information about Forth and Forth programming:
The SBus/SCSI developer's Kit, Release III (ISBN 0-13-107202-1) consists of four manuals:
This kit is available at PTR PH Magnet Stores, or directly from Prentice Hall. For single copies, phone 515/284-6751, fax 515/284-2607 or e-mail orders@prenhall.com. For quantity orders of more than 10 books, phone 201/592- 2498, fax 201/592-2249. International customers: Simon & Schuster International, Customer Service, Attention: Joanne Edwing, 200 Old Tappan Road, Old Tappan, NJ 07675, phone 201/767-4990, fax 201/767-5625. The individual manuals are available through local technical bookstores worldwide.
------------------------------------------------------------------------------------------------------------------------------------------------------------
Typeface or Meaning Example Symbol ------------------------------------------------------------------------------------------------------------------------------------------------------------
AaBbCc123 The names of commands, files, and directories; Edit your .login file.
on-screen computer output
Use ls -a to list all files.
system% You have mail.
AaBbCc123 What you type, contrasted with on-screen system% su
computer output
Password:
AaBbCc123 Variable: replace with a real name or value To delete a file, type rm filename.
AaBbCc123 Book titles, new words or terms, or words to be Read Chapter 6 in User's Guide.
emphasized
These are called class options.
You must be root to do this.
Code samples are included in boxes and may display the following:
ok The OpenBoot Forth Monitor prompt ok
% UNIX C shell prompt system%
$ UNIX Bourne and Korn shell prompt system$
# Superuser prompt, all shells system#
------------------------------------------------------------------------------------------------------------------------------------------------------------
These typographic conventions are also used in this manual:
To enter Control-C, press and hold Control, then press C, then release both keys.
To enter Escape B, press and release Escape, then press and release B.
cd [directory]
The SunDocs Order Desk is a distribution center for Sun Microsystems technical documentation. You can use major credit cards and company purchase orders. You can order documentation in the following ways:
------------------------------------------------------------------------------
In the U.S.A. Outside the U.S.A. ------------------------------------------------------------------------------
Call 1-800-247-0250 Call 1-801-342-3450
Fax 1-801-373-6798 Fax 1-801-373-6798
World Wide Web: http://www.sun.com/sundocs/catalog.html
------------------------------------------------------------------------------
Please use the Reader Comment Card that accompanies this document. We are interested in improving our documentation and welcome your comments and suggestions.
You can also email or fax your comments to us. Please include the part number of your document in the subject line of your email or fax message.