Manuals / Brands / Computer Equipment / Webcam / Intel / Computer Equipment / Webcam

Intel 9800758-02 APPENDIXE CALLING NON-BAStC-SO SUBROUTINES

1 118

Download 118 pages, 4.73 Mb

APPENDIXE CALLING NON-BAStC-SO SUBROUTINES

You can write a subroutine in FORTRAN-SO, PL/M':SO,

or

SOSO/SOS5

assembly

language, convert it into relocatable code, load

it

into free memory, and access

it

directly from BASIC-SO. Any number

of

variables can be referenced, following

PL/M

conventions for passing parameters

to

subroutines.

You will need the ISIS-II User's Guide and the publication relevant to the language

you use for the subroutine. The preface lists the Programming and Operator's

manuals for FORTRAN-SO, PL/M-SO, and

SOSO/SOS5

assembly language.

Preparing Subroutines

Once you have written the desired subroutine, follow the instructions in the

appropriate compiler or Assembler Operator's Manual

to

generate object code from

your source language.

The compiler

or

assembler

output

is

a relocatable object code. This code

is

given a

starting address

in

Intellec system memory.

To

do this, you must know the highest

starting address you can use, as well as the total free memory space.

A

4SK

Intellec system has the highest usable address

of

OBEBFH. A

64K

system has

a highest usable address

of

OF6BFH. Higher-addressed memory in both systems

is

taken by the monitor

and/or

monitor RAM.

When you invoke BASIC-SO, it immediately returns the free memory space in bytes.

The size

of

your main program

and

subroutine(s) must

be

less than the free space.

Suppose you have a 64K

system,and

a

2K

byte

(SOOH)

subroutine. The highest

usable memory address

is

OF6BFH.

If

you place your program next to the monitor,

it must start

at

OEECOH. You must

besure

that there

is

2K

of

space available

at

OEECOH,

and you

~ust

forbid

BASIC-SO

to use this space with the MEMTOP

option when you invoke BASIC-SO. MEMTOP specifies the highest

RAlVI

address

BASIC-SO

may use. In the example below, MEMTOP specifies a boundary

at

OEECOH,

leaving the space fromOEECOH-OF6COH for your subroutine.

-:F1

:BASIC MEMTOP

(OEECOH)

ISIS-II BASIC-80

22620

BYTES FREE

If

you invoke BASIC-SO

on

a 64K Intellec System without specifying MEMTOP, it

looks like this:

-:F1:

BASIC

ISIS-II BASIC-80

24668

BYTES FREE

If

you locate your program as high as possible in free memory,

BASIC-SO

can make

the most economical use

of

its remaining workspaces for string constants, variables,

and strings.

E-I

Contents

