Description of Machine Code File Handling Routines - Revision history

Jhoger: Reverted edits by 203.189.230.5 (Talk); changed back to last version by Jhoger

2011-07-09T03:35:53Z

Reverted edits by 203.189.230.5 (Talk); changed back to last version by Jhoger

Show changes

203.189.230.5: Undo revision 1582 by Jhoger (Talk)

2011-07-07T03:11:31Z

Undo revision 1582 by Jhoger (Talk)

Show changes

Jhoger at 20:44, 14 April 2009

2009-04-14T20:44:30Z

← Older revision		Revision as of 13:44, 14 April 2009
Line 216:		Line 216:

	</pre>		</pre>

			[[Category:Model T Developer Reference]]

Jhoger: /* Sample program */

2009-04-14T20:42:33Z

Sample program

@@ Line 175: / Line 175: @@
 		CALL	LDIRSB		; Copy header bytes into file
-		LHLD	BINADR
+		LHLD	BINADR		; Point to source data
-		POP	B
+		POP	B		; Recover source length
-		CALL	LDIRSB
+		CALL	LDIRSB		; Copy in the program
 </pre>

Jhoger: /* Procedure to save machine code program */

2009-04-14T20:10:39Z

Procedure to save machine code program

@@ Line 116: / Line 116: @@
 <pre>
 		CALL LNKFIL		; gratuitous since appending to final region...
 </pre>

Jhoger: /* Procedure to save machine code program */

2009-04-14T19:43:39Z

Procedure to save machine code program

@@ Line 11: / Line 11: @@
 . Set up file name,
-Set up file name in FILNAM. This is the same step used to open an ASCII file except the extnsion should be "CO" in case of machine code program save. Body of file anme (i.e. string that precedes the extension) should be 6 characters long, space filled to the extension.
+Set up file name in FILNAM. This is the same step used to open an ASCII file
 :<nowiki>[FILNAM] <= 1st character of file name</nowiki>
@@ Line 30: / Line 33: @@
 :<nowiki>[BINEXE] <= Execution start address; 0 if not executable at IPL</nowiki>
 . Fix up directory structure.
 Refer to "Description of ROM routines in PC_8201 for detail of LNKFIL routine.
@@ Line 36: / Line 39: @@
 <pre>
 		CALL	LNKFIL		; Fix up directory structure
 </pre>

Jhoger: New page: == Saving a machine code program into a RAM file == In this chapter, the method to save machine code program that resides in memory into RAM file as a ".CO" file is described. In fact, th...

2009-04-14T18:39:22Z

New page: == Saving a machine code program into a RAM file == In this chapter, the method to save machine code program that resides in memory into RAM file as a ".CO" file is described. In fact, th...

New page

== Saving a machine code program into a RAM file ==

In this chapter, the method to save machine code program that resides in memory into RAM file as a ".CO" file is described. In fact, the object to be saved needs not necessarily machine code program. It can be binary data. The routines described later in this chapter saved the contents of specified portion of memory exactly as they are, just appending some control information.

The control information consists of three words: load address, length, and execution address. The contents of the file is always loaded back to the location where the contents (machine code program) were located when saved. The load address in the file contains the location. Note that this is NOT the address of the file itself.

=== Procedure to save machine code program ===

To save machine code program in memory as a ".CO" file, follow the steps below. Address of individual routines used in this chapter will be described later in this document.

1. Set up file name,

Set up file name in FILNAM. This is the same step used to open an ASCII file except the extnsion should be "CO" in case of machine code program save. Body of file anme (i.e. string that precedes the extension) should be 6 characters long, space filled to the extension.

:<nowiki>[FILNAM] <= 1st character of file name</nowiki>
:.
:.
:.
:<nowiki>[FILNAM+5] <= 6th character of file name</nowiki>
:<nowiki>[FILNAM+6] <= "C"</nowiki>
:<nowiki>[FILNAM+7] <= "O"</nowiki>
:<nowiki>[FILNAM+8] <= " "</nowiki>

2. Set up parameters

Then set address of machine code program, its length and execution address.

:<nowiki>[BINADR] <= Start address of binary data</nowiki>
:<nowiki>[BINLEN] <= Length of binary data</nowiki>
:<nowiki>[BINEXE] <= Execution start address; 0 if not executable at IPL</nowiki>

4. Fix up directory structure.

Refer to "Description of ROM routines in PC_8201 for detail of LNKFIL routine.

<pre>
CALL LNKFIL ; Fix up directory structure
</pre>