--- nono/doc/index.php 2026/04/29 17:05:22 1.1.1.16 +++ nono/doc/index.php 2026/04/29 17:05:39 1.1.1.20 @@ -3,32 +3,15 @@ Copyright (C) 2020 nono project Licensed under nono-license.txt --> - + + + +nono document (<?php print $nono_ver; ?>) + nono () nono は NetBSD とかで動作する OMRON LUNA-I/LUNA-88K のエミュレータです。 -何故か SHARP X68030 と virt68k も動いたりするかも知れません。 +何故か SHARP X68030 と virt-m68k も動いたりするかも知れません。 nono is OMRON LUNA-I/LUNA-88K emulator runs on NetBSD and etc. -It can also emulate SHARP X68030 and virt68k. - +It can also emulate SHARP X68030 and virt-m68k.
@@ -104,34 +86,39 @@ It can also emulate SHARP X68030 and vir
  • make (BSD make, not GNU make)
  • C/C++ compiler which supports -std=c++14.
    -(For gcc, 7.4 or newer works at least. -For clang, 7.0 - 15.0 works at least.) -
  • wxWidgets 3.2.x "stable" branch or 3.0.x "old stable" branch +(For gcc, at least 7.4 or later. +For clang, at least 7.0 or later.) +
  • wxWidgets 3.2.x "stable" branch. + (3.0.x "old stable" branch would also work.)
  • gettext +
  • libslirp (4.7.0 or later is comfirmed, 4.8.0 or later is preferred.)

    -wxWidgets は NetBSD(pkgsrc) なら -pkgsrc/x11/wxGTK32 (OPTIONS:gtk3 で動作確認) です。 +NetBSD(pkgsrc) なら必要なパッケージは +x11/wxGTK32 と net/libslirp です。 +wxGTK32 の代わりに wxGTK30 でも動くはずです。 If you use NetBSD(pkgsrc), -wxWidgets is pkgsrc/x11/wxGTK32 (OPTIONS:gtk3 is tested). +x11/wxGTK32 and net/libslirp are needed. +wxGTK30 would also work.

    (NetBSD 以外でのビルドはサポートしていませんが) -Ubuntu 22.04 ではたぶん以下のパッケージが必要です。 -You may need the following packages on Ubuntu 22.04 +Ubuntu 24.04 ではたぶん以下のパッケージが必要です。 +You may need the following packages on Ubuntu 24.04 (though we won't support non-NetBSD platform).

    - +

    nono のソースアーカイブを展開したら以下のようにビルドします。 @@ -159,13 +146,20 @@ Also, you can specify the following opti

    make install により2つの実行ファイルがインストールされます。 @@ -250,6 +244,21 @@ This option is equivalent to fast-mo _EOM_ ); +option_item("--fd0 file
    --fd1 file
    ", <<<_EOM_ + +(X68030 Only) フロッピーイメージを指定します。 +file が相対パスの場合カレントディレクトリからのパスになります。 +設定の fd0-imagefd1-image +とは相対パスの起点の違いを除いて同一です。 +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 版のみ。 全サブウインドウの起動時のフォントサイズを指定します。 @@ -262,19 +271,16 @@ This option is equivalent to monitor _EOM_ ); -option_item("--initrd file", <<<_EOM_ - -(virt68k only) +option_item("--initrd file", <<<_EOM_ +(virt-m68k Only) カーネルに渡す初期 RAM ディスクのパスを指定します。 file が相対パスの場合カレントディレクトリからのパスになります。 設定の exec-initrd とは相対パスの起点の違いを除いて同一です。 - -Specifies the initial ramdisk image passed to the kernel. +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_ ); @@ -317,7 +323,7 @@ _EOM_ option_item("-X file", <<<_EOM_ ホストの file をロードして実行します。 file が相対パスの場合カレントディレクトリからのパスになります。 -設定の exec-file とは相対パスの起点の違いを除いて同一です。 +設定の exec-file とは相対パスの起点の違いを除いて同一です。 ファイルが gzip 圧縮されていれば自動的に展開します。 (展開後の) ファイル形式は以下の通りですが、 実際にはブートローダとカーネル程度しか想定していません。 @@ -325,8 +331,8 @@ option_item("-X file", <<<_EOM_ 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. +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. @@ -344,7 +350,6 @@ NetBSD の実行ファイルのようで If the file is assumed to be NetBSD executable, it will also load symbol tables as the bootloader does to the kernel.)

  • ELF object (Experimental) -
  • Human68k .x executable (Experimental) LUNA では設定の prom-image (後述) によらず内蔵の互換 ROM で起動します。 luna-dipsw1 の DIPSW 設定が @@ -354,10 +359,9 @@ LUNA では設定の prom-image ロードはここで指定したホストファイルをロードします。 X68030 では、IPLROM 起動の後の起動デバイスに細工がしてあり、 そこからホストファイルを実行します。 -virt68k (と NEWS) はこの方法でしか起動できませんので、 -実行ファイルの指定は必須になります。 - -On LUNA, +virt-m68k (と NEWS) はこの方法でしか起動できませんので、 +実行ファイルの指定は必須になります。 +On LUNA, regardless of prom-image configuration (see below), it boots the internal emulated PROM. If luna-dipsw1 configuration meets dipsw-autoboot=yes, @@ -368,7 +372,7 @@ will load the host file that is specifie On X68030, nono hacks the boot device after normal boot from IPLROM, and loads and executes the host file. -On virt68k (and NEWS), this is the only way to boot. +On virt-m68k (and NEWS), this is the only way to boot. _EOM_ ); ?> @@ -407,6 +411,9 @@ option_dev("-D", <<<_EOM_ _EOM_ ); +$hlink = linkto_str("human", "human.html"); +option_dev("-H", "Human68k モードです。→ {$hlink}"); + option_dev("-L name1=level1[,name2=level2,...]", <<<_EOM_ ログレベルを指定します。 @@ -469,7 +476,7 @@ do in the same manner. vmtype を除くすべての設定項目はそれぞれデフォルト値を持っています。 つまり少なくとも vmtype だけは設定ファイルかコマンドラインオプションで指定する必要があります。 All configuration items except vmtype have default value. -It means, you must specify at least only vmtype +It means, you need to specify at least only vmtype by configuration file or commandline option.

    設定項目は次の通りです。 @@ -487,11 +494,11 @@ VM 種別を以下のいずれかから 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) -
    virt68k … virt68k +
     luna  … LUNA-I +
    luna88k  … LUNA-88K +
    x68030  … X68030 +
    news  … NWS-1750 (Just a joke) +
    virt-m68k (or virt68k)  … virt-m68k
    _EOM_ ); @@ -518,14 +525,38 @@ _EOM_ config_item("clock-sync = value", <<<_EOM_ 仮想マシン内の時刻の同期方法を指定します。 real なら実時間に同期、virtual なら仮想時間に同期します。 -デフォルトは real です。 -この機能は実験中のため将来予告なく仕様が変更になる可能性があります。 -Specifies how to synchronize the time in virtual machine. +Specifies how to synchronize the time in the virtual machine. If real, synchronize with the real time; -if virtual, synchronize with the virtual time. -The default is real. -This feature is under experimentation and may be changed in the future -without notice. +if virtual, synchronize with the virtual time. +

      +
    • LUNA-I では 60Hz のシステムクロック割り込みと RTC(MK48T02) が対象で、 +デフォルトは real です。 +On LUNA-I, 60Hz system clock interrupt and RTC(MK48T02) are the target. +The default is real. +
    • LUNA-88K では 100Hz のシステムクロック割り込みと RTC(MK48T02) が対象で、 +デフォルトは real です。 +On LUNA-88K, 100Hz system clock interrupt and RTC(MK48T02) are the target. +The default is real. +
    • NWS-1750 ではシステムクロック割り込みと RTC(MK48T02) が対象で、 +デフォルトは real です。 +On NWS-1750, system clock interrupt and RTC(MK48T02) are the target. +The default is real. +
    • virt-m68k では Goldfish Timer の割り込みと Goldfish RTC が対象で、 +デフォルトは real です。 +On virt-m68k, Goldfish Timer interrupt and Goldfish RTC are the target. +The default is real. +
    • X68030 では MFP のタイマー割り込みと RTC(RP5C15) が対象で、 +デフォルトは virtual です。 +MFP の TxDR レジスタの読み出しは、 +この指定に関わらず常に virtual 相当の動作しか出来ません。 +NetBSD/x68k での時間同期 の項も参照してください。 +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. + +
    _EOM_ ); @@ -615,26 +646,35 @@ config_item( _EOM_ ); -config_item("exec-file = path", <<<_EOM_ - +config_item("exec-file = path", <<<_EOM_ 起動時にロードするホストの実行ファイルを指定します。 -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. - _EOM_ ); -config_item("exec-initrd = path", <<<_EOM_ - -(virt68k Only) +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_ ); @@ -688,61 +728,84 @@ _EOM_ ); config_item("fpu-type = value", <<<_EOM_ -(X68030 Only) -FPU を装着するかどうか指定しています。 -none なら FPU を装着しません。 -68881 なら FPU として 68881 を装着します。 +(X68030 and virt-m68k Only) +68030 に FPU コプロセッサを装着するかどうか指定しています。 +この設定は mpu-type68030 の時のみ有効です。 +none なら FPU コプロセッサを装着しません。 +68881 なら FPU コプロセッサとして 68881 を装着します。 現状 68882 はサポートしていません。 また none の代わりに 068881 の代わりに 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. +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. -This item also cannot be specified on virt68k for now. +because (probably) all LUNA-I has 68881. _EOM_ ); -config_item("host-avx2 = string", <<<_EOM_ - -ホストが amd64(x86_64) の場合に AVX2 アクセラレーションを使うかどうかを -指定します。 +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 on amd64(x86_64) hosts. +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_ シリアルポートのホスト側ドライバを指定します。 -stdiotcpnone が選択可能です。 -stdio は標準入出力を使用します。 -tcp は TCP ポートで TELNET プロトコルで待ち受けます。 +stdio なら標準入出力を使用します。 +tcp なら TCP ポートで TELNET プロトコルで待ち受けます。 +cons ならメイン画面で端末エミュレーションを行います。 none ならホスト側とは一切通信を行いません。 -デフォルトは none です。 +ゲスト機種によって対応しているホスト側ドライバの種類とデフォルト値が変わります。 +LUNA-I、LUNA-88K、X68030 では stdiotcpnone +が選択可能でデフォルトは none です。 +virt-m68k、NEWS では stdiotcpconsnone +すべてが選択可能でデフォルトは cons です。 Specifies the host driver of serial port. -stdio, tcp, and none can be specified. stdio uses the standard input/output. tcp listens on TCP port using TELNET protocol. +cons does a terminal emulation in main panel. none doesn't make any communication with the host. -The default is none. +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_ ); @@ -765,7 +828,7 @@ _EOM_ ); config_item("hostkbd-input = string", <<<_EOM_ -(LUNA and X68030 only) +(LUNA and X68030 Only) ホストキーボードの入力モードを指定します。 char ならキャラクタ入力モード、 jp なら日本語キーボードモードです。 @@ -784,6 +847,9 @@ config_item( "hostnet-afpacket-ifname = ifname
    " . "hostnet-bpf-ifname = ifname
    " . "hostnet-tap-devpath = path
    " . + "hostnet-usermode-hostfwd = string
    " . + "hostnet-usermode-net = string
    " . + "hostnet-usermode-net6 = string
    " . "hostnet-fallback = integer
    ", <<<_EOM_ それぞれ hostnet0-* の別名です。 _EOM_ @@ -792,28 +858,37 @@ _EOM_ config_item("hostnetN-driver = string", <<<_EOM_ N 番目のイーサネットデバイスのホスト側ドライバを指定します。 -afpacketbpftap のうち -ホスト OS がサポートしているものと autonone が選択可能です。 -afpacket は Linux の AF_PACKET ソケットを使用します。 -bpf は bpf(4) デバイスを使用します。 -tap は tap(4) インタフェースを使用します。 -none ならホスト側とは一切通信を行いません。 -auto ならホスト OS がサポートしているもののうち -tapafpacketbpf を順に試します。 -hostnet0-driver のデフォルトは auto、 -hostnet1-driver のデフォルトは none です。 +afpacketbpftapusermode のうち +configure で検出したものと autonone が選択可能です。 Specifies the host driver of N-th ethernet device. -afpacket, bpf, and tap can be specified -only if the host OS supports them. -auto and none can always be specified. -afpacket uses Linux's AF_PACKET socket, -bpf uses bpf(4) device, -and tap uses tap(4) interface. -none doesn't make any communication with the host. -If auto is specified, -it tries tap, afpacket, and bpf in that order -(if the host OS supports them). +afpacket, bpf, tap and usermode can be specified +only if the configure detects them. +auto and none can always be specified. +
      +
    • afpacket は Linux の AF_PACKET ソケットを使用します。 +ホスト自身とは通信できません。 +afpacket uses Linux's AF_PACKET socket. +It cannot communicate with the host itself. +
    • bpf は bpf(4) デバイスを使用します。 +ホスト自身とは通信できません。 +bpf uses bpf(4) device. +It cannot communicate with the host itself. +
    • tap は tap(4) デバイスを使用します。 +tap uses tap(4) device. +
    • usermode は libslirp を使用したユーザモードです。 +nono 自身が NAT ルータ、DHCP サーバ、DNS サーバの機能を持ちます。 +usermode is an usermode network using libslirp. +nono also acts as NAT router, DHCP server and DNS server. +
    • none ならホスト側とは一切通信を行いません。 +none doesn't make any communication with the host. +
    +autousermode と同義ですが、 +configure で libslirp が無効になっている場合は none と同義になります。 +hostnet0-driver のデフォルトは auto、 +hostnet1-driver のデフォルトは none です。 +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_ @@ -878,6 +953,44 @@ you need to prepare empty scripts that w _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 は +
    +
    +protocol,[hostaddr:]hostport,[guestaddr:]guestport +
    +のように ','(カンマ) 3つで区切って表します。 +protocoltcpudp です。 +hostaddr はホストのバインドアドレスで省略すると 0.0.0.0 です。 +guestaddr はゲストのアドレスで、 +省略すると DHCP でクライアントに配布したアドレスになります +(通常は省略します)。 +例えば、ホストの 10022/tcp へのコネクションをゲストの 22/tcp に転送したい場合は +tcp,10022,22 となります。 +複数指定する場合は ';'(セミコロン) で区切って1行に並べます。 +

    +IPv6 には対応していません。 +_EOM_ +); + config_item("hostnetN-fallback = integer", <<<_EOM_ hostnetN-driver で指定したドライバが使用可能でなかった時、 0 ならプロセスを終了します。 @@ -1050,6 +1163,22 @@ 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 で上書き可能です。 @@ -1084,10 +1213,19 @@ _EOM_ config_item("mpu-clock = value", <<<_EOM_ MPU のクロック数を MHz 単位で指定します。 デフォルトは LUNA-I なら 20MHz、LUNA-88K と X68030 なら 25MHz です。 -virt68k ではあまり意味はありませんが 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 virt68k, it's less meaningful but 25MHz. +On virt-m68k, it's less meaningful but 25MHz. +_EOM_ +); + +config_item("mpu-type = value", <<<_EOM_ +(X68030, virt-m68k Only) +MPU 種別を 6803068040 で指定します。 +デフォルトは 68030 です。 +Specifies the MPU type, 68030 or 68040. +The default is 68030. _EOM_ ); @@ -1261,7 +1399,7 @@ By the way, NetBSD/luna68k needs at leas 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. +the maximum is limited to 240MB.

  • X68030 ではメイン RAM 容量を示し、デフォルトは 12MB です。 4MB から 12MB まで 1MB 単位で指定できます。 拡張メモリについては extram-size を参照してください。 @@ -1270,13 +1408,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 まで(アプリケーションとしては)指定可能です。 +
  • virt-m68k のデフォルトは 128MB です。 +16MB から 4080MB まで指定可能です。 指定された値が 16MB で割り切れない場合は 16MB 単位に切り上げになります。 -On virt68k, the default is 128MB and +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. +it will be rounded up to 16MB. _EOM_ ); @@ -1317,8 +1455,7 @@ SCSI デバイスとイメージを指 値はデバイス種別 devtype とディスクイメージパス path を ","(カンマ) で区切って並べた形式です。 デバイス種別 devtype は以下のいずれかです。 - -Specifies SCSI device and image. N in the key is 0 to 7. +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). @@ -1333,8 +1470,7 @@ the disk image path path separate devtypehd なら path は省略できません。 devtypecdmo なら path は省略可能です。 イメージパスが相対パスなら VM ディレクトリからの相対パスになります。 - -If devtype is hd, path cannot be ommitted. +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. @@ -1404,17 +1540,6 @@ clear the write permission from the imag _EOM_ ); -config_item("spc0-idN-writeprotect = integer", <<<_EOM_ -(LUNA and X68030 Only) -古いオプションです。 -代わりに spc0-idN-writeignore を使ってください。 -このオプションは開発用です。 -Obsolete. -Use spc0-idN-writeignore instead. -This option is for developers. -_EOM_ -); - config_item("sram-sync-ramsize = integer", <<<_EOM_ (X68030 Only) SRAM の RAM 容量欄を実際の RAM サイズに合わせるかどうかを指定します。 @@ -1435,51 +1560,50 @@ The default is 1. _EOM_ ); -config_item("virtio-blockN-image = path", <<<_EOM_ - -(virt68k only) -virtio のブロックデバイスのイメージを指定します。 -キーの N は現状 0 から 7 です。 +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 to 7 for now. +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_ - -(virt68k only) -指定の virtio ブロックデバイスへの書き込みをイメージに書き戻すかどうか指定します。 -0 なら通常動作(書き込みを行う)です。 -1 ならディスクイメージに一切書き戻しません。 -デバイスへ書き込んだはずのデータは Copy-On-Write の要領で、 -VM ディレクトリ内の一時ファイルに書き込みます。 -この一時ファイルはアプリケーション終了時に削除します。 -fsck を気にせずカーネルのデバッグとかを行いたい場合にはどうぞ。 -何が起きるか意味が分からない人は指定しないでください。 -デフォルトは 0 です。 -Specifies whether nono writes a writing to virtio block devices back +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. -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. +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_ -ちなみに、メディアを書き込み禁止にしたい場合はこれではなく、 -イメージファイルの書き込み権を落としてください。 -By the way, if you want to make the media write-protected, -clear the write permission from the image file -(instead of this setting). +(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_ ); @@ -1508,6 +1632,13 @@ Only if you run the X server on NetBSD/x _EOM_ ); +config_item("xp-clock = value", <<<_EOM_ +(LUNA Only) +XP プロセッサのクロック数を MHz 単位で指定します。 +デフォルトは 6.144 [MHz] です。 +_EOM_ +); + ?>

  • @@ -1550,7 +1681,7 @@ _EOM_ Data cache not implemented +MPU (68030) ◎ FPU (68881) ◎ BT454 ◎ CRTC2 ○ 標準で使用する値のみサポート @@ -1576,9 +1707,9 @@ MPU (88110) — 実装予定なし N FUSEROM ○ X68030 -MPU (68030) ○ データキャッシュ未実装 Data cache not implemented -MPU (68EC030) — 実装予定なし Not planned +MPU (68030) ◎ 68EC030 は実装予定なし 68EC030 is not planned FPU (68881) ◎ 68882 は未実装 68882 not implemented +MPU (68040) △ キャッシュ未実装、実行サイクル未考察 DMAC △ CRTC/VC △ 768x512 のテキスト画面のみサポート Only 768x512 text screen supported FDC/FDD ○ @@ -1606,7 +1737,7 @@ Nereid USB — 実装予定なし N Windrv △ NWS-1750 -MPU (68030) ○ データキャッシュ未実装 Data cache not implemented +MPU (68030) ◎ FPU (68881) ◎ 68882 は未実装 68882 not implemented PROM × SCC (Z8530) ◎ チャンネル A のみホストに接続 Only channel A is connected to the host @@ -1619,16 +1750,19 @@ IDROM, DIP-SW, 100Hz Timer, 診断用LED AST, Lv2Intr × 電源 Power Circuit × -virt68k -MPU (68030) ○ データキャッシュ未実装 Data cache not implemented +virt-m68k +MPU (68030) ◎ FPU (68881) ◎ 68882 は未実装 68882 not implemented -Goldfish PIC -Goldfish RTC -Goldfish Timer -Goldfish TTY -virtio v1.0 block -virtio v1.0 net -Power Control +MPU (68040) △ キャッシュ未実装、実行サイクル未考察 +Goldfish PIC ◎ +Goldfish RTC ◎ +Goldfish Timer ◎ +Goldfish TTY ○ +VirtIO Block ○ +VirtIO Network ○ +VirtIO Entropy ◎ +VirtIO SCSI +Power Control ○ __EOM__; $table_lines = preg_split("/\n/", $table); @@ -1655,10 +1789,31 @@ __EOM__;
    -68030 は命令キャッシュのみ実装し、データキャッシュは未実装です。 -また ATC (アドレス変換キャッシュ) は実際の仕様とは異なり高速化してあります。 -68030 instruction cache is implemented but data cache is not. -ATC (Address Translation Cache) is differ from and faster than the real 68030. +68030 ATC (アドレス変換キャッシュ) は実際の仕様とは異なり高速化してあります。 +68030 ATC (Address Translation Cache) is differ from and faster than the real 68030. +
    + + + +
    +いくつか未実装の命令があります。 +キャッシュは未実装で、 +それに伴いキャッシュ制御を行う新設命令 CINV*, CPUSH* も未実装です。 +MMU、ATC はまだ怪しいです。 +FPU はある程度動作すると思いますが +例外を起こす細かい条件は未検証のため、 +本来は例外が起きてソフトウェア (FPSP) で処理するはずのものが +68881 相当のハードウェアエミュレーションで実行出来てしまうという +通常あまり困らないタイプの問題は存分にあります。 +
    + +命令の実行サイクルについてはある程度似せているつもりですが、 +そもそも 68040 はパイプライン方式なので 68000 時代のようにサイクル数を +正確にエミュレーションすることはおそらく不可能です。 +
    +68040 は X68030 と virt-m68k でのみ選択可能です。 +NEWS に 68040 搭載モデルはなさそうなのと、 +LUNA では 68040 搭載モデルは LUNA-I ではなく LUNA-II になるからです。
    @@ -1697,26 +1852,35 @@ PROM も NetBSD/news68k -virt68k エミュレーション"); ?> +
    - QEMU の "virt" (架空ハードウェア仕様)の互換機wをサポートしています。 NetBSD/virt68k が動作します。 -X オプション (または設定の exec-file) -でカーネルを指定してください。 +でカーネルを、 +設定の exec-bootparam でルートデバイスを +それぞれ指定してください。 インストール時には --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. - +--initrd option (or exec-initrd in configuration). +
    + + + +
    +virt-m68k (や NEWS) のようにシリアルコンソールしか持たない機種のために、 +メイン画面でシリアルコンソールの端末エミュレーションを実装してあります。 +hostcom-driver = cons とすることで nono のメイン画面に +シリアルコンソールの内容が表示されます。 +カラーは現状サポートしていませんが、 +ボールド、イタリック、下線などはある程度サポートしています。 +バックログはありませんので、バックログが必要なら +stdio 等を使ってください。
    @@ -1782,11 +1946,60 @@ Also, SW8 specifies enable/disable of th + +
    +usermode ネットワークでは nono 自身が +NAT ルータ、DHCP サーバ、DNS サーバの機能を持ちます。 +ルータと DHCP サーバのアドレスはネットワークアドレス +1 (デフォルトでは 10.8.0.1)、 +DNS サーバのアドレスはネットワークアドレス +2 (デフォルトでは 10.8.0.2) です。 +IPv6 ルータのアドレスはネットワークアドレス +1 (デフォルトでは fd08::1)、 +DNS サーバのアドレスはネットワークアドレス +2 (デフォルトでは fd08::2) です。 +
    + + +Time Synchronization on NetBSD/x68k
    "); ?> +
    + +X68030 でゲスト OS に NetBSD/x68k を使う場合、 +nono と NetBSD/x68k を次の通りに設定すれば +nono をフルスピード動作にしてもゲスト OS の時間がずれなくなります。 +まず nono の設定ファイルに以下を追加します。 +
    +clock-sync = real
    +
    +ゲストの NetBSD/x68k を起動し、 +/etc/sysctl.conf に以下の1行を追加します。 +
    +kern.timecounter.hardware=clockinterrupt
    +
    +さらに /etc/rc.conf に +
    +ntpdate=YES
    +ntpdate_hosts=ntp.nict.jp
    +
    +などと設定します (NTP サーバはお好みで)。 +sysctl の設定によって、ゲスト OS の時計は「この設定が有効になった時点から」 +実時間間隔を刻めますが、 +電源オンからここまでにずれた分が解決できるわけではありませんので、 +必然的に時計を合わせる必要もあるためです。 +これで再起動すると次回からはフルスピードでも実時間を刻めます。 +(再起動せずに有効にしたい場合はこの設定の後 root ユーザで +
    +/etc/rc.d/sysctl start
    +/etc/rc.d/ntpdate start
    +
    +を実行してください) +
    +
    + +
    -Windrv を一応サポートしてみました。 +X68030 で Windrv を一応サポートしています。 Human68k からホストのファイルシステムをアクセスする機構です。 -既存の Windrv とは、ホスト OS の前提が異なるため既存実装からの移植ではありませんし、 +従来の Windrv とはホスト OS の前提が異なるため、 +既存実装からの移植ではありませんし、 そもそも Human68k とホスト(UNIX)ファイルシステムの差異による制約も多くあります。 これらを把握してから使用してください。
      @@ -1800,8 +2013,9 @@ Human68k からホストのファイル 大文字小文字だけが違う同名のファイル (例えば a.BAK と a.bak) があると、 検索(FILES/NFILES) には現れません。 この状況で a.Bak (大文字小文字を区別していれば違うファイル) -を新規作成しようとすると (大文字小文字を区別しない a.Bak -というエントリはゲスト的には存在しないにも関わらず) 作成できなくしてあります。 +を新規作成しようとすると (大文字小文字を区別しないゲスト OS からは +a.Bak というエントリは存在しないように見えるにも関わらず) +作成できなくしてあります。
    • ファイルサイズが 2GB 以上のファイルはゲストからは見えません。
    • Human68k 側の属性は A(アーカイブ)/D(ディレクトリ)/R(読み込み専用) のみ対応しています。 @@ -1898,7 +2112,7 @@ PIO(8255) がラッチするのが概ね 逆アセンブルは、 LUNA-I なら m68k と HD64180 の逆アセンブルが、 LUNA-88K なら m88k と HD64180 の逆アセンブルが、 -X68030/virt68k/NEWS なら m68k の逆アセンブルが選択できます。 +X68030/virt-m68k/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). @@ -1907,7 +2121,7 @@ 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/virt68k/NEWS, +On X68030/virt-m68k/NEWS, you can choose m68k disassemble.

      表示されているダンプ値をダブルクリックすることでメモリの値を編集できます。 @@ -2349,16 +2563,11 @@ extract it and place it in the VM direct

    • 以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/luna/ に作成します。 -ここでは説明を簡単にするためネットワークなしにしていますが、 -ネットワーク設定は必要に応じて行ってください。 Create a configuration file nono.cfg in the VM directory, ~/nono/luna/, -with following contents. -By the way, to simplify the explanation, we assume there is no network here. -However, please configure the network if necessary. +with following contents.
       vmtype = luna
       spc0-id6-image = hd,liveimage-luna68k-with-packages-20210910.img
      -hostnet-driver = none
       
    • nono -c ~/nono/luna で起動します @@ -2429,11 +2638,11 @@ and nono will terminate when the VM is p Try OpenBSD/luna88k"); ?>
      -あおやまさんが OpenBSD/luna88k 7.4 の liveimage を用意されています。 -Aoyama-san has provided a liveimage of OpenBSD/luna88k 7.4. +あおやまさんが OpenBSD/luna88k 7.6 の liveimage を用意されています。 +Aoyama-san has provided a liveimage of OpenBSD/luna88k 7.6.
      -
      https://bsd.network/@ao_kenji/111250570715336091 +
      https://bsd.network/@ao_kenji/113300210182705408
      ここではこれを起動してみます。Let's try it.
      @@ -2444,10 +2653,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-20231016.img.gz +
    • 以下のリンクから liveimage-luna88k-raw-20241013.img.gz をダウンロードして展開し、 VM ディレクトリ ~/nono/luna88k/ に置きます。 -Download liveimage-luna88k-raw-20231016.img.gz from the following link, +Download liveimage-luna88k-raw-20241013.img.gz from the following link, extract it and place it in the VM directory, ~/nono/luna88k/.
      以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/luna88k/ に作成します。 -ここでは説明を簡単にするためネットワークなしにしていますが、 -ネットワーク設定は必要に応じて行ってください。 Create a configuration file nono.cfg in the VM directory, ~/nono/luna88k/, -with following contents. -By the way, to simplify the explanation, we assume there is no network here. -However, please configure the network if necessary. +with following contents.
       vmtype = luna88k
      -spc0-id6-image = hd,liveimage-luna88k-raw-20231016.img
      -hostnet-driver = none
      +spc0-id6-image = hd,liveimage-luna88k-raw-20241013.img
       
    • nono -c ~/nono/luna88k で起動します @@ -2513,9 +2717,9 @@ and nono will terminate when the VM is p Try NetBSD/x68k"); ?>
      -つついさんが NetBSD/x68k 10.0_BETA の liveimage を用意されています。 +つついさんが NetBSD/x68k 10.1 の liveimage を用意されています。 ここではこれを起動してみます。 -Tsutsui-san has provided a liveimage of NetBSD/x68k 10.0_BETA. +Tsutsui-san has provided a liveimage of NetBSD/x68k 10.1. Let's try it.
        @@ -2525,29 +2729,27 @@ Let's try it. and create subdirectories for individual VMs in it (for example ~/nono/x68k/). -
      1. 以下のリンクから -plain-install か with-packages のお好みのほうをダウンロードして展開し、 -VM ディレクトリ ~/nono/x68k/ に置きます。 -Download your favorite one of plain-install or with-packages -from the following link, -extract it and place it in the VM directory, ~/nono/x68k/. +
      2. 以下のサイトから +「パッケージインストール設定済み版」か +「インストーラでインストールしたところまでの未設定版」の +お好みのほうをダウンロードします。 +迷ったら「パッケージインストール設定済み版」がよいでしょう。 +ダウンロードできたら展開して、VM ディレクトリ ~/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://teokurebsd.org/netbsd/liveimage/20230111-x68k/ +http://www.ceres.dti.ne.jp/tsutsui/netbsd/liveimage/x68k.html
      3. 以下の内容の設定ファイル 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. +with following contents.
         vmtype = x68030
        -spc0-id0-image = hd,liveimage-x68k-with-packages-20230111.hds
        -hostnet0-driver = none
        +spc0-id0-image = hd,liveimage-x68k-with-packages-20250106.hds
         
      4. 初回のみ nono -c ~/nono/x68k --create-sram を実行します。 @@ -2568,7 +2770,7 @@ nono のせいではありません(>_<) 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 an accident which is far from the ideal +It's very sad to me that the accident which is far from the ideal is the first experiences of newcomers.
      5. NetBSD が起動した後なら (正確には powerd(8) が起動していれば)、 @@ -2584,20 +2786,34 @@ and nono will terminate when the VM is p -NetBSD/virt68k をインストールしてみる" - . " Try installing NetBSD/virt68k"); ?> +Try installing NetBSD/virt68k"); ?>
        - ここでは NetBSD/virt68k をクリーンインストールする手順だけ紹介します。 -Here I will introduce how to install NetBSD/virt68k. +Here I will introduce how to install NetBSD/virt68k cleanly.
        -
          +
            +
          1. どこかに 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/). +
          2. 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 using build.sh. :( + +
          3. インストーラを起動するカーネルとその後運用するカーネルは同じものなので +VM ディレクトリ内に持ってきておくとよいです。 +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. +
            +cp <path>/release/virt68k/binary/kernel/netbsd-GENERIC.gz ~/nono/virt68k/
            +
            +
          4. 空のディスクイメージを用意します。 1GB でもインストール自体は出来ますが、もう少し大きいほうが安心です。 Prepare an empty disk image file. @@ -2609,46 +2825,48 @@ dd if=/dev/zero of=virt68k.img bs=1m cou
          5. 以下の内容の設定ファイル 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. +with following contents.
            -vmtype = virt68k
            +vmtype = virt-m68k
            +exec-file = netbsd-GENERIC.gz
            +exec-bootparam = root=ld0
             virtio-block0-image = virt68k.img
            -hostcom-driver = stdio
            -hostnet-driver = auto
            +fast-mode = 1
             
            -
          6. 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. :( - -
          7. 以下のコマンドラインで起動します。 -Run as the following: +
          8. インストーラ RAM ディスクを指定してインストーラを起動します。 +設定ファイルでルートデバイスを ld0 に指定していますが、 +RAM ディスク指定のほうが優先されるようです。 +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 -f \
            - -X <path>/release/virt68k/binary/kernel/netbsd-GENERIC.gz \
            +nono -c ~/nono/virt68k \
              --initrd <path>/release/virt68k/installation/ramdisks/inst-ramdisk.fs
             
            -
          9. しばらくすると 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. +
          10. しばらくすると見慣れたインストーラが起動してきます。 +インストールが終わったらトップメニューから e:Utility menu > +g:Halt the system +を選択してください。ゲストの電源がオフになり nono も終了します。 +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. + +
          11. インストールしたディスクから起動するには、 +--initrd オプションを外して実行します。 +カーネルは引き続きホストファイルシステム上にあるもの +(ここでは ~/nono/virt68k/netbsd-GENERIC.gz) を使います。 +To boot from the installed disk, +run without --initrd option. +It still uses the kernel on the host filesystem, +just like the installer does.
            -[   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
            - :
            +nono -c ~/nono/virt68k
             
            - +
    @@ -2656,16 +2874,14 @@ After a while again, the familiar instal Example of host network setup
    "); ?> +
    -wm0 を持つ NetBSD ホストに tap(4) デバイスを用いて -nono のゲスト OS を接続する場合の設定例です。 +NetBSD の tap(4) デバイスを用いて、 +ホストの wm0 と nono のゲスト OS を接続する場合の設定例です。
    1. -設定ファイル nono.cfg に以下の行を追加します -(と言いつつ NetBSD では書かなくてもデフォルトでこの動作になりますが) -Add the following line to configuration file, nono.cfg. -(Although you don't need to write it since these are default behavior -on NetBSD) +設定ファイル nono.cfg に以下の行を追加します。 +Add the following line to configuration file, nono.cfg.
       hostnet-driver = tap
       hostnet-tap-devpath = auto
      @@ -2744,6 +2960,7 @@ It's OK if you can see "HostNet Driver:
       
       
    + @@ -2764,10 +2981,19 @@ the mouse pointer will not move as expec (2021/12/30)
  • Wayland の場合にウィンドウサイズが正しく設定されない場合があります。 -wxWidgets (3.0.5) のバグと思われます。 +wxWidgets (3.0/3.2) のバグと思われます。 On Wayland, window size may be incorrect. -This may be due to wxWidgets (3.0.5) bug. -(2021/12/30) +This may be due to wxWidgets (3.0/3.2) bug. +(2021/12/30, Updated 2024/07/03) + +
  • nono ではありませんが、wxWidgets 3.2 (with GTK3) は +NetBSD/sparc (などマイナーアーキテクチャ?) +でウィンドウ内がほぼ描画されないようです。 +wxWidgets 3.0 (with GTK2) であれば動作します。 +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) @@ -2790,15 +3016,18 @@ In such case, you may need to upgrade it +Included Software"); ?> +
    +
      +
    • +
    +
    + + + Changes"); ?>
    -See changes.html. -changes.php)\n"; - } -?> +See .