How to migrate from ver 0.1.x to ver 0.2.0
-ビルド方法
How to build
-コマンドラインオプション
Command Line Option
-設定
Configuration
-VM について
About VM
-実行してみる
Try it
-ネットワーク設定例
Example of network setup
-変更履歴
Changes
-連絡先、ライセンス等
Contact, License, etc
-
nono is OMRON LUNA-I and LUNA88K emulator runs on NetBSD and etc.@@ -46,81 +39,20 @@ nono は NetBSD とかで動作する OM
How to migrate from ver 0.1.x to ver 0.2.0
How to build
Command Line Option
Configuration
About VM
Try it
Example of network setup
Changes
Contact, License, etc
How to migrate from ver 0.1.x to ver 0.2.0
There are two incompatibilities between ver 0.1.x and ver 0.2.0, -so it will not work the same as before.- -
Configuration changes about network-
These two items in 0.1.x have been removed.-
-代わりに次の5つが追加されています。 -設定方法はこのドキュメントの設定の章を参照してください。 -ホストドライバは以前はデフォルトでオフでしたがデフォルトでオン(auto)に変更になっています。 --ethernet-hostdriver = (default: none) -ethernet-hostdevice = (default: auto) -
Instead, the following five items have been added. -See Configuration section in this document -to setup. -The host driver used to be disabled by default before, -but now it is enabled(auto) by default.-
--hostnet-driver = (default: auto) -hostnet-afpacket-ifname = (default: auto) -hostnet-bpf-ifname = (defualt: auto) -hostnet-tap-devpath = (default: auto) -hostnet-fallback = (default: 0) -
About NVRAM in LUNA88K-
On LUNA88K, originally PROM determines the boot target by referring NVRAM. -Since nono ver 0.1.x didn't support NVRAM (though it created NVRAM.DAT file), -it used hard-coded boot filename "boot" in order to boot OpenBSD/luna88k. -nono ver 0.2.0 supports NVRAM, so at first it initializes the NVRAM -due to checksum mismatch. -In addition, the boot filename in the initialized NVRAM is "vmunix", -so it cannot boot OpenBSD/luna88k. -To boot it, enter as following on Emulated ROM Monitor.-
-この内容は NVRAM.DAT に記録されるので次回以降は直接 OpenBSD が起動します。 --nvram boot_filename boot[Enter] -y -b[Enter] -
The information you have just entered is recorded in the NVRAM, -so next time it boots OpenBSD automatically.+1. ビルド方法
How to build
Command Line Option
Configuration
About VM
Try it
Example of network setup
How to migrate from old versions
Changes
Contact, License, etc
How to build
How to build
(NetBSD 以外でのビルドはサポートしていませんが)
-Ubuntu 18.04 ではたぶん以下のパッケージが必要です。
-You may need the following packages on Ubuntu 18.04
+Ubuntu 20.04 ではたぶん以下のパッケージが必要です。
+
You may need the following packages on Ubuntu 20.04
(though we won't support non-NetBSD platform).
Command Line Option
Command Line Option
Loads and executes host's file. -If file is relative path, -it is path from the current directory. -If the file is gzip'd, it is automatically extracted. -The supported file format (after extracting) is a.out (OMAGIC) or ELF. -Actually, it only assumes bootloaders or kernels. -If this option is specified at the same time as -prom-image in configuration file, -this option preceeds. --_EOM_ -); - option_item("-c vmpath", <<<_EOM_ VM ディレクトリ/設定ファイルを指定します。 vmpath がディレクトリならそのディレクトリの中の nono.cfg @@ -243,8 +154,7 @@ make the specified file a configuration And in both cases, make the directory where that file is located a VM directory. If -c option is omitted, -vmpath is considered as the current directory. - +vmpath is considered as the current directory. _EOM_ ); @@ -253,8 +163,7 @@ option_item("-f", <<<_EOM_ GUI なら起動後にもメニューから変更できますが、その初期値を変えるだけです。
Boot as the fast mode. You can change this mode on GUI menu after boot, -and the option only changes its initial state. -+and the option only changes its initial state. _EOM_ ); @@ -269,8 +178,7 @@ GUI Only. Specifies the initial fontsize on all sub windows. height is one of 12 or 16. The default value is 12. -You can change this value on GUI menu after boot. - +You can change this value on GUI menu after boot. _EOM_ ); @@ -309,8 +217,27 @@ option_item("-V name=value 設定ファイルで指定した name=configvalue の代わりに このオプションの name=value を適用します。
Use this name=value -instead of name=configvalue specified in configuration file. -+instead of name=configvalue specified in configuration file. +_EOM_ +); + +option_item("-X file", <<<_EOM_ +ホストの file をロードして実行します。 +file が相対パスの場合カレントディレクトリからのパスになります。 +ファイルが gzip 圧縮されていれば自動的に展開します。 +(展開後の) ファイル形式は a.out (OMAGIC) か ELF で、 +実際にはブートローダとカーネル程度しか想定していません。 +設定の prom-image、luna-dipsw1 の内容(後述)によらず +内蔵の互換 PROM で起動し、直ちにホストファイルを実行します。 +
Loads and executes host's file. +If file is relative path, +it is path from the current directory. +If the file is gzip'd, it is automatically extracted. +The supported file format (after extracting) is a.out (OMAGIC) or ELF. +Actually, it only assumes bootloaders or kernels. +Regardless of prom-image and luna-dipsw1 configuration +(see below), +the internal emulated PROM loads and executes the host file immediately._EOM_ ); ?> @@ -357,6 +284,11 @@ option_dev("-L name1=level1file", <<<_EOM_ +-X オプションと同様ですが、PROM のプロンプトで停止します。 +_EOM_ +); + option_dev("-M name[,name2,...]", <<<_EOM_ 起動時に表示するモニタウィンドウを指定します。 カンマで区切って複数指定することも出来ます。 @@ -371,7 +303,7 @@ _EOM_ -
Configuration
Configuration
設定項目は次の通りです。
The configuration items are:
@@ -400,8 +331,7 @@ config_item("vmtype = string", <<
VM 種別を以下のいずれかから指定します。
省略不可です。
Specifies the VM type from the following.
-This field is mandatory.
-
+This field is mandatory.
| luna | … LUNA-I | ||||||||||||||||
| luna88k | … LUNA88K
@@ -419,8 +349,7 @@ If real, synchronize with the r
if virtual, synchronize with the virtual time.
The default is real.
This feature is under experimentation and may be changed in the future
-without notice.
-
+without notice.
_EOM_
);
@@ -443,6 +372,20 @@ config_item("ethernet-macaddr = strin
_EOM_
);
+config_item("hostkbd-input = string", <<<_EOM_
+ホストキーボードの入力モードを指定します。
+char ならキャラクタ入力モード、
+jp なら日本語キーボードモードです。
+デフォルトは char です。
+詳細は VM について の章を参照してください。
+Specifies the input mode of the host keyboard. +char means the character mode, +jp means the Japanese keyboard mode. +The defualt is char. +See About VM for details.+_EOM_ +); + config_item("hostnet-driver = string", <<<_EOM_ イーサネットデバイスのホスト側ドライバを指定します。 afpacket、bpf、tap のうち @@ -524,8 +467,7 @@ In all cases, you need to prepare two sh nono-ifup and nono-ifdown in the VM directory or its parent directory. Even if you don't have anything to do in these scripts, -you need to prepare empty scripts that will terminate successfully. - +you need to prepare empty scripts that will terminate successfully. _EOM_ ); @@ -542,6 +484,43 @@ The default is 0. _EOM_ ); +config_item("luna-adjust-misused-epoch = integer", <<<_EOM_ +LUNA で誤った RTC epoch を採用している OS 向けに RTC +エミュレーションを補正するかどうかを +指定します。0 なら補正をしません(実機と同じ動作)、 +1 なら補正します(現実世界と同じ動作)。 +デフォルトは 1 で、通常 1 のままで使用して問題ありません。 + +Specifies whether nono corrects RTC emulation for OSes +that adopts wrong RTC epoch on LUNA. +0 means making no correction +(this is the same behavior as the actual machine). +1 means making correction +(this is the same behavior as the real world). +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 で同じだと思います)。
+例えば1970年はうるう年ではないため 2月28日の翌日は 3月1日ですが、
+MK48T02 的には 00年であるためうるう年と認識し 2月28日の翌日が2月29日になります。
+このように、実機の RTC は4年のうち約2年間、1日ずれた日付を指しているようです。
+しかしながら、RTC の時刻は OS 起動時に一度読んだ後は基本的に参照しない上、
+今時必要なら NTP で時間を合わせるため、
+実機でも問題が顕在化することはまずないと思います。
+nono の場合は実機と異なり、アプリケーション実行中しか RTC が進まないため、
+補正がない場合の動作が問題になるのは
+nono を起動したまま偶数年の2月末日から日付をまたいで、
+かつ nono を起動したまま OS を再起動して NTP などで時刻修正を行わなかった時
+だけだと思います。
+このオプションはほぼ開発者向けの動作確認用です。
+_EOM_
+);
+
config_item("luna-dipsw1 = string", <<<_EOM_
本体前面 DIPSW#1-1..#1-8 の内容を指定します。
"0" を DOWN、"1" を UP として、
@@ -583,8 +562,7 @@ DIPSW#2 が "11111111" なら
if the DIPSW#2 is "11111111".
Otherwise, the bootloader will enter interactive mode.
(I doubt that they actually wanted to switch with only #8)
-
-
+
_EOM_
);
@@ -595,8 +573,7 @@ config_item("monitor-rate = integerSpecifies refresh rate of all text monitor windows in Hz.
It ranges from 1 to 60. The default is 20Hz.
You can change this value on GUI menu after boot,
-but unlike this configuration value, there are only a few preset choices.
-
+but unlike this configuration value, there are only a few preset choices.
_EOM_
);
@@ -645,8 +622,7 @@ The default value is empty.
nono 内蔵のなんちゃって下位互換 ROM で起動します。
LUNA-I 実機を持っている場合は ROM ファイルを指定することで実機 ROM で起動できます。 @@ -658,16 +634,14 @@ you can boot with the real ROM spcifying The ROM file is extracted from 0x41000000-0x4101ffff (128KB) of 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. - +I have no idea about other ROMs.
LUNA88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。
今のところ ROM は version 1.20 のみサポートしています。
-例えば、nono.cfg と同じディレクトリに置いたディスクイメージ luna.img
-を使う場合、
-LUNA では通常 ID 6 をプライマリ HDD に割り当てるのでこんな感じになります。
-
+例えば、nono.cfg と同じディレクトリに置いた sd0.img を
+起動 HDD ディスクイメージとして使い
+(LUNA では通常 ID 6 をプライマリ HDD に割り当てます)、
+ID 5 に同じディレクトリの install.iso をセットした CD ドライブを、
+ID 4 に起動時メディアなしの MO ドライブを接続する場合は次のようになります。
+
+ちなみに、メディアを書き込み禁止にしたい場合はこれではなく、
+イメージファイルの書き込み権を落としてください。
+ VM について
- |
|
- | …
|
-三角2つの場合、ユーザが高速モードを指定していて、等速モードで実行中です。
-キー入力中(後述)または VM がアイドル状態(m68k の STOP 命令)などで起きます。
+三角3つの場合、ユーザが高速モードを指定していて、高速モードで実行中です。
高速モード中はパーセントではなく何倍速で動作しているかを表します。
- | When an icon (two triangles) is displayed, +When an icon (three triangles) is displayed, the user has specified full speed mode and -the VM is running in synchronized mode. -This will happen during keystrokes (see below) or when the VM is idle -(STOP instruction on m68k). -+the VM is running in full speed mode. |
Key input
Key input mode
Most LUNAs have the Japanese keyboard +(though I ever heard there are the US keyboard...). +So nono provides two input modes +for Japanese keyboard users and non Japanese keyboard users. +Both have advantages and disadvantages.+
+JP キーボードモードは、ホストが日本語キーボードであることを前提に
+対応するキーの押下、開放をその都度 VM に入力します。
+メリットとしては動作が実機に近くなり、
+特にキーリピート(をハードウェアが行わないこと)も忠実に再現可能です。
+デメリットは ALT + TAB やアクセラレータキーでメニューを開く場合などに
+キー入力が残ることがあることです
+(キーを押した後でフォーカスが外れるとキーを離したことが
+アプリケーションに通知されないため)。
+またホストが日本語キーボードでなければ使いづらいです。
+JP keyboard mode assumes that the host uses the Japanese keyboard.
+Each time you presses and releases a key,
+nono sends the corresponding key-pressed or key-released to the VM.
+One advantage is that it's close to the real machine behavior,
+and another is that it can reproduce
+the LUNA keyboard itself does not perform a key repeat.
+On the other hand,
+one disadvantage is that key sometimes remains pressed,
+especially when you enter ALT + TAB to switch the application
+or enter accelerator key to open the menu
+(If the application loses the focus after the key is pressed,
+the application will not receive the subsequent key release).
+And another disadvantage is that
+it will be hard to use for non Japenese keyboard users.
+
+一方、キャラクタ入力モードは、ホストから入力された「文字」を
+再び LUNA のキーコードに解釈し直して VM に入力するモードです。
+例えばゲスト OS に "@" を入力したい場合、
+US キーボードなら [SHIFT] + [2] を、
+JP キーボードなら [@] キーを押しますが、
+どちらも VM には [@] キーの押下、[@] キーの開放が連続して送られます。
+US キーボードで [SHIFT] を押したことは通知されません。
+逆に "=" を入力したい場合、
+US キーボードなら [=] キーを、
+JP キーボードなら [SHIFT] + [-] を押しますが、
+どちらも VM には
+[SHIFT]押下 → [-]押下 → [-]開放 → [SHIFT]開放のシーケンスが送られます。
+このようにホストキーボードのレイアウトによらず、
+入力したい文字が入力できるようになり、
+通常のタイピングで困ることはないと思います。
+デメリットは、通常の文字入力以外のタイピングはほぼ出来ないことです。
+[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.
+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
+[@]-pressed and [@]-released will be sent to the VM.
+Note that the fact that you pressed [SHIFT] key on the US keyboard
+will not be sent to the VM.
+Another example, if you want to type "=",
+you would press [=] on the US keyboard or [SHIFT] + [-] on the JP keyboard.
+In both cases, the sequence of
+[SHIFT]-pressed, [-]-pressed, [-]-released, and [SHIFT]-released
+will be sent to the VM.
+Thus, you can type what character you want to type,
+regardless of your keyboard layout.
+Of course there are some disadvantages.
+Firstly, it's hard to type any special characters,
+for example, you can not type any key conbinations
+that don't generate a character.
+Or you can not hold [SHIFT] key pressed.
+Secondly, the key repeat works (by the host),
+even though it should not work as a correct emulation
+(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 +only be typed from the software keyboard window.+
+
| HostChar"; + print " | GuestKey\n"; + for ($i = 0; $i < count($table[$j]); $i++) { + list ($h, $g) = $table[$j][$i]; + print " |
|---|---|
| {$h}"; + print " | ${g}\n"; + } + print " |
Keycode table in the JP keyboard mode
The following table shows the correspondence between +the host key and the guest key. +The keys where the HostKey is N/A can only be enter from +the software keyboard window.+
+
Key Repeat
-On LUNA, +On LUNA, key repeat is done by software(OS), not by the keyboard hardware. For this reason, key repeat doesn't occur on LUNA's PROM or NetBSD/luna68k's bootloader @@ -853,22 +1195,19 @@ while any keys are pressed. That is why the above-mentioned icon distinguishes them. If keys continue to be pressed for some reasons, the VM also continues to run syncronized mode. -In this case, you can resolve it by using the software keyboard window. -+In this case, you can resolve it by using the software keyboard window.
Try it
Try NetBSD/luna68k
Try it
Try NetBSD/luna68k
Tsutsui-san has provided a liveimage of NetBSD/luna68k 9.2.
Let's try it.
Download imagefile from the following link, extract it and place it in the VM directory, ~/nono/luna/.
-http://teokurebsd.org/netbsd/liveimage/20210614-luna68k/ +http://teokurebsd.org/netbsd/liveimage/20210910-luna68k/
@@ -924,7 +1263,7 @@ x⏎vmtype = luna -spc0-id6-image = hd,liveimage-luna68k-raw-20210614.img +spc0-id6-image = hd,liveimage-luna68k-with-packages-20210910.img hostnet-driver = none
You will see a screen like this. The bold text indicates the characters you need to enter.
-NONO 0.2.0 Emulated ROM Monitor for LUNA-I +NONO Emulated ROM Monitor for LUNA-I ** NVRAM Initialized. @@ -954,8 +1293,7 @@ In addition, after the first login, you This is because the infamous makemandb(8) runs heavily in the background for a looooong time. It's very sad to me that these two accidents which are far from the ideal -are the first experiences of a newcomer. - +are the first experiences of a newcomer.- 終了する時は root ユーザで “shutdown -p now” を実行してください。 @@ -967,13 +1305,13 @@ and nono will terminate when the VM is p
Try OpenBSD/luna88k
Try OpenBSD/luna88k
Aoyama-san has provided a liveimage of OpenBSD/luna88k 6.9.+あおやまさんが OpenBSD/luna88k 7.0-beta の liveimage を用意されています。 +
Aoyama-san has provided a liveimage of OpenBSD/luna88k 7.0-beta.
Let's try it.
Download liveimage-luna88k-raw-YYYYMMDD.img.gz from the following link, +Download liveimage-luna88k-raw-20210918.img.gz from the following link, extract it and place it in the VM directory, ~/nono/luna88k/.@@ -1026,7 +1364,7 @@ b⏎vmtype = luna88k -spc0-id6-image = hd,liveimage-luna88k-raw-20210614.img +spc0-id6-image = hd,liveimage-luna88k-raw-20210918.img hostnet-driver = noneYou will see a screen like this. The bold text indicates the characters you need to enter.-NONO 0.2.0 Emulated ROM Monitor for LUNA88K +NONO Emulated ROM Monitor for LUNA88K ** NVRAM Initialized. @@ -1052,7 +1390,7 @@ and nono will terminate when the VM is p -ネットワーク設定例
+Example of network setup6. ネットワーク設定例
Example of network setupwm0 を持つ NetBSD ホストに tap(4) デバイスを用いて nono のゲスト OS を接続する場合の設定例です。 @@ -1075,8 +1413,7 @@ sysinst 等で OS をアップグレー に戻るのがハマりポイントです。+ +By default, /dev/tap is only accessible to privileged user. You need to chmod /dev/tap (without unit number) appropriately. -Note that upgrading using sysinst always reset the permission to 600. -+Note that upgrading using sysinst always reset the permission to 600.- bridge(4) インタフェースを作成し、 ホストの外部(物理)インタフェースをブリッジに追加しておきます。 @@ -1145,21 +1482,33 @@ It's OK if you can see "HostNet Driver:
7. 過去のバージョンからの移行方法
+How to migrate from old versions+バージョンアップに伴い設定ファイル等に非互換が発生する場合があります。 +その場合は以下の移行方法を参照して設定ファイル等を更新してください。 ++ -Some versions may have incompatibilities in the configuration files, etc. +In such case, you may need to upgrade it by referring the following link.+ +変更履歴
+Changes8. 変更履歴
ChangesSee changes.html.- -ライセンス
+License9. 連絡先、ライセンス等
+ +Contact, License, etc9.1. ライセンス
LicenseSee nono-license.txt.- -連絡先
+Contact us9.2. 連絡先
Contact usバグ報告などは以下にお願いします。日本語でおk。- -If you find any problems, please let me know. @@ -1168,12 +1517,11 @@ You may write in English.
>https://github.com/isaki68k/nono-issue/issuesパッチの提供について
+About contributes9.3. パッチの提供について
About contributesパッチを提供してくださる場合は以下に同意したものとします。 -- -If you provide a patch to nono, you must agree to the following conditions: -+If you provide a patch to nono, you must agree to the following +conditions:
- 成果物が nono のライセンスに従って運用あるいは配布されること。
All your work are operated or distributed under the nono license.@@ -1185,8 +1533,7 @@ You may write in English.
Acknowledgements
+9.4. Acknowledgements
nono は以下の広告条項を含むソースコードを利用しています。nono uses source code with the following advertising clause.