--- nono/doc/index.html 2026/04/29 17:05:18 1.1.1.16
+++ nono/doc/index.html 2026/04/29 17:05:22 1.1.1.17
@@ -74,12 +74,13 @@ dt.dt-indent {
-gettext
wxWidgets は NetBSD(pkgsrc) なら
-pkgsrc/x11/wxGTK30 (OPTIONS:gtk3 で動作確認) です。
-2022Q3 の wxGTK32 ではビルドできないようです。
+pkgsrc/x11/wxGTK32 (OPTIONS:gtk3 で動作確認) です。
If you use NetBSD(pkgsrc),
-wxWidgets is pkgsrc/x11/wxGTK30 (OPTIONS:gtk3 is tested).
-wxGTK32 in 2022Q3 doesn't seem to build for now.
+wxWidgets is pkgsrc/x11/wxGTK32 (OPTIONS:gtk3 is tested).
(NetBSD 以外でのビルドはサポートしていませんが)
-Ubuntu 20.04 ではたぶん以下のパッケージが必要です。
-You may need the following packages on Ubuntu 20.04
+Ubuntu 22.04 ではたぶん以下のパッケージが必要です。
+You may need the following packages on Ubuntu 22.04
(though we won't support non-NetBSD platform).
@@ -142,41 +140,52 @@ build-essential
gettext
libbsd-dev
libkqueue-dev
-libwxgtk3.0-gtk-dev
+libwxgtk3.0-gtk3-dev
zlib1g-dev
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.
-
--DNOTEST は開発者用のテストツールをビルドしないためのものです。
-With -DNOTEST, the build excludes test tools which is needed
-for developers only.
+Extract the nono's source archive and build as following.
+
-% ./configure
-% make -DNOTEST depend
-% make -DNOTEST
+% ./configure [<options>]
+% make -DRELEASE depend
+% make -DRELEASE
% su
# make install
-2つの実行ファイルがインストールされます。
+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 …
+amd64(x86_64) で AVX2 対応コードを無効にします。
+デフォルトでは、コンパイラが AVX2 に対応していることを
+configure が検出できれば AVX2 対応コードを生成します。
+
Disable AVX2 support on amd64(x86_64).
+By the default, it will generate AVX2 supported binary
+only if configure detects that compiler supports AVX2.
+
+
+make install により2つの実行ファイルがインストールされます。
nono が GUI 版実行ファイル、
nono-cli がコマンドライン版です。
-Two executables will be installed.
+make install will install two executables.
nono is the GUI executable and nono-cli is
the command line executable.
-
+
@@ -186,18 +195,9 @@ the command line executable.
2. 実行方法 How to execute
nono は複数機種に対応しているため設定なしでは起動できません。
設定は設定ファイルかコマンドラインオプションで指定します。
-nono はまず設定ファイル ~/.nono.cfg
-があれば読み込み、続いてカレントディレクトリの設定ファイル nono.cfg
-があれば読みます
-(
-c オプションで設定ファイル (VM ディレクトリ) の位置を指定することも出来ます)。
詳細は以下の
設定の章を参照してください。
nono supports multiple architectures so that
it needs configuration.
-First, nono reads a configuration file
-names ~/.nono.cfg if exists, then
-reads a configuration file names nono.cfg in the current directory if exists
-(You can specify the configuration file path (or VM directory) using
--c option).
See the following Configuration section for
details.
@@ -246,6 +246,19 @@ This option is equivalent to fast-mo
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.
+--initrd file
+
+(virt68k 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.
+
-s scale
GUI 版のみ。
メインウィンドウの起動時のスケールを実数で指定します。
@@ -273,6 +286,7 @@ If name is not correct,
-X file
ホストの file をロードして実行します。
file が相対パスの場合カレントディレクトリからのパスになります。
+設定の exec-file とは相対パスの起点の違いを除いて同一です。
ファイルが gzip 圧縮されていれば自動的に展開します。
(展開後の) ファイル形式は以下の通りですが、
実際にはブートローダとカーネル程度しか想定していません。
@@ -280,6 +294,8 @@ If name is not correct,
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.
@@ -299,18 +315,29 @@ it will also load symbol tables as the b
ELF object (Experimental)
Human68k .x executable (Experimental)
-LUNA では、設定の prom-image、luna-dipsw1 の内容(後述)によらず
-内蔵の互換 PROM で起動し、直ちにホストファイルを実行します。
+LUNA では設定の prom-image (後述) によらず内蔵の互換 ROM で起動します。
+luna-dipsw1 の DIPSW 設定が
+dipsw-autoboot=yes 相当の状態ならそのまま直ちにホストファイルを実行し、
+そうでなければ互換 ROM のプロンプトで停止します。
+後者の場合でも LUNA-I なら "g" コマンド、LUNA-88K なら "b" コマンドによる
+ロードはここで指定したホストファイルをロードします。
X68030 では、IPLROM 起動の後の起動デバイスに細工がしてあり、
そこからホストファイルを実行します。
+virt68k (と NEWS) はこの方法でしか起動できませんので、
+実行ファイルの指定は必須になります。
On LUNA,
-regardless of prom-image and luna-dipsw1 configuration
-(see below),
-the internal emulated PROM loads and executes the host file immediately.
+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.
+and loads and executes the host file.
+On virt68k (and NEWS), this is the only way to boot.
以下開発用。For developers:
@@ -330,8 +357,6 @@ and loads and executes the host file.ログレベルを指定します。
カンマで区切って複数指定することも出来ます。
-Lhelp で name の一覧を表示します。
---load-only file
--X オプションと同様ですが、PROM のプロンプトで停止します。
-M name[,name2,...]
起動時に表示するモニタウィンドウを指定します。
カンマで区切って複数指定することも出来ます。
@@ -375,7 +400,7 @@ 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 it.
+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.
@@ -396,8 +421,9 @@ This field is mandatory.
| | luna | … LUNA-I
|
| luna88k | … LUNA-88K
- |
| x68030 | … X68030 (Experimental)
+ |
| x68030 | … X68030
|
| news | … NWS-1750 (Just a joke)
+ |
| virt68k | … virt68k
|
cgrom-image = path
(X68030 Only)
@@ -484,14 +510,31 @@ is determined by the configuration file
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.
-ethernet-macaddr = string
ethernetN-macaddr = string
-N 番目の
-イーサネットデバイスの仮想マシン側の MAC アドレスを指定します。
+ethernet-macaddr = string
ethernetN-macaddr = string
+N
+番目のイーサネットデバイスの仮想マシン側の MAC アドレスを指定します。
XX:XX:XX:XX:XX:XX
形式で指定します。
auto なら自動的に決定します。
デフォルトは auto です。
-ethernet-macaddr は ethernet0-macaddr の別名です。
+ethernet-macaddr は ethernet0-macaddr の別名です。
+exec-file = path
+
+起動時にロードするホストの実行ファイルを指定します。
+-X オプションとほぼ同等ですが、相対パスは VM ディレクトリを起点にします。
+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.
+
+exec-initrd = path
+
+(virt68k 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.
+
extram-size = integer
(X68030 Only)
拡張メモリのサイズを MB 単位で指定します。
@@ -502,14 +545,12 @@ For now, only the following can be speci
0 … 拡張メモリを使用しません。デフォルトです。
No extended memory. It's default.
16 … TS-6BE16 互換モードで、
-アドレス $0100'0000〜$01ff'ffff の 16MB です。
+アドレス $0100'0000 からの 16MB です。
TS-6BE16 compatible mode.
-Its address is $0100'0000〜$01ff'ffff and the size is 16MB.
-128/256 … 060turbo 互換モードで、
-アドレス $1000'0000〜$17ff'ffff/$1fff'ffff の 128/256MB です。
-060turbo compatible mode.
-Its address is $1000'0000〜$17ff'ffff/$1fff'ffff and the size is
-128 or 256MB.
+Its address is from $0100'0000 and the size is 16MB.
+128/256/512 … 060turbo 互換モードで、
+アドレス $1000'0000 からです。
+060turbo compatible mode. Its address is from $1000'0000.
fast-mode = integer
起動時の動作モードを指定します。0 なら通常モード、1 なら高速モードです。
@@ -541,6 +582,7 @@ FPU を装着するかどうか指定し
68881 の代わりに 1 と書くこともできます。
デフォルトは 68881 です。
LUNA-I はたぶん 68881 搭載モデルのみのため設定できません。
+virt68k も現状 68881 固定としています。
Specifies whether to install FPU or not.
If none, FPU is not installed.
If 68881, 68881 FPU is installed.
@@ -549,7 +591,24 @@ And, none can also be written a
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.
+because (probably) all LUNA-I has 68881.
+This item also cannot be specified on virt68k for now.
+host-avx2 = string
+
+ホストが amd64(x86_64) の場合に AVX2 アクセラレーションを使うかどうかを
+指定します。
+auto なら起動時にホスト CPU が AVX2 をサポートしているか確認し、
+サポートしていれば使用します。
+no なら AVX2 コードを実行しません。
+デフォルトは auto です。
+amd64(x86_64) 以外のホストではこの設定は無視されます。
+Specifies whether to use AVX2 acceleration on amd64(x86_64) hosts.
+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).
+
hostcom-driver = string
シリアルポートのホスト側ドライバを指定します。
stdio、tcp、none が選択可能です。
@@ -587,9 +646,11 @@ The default is 0.
jp means the Japanese keyboard mode.
The defualt is char.
See About VM for details.
-hostnetN-driver = string
-N 番目の
-イーサネットデバイスのホスト側ドライバを指定します。
+hostnet-driver = string
hostnet-afpacket-ifname = ifname
hostnet-bpf-ifname = ifname
hostnet-tap-devpath = path
hostnet-fallback = integer
+それぞれ hostnet0-* の別名です。
+hostnetN-driver = string
+N
+番目のイーサネットデバイスのホスト側ドライバを指定します。
afpacket、bpf、tap のうち
ホスト OS がサポートしているものと auto、none が選択可能です。
afpacket は Linux の AF_PACKET ソケットを使用します。
@@ -598,9 +659,9 @@ See About VM for
none ならホスト側とは一切通信を行いません。
auto ならホスト OS がサポートしているもののうち
tap → afpacket → bpf を順に試します。
-hostnet0-driver のデフォルトは auto、
-hostnet1-driver のデフォルトは none です。
-Specifies the host driver of N-th
+hostnet0-driver のデフォルトは auto、
+hostnet1-driver のデフォルトは none です。
+Specifies the host driver of N-th
ethernet device.
afpacket, bpf, and tap can be specified
only if the host OS supports them.
@@ -612,9 +673,9 @@ and tap uses tap(4) interface.
If auto is specified,
it tries tap, afpacket, and bpf in that order
(if the host OS supports them).
-The default of hostnet0-driver is auto,
+The default of hostnet0-driver is auto,
the default of hostnet1-driver is none.
-hostnetN-afpacket-ifname = ifname
+hostnetN-afpacket-ifname = ifname
ホストドライバが afpacket の時にバインドするインタフェースを1つ指定します。
ifname が auto
なら使用可能なインタフェースを1つ自動的に選択します。
@@ -625,7 +686,7 @@ If auto is specified as ifna
it selects an usable interface automatically.
The default is auto.
Note that this host driver cannot communicate with the localhost.
-hostnetN-bpf-ifname = ifname
+hostnetN-bpf-ifname = ifname
ホストドライバが bpf の時にバインドするインタフェースを1つ指定します。
ifname が auto
なら使用可能なインタフェースを1つ自動的に選択します。
@@ -636,7 +697,7 @@ If auto is specified as ifna
it selects an usable interface automatically.
The default is auto.
Note that this host driver cannot communicate with the localhost.
-hostnetN-tap-devpath = path
+hostnetN-tap-devpath = path
ホストドライバが tap の時に使用するデバイスを1つフルパスで指定します。
デフォルトは auto で、この場合は自動的にデバイスを選択します。
この時の探し方はホスト OS によって異なります。
@@ -664,7 +725,7 @@ In all cases, you need to prepare two sh
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.
-hostnetN-fallback = integer
+hostnetN-fallback = integer
hostnetN-driver で指定したドライバが使用可能でなかった時、
0 ならプロセスを終了します。
1 なら none を選択して実行を継続します。
@@ -674,8 +735,6 @@ you need to prepare empty scripts that w
terminate the process if 0,
or continue to run using the none driver if 1.
The default is 0.
-hostnet-driver = string
hostnet-afpacket-ifname = ifname
hostnet-bpf-ifname = ifname
hostnet-tap-devpath = path
hostnet-fallback = integer
-それぞれ hostnet0-* の別名です。
iplrom1-image = path
(X68030 Only)
X68030 の外部 IPLROM イメージファイルのパスを指定します。
@@ -838,8 +897,10 @@ from preset rate or rate specified here.
mpu-clock = value
MPU のクロック数を MHz 単位で指定します。
デフォルトは LUNA-I なら 20MHz、LUNA-88K と X68030 なら 25MHz です。
+virt68k ではあまり意味はありませんが 25MHz です。
Specifies the MPU clock in MHz.
-The default value is 20MHz on LUNA-I, or 25MHz on LUNA-88K and X68030.
+The default value is 20MHz on LUNA-I, or 25MHz on LUNA-88K and X68030.
+On virt68k, it's less meaningful but 25MHz.
mpu-pseudo-stop = integer
(LUNA-88K Only)
m88100 にて疑似 STOP 状態を有効にするかどうかを指定します。
@@ -853,24 +914,21 @@ m88100 には、m68k の STOP 命令 (
(例えば人間がキーを入力するまで) ホスト CPU パワーを使い潰してビジーウェイトループを実行し続けることになり、ホスト CPU があっつあつになります。
それを防ぐための機能です。
特徴的な命令列を検出して実現しているので、すべての状況で動作するわけではありません。
-nereid0-enable = integer
nereid1-enable = integer
-
-(X68030 Only)
+nereid0-enable = integer
nereid1-enable = integer
+(X68030 Only)
Nereid 拡張ボードを装着するかどうかを指定します。
Nereid は同時に2枚まで使用することができます。
値は 0 なら装着せず、1 なら装着します。
デフォルトは 0 (装着しない) です。
-詳細は 4.5 Nereid の章を参照してください。
+詳細は 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.5 Nereid below for details.
-
-nereid0-net = integer
nereid1-net = integer
-
-(X68030 Only)
+See also Section 4.6 Nereid below for details.
+nereid0-net = integer
nereid1-net = integer
+(X68030 Only)
Nereid ボードの NIC (RTL8019AS) のみを無効にすることが出来ます
(実機では通常そのようなことは出来ません)。
0 なら無効、1 なら有効です。デフォルトは 1 です。
@@ -882,11 +940,9 @@ Nereid ボードの NIC (RTL8019AS) の
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.
-
-nereid0-ram-size = integer
nereid1-ram-size = integer
-
-(X68030 Only)
+is 0.
+nereid0-ram-size = integer
nereid1-ram-size = integer
+(X68030 Only)
Nereid ボードのバンクメモリのサイズを MB 単位で指定します。
指定できるのは 0, 4, 16 です。
0 を指定するとバンクメモリを無効にします。
@@ -903,8 +959,7 @@ is 0.
また通常は必要ありませんが -4 または -16 を指定すると、
バンクメモリは無効にした上で Nereid 制御ポートのビット6の読み出し値
(バンクメモリの容量) を再現することが出来ます。
--4 ならビット6は 0 (4MB)、0 か -16 なら 1(16MB) が読み出せます。
-
+-4 ならビット6は 0 (4MB)、0 か -16 なら 1(16MB) が読み出せます。
news-dipsw = string
(NEWS Only)
DIPSW の内容を指定します。
@@ -974,18 +1029,25 @@ For now, only version 1.20 is supported.
- LUNA-I のデフォルトは 16MB です。
16MB 未満は 4MB 単位で、
-16MB 以上は 255MB まで 1MB 単位で指定できます
-(ちなみに NetBSD/luna68k の起動には最低でも 8MB 必要です)。
+16MB 以上は 512MB まで 1MB 単位で指定できます。
+ただし prom-image で実機イメージを指定した場合は 255MB が上限になります。
+ちなみに NetBSD/luna68k の起動には最低でも 8MB 必要です。
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.
+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.
- LUNA-88K のデフォルトは 64MB です。
64MB 未満は 16MB 単位で、
-64MB 以上は暫定で 255MB まで 1MB 単位で指定できます。
+64MB 以上は暫定で 512MB まで 1MB 単位で指定できます。
+ただし prom-image で実機イメージを指定した場合は
+240MB が上限になります。
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.
+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.
- X68030 ではメイン RAM 容量を示し、デフォルトは 12MB です。
4MB から 12MB まで 1MB 単位で指定できます。
拡張メモリについては extram-size を参照してください。
@@ -994,6 +1056,13 @@ You can specify it in 1MB unit from 4MB
See extram-size for extended memory.
- NWS-1750 では現状 16MB で変更できません。
On NWS-1750, This is 16MB fixed for now.
+ - virt68k のデフォルトは 128MB です。
+16MB から 4080MB まで(アプリケーションとしては)指定可能です。
+指定された値が 16MB で割り切れない場合は 16MB 単位に切り上げになります。
+
On virt68k, 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.
rtc-epoch-year = integer
(LUNA Only)
@@ -1128,24 +1197,67 @@ $ed0008.L (RAM size) in SRAM with config
This update is performed once only if
the SRAM magic string is correct at the application startup.
The default is 1.
-xxx-news-sic-ignore = integer
-(NEWS Only)
-未実装の SCSI コントローラおよび DMA
-コントローラ領域へのアクセスを無視するか指定します。
-現状 (2022/08)、NetBSD/m68k はこの領域へのバスエラーを処理できず、
-uvm_fault のパニックを起こしてしまいます。
-1 にするととりあえず si(4) へのアクセスが不調に終わって
-(他に問題がなければ) NetBSD/news68k が起動できます。
+virtio-blockN-image = path
+
+(virt68k only)
+virtio のブロックデバイスのイメージを指定します。
+キーの N は現状 0 から 7 です。
+イメージパスが相対パスなら VM ディレクトリからの相対パスになります。
+Specifies virtio block device's image.
+N in the key is 0 to 7 for now.
+If the path is relative path, it is from the VM directory.
+
+virtio-blockN-writeignore = integer
+
+(virt68k only)
+指定の virtio ブロックデバイスへの書き込みをイメージに書き戻すかどうか指定します。
+0 なら通常動作(書き込みを行う)です。
+1 ならディスクイメージに一切書き戻しません。
+デバイスへ書き込んだはずのデータは Copy-On-Write の要領で、
+VM ディレクトリ内の一時ファイルに書き込みます。
+この一時ファイルはアプリケーション終了時に削除します。
+fsck を気にせずカーネルのデバッグとかを行いたい場合にはどうぞ。
+何が起きるか意味が分からない人は指定しないでください。
デフォルトは 0 です。
-このオプションは暫定的なもので将来廃止される予定です。
-
-Specifies whether to ignore accesses to unimplemented
-SCSI controller and DMA controller areas.
-As of Aug. 2022, NetBSD/m68k can not handle bus errors to this area,
-and it happens uvm_fault panic.
-Specifying 1 avoids it and NetBSD/news68k can boot.
-The default value is 0.
-This option is temporary and will be discontinued in the future.
+Specifies whether nono writes a writing to virtio block 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).
+
+windrv-path = path
+(X68030 Only)
+Windrv でゲスト側に見せるホストディレクトリを指定します。
+今の所指定できるディレクトリは1つだけです。
+空なら Windrv デバイスが存在しないように振る舞います。
+デフォルトは空です。
+x68k-cut-fc2 = integer
+(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.
@@ -1188,7 +1300,7 @@ This option is temporary and will be dis
| LUNA-I
|
| MPU (68030)
| ○
- | キャッシュ未実装 Cache not implemented
+ | データキャッシュ未実装 Data cache not implemented
| FPU (68881)
| ◎
|
@@ -1212,7 +1324,7 @@ This option is temporary and will be dis
|
| | Ethernet (AM7990)
| ◎
- | マルチキャストフィルタを除く Except multicast filter
+ |
| | NVRAM&RTC (MK48T02)
| ◎
|
@@ -1256,7 +1368,7 @@ This option is temporary and will be dis
| | X68030
| | MPU (68030)
| ○
- | キャッシュ未実装、ファンクションコード未実装 Cache and FC not implemented
+ データキャッシュ未実装 Data cache not implemented
| MPU (68EC030)
| —
| 実装予定なし Not planned
@@ -1264,7 +1376,7 @@ This option is temporary and will be dis
| ◎
| 68882 は未実装 68882 not implemented
| | DMAC
- | ○
+ | △
|
| | CRTC/VC
| △
@@ -1273,11 +1385,17 @@ This option is temporary and will be dis
| ○
|
| 標準・拡張エリアセット Areaset
- | ×
+ | ◎
|
| | ADPCM/OPM
| ×
|
+ | テキスト画面Text screen
+ | ○
+ |
+ | コントラスト Contrast
+ ◎
+ |
| グラフィック機能全般 All other graphics
×
| 当面予定なし Not scheduled
@@ -1314,17 +1432,14 @@ This option is temporary and will be dis
| システムポートSystem port
| △
|
- | テキスト画面Text screen
- | ○
- |
| 電源 Power curcuit
| ○
|
- | | Nereid Ethernet
- | ◎
- | マルチキャストフィルタを除く Except multicast filter
- | | Nereid Bank memory
- | ◎
+ | | Nereid Ethernet
+ | ◎
+ |
+ | | Nereid Bank memory
+ | ◎
|
| | Nereid USB
| —
@@ -1332,10 +1447,13 @@ This option is temporary and will be dis
| 拡張メモリ Extended memory
| ○
|
+ | | Windrv
+ | △
+ |
| | NWS-1750
| | MPU (68030)
| ○
- | キャッシュ未実装 Cache not implemented
+ | データキャッシュ未実装 Data cache not implemented
| FPU (68881)
| ◎
| 68882 は未実装 68882 not implemented
@@ -1347,7 +1465,7 @@ This option is temporary and will be dis
| チャンネル A のみホストに接続 Only channel A is connected to the host
| Ethernet (AM7990)
| ◎
- | マルチキャストフィルタを除く Except multicast filter
+ |
| | NVRAM&RTC (MK48T02)
| ◎
|
@@ -1369,6 +1487,34 @@ This option is temporary and will be dis
| 電源 Power Circuit
| ×
|
+ | | virt68k
+ | | MPU (68030)
+ | ○
+ | データキャッシュ未実装 Data cache not implemented
+| FPU (68881)
+ | ◎
+ | 68882 は未実装 68882 not implemented
+ | | Goldfish PIC
+ | ◎
+ |
+ | | Goldfish RTC
+ | ◎
+ |
+ | | Goldfish Timer
+ | ○
+ |
+ | | Goldfish TTY
+ | ○
+ |
+ | | virtio v1.0 block
+ | ○
+ |
+ | | virtio v1.0 net
+ | △
+ |
+ | | Power Control
+ | ○
+ |
@@ -1376,12 +1522,9 @@ This option is temporary and will be dis
4.2. MPU (68030)
-68030 はキャッシュが未実装です。
-これに伴い命令の所要クロック数もまだ正しくなく、
-そのためクロック測定などでは正確な値が出ません。
+68030 は命令キャッシュのみ実装し、データキャッシュは未実装です。
また ATC (アドレス変換キャッシュ) は実際の仕様とは異なり高速化してあります。
-68030 cache is not implemented.
-Therefore, number of clock cycle is not correct.
+68030 instruction cache is implemented but data cache is not.
ATC (Address Translation Cache) is differ from and faster than the real 68030.
@@ -1410,9 +1553,47 @@ Human68k を起動する場合はお手
+
+
+4.5. NEWS エミュレーション
+NEWS エミュレーションは今の所
+-X オプションでカーネルを直接起動することしか出来ません。
+PROM も NetBSD/news68k
+の起動と終了に最低限必要な程度が誤魔化してあるだけです。
+また、デバイスの配置や、デバイスが存在しないアドレスへのアクセスが
+どうなるかなどは実機確認をしていないため分かりません。
+従って、動くものは動く、程度のものでしかありません。
+というかネタです。
+
+
+
+
+
+4.6. virt68k エミュレーション
+
+QEMU の "virt" (架空ハードウェア仕様)の互換機wをサポートしています。
+NetBSD/virt68k が動作します。
+-X オプション (または設定の exec-file)
+でカーネルを指定してください。
+インストール時には --initrd (または設定の exec-initrd)
+で RAM ディスクイメージも指定します。
+また、設定の hostcom-driver でシリアルコンソールを
+どこかに出力するのもほぼ必須だと思います。
+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).
+And also, you may need to configure serial console
+by hostcom-driver in configuration.
+
+
+
+
-4.5. X68030 の Nereid エミュレーション
+4.7. X68030 の Nereid エミュレーション
現実の Nereid はイーサネット/メモリ/USB の複合拡張ボードで、
このうちメモリは、メインメモリの増設に使える他、
メインメモリとして使わなかった領域をバンクメモリとして使うことも出来ます。
@@ -1441,7 +1622,7 @@ Originally, SW6 and SW7 can be arbitrari
SW6 and SW7 are fixed to be OFF on board #0, and
SW6 and SW7 are fixed to be ON on board #1.
-
+
| #0 (nereid0-*) | #1 (nereid1-*)
|
|---|
ベースアドレス・割り込みベクタ
Base address and interrupt vectors
| $ece300,$f9,$fb (SW7=OFF)
@@ -1470,20 +1651,61 @@ Otherwise, the bank memory will be alloc
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.
-
+
-4.6. NEWS エミュレーション
-NEWS エミュレーションは未完成です。
-今の所 -X でカーネルを直接起動することしか出来ません。
+ 4.8. Windrv
+Windrv を一応サポートしてみました。
+Human68k からホストのファイルシステムをアクセスする機構です。
+既存の Windrv とは、ホスト OS の前提が異なるため既存実装からの移植ではありませんし、
+そもそも Human68k とホスト(UNIX)ファイルシステムの差異による制約も多くあります。
+これらを把握してから使用してください。
+
+- ファイル名は21文字すべて認識します。
+22文字以上(というか 18.3 形式以外)のファイル名はゲストからは見えません。
+
- ファイル名中の ASCII 以外の文字には現状対応していません。
+これらの文字を含むファイルはゲストからは見えません。
+
- マルチピリオドには対応していません。
+このようなファイルはゲストからは見えません。
+
- 大文字小文字は区別しません。
+大文字小文字だけが違う同名のファイル (例えば a.BAK と a.bak) があると、
+検索(FILES/NFILES) には現れません。
+この状況で a.Bak (大文字小文字を区別していれば違うファイル)
+を新規作成しようとすると (大文字小文字を区別しない a.Bak
+というエントリはゲスト的には存在しないにも関わらず) 作成できなくしてあります。
+
- ファイルサイズが 2GB 以上のファイルはゲストからは見えません。
+
- Human68k 側の属性は A(アーカイブ)/D(ディレクトリ)/R(読み込み専用)
+のみ対応しています。
+S(システム)/H(隠しファイル)属性は保存されません。
+
- ホストのシンボリックリンクは、リンク先の
+ファイルもしくはディレクトリとして見えます。
+またリンク先が Windrv のルートパスの外側を指していても構いません。
+
- ファイルのロックには対応していません。
+
- WindrvXM.sys による拡張動作には対応していません。
+windrv 互換として動作します。
+
- TwentyOne.x は現状 +T/-C/-P/-S (いずれもデフォルト) 相当だと思います。
+TwentyOne.x が常駐していないとか、
+これ以外のオプションの時にどうなるかは把握していません。
+
- lndrv.x によるゲスト側のシンボリックリンク機能には未対応です。
+
+
+Windrv を使用する場合、まず nono
+の設定ファイルに windrv-path を設定します。
+次にゲストの Human68k の CONFIG.SYS に WINDRV.SYS (または WindrvXM.sys)
+を設定してください。
+
+
+DEVICE = \SYS\WINDRV.SYS
+
+
-4.7. ステータスパネル Status Panel
+ 4.9. ステータスパネル Status Panel
ステータスパネル中央にあるパフォーマンスメータのアイコンは
高速モードの状態を表示しています。
ダブルクリックすると高速/等速モードの指定を切り替えることができます。
@@ -1532,26 +1754,27 @@ or the keyboard buzzer is sounding.
-4.8. DIPSW 設定ウィンドウ
+ 4.10. DIPSW 設定ウィンドウ
DIPSW 設定ウィンドウでの変更はアプリケーション起動中のみ有効です。
またここでの設定は即 VM に反映されますが、
LUNA の場合 DIPSW の状態を
PIO(8255) がラッチするのが概ね起動時および再起動時のみとなっています
(厳密には PROM と XP が云々ですが)。
+
-4.9. メモリダンプモニタ Memory Dump Monitor
+ 4.11. メモリダンプモニタ Memory Dump Monitor
メモリダンプモニタの出力形式を、バイト、ワード、ロングワード
(m88k ではそれぞれバイト、ハーフワード、ワードと表現します)
から選択できます。
また 68030/88200 の MMU ディスクリプタとして表示させることもできます
(この位置が正しいディスクリプタかどうかは関係なく表示します)。
-逆アセンブルも、逆アセンブルウィンドウからこちらにマージしました。
-LUNA-I なら m68k、HD64180 の逆アセンブルが、
-LUNA-88K なら m88k、HD64180 の逆アセンブルが、
-X68030 と NEWS なら m68k の逆アセンブルが選択できます。
+逆アセンブルは、
+LUNA-I なら m68k と HD64180 の逆アセンブルが、
+LUNA-88K なら m88k と HD64180 の逆アセンブルが、
+X68030 /virt68k/NEWS なら m68k の逆アセンブルが選択できます。
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).
@@ -1560,7 +1783,8 @@ Also you can choose 68030/88200 MMU desc
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 and NEWS, you can choose m68k disassemble.
+On X68030 /virt68k/NEWS,
+you can choose m68k disassemble.
表示されているダンプ値をダブルクリックすることでメモリの値を編集できます。
編集できるのはメモリと以下の部分のみです。
@@ -1569,9 +1793,9 @@ Only memory and the following areas are
- NVRAM (LUNA and NEWS Only) …
編集するとただちにファイルも更新します。
-後ろの8バイトは時計レジスタを兼ねているため編集不可です。
+後ろの8バイトのみ時計レジスタを兼ねているため編集不可です。
The backend file is also updated immediately when edited.
-The last 8 bytes are not editable since there are the clock register.
+The only last 8 bytes are not editable since there are the clock registers.
- Bitmap framebuffer (LUNA Only) … 共通プレーンは書き込み不可です。
The common plane is not editable.
- SRAM (X68030 Only) …
@@ -1580,21 +1804,25 @@ The last 8 bytes are not editable since
- TVRAM とテキストパレット (X68030 Only)
Text VRAM and text palette
+
-4.10. デバイスマップモニタ Device Map Monitor
+ 4.12. デバイスマップモニタ Device Map Monitor
m68k/m88k バスに接続されているデバイスを表示します。
32ビットアドレスのうち上位 8 ビット、256個分を表示しています。
1枠が 16MB になります。
また、X68030 ではこのうち 24ビット空間を別モニタで表示します。
こちらは 1枠 8KB x 2048個です。
どちらも内部構造を表示しているだけなので名前に馴染みがない場合があるかもしれません。
+NEWS のデバイスマップは内部構造の都合上、
+内部状態を正確に反映していないケースがあるかも知れません。
+
-4.11. キー入力モード Key input mode
+ 4.13. キー入力モード Key input mode
LUNA も X68030 もキーボードは通常日本語キーボードです
(LUNA には英語キーボードも存在するようですが…)。
そのため、ホストが日本語キーボードの場合とそうでない場合のために
@@ -1680,7 +1908,7 @@ even though it should not work as a corr
-4.12. キャラクタ入力モードのキーコード対応表 Keycode table in the character mode
+ 4.14. キャラクタ入力モードのキーコード対応表 Keycode table in the character mode
キャラクタ入力モードでの、ホストから入力した文字と
VM に送信されるキーの対応は次の通りです。
ファンクションキーとカーソルキーは文字ではありませんが
@@ -1698,7 +1926,7 @@ only be typed from the software keyboard
.keytable-whole {
display: inline-block;
vertical-align: top;
- border: solid 1px;
+ border-bottom: solid 1px;
}
.keytable-middle {
margin-left: 1em;
@@ -1707,16 +1935,25 @@ only be typed from the software keyboard
.keytable-head {
text-align: left;
+ border-top: solid 1px;
border-bottom: solid 1px;
}
.keytable-headl {
padding-right: 1em;
+ border-left: solid 1px;
+ border-right: solid 1px;
+}
+.keytable-headr {
+ border-right: solid 1px;
}
.keytable-tdl {
padding-right: 1em;
+ border-left: solid 1px;
+ border-right: solid 1px;
}
.keytable-tdr {
+ border-right: solid 1px;
}
@@ -1786,12 +2023,12 @@ only be typed from the software keyboard
-4.13. JP キーボードモードのキーコード対応表 Keycode table in the JP keyboard mode
+ 4.15. JP キーボードモードのキーコード対応表 Keycode table in the JP keyboard mode
JP キーボードモードでの、ホストキーと VM に送信されるキーの対応は次の通りです。
ここに記載のないキーはソフトウェアキーボードからのみ入力出来ます。
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 enter from
+The keys that not listed in this table can only be entered from
the software keyboard window.
@@ -1809,20 +2046,17 @@ the software keyboard window.
| []] | []]
| | [,] | [,]
| | [.] | [.]
- | | [/] | [/]
- | | [_] | [_]
|
| HostKey | GuestKey
+ |
|---|
| [/] | [/]
+ | | [_] | [_]
| | [ESC] | [ESC]
| | [TAB] | [TAB]
| | [CTRL] | [CTRL]
- | | [BS] | [BS]
- | | [Enter] | [Enter]
- | | [F1] 〜 [F10] | [PF1] 〜 [PF10]
- | | [F11] | [PF10]
| | [SHIFT-L] | [SHIFT-L]
| | [SHIFT-R] | [SHIFT-R]
+ | | [Enter] | [Enter]
| | [↑] | [↑]
| | [←] | [←]
| | [→] | [→]
@@ -1830,7 +2064,10 @@ the software keyboard window.
|
| HostKey | GuestKey
- |
|---|
| [DEL] | Numpad[DEL]
+ | | [BS] | [BS]
+ | | [Delete] | [DEL]
+ | | [F1] 〜 [F10] | [PF1] 〜 [PF10]
+ | | [F11] | [PF10]
| | Numpad[0]〜[9] | Numpad[0]〜[9]
| | Numpad[+] | Numpad[+]
| | Numpad[-] | Numpad[-]
@@ -1840,13 +2077,23 @@ the software keyboard window.
| | Numpad[.] | Numpad[.]
| | Numpad[Enter] | Numpad[Enter]
|
+
+
+(X68030 Only)
+| HostKey | GuestKey
+ |
|---|
| [Home] | [HOME]
+ | | [Insert] | [INS]
+ | | [PageUp] | [ROLL UP]
+ | | [PageDown] | [ROLL DOWN]
+ | | [End] | [UNDO]
+ |
-4.14. キーリピート Key Repeat
+ 4.16. キーリピート Key Repeat
LUNA では、キーボードがハードウェア側でキーリピートを行わず、
ソフトウェア(OS など)がキーリピートの処理を行います。
そのため、キーリピートを実装していない LUNA の PROM や
@@ -1950,7 +2197,7 @@ x⏎
You will see a screen like this. The bold text indicates
the characters you need to enter.
-NONO 0.6.0 Emulated ROM Monitor for LUNA-I
+NONO 0.7.0 Emulated ROM Monitor for LUNA-I
** NVRAM Initialized.
@@ -1996,11 +2243,11 @@ and nono will terminate when the VM is p
5.2. OpenBSD/luna88k を実行してみる Try OpenBSD/luna88k
-あおやまさんが OpenBSD/luna88k 7.0 の liveimage を用意されています。
- Aoyama-san has provided a liveimage of OpenBSD/luna88k 7.0.
+あおやまさんが OpenBSD/luna88k 7.4 の liveimage を用意されています。
+ Aoyama-san has provided a liveimage of OpenBSD/luna88k 7.4.
-- https://twitter.com/ao_kenji/status/1473611893386661888
+
- https://bsd.network/@ao_kenji/111250570715336091
ここではこれを起動してみます。 Let's try it.
@@ -2011,10 +2258,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-20211221.img.gz
+以下のリンクから liveimage-luna88k-raw-20231016.img.gz
をダウンロードして展開し、
VM ディレクトリ ~/nono/luna88k/ に置きます。
-Download liveimage-luna88k-raw-20211221.img.gz from the following link,
+Download liveimage-luna88k-raw-20231016.img.gz from the following link,
extract it and place it in the VM directory, ~/nono/luna88k/.
vmtype = luna88k
-spc0-id6-image = hd,liveimage-luna88k-raw-20211221.img
+spc0-id6-image = hd,liveimage-luna88k-raw-20231016.img
hostnet-driver = none
@@ -2053,7 +2300,7 @@ b⏎
You will see a screen like this. The bold text indicates
the characters you need to enter.
-NONO 0.6.0 Emulated ROM Monitor for LUNA-88K
+NONO 0.7.0 Emulated ROM Monitor for LUNA-88K
** NVRAM Initialized.
@@ -2081,9 +2328,10 @@ and nono will terminate when the VM is p
5.3. NetBSD/x68k を実行してみる Try NetBSD/x68k
-つついさんが NetBSD/x68k 9.2 の liveimage を用意されています。
+つついさんが NetBSD/x68k 10.0_BETA の liveimage を用意されています。
ここではこれを起動してみます。
- Tsutsui-san has provided a liveimage of NetBSD/x68k 9.2. Let's try it.
+ Tsutsui-san has provided a liveimage of NetBSD/x68k 10.0_BETA.
+Let's try it.
- どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、
@@ -2099,21 +2347,21 @@ VM ディレクトリ ~/nono/x68k/ に
from the following link,
extract it and place it in the VM directory, ~/nono/x68k/.
-http://teokurebsd.org/netbsd/liveimage/20210613-x68k/
+http://teokurebsd.org/netbsd/liveimage/20230111-x68k/
- 以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/x68k/
に作成します。
-ここでは説明を簡単にするためネットワークなしにしていますが、
-ネットワーク設定は必要に応じて行ってください。
+ここでは説明を簡単にするためネットワークなしにしていますが、
+ネットワーク設定は必要に応じて行ってください。
Create a configuration file nono.cfg in the VM directory, ~/nono/x68k/,
with following contents.
-By the way, to simplify the explanation, we assume there is no network here.
-However, please configure the network if necessary.
+By the way, to simplify the explanation, we assume there is no network here.
+However, please configure the network if necessary.
vmtype = x68030
-spc0-id0-image = hd,liveimage-x68k-with-packages-20210613.hds
+spc0-id0-image = hd,liveimage-x68k-with-packages-20230111.hds
hostnet0-driver = none
@@ -2149,6 +2397,75 @@ and nono will terminate when the VM is p
+
+
+
+
+5.4. NetBSD/virt68k をインストールしてみる Try installing NetBSD/virt68k
+
+ここでは NetBSD/virt68k をクリーンインストールする手順だけ紹介します。
+Here I will introduce how to install NetBSD/virt68k.
+
+
+- どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、
+その中に VM ディレクトリを用意します (例えば ~/nono/virt68k/)。
+
Create a directory somewhere for nono (for example ~/nono/),
+and create subdirectories for individual VMs in it
+(for example ~/nono/virt68k/).
+
+ - 空のディスクイメージを用意します。
+1GB でもインストール自体は出来ますが、もう少し大きいほうが安心です。
+
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
+
+
+ - 以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/virt68k
+に作成します。
+ネットワークは別途設定してください。
+
Create a configuration file nono.cfg in the VM directory, ~/nono/virt68k/,
+with following contents.
+You may also need network configuration.
+
+vmtype = virt68k
+virtio-block0-image = virt68k.img
+hostcom-driver = stdio
+hostnet-driver = auto
+
+
+ - NetBSD/virt68k のインストールセットはまだ用意されてないようなので、
+NetBSD のソースコードから build.sh でビルドします。
+
There doesn't seem to be the official NetBSD/virt68k set available yet.
+You have to build it manually from the source code. :(
+
+ - 以下のコマンドラインで起動します。
+
Run as the following:
+
+nono -c ~/nono/virt68k -f \
+ -X <path>/release/virt68k/binary/kernel/netbsd-GENERIC.gz \
+ --initrd <path>/release/virt68k/installation/ramdisks/inst-ramdisk.fs
+
+
+ - しばらくすると root パーティションなどを聞かれるので Enter を 4回押します。
+またしばらくすると見慣れたインストーラが起動してきます。
+
After a while, you will be asked about the root partition, etc.,
+so hit Enter key four times.
+After a while again, the familiar installer will start.
+
+[ 1.0000030] root device (default md0a): ⏎
+[ 1.0200030] dump device (default md0b): ⏎
+[ 1.0300030] file system (default ffs): ⏎
+[ 1.0400030] root on md0a dumps on md0b
+[ 1.0600030] kern.module.path=/stand/virt68k/10.99.10/modules
+[ 1.1200030] init path (default /sbin/init): ⏎
+[ 1.1400030] init: trying /sbin/init
+ :
+
+
+
+
@@ -2176,7 +2493,7 @@ sysinst 等で OS をアップグレー
に戻るのがハマりポイントです。
By default, /dev/tap is only accessible to privileged user.
You need to chmod /dev/tap (without unit number) appropriately.
-Note that upgrading using sysinst always reset the permission to 600.
+Note that upgrading using sysinst always resets the permission to 600.
bridge(4) インタフェースを作成し、
ホストの外部(物理)インタフェースをブリッジに追加しておきます。
| | | | | | | | | |