Main BASIC-SO REFERENCE MANUAL r I ii PREFACE Page CHAPTER! CHAPTER AND APPENDIX CONTENTS 4 RMX/80 HANDLING 5 ILLUSTRATIONS TABLES CHAPTER 1 INTRODUCTION TO BASIC-80 Operating System Interface Invoking BASIC-80 Examples Manipulating Files from BASIC-SO Listing the Directory of "filename", to a Disk 4"4;0"1" CHAPTER 2 LANGUAGE ELEMENTS Instructions Commands Statements Language Elements BASIC-80 Table 2-1. BASIC-80 Commands 2-2 (Cont'd.) Table 2-2. BASIC-80 Statements BASIC-SO Table 2-2. BASIC-80 Statements Language Elements = (Cont'd.) Table 2-3. BASIC-80 Functions Table 2-3. BASIC-80 Functions (Cont'd.) Returns Example Functions Representing Data Syntax Numeric Data Constants o. Integer Constants Decimal Integer Constants Hexadecimal Integer Constants Octal Integer Constants Variables AI String Data String Constants String Variables Converting Data l4! (l4) Array Variables Y(I,1) String Arrays 8. If of Order Operators and Precedence of Evaluation Arithmetic Operators Relational Operators Logical Operators String Operator Expressions Numeric Expressions String Expressions CHAPTER 3 ENTERING AND EDITING PROGRAMS Entering Instruction Lines Correcting Entry Errors Editing Program Text D Subcommand [integer] D L Subcommand I Subcommand H Subcommand X Subcommand S Subcommand K Subcommand C Subcommand Q Subcommand Carriage A Subcommand 40. CHAPTER 4 ERROR HANDLING + = Error Error Trapping ? ? 3 -3 Trace Facility Error Simulation B = A Restarting Program Execution CHAPTER 5 DISK FILE INPUT/OUTPUT Sequential File 1/0 Opening a Sequential File Writing to a Sequential File Reading from a Sequential File Closing a Sequential File Random File I/O Defining a Random 110 Buffers FILE "rMBER 3 Opening and Closing a Random Disk File Reading from a Random File ="; 1/0 Writing to a Random File = ATTRIB CHAPTER 6 COMMANDS J[, ":Fdrive AND STATEMENTS "W1" CLOSE [,[1] CONT DATA I I DEF FN(X) DEFSNG DEFDBL DEFSTR DEFINT DEFUSRn =" "; = DIM DIR O. will + ";8;" EXIT FIELD 110 number of characters AS string variable [,number of characters AS string variable] ... FOR-NEXT-STEP GET [I] file number [,record number] GOSUB line number IF-THEN-ELSE ? INPUT Ok KILL LET LINE INPUT LIST LOAD LSET, RSET = 10 CO MERGE NEW NEXT NULL ERROR ON GOTO ON ... GOSUB ON ... "#" GOTO OPEN OPTION BASE OUT POKE PRINT [II "!"; I;] ... PRINT USING Numeric fields tttt PRUN PUT RANDOMIZE >= READ REM B+C)/3 RENAME RENUM A RESUME RETURN A=11 220 RUN numberlstring RUN IN BREAK TRON, STOP SWAP TROFF WAIT WIDTH ABS CHAPTER 7 FUNCTIONS ?5 Ase ATN ?5 COBl 10 CHR$ A#=1/3 CINT cos 10 1 2 3 AO/o .1666667 ERL 1/0 ERR X/Y <> EXP ? Ok FRE HEXS INP "1", = INPUTS INT ? ? LEFT$ = LEN LOC LOF LOG MID$ [,J]) = MKI$ MKS$ MKD$ OCT$ PEEK P~S RIGHTS = RND o SIN ?8 SPACES NOTE saR STRINGS OK STR$ = TAB 1 TAN 4 USRn VAL VARPTR APPENDIX A BASIC-SO ERROR CODES A-I Error BASIC-80 < Table O. 0, Error APPENDIX B BASIC-SO RESERVED WORDS Page APPENDIX C BASIC-80 COMMAND CHARACTERS Page D-l. * = > Table < Table D-2. ASCII D-2 FS Codes BASIC-SO Code APPENDIXE CALLING NON-BAStC-SO SUBROUTINES Preparing Subroutines NOTE Calling Subroutines ~~D~ESS ILS_f_I~~I Numbers and Strings of Figure B-1. Internal Representation Some Real Examples BASIC-SO Calling Non-BASIC-SO Subroutines E9 E-5 EXTERNAL o E.H o Figure E-2. 8080/8085 Assembly Language Program Calling a Non-BASIC-SO BASIC-SO Program Figure E-4. FORTRAN-80 APPENDIX F RMX/SO BASIC-SO RMX/80 is What Initializing the SO/30 Predefined RMX/SO BASIC-SO Configuration Single Board Computer Hardware Reference Manual, chapter 2. Table F-l. Reference Manual for details). The supplied cable attaches from iSBC RAM RMX/SO RMX/80 Generating for Software Requirements Generating a Boot-Loaded RMX/80 BQOPS.ASM BASIC-80 CPU BOOTED CONTR UIO HIRAM BOTMEM PROM Programming Manual for details) User's Guide for further information.) RMX/80 Generating a PROM-Based Reference Manual shows one way to RMX/80 BASIC-80 o Configuring PROM-Based With or Without DFS. iSBC An o Page Configuring on an iSBC an Adding BASIC-SO to DFS Public Variables and Linking 13,10,26 Adding RMX/SO to Programs BASIC-SO Adding USR BASIC-SO Adding liD Drivers to I/O User-Written Figure F-S. Sample User-Written F-15 RMX/80 1/0 BASIC-SO Altering BASIC-80 Workspace Burning a BASIC-80 Program Into PROM PROM Program- mer Reference Manual, 9800133F. PROM Universal Mapper Operator's Manual, 9S00236A. Page INDEX Index BASIC-SO Ase, 110 # REQUEST COMMENTS READER'S FOR BUSIN ESS REPLY NO U.S.A. IN MAIL Page INTEL