Editing OS-9 (section)

== 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 ANON=1 nitros9/done FoenixMgr/done

(If you have a github account and your github ssh key is loaded,
you can omit `ANON=1` on the last command,
so it will check out git repositories using your github username,
in case you want to push changes.)

There is a special Make target for re-flashing the F256Jr or F256K,
but first time you run this command, it should fail.  
Then you have to edit the `port=` line in `FoenixMgr/foenixmgr.ini`
and run the command again (with the cable plugged in): 
 make ANON=1 run-f256-flash        # Old command for F256Jr that works?
or
 make ANON=1 run-f256jr-flash      # TODO fix this
or
 make ANON=1 run-f256k-flash       # TODO fix this