OS-9:Level 1 Boot - Revision history

ExileInParadise: /* Boot Track */

2024-05-19T12:57:24Z

Boot Track

← Older revision		Revision as of 08:57, 19 May 2024
Line 36:		Line 36:
	* [[OS9]] kernel module part 1		* [[OS9]] kernel module part 1
	* MPU vectors		* MPU vectors
	* [[OS9p2]] kernel part 2		* [[OS9p2]] kernel module part 2
	* [[Init]] module		* [[Init]] module
	* [[Boot]] module		* [[Boot]] module

ExileInParadise: convert module names to page links

2024-05-19T12:56:40Z

convert module names to page links

← Older revision		Revision as of 08:56, 19 May 2024
Line 33:		Line 33:
	* Start address		* Start address
	* OS9 Boot banner text		* OS9 Boot banner text
	* ~~RELocate~~ code		* [[REL]]ocate code
	* OS9 kernel module part 1		* [[OS9]] kernel module part 1
	* MPU vectors		* MPU vectors
	* ~~OS9~~ kernel part 2		* [[OS9p2]] kernel part 2
	* Init module		* [[Init]] module
	* Boot module		* [[Boot]] module

	== RELocate ==		== RELocate ==
	The ~~RELocate~~ code does setup housekeeping:		The [[REL]]ocate code does setup housekeeping:
	* Configure the SAM for all-RAM mode to move the ROMs out of the way and create a flat 64KB RAM workspace for OS-9 to manage		* Configure the SAM for all-RAM mode to move the ROMs out of the way and create a flat 64KB RAM workspace for OS-9 to manage
	* Configure the SAM to locate the VDG screen RAM at address $8000		* Configure the SAM to locate the VDG screen RAM at address $8000
Line 48:		Line 48:
	* Check to see if this is first boot or a restart after reset		* Check to see if this is first boot or a restart after reset
	* Copy the boot track blocks initially loaded into address $2600 to $3800 into high RAM starting at address $F000		* Copy the boot track blocks initially loaded into address $2600 to $3800 into high RAM starting at address $F000
	* Jump into the ~~OS-9~~ kernel part 1 ~~module's~~ start address		* Jump into the [[OS9]] kernel module part 1 start address

	This sequence will crash on a Color Computer 3 due to its new vector page at $FE00 to $FEFF getting overwritten.		This sequence will crash on a Color Computer 3 due to its new vector page at $FE00 to $FEFF getting overwritten.

	Later versions of OS-9 change ~~RELocate~~ to copy the boot track one 256-byte page lower, starting at $EF00, to avoid the new vectors page.		Later versions of OS-9 change [[REL]]ocate to copy the boot track one 256-byte page lower, starting at $EF00, to avoid the new vectors page.

	== OS9 ==		== OS9 ==
	The ~~first~~ module ~~of the OS-9 kernel~~ provides core service tables, cold start code, interrupt handlers, module linking and CRC verification, and other essential functions.		The [[OS9]] kernel module part 1 provides core service tables, cold start code, interrupt handlers, module linking and CRC verification, and other essential functions.

	== Vectors ==		== Vectors ==
