by CaptainYS
https://github.com/captainys/TOWNSEMU/releases/latest
It is an emulator of legendary Fujitsu FM TOWNS computer including Marty. The goal is to emulate model II MX, which was the last computer I pledged allegiance. I think I can say this initial goal has very well been achieved.
Also I am trying to find and document undocumented features of FM TOWNS system as much as possible while writing the emulator.
Have been tested primarily on Windows 10 and macOS. I think it runs on Linux ok based on the user reports. (Thank you for the reports!)
伝説の名機富士通FM TOWNS/Martyのエミュレータです。目標はモデルII MXを再現することです。この目標は、ほぼ達成できたと思っています。FM TOWNS II MXは僕が最後に忠誠を誓った機種でした。
また、開発と並行してFM TOWNSのシステムで未公開の機能を見つけて記録に残すことも目標にしています。
とりあえず、Windows 10とmacOSXで動きます。Linuxも対応したと思うんですが、Virtual Box上の開発環境だと普通に音が鳴るのですが、直接起動しているLinuxで音が出ないという報告があるのですが、まだ確認できてません。
The ROM set is compatible with another FM TOWNS emulator UNZ. You can get the best experience if you own an actual FM TOWNS hardware and extract ROM image from your TOWNS. However, if you do not own your FM TOWNS hardware, you can use the following free version of the ROM.
http://ysflight.com/FM/towns/FreeTOWNS/e.html
ROMイメージはFM TOWNSエミュレータUNZと互換性があります。実機を所有している方は、実機から抜き出したROMイメージを使うのが最も高い再現性を出すことができますが、実機を所有していない場合は、以下のURLからフリーの互換ROMをダウンロードして使うことができます。
http://ysflight.com/FM/towns/FreeTOWNS/j.html
Tsugaru supports .ISO, .CUE and .MDS file format for a CD image. If the CD has an audio track, .MDS or .CCD is highly recommended. I do not recommend .CUE file since it is absolutely inappropriate from the preservation point of view.
My .CUE interpreter is based on Alcohol 52%, which seems to agree with CD Manipulator, but there is no guarantee .CUE file made by other programs can run correctly with Tsugaru.
.CUE file is TOTALLY INAPPROPRIATE for preservation because of the ambiguity in interpretation of PREGAP. The following is the beginning of the .CUE file generated by Alcohol 52% 2.1.1:
FILE "TAITO_CHASE_H_Q.BIN" BINARY
TRACK 01 MODE1/2352
INDEX 01 00:00:00
TRACK 02 AUDIO
PREGAP 00:02:00
INDEX 01 00:58:00
TRACK 03 AUDIO
INDEX 01 02:11:05
and ImgBurn 2.5.8.0.
FILE "TAITO_CHASE_H_Q.BIN" BINARY
TRACK 01 MODE1/2352
INDEX 01 00:00:00
TRACK 02 AUDIO
PREGAP 00:02:00
INDEX 01 00:58:00
TRACK 03 AUDIO
INDEX 00 02:04:05
INDEX 01 02:09:05
from the same disc, TAITO Chase HQ (track 4 and the rest are omitted.)
As you can see, the starting time of track 3 from Alcohol 52% is 2:11:05 and ImgBurn 02:09:05. DIFFERENT FOR THE SAME DISC!
Alcohol 52%'s interpretation is this, PREGAP affects only the track that PREGAP keyword exists. From the CD-Player point of view, the starting time of TRACK 2 needs to be added by 2 seconds to skip PREGAP. The rest of the tracks are unaffected.
However, ImgBurn's interpretation is this, PREGAP affects the all the tracks after PREGAP keyword. For CD-Player, the starting time of TRACK 2 and the rest tracks needs to be added by 2 seconds.
Tsugaru has no way of identifying which interpretation was used for generating .CUE file.
I have not experienced such an ambiguity in .MDS/.MDF file format. Therefore, .MDF is highly recommended.
If you are on preservation, my recommendation is do not use .CUE file. If you do, make sure .CUE file does not use PREGAP and POSTGAP.
After some survey, looks like ImgBurn is better align with CDRWIN? Also CD Manipulator does not PREGAP and POSTGAP, instead it uses INDEX 00, which does not have ambiguity. Tsugaru will support .CUE file created by ImgBurn and CD Manipulator. But, .CUE files created by other application may not run correctly on Tsugaru.
津軽は、CDイメージフォーマットとして、.ISO, .CUE, .MDSフォーマットをサポートしますが、オーディオトラックがある場合、.MDSまたは.CCDフォーマットを推奨します。.CUEフォーマットは、PREGAPの解釈が曖昧なため、保存という観点でまったくお勧めできません。ゲームの保存が目的ならば、今すぐ使用を停止するべきで、.MDSに置き換えるべきです。
津軽の.CUEインタープリタはAlcohol 52%が生成する.CUEファイルを前提としています。どうもCD Manipulatorが出力する.CUEファイルも一致するようです。ですが、他のプログラムを使って生成した.CUEファイルでは津軽で正常に使用できない可能性があります。
.CUEファイルがゲームの保存に不向きである理由は、次の例からわかります。下は、Alcohol 52% 2.1.1を使って生成した.CUEファイルです。
FILE "TAITO_CHASE_H_Q.BIN" BINARY
TRACK 01 MODE1/2352
INDEX 01 00:00:00
TRACK 02 AUDIO
PREGAP 00:02:00
INDEX 01 00:58:00
TRACK 03 AUDIO
INDEX 01 02:11:05
そして、下はImgBurn 2.5.8.0で生成した.CUEファイルです。どちらもTAITO Chase H.Q.のディスクから生成したものです。なお、トラック4以降は省略しました。
FILE "TAITO_CHASE_H_Q.BIN" BINARY
TRACK 01 MODE1/2352
INDEX 01 00:00:00
TRACK 02 AUDIO
PREGAP 00:02:00
INDEX 01 00:58:00
TRACK 03 AUDIO
INDEX 00 02:04:05
INDEX 01 02:09:05
見ればわかる通り、トラック3の開始時間は Alcohol 52% によると 2:11:05、ImgBurnによると02:09:05と出ています。同じディスクなのに！
Alcohol 52%の解釈では、PREGAPはそれが存在するトラックにのみ影響して、CDプレイヤーから見るとそのトラックの開始時間はINDEX 01の時間にPREGAPの2秒を加えた時間、それ以外のトラックは、INDEX 01の値そのままということのようです。
しかし、ImgBurnの解釈では、PREGAPはそれが存在するトラック以降のすべてのトラックに影響するということのようです。例えば、トラック3の開始時間はINDEX 01の値にPREGAPの2秒を加えるとAlcohol 52%が出力する時間と一致します。
どちらの解釈なのか、その情報は.CUEファイルのどこにも書いていないので、.CUEファイルから判定することができません。
ですが、これまでのところ.MDS/.MDFファイルではそのような曖昧さに当たったことはありません。なので、.MDFファイルを使用することを推奨します。
また、ゲームの保存、アーカイブを目的とするならば、今すぐ.CUEファイルの使用をやめて.MDS/.MDFファイルに置き換えることを勧めます。.CUEファイルをどうしても使う場合は、PREGAPとPOSTGAPキーワードを使わないアプリケーションでイメージを作成することを勧めます。
どうもImgBurnを使う方がCDRWINと近いCUEファイルを生成するようで、またCD Manipulatorが出力するCUEファイルはPREGAP, POSTGAPキーワードを使わない(代わりにINDEX 00を使用)ようなので、このふたつのアプリケーションが出力したCUEファイルはサポートしますが、それ以外のプログラムが出力したCUEファイルでは正常に動作しない可能性があります。
The emulation is getting better. Thanks to the great help from the users and contributors around the world, with conservative estimate Tsugaru can run more than 97% of the FM TOWNS commercial application titles. Emulation state is in the Wiki (https://wiki3.jp/fmtowns/page/10). Wiki is set up by WINDY. (Thanks!) Overall, I think it is safe to say more than 97% of FM TOWNS apps works.
80486 emulation is, getting faster, but there is a room for improvement. Will be improved down the road.
Not-all instructions of Intel 80486 processor have been implemented yet. Since the emulator has its own debugger, no plan to support debug registers. Nonetheless, the CPU core does pass TEST386 enhanced tests now. The emulation quality is reasonably high. If you want to run Windows 3.1, Windows 95, or early-day Linux on Tsugaru, make sure to enable the High-Fidelity mode. Since Towns OS apps do not use many exception handlings and task registers, these CPU features are turned off by default.
エミュレーションはかなりよくなってきて、世界中のユーザとコントリビュターの皆さまのご協力により、少なく見積もってFM TOWNS用に発売されたソフトの97%以上が動作可能と推定しています。また、ユーザによる動作確認もWikiに上がってきています。(https://wiki3.jp/fmtowns/page/10) WikiはWINDYさんがセットアップしてくださいました。ありがとうございます。現状で、少なく見積もって97%以上のFM TOWNSアプリケーションを実行できると言えるようです。
80486エミュレーションは速くなってきましたが、まだ改善の余地があります。少しずつスピードアップしていきます。
80486のすべてのインストラクションをエミュレートできてませんが、TEST386の拡張テストまで通過するレベルになりました。ただし、津軽自体にデバッガがあるのでCPUのデバッグ機能のサポートの予定はありません。もしも、FM TOWNS用Windows 3.1, 95または古代のLinuxを津軽で実行したい場合は、High-Fidelityモードを有効にしてください。Towns OSのアプリケーションは、ハードウェアタスクスイッチング、例外処理などのCPU機能を使っていないので、デフォルト設定では、それらの機能はオフになっていて、その分処理速度を上げています。
Open Source with 3-clause BSD License.
For Windows Visual C++:
git clone https://github.com/captainys/TOWNSEMU.git
cd .\TOWNSEMU\gui\src
git clone https://github.com/captainys/public.git
cd ..
mkdir build
cd build
cmake ../src
cmake --build . --config Release --parallel
For macOS:
git clone https://github.com/captainys/TOWNSEMU.git
cd TOWNSEMU/gui/src
git clone https://github.com/captainys/public.git
cd ..
mkdir build
cd build
cmake ../src
cmake --build . --config Release
cp main_cui/Tsugaru_CUI.app/Contents/MacOS/Tsugaru_CUI main_gui/Tsugaru_GUI.app/Contents/MacOS/.
main_gui/Tsugaru_GUI.app/Contents/MacOS/Tsugaru_GUI
In Windows and Linux, just start Tsugaru_GUI. It internally uses Tsugaru_CUI, therefore two programs must be in the same directory.
In macOS, start the app bundle Tsugaru_GUI.
WindowsとLinuxではTsugaru_GUIを起動してください。中でTsugaru_CUIを使うので、同じディレクトリに両方のプログラムを置いてください。
macOSでは、Tsugaru_GUIアプリケーションを実行してください。
After 20251004, you can use special paths ${progdir} and ${profiledir} to specify files in the GUI. You also can change the base directory, where options, recent files, and default profile are stored by the command-line option:
-basedir directory_name
You can use ${progdir} in the directory name given to the -basedir option.
With these additions, you can set up a directory in a portable drive, save all Tsugaru executables, copy disc/disk/ROM images in the sub-directories, and write a launcher, like by a batch file or a script to start the executable as:
Tsugaru_GUI -basedir ${progdir}
(* In macOS, ${progdir} points to Tsugaru_GUI.app/Contents/Resources, so make it like ${progdir}/../..)
Then, you can set up your profiles all relative to the ${profiledir}.
You can also select files and directories from the GUI, and select a menu, Make File/Dir Names Relative to ${profiledir}, in the File menu to make all files relative.
20251014バージョン以降、特殊なパス名、${progdir}と${profiledir}をGUI環境で使うことができます。また、デフォルトプロファイル、オプション、最近使ったファイル等を保存するベースディレクトリを、次のコマンドオプションで指定することができるようになりました。
-basedir directory_name
directory_nameには${progdir}のみ使用可能です。
この機能により、ポータブルディスクドライブに津軽用のディレクトリを作成し、津軽の実行ファイルをそのディレクトリに、ディスクイメージ、ROMイメージ等をそのサブディレクトリにコピーして、簡単な起動ようスクリプトを書くことで、ポータブルな実行環境を作成することができます。起動スクリプトは、Tsugaru_GUIを次のように起動します。
Tsugaru_GUI -basedir ${progdir}
なお、macOS環境では、${progdir}は、Tsugaru_GUI.app/Contents/Resourcesを指すので、${progdir}/../..のように二つ上のディレクトリを指すようにすると良いでしょう。
こうすることで、あとはすべてのファイルやディレクトリを${profiledir}からの相対パスで指定することができます。
また、セットアップに関しては、普通にファイルセレクタでファイルを選択してから、ファイルメニューの、「プロファイルのファイル名を${profiledir}からの相対パスにする」を選ぶことで、選択したファイル名やディレクトリ名を相対パス化することができます。
It starts from terminal/command prompt. The basic options are:
main_cui ROM_FILE_PATH -CD CD_IMAGE_FILE -FD0 FD0_IMAGE_FILE
CD-image can be .ISO or .CUE or .MDS. .MDS is recommended if the CD has audio tracks. Floppy-disk image can be raw-binary or .D77 file. You can look into scripts sub-directories for samples of other options.
You can see the help by typing:
main_cui -HELP
I add some command samples below. Please see also command.md
コマンドから起動します。
main_cui ROM_FILE_PATH -CD CD_IMAGE_FILE -FD0 FD0_IMAGE_FILE
CD-imageは.ISOと.CUEに対応。ディスクイメージは.D77か生イメージファイルに対応。scriptsサブディレクトリ内にバッチ実行などの例題があるので、そっちも参照。ヘルプを書く時間が無い。
また、次のようにタイプするとヘルプを表示します。英語ですが。
main_cui -HELP
以下に起動コマンドの例をいくつか挙げます。command.mdファイルも参照してください。
To emulate Marty, you need to own ROM images extracted from a Marty.
In addition to specify the ROM location in the command parameter in CUI or text dialog box in GUI, you also need to select the machine type. From CUI, add a parameter -TOWNSTYPE MARTY. Or from GUI, select MARTY as Towns Type.
If you do not specify the machine type, even with the Marty ROM, the virtual machine will start just like a full-spec FM TOWNS.
Martyを再現するには、Martyから抜き出したROMイメージが必要です。
MartyのROMイメージの場所をコマンドパラメータ、あるいはGUIのダイアログで指定する他に、マシンタイプをMartyに設定する必要があります。コマンドから指定する場合は -TOWNSTYPE MARTY オプションを追加してください。GUIから指定する場合は、リストからMARTYを選んでください。
マシンタイプを指定しない場合、MartyのROMを使っても、フルスペックのFM TOWNSのように起動してしまいます。
.\Tsugaru_CUI.exe -HELP
Print help.
ヘルプを表示します。
./Tsugaru_CUI E:/ROM_MX -CD E:/ISOImage/AFTER_BURNER.CUE -GAMEPORT0 KEY -SCALE 160
If FM TOWNS ROM image files are stored in E:/ROM_MX directory, boot from disc image E:/ISOImage/AfterburnerII/AFTER_BURNER.CUE. Game pad 0 is emulated by keyboard (A,S,Z,X,↑↓←→), and Window size is scaled up to 160%.
If you have a physical game pad, you can use PHYS0, PHYS1, PHYS2, or PHYS3 in place for KEY. Or, in case your game pad reports direction button as the analog input, use ANA0,ANA1, ANA2 or ANA3.
FM TOWNSのROMイメージがE:/ROM_MXのとき、ディスクイメージE:/ISOImage/AFTER_BURNER.CUEから起動します。ジョイパッド0はキーボードエミュレーション (A,S,Z,X,↑↓←→)、ウィンドウは160%にスケールアップされます。
USBやBluetooth接続のゲームパッドがある場合は、KEYの代わりにPHYS0, PHYS1, PHYS2, または PHYS3を指定すると使えます。また、十字ボタンをハットスイッチではなくアナログレバーとして扱うゲームパッドの場合は、ANA0,ANA1,ANA2,ANA3を指定することで利用できます。
./Tsugaru_CUI E:/ROM_MX -CD E:/ISOImage/AUGUSTA.CUE -FD0 E:/ISOImage/AUGUSTAFD.bin -SCALE 160
IF FM TOWNS ROM image files are in E:/ROM_MX directory, boot from disc image E:/ISOImage/AUGUSTA.CUE and floppy-disk image E:/ISOImage/AUGUSTAFD.bin in drive A. Window is scaled up to 160%.
FM TOWNSのROMイメージがE:/ROM_MXのとき、CDイメージE:/ISOImage/AUGUSTA.CUEとドライブAのフロッピーディスクイメージE:/ISOImage/AUGUSTAFD.binから起動します。ウィンドウは160%にスケールアップされます。
./Tsugaru_CUI E:/ROM_MX -CMOS ./CMOS.BIN -CD E:/ISOImage/TownsOSV2.1L20.cue
If FM TOWNS ROM image files are stored in E:/ROM_MX, and CMOS file (BIOS Settings in the DOS terminology) is ./CMOS.BIN, boot from disc image E:/ISOImage/TownsOSV2.1L20.cue If ./CMOS.BIN does not exist, it is created when the program is closed by Q (Quit) command. If the program is forced to close by window-close button, the file won't be created.
FM TOWNSのROMイメージがE:/ROM_MXで、CMOSファイル(DOSで言うところのBIOS設定)が./CMOS.BINのとき、ディスクイメージE:/ISOIMage/TownsOSV2.1L20.cueからシステムを起動します。./CMOS.BINが存在しない場合、コンソールコマンドのQ (Quit) コマンドで終了したとき、新たにCMOS.BINを作成します。ウィンドウを閉じて強制終了した場合はファイルはできません。
FM TOWNS uses a MSX mouse, which sends a displacement infornation in X- and Y-directions to the PC. Therefore, mouse does not know where the cursor is. To match the mouse cursor location in the host OS and guest VM, the emulator needs to know where the guest VM is thinking the mouse cursor is currently.
I did reverse engineering and found the mouse-cursor locations for TBIOSes that come with V1.1 L10/L20/L30, V2.1 L10B/L20/L31. Will add other versions of TownsOS and VINGBIOS hopefully. Most likely I will forget updating version numbers here, but probably I'll add comments in the commit log.
This mouse integration is smooth and recommended. But, some Towns applications reads mouse without using TBIOS. I've added special handlings to some of such applications. Please see the list of application-specific settings.
In Windows 3.1 and 95 guests, I have developed drivers for integrating mouse smoothly. Please see winapp sub-directory.
Or, in the worst case, press the mouse middle button, which will enable differential mouse integration, which should work in any situation.
FM TOWNSはMSXマウスを使用します。MSXマウスはマウスの移動量のXYをPCに送信します。だから、マウスカーソルがPC上のどこにあるのか、マウスは知りません。ホストPCとゲストVMでマウス位置を一致させるためには、エミュレータが、VMが今マウスがどこにあると思っているか検出しなくてはなりません。
このエミュレータでは、Towns OS V1.1 L10/L20/L30, V2.1 L10B/L20/L31付属のTBIOSについて解析して、対応しました。他のバージョンやVINGBIOSにも順に対応しますが、多分ここのREADMEには書くのを忘れるでしょう。が、GITのコミットコメントには多分書くと思うのでそっちを見てください。
この方法はスムーズなので推奨しますが、いくつかのFM TOWNS用アプリケーションは、TBIOSを使わずにマウスを読んでいます。そのようなアプリケーションの中には、特別な対応でスムーズなマウスインテグレーションを実現したものもあります。特定アプリケーション用セッティングのリストを参照してください。
Windows 3.1/95を津軽上で実行する場合、それぞれでスムーズなマウスインテグレーションを実現するドライバを開発しました。winappサブディレクトリを見てください。
何をやってもダメな場合は、マウスの中ボタンを押してみてください。そうすると、差分マウスインテグレーション機能が有効になり、アプリケーションに限らずマウスが使えるはずです。
You can share a directory of the host with the VM using a utility called TGDRV.COM
When you start Tsugaru CUI, specify -SHAREDDIR <dir> option to specify a host directory to be shared with the VM. When you start Tsugaru GUI, specify shared directories in "TGDRV" tab. You can specify up to 8 directories in CUI, 4 directories in GUI.
In the VM, insert the TsugaruUtil.D77, and run TGDRV.COM. The sheard directory will appear as a virtual disk drive in the VM. If you use a Towns OS installed on the hard-disk image, it would be convenient to copy TGDRV.COM to the virtual hard disk.
Kanji and Katakana files also cannot be accessed. In macOS and Linux environment, since MS-DOS capitalizes all the files, you cannot access filles with small-case letters.
ユーティリティTGDRV.COMを使うことで、ホストPCのディレクトリを直接津軽上のVMと共有することができます。
津軽CUIを起動するとき、-SHAREDDIR <dir>オプションを追加して、共有するディレクトリを指定してください。津軽GUIを使う場合は、"TGDRV"タブで共有ディレクトリを指定してください。CUIでは最大8箇所、GUIでは最大4か所のディレクトリを指定できます。
津軽VM上ではディスクイメージ TsugaruUtil.D77 をセットして、TGDRV.COMを実行すると、共有ディレクトリがVM上の仮想ドライブとしてアクセスできるようになります。ハードディスクイメージを利用している場合は、ハードディスクイメージにTGDRV.COMをコピーしておくと便利と思います。
漢字・カナを含むファイルもアクセスできません。macOSとLinuxでは、MS-DOSがすべてのファイル名を大文字にしてしまうため、ホスト上の小文字を含むファイルはアクセスできません。
To transfer a file from the host to the VM, follow the following steps:
- In Tsugaru CUI, type
XMODEMTOVM filename(filenameis the file that you want to send to the VM). - Start a terminal program in the VM and start XMODEM transfer. I have confirmed with a popular free text editor called WINK2, which has a terminal mode.
To transfer a file from the VM to the host, follow the following steps:
- Start a terminal program in the VM and start XMODEM transfer.
- In Tsugaru CUI, type
XMODEMFROMVM filename.
XMODEMを使ってホストからVMにファイルを転送するには、次のステップで操作してください:
- 津軽CUIモードで、
XMODEMTOVM filename(filenameは転送するファイル名)とコマンドを入力。 - VM上でターミナルソフト (WINK2の通信モードなど) を起動してXMODEMのファイル転送を開始する。
XMODEMを使ってVMからホストにファイルを転送するには、次のステップで操作してください:
- VM上でターミナルソフトを起動してXMODEMのファイル転送を開始する。
- 津軽CUIモードで、
XMODEMFROMVM filenameとコマンドを入力。
XMODEM works, but it sends 1 byte at a time, and slow. You can transfer a file much faster using TFTP by the following steps. You need to use Tsugaru CUI. You need to transfer FTCLIENT.EXP to the VM. You can do it once with XMODEM or use a conventional disk-image tools such as EDITDISK.
- Type command
VM2HOST vmfile hostfileorHOST2VM hostfile vmfile. These commands schedule file transfer. If you want to transfer multiple files, type commands multiple times. - In VM, start FTCLIENT.EXP (like
run386 -nocrt FTCLIENT.EXPin the command mode)
Then the files will be transferred. FTCLIENT.EXP can be found in townsapp/exp subdirectory.
XMODEMは機能しますが、1バイト単位でファイルを転送するので、遅いです。より高速にVMとホスト間でファイルを転送したい場合、次の手順で操作してください。CUIで実行する必要があります。FTCLIENT.EXPをVMに転送しておく必要がありますが、XMODEMを使うか、あるいはEDITDISKなどのディスクイメージツールを利用してください。
- コマンド
VM2HOST vmfile hostfileまたはHOST2VM hostfile vmfileをタイプする。これらのコマンドはファイル転送を予約する。複数ファイルを転送したい場合は、コマンドを複数回タイプする。 - VM上でFTCLIENT.EXPを実行する。(コマンドモードに降りて
run386 -nocrt FTCLIENT.EXPとタイプ)
この手順で予約したファイルが転送されます。FTCLIENT.EXPはtownsapp/expサブディレクトリにあります。
Wing Commander 1 and Strike Commander (not Strike Commander Plus) for FM TOWNS did not support analog joystick. The player had choice between fly by mouse or fly by keyboard, which was a major frustration. Especially, Wing Commander for FM TOWNS comes with Orchestra BGM by CDDA. It was the BEST Wing Commander port of all. Only thing missing was analog joystick. Tsugaru offers a redemption. With the option
-FLIGHTMOUSE joystickId centerX centerY scaleX scaleY zeroZoneInPercent
Tsugaru translates flight joystick input to mouse input. It is also exposed in GUI. It makes Wing Commander and Strike Commander so much more easy to fly. joystickID is you know what it is. centerX and centerY specifies screen coordinate (in 640x480 scale) where mouse cursor should be when the joystick is neutral. scaleX and scaleY specifies how large a deflection in screen scale the mouse cursor should travel when the stick is moved all the way. Actually majority of the analog joysticks doesn't deflect to 1.0. Usually stops at 0.9 or so. So, specifying larger scaleX and scaleY is recommended, or your fighter will maneuver real slow. zeroZoneInPercent specifies zero zone (or dead zone) of the joyostick.
To use it with Wing Commander or Strike Commander, you also need to enable application-specific augumentation for the program.
FM TOWNS用Wing Commander 1、Strike Commanderはアナログジョイスティックをサポートしませんでした。プレイヤーはマウスかキーボードかどちらかで操縦しなくてはなりませんでした。とくにWing Commander 1はFM TOWNS版はCDDAによるオーケストラのBGMがついていて、他のどの移植版よりもこの一点で最高の移植と思うのですが、アナログスティック非対応だけが心残りでした。津軽はこの当時の恨みを晴らす機能を提供します。まさに江戸の恨みを青森で。コマンドオプション（GUIからも指定可)で、
-FLIGHTMOUSE joystickId centerX centerY scaleX scaleY zeroZoneInPercent
joystickIdはそのまんまで、centerX,centerYはジョイスティックが中立位置のときマウス座標をどこに置くかで、scaleX,scaleYはジョイスティックの入力が1.0のときマウス座標をどれだけ動かすかの設定です。zeroZoneInPercentはジョイスティックの遊びをパーセントで指定します。なお、ジョイスティックは結構精一杯押したり引いたりしても値が1.0まで上がりません。scaleX,scaleYは大きめの値を指定しておいた方が楽です。
なお、Wing CommanderまたはStrike Commanderで使用するには、このオプションに加えてApplication Specific Augumentationを有効にする必要があります。
You need bootable floppy disk images/CD-ROM images to run unit tests. My guess is it is ok to redistribute Towns OS bootable floppy disk images, but to be safe I am keeping them to myself.
If you have an ISO image (track 0 image) of Towns OS V1.1 L10 or Towns OS V2.1 L31, you can run two tests by:
- Configure the top-level CMakeLists.txt so that DISC_IMAGE_DIR points to the directory where you store your ISO images.
- CMake and build everything.
- Run either one of the following comman in the build directory.
ctest -R MX_V21L31_GUI
ctest -R MX_V11L10_GUI
The tests are timing-sensitive, or the CPU needs to be reasonably fast. If not, mouse-click may take place before wigets are ready, in which case, the test may not run all the way.
ユニットテストを実行するには、起動可能なフロッピーディスクイメージまたはCD-ROMイメージが必要です。Towns OSでフォーマットした起動可能ディスクイメージは多分再配布しても良いと思いますが(多分富士通としては小さなソフトハウスなどがフロッピー版のソフトを販売するために使うことを想定していたのではないかと思うので)、一応、ディスクイメージは外に出してません。
が、Towns OS V1.1 L10またはV2.1 L31のISOイメージ(トラック0のイメージ)があれば、GUIのテストだけ実行できます。
- 最上位のCMakeLists.txtを修正して、DISC_IMAGE_DIRがISOイメージの場所を指すようにする。
- CMakeを再度実行してからBuild。
- 次のコマンドを実行。
ctest -R MX_V21L31_GUI
ctest -R MX_V11L10_GUI
なお、タイミングに影響されるので遅いCPUだと多分途中から先に進まなくなって、テスト途中で止まる鴨しれません。
Please see commit comments after this!
- Improvement in hardware task-switching emulation and VM86 mode in the high-fidelity mode. CPU passes the enhanced TEST386 tests.
- Fixed REX-3586 signature. 1999 Debian Linux (Kernel 2.0.33 Hamm) for FM TOWNS can use REX-3586.
- Support FMT-3631/3632 Windows Accelerator cards. Windows 3.1/95 can use up to 1280x1024 resolution with FMT-3631/3632. FM TOWNS Windows 3.1 comes with FMT-3631 driver. FM TOWNS Windows 95 comes with FMT-3631 and FMT-3632 drivers.
- Fixed mouse integration for Fujitsu Habitat.
- Linux version does not get slow if RS232C to TCP/IP tunnel is enabled.
- Improved differential mouse integration for diligent mouse movement.
- Support LAN Card (REX3586) and Network Address Translation. Port forwarding is currently only available from the CUI.
- Differential Mouse Integration for the apps that is not reading mouse by known TBIOS version, enabled/disabled by mouse middle button.
- Headless mode, CUI only.
- Support COM1 to COM4.
- Improved CPU fidelity in the High-Fidelity mode. Can run Revival Xanadu on Windows 95 (requires manual rollback of the joystick-driver).
- Improved SCSI CDDA emulation.
- Can start Windows 3.1 if compiled in the High-Fidelity Mode!
- Virtual Machine is pretty stable, I think.
- Added tight-integration mode in the GUI module.
- I lost track of what I added or improved. But, I can say I clear-confirmed Wing Commander 1 and Strike Commander :-)
- YM2612 emulator for Tsugaru (Tsugaru-Ben) is becoming much better than earlier version. Super DAISENRYAKU intro music and Emerald Dragon BGM sound very similar to actual YM2612.
- I lost track of what changes I made since 6/15. Please see git commit log!
- Added separate timer for audio. Super DAISENRYAKU BGM plays better. Still need more work in YM2612 emulation.
- Changed the internal clock frequency of YM2612 from 600KHz to 690KHz. FM Towns Technical Databook [2] tells it is 600KHz, but somehow 690KHz is giving me more accurate timing.
- Fixed CDC. Was reporting number of tracks as binary. It should be in BCD. TOWNS ILLUSION runs again. This time it needs to start from BIN/CUE. It stopps in the middle if you start from ISO.
- Speed up in CPU emulation.
- Better CDDA emulation, preliminary support for electric volume registers, fixed BT MEM,R instruction. Confirmed RAYXANBER can start game play!
- Improvement in YM2612 emulation. Still different, but getting similar. (Struggling to make sense of envelope calculation.)
- Fixed hard-disk read/write. Now can install TownsOS in a hard-disk image, and boot from it.
- Mouse Integration for Wing Commander. Need -APP WINGCOMMANDER1 option.
- Fixed CDC. Was pushing status code 06 00 00 00 twice after MODE1 Read.
- Added disk-access indicators. Changed FDC timing.
- Tested TownsOS boot and mouse integration with Freeware Collection 1-3, Free Software Collection 4-11. Made corrections for Free Software Collection 4 Disc B and Free Software Collection 6.
- Free Software Collection 4 Disc B uses Towns OS V2.1L10 (L10 with no mark). DOS Extender that comes with Towns OS V2.1L10 blocks unless the CPU type identified by I/O port 0030H is 80386DX or 80386SX. For this problem, I have added -PRETEND386DX option.
- Sprite emulation should be pretty good.
- Game pad can be emulated by keyboard (-GAMEPORT0 option. Use arrow keys and Z,X,A,S)
- Afterburner II (SEGA, ported by CRI) is playable! Sample boot script is Afterburner2.py.
- Preliminary support for SCSI Hard disks. (Create a big binary filled with zeros and use -HD0 option.)
- CPU core speed up. Still not good enough for 486DX 66MHz.
- Support 3-mode floppy disk read/write.
- Very preliminary YM2612 support.
- Added initial CMOS.
- Started CPU instruction tests. Already captured and fixed numerous bugs in CPU cores.
- Fixed sprite.
- Towns ILLUSION works all the way without corrupted image!!!!
- At least the program doesn't crash or freeze when sprite is used.
- Towns ILLUSION (Legendary DEMO that comes with Towns OS V1.1 L10) runs all the way, although the images are still corrupted.
- Primitive support for RF5C68 PCM Sound Generator Playback.
- Roughly 25% speed up.
- Supported CDDA from BIN/CUE
- Added a unit test for Towns OS GUI V1.1 L30
- Added unit tests for Towns OS GUI V1.1 L10 and V2.1 L31.
- Make it public.
- Major progress! My Towns can boot from ISO image of Towns OS V2.1 L20 and can move mouse cursor with keys.
- Major progress! My Towns can read from ISO image!
- Succeeed in booting into Towns OS V2.1 L30 command mode, and then running a test program compiled by High-C!
- First line of code!
- Interpretation of I/O 480H
[2] pp. 91 tells that:
I/O 0480H
Bit 1: Select F8000H to FFFFFH mapping RAM or System-ROM (0:SysROM 1:RAM)
Bit 0: RAM or CMOS (0:RAM 1:CMOS)
It doesn't tell where in the memory space Bit 0 is controlling. From the memory map, it looks to be D0000 to DFFFF. However, the boot ROM does not clear Bit 0 before memory test, which causes CMOS destruction upon restarting by REIPL.COM.
Only interpretation I can think of is:
Bit 1 Bit 0 F0000-FFFFF D0000-DFFFF
0 0 SysROM RAM
0 1 SysROM CMOS
1 0 RAM RAM
1 1 RAM RAM
Eventually I'm going to write a test program and see the behavior on my actual FM Towns.
[1] Intel i486TM Microprocessor Programmer's Reference Manual, Intel, 1990
[2] Noriaki Chiba, FM TOWNS Technical Databook, 3rd Edition, ASCII, 1994
[3] towns_cd.h, Linux for FM TOWNS source code.
[4] X86 Opcode and Instruction Reference Home, http://ref.x86asm.net/coder32.html (As of February 9 2020)
[5] Intel 80386 Programmre's Reference Manual, Intel, 1986
[6] https://github.com/nabe-abk/free386/blob/master/doc-ja/dosext/coco_nsd.txt
[7] http://www.ctyme.com/rbrown.htm
[8] SEGA Genesis Software Manual
[9] http://www.mit.edu/afs/sipb.mit.edu/contrib/doc/specs/protocol/scsi-2/s2-r10l.txt (As of May 3 2020)
[10] List of Floppy Disk Formats, https://en.wikipedia.org/wiki/List_of_floppy_disk_formats, (As of May 23 2020)
[11] YM2608 OPNA Application Manual
[12] Source code of Artane's FM Towns emulator project https://github.com/Artanejp