OS-9 Assembly Code Development - Revision history

Jfed: /* Single Source File Format */

2024-10-08T11:43:35Z

Single Source File Format

← Older revision		Revision as of 07:43, 8 October 2024
Line 138:		Line 138:
	* '''mod:''' Creates the module header and starts CRC check. '''mod''' has 6 attributes:		* '''mod:''' Creates the module header and starts CRC check. '''mod''' has 6 attributes:

	# Module size (computed from the ''eom'' label at the end of the code - 2 bytes)		# Module size (computed from the ''<u>eom</u>'' label at the end of the code - 2 bytes)
	# Module name offset (offset where the string of the name is contained, here that is defined at the name label with the ''fcs'' pseudo instruction - 2 bytes		# Module name offset (offset where the string of the name is contained, here that is defined at the ''<u>name</u>'' label with the ''fcs'' pseudo instruction - 2 bytes
	# Module type & language (in this case a Program in 6809 object code - 1 byte)		# Module type & language (in this case a Program in 6809 object code - 1 byte)
	# Module attribute-revision (1 byte). Attributes are reentrant (ReEnt) or not reentrant (0). Revision is a number 0-15. If two or more modules with the same name are in the module directory, then OS-9 only keeps the highest revision number module.		# Module attribute-revision (1 byte). Attributes are reentrant (ReEnt) or not reentrant (0). Revision is a number 0-15. If two or more modules with the same name are in the module directory, then OS-9 only keeps the highest revision number module.
	# Module execution offset (here that is defined with the start label - 2 bytes)		# Module execution offset (here that is defined with the ''<u>start</u>'' label - 2 bytes)
	# Module variable storage size (defined by the ''<u>size</u>'' label immediately after the variable area, includes stack space - 2 bytes)		# Module variable storage size (defined by the ''<u>size</u>'' label immediately after the variable area, includes stack space - 2 bytes)

Jfed: /* Single Source File Format */

2024-10-01T04:18:33Z

Single Source File Format

← Older revision		Revision as of 00:18, 1 October 2024
Line 129:		Line 129:
	<code> [Program Section - Program Code Here]</code>		<code> [Program Section - Program Code Here]</code>
	<code> </code>		<code> </code>
	<code> os9 F$Exit</code>		<code> os9 F$Exit</code>

	<code> '''emod'''</code>		<code> '''emod'''</code>

Jfed: /* Single Source File Format */

2024-10-01T03:49:51Z

Single Source File Format

← Older revision		Revision as of 23:49, 30 September 2024
Line 136:		Line 136:
	OS9 can load programs (modules) only if they are in module header format. A module (program) is defined between the '''mod''' and '''emod''' pseudo instructions.		OS9 can load programs (modules) only if they are in module header format. A module (program) is defined between the '''mod''' and '''emod''' pseudo instructions.

			* '''mod:''' Creates the module header and starts CRC check. '''mod''' has 6 attributes:
	'''mod:''' Creates the module header and starts CRC check. '''mod''' has 6 attributes:

	# Module size (computed from the ''eom'' label at the end of the code - 2 bytes)		# Module size (computed from the ''eom'' label at the end of the code - 2 bytes)
Line 146:		Line 145:
	# Module variable storage size (defined by the ''<u>size</u>'' label immediately after the variable area, includes stack space - 2 bytes)		# Module variable storage size (defined by the ''<u>size</u>'' label immediately after the variable area, includes stack space - 2 bytes)

			* '''emod''': Outputs the correct 3 byte CRC. This is generated by the assembler over the entire module.
	'''emod''': Outputs the correct 3 byte CRC. This is generated by the assembler over the entire module.

Jfed: /* Program Modules */

2024-09-30T02:59:46Z

Program Modules

← Older revision		Revision as of 22:59, 29 September 2024
Line 90:		Line 90:

	=== Program Modules ===		=== Program Modules ===
	The format of ~~the~~ program module varies depending on whether you have a single source file for your program or multiple source files.		The format of a program module varies depending on whether you have a single source file for your program or multiple source files.

	Note: multiple source files format cannot use direct page addressing due to the way they are compiled.		Note: multiple source files format cannot use direct page addressing due to the way they are compiled.

Jfed: Added intro sentence.

2024-09-30T02:53:57Z

Added intro sentence.

← Older revision		Revision as of 22:53, 29 September 2024
Line 95:		Line 95:

	==== Single Source File Format ====		==== Single Source File Format ====
			The following is a skeleton for a single source file memory module (program).
	<code>********************************************************************</code>		<code>********************************************************************</code>
	<code>* [Program Name]</code>		<code>* [Program Name]</code>
Line 119:		Line 119:
	<code> '''mod eom,name,tylg,atrv,start,size'''</code>		<code> '''mod eom,name,tylg,atrv,start,size'''</code>

	<code> [Data Section - Variables Here]</code>		<code> [Data Section - Variables and Data Structures Here]</code>

	<code>size equ .</code>		<code>size equ .</code>

