Intel 9800758-02 manual Appendixe

Page 87

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

Image 87

Contents BASIC-SO Reference Manual A108/0979/7500 FL Preface Page Contents Illustrations Invoking BASIC-80 Chapter Introduction to BASIC-80Filename ExamplesIntroduction to BASIC-80 Basic filename MEMTOPaddressDeleting a File Listing the Directory of a DiskRenaming a File Changing File AttributesSave LP ,A You can now run, list, or edit the programStatements CommandsBASIC-80 Statements BASIC-80 Commands ContdBASIC-80 Functions BASIC-80 Statements ContdBASIC-80 Functions Contd Functions Representing DataHexadecimal Integer Constants ConstantsInteger Constants Decimal Integer ConstantsOctal Integer Constants Single-Precision Floating-Point ConstantsDouble-Precision Floating-Point Constants $ = Enter next data string String ConstantsString Variables This is a string constantYI,1 L4! = Csng l4String Arrays BASIC-SO Operators in Order of Precedence Contd Arithmetic OperatorsString Expressions Logical OperatorsString Operator Numeric ExpressionsEntering and Editing Programs 30 A--=8xx*522537 Control-R a = 8*37 30 A=8*5230 A=8 30 A=8*52 30 A=8*37If AB then SubcommandCommand 3D press 3, then D results Integer DIf AB then 120 Else Null SET At this point, the other editing subcommands may be used Syntax of the X subcommand isPrint Undefined SET. Enter a L Print Undefined SET The E subcommand is enteredInteger C character character Move the cursor to PRINT. Enter 2C RE LBASIC-80 Error Messages Syntax Error MessagesOverflow, Underflow, and Divide-by-Zero Error Trapping Trace Facility If line 40 is replaced with Error SimulationError Handling Restarting Program ExecutionOpen 1,#1,F1DATES Opening a Sequential FileIf executed four times, it would read all eight values Refer to for further details of Print UsingWriting to a Sequential File Reading from a Sequential FileValue of R$ would be Closing a Sequential FileBuffers Defining a Random 1/0 Field-FIELDField #3, 20 AS N$ Field #3, 20 AS N$, 9 AS SS$ Disk File Input/OutputTo read the next record Opening and Closing a Random Disk FileReading from a Random 1/0 File Any of the parameters can be variablesDouble-precision value Writing to a Random 1/0 FileInteger Single-precision valueMKI$ Clear expression,address Attrib Fdrive numberfilename, W1Attrib Fdrive numberfilename, WO Auto first lineJ, incrementClose Commands and StatementsRules for function name are the same as for variable name DEF FNXDefsng Defdbl Defstr Defint Delete DIMEND ErrorDIR EditFOR-NEXT-STEP Error expressionExit FieldGET I file number ,record number GETGosub For variable=expression to expression Step expressionIF-THEN-ELSE InputGoto List KillLET Line InputLoad LSET, RsetNEW Merge9 16 NextOn ... Gosub On ... GotoOpen Option Base OUTPoke Print Using PrintString Fields If X$=SEVEN and Y$=EIGHT, the results of line 40 would be Numeric fieldsPUT PrunRead RandomizeREM Return Resume60 END SaveRUN line numberlstring expression ,F Line number RUN filename? 5,8,2 TRON, TroffWidth WaitATN ABSCHR$ CintFunctions AO/o = CsngCVI CVS 10 A# = 1.00/3.00EOF DskfOk· FIXHexs INPInputs INT InstrLEFT$ LOG LENLOC LOFMID$ MKI$ MKS$ MKD$OCT$ RIGHT$ string,integer RightsPeek expression POS integer10 a =1 SGNSIN SpacesSQRexpression SPCSPC integer If A$ = 2 then Print Correct Else GotoSTR$ expression TAB expressionTAN expression 60 AO/o = Here is an example of how the USRn statement is usedTable A-I. BASIC-80 Error Codes Appendix a BASIC-SO Error CodesTable A-I. BASIC-SO Error Codes Contd Appendix B BASIC-SO Reserved Words Page To resume program execution after it is stopped by To halt program execution and return to commandLevel To tab across the linePage Appendix D Ascii Codes Table D-l. Ascii Code ListBEL Table D-2. Ascii Code DefinitionAppendixe Calling Subroutines Figure B-1. Internal Representation of Numbers and Strings RESULT=USR%1VARPTRA, VARPTRB, VARPTRC» PRINTA+B+C= Result Some Real ExamplesFigure E-2 /8085 Assembly Language Program Figure E-3. PL/M-80 Program Appendix F RMX/SO BASIC-SO ISIS-II BASIC-SO Initializing the Predefined RMX/SO BASIC-SO ConfigurationOOOOH-OFFFH Table F-l. Sample Configuration Jumper WiringBASIC-80 Executable Files Generating Boot-Loaded and PROM-Based VersionsBASIC-80 Source Files BASIC-80 Object FilesGenerating a Boot-Loaded RMX/80 BASIC-80 This option enables your user-written I/O drivers if you That are not boot loadedThis option is used to allocate memory. It is 1 if the boot Setting baud rates, refer to the RMX/SO Users GuideISBC 80/20-4 Generating a PROM-Based RMX/80 BASIC-80 Prom F1 RMX820.L1BSTART, & FOBASCM.OBJ,& FORMXBAS.LlB F1 DFSDIR. L1BDIRECTORY ,RENAM E,& F1 MTI810.L1B ISBC SO/10 System Clock Configuring DFS on an iSBC 80/10Adding BASIC-SO to an Existing RMX/SO Configuration Configuration RequirementsPublic Variables Open 0,#1, L1LlST Adding User-Written I/O Drivers to RMX/SO BASIC-SOFigure F-S. Sample User-Written 1/0 Driver Routine Burning a BASIC-80 Program Into Prom Altering BASIC-80 WorkspaceBaprom F1HEATER.BAS Page Index Ase BASIC-80 RIGHT$,7-1O Request for Readerscomments 111111