Line 61:		Line 61:

	== OS9p2 ==		== OS9p2 ==
	The ~~second~~ module ~~of the OS-9 kernel~~ provides additional memory and process management along with additional core functions.		The [[OS9p2]] kernel module part 2 provides additional memory and process management along with additional core functions.

	== Init ==		== Init ==
	The ~~init~~ module is a small set of configuration data for the OS-9 system such as the first process to start, usually SysGo, the default storage device name such as /D0 or /DD, the initial terminal device name such as /TERM and the name of the Boot module.		The [[Init]] module is a small set of configuration data for the OS-9 system such as the first process to start, usually SysGo, the default storage device name such as /D0 or /DD, the initial terminal device name such as /TERM and the name of the Boot module.

	== Boot ==		== Boot ==
	The ~~boot~~ module provides hardware-specific code to read the OS-9 RBF disk storage layout, find the OS9Boot file, and begin loading it into memory to initialize each module found in it.		The [[Boot]] module provides hardware-specific code to read the OS-9 RBF disk storage layout, find the OS9Boot file, and begin loading it into memory to initialize each module found in it.

	== OS9Boot ==		== OS9Boot ==
	The OS9Boot file is a collection of support modules to provide services to the OS-9 applications run by the user.		The [[OS9Boot]] file is a collection of support modules to provide services to the OS-9 applications run by the user.

	* CCDisk - driver for WD17x3 floppy disk drives		* [[CCDisk]] - driver for WD17x3 floppy disk drives
	* CCIO - driver for the Color Computer console I/O		* [[CCIO]] - driver for the Color Computer console I/O
	* Clock - system module for time tracking and task switching		* [[Clock]] - system module for time tracking and task switching
	* D0 - a device descripter for floppy disk drive 0		* [[D0]] - a device descripter for floppy disk drive 0
	* D1 - a device descripter for floppy disk drive 1		* [[D1]] - a device descripter for floppy disk drive 1
	* D2 - a device descripter for floppy disk drive 2		* [[D2]] - a device descripter for floppy disk drive 2
	* D3 - a device descripter for floppy disk drive 3		* [[D3]] - a device descripter for floppy disk drive 3
	* IOMan - the I/O manager service module handling pathlist management for the kernel		* [[IOMan]] - the I/O manager service module handling pathlist management for the kernel
	* PipeMan - the Pipe file manager providing interprocess pipe handling		* [[PipeMan]] - the Pipe file manager providing interprocess pipe handling
	* Piper - the Pipe driver providing interprocess pipe handling		* [[Piper]] - the Pipe driver providing interprocess pipe handling
	* Pipe - the Pipe device descripter providing interprocess pipe handling		* [[Pipe]] - the Pipe device descripter providing interprocess pipe handling
	* PRINTER - the printer driver for serial printers attached to the built-in serial port		* [[PRINTER]] - the printer driver for serial printers attached to the built-in serial port
	* P - the printer device descripter for serial printers attached to the built-in serial port		* [[P]] - the printer device descripter for serial printers attached to the built-in serial port
	* RBF - the Random Block File manager for block-oriented storage devices		* [[RBF]] - the Random Block File manager for block-oriented storage devices
	* RS232 - the RS-232 serial port driver for terminals or modems attached to the built in serial port		* [[RS232]] - the RS-232 serial port driver for terminals or modems attached to the built in serial port
	* SCF - the ~~Sequencial~~ Character File manager for character-by-character devices		* [[SCF]] - the Sequential Character File manager for character-by-character devices
	* Shell - the default command interpreter		* [[Shell]] - the default command interpreter
	* SysGo - the system startup module to spawn the console shell on the default disk and terminal device		* [[SysGo]] - the system startup module to spawn the console shell on the default disk and terminal device
	* T1 - the device descripter for a terminal attached to the built-in serial port		* [[T1]] - the device descripter for a terminal attached to the built-in serial port
	* TERM - the default Color Computer console device descripter		* [[TERM]] - the default Color Computer console device descripter

	== SysGo ==		== SysGo ==
	The SysGo module starts the initial console shell and waits in the background for it to exit, and restart it if this happens.		The [[SysGo]] module starts the initial console shell and waits in the background for it to exit, and restart it if this happens.

	== Shell ==		== Shell ==
	The user command line ~~module providing~~ command execution, file system navigation, and I/O stream redirection.		The [[Shell]] modules provides a user command line environment, command execution, file system navigation, and I/O stream redirection.

	== Startup ==		== Startup ==
	~~An initial~~ shell procedure ~~to load~~ and ~~run~~ the setime module to prompt for the current date and time.		The [[Startup]] shell procedure file loads and runs the [[setime]] module to prompt for the current date and time from /[[TERM]].

	== Bootstrap complete ==		== Bootstrap complete ==
	The system is ready to use once the OS9: prompt appears.		The system is ready to use once the OS9: prompt appears.

ExileInParadise: the shell also provides command execution (stick a fork in it)

2024-05-19T12:00:00Z

the shell also provides command execution (stick a fork in it)

