This v4 release supports the TFR/911H single board computer.
We could and should port it to the TFR/905H, but for now, it's only the TFR/911H.
These instructions should work on Ubuntu.
Install pico-sdk and picotool in the superdirectory
of the tfr9 directory. This is often the coco-shelf or
turbo-shelf directory. I used version 2.3.0 of these tools.
You need the Go compiler. If you don't have the latest, you can probably edit the go.mod files to reduce the version required.
cd tfr9/v4
make clean
make all
The products will be in the build directory.
/coco-shelf/tfr9/v4$ ls build
listings tether.linux-amd64.exe tether.linux-arm-7.exe tether.mac-arm64.exe tether.win-amd64.exe
tether.linux-386.exe tether.linux-arm64.exe tether.mac-amd64.exe tether.win-386.exe tfr911h_v4.uf2
Inside the /v4/ directory, you can make flash to flash
new firmware into the TFR/911H. (Hold down the button marked
FLASH while you either Plug In (power up) the board or
RESET the board with the button marked RESET.
make flash
To connect to the board over the USB cable with the tether program,
you can either make run or you can sh tether.sh.
make run OR
sh tether.sh
If nothing happens, look in the file named _log for errors.
In this release, when you restart the TFR911H, you will initially get a TCL SHELL with the prompt "TCL>". Hit Enter a time or two if you don't see it.
This shell is not yet very useful, but soon it will be how you configure what you want to run on your board.
To exit the shell and start running the 6809/6309, type "bye".
TCL> bye
This is an old version of Tcl from 1993, release 6.7, that has been updated for modern gcc and enhanced with commands for manipulating data on the TFR/911H.
While you are in the TCL SHELL, you can manipulate the 11MB filesystem on the FLASH Storage of the Pico.
THIS IS NOT USEFUL YET, but soon it will be.
Lots of simple UNIX commands work if you use them in their simplest forms:
cd pwd ls cp mv rm mkdir rmdir cat hd
df du file wc grep
There is always a special mount named "/pc". This is a remote mount from a directory on the PC. By default it is the directory "/tmp/pc".
To load files onto the Pico filesytem, first copy them on your PC into the directory "/tmp/pc". Then boot the TFR/911h and use the TCL shell to copy files from "/pc" to the place you want in the Pico filesystem.
AT THE MOMENT, you don't have any choice what OS to run, unless you hack it yourself. You get Turbo9 OS with a Basic09 command so you can experiment and do stuff.
We'll try and get more capabilities Really Soon Now.
If you type "MDIR" you can see the other commands available to you. This version of Turbo9 OS has no disk device, so you cannot save or load files in it.
The file v4/tfr911h/turbo9os.rom.h contains OS9
modules. (Notice it begins with $87 $CD).
The kernel MUST be first, because a simple heuristic
is used to find the kernel entry for the 6809 RESET vector.
Rewrite that file with the modules you want to boot.
Basic09 gets added on by this line:
/coco-shelf/tfr9/v4$ grep RomList tfr911h/v4_tfr911h_main.cpp
RomList<Turbo9os_Rom, Basic09_Rom>>,
/coco-shelf/tfr9/v4$
Notice since Kernel is first in Turbo9os_Rom, it will be first in the RomList, as it must.