nono is OMRON LUNA-I emulator runs on NetBSD and etc.-
+nono は NetBSD とかで動作する OMRON LUNA-I や LUNA88K とかのエミュレータです。
+nono is OMRON LUNA-I and LUNA88K emulator runs on NetBSD and etc.
+
+
How to migrate from ver 0.1.x to ver 0.2.0
How to build
Command Line Option
Configuration
About VM
Try it
Setup network
Example of network setup
Changes
Contact, License, etc
Introduction
How to migrate from ver 0.1.x to ver 0.2.0
-nono is OMRON LUNA-I emulator runs on NetBSD and etc. -LUNA88K is still experimental support. --
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.+
How to build
-アーカイブを展開したら以下のようにビルドします。
+nono のソースアーカイブを展開したら以下のようにビルドします。
configure には環境変数 CC、CXX でコンパイラを指定することが出来ます。
また wx-config が標準的な名前で提供されていないために見付けられない場合には
環境変数 WX_CONFIG にパスを指定することが出来ます。
-Extract the archive and build as following.
+
Extract the nono's source archive and build as following.
You can specify C/C++ compiler using environment variable CC and CXX
if configure cannot find standard name suitable compiler.
Also, you can specify wx-config path using environment variable WX_CONFIG
@@ -292,8 +346,20 @@ This field is mandatory.
luna … LUNA-I
- luna88k … LUNA88K (experimental)
+ luna88k … LUNA88K
Specify how to synchronize the time in virtual machine. +If real, synchronize with the real time; +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. +
Specifies the TCP port number that debugger listens. If 0, it will not listen. The default is 0.
Specifies the host driver of ethernet device. -none, tap and bpf can be specified. -If none, it doesn't make any communication with the host. -tap or bpf is determined at build time for the host OS. -If the host is NetBSD, OpenBSD, FreeBSD, or Linux, it's tap.
Specifies the host device name of ethernet device. -If ethernet-hostdriver is tap, -this field specifies the full path to the tap device.-
-デフォルトは auto で、この場合の動作はホスト OS ごとに異なります。 -Linux なら "/dev/net/tun" を指定したのと同じです。 +afpacket, bpf, and tap can be specified +only if the host OS supports them. +auto and none can always be specified. +afpacket uses Linux's AF_PACKET socket, +bpf uses bpf(4) device, +and tap uses tap(4) interface. +none doesn't make any communication with the host. +If auto is specified, +it tries tap, afpacket, and bpf in that order +(if the host OS supports them). +The default is auto.
Specify an interface name to bind to, when the host driver is afpacket. +If auto is specified as ifname, +it selects an usable interface automatically. +The default is auto. +Note that this host driver cannot communicate with the localhost.
Specify an interface name to bind to, when the host driver is bpf. +If auto is specified as ifname, +it selects an usable interface automatically. +The default is auto. +Note that this host driver cannot communicate with the localhost.
The default is auto. +いずれの場合も VM ディレクトリかその親ディレクトリに +nono-ifup, nono-ifdown という名前のシェルスクリプトが必要です。 +何もすることがない場合でも正常終了する空のシェルスクリプトを用意してください。 ++Specify a device pathname, when the host driver is tap. +The default is auto. The behavior in this case depends on the host OS. On Linux, it's the same as /dev/net/tun. On OpenBSD, it will try from /dev/tap0 to /dev/tap9 @@ -335,13 +441,22 @@ until successful. On NetBSD (and FreeBSD), it will try cloning by /dev/tap first. If that fails, then try from /dev/tap0 to /dev/tap9 until successful. -
Specify the behavior when the driver which is selected by +hostnet-driver is unusable; +terminate the process if 0, +or continue to run using the none driver if 1. +The default is 0.
Specifies the MPU clock in MHz. The default value is 20MHz on LUNA-I, or 25MHz on LUNA88K.
実機を持っていない場合はこの値を空に (= デフォルトのままに) しておくと、
-nono 内蔵のなんちゃって下位互換 ROM で起動します(現状 LUNA-I のみ)。
+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).
-For now, it's only for LUNA-I.
LUNA-I 実機を持っている場合は @@ -433,11 +559,11 @@ I have no idea about other ROMs.
LUNA88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。
-ただし現状サポートしていません。
+今のところ ROM は version 1.20 のみサポートしています。
For LUNA88K,
the ROM file is extracted from 0x41000000-0x4103ffff (256KB).
-However, it's not supported yet.
+For now, only version 1.20 is supported.
When an icon (two triangles) is displayed, the user has specified full speed mode and the VM is running in synchronized mode. -This will happen during keystrokes or when the VM is idle +This will happen during keystrokes (see below) or when the VM is idle (STOP instruction on m68k).
Try it
Try NetBSD/luna68k
Tsutsui-san has provided NetBSD/luna68k 9.0 liveimage for this -(Thanks as always).+つついさんが NetBSD/luna68k 9.2 の liveimage を用意されています。 +
Tsutsui-san has provided a liveimage of NetBSD/luna68k 9.2.+
Let's try it.
Create a directory somewhere for nono (for example ~/nono/), -and create subdirectories for individual VMs in it (for example ~/nono/luna/).+and create subdirectories for individual VMs in it +(for example ~/nono/luna/).
Download imagefile from the following link, extract it and place it in the VM directory, ~/nono/luna/.
-http://teokurebsd.org/netbsd/liveimage/20200518-luna68k/ +http://teokurebsd.org/netbsd/liveimage/20210614-luna68k/-
Create a configuration file nono.cfg in the VM directory, ~/nono/luna/, -with following contents:+with following contents. +By the way, to simplify the explanation, we assume there is no network here. +However, please configure the network if necessary.
+vmtype = luna -spc0-id6-image = hd,liveimage-luna68k-raw-20200518.img +spc0-id6-image = hd,liveimage-luna68k-raw-20210614.img +hostnet-driver = none
Run as nono -c ~/nono/luna. @@ -650,64 +790,183 @@ spc0-id6-image = hd,liveimage-luna68k-raThe emulated ROM Monitor will be executed. Then, only for the first time, entering the following can boot NetBSD.++画面はこんな感じのはずです (太字が入力部分)。 ++k⏎ +⏎ +⏎ +d⏎ +boot⏎ +g⏎ +x⏎ +You will see a screen like this. The bold text indicates +the characters you need to enter.この内容は NVRAM.DAT に記録されているので次回以降は直接 NetBSD が起動します。-k -[Enter] -[Enter] -d -boot -g -x +NONO 0.2.0 Emulated ROM Monitor for LUNA-I + +** NVRAM Initialized. + +>k⏎ +controller: dk ?⏎ +drive unit: 0 ?⏎ +partition : c ?d⏎ +filename : vmunix ?boot⏎ +>g⏎ +Loaded. Entry point = $00700000 +>x⏎The information you have just entered is recorded in the NVRAM, so next time it boots NetBSD automatically.+- 初回起動時、 +Updating fontconfig cache はあほみたいに時間がかかりますが、 +nono がハングアップしてるわけではありません(>_<)。 +また初回ログイン時めちゃくちゃ重たいですが、 +これはバックグラウンドで makemandb が動くためで +nono のせいではありません(>_<)。 +
At the first boot, you will see the console stops after printing +"Updating fontconfig cache". +This is because the infamous fontconfig takes very looooong time. +nono would not have hang-up. +In addition, after the first login, you will feel it's too heavy. +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. ++ +- 終了する時は root +ユーザで “shutdown -p now” を実行してください。 +LUNA はソフトウェアから電源オフでき、 +VM の電源オフで nono も終了します。 +
To quit, type “shutdown -p now” as the root user. +LUNA can be powered off by software, +and nono will terminate when the VM is powered off.
Try OpenBSD/luna88k
Aoyama-san has provided a liveimage of OpenBSD/luna88k 6.9.+ +ここではこれを起動してみます。
Let's try it.+
Create a directory somewhere for nono (for example ~/nono/), +and create subdirectories for individual VMs in it +(for example ~/nono/luna88k/).+ +
Download liveimage-luna88k-raw-YYYYMMDD.img.gz from the following link, +extract it and place it in the VM directory, ~/nono/luna88k/.+
+http://www.nk-home.net/~aoyama/liveimage/ ++ +
Create a configuration file nono.cfg in the VM directory, ~/nono/luna88k/, +with following contents. +By the way, to simplify the explanation, we assume there is no network here. +However, please configure the network if necessary.+
+ ++vmtype = luna88k +spc0-id6-image = hd,liveimage-luna88k-raw-20210614.img +hostnet-driver = none +
Run as nono -c ~/nono/luna88k. +(NVRAM.DAT will be created automatically in the VM directory)+
The emulated ROM Monitor will be executed. +Then, only for the first time, +entering the following can boot OpenBSD.+
+画面はこんな感じのはずです (太字が入力部分)。 ++nvram boot_filename boot⏎ +y +b⏎ +
You will see a screen like this. The bold text indicates +the characters you need to enter.+
+この内容は NVRAM.DAT に記録されているので次回以降は直接 OpenBSD が起動します。 ++NONO 0.2.0 Emulated ROM Monitor for LUNA88K + +** NVRAM Initialized. + +N>nvram boot_filename boot⏎ +Update boot_filename : "vmunix" -> "boot" (Y/[N]):y +Updated +N>b⏎ +
The information you have just entered is recorded in the NVRAM, +so next time it boots OpenBSD automatically.+ +
To quit, type “shutdown -p now” as the root user. +LUNA88K can be powered off by software, +and nono will terminate when the VM is powered off.+
Setup network
Example of network setup
Add the following line to configuration file, nono.cfg.+wm0 を持つ NetBSD ホストに tap(4) デバイスを用いて +nono のゲスト OS を接続する場合の設定例です。 +
Add the following line to configuration file, nono.cfg. +(Although you don't need to write it since these are default behavior +on NetBSD)
-次に VM ディレクトリかその親ディレクトリに nono-ifup、nono-ifdown -というスクリプトを用意します。 -nono は tap(4) をオープンし、 -そのデバイス名を引数にこれらのスクリプトを呼びます。 --ethernet-hostdriver = tap +hostnet-driver = tap +hostnet-tap-devpath = auto
Then, prepare two scripts named nono-ifup and nono-ifdown -in the VM directory or its parent directory. -nono will open tap(4) and -invoke these scripts with the name of the device as an argument.-
-例えば、NetBSD ホストで、ホストの wm0 セグメントに nono のゲスト OS を接続する場合、
-For example, if you want to connect guest OS to host's wm0 segment
-on NetBSD,
-
By default, /dev/tap is only accessible to privileged user. -You need to chmod /dev/tap (without unit number) appropriately.sysinst 等で OS をアップグレードするとパーミッションが 600 に戻るのがハマりポイントです。 +
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. +
Create a bridge(4) interface, and add your physical interface to the bridge.
-常用するなら設定ファイルに書いておきましょう。 -# ifconfig bridge0 create # brconfig bridge0 add wm0
If you want to use this all the time, +常用するなら /etc の設定ファイルに書いておきましょう。 +If you use it regularly, you can put configuration file into /etc./etc/ifconfig.bridge0 @@ -725,9 +984,13 @@ up 一般ユーザに戻って、 VM ディレクトリかその親ディレクトリに 次のような 2つのスクリプトを用意します。 +nono は tap(4) をオープンし、 +そのデバイス名を引数にこれらのスクリプトを呼びます。 sudo の設定は別途行ってください。Return to non-privileged user, and create following two scripts in the VM directory or its parent directory. +nono will open tap(4) and +invoke these scripts with the name of the device as an argument. In addition, you need to set up sudo separately.nono-ifup @@ -751,10 +1014,10 @@ sudo /sbin/ifconfig $1 down- nono を起動し、 メニューの「モニタ > ホスト > ホストネットワーク」を開いて -NetDriver が None 以外 (この場合 BSD tap) になっていれば動いてるはずです。 +HostNet Driver: tap になっていれば動いてるはずです。
Run nono, and open "Monitor > Host > Host Network" window from menu. -It's OK if you can see "NetDriver: BSD tap" (in this case).+It's OK if you can see "HostNet Driver: tap".