Jfed: Added information about assembly pseudo instructions.

2024-09-30T02:49:22Z

Added information about assembly pseudo instructions.

← Older revision		Revision as of 22:49, 29 September 2024
Line 107:		Line 107:
	<code> nam [executablename]</code>		<code> nam [executablename]</code>
	<code> ttl [Full Program Name]</code>		<code> ttl [Full Program Name]</code>
	~~<code></code>~~
	<code> ifp1</code>		<code> ifp1</code>
	<code> use defsfile</code>		<code> use defsfile</code>
	<code> endc</code>		<code> endc</code>
	~~</code>~~
	<code>tylg set Prgrm+Objct</code>		<code>tylg set Prgrm+Objct</code>
	<code>atrv set ReEnt+rev</code>		<code>atrv set ReEnt+rev</code>
	<code>rev set $00</code>		<code>rev set $00</code>
	<code>edition set 1</code>		<code>edition set 1</code>
	~~</code>~~
	<code> mod eom,name,tylg,atrv,start,size</code>		<code> '''mod eom,name,tylg,atrv,start,size'''</code>
	~~</code>~~
	<code> [Variables Here]</code>		<code> [Data Section - Variables Here]</code>
	~~</code>~~
	<code>size equ .</code>		<code>size equ .</code>
	<code>name fcs /executablename/</code>		<code>name fcs /[executablename]/</code>
	<code> fcb edition</code>		<code> fcb edition</code>
	~~</code>~~
	<code>start</code>		<code>start</code>
	~~</code>~~
	<code> [Program Code Here]</code>		<code> [Program Section - Program Code Here]</code>
	<code> </code>		<code> </code>
	<code> os9 F$Exit</code>		<code> os9 F$Exit</code>
	~~</code>~~
	<code> emod</code>		<code> '''emod'''</code>
	<code>eom equ *</code>		<code>eom equ *</code>
	<code> end</code>		<code> end</code>
			OS9 can load programs (modules) only if they are in module header format. A module (program) is defined between the '''mod''' and '''emod''' pseudo instructions.


			'''mod:''' Creates the module header and starts CRC check. '''mod''' has 6 attributes:

			# Module size (computed from the ''eom'' label at the end of the code - 2 bytes)
			# Module name offset (offset where the string of the name is contained, here that is defined at the name label with the ''fcs'' pseudo instruction - 2 bytes
			# Module type & language (in this case a Program in 6809 object code - 1 byte)
			# Module attribute-revision (1 byte). Attributes are reentrant (ReEnt) or not reentrant (0). Revision is a number 0-15. If two or more modules with the same name are in the module directory, then OS-9 only keeps the highest revision number module.
			# Module execution offset (here that is defined with the start label - 2 bytes)
			# Module variable storage size (defined by the ''<u>size</u>'' label immediately after the variable area, includes stack space - 2 bytes)


			'''emod''': Outputs the correct 3 byte CRC. This is generated by the assembler over the entire module.


			For more information about memory modules, see OS-9 Fundamentals:

			[https://www.youtube.com/watch?v=YpoqTyrty8k OS-9 Fundamentals on YouTube by Boisy Pitre]

	==== Multiple Source File Format ====		==== Multiple Source File Format ====

Jfed: /* Data Modules */

2024-09-29T21:55:30Z

Data Modules

← Older revision		Revision as of 17:55, 29 September 2024
Line 141:		Line 141:
	Here is a portion of the font module, which is a data module in NitrOS-9.		Here is a portion of the font module, which is a data module in NitrOS-9.

	<code> nam font</code>		<code> nam font</code>
			<code> ttl F256 font</code>
	<code> ttl F256 font</code>		</code>
			<code> use defsfile</code>
	<code> use defsfile</code>		</code>
			<code>tylg set Data</code>
	<code>tylg set Data</code>		<code>atrv set ReEnt+rev</code>
			<code>rev set $01</code>
	<code>atrv set ReEnt+rev</code>		</code>
			<code> mod eom,name,tylg,atrv,start,0</code>
	<code>rev set $01</code>		<code>name fcs /font/</code>
			</code>
	<code> mod eom,name,tylg,atrv,start,0</code>		<code>start</code>
			<code>L0000 fcb $00,$00,$00,$00,$00,$00,$00,$00 </code>
	<code>name fcs /font/</code>		<code>L0008 fcb $7C,$82,$AA,$82,$BA,$92,$82,$7C </code>
			</code>
	<code>start</code>		<code>*More data here</code>
			</code>
	<code>L0000 fcb $00,$00,$00,$00,$00,$00,$00,$00 </code>		<code> emod</code>
			<code>eom equ *</code>
	<code>L0008 fcb $7C,$82,$AA,$82,$BA,$92,$82,$7C </code>		<code> end</code>

	<~~nowiki~~>*</~~nowiki~~>~~More data here~~

	<code> emod</code>

	<code>eom equ *</code>

	<code> end</code>

	== Writing Position Independent Code ==		== Writing Position Independent Code ==

Jfed: /* Single Source File Format */

2024-09-29T21:51:34Z

Single Source File Format

← Older revision		Revision as of 17:51, 29 September 2024
Line 119:		Line 119:
	<code> mod eom,name,tylg,atrv,start,size</code>		<code> mod eom,name,tylg,atrv,start,size</code>
	</code>		</code>
	<code> [Variables ~~go here~~]</code>		<code> [Variables Here]</code>
	</code>		</code>
	<code>size equ .</code>		<code>size equ .</code>

Jfed: /* Single Source File Format */

2024-09-29T21:50:34Z

Single Source File Format

← Older revision		Revision as of 17:50, 29 September 2024
Line 96:		Line 96:
	==== Single Source File Format ====		==== Single Source File Format ====

	<code>********************************************************************</code>		<code>********************************************************************</code>
			<code>* [Program Name]</code>
	<code>* [Program Name]</code>		<code>* [Description]</code>
			<code>*</code>
	<code>* [Description]</code>		<code>* by [Author Name]</code>
			<code>*</code>
	<code>*</code>		<code>* Edt/Rev YYYY/MM/DD Modified by</code>
			<code>* Comment</code>
	<code>* by [Author Name]</code>		<code>* ------------------------------------------------------------------</code>
			<code> nam [executablename]</code>
	<code>*</code>		<code> ttl [Full Program Name]</code>
			<code></code>
	<code>* Edt/Rev YYYY/MM/DD Modified by</code>		<code> ifp1</code>
			<code> use defsfile</code>
	<code>* Comment</code>		<code> endc</code>
			</code>
	<code>* ------------------------------------------------------------------</code>		<code>tylg set Prgrm+Objct</code>
			<code>atrv set ReEnt+rev</code>
	<code> nam [executablename]</code>		<code>rev set $00</code>
			<code>edition set 1</code>
	<code> ttl [Full Program Name]</code>		</code>
			<code> mod eom,name,tylg,atrv,start,size</code>
	<br>		</code>
	<code> ifp1</code~~><br~~>		<code> [Variables go here]</code>
	<code> use defsfile</code~~><br~~>		</code>
	<code> endc</code~~><br~~>		<code>size equ .</code>
	<br>		<code>name fcs /executablename/</code>
	<code>tylg set Prgrm+Objct</code~~><br~~>		<code> fcb edition</code>
	<code>atrv set ReEnt+rev</code~~><br~~>		</code>
	<code>rev set $00</code~~><br~~>		<code>start</code>
	<code>edition set 1</code~~><br~~>		</code>
	<br>		<code> [Program Code Here]</code>
	<code> mod eom,name,tylg,atrv,start,size</code~~><br~~>		<code> </code>
	<br>		<code> os9 F$Exit</code>
	<code>[Variables go here]</code~~><br~~>		</code>
	<br>		<code> emod</code>
	<code>size equ .</code~~><br~~>		<code>eom equ *</code>
	<code>name fcs /executablename/</code~~><br~~>		<code> end</code>
	<code> fcb edition</code~~><br~~>
	<br>
	<code>start</code~~><br~~>
	<br>
	<code> [Program Code Here]</code~~><br~~>
	<code> </code~~><br~~>
	<code> os9 F$Exit</code~~><br~~>
	<~~br>~~
	~~<br~~>
	<code> emod</code~~><br~~>
	<code>eom equ *</code~~><br~~>
	<code> end</code>~~<br>~~


	==== Multiple Source File Format ====		==== Multiple Source File Format ====

Jfed: formatting

2024-09-29T21:41:45Z

formatting

← Older revision		Revision as of 17:41, 29 September 2024
Line 96:		Line 96:
	==== Single Source File Format ====		==== Single Source File Format ====

	<code>********************************************************************</code>~~<br>~~		<code>********************************************************************</code>
	<code>* [Program Name]</code>~~<br>~~
	<code>* [Description]</code>~~<br>~~		<code>* [Program Name]</code>
	<code>*</code>~~<br>~~
	<code>* by [Author Name]</code>~~<br>~~		<code>* [Description]</code>
	<code>*</code>~~<br>~~
	<code>* Edt/Rev YYYY/MM/DD Modified by</code>~~<br>~~		<code>*</code>
	<code>* Comment</code>~~<br>~~
	<code>* ------------------------------------------------------------------</code>~~<br>~~		<code>* by [Author Name]</code>
	<code>nam [executablename]~~</nowiki>~~</code>~~<br>~~
	<code> ttl [Full Program Name]</code>~~<br>~~		<code>*</code>

			<code>* Edt/Rev YYYY/MM/DD Modified by</code>

			<code>* Comment</code>

			<code>* ------------------------------------------------------------------</code>

			<code> nam [executablename]</code>

			<code> ttl [Full Program Name]</code>

	<br>		<br>
	<code> ifp1</code><br>		<code> ifp1</code><br>