OS-9: Difference between revisions

From F256 Foenix
Jump to navigationJump to search
No edit summary
Line 1: Line 1:
== Introduction ==
== Introduction ==
OS-9 is a 6809-based operating system that is well-known on the Tandy Color Computer. Its open-source successor, NitrOS-9, is now running on the Foenix F256. For all intents and purposes, OS-9 and NitrOS-9 are interchangeable.
The FNX6809 combined with the F256 makes a great system for running OS-9/6809. [[wikipedia:OS-9|OS-9]] was a real-time, embedded operating system created by [[wikipedia:Microware|Microware Systems Corporation]]. While it was used in many areas of industry, home computer users know it best for its implementation on the [[wikipedia:TRS-80_Color_Computer|Tandy Color Computer]] sold by Radio Shack


The FNX6809 combined with the F256 makes a great system for running OS-9/6809. OS-9 was a real-time, embedded operating system created by Microware Systems Corporation. While it was used in many areas of industry, home computer users know it best for its implementation on the Tandy Color Computer sold by Radio Shack
Today, a community effort has led to the creation of [https://github.com/nitros9project/nitros9 NitrOS-9], an open source version of the OS-9 operating system. Throughout this document, I'll refer to NitrOS-9 as OS-9.
 
Today, a community effort has led to the creation of NitrOS-9, an open source version of the OS-9 operating system. Throughout this document, I'll refer to NitrOS-9 as OS-9.


== A word about platforms ==
== A word about platforms ==
Line 12: Line 10:
To get code into the F256, you need [https://github.com/pweingar/FoenixMgr FoenixMgr]. Download this package and follow the instructions to install it on your machine.
To get code into the F256, you need [https://github.com/pweingar/FoenixMgr FoenixMgr]. Download this package and follow the instructions to install it on your machine.


Note, if you're using a Mac, you won't be able to upload code into the F256 due to the driver manufacturer being so behind on updates. I have a Linux VM and use FoenixMgr tools in bridge mode on there. This allows me to run the commands on my Mac and direct them to the Linux VM.
Note, if you're using a Mac, you won't be able to upload code into the F256 due to the [https://www.maxlinear.com/support/design-tools/software-drivers driver manufacturer] being so behind on updates. I have a Linux VM and use FoenixMgr tools in bridge mode on there. This allows me to run the commands on my Mac and direct them to the Linux VM.


== Cross-hosted software ==
== Cross-hosted software ==
Cross-hosted development is the fastest way to develop code for the F256. For this you need the following:
Cross-hosted development is the fastest way to develop code for the F256. For this you need the following:


* lwtools - an assembler/linker package
* [http://www.lwtools.ca lwtools] - an assembler/linker package
* ToolShed - a set of tools for creating disk images
* [https://github.com/nitros9project/toolshed ToolShed] - a set of tools for creating disk images
* NitrOS-9 - the NitrOS-9 operating system in source form
* [https://github.com/nitros9project/nitros9 NitrOS-9] - the NitrOS-9 operating system in source form


You can pull these down individually, or better yet, this fork of @strickyak's great CoCo Shelf repository. It has a <code>Makefile</code> which gets all of the above and puts it in a convenient location (note that you'll have to update your shell script of choice to include the locations of the binaries in the <code>PATH</code> environment variable).
You can pull these down individually, or better yet, use [https://github.com/strickyak @strickyak]'s great [https://github.com/strickyak/coco-shelf/ CoCo Shelf repository]. It has a <code>Makefile</code> which gets all of the above and puts it in a convenient location (note that you'll have to update your shell script of choice to include the locations of the binaries in the <code>PATH</code> environment variable).


Here are the commands to type at the terminal to pull down all the required software:
Here are the commands to type at the terminal to pull down all the required software:

Revision as of 19:42, 14 December 2023

Introduction

The FNX6809 combined with the F256 makes a great system for running OS-9/6809. OS-9 was a real-time, embedded operating system created by Microware Systems Corporation. While it was used in many areas of industry, home computer users know it best for its implementation on the Tandy Color Computer sold by Radio Shack

Today, a community effort has led to the creation of NitrOS-9, an open source version of the OS-9 operating system. Throughout this document, I'll refer to NitrOS-9 as OS-9.

A word about platforms

This document assumes you're running on Linux or macOS. If you're using Windows, someone will have to step up and write a document for that platform.

Foenix-specific tools

To get code into the F256, you need FoenixMgr. Download this package and follow the instructions to install it on your machine.

Note, if you're using a Mac, you won't be able to upload code into the F256 due to the driver manufacturer being so behind on updates. I have a Linux VM and use FoenixMgr tools in bridge mode on there. This allows me to run the commands on my Mac and direct them to the Linux VM.

Cross-hosted software

Cross-hosted development is the fastest way to develop code for the F256. For this you need the following:

  • lwtools - an assembler/linker package
  • ToolShed - a set of tools for creating disk images
  • NitrOS-9 - the NitrOS-9 operating system in source form

You can pull these down individually, or better yet, use @strickyak's great CoCo Shelf repository. It has a Makefile which gets all of the above and puts it in a convenient location (note that you'll have to update your shell script of choice to include the locations of the binaries in the PATH environment variable).

Here are the commands to type at the terminal to pull down all the required software:

cd
git clone https://github.com/strickyak/coco-shelf.git
cd coco-shelf
export PATH=$PATH:$HOME/coco-shelf/bin
make mirror-stuff done-lwtools done-cmoc done-toolshed done-nitros9