← Older revision		Revision as of 08:00, 19 May 2024
Line 97:		Line 97:

	== Shell ==		== Shell ==
	The user command line module providing file system navigation and I/O stream redirection.		The user command line module providing command execution, file system navigation, and I/O stream redirection.

	== Startup ==		== Startup ==

ExileInParadise: adds the 'of'

2024-05-19T11:58:44Z

adds the 'of'

← Older revision		Revision as of 07:58, 19 May 2024
Line 70:		Line 70:

	== OS9Boot ==		== OS9Boot ==
	The OS9Boot file is a collection support modules to provide services to the OS-9 applications run by the user.		The OS9Boot file is a collection of support modules to provide services to the OS-9 applications run by the user.

	* CCDisk - driver for WD17x3 floppy disk drives		* CCDisk - driver for WD17x3 floppy disk drives

ExileInParadise: Describe the RELocate code

2024-05-19T11:57:21Z

Describe the RELocate code

← Older revision		Revision as of 07:57, 19 May 2024
Line 41:		Line 41:

	== RELocate ==		== RELocate ==
			The RELocate code does setup housekeeping:
			* Configure the SAM for all-RAM mode to move the ROMs out of the way and create a flat 64KB RAM workspace for OS-9 to manage
			* Configure the SAM to locate the VDG screen RAM at address $8000
			* Clear the screen RAM
			* Copy the OS9 Boot banner text onto the screen
			* Check to see if this is first boot or a restart after reset
			* Copy the boot track blocks initially loaded into address $2600 to $3800 into high RAM starting at address $F000
			* Jump into the OS-9 kernel part 1 module's start address

			This sequence will crash on a Color Computer 3 due to its new vector page at $FE00 to $FEFF getting overwritten.

			Later versions of OS-9 change RELocate to copy the boot track one 256-byte page lower, starting at $EF00, to avoid the new vectors page.

	== OS9 ==		== OS9 ==

ExileInParadise: press enter after DOS to actually start it booting

2024-05-19T05:50:48Z

press enter after DOS to actually start it booting

← Older revision		Revision as of 01:50, 19 May 2024
Line 20:		Line 20:
	=== 1.1 ===		=== 1.1 ===

	Place the OS9L1V1M.DSK master disk into the floppy diskette drive, type DOS, and OS-9 begins to boot.		Place the OS9L1V1M.DSK master disk into the floppy diskette drive, type DOS, press ENTER, and OS-9 begins to boot.

	== Boot Track ==		== Boot Track ==

ExileInParadise: add the summary for the sysgo module to the OS9boot module list

2024-05-19T05:47:29Z

add the summary for the sysgo module to the OS9boot module list

← Older revision		Revision as of 01:47, 19 May 2024
Line 77:		Line 77:
	* SCF - the Sequencial Character File manager for character-by-character devices		* SCF - the Sequencial Character File manager for character-by-character devices
	* Shell - the default command interpreter		* Shell - the default command interpreter
	* SysGo-~~V01.00.05.sm~~		* SysGo - the system startup module to spawn the console shell on the default disk and terminal device
	* T1 - the device descripter for a terminal attached to the built-in serial port		* T1 - the device descripter for a terminal attached to the built-in serial port
	* TERM - the default Color Computer console device descripter		* TERM - the default Color Computer console device descripter

ExileInParadise: indent decb 1.1 notes

2024-05-19T05:43:01Z

indent decb 1.1 notes

← Older revision		Revision as of 01:43, 19 May 2024
Line 18:		Line 18:
	The user is then prompted to place the OS9L1V1M.DSK master diskette in the floppy disk drive and press a key to continue.		The user is then prompted to place the OS9L1V1M.DSK master diskette in the floppy disk drive and press a key to continue.

	== 1.1 ==		=== 1.1 ===

	Place the OS9L1V1M.DSK master disk into the floppy diskette drive, type DOS, and OS-9 begins to boot.		Place the OS9L1V1M.DSK master disk into the floppy diskette drive, type DOS, and OS-9 begins to boot.

ExileInParadise: The bootstrap sequence for OS-9 Level 1 on the Color Computer

