,ll 6.6
,cs 10
,pl 66
,lm 0.2,0.5
,pn 9
,ju
,hd
,ce
OmegaSoft 6809 Cross Pascal Language Handbook (V1.0)
,,
,ft

,ce 1
0-##
,,
,ce
OmegaSoft 6809 Cross Pascal Language Handbook (V1.0)

,ce
PREFACE

MANUAL OBJECTIVES

This manual describes the Pascal Language as implemented by Certified Software for the 6809 CPU with a 68000 host. This manual is a reference document and is not meant as a tutorial on Pascal. For those not familiar with the Pascal Language the following book is recommended by Certified Software.

    Programming in Pascal
    Revised Edition
    Peter Grogono
    Published by Addison-Wesley
    Number ISBN 0-201-02775-5

Readers should have a basic knowledge of the operating system to be used with the Pascal Compiler. Operating system dependent features are presented in section 3 of this manual.

STRUCTURE OF THIS MANUAL

* Chapter 1 describes the steps necessary to install the Pascal compiler and related programs on your system.

* Chapter 2 covers the operation of each program (such as command line format) and operating system dependent utilities.

* Chapter 3 describes those features which are operating system dependent, such as I/O operations.

* Chapter 4 describes the basic structure of a Pascal program and it's elements. It also describes in detail the components of the various declaration sections.

* Chapter 5 describes the valid forms of an expression and the statement types allowed in Pascal.

* Chapter 6 describes the format of user defined procedures and functions. In addition each built-in standard procedure and function is described.

* Chapter 7 describes Modular compilation and its advantages. Interface to assembly language routines and data is also covered.

* Chapter 8 describes Pascal device drivers.

* Chapter 9 is an appendix that includes compilation and runtime errors, the runtime environment, the runtime support routines used and their location, and the ISO Validation Report. This report can be used as an aid for those of you who must write portable Pascal programs or wish to transport programs from another source to run on OmegaSoft Pascal. An additional appendix outlines changes that must be made to your program if written using an earlier version of this software.

* Chapter 10 is a reference manual for the Relocatable Macro Assembler provided.

* Chapter 11 is a reference manual for the Linking Loader provided.

,ce
PREFACE

* Chapter 12 is a reference manual for the Screen Editor provided.

* Chapter 13 is not used.

* Chapter 14 is a reference manual describing installation of the Interactive Debugger on your target system.

* Chapter 15 is an index covering chapters 4 through 14, with emphasis placed on Pascal syntax items.

,ce
HOST COMPUTER - HARDWARE

The larger programs in the package require 256K bytes of memory at a minimum, this implies that the minimum system RAM size is 256K plus operating system requirements, probably 512K is the minimum you should consider. For those operating systems that allow RAM disk, you should consider having 64 - 256K of RAM disk. For those operating systems that allow you to call one program from within another, or allow loading commands into memory and leaving them there, you should have at least 1MB to take advantage of these capabilities.

The CPU should be at least a 68000, 68008's are fine for small target systems, but they are just too slow for an effective host development system.  Another item to be careful of is wait states, accept no system having more than 2 wait states, you aren't getting your monies worth.

Since 68020 system prices are coming down in price, you might want to consider a 68020 if your budget will allow it. These systems normally run at least 2 times as fast as a 68000.

Any host development system should also include a hard disk, 10MB should be considered the minimum size.

,ce
HOST DEVELOPMENT SYSTEM - OPERATING SYSTEM

Unfortunately there are many operating systems for the 68000 being sold today. This implies that it is not feasible to support them all. At the time of this writing (January 1987) Certified Software supports one operating system for the cross compiler. What follows are features that are nice to have and are only an opinion. Just as no editor will please everybody, the same is true for operating systems.

The best directory structure on a disk is hierarchical file structure as it allows the user to organize the disk however he feels is best. At the very minimum there needs to be some way to segregate groups of files relating to different projects, such as user numbers.

RAM disk is a very useful option, especially for such things as include files on large modular projects.

Multitasking is a useful addition, so that you can run compilations and listings while you are editing. On the other hand, multi-user is probably not worth the trouble. This is due to the extra software overhead, memory management hardware, and general degradation of performance when multiple users are on the system. 
,pg
,ce
PREFACE

With the price of computer systems coming down, it is probably preferable to purchase multiple computers with an efficient operating system rather than having programmers sharing one system. After all, if two people are compiling, each compilation will take twice as long on a multi-user system. Site licenses are available from Certified Software or through it's distributors for multiple computer systems.

The ability to load commonly used programs into memory (such as the compiler, debugger, editor) can save quite a bit of time by avoiding having to load it off of disk each time you need it. It also makes the capability of our editor to compile and assemble from the edit buffer that much more time effective. Note that this editor capability is not available for all operating systems.

,ce
TARGET SYSTEM

If you plan on using the target debugger then your target system needs to have a serial port for debugging, and the ability to replace the memory space normally taken by EPROMS (for your target program code) with RAM so the target debugger can download code.
