BIF-6809 のインストール方法

What You Need to Get Started 始めるに必要なのは:

To "install" BIF-6809 on a Color Computer or a Color Computer emulator, the first thing you need is the hardware or the emulator.
BIF-6809 を「インストール」するに必要なのは先ず、そのコンピュータもしくはエミュレーターです。タンディ・ラジオシャック社製造のカーラーコンピュータは日本にあまり知られていないが、エミュレーターなら手に入れることはできるでしょう。


The Tandy Radio Shack Color Computer 1 or 2 should run it okay. The 3 will run it when using the 1/2 mode's 32 column screen, as I recall.

I'm not sure whether the Welsh Dragon shares enough of the low-level API to run it as it is, but it probably would not require much to get it to run. (I do recognize the irony here. I do plan to try to get it running on the Dragon in appreciation.)

It should be fairly easily portable to other computers which use the 6809 as the main CPU.
他の 6809 を主CPU とするコンピュータに移植するのはそれほど難しくないと思います。

The parts that need primary attention when moving it to another computer using the 6809 are character input and output and disk input and output.

The 6847-dependent 32 column small-screen editor will also take some work, or you probably should trade it for a proper Forth Screen editor anyway.
6847依存の 32桁小型スクリーンエディタにも若干の手入れが必要でしょう。或いは、通常の Forth スクリーン型エディタを替りに使うことをお薦めします。

The XRoar Emulator

I used the Dragon's excellent XRoar ( emulator to bring this all back up, so I will describe how I did that.
これらを復活させるに使ったのはそのとてもすばらしい龍の XRoarエミュレータでした。それを想定に話を進みます。

I downloaded the XRoar archive (.tar.gz), unpacked it in its own directory, and did the usual configure-make routine described therein, but I did not do a make-install.
いつもの通り、(.tar.gzの)アーカイブをダウンロードし、専用のディレクトリに解凍、その中に説明される configure-make の手順に従ったが、 make-install はやめたのです。

That means I have to specify the path when running it, something like this:
../../xroar-0.35.3/src/xroar -machine coco2bus -bas ../../roms/Color\ Basic\ v1.3\ \(1982\)\(Tandy\).rom -extbas ../../roms/Extended\ Colour\ Basic\ v1.0\ \(1981\)\(Tandy\)/coco.rom -cart rsdos -cart-rom ../../roms/Color\ Computer\ Controller\ \(1982\)\ \(26-3022\).rom -keymap us -kbd-translate &

You choose your poison. You'll need to plan a bit of time to get used to running it, using disk images, etc. Make sure you figure out disk images.

I won't describe the assembly language development environment here, at least, not yet.

Hardware  ハードウェア

If you have the hardware, you probably know what to do. Use your favorite method to write the above two images to floppy disks (or make emulated floppy disk images, as the case may be).

The tools disk goes in the first drive (Color Computer drive 0).
その tools のディスクは最初のドライブ(Color Computer ドライブ 0)に、

The bifsource disk goes in the second drive (Color Computer drive 1).
その bifsource のディスクは二次のドライブ(Color Computer ドライブ 1)に挿入されます。

Launching and Running BIF-6809 --- BIF-6809 を稼働させる

Once you're used to the emulator, download BIF-6809 here and unpack it somewhere close to XRoar. Even if you do the make-install step, you'll want to be able to use reasonably short paths to point to the ROM images.
エミュレータに慣れたら、 BIF-6809 をここからダウンロードして XRoar の置き場の近くに解凍しましょう。 make-install やっても、ロムイメージまでのパスがやや簡単な場所が望ましく思います。

The Files You Need from Here  ここから要るファイル

Look here:

You can get the bleeding edge snapshot (which I recommend) by finding the ZIP and TAR export buttons and clicking the one appropriate to you. (If you're not sure, probably ZIP.)
(私が推薦します)最先端・血まみれ瞬間映像の塊を手に入れるのは ZIP 及び TAR エクスポートボタンを探して自分に適している方をクリックします。(わからない場合は恐らく ZIP でしょう。)

The files you want are
お狙いのファイルはサブディレクトリ edtasm_v の中の

  • tools.dsk
  • bifsource.dsk

in the edtasm_v directory.

Or, if you really don't want the tarball, I think you can download them from the tree tree view, depending on ....

The disk image with the BIF-6809 executable is "bifsource.dsk" inside the edtasm_v subdirectory. Use the GUI dialogs or the command-line to attach the disk image to the second drive and check it in DISK Extended Basic:
BIF-6809の稼働可能ファイルは edtasm_v の中にある "bifsource.dsk" です。GUI のダイアログもしくはコマンドラインパラメータを使って、ディスクイメージを取り付けるのです。

XRoar: Tool menu => Drive Control (check)
The drive control dialog will pop up. In that, click the Insert button for Drive 2:
XRoar Drive Control: Drive 2: Insert
A file open dialog pops up, allowing you to go hunting for the bifsource.dsk disk image. Select it and click "Open".
ファイルオープンのダイアログがでてきて、 bifsource.dsk が探せたら、セレクトして「開く」をクリック。

While we are here, click the Insert button for Drive 1, and select the "tools.dsk" disk image in the same directory so that error messages will be a little more than just numbers.
序に、ナマの番号より詳しいエラーメッセージが出せるようにドライブ1の挿入ボタンもクリックし、同じディレクトリにある "tools.dsk" のディスクイメージを選んで取り付けましょう。

Loading and Running  導入及び稼働

Back in the Color Computer or emulator, type this in BASIC:
You should get a listing that runs off the top of the screen.
BIF6B        ASM   3 A 3
BIF6809N  BIN    2 B 4
BIF7          ASM   3 A 3
BIF7B        ASM   3 A 2
BIF6809    BIN     2 B 4

And you get the flashing cursor. Now type
It takes a minute or so, then the OK prompt and the flashing cursor return. Type:
およそ一分が掛かると思います。 OKの刺激文字と点滅するカーソルが戻ってきたら打ち込むのは
EXEC &H1300
And it should respond with
6809 BIF V1.0
and a white cursor that does not flash.

To check that it is running, type
You should get a long list of vocabulary and addresses that ends with
[ 8715
[COMPILE] 12832
] 8738

To further check, you might try typing a simple definition or two:
:  STAR  42  EMIT  ;
To see if it worked, type "STAR" and enter and it should give you an asterisk: "*".
定義が利いたかを診るに "STAR" と改行を打ちこめば、アステリスクが出てくるはずです: "*"


One more:
:  STARS  0  DO  STAR  LOOP  ;
then type
**********  OK

Says your interpreter is at least sort-of functioning.
If you know Forth, this should be enough to get you going.
Forth にある程度精通している方はこれで多分使えると思います。

The How to Use page ( may also be of use.

If you have problems, leave me a note in the HELP forum. (It may take me a few days to respond.)