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.
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.
How to build
The followings are required for build. If you use NetBSD(pkgsrc), wxWidgets is pkgsrc/x11/wxGTK30 (OPTIONS:gtk3 is tested).
(NetBSD 以外でのビルドはサポートしていませんが)
Ubuntu 18.04 ではたぶん以下のパッケージが必要です。
You may need the following packages on Ubuntu 18.04
(though we won't support non-NetBSD platform).
nono のソースアーカイブを展開したら以下のようにビルドします。
configure には環境変数 CC、CXX でコンパイラを指定することが出来ます。
また wx-config が標準的な名前で提供されていないために見付けられない場合には
環境変数 WX_CONFIG にパスを指定することが出来ます。
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
if configure cannot find wx-config.
% ./configure % make depend % make % su # make install
2つの実行ファイルがインストールされます。
nono が GUI 版実行ファイル、
nono-cli がコマンドライン版です。
Two executables will be installed.
nono is the GUI executable and nono-cli is
the command line executable.
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.
Specifies the VM directory/configuration file. If vmpath is a directory, make nono.cfg in that directory a configuration file. Or if vmpath is a file, make the specified file a configuration file. 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.
Boot as the fast mode. You can change this mode on GUI menu after boot, and the option only changes its initial state.
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.
GUI Only. Specifies the initial main window scale in real number. You can change this scale on GUI menu after boot, but unlike this option, there are only a few preset choices (Should be improved in someday). The default value is 1.0
Shows the result of reading configuration file and parsing -V options.
Shows the version.
Use this name=value instead of name=configvalue specified in configuration file.
For developers:
Configuration
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. And, blank lines, lines beginning with "#", and lines with unrecognized key are also ignored.
設定項目は次の通りです。
The configuration items are:
Specifies the VM type from the following. This field is mandatory.
luna | … LUNA-I | |
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. 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.
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 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. In all cases, you need to prepare two shell script files which names are 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.
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 status of the front panel DIPSW#1-1..#1-8 using 8 digit. "0" means DOWN and "1" means UP. The first character corresponds to #1 and the eighth character corresponds to #8.
LUNA-I でのデフォルトは 11110111 です。
各スイッチの内容は以下のリンクを参照してください。
On LUNA-I, the default value is 11110111.
See the following link about DIPSW.
→ NetBSD/luna68k: Information
LUNA88K でのデフォルトは 11111111 です。
各スイッチの内容は以下のリンクを参照してください。
On LUNA88K, the default value is 11111111.
See the following link about DIPSW.
→ OpenBSD manual pages: boot_luna88k(8)
Specifies status of the front panel DIPSW#2-1..#2-8. The same syntax as luna-dipsw1 is used. The default value is 11111111.
NetBSD/luna68k のブートローダは、
DIPSW#2 が "11111111" なら自動的にカーネルをロードして実行し、
どれかでも "0" にするとプロンプトで停止するようです。
(本当は #8 だけで制御するつもりだったんじゃないかという気がします)
NetBSD/luna68k bootloader will automatically load and execute the kernel,
if the DIPSW#2 is "11111111".
Otherwise, the bootloader will enter interactive mode.
(I doubt that they actually wanted to switch with only #8)
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. 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 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).
LUNA-I 実機を持っている場合は
ROM ファイルを指定することで実機 ROM で起動できます。
ROM ファイルは実機の 0x41000000-0x4101ffff (128KB) を保存したものです。
今のところ ROM は V4.22 (Thu Jul 27 11:45:42 1989) のみサポートしています。
それ以外については何も分かりません。
If you have the real LUNA-I machine,
you can boot with the real ROM spcifying the ROM file path.
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.
LUNA88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。
今のところ ROM は version 1.20 のみサポートしています。
For LUNA88K,
the ROM file is extracted from 0x41000000-0x4103ffff (256KB).
For now, only version 1.20 is supported.
Specifies the RAM size in MB. 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. 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 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.
Specifies SCSI device. N is 0 to 7. But don't specify ID 7 because the host uses it. The value is in a form of device type devtype and the image path path separated by ","(comma). For now, only "hd" (hard disk) can be specified for devtype. If the path is relative path, it is from the VM directory.
例えば、nono.cfg と同じディレクトリに置いたディスクイメージ luna.img
を使う場合、
LUNA では通常 ID 6 をプライマリ HDD に割り当てるのでこんな感じになります。
For example, if you use disk image luna.img placed in the same
directory as nono.cfg,
since LUNA usually assigns ID 6 to the primary HDD,
write as following:
spc0-id6-image = hd,luna.img
Specifies the average seek time of specified SCSI HDD in msec. 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.
Specifies whether nono ignores writing to SCSI devices. 0 means normal operation (writes to the devices). If 1 is specified, nono will not actually write back to the disk image even though the write command is succeeded. nono's SCSI devices acts as write command is successfully done but it never writes back to the actual disk image. This is useful for kernel debugging because it does not require fsck after the kernel hangs. But don't use this flag if you don't understand this paragraph. The default value is 0.
About VM
Status Panel
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.
…
|
マークなしの場合、ユーザが等速モードを指定していて、等速モードで実行中です。
| When no icons are displayed, the user has specified syncronized mode and the VM is running in synchronized mode.
| …
|
三角2つの場合、ユーザが高速モードを指定していて、等速モードで実行中です。
キー入力中(後述)または VM がアイドル状態(m68k の STOP 命令)などで起きます。
高速モード中はパーセントではなく何倍速で動作しているかを表します。
| 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 (see below) or when the VM is idle (STOP instruction on m68k).
| …
|
三角3つの場合、ユーザが高速モードを指定していて、高速モードで実行中です。
| When an icon (three triangles) is displayed, the user has specified full speed mode and the VM is running in full speed mode. |
Key input
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 that don't implement it, and key repeat occurs on NetBSD/luna68k kernel that implements it. Since the timing of key repeat is measured by the guest software, if the VM is running faster than the real, the key repeat will occur faster, too. The host application doesn't have the way to avoid it. Therefore, nono will temporarily suppress the full speed mode 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.
Try it
Try NetBSD/luna68k
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/).
Download imagefile from the following link, extract it and place it in the VM directory, ~/nono/luna/.
http://teokurebsd.org/netbsd/liveimage/20210614-luna68k/
Create a configuration file nono.cfg in the VM directory, ~/nono/luna/, 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-20210614.img hostnet-driver = none
Run as nono -c ~/nono/luna. (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 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 が起動します。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.
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.
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.
Example of network setup
Add the following line to configuration file, nono.cfg. (Although you don't need to write it since these are default behavior on NetBSD)
hostnet-driver = tap hostnet-tap-devpath = auto
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.
常用するなら /etc の設定ファイルに書いておきましょう。# ifconfig bridge0 create # brconfig bridge0 add wm0
If you use it regularly, you can put configuration file into /etc.
/etc/ifconfig.bridge0create up !/sbin/brconfig $int add wm0# /etc/rc.d/network restart
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#!/bin/sh sudo /sbin/ifconfig $1 up sudo /sbin/brconfig bridge0 add $1
nono-ifdown#!/bin/sh sudo /sbin/brconfig bridge0 delete $1 sudo /sbin/ifconfig $1 down
% chmod +x nono-ifup nono-ifdown
Run nono, and open "Monitor > Host > Host Network" window from menu. It's OK if you can see "HostNet Driver: tap".
Changes
License
Contact us
If you find any problems, please let me know. You may write in English.
About contributes
If you provide a patch to nono, you must agree to the following conditions:
All your work are operated or distributed under the nono license.
The license may be changed in the future.
Do not exercise your author's rights.
nono uses source code with the following advertising clause.
This product includes software developed by Gordon Ross
This product includes software developed by the University of California, Lawrence Berkeley Laboratory.