Foenix F256 / Wildbits/K2 Wiki - User contributions [en]

OS-9

2024-06-26T02:02:58Z

104.61.174.70:

== Introduction ==
The FNX6809 combined with the F256 makes a great system for running OS-9/6809. [[wikipedia:OS-9|OS-9]] is 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

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 page, I'll refer to NitrOS-9 as OS-9.

== A word about platforms ==
This page assumes you're running on Linux or macOS. If you're using Windows, these instructions don't apply, and someone will have to step up and write steps to develop on that platform.

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

* [http://www.lwtools.ca lwtools] - an assembler/linker package
* [https://github.com/nitros9project/toolshed ToolShed] - a set of tools for creating disk images
* [https://github.com/nitros9project/nitros9 NitrOS-9] - the NitrOS-9 operating system in source form
* [https://github.com/pweingar/FoenixMgr FoenixMgr] - tools to load code into RAM or Flash of the F256.

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 terminal commands for Linux and macOS to pull down all the required software:
cd
git clone <nowiki>https://github.com/strickyak/coco-shelf.git</nowiki>
cd coco-shelf
export PATH=$PATH:$HOME/coco-shelf/bin
make mirror-stuff done-lwtools done-cmoc done-toolshed done-nitros9

== Building FEU and OS-9 Level 1 from scratch ==
FEU is the Foenix Executive Utility. It resides in flash and hosts a debugger and booters that can bring up operating systems like OS-9. FEU runs under OS-9 Level 1, so go ahead and build the entire operating system:
cd nitros9
export NITROS9DIR=$PWD
cd level1/f256
make
cd feu
Now you can flash the image into the F256. You must have a USB cable connected to the system from your computer. 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. You can use a Linux VM and FoenixMgr tools in bridge mode on the Mac.

There are distinct builds of FEU for the F256 Jr and the F256K. Power up the machine, then select the correct command:
cd feu
make flash_f256jr
or
cd feu
make flash_f256k
Once the flash completes, restart the machine and FEU should come up.

== Building OS-9 Level 2 ==
To build OS-9 Level 2, run these commands:
cd ../../level2/f256
make dsk

This produces the following disk images for the F256 Jr and the F256K:

NOS9_6809_L2_v030300_f256jr_dw.dsk
NOS9_6809_L2_v030300_f256jr_sd.dsk
NOS9_6809_L2_v030300_f256k_dw.dsk
NOS9_6809_L2_v030300_f256k_sd.dsk

The ''dw'' disk images are for booting from DriveWire. The ''sd'' disk image are for booting from the SD card. You need to write the images onto an SD card, then insert the SD card into the F256 and restart.

Here's how to image the SD card.

==== Linux ====
On Linux, insert the SD card into your computer. Ttype <code>lsblk</code> to find the correct device and replace ''sdx'' on the command line below with it:

dd if=NOS9_6809_L2_v030300_f256k_sd.dsk of=/dev/''sdx''

==== macOS ====
On macOS, insert the SD card into your Mac. A dialog will likely appear telling you that the disk you attached isn't readable. Click the "ignore" button, then type <code>diskutil list external</code> to obtain the device name of the SD card and replace ''diskx'' on the command line below with it:
sudo dd if=NOS9_6809_L2_v030300_f256k_sd.dsk of=/dev/''diskx''
Once the command completes, type:
diskutil eject /dev/''diskx''
You can then safely remove the SD card.

OS-9

2024-06-26T01:57:14Z

104.61.174.70:

== Introduction ==
The FNX6809 combined with the F256 makes a great system for running OS-9/6809. [[wikipedia:OS-9|OS-9]] is 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

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 page, I'll refer to NitrOS-9 as OS-9.

== A word about platforms ==
This page assumes you're running on Linux or macOS. If you're using Windows, these instructions don't apply, and someone will have to step up and write steps to develop on that platform.

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

* [http://www.lwtools.ca lwtools] - an assembler/linker package
* [https://github.com/nitros9project/toolshed ToolShed] - a set of tools for creating disk images
* [https://github.com/nitros9project/nitros9 NitrOS-9] - the NitrOS-9 operating system in source form
* [https://github.com/pweingar/FoenixMgr FoenixMgr] - tools to load code into RAM or Flash of the F256.

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 terminal commands for Linux and macOS to pull down all the required software:
cd
git clone <nowiki>https://github.com/strickyak/coco-shelf.git</nowiki>
cd coco-shelf
export PATH=$PATH:$HOME/coco-shelf/bin
make mirror-stuff done-lwtools done-cmoc done-toolshed done-nitros9

== Building FEU and OS-9 Level 1 from scratch ==
FEU is the Foenix Executive Utility. It resides in flash and hosts a debugger and booters that can bring up operating systems like OS-9. FEU runs under OS-9 Level 1, so go ahead and build the entire operating system:
cd nitros9
export NITROS9DIR=$PWD
cd level1/f256
make
cd feu
Now you can flash the image into the F256. You must have a USB cable connected to the system from your computer. 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. You can use a Linux VM and FoenixMgr tools in bridge mode on the Mac.

There are distinct builds of FEU for the F256 Jr and the F256K. Power up the machine, then select the correct command:
cd feu
make flash_f256jr
or
cd feu
make flash_f256k
Once the flash completes, restart the machine and FEU should come up.

== Building OS-9 Level 2 ==
To build OS-9 Level 2, run these commands:
cd ../../level2/f256
make dsk

This produces the following disk images for the F256 Jr and the F256K:

NOS9_6809_L2_v030300_f256jr_dw.dsk
NOS9_6809_L2_v030300_f256jr_sd.dsk
NOS9_6809_L2_v030300_f256k_dw.dsk
NOS9_6809_L2_v030300_f256k_sd.dsk

The ''dw'' disk images are for booting from DriveWire. The ''sd'' disk image are for booting from the SD card.

On Linux, type <code>lsblk</code> to find the correct device and replace ''sdx'' on the command line below with it:

dd if=NOS9_6809_L2_v030300_f256k_sd.dsk of=/dev/''sdx''

On macOS, insert the SD card into your Mac. A dialog will likely appear telling you that the disk you attached isn't readable. Click the "ignore" button, then type <code>diskutil list external</code> to obtain the device name of the SD card and replace ''diskx'' on the command line below with it:
sudo dd if=NOS9_6809_L2_v030300_f256k_sd.dsk of=/dev/''diskx''

OS-9

2024-06-26T01:48:54Z

104.61.174.70:

== Introduction ==
The FNX6809 combined with the F256 makes a great system for running OS-9/6809. [[wikipedia:OS-9|OS-9]] is 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

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 page, I'll refer to NitrOS-9 as OS-9.

== A word about platforms ==
This page assumes you're running on Linux or macOS. If you're using Windows, these instructions don't apply, and someone will have to step up and write steps to develop on that platform.

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

* [http://www.lwtools.ca lwtools] - an assembler/linker package
* [https://github.com/nitros9project/toolshed ToolShed] - a set of tools for creating disk images
* [https://github.com/nitros9project/nitros9 NitrOS-9] - the NitrOS-9 operating system in source form
* [https://github.com/pweingar/FoenixMgr FoenixMgr] - tools to load code into RAM or Flash of the F256.

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 terminal commands for Linux and macOS to pull down all the required software:
cd
git clone <nowiki>https://github.com/strickyak/coco-shelf.git</nowiki>
cd coco-shelf
export PATH=$PATH:$HOME/coco-shelf/bin
make mirror-stuff done-lwtools done-cmoc done-toolshed done-nitros9

== Building FEU and OS-9 from scratch ==
FEU is the Foenix Executive Utility. It resides in flash and hosts a debugger and booters that can bring up operating systems like OS-9. FEU runs under OS-9 Level 1, so go ahead and build the entire operating system:
cd nitros9/level1/f256
make
cd feu
Now you can flash the image into the F256. You must have a USB cable connected to the system from your computer. 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. You can use a Linux VM and FoenixMgr tools in bridge mode on the Mac.

There are distinct builds of FEU for the F256 Jr and the F256K. Power up the machine, then select the correct command:
cd feu
make flash_f256jr
or
cd feu
make flash_f256k
Once the flash completes, restart the machine and FEU should come up.

== Assembling OS-9 Level 2 ==
Note: This assumes you have already built the '''''feu boot loader''''' and flashed it to the F256. Compiling NitrOS-9 requires lwtools and ToolShed.

==== Set the NITROS9DIR environment variable to the nitros9 directory ====
If you forget to do this, you will see an error when you compile like "*** No rule to make target '/rules.mak'."

cd nitros9
export NITROS9DIR=$PWD

==== Build lib and Rogue (if you want to play Rogue) ====
From the nitros9 directory:

cd lib
make
cd ../3rdparty/packages/rogue
make

==== Build Level 2 Disk Image for the F256 ====
From the nitros9 directory:

cd level2/f256
make dsk

: Note: ''do not type'' <code>make</code> ''in the root nitros9 directory. The nitros9 directory contains builds for every version and build of NitrOS-9 (coco, coco3, etc.). Make sure to invoke ''<code>make</code> ''from the level2/f256 directory to avoid compiling every possible iteration of the system. ''

This will produce 2 disk images:

NOS9_6809_L2_v030300_f256_dw.dsk
NOS9_6809_L2_v030300_f256_sd.dsk

The ''dw'' disk image will boot from DriveWire (if you have installed an ESP32 or ESP8266 and have a DriveWire server). The ''sd'' disk image will boot from the SD card. Use <code>dd</code> on Linux, etc. to flash the disk to an SD card. On Linux, '''''IF''''' the card is named /dev/sdx:

dd if=NOS9_6809_L2_v030300_f256_sd.dsk of=/dev/sdx

Note: '''This is just a sample command, your SD card is probably not named /dev/sdx'''. Check and make sure you are writing to the correct device. On Linux, type <code>lsblk</code> in a terminal to find the correct device. Substitute /dev/sdx in the above command with the correct device name for your SD card on your system. Double check the device name to avoid catastrophic data loss.

OS-9

2024-06-26T01:39:45Z

104.61.174.70: /* Compiling OS-9 Level 2 */

== Introduction ==
The FNX6809 combined with the F256 makes a great system for running OS-9/6809. [[wikipedia:OS-9|OS-9]] is 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

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 page, I'll refer to NitrOS-9 as OS-9.

== A word about platforms ==
This page 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.

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

* [http://www.lwtools.ca lwtools] - an assembler/linker package
* [https://github.com/nitros9project/toolshed ToolShed] - a set of tools for creating disk images
* [https://github.com/nitros9project/nitros9 NitrOS-9] - the NitrOS-9 operating system in source form
* [https://github.com/pweingar/FoenixMgr FoenixMgr] - tools to load code into RAM or Flash of the F256.

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).

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.

Here are the terminal commands for Linux and macOS to pull down all the required software:
cd
git clone <nowiki>https://github.com/strickyak/coco-shelf.git</nowiki>
cd coco-shelf
export PATH=$PATH:$HOME/coco-shelf/bin
make mirror-stuff done-lwtools done-cmoc done-toolshed done-nitros9

== Assembling OS-9 Level 2 ==
Note: This assumes you have already built the '''''feu boot loader''''' and flashed it to the F256. Compiling NitrOS-9 requires lwtools and ToolShed.

==== Set the NITROS9DIR environment variable to the nitros9 directory ====
If you forget to do this, you will see an error when you compile like "*** No rule to make target '/rules.mak'."

cd nitros9
export NITROS9DIR=$PWD

==== Build lib and Rogue (if you want to play Rogue) ====
From the nitros9 directory:

cd lib
make
cd ../3rdparty/packages/rogue
make

==== Build Level 2 Disk Image for the F256 ====
From the nitros9 directory:

cd level2/f256
make dsk

: Note: ''do not type'' <code>make</code> ''in the root nitros9 directory. The nitros9 directory contains builds for every version and build of NitrOS-9 (coco, coco3, etc.). Make sure to invoke ''<code>make</code> ''from the level2/f256 directory to avoid compiling every possible iteration of the system. ''

This will produce 2 disk images:

NOS9_6809_L2_v030300_f256_dw.dsk
NOS9_6809_L2_v030300_f256_sd.dsk

The ''dw'' disk image will boot from DriveWire (if you have installed an ESP32 or ESP8266 and have a DriveWire server). The ''sd'' disk image will boot from the SD card. Use <code>dd</code> on Linux, etc. to flash the disk to an SD card. On Linux, '''''IF''''' the card is named /dev/sdx:

dd if=NOS9_6809_L2_v030300_f256_sd.dsk of=/dev/sdx

Note: '''This is just a sample command, your SD card is probably not named /dev/sdx'''. Check and make sure you are writing to the correct device. On Linux, type <code>lsblk</code> in a terminal to find the correct device. Substitute /dev/sdx in the above command with the correct device name for your SD card on your system. Double check the device name to avoid catastrophic data loss.

OS-9

2024-06-26T00:37:25Z

104.61.174.70:

== Introduction ==
The FNX6809 combined with the F256 makes a great system for running OS-9/6809. [[wikipedia:OS-9|OS-9]] is 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

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 page, I'll refer to NitrOS-9 as OS-9.

== A word about platforms ==
This page 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 [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 [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 development is the fastest way to develop code for the F256. For this you need the following:

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

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 terminal commands for Linux and macOS to pull down all the required software:
cd
git clone <nowiki>https://github.com/strickyak/coco-shelf.git</nowiki>
cd coco-shelf
export PATH=$PATH:$HOME/coco-shelf/bin
make mirror-stuff done-lwtools done-cmoc done-toolshed done-nitros9

== Compiling OS-9 Level 2 ==
Note: This assumes you have already built the '''''feu boot loader''''' and flashed it to the F256. Compiling NitrOS-9 requires lwtools and ToolShed.

==== Set the NITROS9DIR environment variable to the nitros9 directory ====
If you forget to do this, you will see an error when you compile like "*** No rule to make target '/rules.mak'."

cd nitros9
export NITROS9DIR=$PWD

==== Build lib and Rogue (if you want to play Rogue) ====
From the nitros9 directory:

cd lib
make
cd ../3rdparty/packages/rogue
make

==== Build Level 2 Disk Image for the F256 ====
From the nitros9 directory:

cd level2/f256
make dsk

: Note: ''do not type'' <code>make</code> ''in the root nitros9 directory. The nitros9 directory contains builds for every version and build of NitrOS-9 (coco, coco3, etc.). Make sure to invoke ''<code>make</code> ''from the level2/f256 directory to avoid compiling every possible iteration of the system. ''

This will produce 2 disk images:

NOS9_6809_L2_v030300_f256_dw.dsk
NOS9_6809_L2_v030300_f256_sd.dsk

The ''dw'' disk image will boot from DriveWire (if you have installed an ESP32 or ESP8266 and have a DriveWire server). The ''sd'' disk image will boot from the SD card. Use <code>dd</code> on Linux, etc. to flash the disk to an SD card. On Linux, '''''IF''''' the card is named /dev/sdx:

dd if=NOS9_6809_L2_v030300_f256_sd.dsk of=/dev/sdx

Note: '''This is just a sample command, your SD card is probably not named /dev/sdx'''. Check and make sure you are writing to the correct device. On Linux, type <code>lsblk</code> in a terminal to find the correct device. Substitute /dev/sdx in the above command with the correct device name for your SD card on your system. Double check the device name to avoid catastrophic data loss.

OS-9

2024-06-26T00:28:55Z

104.61.174.70:

== Introduction ==
The FNX6809 combined with the F256 makes a great system for running OS-9/6809. [[wikipedia:OS-9|OS-9]] is 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

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 page, I'll refer to NitrOS-9 as OS-9.

== A word about platforms ==
This page 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 [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 [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 development is the fastest way to develop code for the F256. For this you need the following:

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

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:
cd
git clone <nowiki>https://github.com/strickyak/coco-shelf.git</nowiki>
cd coco-shelf
export PATH=$PATH:$HOME/coco-shelf/bin
make mirror-stuff done-lwtools done-cmoc done-toolshed done-nitros9

== Compiling OS-9 Level 2 ==
Note: This assumes you have already built the '''''feu boot loader''''' and flashed it to the F256. Compiling NitrOS-9 requires lwtools and ToolShed.

==== Set the NITROS9DIR environment variable to the nitros9 directory ====
If you forget to do this, you will see an error when you compile like "*** No rule to make target '/rules.mak'."

cd nitros9
export NITROS9DIR=$PWD

==== Build lib and Rogue (if you want to play Rogue) ====
From the nitros9 directory:

cd lib
make
cd ../3rdparty/packages/rogue
make

==== Build Level 2 Disk Image for the F256 ====
From the nitros9 directory:

cd level2/f256
make dsk

: Note: ''do not type'' <code>make</code> ''in the root nitros9 directory. The nitros9 directory contains builds for every version and build of NitrOS-9 (coco, coco3, etc.). Make sure to invoke ''<code>make</code> ''from the level2/f256 directory to avoid compiling every possible iteration of the system. ''

This will produce 2 disk images:

NOS9_6809_L2_v030300_f256_dw.dsk
NOS9_6809_L2_v030300_f256_sd.dsk

The ''dw'' disk image will boot from DriveWire (if you have installed an ESP32 or ESP8266 and have a DriveWire server). The ''sd'' disk image will boot from the SD card. Use <code>dd</code> on Linux, etc. to flash the disk to an SD card. On Linux, '''''IF''''' the card is named /dev/sdx:

dd if=NOS9_6809_L2_v030300_f256_sd.dsk of=/dev/sdx

Note: '''This is just a sample command, your SD card is probably not named /dev/sdx'''. Check and make sure you are writing to the correct device. On Linux, type <code>lsblk</code> in a terminal to find the correct device. Substitute /dev/sdx in the above command with the correct device name for your SD card on your system. Double check the device name to avoid catastrophic data loss.

OS-9

2024-06-26T00:28:30Z

104.61.174.70:

== Introduction ==
The FNX6809 combined with the F256 makes a great system for running OS-9/6809. [[wikipedia:OS-9|OS-9]] is 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

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 page, I'll refer to NitrOS-9 as OS-9.

== A word about platforms ==
This page 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 [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 [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 development is the fastest way to develop code for the F256. For this you need the following:

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

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:
cd
git clone <nowiki>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

== Compiling OS-9 Level 2 ==
Note: This assumes you have already built the '''''feu boot loader''''' and flashed it to the F256. Compiling NitrOS-9 requires lwtools and ToolShed.

==== Set the NITROS9DIR environment variable to the nitros9 directory ====
If you forget to do this, you will see an error when you compile like "*** No rule to make target '/rules.mak'."

cd nitros9
export NITROS9DIR=$PWD

==== Build lib and Rogue (if you want to play Rogue) ====
From the nitros9 directory:

cd lib
make
cd ../3rdparty/packages/rogue
make

==== Build Level 2 Disk Image for the F256 ====
From the nitros9 directory:

cd level2/f256
make dsk

: Note: ''do not type'' <code>make</code> ''in the root nitros9 directory. The nitros9 directory contains builds for every version and build of NitrOS-9 (coco, coco3, etc.). Make sure to invoke ''<code>make</code> ''from the level2/f256 directory to avoid compiling every possible iteration of the system. ''

This will produce 2 disk images:

NOS9_6809_L2_v030300_f256_dw.dsk
NOS9_6809_L2_v030300_f256_sd.dsk

The ''dw'' disk image will boot from DriveWire (if you have installed an ESP32 or ESP8266 and have a DriveWire server). The ''sd'' disk image will boot from the SD card. Use <code>dd</code> on Linux, etc. to flash the disk to an SD card. On Linux, '''''IF''''' the card is named /dev/sdx:

dd if=NOS9_6809_L2_v030300_f256_sd.dsk of=/dev/sdx

Note: '''This is just a sample command, your SD card is probably not named /dev/sdx'''. Check and make sure you are writing to the correct device. On Linux, type <code>lsblk</code> in a terminal to find the correct device. Substitute /dev/sdx in the above command with the correct device name for your SD card on your system. Double check the device name to avoid catastrophic data loss.

OS-9

2024-06-26T00:26:46Z

104.61.174.70:

== Introduction ==
The FNX6809 combined with the F256 makes a great system for running OS-9/6809. [[wikipedia:OS-9|OS-9]] is 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

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 page, I'll refer to NitrOS-9 as OS-9.

== A word about platforms ==
This page 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 [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 [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 development is the fastest way to develop code for the F256. For this you need the following:

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

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:
<code>
cd
git clone <nowiki>https://github.com/strickyak/coco-shelf.git</nowiki>
cd coco-shelf
export PATH=$PATH:$HOME/coco-shelf/bin
make mirror-stuff done-lwtools done-cmoc done-toolshed done-nitros9
</code>

== Compiling OS-9 Level 2 ==
Note: This assumes you have already built the '''''feu boot loader''''' and flashed it to the F256. Compiling NitrOS-9 requires lwtools and ToolShed.

==== Set the NITROS9DIR environment variable to the nitros9 directory ====
If you forget to do this, you will see an error when you compile like "*** No rule to make target '/rules.mak'."

cd nitros9
export NITROS9DIR=$PWD

==== Build lib and Rogue (if you want to play Rogue) ====
From the nitros9 directory:

cd lib
make
cd ../3rdparty/packages/rogue
make

==== Build Level 2 Disk Image for the F256 ====
From the nitros9 directory:

cd level2/f256
make dsk

: Note: ''do not type'' <code>make</code> ''in the root nitros9 directory. The nitros9 directory contains builds for every version and build of NitrOS-9 (coco, coco3, etc.). Make sure to invoke ''<code>make</code> ''from the level2/f256 directory to avoid compiling every possible iteration of the system. ''

This will produce 2 disk images:

NOS9_6809_L2_v030300_f256_dw.dsk
NOS9_6809_L2_v030300_f256_sd.dsk

The ''dw'' disk image will boot from DriveWire (if you have installed an ESP32 or ESP8266 and have a DriveWire server). The ''sd'' disk image will boot from the SD card. Use <code>dd</code> on Linux, etc. to flash the disk to an SD card. On Linux, '''''IF''''' the card is named /dev/sdx:

dd if=NOS9_6809_L2_v030300_f256_sd.dsk of=/dev/sdx

Note: '''This is just a sample command, your SD card is probably not named /dev/sdx'''. Check and make sure you are writing to the correct device. On Linux, type <code>lsblk</code> in a terminal to find the correct device. Substitute /dev/sdx in the above command with the correct device name for your SD card on your system. Double check the device name to avoid catastrophic data loss.

OS-9

2024-01-28T17:27:07Z

104.61.174.70: /* Compiling OS-9 Level 2 */

== Introduction ==
The FNX6809 combined with the F256 makes a great system for running OS-9/6809. [[wikipedia:OS-9|OS-9]] is 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

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 page, I'll refer to NitrOS-9 as OS-9.

== A word about platforms ==
This page 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 [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 [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 development is the fastest way to develop code for the F256. For this you need the following:

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

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:
<code>cd
git clone <nowiki>https://github.com/strickyak/coco-shelf.git</nowiki>
cd coco-shelf
export PATH=$PATH:$HOME/coco-shelf/bin
make mirror-stuff done-lwtools done-cmoc done-toolshed done-nitros9</code>

== Compiling OS-9 Level 2 ==
Note: This assumes you have already built the '''''feu boot loader''''' and flashed it to the F256. Compiling NitrOS-9 requires lwtools and ToolShed.

==== Set the NITROS9DIR environment variable to the nitros9 directory ====
If you forget to do this, you will see an error when you compile like "*** No rule to make target '/rules.mak'."

cd nitros9
export NITROS9DIR=$PWD

==== Build lib and Rogue (if you want to play Rogue) ====
From the nitros9 directory:

cd lib
make
cd ../3rdparty/packages/rogue
make

==== Build Level 2 Disk Image for the F256 ====
From the nitros9 directory:

cd level2/f256
make dsk

: Note: ''do not type'' <code>make</code> ''in the root nitros9 directory. The nitros9 directory contains builds for every version and build of NitrOS-9 (coco, coco3, etc.). Make sure to invoke ''<code>make</code> ''from the level2/f256 directory to avoid compiling every possible iteration of the system. ''

This will produce 2 disk images:

NOS9_6809_L2_v030300_f256_dw.dsk
NOS9_6809_L2_v030300_f256_sd.dsk

The ''dw'' disk image will boot from DriveWire (if you have installed an ESP32 or ESP8266 and have a DriveWire server). The ''sd'' disk image will boot from the SD card. Use <code>dd</code> on Linux, etc. to flash the disk to an SD card. On Linux, '''''IF''''' the card is named /dev/sdx:

dd if=NOS9_6809_L2_v030300_f256_sd.dsk of=/dev/sdx

Note: '''This is just a sample command, your SD card is probably not named /dev/sdx'''. Check and make sure you are writing to the correct device. On Linux, type <code>lsblk</code> in a terminal to find the correct device. Substitute /dev/sdx in the above command with the correct device name for your SD card on your system. Double check the device name to avoid catastrophic data loss.

OS-9

2024-01-28T17:26:40Z

104.61.174.70: /* Build Level 2 Disk Image for the F256 */

== Introduction ==
The FNX6809 combined with the F256 makes a great system for running OS-9/6809. [[wikipedia:OS-9|OS-9]] is 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

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 page, I'll refer to NitrOS-9 as OS-9.

== A word about platforms ==
This page 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 [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 [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 development is the fastest way to develop code for the F256. For this you need the following:

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

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:
<code>cd
git clone <nowiki>https://github.com/strickyak/coco-shelf.git</nowiki>
cd coco-shelf
export PATH=$PATH:$HOME/coco-shelf/bin
make mirror-stuff done-lwtools done-cmoc done-toolshed done-nitros9</code>

== Compiling OS-9 Level 2 ==
Note: This assumes you have already built the '''''feu boot loader''''' and flashed it to the F256. Compiling NitrOS-9 requires lwtools and ToolShed.

==== Set the NITROS9DIR environment variable to the nitros9 directory ====
If you forget to do this, you will see an error when you compile like "*** No rule to make target '/rules.mak'."

cd nitros9
export NITROS9DIR=$PWD

==== Build lib and Rogue (if you want to play Rogue) ====
From the nitros9 directory:

cd lib
make
cd ../3rdparty/packages/rogue
make

==== Build Level 2 Disk Image for the F256 ====
From the nitros9 directory:

cd level2/f256
make dsk

: Note: ''do not type'' <code>make</code> ''in the root nitros9 directory. The nitros9 directory contains builds for every version and build of NitrOS-9 (coco, coco3, etc.). Make sure to invoke ''<code>make</code> ''from the level2/f256 directory to avoid compiling every possible iteration of the system. ''

This will produce 2 disk images:

NOS9_6809_L2_v030300_f256_dw.dsk
NOS9_6809_L2_v030300_f256_sd.dsk

The ''dw'' disk image will boot from DriveWire (if you have installed an ESP32 or ESP8266 and have a DriveWire server). The ''sd'' disk image will boot from the SD card. Use dd on Linux, etc. to flash the disk to an SD card. On Linux, '''''IF''''' the card is named /dev/sdx:

dd if=NOS9_6809_L2_v030300_f256_sd.dsk of=/dev/sdx

Note: '''This is just a sample command, your SD card is probably not named /dev/sdx'''. Check and make sure you are writing to the correct device. On Linux, type <code>lsblk</code> in a terminal to find the correct device. Substitute /dev/sdx in the above command with the correct device name for your SD card on your system. Double check the device name to avoid catastrophic data loss.

OS-9

2023-12-17T19:46:42Z

104.61.174.70: /* Introduction */

OS-9

2023-12-15T02:45:10Z

104.61.174.70: /* Cross-hosted software */

== Introduction ==
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

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 page, I'll refer to NitrOS-9 as OS-9.

== A word about platforms ==
This page 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 [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 [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 development is the fastest way to develop code for the F256. For this you need the following:

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

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:
<code>cd
git clone <nowiki>https://github.com/strickyak/coco-shelf.git</nowiki>
cd coco-shelf
export PATH=$PATH:$HOME/coco-shelf/bin
make mirror-stuff done-lwtools done-cmoc done-toolshed done-nitros9</code>

OS-9

2023-12-15T02:44:22Z

104.61.174.70: /* Cross-hosted software */

== Introduction ==
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

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 page, I'll refer to NitrOS-9 as OS-9.

== A word about platforms ==
This page 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 [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 [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 development is the fastest way to develop code for the F256. For this you need the following:

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

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:
<code>
cd
git clone <nowiki>https://github.com/strickyak/coco-shelf.git</nowiki>
cd coco-shelf
export PATH=$PATH:$HOME/coco-shelf/bin
make mirror-stuff done-lwtools done-cmoc done-toolshed done-nitros9
</code>

OS-9

2023-12-15T02:43:28Z

104.61.174.70:

OS-9

2023-12-15T02:42:59Z

104.61.174.70:

== Introduction ==
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

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.

== 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 [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 [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 development is the fastest way to develop code for the F256. For this you need the following:

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

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:
<code>cd
git clone <nowiki>https://github.com/strickyak/coco-shelf.git</nowiki>
cd coco-shelf
export PATH=$PATH:$HOME/coco-shelf/bin
make mirror-stuff done-lwtools done-cmoc done-toolshed done-nitros9</code>

OS-9

2023-12-15T02:38:39Z

104.61.174.70: /* Foenix-specific tools */

== 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. 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 [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.

== 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, 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).

Here are the commands to type at the terminal to pull down all the required software:
<code>cd
git clone <nowiki>https://github.com/strickyak/coco-shelf.git</nowiki>
cd coco-shelf
export PATH=$PATH:$HOME/coco-shelf/bin
make mirror-stuff done-lwtools done-cmoc done-toolshed done-nitros9</code>

OS-9

2023-12-15T02:37:39Z

104.61.174.70:

== 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. 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, 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).

Here are the commands to type at the terminal to pull down all the required software:
<code>cd
git clone <nowiki>https://github.com/strickyak/coco-shelf.git</nowiki>
cd coco-shelf
export PATH=$PATH:$HOME/coco-shelf/bin
make mirror-stuff done-lwtools done-cmoc done-toolshed done-nitros9</code>

OS-9

2023-12-15T02:36:31Z

104.61.174.70: Created page with "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."

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.