This manual, Writing FCode Programs, replaces both Writing FCode Programs for SBus Cards and Writing FCode 2.0 Programs.
This manual is written for designers of SBus interface cards and other devices that use the FCode interface language. It assumes that you have some familiarity with SBus card design requirements and Forth programming.
The material covered in this manual is specifically for those developing FCode applications on OpenBoot 2.0 or later SPARCsystems, and those developing SBus cards for either OpenBoot 2.0 only or both OpenBoot 1.0 and OpenBoot 2.0 and later systems.
This manual also assumes that you have read and understood SBus Specification B.0 (or later) and OpenBoot Command Reference.
This manual does not pretend to cover everything you need to know to write FCode drivers for SBus cards. You'll have to read some other books, too.
For information about SBus, OpenBoot 2.0, SBus device drivers, and writing device drivers for Sun workstations, see the following Sun manuals:
For more information about Forth and Forth programming, see:
Some programs specifically mentioned in this manual for use in developing FCode programs are included on a diskette in the SBus Developer's Kit. Instructions for using these programs are included on the diskette.
If you don't have access to a complete SBus Developer's Kit, or if your SPARCstation doesn't have a diskette drive, contact the Sun SBus Technical Support Group (sbustech@Sun.com) for the software.
The following table describes the typeface changes and symbols used in this book.
Table P-1 Typographic Conventions
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------
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 Command-line placeholder: To delete a file, type rm filename.
replace with a real name or value
AaBbCc123 Book titles, new words or terms, or words to be Read Chapter 6 in User's Guide. These are called
emphasized class options.
You must be root to do this.
Code samples are included in boxes and may display the following:
% UNIX C shell prompt system%
ok OpenBoot command prompt ok
$ UNIX Bourne and Korn shell prompt system$
# Superuser prompt, all UNIX shells system#
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------
This manual follows a number of typographic conventions:
Press the Control-C key.
When you see two key names separated by a dash, press and hold the first key down, then press the second key. For example:
To press Control-C, press and hold Control, then press C.
cd [directory]