nono is OMRON LUNA-I and LUNA88K emulator runs on NetBSD and etc.+nono は NetBSD とかで動作する OMRON LUNA-I や LUNA-88K とかのエミュレータです。 +
nono is OMRON LUNA-I and LUNA-88K emulator runs on NetBSD and etc.
How to migrate from ver 0.2.x to ver 0.2.0
How to build
Command Line Option
Configuration
About VM
Try it
Example of 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 migrate from ver 0.2.x to ver 0.3.0
Configuration about debugger has been changed from ver 0.2.x to ver 0.3.0. +If your configuration file has them, please update by yourself. +See Configuration section in this document.+ +
+
+以下の設定項目は廃止になりました。
+The following item has been removed.
+
+
+ +代わりに以下の2つが追加されています。 ++debugger-port = (default: 0) +
Instead, the following two items are added.+
+ ++debugger-driver = (default: none) +debugger-tcp-port = (default: 0) +
How to build
+-DNOTEST は開発者用のテストツールをビルドしないためのものです。
+With -DNOTEST, the build excludes test tools which is needed
+for developers only.
+
@@ -162,15 +215,13 @@ 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.% ./configure -% make depend -% make +% make -DNOTEST depend +% make -DNOTEST % su # make install
Boot as the fast mode. You can change this mode on GUI menu after boot, -and the option only changes its initial state. -
Use this name=value instead of name=configvalue specified in configuration file. -
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. -
For developers:@@ -243,12 +293,16 @@ this option preceeds.
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:
@@ -281,11 +334,10 @@ lines with unrecognized key are also ign
Specifies the VM type from the following. -This field is mandatory. -+This field is mandatory.
| luna | … LUNA-I - | |
| luna88k | … LUNA88K + | |
| luna88k | … LUNA-88K |
Specifies the TCP port number that debugger listens. -If 0, it will not listen. -The default is 0.
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.+
Specify the TCP port number that debugger console driver listens.+
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.
Specify the TCP port number that host driver listens.
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.
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.
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 で時間を合わせるため、
実機でも問題が顕在化することはまずないと思います。
@@ -457,9 +550,9 @@ See the following link about DIPSW.<
→ NetBSD/luna68k: Information
-LUNA88K でのデフォルトは 11111111 です。
+LUNA-88K でのデフォルトは 11111111 です。
各スイッチの内容は以下のリンクを参照してください。
-On LUNA88K, the default value is 11111111.
+
On LUNA-88K, the default value is 11111111.
See the following link about DIPSW.
→ OpenBSD manual pages: boot_luna88k(8)
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).
Specifies 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. -
Specifies the MPU clock in MHz. -The default value is 20MHz on LUNA-I, or 25MHz on LUNA88K.
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, @@ -526,8 +629,7 @@ The default value is empty.nono 内蔵のなんちゃって下位互換 ROM で起動します。If you does not have the real LUNA machines, you can boot with nono's internal downward compatible emulated ROM -if you set this field empty (or leave it as the default). -+if you set this field empty (or leave it as the default).
LUNA-I 実機を持っている場合は ROM ファイルを指定することで実機 ROM で起動できます。 @@ -539,23 +641,21 @@ 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) を保存したものです。
+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.
-
Specifies the RAM size in MB. @@ -563,18 +663,27 @@ 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. +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. -
Specifies the RTC 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.
Specifies whether to display the status panel or not. If 0, it is hidden; if 1, it is shown. -You can change it on GUI menu after boot. -
If devtype is hd, path cannot be ommitted. If devtype is cd or mo, path can be ommitted. -If the path is relative path, it is from the VM directory. -+If the path is relative path, it is from the VM directory.
例えば、nono.cfg と同じディレクトリに置いた sd0.img を @@ -630,8 +737,7 @@ spc0-id4-image = mo Currently, the default value is 0 (This may be something like SSD :-). If you specify about 16 or so, you can feel nostalgic, -but this feature is still unstable. -
Obsolete. Use spc0-idN-writeignore instead. -This option is for developers. -
The performance meter's icon at the center of the status panel shows the VM speed status. -You can switch full speed / syncronized mode by double-clicking on this icon. -+You can switch full speed / syncronized mode by double-clicking +on this icon.
|
- | …
|
-三角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. |
一方、キャラクタ入力モードは、ホストから入力された「文字」を
再び LUNA のキーコードに解釈し直して VM に入力するモードです。
@@ -1021,8 +1130,7 @@ 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.
@@ -1033,10 +1141,8 @@ In this case, you can resolve it by usin
つついさんが NetBSD/luna68k 9.2 の liveimage を用意されています。
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/
@@ -1092,7 +1198,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 0.3.0 Emulated ROM Monitor for LUNA-I ** NVRAM Initialized. @@ -1122,8 +1228,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 newcomers.終了する時は root ユーザで “shutdown -p now” を実行してください。 @@ -1137,11 +1242,11 @@ and nono will terminate when the VM is p 5.2. OpenBSD/luna88k を実行してみる
Try OpenBSD/luna88k-あおやまさんが OpenBSD/luna88k 6.9 の liveimage を用意されています。 -@@ -1243,8 +1348,7 @@ sysinst 等で OS をアップグレー に戻るのがハマりポイントです。Aoyama-san has provided a liveimage of OpenBSD/luna88k 6.9.+あおやまさんが OpenBSD/luna88k 7.0 の liveimage を用意されています。 +Aoyama-san has provided a liveimage of OpenBSD/luna88k 7.0.-
ここではこれを起動してみます。- https://twitter.com/ao_kenji/status/1404784588015112192 +
- https://twitter.com/ao_kenji/status/1473611893386661888
Let's try it.
@@ -1152,10 +1257,10 @@ and nono will terminate when the VM is p and create subdirectories for individual VMs in it (for example ~/nono/luna88k/). -以下のリンクから liveimage-luna88k-raw-YYYYMMDD.img.gz + 以下のリンクから liveimage-luna88k-raw-20211221.img.gz をダウンロードして展開し、 VM ディレクトリ ~/nono/luna88k/ に置きます。 - Download liveimage-luna88k-raw-YYYYMMDD.img.gz from the following link, +Download liveimage-luna88k-raw-20211221.img.gz from the following link, extract it and place it in the VM directory, ~/nono/luna88k/.@@ -1194,7 +1299,7 @@ b⏎vmtype = luna88k -spc0-id6-image = hd,liveimage-luna88k-raw-20210614.img +spc0-id6-image = hd,liveimage-luna88k-raw-20211221.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 0.3.0 Emulated ROM Monitor for LUNA88K ** NVRAM Initialized. @@ -1209,10 +1314,10 @@ so next time it boots OpenBSD automatica終了する時は root ユーザで “shutdown -p now” を実行してください。 -LUNA88K はソフトウェアから電源オフでき、 +LUNA-88K はソフトウェアから電源オフでき、 VM の電源オフで nono も終了します。 To quit, type “shutdown -p now” as the root user. -LUNA88K can be powered off by software, +LUNA-88K can be powered off by software, and nono will terminate when the VM is powered off.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) インタフェースを作成し、 ホストの外部(物理)インタフェースをブリッジに追加しておきます。 @@ -1312,9 +1416,38 @@ It's OK if you can see "HostNet Driver: + + 7. 既知の問題
+Known Issues+-+
+- デバッガのコンソール入力で、 +バックスペースやカーソルキーの入力に対する表示が動作していません。 +
In debugger console, some special characters like backspace or cursor keys +aren't printed correctly.+(since ver 0.3.0) +- ホストが VirtualBox (on Windows?) で、 +VirtualBox の「マウス統合」が有効にしている場合、 +nono の「マウスモード」でマウスポインタが正しく移動しません。 +
If the host OS is running on VirtualBox (on Windows?) and +"Mouse integration" on VirtualBox is enabled, +the mouse pointer will not move as expected in nono's Mouse Mode.+(2021/12/30) + +- Wayland の場合にウィンドウサイズが正しく設定されない場合があります。 +wxWidgets (3.0.5) のバグと思われます。 +
On Wayland, window size may be incorrect. +This may be due to wxWidgets (3.0.5) bug.+(2021/12/30) + +- メインウィンドウの中央付近に nono のサブウィンドウや他のウィンドウが存在する場合、マウスモードに入れません。 +
If there are nono's sub windows or other windows near the center of +the main window, you will not enter the mouse mode.(since ver 0.0.2) + +7. 過去のバージョンからの移行方法
+How to migrate from old versions8. 過去のバージョンからの移行方法
How to migrate from old versionsバージョンアップに伴い設定ファイル等に非互換が発生する場合があります。 その場合は以下の移行方法を参照して設定ファイル等を更新してください。 @@ -1326,20 +1459,20 @@ In such case, you may need to upgrade it-8. 変更履歴
+Changes9. 変更履歴
ChangesSee changes.html.-9. 連絡先、ライセンス等
+Contact, License, etc10. 連絡先、ライセンス等
-Contact, License, etc9.1. ライセンス
+License10.1. ライセンス
LicenseSee nono-license.txt.-9.2. 連絡先
+Contact us10.2. 連絡先
Contact usバグ報告などは以下にお願いします。日本語でおk。-If you find any problems, please let me know. @@ -1348,11 +1481,11 @@ You may write in English.
>https://github.com/isaki68k/nono-issue/issues9.3. パッチの提供について
+About contributes10.3. パッチの提供について
About contributesパッチを提供してくださる場合は以下に同意したものとします。 --If you provide a patch to nono, you must agree to the following conditions: -+If you provide a patch to nono, we assume that you agree the following +conditions:
- 成果物が nono のライセンスに従って運用あるいは配布されること。
All your work are operated or distributed under the nono license.@@ -1364,7 +1497,7 @@ You may write in English.
9.4. Acknowledgements
+10.4. Acknowledgements
nono は以下の広告条項を含むソースコードを利用しています。nono uses source code with the following advertising clause.