nono is OMRON LUNA-I emulator runs on NetBSD and so on.+nono は NetBSD とかで動作する OMRON LUNA-I/LUNA-88K のエミュレータです。 +何故か SHARP X68030 と virt-m68k も動いたりするかも知れません。 +
nono is OMRON LUNA-I/LUNA-88K emulator runs on NetBSD and etc. +It can also emulate SHARP X68030 and virt-m68k.
How to build
How to build
How to execute
Configuration
About VM
Try it
Example of host network setup
Known Issues
How to migrate from old versions
Changes
Contact, License, etc
+
Green Background is new or updated paragraph.+
The followings are required for build.+
+NetBSD(pkgsrc) なら必要なパッケージは
+x11/wxGTK32 と net/libslirp です。
+wxGTK32 の代わりに wxGTK30 でも動くはずです。
+If you use NetBSD(pkgsrc),
+x11/wxGTK32 and net/libslirp are needed.
+wxGTK30 would also work.
+
+
+(NetBSD 以外でのビルドはサポートしていませんが)
+Ubuntu 24.04 ではたぶん以下のパッケージが必要です。
+You may need the following packages on Ubuntu 24.04
+(though we won't support non-NetBSD platform).
+
+nono のソースアーカイブを展開したら以下のようにビルドします。
+Extract the nono's source archive and build as following.
+
-まだ make install はないです。 -wx/nono が GUI 版実行ファイル、 -cli/nono-cli がコマンドライン版です。 +-% ./configure -% make depend -% make +% ./configure [<options>] +% make -DRELEASE depend +% make -DRELEASE +% su +# make install
+configure には環境変数 CC、CXX でコンパイラを指定することが出来ます。
+wx-config が標準的な名前で提供されていないために見付けられない場合には
+環境変数 WX_CONFIG にパスを指定することが出来ます。
+また configure のオプションとして以下が指定できます。
+You can specify C/C++ compiler using environment variable CC and CXX
+if configure cannot find standard name suitable compiler.
+You can specify wx-config path using environment variable WX_CONFIG
+if configure cannot find wx-config.
+Also, you can specify the following option for configure.
+
+
+
Disable AVX2 support on amd64(x86_64). +By the default, it will generate AVX2 supported binary +only if configure detects that compiler supports AVX2.+
Disable NEON support on aarch64. +By the default, it will generate NEON supported binary +only if configure detects that compiler supports NEON.+
+make install により2つの実行ファイルがインストールされます。
+nono が GUI 版実行ファイル、
+nono-cli がコマンドライン版です。
+make install will install two executables.
+nono is the GUI executable and nono-cli is
+the command line executable.
+
Command Line Option
nono supports multiple architectures so that +it needs configuration. +See the following Configuration section for +details.+
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._EOM_ ); -option_item("-c vmdir", <<<_EOM_ -VM ディレクトリを指定します。省略するとカレントディレクトリとします。 +option_item("--create-sram", <<<_EOM_ +(X68030 Only) +VM ディレクトリに X68030 用の SRAM.DAT がなければ初期状態で作成して終了します。 +
+nono will create the initial SRAM.DAT for X68030 and exit, +if there is no SRAM.DAT in the VM directory._EOM_ ); option_item("-f", <<<_EOM_ 高速モードで起動します。 GUI なら起動後にもメニューから変更できますが、その初期値を変えるだけです。 +設定の fast-mode=1 と等価です。 +
Boot as the fast mode. +You can change this mode on GUI menu after boot, +and the option only changes its initial state. +This option is equivalent to fast-mode=1 in configuration.+_EOM_ +); + +option_item("--fd0 file
Specifies the floppy image. +If file is relative path, +it is path from the current directory. +This option is equivalent to fd0-image, fd1-image +in configuration except for base directory of the relative path.+ _EOM_ ); option_item("--fontsize height", <<<_EOM_ GUI 版のみ。 全サブウインドウの起動時のフォントサイズを指定します。 -height には 12, 16, 24 -のいずれかを指定します。デフォルトは 12 です。 +起動後にメニューから変更できます。 +設定の monitor-fontsize と等価です。 +
GUI Only. +Specifies the initial fontsize of all sub windows. +You can change this value on GUI menu after boot. +This option is equivalent to monitor-fontsize in configuration._EOM_ ); -option_item(array("-s scale", - "--scale scale"), <<<_EOM_ +option_item("--initrd file", <<<_EOM_ +(virt-m68k Only) +カーネルに渡す初期 RAM ディスクのパスを指定します。 +file が相対パスの場合カレントディレクトリからのパスになります。 +設定の exec-initrd とは相対パスの起点の違いを除いて同一です。 +
Specifies the initial ramdisk image passed to the kernel. +If file is relative path, +it is path from the current directory. +This option is equivalent to exec-initrd in configuration +except for base directory of the relative path.+_EOM_ +); + +option_item("-s scale", <<<_EOM_ GUI 版のみ。 メインウィンドウの起動時のスケールを実数で指定します。 -起動後にもメニューからプリセットされた倍率には変更可能ですが、 -任意倍率は起動時のみ指定可能です -(そのうちなんとかしたい)。 -デフォルトは 1.0 です。 +設定の mainview-scale と等価です。 +起動後はメニューからプリセットされた倍率と +mainview-scale で指定された倍率には変更可能です。 +
GUI Only. +Specifies the initial main window scale in real number. +This is equivalent to mainview-scale in configuration. +You can change this scale on GUI menu after boot._EOM_ ); option_item("--show-config", <<<_EOM_ 設定ファイルと -V オプションを読み込んだ結果を表示します。 +
Shows the result of reading configuration file and +parsing -V options._EOM_ ); option_item("-v", <<<_EOM_ バージョンを表示します。 +
Shows the version._EOM_ ); option_item("-V name=value", <<<_EOM_ -設定ファイルの内容を個別に上書きします。 +設定ファイルで指定した name=configvalue の代わりに +このオプションの name=value を適用します。 +name が正しくない場合はエラー終了します。 +
Use this name=value +instead of name=configvalue specified in configuration file. +If name is not correct, it will exit on error.+_EOM_ +); + +option_item("-X file", <<<_EOM_ +ホストの file をロードして実行します。 +file が相対パスの場合カレントディレクトリからのパスになります。 +設定の exec-file とは相対パスの起点の違いを除いて同一です。 +ファイルが gzip 圧縮されていれば自動的に展開します。 +(展開後の) ファイル形式は以下の通りですが、 +実際にはブートローダとカーネル程度しか想定していません。 +また、いずれも起動元デバイスが取得できないなどの問題はあるかも知れません。 +
Loads and executes host's file. +If file is relative path, +it is path from the current directory. +This option is equivalent to exec-file in configuration +except for base directory of the relative path. +If the file is gzip'd, it is automatically extracted. +The supported file format (after extracting) is the following. +Actually, it only assumes bootloaders or kernels. +And note that it may not obtain some information that where did I boot from, +for example.+
a.out (OMAGIC) executable (It probably supports bootloaders only)+
ELF executable +(It probably supports the kernel only. +If the file is assumed to be NetBSD executable, +it will also load symbol tables as the bootloader does to the kernel.)+
On LUNA, +regardless of prom-image configuration (see below), +it boots the internal emulated PROM. +If luna-dipsw1 configuration meets dipsw-autoboot=yes, +it will immediately load and execute the host file. +Otherwise, it will wait in prompt. +Even in this case, "g" command (in LUNA-I) or "b" command (in LUNA-88K) +will load the host file that is specified by this option. +On X68030, +nono hacks the boot device after normal boot from IPLROM, +and loads and executes the host file. +On virt-m68k (and NEWS), this is the only way to boot._EOM_ ); ?>
For developers:
Configuration
nono's configurations are always applied in the following order.+
Default value+
Contents of ~/.nono.cfg if exists+
Contents of nono.cfg in the VM directory (or the file specified by -c option) if exists+
Command line option+
+The syntax of both files is key = value format, one per line. +White spaces before and after key and value are ignored. +Blank lines, lines beginning with "#" are also ignored. +The lines with unrecognized key are ignored with a warning. + +If the same key appears more than once, +the latter overwrites the former in the above order. +If the same key appears in a file, +the latter overwrites the former in the same manner. +Then, command line option -V etc. overwrites them. +If the same key appears more than once in the command line option, +do in the same manner.+
+vmtype を除くすべての設定項目はそれぞれデフォルト値を持っています。
+つまり少なくとも vmtype だけは設定ファイルかコマンドラインオプションで指定する必要があります。
+All configuration items except vmtype have default value.
+It means, you need to specify at least only vmtype
+by configuration file or commandline option.
設定項目は次の通りです。
+The configuration items are:
Specifies the VM type from the following. +This field is mandatory.+
| luna | … LUNA-I + | |
| luna88k | … LUNA-88K + | |
| x68030 | … X68030 + | |
| news | … NWS-1750 (Just a joke) + | |
| virt-m68k (or virt68k) | … virt-m68k + |
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("ethernet-hostdriver = string", <<<_EOM_ -イーサネットデバイスのホスト側ドライバを指定します。 -none、tap、bpf が指定できます。 +config_item("clock-sync = value", <<<_EOM_ +仮想マシン内の時刻の同期方法を指定します。 +real なら実時間に同期、virtual なら仮想時間に同期します。 +
Specifies how to synchronize the time in the virtual machine. +If real, synchronize with the real time; +if virtual, synchronize with the virtual time.+
On LUNA-I, 60Hz system clock interrupt and RTC(MK48T02) are the target. +The default is real.+
On LUNA-88K, 100Hz system clock interrupt and RTC(MK48T02) are the target. +The default is real.+
On NWS-1750, system clock interrupt and RTC(MK48T02) are the target. +The default is real.+
On virt-m68k, Goldfish Timer interrupt and Goldfish RTC are the target. +The default is real.+
On X68030, MFP timer interrupts and RTC(RP5C15) are the target. +The default is virtual. +Note that reading from MFP TxDR register only works as virtual, +regardless of this setting. +See also Time Synchronization on NetBSD/x68k.+ +
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("ethernet-macaddr = string", <<<_EOM_ -イーサネットデバイスの仮想マシン側の MAC アドレスを指定します。 +config_item("debugger-tcp-port = integer", +<<<_EOM_ +デバッガのコンソールドライバが tcp の時の TCP 待ち受けポート番号を指定します。 +
Specifies the TCP port number that debugger console driver listens.+_EOM_ +); + +?>yesno", <<<_EOM_ +(LUNA and NEWS Only) +機種に依存せず DIPSW を自動起動に設定するかどうか指定します。 +"yes" なら自動起動するように、 +"no" なら自動起動しないように DIPSW 設定を上書きします。 +"" (空) なら何もしません。デフォルトは "" です。 +このオプションは luna-dipsw1 や news-dipsw +の状態が設定ファイルやコマンドラインオプションによって確定した後に +該当のスイッチだけを変更します。 +
Specifies whether to configure DIPSW to boot automatically, +regardless of the models. +"yes" overwrites DIPSW, to boot automatically. +"no" overwrites DIPSW, not to boot automatically. +"" (Empty) does nothing. +The default value is "". +This option only changes the appropriate switch(es) +after the luna-dipsw1 or news-dipsw configuration +is determined by the configuration file or command line options.+_EOM_ +); + +config_item("dipsw-serial = yesno", <<<_EOM_ +(LUNA and NEWS Only) +機種に依存せず DIPSW をシリアルコンソールを使うかどうか指定します。 +"yes" ならシリアルコンソールを使うように、 +"no" ならシリアルコンソールを使わないように DIPSW 設定を上書きします。 +"" (空) なら何もしません。デフォルトは "" です。 +luna-dipsw1 もしくは news-dipsw (機種による) +の状態が設定ファイルやコマンドラインオプションによって確定した後に +このオプションによって該当のスイッチだけを変更します。 +NEWS でシリアルコンソールを使わないを選択した場合、 +SW1,2,3 は OFF, OFF, ON にセットされ、 +NWB-512 モノクロコンソール(未実装) が選択されます。 +
Specifies whether to configure DIPSW to use serial console, +regardless of the models. +"yes" overwrites DIPSW, to use serial console. +"no" overwrites DIPSW, not to use serial console. +"" (Empty) does nothing. +The default value is "". +This option only changes the appropriate switch(es) +after the luna-dipsw1 or news-dipsw configuration +is determined by the configuration file or command line options. +If you choose not to use serial console on NEWS, +SW1,2,3 will be set OFF, OFF, ON respectively, +and NWB-512 monochrome console (not implemented) will be chosen.+_EOM_ +); + +config_item( + "ethernet-macaddr = string
Specifiies the host file that will be loaded at startup. +This is mostly the same as -X option. +The only one difference is that relative path originates the VM directory.+_EOM_ +); + +config_item("exec-bootparam = string", <<<_EOM_ +(virt-m68k Only) +カーネルに渡すブートパラメータを指定します。 +内容はたぶん OS ごとに異なりますが、 +NetBSD/virt68k では "root=ld0" (クォートを除く) +のようにしてカーネルにルートデバイスを指示します。 +
Specifies the boot parameter that is passed to the kernel. +The syntax may differ depending on the OS, but in NetBSD/virt68k, +you can specify the root device to the kernel, like as +"root=ld0" (excluding quotes).+_EOM_ +); + +config_item("exec-initrd = path", <<<_EOM_ +(virt-m68k Only) +カーネルに渡す初期 RAM ディスクイメージのパスを指定します。 +--initrd オプションとほぼ同等ですが、相対パスは VM ディレクトリを起点にします。 +
Specifies the initial ramdisk image passed to the kernel. +This is mostly the same as --initrd option. +The only one difference is that relative path originates the VM directory.+_EOM_ +); + +config_item("extram-size = integer", <<<_EOM_ +(X68030 Only) +拡張メモリのサイズを MB 単位で指定します。 +今の所以下だけが指定できます。 +
Specifies the extended RAM size in MB. +For now, only the following can be specified.+
No extended memory. It's default.+
TS-6BE16 compatible mode. +Its address is from $0100'0000 and the size is 16MB.+
060turbo compatible mode. Its address is from $1000'0000.+
Specifies the number of floppy drives from 0 to 4. +The default is 2.+_EOM_ +); + +config_item("fdN-image = path", <<<_EOM_ +(X68030 Only) +フロッピードライブ N に起動時に挿入するディスクイメージを指定します。 +イメージパスが相対パスなら VM ディレクトリからの相対パスになります。 +起動後はメニューから操作できます。 +デフォルトは空です。 +
Specifies 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 and virt-m68k Only) +68030 に FPU コプロセッサを装着するかどうか指定しています。 +この設定は mpu-type が 68030 の時のみ有効です。 +none なら FPU コプロセッサを装着しません。 +68881 なら FPU コプロセッサとして 68881 を装着します。 +現状 68882 はサポートしていません。 +また none の代わりに 0、 +68881 の代わりに 1 と書くこともできます。 +デフォルトは 68881 です。 +LUNA-I はたぶん 68881 搭載モデルのみのため変更できません。 +
Specifies whether to install FPU co-processor or not. +This item is meaningful only if mpu-type is 68030. +If none, FPU co-processor is not installed. +If 68881, 68881 FPU co-processor 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("host-avx2 = string", <<<_EOM_ +ホストが amd64(x86_64) の場合にレンダリングに AVX2 +アクセラレーションを使うかどうかを指定します。 +auto なら起動時にホスト CPU が AVX2 をサポートしているか確認し、 +サポートしていれば使用します。 +no なら AVX2 コードを実行しません。 +デフォルトは auto です。 +amd64(x86_64) 以外のホストではこの設定は無視されます。 +
Specifies whether to use AVX2 acceleration for rendering +on amd64(x86_64) host. +If auto, nono checks whether the host CPU supports AVX2 +on startup and use it if it does. +If no, nono will not execute AVX2 instructions. +The default is auto. +Note that this item is ignored if the host is not amd64(x86_64).+_EOM_ +); + +config_item("host-neon = string", <<<_EOM_ +ホストが aarch64 の場合にレンダリングに NEON +アクセラレーションを使うかどうかを指定します。 +auto なら使用し、 +no なら使用しません。 +デフォルトは auto です。 +aarch64 以外のホストではこの設定は無視されます。 +
Specifies whether to use NEON acceleration for rendering +on aarch64 host. +If auto, nono uses NEON code. +If no, nono don't use NEON code. +The default is auto. +Note that this item is ignored if the host is not aarch64.+_EOM_ +); + +config_item("hostcom-driver = string", <<<_EOM_ +シリアルポートのホスト側ドライバを指定します。 +stdio なら標準入出力を使用します。 +tcp なら TCP ポートで TELNET プロトコルで待ち受けます。 +cons ならメイン画面で端末エミュレーションを行います。 +none ならホスト側とは一切通信を行いません。 +ゲスト機種によって対応しているホスト側ドライバの種類とデフォルト値が変わります。 +LUNA-I、LUNA-88K、X68030 では stdio、tcp、none +が選択可能でデフォルトは none です。 +virt-m68k、NEWS では stdio、tcp、cons、none +すべてが選択可能でデフォルトは cons です。 +
Specifies the host driver of serial port. +stdio uses the standard input/output. +tcp listens on TCP port using TELNET protocol. +cons does a terminal emulation in main panel. +none doesn't make any communication with the host. +The choices and default value vary depending on the guest type. +On LUNA-I, LUNA-88K and X68030, you can choose stdio, tcp +or none, and the default is none. +On virt-m68k and NEWS, you can choose all of stdio, tcp, +cons or none, and the default is cons.+_EOM_ +); + +config_item("hostcom-tcp-port = integer", <<<_EOM_ +ホストドライバが tcp の時の TCP 待ち受けポート番号を指定します。 +
Specifies the TCP port number that host driver listens.+_EOM_ +); + +config_item("hostcom-fallback = integer", <<<_EOM_ +hostcom-driver で指定したドライバが使用可能でなかった時、 +0 ならプロセスを終了します。1 なら none を選択して実行を継続します。 +デフォルトは 0 です。 +
Specifies 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_ +(LUNA and X68030 Only) +ホストキーボードの入力モードを指定します。 +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
Specifies the host driver of N-th +ethernet device. +afpacket, bpf, tap and usermode can be specified +only if the configure detects them. +auto and none can always be specified.+
afpacket uses Linux's AF_PACKET socket. +It cannot communicate with the host itself.+
bpf uses bpf(4) device. +It cannot communicate with the host itself.+
tap uses tap(4) device.+
usermode is an usermode network using libslirp. +nono also acts as NAT router, DHCP server and DNS server.+
none doesn't make any communication with the host.+
auto is a synonym for usermode, but +when libslirp is disabled on configure, it is a synonym for none. +The default of hostnet0-driver is auto, +the default of hostnet1-driver is none.+_EOM_ +); + +config_item("hostnetN-afpacket-ifname = ifname", <<<_EOM_ +ホストドライバが afpacket の時にバインドするインタフェースを1つ指定します。 +ifname が auto +なら使用可能なインタフェースを1つ自動的に選択します。 +デフォルトは auto です。 +なお、このホストドライバではローカルホストとの通信は出来ません。 +
Specifies 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.+_EOM_ +); + +config_item("hostnetN-bpf-ifname = ifname", <<<_EOM_ +ホストドライバが bpf の時にバインドするインタフェースを1つ指定します。 +ifname が auto +なら使用可能なインタフェースを1つ自動的に選択します。 +デフォルトは auto です。 +なお、このホストドライバではローカルホストとの通信は出来ません。 +
Specifies 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.+_EOM_ +); + +config_item("hostnetN-tap-devpath = path", <<<_EOM_ +ホストドライバが tap の時に使用するデバイスを1つフルパスで指定します。 +デフォルトは auto で、この場合は自動的にデバイスを選択します。 +この時の探し方はホスト OS によって異なります。 +Linux なら /dev/net/tun を指定したのと同じです。 +OpenBSD なら /dev/tap0 から /dev/tap9 まで +順番にオープンできるまで試します。 +NetBSD (と FreeBSD) ならまず /dev/tap でクローニングを試み、 +それが失敗すれば /dev/tap0 から /dev/tap9 までを +順番にオープンできるまで試します。 +いずれの場合も VM ディレクトリかその親ディレクトリに +nono-ifup, nono-ifdown という名前のシェルスクリプトが必要です。 +何もすることがない場合でも正常終了する空のシェルスクリプトを用意してください。 +
+Specifies 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.+_EOM_ +); + +config_item("hostnetN-usermode-net = network/netmask", <<<_EOM_ +ホストドライバが usermode の時の、内部 IPv4 ネットワークのアドレスを指定します。 +ネットワークアドレスは +192.0.2.0/255.255.255.0 のようにネットマスクで指定するか +192.0.2.0/24 のようにネットマスク長で指定することも出来ます。 +デフォルトは 10.8.0.0/24 です。 +_EOM_ +); + +config_item("hostnetN-usermode-net6 = network/prefixlen", <<<_EOM_ +ホストドライバが usermode の時の、内部 IPv6 ネットワークのアドレスを指定します。 +ネットワークアドレスは 2001:db8::/64 +のようにアドレスとプレフィックス長で指定します。 +デフォルトは fd08::/64 です。 +_EOM_ +); + +config_item("hostnetN-usermode-hostfwd = entry[;entry[;…]]", <<<_EOM_ +ホストドライバが usermode の時の、外部から内部へのポートフォワーディングの設定を行います。 +1つの entry は +
+IPv6 には対応していません。
+_EOM_
+);
+
+config_item("hostnetN-fallback = integer", <<<_EOM_
+hostnetN-driver で指定したドライバが使用可能でなかった時、
+0 ならプロセスを終了します。
+1 なら none を選択して実行を継続します。
+デフォルトは 0 です。
+Specifies the behavior when the driver which is selected by
+hostnetN-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("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_
+(LUNA and X68030 Only)
+起動時にキーボードを本体に接続するかどうかを指定します。
+1 なら接続し、0 なら接続しません。デフォルトは 1 です。
+起動後はメニューから変更可能です。
+Specifies 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 なら補正をしません(実機と同じ動作)、
+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 などはこの
+RTC の年の値を 1970年からの経過年として使用しています。
+例えば1970年はうるう年ではないため 2月28日の翌日は 3月1日ですが、
+MK48T02 的には 00年であるためうるう年と認識し 2月28日の翌日が2月29日になります。
+このように、これらの OS を使っている場合実機の
+RTC は4年のうち約2年間、1日ずれた日付を指しているようです。
+しかしながら、RTC の時刻は OS 起動時に一度読んだ後は基本的に参照しない上、
+今時必要なら NTP で時間を合わせるため、
+実機でも問題が顕在化することはまずないと思います。
+nono の場合は実機と異なり、アプリケーション実行中しか RTC が進まないため、
+補正がない場合の動作が問題になるのは
+nono を起動したまま偶数年の2月末日から日付をまたいで、
+かつ nono を起動したまま OS を再起動して NTP などで時刻修正を行わなかった時
+だけだと思います。
+このオプションはほぼ開発者向けの動作確認用です。
_EOM_
);
config_item("luna-dipsw1 = string", <<<_EOM_
+(LUNA Only)
本体前面 DIPSW#1-1..#1-8 の内容を指定します。
"0" を DOWN、"1" を UP として、
これを8つ並べた形式で、前から順に #1..#8 に対応します。
-デフォルトは 11110111 です。
+Specifies status of the front panel DIPSW#1-1..#1-8 using 8 digits.
+"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
-各スイッチの内容はここ
-(NetBSD/luna68k: Information) を参照してください。
+LUNA-88K でのデフォルトは 11111111 です。
+各スイッチの内容は以下のリンクを参照してください。
+On LUNA-88K, the default value is 11111111.
+See the following link about DIPSW.
+→ OpenBSD manual pages: boot_luna88k(8)
+
+自動起動するかどうかとシリアルコンソールを使うかどうかを指定したい場合は
+こちらではなく
+dipsw-autoboot、dipsw-serial
+設定を使うほうが便利です。
+If you only want to specify whether to autoboot and/or
+to use serial console,
+dipsw-autoboot, dipsw-serial
+configurations are useful.
_EOM_
);
config_item("luna-dipsw2 = string", <<<_EOM_
+(LUNA Only)
本体前面 DIPSW#2-1..#2-8 の内容を指定します。
書式は luna-dipsw1 と同じです。
デフォルトは 11111111 です。
-
-すべて "1"(UP) なら
-NetBSD/luna68k のブートローダは自動的にカーネルをロードして実行し、
-どれかでも "0"(DOWN) にするとプロンプトで停止するようです。
+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)
+
+_EOM_
+);
+
+config_item("luna-video-plane = integer", <<<_EOM_
+(LUNA Only)
+LUNA のビデオボードのプレーン数を 1、4、8 から指定します。
+1 ならモノクロビデオボード、
+4 なら16色 (4bpp) ビデオボード、
+8 なら 256色 (8bpp) ビデオボードです。
+デフォルトは 4 です。
+Specifies number of planes on LUNA video board.
+The valid values are 1, 4 or 8.
+1 means a monochrome video board,
+4 means 16-color (4bpp) video board,
+8 means 256-color (8bpp) video board.
+The default value is 4.
+_EOM_
+);
+
+config_item(
+ "m88100-version = integer
" .
+ "m88200-version = integer", <<<_EOM_
+(LUNA-88K Only)
+MPU と CMMU のマスクバージョンを設定します。
+今の所これによるエミュレータの動作の違いはありません。
+どちらかというとこれを参照しているゲスト OS の動作確認用です。
+デフォルトは m88100-version が 11、m88200-version が 9 です。
+Specifies MPU and CMMU mask version.
+This item doesn't affect any MPU/CMMU emulations for now.
+But it may be useful for verifying the guest OS behaviors.
+The default value is 11 for m88100-version,
+9 for m88200-version.
+_EOM_
+);
+
+config_item("mainview-scale = double", <<<_EOM_
+メインウィンドウの起動時のスケールを実数で指定します。
+コマンドラインオプション -s で上書き可能です。
+起動後はメニューから、
+プリセットされた倍率とここで指定した倍率には変更可能です。
+デフォルトは 1.0 です。
+_EOM_
+);
+
+config_item("monitor-fontsize = integer",
+<<<_EOM_
+テキスト系モニタとステータスパネルのフォントサイズを
+12, 16, 24 から指定します。
+コマンドラインオプション --fontsize で上書き可能です。
+起動後はメニューから変更することができます。
+デフォルトは 12 です。
+_EOM_
+);
+
+config_item("monitor-rate = integer", <<<_EOM_
+テキスト系モニタウィンドウの更新頻度を Hz 単位で指定します。
+1 から 60 までの間で指定でき、デフォルトは 20Hz です。
+起動後にメニューから、
+プリセットされた頻度とここで指定した頻度には変更可能です。
+Specifies refresh rate of all text monitor windows in Hz.
+It ranges from 1 to 60. The default is 20Hz.
+You can choose this value on GUI menu after boot,
+from preset rate or rate specified here.
_EOM_
);
config_item("mpu-clock = value", <<<_EOM_
MPU のクロック数を MHz 単位で指定します。
-デフォルトは 20MHz です。
+デフォルトは LUNA-I なら 20MHz、LUNA-88K と X68030 なら 25MHz です。
+virt-m68k ではあまり意味はありませんが 25MHz です。
+Specifies the MPU clock in MHz.
+The default value is 20MHz on LUNA-I, or 25MHz on LUNA-88K and X68030.
+On virt-m68k, it's less meaningful but 25MHz.
+_EOM_
+);
+
+config_item("mpu-type = value", <<<_EOM_
+(X68030, virt-m68k Only)
+MPU 種別を 68030 か 68040 で指定します。
+デフォルトは 68030 です。
+Specifies the MPU type, 68030 or 68040.
+The default is 68030.
+_EOM_
+);
+
+config_item("mpu-pseudo-stop = integer", <<<_EOM_
+(LUNA-88K Only)
+m88100 にて疑似 STOP 状態を有効にするかどうかを指定します。
+0 なら無効(実機と同じ動作)、1 なら有効で、デフォルトは 1 です。
+m88100 には、m68k の STOP 命令 (割り込みが上がるまで何もせず待つ)
+に相当する命令がなく、
+大抵ビジーウェイトループで割り込みが上がるのを待つことになります。
+これは実機では (消費電力を減らす手段がないという些細な問題以外には)
+何のデメリットもないのですが、
+エミュレータで特に高速動作させている時には割り込みが上がるまで
+(例えば人間がキーを入力するまで) ホスト CPU パワーを使い潰してビジーウェイトループを実行し続けることになり、ホスト CPU があっつあつになります。
+それを防ぐための機能です。
+特徴的な命令列を検出して実現しているので、すべての状況で動作するわけではありません。
+_EOM_
+);
+
+config_item(
+ "nereid0-enable = integer
" .
+ "nereid1-enable = integer
", <<<_EOM_
+(X68030 Only)
+Nereid 拡張ボードを装着するかどうかを指定します。
+Nereid は同時に2枚まで使用することができます。
+値は 0 なら装着せず、1 なら装着します。
+デフォルトは 0 (装着しない) です。
+詳細は 4.6 Nereid の章を参照してください。
+Specifies whether install Nereid expansion board or not.
+Up to two board can be operated at the same time.
+If 0, the board is not installed.
+If 1, the board is installed.
+The default value is 0.
+See also Section 4.6 Nereid below for details.
+_EOM_
+);
+
+config_item(
+ "nereid0-net = integer
" .
+ "nereid1-net = integer
", <<<_EOM_
+(X68030 Only)
+Nereid ボードの NIC (RTL8019AS) のみを無効にすることが出来ます
+(実機では通常そのようなことは出来ません)。
+0 なら無効、1 なら有効です。デフォルトは 1 です。
+通常は 1 のまま使用してください。
+この設定は対応する nereidN-enable が 0
+(ボードを装着しない) の場合は意味を持ちません。
+This can disable only NIC (RTL8019AS) of Nereid expansion board
+(although it's not possible normally in the real world).
+It's disabled if 0, or enabled if 1.
+The default is 1. Normally, leave it 1.
+This item will be ignored if the corresponding nereidN-enable
+is 0.
+_EOM_
+);
+
+config_item(
+ "nereid0-ram-size = integer
" .
+ "nereid1-ram-size = integer
", <<<_EOM_
+(X68030 Only)
+Nereid ボードのバンクメモリのサイズを MB 単位で指定します。
+指定できるのは 0, 4, 16 です。
+0 を指定するとバンクメモリを無効にします。
+デフォルトは 16 です。
+この設定は対応する nereidN-enable が 0
+(ボードを装着しない) の場合は意味を持ちません。
+Specifies bank memory size in MB of Nereid expansion board.
+The valid values are 0, 4 or 16.
+If 0, disable the bank memory.
+The default is 16.
+This item will be ignored if the corresponding nereidN-enable
+is 0.
+
+また通常は必要ありませんが -4 または -16 を指定すると、
+バンクメモリは無効にした上で Nereid 制御ポートのビット6の読み出し値
+(バンクメモリの容量) を再現することが出来ます。
+-4 ならビット6は 0 (4MB)、0 か -16 なら 1(16MB) が読み出せます。
+_EOM_
+);
+
+config_item("news-dipsw = string", <<<_EOM_
+(NEWS Only)
+DIPSW の内容を指定します。
+"0" を OFF、"1" を ON として、
+これを8つ並べた形式で、前から順に SW1..SW8 に対応します。
+デフォルトは 00001000 です。
+Specifies status of the DIPSW using 8 digits.
+"0" means OFF and "1" is ON.
+The first character corresponds to SW1 and
+the eighth character corresponds to SW8.
+The default valus is 00001000.
+
+各スイッチの内容は以下のリンクを参照してください。
+See the following link about DIPSW.
+→ NetBSD/news68k Frequently Asked Questions
+
+自動起動するかどうかとシリアルコンソールを使うかどうかを指定したい場合は
+こちらではなく
+dipsw-autoboot、dipsw-serial
+設定を使うほうが便利です。
+If you only want to specify whether to autoboot and/or
+to use serial console,
+dipsw-autoboot, dipsw-serial
+configurations are useful.
_EOM_
);
-/* luna には不要
- config_item("mpu-has-fpu", ""); */
-
-config_item("prom-use-rom = integer", <<<_EOM_
-外部 ROM イメージファイルを使うかどうかを指定します。
-0 なら使わない、1 なら使うです。
-デフォルトは 0 です。
+config_item("prom-image = path", <<<_EOM_
+(LUNA Only)
+LUNA-I/LUNA-88K の外部 ROM イメージファイルのパスを指定します。
+path がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
+path が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
+空にすると内蔵 ROM を使用します。
+デフォルトは空です。
+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.
+If the path is empty, internal emulated ROM will be used.
+The default value is empty.
-実機を持っていない場合はこの値を 0 にしておくと、
+実機を持っていない場合はこの値を空に (= デフォルトのままに) しておくと、
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.
-実機を持っている場合は ROM ファイルを用意して
-この値を 1 にすると実機 ROM で起動できます。
-ROM ファイルは実機の 0x41000000-0x4101ffff (128KB) を PROM.DAT (大文字)
-という名前で保存したもので、VM ディレクトリに置きます。
+LUNA-88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。
+今のところ ROM は version 1.20 のみサポートしています。
+
+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 単位で指定します。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 512MB in 1MB unit. +However, if you have prom-image with the real image, +the maximum is limited to 255MB. +By the way, NetBSD/luna68k needs at least 8MB to boot.+
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 512MB in 1MB unit. +However, if you have prom-image with the real image, +the maximum is limited to 240MB.+
On X68030, the default is 12MB. +You can specify it in 1MB unit from 4MB to 12MB. +See extram-size for extended memory.+
On NWS-1750, This is 16MB fixed for now.+
On virt-m68k, the default is 128MB and +the range is 16MB to 4080MB. +If the specified size is not divisible by 16MB, +it will be rounded up to 16MB.+
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. +On NEWS, it is fixed at 1900._EOM_ ); -config_item("spc0-idN-image = devtype,path", <<<_EOM_ -SCSI デバイスを指定します。N には 0 から 7 が入ります。 -ID 7 は本体が使用しますので指定しないでください。 -値はデバイス種別 devtype とイメージパス path -を ","(カンマ) で区切って並べた形式で、 -今の所デバイス種別 devtype には "hd"(ハードディスク) のみ指定可能です。 -ディスクイメージパスが相対パスなら VM ディレクトリからの相対パスになります。 -
-例えば、nono.cfg と同じディレクトリに置いたディスクイメージ luna.img
-を使う場合、
-LUNA では通常 ID 6 をプライマリ HDD に割り当てるのでこんな感じになります。
+config_item("show-statuspanel = integer", <<<_EOM_
+ステータスパネルを表示するかどうかを指定します。
+0 なら非表示、1 なら表示です。
+デフォルトは 1(表示) です。
+起動後はメニューから変更可能です。
+Specifies whether to display the status panel or not.
+If 0, it is hidden; if 1, it is shown.
+The default is 1 (show).
+You can change it on GUI menu after boot.
+_EOM_
+);
+
+config_item("spc0-idN-image = devtype[,path]", <<<_EOM_
+(LUNA and X68030 Only)
+SCSI デバイスとイメージを指定します。キーの N には 0 から 7 が入ります。
+ただし ID 7 は本体が使用しますので指定しないでください。
+値はデバイス種別 devtype とディスクイメージパス path
+を ","(カンマ) で区切って並べた形式です。
+デバイス種別 devtype は以下のいずれかです。
+Specifies SCSI device and image. N in the key 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 disk image path path separated by ","(comma).
+devtype can be one of the following:
+
+devtype が hd なら path は省略できません。
+devtype が cd か mo なら path は省略可能です。
+イメージパスが相対パスなら VM ディレクトリからの相対パスになります。
+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.
+
+
+例えば、nono.cfg と同じディレクトリに置いた sd0.img を
+起動 HDD ディスクイメージとして使い
+(LUNA では通常 ID 6 をプライマリ HDD に割り当てます)、
+ID 5 に同じディレクトリの install.iso をセットした CD ドライブを、
+ID 4 に起動時メディアなしの MO ドライブを接続する場合は次のようになります。
+For example, if you use a harddisk image sd0.img placed in the same
+directory as nono.cfg
+(LUNA usually assigns ID 6 to the primary HDD),
+ID 5 for CD-ROM drive that loads install.iso in the same directory,
+and ID 4 for MO drive without media on boot,
+write as following:
_EOM_ ); -config_item("spc0-idN-writeprotect = integer", <<<_EOM_ -指定の SCSI デバイスへの書き込みを無視するかどうか指定します。 +config_item("spc0-idN-seektime = integer", <<<_EOM_ +(LUNA and X68030 Only) +指定の SCSI HDD の平均シークタイムを msec 単位で指定します。 +現在のデフォルトは 0 です (S・S・D!! S・S・D!!)。 +16 程度を指定すると幾分往時に思いを馳せることが出来るかもしれませんが、 +今の所あまり安定していません。 +-spc0-id6-image = hd,luna.img +spc0-id6-image = hd,sd0.img +spc0-id5-image = cd,install.iso +spc0-id4-image = mo
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.+_EOM_ +); + +config_item("spc0-idN-writeignore = integer", <<<_EOM_ +(LUNA and X68030 Only) +指定の SCSI HD デバイスへの書き込みをイメージに書き戻すかどうか指定します。 0 なら通常動作(書き込みを行う)です。 -1 なら書き込みコマンドは成功したように振る舞いますが実際には -ディスクイメージに一切書き戻しません。 +1 ならディスクイメージに一切書き戻しません。 +デバイスへ書き込んだはずのデータは Copy-On-Write の要領で、 +VM ディレクトリ内の一時ファイルに書き込みます。 +この一時ファイルはアプリケーション終了時に削除します。 fsck を気にせずカーネルのデバッグとかを行いたい場合にはどうぞ。 何が起きるか意味が分からない人は指定しないでください。 デフォルトは 0 です。 +
Specifies whether nono writes a writing to SCSI HD devices back +to the diskimage. +0 means normal operation (writes to the diskimage). +1 means that nono will not write to the diskimage back. +Data that the guest wrote to the device will be written to a temporary file +in the VM directory, +like Copy-On-Write. +The temporary file will be removed when the application exits. +This is useful for kernel debugging because it does not require fsck +after the kernel hangs or reboots. +Don't use this flag if you don't understand this paragraph. +The default value is 0.+
+ちなみに、メディアを書き込み禁止にしたい場合はこれではなく、
+イメージファイルの書き込み権を落としてください。
+By the way, if you want to make the media write-protected,
+clear the write permission from the image file
+(instead of this setting).
+_EOM_
+);
+
+config_item("sram-sync-ramsize = integer", <<<_EOM_
+(X68030 Only)
+SRAM の RAM 容量欄を実際の RAM サイズに合わせるかどうかを指定します。
+0 なら何もしません (実機と同じ)。
+1 なら、アプリケーション起動時に
+SRAM の \$ed0008.L (RAM 容量) を ram-size の設定値で更新します。
+この更新は、
+アプリケーション起動時に SRAM マジックが正しく書かれている場合のみ行われます。
+デフォルトは 1 です。
+Specifies 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_
+);
+
+config_item("virtio-blockN-image = path", <<<_EOM_
+(virt-m68k Only)
+VirtIO ブロックデバイスのイメージを指定します。
+キーの N は現状 0 から 7 が指定可能です。
+イメージパスが相対パスなら VM ディレクトリからの相対パスになります。
+Specifies VirtIO block device's image.
+N in the key is 0 through 7 for now.
+If the path is relative path, it is from the VM directory.
+_EOM_
+);
+
+config_item("virtio-blockN-writeignore = integer", <<<_EOM_
+(virt-m68k Only)
+指定の VirtIO ブロックデバイスへの書き込みをイメージに書き戻すかどうか指定します。
+詳細は spc0-idN-writeignore を参照してください。
+Specifies whether nono writes a writing to VirtIO block devices back
+to the diskimage.
+See spc0-idN-writeignore for details.
+_EOM_
+);
+
+config_item("virtio-scsi-idN-image = devtype[,path]", <<<_EOM_
+
+(virt-m68k Only)
+VirtIO SCSI デバイスとイメージを指定します。
+イニシエータ ID が不要なため、
+キーの N には 0 から 7 が指定できます。
+詳細は spc0-idN-image を参照してください。
+Specifies VirtIO SCSI device and image.
+You can specify all of 0 thorugh 7 for the key N,
+because there is no initiator.
+See spc0-idN-image for more details.
+
+_EOM_
+);
+
+config_item("virtio-scsi-idN-writeignore = integer", <<<_EOM_
+
+(virt-m68k Only)
+指定の VirtIO SCSI デバイスへの書き込みをイメージに書き戻すかどうか指定します。
+詳細は spc0-idN-writeignore を参照してください。
+Specifies whether nono writes a writing to VirtIO SCSI devices back
+to the diskimage.
+See spc0-idN-writeignore for details.
+
+_EOM_
+);
+
+config_item("windrv-path = path", <<<_EOM_
+(X68030 Only)
+Windrv でゲスト側に見せるホストディレクトリを指定します。
+今の所指定できるディレクトリは1つだけです。
+空なら Windrv デバイスが存在しないように振る舞います。
+デフォルトは空です。
+_EOM_
+);
+
+config_item("x68k-cut-fc2 = integer", <<<_EOM_
+(X68030 Only)
+MPU (68030) の FC2 ピンを切断するかどうかを指定します。
+0 なら切断しません (標準の状態)。
+1 なら切断します。
+デフォルトは 1 です。
+NetBSD/x68k で X サーバを起動する場合のみ 1 にする必要があります。
+Specifies whether to cut MPU(68030) FC2 pin.
+If 0, the FC2 pin is connected as usual.
+If 1, it is disconnected.
+The default is 1.
+Only if you run the X server on NetBSD/x68k, it needs to be 1.
+_EOM_
+);
+
+config_item("xp-clock = value", <<<_EOM_
+(LUNA Only)
+XP プロセッサのクロック数を MHz 単位で指定します。
+デフォルトは 6.144 [MHz] です。
_EOM_
);
@@ -361,76 +1643,1459 @@ _EOM_
?>
| ◎ | : ほぼ実装済み Mostly implemented+ |
| ○ | : 困らない程度には実装済み Works+ |
| △ | : とりあえず動いてる程度 Works somehow+ |
| × | : 未実装 Not implemented+ |
| — | : 実装予定なし Not planned+ |
| {$line}\n"; + } else { + $t = preg_split("/\t+/", $line, 3); + $h = isset($t[0]) ? $t[0] : ""; + $m = isset($t[1]) ? $t[1] : ""; + $d = isset($t[2]) ? $t[2] : ""; + print " | ||
| {$h}\n"; + print " | {$m}\n"; + print " | {$d}\n"; + } + } +?> + |
68030 ATC (Address Translation Cache) is differ from and faster than the real 68030.+
Supports QEMU "virt" virtual hardware's compatible machine and +it can run NetBSD/virt68k. +You need to specify the kernel by -X option +(or exec-file in configuration). +If you want to install, you also need to specify the ramdisk image by +--initrd option (or exec-initrd in configuration).+
Nereid in the real world is a combined Ethernet/memory/USB expansion board. +Of these, the memory can be used to expand main memory, +and areas not used for the main memory can be used as bank memory. +nono supports only ethernet (RTL8019AS) and bank memory among +the functions of the Nereid expansion board. +Main memory expansion is not supported because it's meaningless on emulators. +Also, USB (SL811HS/T) is not planned for implementation.+
Since Nereid can set to two different combinations of addresses and +interrupt vectors by DIPSW, +so up to two boards can be operated at the same time. +Originally, SW6 and SW7 can be arbitrarily combined +(as long as they don't collide), in nono however, for simpility, +SW6 and SW7 are fixed to be OFF on board #0, and +SW6 and SW7 are fixed to be ON on board #1.+
++バンクメモリは、メインメモリとして使わなかった領域を使用します。 +そのため実機でもバンクメモリの容量は DIPSW のメインメモリ割り当て設定 +(SW1-5) に依存します。 +nono に関係する結論だけでいうと、 +メインメモリへの割り当てを一切行わない場合はバンクメモリは 16MB 確保でき、 +メインメモリへの割り当てをいくらかでも行うとバンクメモリは 4MB となります。 +設定の nereidN-ram-size はこの部分を指定していることになります。 +またこの容量とは独立に SW8 でバンクメモリの有効・無効を指定できますので、 +nereidN-ram-size が 0 (以下) というのは SW8 +でバンクメモリを無効にしたことに相当します。 ++
+#0 (nereid0-*) #1 (nereid1-*) + ベースアドレス・割り込みベクタ Base address and interrupt vectors+$ece300,$f9,$fb
(SW7=OFF) +$eceb00,$f8,$fa
(SW7=ON) +バンクメモリウィンドウ Bank memory window+$ee0000
(SW6=OFF) +$ef0000
(SW6=ON) +
Bank memory uses memory areas not used as the main memory. +So the bank memory size depends on the main memory settings (SW1-5). +As a result, +only if you don't allocate any memories to main memory, +the bank memory can be allocated 16MB. +Otherwise, the bank memory will be allocated 4MB. +Thus, nereidN-ram-size specifies this value. +Also, SW8 specifies enable/disable of the bank memory regardless of the size, +nereidN-ram-size = 0 (or less) means disabling the bank memory.+
+ゲストの NetBSD/x68k を起動し、 +/etc/sysctl.conf に以下の1行を追加します。 ++clock-sync = real +
+さらに /etc/rc.conf に ++kern.timecounter.hardware=clockinterrupt +
+などと設定します (NTP サーバはお好みで)。 +sysctl の設定によって、ゲスト OS の時計は「この設定が有効になった時点から」 +実時間間隔を刻めますが、 +電源オンからここまでにずれた分が解決できるわけではありませんので、 +必然的に時計を合わせる必要もあるためです。 +これで再起動すると次回からはフルスピードでも実時間を刻めます。 +(再起動せずに有効にしたい場合はこの設定の後 root ユーザで ++ntpdate=YES +ntpdate_hosts=ntp.nict.jp +
+を実行してください) + ++/etc/rc.d/sysctl start +/etc/rc.d/ntpdate start +
+++DEVICE = \SYS\WINDRV.SYS ++
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.+
+ | …
+ |
+三角3つの場合、ユーザが高速モードを指定していて、高速モードで実行中です。
+高速モード中はパーセントではなく何倍速で動作しているかを表します。
+ | When an icon (three triangles) is displayed, +the user has specified full speed mode and +the VM is running in full speed mode. + |
Try it
On memory dump monitor, +you can choose the output format from byte, word and longword +(In m88k, it is represented as byte, halfword and word respectively). +Also you can choose 68030/88200 MMU descriptor format +(It displays regardless of whether this address is used as descriptor or not). +Disassemble is now merged from disassemble monitor. +On LUNA-I, you can choose m68k and HD64180 disassemble. +On LUNA-88K, you can choose m88k and HD64180 disassemble. +On X68030/virt-m68k/NEWS, +you can choose m68k disassemble.+
+表示されているダンプ値をダブルクリックすることでメモリの値を編集できます。
+編集できるのはメモリと以下の部分のみです。
+You can edit the memory value by double click.
+Only memory and the following areas are editable.
+
The backend file is also updated immediately when edited. +The only last 8 bytes are not editable since there are the clock registers.+
The common plane is not editable.+
The backend file is also updated immediately when edited.+
Text VRAM and text palette+
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.+
+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/X68030 のキーコードに解釈し直して 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/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
+[@]-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).
+
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 that not listed in this table 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 " |
The following table shows the correspondence between +the host key and the guest key. +The keys that not listed in this table can only be entered from +the software keyboard window.+
+
| HostKey"; + print " | GuestKey\n"; + for ($i = 0; $i < count($table[$j]); $i++) { + list ($h, $g) = $table[$j][$i]; + print " |
|---|---|
| {$h}"; + print " | ${g}\n"; + } + print " |
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.+
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/20210910-luna68k/ ++ +
Create a configuration file nono.cfg in the VM directory, ~/nono/luna/, +with following contents.+
+ ++vmtype = luna +spc0-id6-image = hd,liveimage-luna68k-with-packages-20210910.img +
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 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 will boot 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, at the first boot, you will feel it's too heavy for several hours. +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 newcomers.+ +
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.+
Aoyama-san has provided a liveimage of OpenBSD/luna88k 7.6.+ +ここではこれを起動してみます。
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-20241013.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.+
+ ++vmtype = luna88k +spc0-id6-image = hd,liveimage-luna88k-raw-20241013.img +
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 Emulated ROM Monitor for LUNA-88K + +** 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 will boot OpenBSD automatically.+ +
To quit, type “shutdown -p now” as the root user. +LUNA-88K can be powered off by software, +and nono will terminate when the VM is powered off.+
Tsutsui-san has provided a liveimage of NetBSD/x68k 10.1. +Let's try it.+
Create a directory somewhere for nono (for example ~/nono/), +and create subdirectories for individual VMs in it +(for example ~/nono/x68k/).+ +
Download your favorite one of with-packages or plain-install +from the following site. +Extract it and place it in the VM directory, ~/nono/x68k/.+
+http://www.ceres.dti.ne.jp/tsutsui/netbsd/liveimage/x68k.html ++ +
Create a configuration file nono.cfg in the VM directory, ~/nono/x68k/, +with following contents.+
+ ++vmtype = x68030 +spc0-id0-image = hd,liveimage-x68k-with-packages-20250106.hds +
Only the first time, run as nono -c ~/nono/x68k --create-sram. +This will create an initial SRAM.DAT in the VM directory.+ +
Again, run as nono -c ~/nono/x68k. +NetBSD/x68k will be booted from HDD. +Next time, it will boot NetBSD automatically.+ +
At the first boot, you will feel it's too heavy for several hours. +This is because the infamous makemandb(8) runs heavily in the background +for a looooong time. +It's very sad to me that the accident which is far from the ideal +is the first experiences of newcomers.+ +
After NetBSD boots up (more precisely, if powerd(8) is running), +you can shutdown and power off by +"Device > Operation > Push Power button" on menu, +and nono will terminate when the VM is powered off.+ +
Here I will introduce how to install NetBSD/virt68k cleanly.+
Create a directory somewhere for nono (for example ~/nono/), +and create subdirectories for individual VMs in it +(for example ~/nono/virt68k/).+ +
There doesn't seem to be the official NetBSD/virt68k set available yet. +You have to build it manually from the source code using build.sh. :(+ +
The kernel used for installation and the kernel used for operation +are the same. +So it would be good idea to bring it into the VM directory at this point.
+-% mkdir -p ~/nono/luna/ -% echo "vmtype=luna" > ~/nono/luna/nono.cfg -% path/to/nono -c ~/nono/luna +cp <path>/release/virt68k/binary/kernel/netbsd-GENERIC.gz ~/nono/virt68k/
Prepare an empty disk image file. +You can install it with 1GB at least, +but it would be safer if it was a little larger.+
+ ++dd if=/dev/zero of=virt68k.img bs=1m count=2048 +
Create a configuration file nono.cfg in the VM directory, ~/nono/virt68k/, +with following contents.+
+ ++vmtype = virt-m68k +exec-file = netbsd-GENERIC.gz +exec-bootparam = root=ld0 +virtio-block0-image = virt68k.img +fast-mode = 1 +
Run the installer by specifying installer RAM disk. +By the way, configuration file specifies root device as ld0, +but RAM disk specified by the command line will take precedence.+
+ ++nono -c ~/nono/virt68k \ + --initrd <path>/release/virt68k/installation/ramdisks/inst-ramdisk.fs +
After a while, the familiar installer will start. +Once the installation has finished, +choose e:Utility menu > g:Halt the system. +Then the guest will shut down, and nono also will terminate.+ +
To boot from the installed disk, +run without --initrd option. +It still uses the kernel on the host filesystem, +just like the installer does.+
++nono -c ~/nono/virt68k +
Setup network
Add the following line to configuration file, nono.cfg.
-を追加し、VM ディレクトリに nono-ifup、nono-ifdown -というスクリプトを用意してください。 -nono は tap(4) をオープンし、 -そのデバイス名を引数にこれらのスクリプトを呼びます。 --ethernet-hostdriver = tap +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 resets the permission to 600.+ +
Create a bridge(4) interface, and +add your physical interface to the bridge.
-のようにして用意しておいた bridge0 に対して、 -(sudo の設定は別途行ってから) -次のような nono-ifup、nono-ifdown を用意すれば -wm0 の物理セグメントとブリッジできると思います。 - +常用するなら /etc の設定ファイルに書いておきましょう。 +-# brconfig bridge0 create +# ifconfig bridge0 create # brconfig bridge0 add wm0
If you use it regularly, +you can put configuration file into /etc.+
+/etc/ifconfig.bridge0 ++ ++create +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 ifconfig $1 up -sudo brconfig bridge0 add $1 +sudo /sbin/ifconfig $1 up +sudo /sbin/brconfig bridge0 add $1
-nono-ifup +nono-ifdown+#!/bin/sh -sudo brconfig bridge0 delete $1 -sudo ifconfig $1 down +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".+ +
In debugger console, some special characters like cursor keys +aren't printed correctly.+(since ver 0.3.0) +
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) + +
On Wayland, window size may be incorrect. +This may be due to wxWidgets (3.0/3.2) bug.+(2021/12/30, Updated 2024/07/03) + +
On wxWidgets 3.2 (with GTK3), it seems that the inside of the window +is hardly drawn at NetBSD/sparc (and such minor architectures?). +wxWidgets 3.0 (with GTK2) can.+(2024/07/03) + +
Some versions may have incompatibilities in the configuration files, etc. +In such case, you may need to upgrade it by referring the following link.+
Note
This is alpha quality release. -All specifications on this page may be changed -without compatibility in the near future.+Included Software"); ?> +
See nono-license.txt about nono itself.+
nono uses X68030 IPLROM image distributed without charge. +You must read +the license agreement +(even though it's Japanese original text only).+
nono modifies and embeds the font distributed as SIL Open Font License version 1.1.+
If you find any problems, please let me know. +You may write in English.
If you provide a patch to nono, we assume that you agree the following +conditions:+
All your work will be 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.
+