2024-05-19T05:42:13Z

The bootstrap sequence for OS-9 Level 1 on the Color Computer

New page

= OS-9 Level 1 Boot =

== Disk Extended Color BASIC ==

=== 1.0 ===
Disk Extended Color BASIC 1.0 does not directly support the OS-9 boot track.

The OS9L1V1B.DSK contains two files: *.BAS and $82$81

*.BAS provides a menu to choose Boot or to test the floppy diskette drive.

If the disk test is chosen, the $82$81 is loaded from diskette into address $5000 and started to test the rotation speed of the floppy disk drive to verify it rotates close to 300 revolutions per minute.

If boot is chosen, then BASIC DATA statements are poked into address $5000 and started.

The boot code is very similar to the DOS command added for Disk Extended Color BASIC 1.1.

The user is then prompted to place the OS9L1V1M.DSK master diskette in the floppy disk drive and press a key to continue.

== 1.1 ==

Place the OS9L1V1M.DSK master disk into the floppy diskette drive, type DOS, and OS-9 begins to boot.

== Boot Track ==
The *.BAS machine code or the DOS command loads track 34, sectors 1-18 from the the OS9L1V1M.DSK diskette into RAM at address $2600.

If the first two bytes of the boot track are 'OS' then the DOS command reads the 16-bit address loaded into $2602 and transfers control to the code there.

Between the OS signature, start address, and the beginning of code are the bytes of the OS9 Boot banner shown on the screen.

The boot track contains:
* OS Signature bytes 'OS'
* Start address
* OS9 Boot banner text
* RELocate code
* OS9 kernel module part 1
* MPU vectors
* OS9 kernel part 2
* Init module
* Boot module

== RELocate ==

== OS9 ==
The first module of the OS-9 kernel provides core service tables, cold start code, interrupt handlers, module linking and CRC verification, and other essential functions.

== Vectors ==
This block of data is designed to load into RAM to initialize the address of the 6809 MPU vectors.

== OS9p2 ==
The second module of the OS-9 kernel provides additional memory and process management along with additional core functions.

== Init ==
The init module is a small set of configuration data for the OS-9 system such as the first process to start, usually SysGo, the default storage device name such as /D0 or /DD, the initial terminal device name such as /TERM and the name of the Boot module.

== Boot ==
The boot module provides hardware-specific code to read the OS-9 RBF disk storage layout, find the OS9Boot file, and begin loading it into memory to initialize each module found in it.

== OS9Boot ==
The OS9Boot file is a collection support modules to provide services to the OS-9 applications run by the user.

* CCDisk - driver for WD17x3 floppy disk drives
* CCIO - driver for the Color Computer console I/O
* Clock - system module for time tracking and task switching
* D0 - a device descripter for floppy disk drive 0
* D1 - a device descripter for floppy disk drive 1
* D2 - a device descripter for floppy disk drive 2
* D3 - a device descripter for floppy disk drive 3
* IOMan - the I/O manager service module handling pathlist management for the kernel
* PipeMan - the Pipe file manager providing interprocess pipe handling
* Piper - the Pipe driver providing interprocess pipe handling
* Pipe - the Pipe device descripter providing interprocess pipe handling
* PRINTER - the printer driver for serial printers attached to the built-in serial port
* P - the printer device descripter for serial printers attached to the built-in serial port
* RBF - the Random Block File manager for block-oriented storage devices
* RS232 - the RS-232 serial port driver for terminals or modems attached to the built in serial port
* SCF - the Sequencial Character File manager for character-by-character devices
* Shell - the default command interpreter
* SysGo-V01.00.05.sm
* T1 - the device descripter for a terminal attached to the built-in serial port
* TERM - the default Color Computer console device descripter

== SysGo ==
The SysGo module starts the initial console shell and waits in the background for it to exit, and restart it if this happens.

== Shell ==
The user command line module providing file system navigation and I/O stream redirection.

== Startup ==
An initial shell procedure to load and run the setime module to prompt for the current date and time.

== Bootstrap complete ==
The system is ready to use once the OS9: prompt appears.