Editing
OS-9
From F256 Foenix
Jump to navigation
Jump to search
Warning:
You are not logged in. Your IP address will be publicly visible if you make any edits. If you
log in
or
create an account
, your edits will be attributed to your username, along with other benefits.
Anti-spam check. Do
not
fill this in!
== 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.
Summary:
Please note that all contributions to F256 Foenix are considered to be released under the Creative Commons Zero (Public Domain) (see
F256 Foenix:Copyrights
for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource.
Do not submit copyrighted work without permission!
Cancel
Editing help
(opens in new window)
Navigation menu
Page actions
Page
Discussion
Read
Edit
Edit source
History
Page actions
Page
Discussion
More
Tools
Personal tools
Not logged in
Talk
Contributions
Create account
Log in
Navigation
Main page
Recent changes
Random page
Help about MediaWiki
Search
Tools
What links here
Related changes
Special pages
Page information