nono is OMRON LUNA-I and LUNA88K emulator runs on NetBSD and etc.+nono は NetBSD とかで動作する OMRON LUNA-I/LUNA-88K +(と SHARP X68030) のエミュレータです。 +
nono is OMRON LUNA-I/LUNA-88K (and SHARP X68030) emulator +runs on NetBSD and etc.
How to build
Command Line Option
How to execute
Configuration
About VM
Try it
Example of network setup
Example of host network setup
Known Issues
How to migrate from old versions
Changes
Contact, License, etc
Changes
Contact, License, etc
+
Green Background is new or updated paragraph.+
How to build
The followings are required for build. -If you use NetBSD(pkgsrc), -wxWidgets is pkgsrc/x11/wxGTK30 (OPTIONS:gtk3 is tested).+
The followings are required for build.
+wxWidgets は NetBSD(pkgsrc) なら pkgsrc/x11/wxGTK30 です。
+OPTIONS:gtk3 で動作確認しています。
+If you use NetBSD(pkgsrc),
+wxWidgets is pkgsrc/x11/wxGTK30 (OPTIONS:gtk3 is tested).
+
+
(NetBSD 以外でのビルドはサポートしていませんが)
Ubuntu 20.04 ではたぶん以下のパッケージが必要です。
You may need the following packages on Ubuntu 20.04
@@ -99,10 +111,15 @@ You can specify C/C++ compiler using env
if configure cannot find standard name suitable compiler.
Also, you can specify wx-config path using environment variable WX_CONFIG
if configure cannot find wx-config.
+
+-DNOTEST は開発者用のテストツールをビルドしないためのものです。
+With -DNOTEST, the build excludes test tools which is needed
+for developers only.
+
@@ -118,8 +135,17 @@ the command line executable.% ./configure -% make depend -% make +% make -DNOTEST depend +% make -DNOTEST % su # make install
How to execute
Command Line Option
Command Line Option
Use this name=value -instead of name=configvalue specified in configuration file.+instead of name=configvalue specified in configuration file. +If name is not correct, it will exit on error. _EOM_ ); @@ -271,8 +299,8 @@ _EOM_ option_dev("-D", <<<_EOM_ コンソールをデバッガとして使用します。 --d を指定しなくても起動時にプロンプトで停止します -(そのうちなんとかしたい)。 +過去との互換性のために存在していますが、 +-V debugger-driver=stdio と等価です。 _EOM_ ); @@ -310,13 +338,13 @@ VM の設定ファイルはその VM デ 書式は key = value 形式で1行1項目ずつです。 key と value の前後の空白は取り除かれます。 また空行と "#" で始まる行は無視します。 -知らないキーの行も無視します。 +知らないキーは警告を出した上で無視します。
VM configuration file is nono.cfg (or the file specified by -c option) in the VM directory. Its syntax is key = value format, one per line. White spaces before and after key and value are ignored. -Blank lines, lines beginning with "#", and -lines with unrecognized key are also ignored.+Blank lines, lines beginning with "#" are also ignored. +The lines with unrecognized key are ignored with a warning.
設定項目は次の通りです。
The configuration items are:
@@ -334,11 +362,32 @@ VM 種別を以下のいずれかから
This field is mandatory.
| luna | … LUNA-I - | |
| luna88k | … LUNA88K + | |
| luna88k | … LUNA-88K + | |
| x68030 | … X68030 (Experimental) |
Specifies the X68030's external CGROM image file path. +This CGROM is 768KB. +If the path does not have any path delimiters, +the VM directory and then its parent directory will be searched. +If the path is a relative path, +it will be path from the VM directory, not from the current directory. +If the path is empty, nono's builtin compatible CGROM will be used. +The default value is empty.+_EOM_ +); + config_item("clock-sync = value", <<<_EOM_ 仮想マシン内の時刻の同期方法を指定します。 real なら実時間に同期、virtual なら仮想時間に同期します。 @@ -353,17 +402,31 @@ without notice. _EOM_ ); -config_item("debugger-port = integer", <<<_EOM_ -デバッガの TCP 待ち受けポート番号を指定します。 -0 なら待ち受けを行いません。 -デフォルトは 0 です。 -
Specifies the TCP port number that debugger listens. -If 0, it will not listen. -The default is 0.+config_item("debugger-driver = string", <<<_EOM_ +デバッガのコンソールドライバを指定します。 +stdio、tcp、none が選択可能です。 +stdio は標準入出力を使用します。 +tcp は TCP ポートで TELNET プロトコルで待ち受けます。 +none ならホスト側とは一切通信を行いません。 +デフォルトは none です。 +
Specifies console driver of the debugger. +stdio, tcp, and none can be specified. +stdio uses the standard input/output. +tcp listens on TCP port using TELNET protocol. +none doesn't make any communication with the host. +The default is none.+_EOM_ +); + +config_item("debugger-tcp-port = integer", +<<<_EOM_ +デバッガのコンソールドライバが tcp の時の TCP 待ち受けポート番号を指定します。 +
Specify the TCP port number that debugger console driver listens._EOM_ ); config_item("ethernet-macaddr = string", <<<_EOM_ +(LUNA Only) イーサネットデバイスの仮想マシン側の MAC アドレスを指定します。 XX:XX:XX:XX:XX:XX 形式で指定します。 @@ -372,6 +435,85 @@ config_item("ethernet-macaddr = strin _EOM_ ); +config_item("fd-drive = integer", <<<_EOM_ +(X68030 Only) +フロッピードライブの数を 0 から 4 で指定します。 +デフォルトは 2 です。 +
Specify the number of floppy drives from 0 to 4. +The default is 2.+_EOM_ +); + +config_item("fdN-image = path", <<<_EOM_ +(X68030 Only) +フロッピードライブ N に起動時に挿入するディスクイメージを指定します。 +イメージパスが相対パスなら VM ディレクトリからの相対パスになります。 +起動後はメニューから操作できます。 +デフォルトは空です。 +
Specify a diskimage to be inserted to floppy drive N at startup. +If the path is relative path, it is from the VM directory. +You can also operate them from menu after startup. +The default is empty.+_EOM_ +); + +config_item("fpu-type = value", <<<_EOM_ +(X68030 Only) +FPU を装着するかどうか指定しています。 +none なら FPU を装着しません。 +68881 なら FPU として 68881 を装着します。 +現状 68882 はサポートしていません。 +また none の代わりに 0、 +68881 の代わりに 1 と書くこともできます。 +デフォルトは 68881 です。 +LUNA-I はたぶん 68881 搭載モデルのみのため設定できません。 +
Specify whether to install FPU or not. +If none, FPU is not installed. +If 68881, 68881 FPU is installed. +68882 is not supported yet. +And, none can also be written as 0, +68881 can also be written as 1. +The default is 68881. +This item cannot be specified on LUNA-I +because (probably) all LUNA-I has 68881.+ +_EOM_ +); + +config_item("hostcom-driver = string", <<<_EOM_ +シリアルポートのホスト側ドライバを指定します。 +stdio、tcp、none が選択可能です。 +stdio は標準入出力を使用します。 +tcp は TCP ポートで TELNET プロトコルで待ち受けます。 +none ならホスト側とは一切通信を行いません。 +デフォルトは none です。 +
Specifies the host driver of serial port. +stdio, tcp, and none can be specified. +stdio uses the standard input/output. +tcp listens on TCP port using TELNET protocol. +none doesn't make any communication with the host. +The default is none.+_EOM_ +); + +config_item("hostcom-tcp-port = integer", <<<_EOM_ +ホストドライバが tcp の時の TCP 待ち受けポート番号を指定します。 +
Specify the TCP port number that host driver listens.+_EOM_ +); + +config_item("hostcom-fallback = integer", <<<_EOM_ +hostcom-driver で指定したドライバが使用可能でなかった時、 +0 ならプロセスを終了します。1 なら none を選択して実行を継続します。 +デフォルトは 0 です。 +
Specify the behavior when the driver which is selected by +hostcom-driver is unusable; +terminate the process if 0, +or continue to run using the none driver if 1. +The default is 0.+_EOM_ +); + config_item("hostkbd-input = string", <<<_EOM_ ホストキーボードの入力モードを指定します。 char ならキャラクタ入力モード、 @@ -387,6 +529,7 @@ _EOM_ ); config_item("hostnet-driver = string", <<<_EOM_ +(LUNA Only) イーサネットデバイスのホスト側ドライバを指定します。 afpacket、bpf、tap のうち ホスト OS がサポートしているものと auto、none が選択可能です。 @@ -412,7 +555,8 @@ The default is auto. _EOM_ ); -config_item("hostdriver-afpacket-ifname = ifname", <<<_EOM_ +config_item("hostnet-afpacket-ifname = ifname", <<<_EOM_ +(LUNA Only) ホストドライバが afpacket の時にバインドするインタフェースを1つ指定します。 ifname が auto なら使用可能なインタフェースを1つ自動的に選択します。 @@ -426,7 +570,8 @@ Note that this host driver cannot commun _EOM_ ); -config_item("hostdriver-bpf-ifname = ifname", <<<_EOM_ +config_item("hostnet-bpf-ifname = ifname", <<<_EOM_ +(LUNA Only) ホストドライバが bpf の時にバインドするインタフェースを1つ指定します。 ifname が auto なら使用可能なインタフェースを1つ自動的に選択します。 @@ -440,7 +585,8 @@ Note that this host driver cannot commun _EOM_ ); -config_item("hostdriver-tap-devpath = path", <<<_EOM_ +config_item("hostnet-tap-devpath = path", <<<_EOM_ +(LUNA Only) ホストドライバが tap の時に使用するデバイスを1つフルパスで指定します。 デフォルトは auto で、この場合は自動的にデバイスを選択します。 この時の探し方はホスト OS によって異なります。 @@ -472,6 +618,7 @@ _EOM_ ); config_item("hostnet-fallback = integer", <<<_EOM_ +(LUNA Only) hostnet-driver で指定したドライバが使用可能でなかった時、 0 ならプロセスを終了します。 1 なら none を選択して実行を継続します。 @@ -484,7 +631,60 @@ The default is 0. _EOM_ ); +config_item("iplrom1-image = path", <<<_EOM_ + +(X68030 Only) +X68030 の外部 IPLROM イメージファイルのパスを指定します。 +こちらは 0xfe0000..0xffffff の 128KB の部分で、IPLROM30 と呼ばれているほうです。 +path がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。 +path が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。 +空にすると無償配布されている IPLROM30 を使用します。 +デフォルトは空です。 +
Specifies the X68030's external IPLROM image file path. +This one contains 128KB at 0xfe0000..0xffffff and is known as IPLROM30. +If the path does not have any path delimiters, +the VM directory and then its parent directory will be searched. +If the path is a relative path, +it will be path from the VM directory, not from the current directory. +If the path is empty, the public released IPLROM30 will be used. +The default value is empty.+_EOM_ +); + +config_item("iplrom2-image = path", <<<_EOM_ + +(X68030 Only) +X68030 の外部 IPLROM イメージファイルのパスを指定します。 +こちらは 0xfc0000..0xfdffff の 128KB の部分で、ROM30 と呼ばれているほうです。 +path がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。 +path が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。 +空にすると内蔵 ROM を使用します。 +内蔵 ROM は NetBSD/x68k が起動する程度の SCSI IOCS のみサポートしています。 +デフォルトは空です。 +
Specifies the X68030's external IPLROM image file path. +This one contains 128KB at 0xfc0000..0xfdffff and is known as ROM30. +If the path does not have any path delimiters, +the VM directory and then its parent directory will be searched. +If the path is a relative path, +it will be path from the VM directory, not from the current directory. +If the path is empty, internal emulated ROM will be used. +The ROM supports only enough SCSI IOCS to boot NetBSD/x68k. +The default value is empty.+_EOM_ +); + +config_item("keyboard-connect = integer", <<<_EOM_ +起動時にキーボードを本体に接続するかどうかを指定します。 +1 なら接続し、0 なら接続しません。デフォルトは 1 です。 +起動後はメニューから変更可能です。 +
Specify whether to connect keyboard on boot. +If 1, it is connected; if 0, it isn't connected. The default is 1. +You can change it on GUI menu after boot.+_EOM_ +); + config_item("luna-adjust-misused-epoch = integer", <<<_EOM_ +(LUNA Only) LUNA で誤った RTC epoch を採用している OS 向けに RTC エミュレーションを補正するかどうかを 指定します。0 なら補正をしません(実機と同じ動作)、 @@ -501,14 +701,12 @@ The default is 1. Normally, leave it 1.
LUNA で採用している RTC (MK48T02) は2桁で保持している年の値が
4 で割り切れる年をうるう年とする仕様です。
-ところが NetBSD/luna68k、OpenBSD/luna88k など現存してソースが確認できる OS
-はいずれもこの RTC の年の値を 1970年からの経過年として使用しています
-(LUNA が本来どういう仕様だったのかは分かりませんが、
-異なる OS を起動し直すたびに RTC epoch をずらす運用は考えにくいので
-おそらくすべての OS で同じだと思います)。
+ところが NetBSD/luna68k、OpenBSD/luna88k などはこの
+RTC の年の値を 1970年からの経過年として使用しています。
例えば1970年はうるう年ではないため 2月28日の翌日は 3月1日ですが、
MK48T02 的には 00年であるためうるう年と認識し 2月28日の翌日が2月29日になります。
-このように、実機の RTC は4年のうち約2年間、1日ずれた日付を指しているようです。
+このように、これらの OS を使っている場合実機の
+RTC は4年のうち約2年間、1日ずれた日付を指しているようです。
しかしながら、RTC の時刻は OS 起動時に一度読んだ後は基本的に参照しない上、
今時必要なら NTP で時間を合わせるため、
実機でも問題が顕在化することはまずないと思います。
@@ -522,6 +720,7 @@ _EOM_
);
config_item("luna-dipsw1 = string", <<<_EOM_
+(LUNA Only)
本体前面 DIPSW#1-1..#1-8 の内容を指定します。
"0" を DOWN、"1" を UP として、
これを8つ並べた形式で、前から順に #1..#8 に対応します。
@@ -537,9 +736,9 @@ See the following link about DIPSW.<
→ NetBSD/luna68k: Information
@@ -636,32 +851,52 @@ the real LUNA-I machine.
For now, only V4.22 (Thu Jul 27 11:45:42 1989) is supported.
I have no idea about other ROMs.
-LUNA88K でのデフォルトは 11111111 です。
+LUNA-88K でのデフォルトは 11111111 です。
各スイッチの内容は以下のリンクを参照してください。
-On LUNA88K, the default value is 11111111.
+
_EOM_
);
-/* luna には不要
- config_item("mpu-has-fpu", ""); */
-
config_item("mpu-pseudo-stop = integer", <<<_EOM_
+(LUNA-88K Only)
m88100 にて疑似 STOP 状態を有効にするかどうかを指定します。
0 なら無効(実機と同じ動作)、1 なら有効で、デフォルトは 1 です。
m88100 には、m68k の STOP 命令 (割り込みが上がるまで何もせず待つ)
@@ -604,17 +819,17 @@ _EOM_
);
config_item("prom-image = path", <<<_EOM_
-LUNA-I/LUNA88K の外部 ROM イメージファイルのパスを指定します。
+(LUNA Only)
+LUNA-I/LUNA-88K の外部 ROM イメージファイルのパスを指定します。
path がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
path が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
空にすると内蔵 ROM を使用します。
デフォルトは空です。
-On LUNA-88K, the default value is 11111111.
See the following link about DIPSW.
→ OpenBSD manual pages: boot_luna88k(8)
@@ -547,6 +746,7 @@ _EOM_
);
config_item("luna-dipsw2 = string", <<<_EOM_
+(LUNA Only)
本体前面 DIPSW#2-1..#2-8 の内容を指定します。
書式は luna-dipsw1 と同じです。
デフォルトは 11111111 です。
@@ -566,6 +766,22 @@ Otherwise, the bootloader will enter int
_EOM_
);
+config_item("luna-video-plane = integer", <<<_EOM_
+(LUNA Only)
+LUNA のビデオボードのプレーン数を 1 か 4 で指定します。
+1 ならモノクロビデオボード、
+4 なら16色 (4bpp) ビデオボードに相当します。
+8bpp ボードは(まだ?)サポートしていません。
+デフォルトは今の所 1 です (将来変更するかもしれません)。
+Specify number of planes on LUNA video board.
+The valid values are 1 or 4.
+1 means a monochrome video board,
+4 means 16-color (4bpp) video board.
+Note that 8bpp video board is not (yet?) supported.
+The default value is 1 for now (It may be changed in the future).
+_EOM_
+);
+
config_item("monitor-rate = integer", <<<_EOM_
テキスト系モニタウィンドウの更新頻度を Hz 単位で指定します。
1 から 60 までの間で指定でき、デフォルトは 20Hz です。
@@ -579,16 +795,15 @@ _EOM_
config_item("mpu-clock = value", <<<_EOM_
MPU のクロック数を MHz 単位で指定します。
-デフォルトは LUNA-I なら 20MHz、LUNA88K なら 25MHz です。
+デフォルトは LUNA-I なら 20MHz、LUNA-88K と X68030 なら 25MHz です。
Specifies the MPU clock in MHz.
-The default value is 20MHz on LUNA-I, or 25MHz on LUNA88K.
+The default value is 20MHz on LUNA-I, or 25MHz on LUNA-88K
+and X68030.Specifies the LUNA-I/LUNA88K's external ROM image file path.
+
Specifies the LUNA-I/LUNA-88K's external ROM image file path.
If the path does not have any path delimiters,
the VM directory and then its parent directory will be searched.
If the path is a relative path,
-it will be path from the VM directory, not from the current
-directory.
+it will be path from the VM directory, not from the current directory.
If the path is empty, internal emulated ROM will be used.
The default value is empty.
-LUNA88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。
+LUNA-88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。
今のところ ROM は version 1.20 のみサポートしています。
-For LUNA88K,
+For LUNA-88K,
the ROM file is extracted from 0x41000000-0x4103ffff (256KB).
For now, only version 1.20 is supported.
_EOM_
);
config_item("ram-size = integer", <<<_EOM_
-搭載する RAM サイズを MB 単位で指定します。
-LUNA-I のデフォルトは 16MB です。
+搭載する RAM サイズを MB 単位で指定します。Specifies the RAM size in MB.
+
Specifies the RAM size in MB. -On LUNA-I, the default is 16MB. +On LUNA-I, the default is 16MB. If the size is less than 16MB, you can specify in 4MB unit. If larger, you can specify up to 255MB in 1MB unit. -By the way, NetBSD/luna68k needs at least 8MB to boot. -On LUNA88K, the default is 64MB. +By the way, NetBSD/luna68k needs at least 8MB to boot.+- LUNA-88K のデフォルトは 64MB です。 +64MB 未満は 16MB 単位で、 +64MB 以上は暫定で 255MB まで 1MB 単位で指定できます。 +
On LUNA-88K, the default is 64MB. If the size is less than 64MB, you can specify in 16MB unit. If larger, you can specify up to tentative 255MB in 1MB unit.+- X68030 のデフォルトは 12MB です。 +4MB から 12MB まで 1MB 単位で指定できます。 +
On X68030, the default is 12MB. +You can specify it in 1MB unit from 4MB to 12MB.+
Specifies the RTC (MK48T02) epoch year. +The default is 1970. +Since both NetBSD/luna68k and OpenBSD/luna88k use 1970 as epoch year, +there is no need to touch this value. +If you boot 4.4BSD on LUNA-I as the guest OS, specify 1900._EOM_ ); @@ -773,14 +1008,184 @@ Use spc0-idN-writeignore This option is for developers. _EOM_ ); + +config_item("sram-sync-ramsize = integer", <<<_EOM_ + +(X68030 Only) +SRAM の RAM 容量欄を実際の RAM サイズに合わせるかどうかを指定します。 +0 なら何もしません (実機と同じ)。 +1 なら、アプリケーション起動時に +SRAM の \$ed0008.L (RAM 容量) を ram-size の設定値で更新します。 +この更新は、 +アプリケーション起動時に SRAM マジックが正しく書かれている場合のみ行われます。 +デフォルトは 1 です。 +
Specify whether to synchronize a RAM size field in SRAM +with real RAM size or not. +If 0, the application will do nothing (as same as the real). +If 1, the application updates(synchronizes) +\$ed0008.L (RAM size) in SRAM with configuration value of ram-size. +This update is performed once only if +the SRAM magic string is correct at the application startup. +The default is 1.+ +_EOM_ +); ?>
About VM
Status Panel
Implementation Status+
| ◎ | : ほぼ実装済み Mostly implemented+ |
| ○ | : 困らない程度には実装済み Works+ |
| △ | : とりあえず動いてる程度 Works somehow+ |
| × | : 未実装 Not implemented+ |
| — | : 実装予定なし Not planned+ |
| {$br}{$line}\n"; + $br = ""; + } else { + list ($h, $m, $d) = preg_split("/\t+/", $line, 3); + print " | ||
| {$h}\n"; + print " | {$m}\n"; + print " | {$d}\n"; + } + } +?> + |
68030 cache is not implemented. +Therefore, number of clock cycle is not correct. +ATC (Address Translation Cache) is differ from and faster than the real 68030.+ +
Status Panel
Key input mode
Key input mode
Most LUNAs have the Japanese keyboard -(though I ever heard there are the US keyboard...). +LUNA and X68030 has the Japanese keyboard +(though I ever heard there are US keyboard for LUNA...). So nono provides two input modes for Japanese keyboard users and non Japanese keyboard users. Both have advantages and disadvantages.@@ -865,7 +1270,7 @@ And another disadvantage is that it will be hard to use for non Japenese keyboard users.
一方、キャラクタ入力モードは、ホストから入力された「文字」を
-再び LUNA のキーコードに解釈し直して VM に入力するモードです。
+再び LUNA/X68030 のキーコードに解釈し直して VM に入力するモードです。
例えばゲスト OS に "@" を入力したい場合、
US キーボードなら [SHIFT] + [2] を、
JP キーボードなら [@] キーを押しますが、
@@ -887,7 +1292,7 @@ JP キーボードなら [SHIFT] + [-]
(本来キーリピートが動作しない ROM やブートローダでもキーリピートが効くことは
一般ユーザからはメリットに感じられるかも知れませんが)。
In contrast, in the character mode, when you type a character,
-nono re-converts it into the LUNA's key code and sends it to the VM.
+nono re-converts it into the LUNA/X68030's key code and sends it to the VM.
For example if you want to type "@" in the guest OS,
you would press [SHIFT] + [2] on the US keyboard or [@] on the JP keyboard.
In both cases, the sequence of
@@ -911,19 +1316,19 @@ even though it should not work as a corr
(Although some of you may feel it an advantage).
Keycode table in the character mode
The following table shows the correspondence between the character that typed from the host and the key that will be sent to the VM. nono can recognize the function keys and arrow keys. -The keys where the HostChar is N/A can +The keys that not listed in this table can only be typed from the software keyboard window.
