Tutorial #3 - Preparing a .S19 File

Introduction.

This tutorial shows how to prepare an ASCII text file describing the data you desire to program into an EPROM. Once the file is prepared, GEN_S19 is executed from the DOS prompt. Assuming your source ASCII file has no errors, the result is a .S19 file that may then be downloaded to the Prom Blower.

On most machines in the Computer Eng Lab there is a directory C:\EEGR-463. Copy these files to your floppy. This includes the following files;

Files

Preparing a PROM.DTA file

This is a file which indicates what you want programmed in an EPROM. Use any ASCII editor such as TurboC or Norton Commander. The file must be named PROM.DTA and must be located on the A: drive (along with gen_s19.exe and as11.exe).

An example of this file follows.


* This is a comment. Comments must begin with an asterisk in the first
* column.  You may have any number of comments, and I assume your
* instructor wants good  documentation. 

* Blank lines as the above are permitted.
<0000>

* The above is the starting address.  The < must be in the first column. 
* The address must be specified in hexadecimal using four digits. 

0f 67 89 09 88 00 00 99 88 7c fc

* The above is data.  Up to 16 data bytes may appear on one line.  Each
* byte must consist of two hexadecimal digits. 

* Note that in the above, 0f is placed in address 0000, 67 in the next
* address, etc. 

00 04 56 67
77
89 aa cc ff

* Note that the number of data bytes on one line may vary.  Each byte is
* assigned in a consecutive manner, beginning at the specified address. 

<0192>

* this is another starting address.  Now the following bytes will be
* assigned, beginning at this address.  You can have as many new
* addresses as you like. 


* The last line in the file must be a dot in the first column.
.

Note that if the first column is blank, the line is assumed to be blank. If it is an asterisk, the line is assumed to contain a comment. If it is an <, the line is assumed to be a 4 digit hexadecimal address. If it is a dot, the program knows there i s no more. If neither blank, an *, a < or a dot, the program assumes the line contains data.

Be careful to follow the format. Note that hex characters are 0-9 and either a' through f' or A' through F'. Program GEN_S19 includes some error checking, but probably not enough.

Using GEN_S19.EXE

Save the ASCII file discussed above on your a: floppy as A:\PROM.DTA. You can save it under another name as well, but GEN_S19 only processes A:\PROM.DTA.

All of this is not as hard as it might seem. Do it once and it will seem simple.

Your floppy must also have GEN_S19.EXE and AS11.EXE as well.

From the DOS command prompt A:> type;

gen_s19

This will cause your PROM.DTA file to be opened, read and formatted in a Motorola assembly language file. This will be saved on your disk as A:TEMP.ASM. This is for your information only. The program then calls the AS11 assembler which cross assembles this assembly file and writes the result to PROM.S19.

The PROM.S19 file is the end product. You can then copy this to a 5-1/4 floppy if necessary and download this to the Prom Blower.