--- nono/doc/index.php 2026/04/29 17:05:15 1.1.1.14 +++ nono/doc/index.php 2026/04/29 17:05:47 1.1.1.22 @@ -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) のエミュレータです。 -nono is OMRON LUNA-I/LUNA-88K (and SHARP X68030) emulator -runs on NetBSD and etc. +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.
@@ -103,70 +86,89 @@ runs on NetBSD and etc.
  • 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 - 13.0 works at least.) -
  • wxWidgets 3.0.x "stable" branch -or 3.2.x "new 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/wxGTK30 (OPTIONS:gtk3 で動作確認) です。 -2022Q3 の wxGTK32 ではビルドできないようです。 +NetBSD(pkgsrc) なら必要なパッケージは +x11/wxGTK32 と net/libslirp です。 +wxGTK32 の代わりに wxGTK30 でも動くはずです。 If you use NetBSD(pkgsrc), -wxWidgets is pkgsrc/x11/wxGTK30 (OPTIONS:gtk3 is tested). -wxGTK32 in 2022Q3 doesn't seem to build for now. +x11/wxGTK32 and net/libslirp are needed. +wxGTK30 would also work.

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

    - +

    nono のソースアーカイブを展開したら以下のようにビルドします。 -configure には環境変数 CC、CXX でコンパイラを指定することが出来ます。 -また wx-config が標準的な名前で提供されていないために見付けられない場合には -環境変数 WX_CONFIG にパスを指定することが出来ます。 -Extract the nono's source archive and build as following. -You can specify C/C++ compiler using environment variable CC and CXX -if configure cannot find standard name suitable compiler. -Also, you can specify wx-config path using environment variable WX_CONFIG -if configure cannot find wx-config. -

    --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. + +

    +

    +

    +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. - +

    @@ -175,20 +177,9 @@ the command line executable.
    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.
    @@ -233,26 +224,27 @@ If -c option is omitted, _EOM_ ); -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 と等価です。 +設定の 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. +This option is equivalent to fast-mode=1 in configuration. +_EOM_ +); + +option_item("--fd0 file
    --fd1 file", <<<_EOM_ +(X68030 Only) フロッピーイメージを指定します。 +file が相対パスの場合カレントディレクトリからのパスになります。 +設定の fd0-image、fd1-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_ ); @@ -260,27 +252,36 @@ option_item("--fontsize height", GUI 版のみ。 全サブウインドウの起動時のフォントサイズを指定します。 起動後にメニューから変更できます。 -設定の monitor-fontsize と等価です。 +設定の 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. +This option is equivalent to monitor-fontsize in configuration. +_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 版のみ。 メインウィンドウの起動時のスケールを実数で指定します。 - 設定の mainview-scale と等価です。 起動後はメニューからプリセットされた倍率と -mainview-scale で指定された倍率には変更可能です。 +mainview-scale で指定された倍率には変更可能です。 GUI Only. Specifies the initial main window scale in real number. - -This is equivalent to mainview-scale in configuration. +This is equivalent to mainview-scale in configuration. You can change this scale on GUI menu after boot. _EOM_ ); @@ -311,6 +312,7 @@ _EOM_ option_item("-X file", <<<_EOM_ ホストの file をロードして実行します。 file が相対パスの場合カレントディレクトリからのパスになります。 +設定の exec-file とは相対パスの起点の違いを除いて同一です。 ファイルが gzip 圧縮されていれば自動的に展開します。 (展開後の) ファイル形式は以下の通りですが、 実際にはブートローダとカーネル程度しか想定していません。 @@ -318,6 +320,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. 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. @@ -335,20 +339,29 @@ 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、luna-dipsw1 の内容(後述)によらず -内蔵の互換 PROM で起動し、直ちにホストファイルを実行します。 +LUNA では設定の prom-image (後述) によらず内蔵の互換 ROM で起動します。 +luna-dipsw1 の DIPSW 設定が +dipsw-autoboot=yes 相当の状態ならそのまま直ちにホストファイルを実行し、 +そうでなければ互換 ROM のプロンプトで停止します。 +後者の場合でも LUNA-I なら "g" コマンド、LUNA-88K なら "b" コマンドによる +ロードはここで指定したホストファイルをロードします。 X68030 では、IPLROM 起動の後の起動デバイスに細工がしてあり、 そこからホストファイルを実行します。 - -On LUNA, -regardless of prom-image and luna-dipsw1 configuration -(see below), -the internal emulated PROM loads and executes the host file immediately. +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, +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 virt-m68k (and NEWS), this is the only way to boot. _EOM_ ); ?> @@ -364,11 +377,22 @@ function option_dev($name, $desc) print "
    {$desc}
    \n"; } -option_dev("-b hexaddr[,skipcount]", <<<_EOM_ +option_dev("-b,--b hexaddr[,skipcount]", <<<_EOM_ デバッガのブレークポイントを 16進数で指定します。 _EOM_ ); +option_dev("--bi inst[:mask][,skipcount]", +<<<_EOM_ +デバッガの命令ブレークポイントを指定します。 +_EOM_ +); + +option_dev("--bv vector[,skipcount]", <<<_EOM_ +デバッガの例外ブレークポイントを指定します。 +_EOM_ +); + option_dev("-C", <<<_EOM_ ログをコンソールにも出力します。 通常はログウィンドウにだけ出力されます。 @@ -387,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_ ログレベルを指定します。 @@ -395,11 +422,6 @@ option_dev("-L name1=level1file", <<<_EOM_ --X オプションと同様ですが、PROM のプロンプトで停止します。 -_EOM_ -); - option_dev("-M name[,name2,...]", <<<_EOM_ 起動時に表示するモニタウィンドウを指定します。 カンマで区切って複数指定することも出来ます。 @@ -417,11 +439,9 @@ _EOM_ Configuration"); ?>
    - nono の設定はいずれも以下の順序で適用されます。 nono's configurations are always applied in the following order. - -
      +
      1. デフォルト値 Default value
      2. ~/.nono.cfg があればその内容 Contents of ~/.nono.cfg if exists @@ -430,7 +450,6 @@ nono の設定はいずれも以下の Contents of nono.cfg in the VM directory (or the file specified by -c option) if exists
      3. コマンドラインオプション Command line option
      - ファイルの書式はどちらも key = value 形式で1行1項目ずつです。 key と value の前後の空白は取り除かれます。 また空行と "#" で始まる行は無視します。 @@ -450,18 +469,15 @@ 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. -

      - 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. -

      設定項目は次の通りです。 The configuration items are: @@ -478,10 +494,11 @@ VM 種別を以下のいずれかから Specifies the VM type from the following. This field is mandatory. -
       luna … LUNA-I -
      luna88k … LUNA-88K -
      x68030 … X68030 (Experimental) -
      news … NWS-1750 (Just a joke) +
       luna  … LUNA-I +
      luna88k  … LUNA-88K +
      x68030  … X68030 +
      news  … NWS-1750 (Just a joke) +
      virt-m68k (or virt68k)  … virt-m68k
      _EOM_ ); @@ -508,14 +525,37 @@ _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_ ); @@ -591,45 +631,76 @@ and NWB-512 monochrome console (not impl _EOM_ ); -config_item("ethernet-macaddr = string", <<<_EOM_ -(LUNA and NEWS only) -イーサネットデバイスの仮想マシン側の MAC アドレスを指定します。 +config_item( + "ethernet-macaddr = string
      " . + "ethernetN-macaddr = string
      ", +<<<_EOM_ +N +番目のイーサネットデバイスの仮想マシン側の MAC アドレスを指定します。 XX:XX:XX:XX:XX:XX 形式で指定します。 auto なら自動的に決定します。 デフォルトは auto です。 +ethernet-macaddr は ethernet0-macaddr の別名です。 _EOM_ ); -config_item("extram-size = integer", <<<_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-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. -
        +
        • 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. +
      _EOM_ ); -config_item("fast-mode = integer", <<<_EOM_ - +config_item("fast-mode = integer", <<<_EOM_ 起動時の動作モードを指定します。0 なら通常モード、1 なら高速モードです。 デフォルトは 0 です。 コマンドラインオプション -f でも高速モードへのみ指定可能です。 - _EOM_ ); @@ -656,18 +727,20 @@ _EOM_ ); config_item("fpu-type = value", <<<_EOM_ -(X68030 Only) -FPU を装着するかどうか指定しています。 -none なら FPU を装着しません。 -68881 なら FPU として 68881 を装着します。 +(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 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. @@ -677,42 +750,129 @@ because (probably) all LUNA-I has 68881. _EOM_ ); -config_item("hostcom-driver = string", <<<_EOM_ -シリアルポートのホスト側ドライバを指定します。 -stdio、tcp、none が選択可能です。 -stdio は標準入出力を使用します。 -tcp は TCP ポートで TELNET プロトコルで待ち受けます。 +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
      " . + "hostcom-tcp-port = integer
      " . + "hostcom-fallback = integer", <<<_EOM_ +それぞれ hostcom0-* の別名です。 +These are aliases for hostcom0-* respectively. +_EOM_ +); + +config_item("hostcomN-driver = string", <<<_EOM_ +起動時のシリアルポート N のホスト側ドライバを指定します。 +stdio なら標準入出力を使用します。 +tcp なら TCP ポートで TELNET プロトコルで待ち受けます。 +console (または cons) +ならメイン画面で端末エミュレーションを行います。 none ならホスト側とは一切通信を行いません。 -デフォルトは none です。 -Specifies the host driver of serial port. -stdio, tcp, and none can be specified. +Specifies the host driver of serial port N on startup. 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. +console (or cons) does a terminal emulation in main panel. +none doesn't make any communication with the host. +

      +hostcomN と +VM 内のデバイス(ポート)との対応は下表の通り VM 種別ごとに固定です。 +The correspondence between hostcomN and +device (port) in the VM is fixed depending on the VM type +as the following table. +

      + +
      hostcom＼VMLUNA-I/LUNA-88KX68030NWS-1750virt-m68k +
      hostcom0 + SIO(uPD7201) Ch.A + SCC(Z8530) Ch.A + SCC(Z8530) Ch.A + Goldfish TTY +
      hostcom1 + HD647180 ASCI Ch.0 + N/A + N/A + N/A +
      hostcom2 + HD647180 ASCI Ch.1 + N/A + N/A + N/A +
      +
      +

      +また、VM 種別によって有効なホスト側ドライバの種類とデフォルト値も異なります。 +The choices and default value vary depending on the VM type. +

      + +
      VMLUNA-I/LUNA-88KX68030NWS-1750virt-m68k +
      有効なドライバ
      Available drivers +       		stdio
      tcp
      none
      +       		stdio
      tcp
      none
      +       		stdio
      tcp
      console
      none +       		stdio
      tcp
      console
      none +
      hostcom0-driver のデフォルト値
      Default value +       		none + none + console + console +
      hostcom[12]-driver のデフォルト値
      Default value +       		none + N/A + N/A + N/A +
      +
      +

      +指定したドライバが使用出来なかった場合エラー終了します。 +起動後はメニューからドライバを変更できますが、パラメータは(まだ?)変更できません。 +実行中に変更に失敗した場合は none にフォールバックします。 +Terminate if the specified driver could not be used. +You can change the driver by menu at runtime, +but its parameters cannot be changed (yet?). +If changing at runtime fails, it will fallback to none. _EOM_ ); -config_item("hostcom-tcp-port = integer", <<<_EOM_ +config_item("hostcomN-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) +(LUNA and X68030 Only) ホストキーボードの入力モードを指定します。 char ならキャラクタ入力モード、 jp なら日本語キーボードモードです。 @@ -726,35 +886,87 @@ See About VM for _EOM_ ); -config_item("hostnet-driver = string", <<<_EOM_ -(LUNA and NEWS Only) -イーサネットデバイスのホスト側ドライバを指定します。 -afpacket、bpf、tap のうち -ホスト OS がサポートしているものと auto、none が選択可能です。 -afpacket は Linux の AF_PACKET ソケットを使用します。 -bpf は bpf(4) デバイスを使用します。 -tap は tap(4) インタフェースを使用します。 -none ならホスト側とは一切通信を行いません。 -auto ならホスト OS がサポートしているもののうち -tap → afpacket → bpf を順に試します。 -デフォルトは auto です。 -Specifies the host driver of ethernet device. -afpacket, bpf, and tap can be specified -only if the host OS supports them. -auto and none can always be specified. -afpacket uses Linux's AF_PACKET socket, -bpf uses bpf(4) device, -and tap uses tap(4) interface. -none doesn't make any communication with the host. -If auto is specified, -it tries tap, afpacket, and bpf in that order -(if the host OS supports them). -The default is auto. +config_item( + "hostnet-driver = string
      " . + "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-* の別名です。 +These are aliases for hostnet0-* respectively. _EOM_ ); -config_item("hostnet-afpacket-ifname = ifname", <<<_EOM_ -(LUNA and NEWS Only) +config_item("hostnetN-driver = string", <<<_EOM_ +起動時の N +番目のイーサネットデバイスのホスト側ドライバを指定します。 +afpacket、bpf、tap、usermode のうち +configure で検出したものと auto、none が選択可能です。 +Specifies the host driver of N-th ethernet device on startup. +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. +
      +auto は usermode と同義ですが、 +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. +

      +hostnetN と +VM 内のデバイスとの対応は下表の通り VM 種別ごとに固定です。 +The correspondence between hostnetN and +device in the VM is fixed depending on the VM type as the following table. +

      + +
      hostnet＼VMLUNA-I/LUNA-88KX68030NWS-1750virt-m68k +
      hostnet0 + Lance(AM7990) + Nereid#0 (RTL8019AS) + Lance(AM7990) + VirtIO Network +
      hostnet1 + N/A + Nereid#1 (RTL8019AS) + N/A + N/A +
      +
      +

      +指定したドライバが使用出来なかった場合エラー終了します。 +起動後はメニューからドライバを変更できますが、パラメータは(まだ?)変更できません。 +実行中に変更に失敗した場合は none にフォールバックします。 +Terminate if the specified driver could not be used. +You can change the driver by menu at runtime, +but its parameters cannot be changed (yet?). +If changing at runtime fails, it will fallback to none. +_EOM_ +); + +config_item("hostnetN-afpacket-ifname = ifname", <<<_EOM_ ホストドライバが afpacket の時にバインドするインタフェースを1つ指定します。 ifname が auto なら使用可能なインタフェースを1つ自動的に選択します。 @@ -768,8 +980,7 @@ Note that this host driver cannot commun _EOM_ ); -config_item("hostnet-bpf-ifname = ifname", <<<_EOM_ -(LUNA and NEWS Only) +config_item("hostnetN-bpf-ifname = ifname", <<<_EOM_ ホストドライバが bpf の時にバインドするインタフェースを1つ指定します。 ifname が auto なら使用可能なインタフェースを1つ自動的に選択します。 @@ -783,8 +994,7 @@ Note that this host driver cannot commun _EOM_ ); -config_item("hostnet-tap-devpath = path", <<<_EOM_ -(LUNA and NEWS Only) +config_item("hostnetN-tap-devpath = path", <<<_EOM_ ホストドライバが tap の時に使用するデバイスを1つフルパスで指定します。 デフォルトは auto で、この場合は自動的にデバイスを選択します。 この時の探し方はホスト OS によって異なります。 @@ -815,17 +1025,41 @@ you need to prepare empty scripts that w _EOM_ ); -config_item("hostnet-fallback = integer", <<<_EOM_ -(LUNA and NEWS Only) -hostnet-driver で指定したドライバが使用可能でなかった時、 -0 ならプロセスを終了します。 -1 なら none を選択して実行を継続します。 -デフォルトは 0 です。 -Specifies the behavior when the driver which is selected by -hostnet-driver is unusable; -terminate the process if 0, -or continue to run using the none driver if 1. -The default is 0. +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つで区切って表します。 +protocol は tcp か udp です。 +hostaddr はホストのバインドアドレスで省略すると 0.0.0.0 です。 +guestaddr はゲストのアドレスで、 +省略すると DHCP でクライアントに配布したアドレスになります +(通常は省略します)。 +例えば、ホストの 10022/tcp へのコネクションをゲストの 22/tcp に転送したい場合は +tcp,10022,22 となります。 +複数指定する場合は ';'(セミコロン) で区切って1行に並べます。 +

      +IPv6 には対応していません。 _EOM_ ); @@ -978,55 +1212,79 @@ LUNA のビデオボードのプレー 1 ならモノクロビデオボード、 4 なら16色 (4bpp) ビデオボード、 8 なら 256色 (8bpp) ビデオボードです。 -デフォルトは 4 です。 +デフォルトは 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. +The default value is 4. _EOM_ ); -config_item("mainview-scale = double", <<<_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 です。       +デフォルトは 1.0 です。 _EOM_ ); -config_item("monitor-fontsize = integer", +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. +from preset rate or rate specified here. _EOM_ ); config_item("mpu-clock = value", <<<_EOM_ MPU のクロック数を MHz 単位で指定します。 デフォルトは 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. +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_ ); @@ -1046,6 +1304,67 @@ m88100 には、m68k の STOP 命令 ( _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 の内容を指定します。 @@ -1121,26 +1440,40 @@ config_item("ram-size = integer",

      • 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 を参照してください。 +拡張メモリについては extram-size を参照してください。 On X68030, the default is 12MB. You can specify it in 1MB unit from 4MB to 12MB. -See extram-size for extended memory. +See extram-size for extended memory.
      • NWS-1750 では現状 16MB で変更できません。 On NWS-1750, This is 16MB fixed for now. +
      • virt-m68k のデフォルトは 128MB です。 +16MB から 4080MB まで指定可能です。 +指定された値が 16MB で割り切れない場合は 16MB 単位に切り上げになります。 +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.
      _EOM_ ); @@ -1181,8 +1514,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). @@ -1197,8 +1529,7 @@ the disk image path path separate devtype が hd なら path は省略できません。 devtype が cd か mo なら 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. @@ -1268,17 +1599,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 サイズに合わせるかどうかを指定します。 @@ -1299,28 +1619,82 @@ The default is 1. _EOM_ ); -config_item("xxx-news-sic-ignore = integer", -<<<_EOM_ -(NEWS Only) -未実装の SCSI コントローラおよび DMA -コントローラ領域へのアクセスを無視するか指定します。 -現状 (2022/08)、NetBSD/m68k はこの領域へのバスエラーを処理できず、 -uvm_fault のパニックを起こしてしまいます。 -1 にするととりあえず si(4) へのアクセスが不調に終わって -(他に問題がなければ) NetBSD/news68k が起動できます。 -デフォルトは 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. +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_ +); + + ?>
    @@ -1362,7 +1736,7 @@ _EOM_ Cache not implemented +MPU (68030) ◎ FPU (68881) ◎ BT454 ◎ CRTC2 ○ 標準で使用する値のみサポート @@ -1370,15 +1744,16 @@ Frame buffer ◎ Keyboard/Mouse ◎ SIO (uPD7201) ◎ PIO (8255) ○ -Ethernet (AM7990) ◎ LARF を除く Except LARF +Ethernet (AM7990) ◎ NVRAM&RTC (MK48T02) ◎ Front LCD ◎ SPC (MB89352) ◎ SCSI HD/CD/MO Devices ○ -XP(HD647180) CPU △ -XP(HD647180) Timer0/1 ○ -XP(HD647180) その他の内蔵デバイス
    Other internal devices     × -XP 周辺デバイス Peripheral devices × +XP(HD647180) CPU △ +XP(HD647180) Timer0/1 ○ +XP(HD647180) ASCI ○ +XP(HD647180) その他の内蔵デバイス
    Other internal devices × +XP 周辺デバイス Peripheral devices × 電源 Power Circuit ○ LUNA-88K specific @@ -1388,15 +1763,17 @@ MPU (88110) — 実装予定なし N FUSEROM ○ X68030 -MPU (68030) ○ キャッシュ未実装、ファンクションコード未実装 Cache and FC not implemented -MPU (68EC030) — 実装予定なし Not planned +MPU (68030) ◎ 68EC030 は実装予定なし 68EC030 is not planned FPU (68881) ◎ 68882 は未実装 68882 not implemented -DMAC ○ -CRTC/VC △ 768x512 のテキスト画面のみサポート Only 768x512 text screen supported +MPU (68040) △ キャッシュ未実装、実行サイクル未考察 +DMAC △ +CRTC/VC △ 768x512 画面モードのみサポート Only 768x512 screen mode is supported FDC/FDD ○ -標準・拡張エリアセット Areaset × +標準・拡張エリアセット Areaset ◎ ADPCM/OPM × -グラフィック機能全般 All other graphics × 当面予定なし Not scheduled +テキスト画面Text screen ○ +コントラスト Contrast ◎ +グラフィック機能全般 All other graphics △ グラフィック画面(1024x1024 モード)、画面間プライオリティ(合成を除く)、個別画面オンオフのみ実装。これ以外は当面予定なし。 Keyboard ◎ TVコントロールを除く Except TV Control Mouse ◎ 本体接続のみ MFP △ @@ -1408,19 +1785,19 @@ SCSI HD/CD/MO Devices ○ SCC (Z8530) ◎ SRAM ◎ システムポートSystem port △ -テキスト画面Text screen ○ 電源 Power curcuit ○ -Nereid Ethernet × -Nereid Bank memory × +Nereid Ethernet ◎ +Nereid Bank memory ◎ Nereid USB — 実装予定なし Not planned -拡張メモリ Extended memory ○ +拡張メモリ Extended memory ○ +Windrv △ NWS-1750 -MPU (68030) ○ キャッシュ未実装 Cache not implemented +MPU (68030) ◎ FPU (68881) ◎ 68882 は未実装 68882 not implemented PROM × SCC (Z8530) ◎ チャンネル A のみホストに接続 Only channel A is connected to the host -Ethernet (AM7990) ◎ LARF を除く Except LARF +Ethernet (AM7990) ◎ NVRAM&RTC (MK48T02) ◎ Video Board × Keyboard/Mouse × @@ -1429,17 +1806,33 @@ IDROM, DIP-SW, 100Hz Timer, 診断用LED AST, Lv2Intr × 電源 Power Circuit × +virt-m68k +MPU (68030) ◎ +FPU (68881) ◎ 68882 は未実装 68882 not implemented +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); foreach ($table_lines as $line) { if ($line == "") { continue; - } else if (preg_match("/\t/", $line) == false) { + } else if (preg_match("/\t/", $line) == 0) { // table title - print "{$br}{$line}\n"; - $br = ""; + print "{$line}\n"; } else { - list ($h, $m, $d) = preg_split("/\t+/", $line, 3); + $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"; @@ -1452,13 +1845,30 @@ __EOM__;
    -68030 はキャッシュが未実装です。 -これに伴い命令の所要クロック数もまだ正しくなく、 -そのためクロック測定などでは正確な値が出ません。 -また ATC (アドレス変換キャッシュ) は実際の仕様とは異なり高速化してあります。 -68030 cache is not implemented. -Therefore, number of clock cycle is not correct. -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 になるからです。
    @@ -1484,10 +1894,220 @@ Human68k を起動する場合はお手 + +
    + +X68030 のグラフィック画面を一部実装しています。 +これにより NetBSD/x68k の標準設定の X サーバは起動します。 +グラフィック画面として実装しているのは 1024x1024 (16色) モードのみです。 +ビデオコントローラは、画面間プライオリティと画面オンオフを実装しており、 +テキスト画面とグラフィック画面の優先度を変更することは出来ます。 +ただし合成や半透明合成は未実装ですので実質切り替えられるだけです。 +スクロール等 CRTC の機能も未実装です。 + +
    + +
    -NEWS エミュレーションは未完成です。 -今の所 -X でカーネルを直接起動することしか出来ません。 +NEWS エミュレーションは今の所 +-X オプションでカーネルを直接起動することしか出来ません。 +PROM も NetBSD/news68k +の起動と終了に最低限必要な程度が誤魔化してあるだけです。 +また、デバイスの配置や、デバイスが存在しないアドレスへのアクセスが +どうなるかなどは実機確認をしていないため分かりません。 +従って、動くものは動く、程度のものでしかありません。 +というかネタです。 +
    + + + +
    +QEMU の "virt" (架空ハードウェア仕様)の互換機ｗをサポートしています。 +NetBSD/virt68k が動作します。 +-X オプション (または設定の exec-file) +でカーネルを、 +設定の exec-bootparam でルートデバイスを +それぞれ指定してください。 +インストール時には --initrd (または設定の exec-initrd) +で RAM ディスクイメージも指定します。 +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). +
    + + + +
    +virt-m68k (や NEWS) のようにシリアルコンソールしか持たない機種のために、 +メイン画面でシリアルコンソールの端末エミュレーションを実装してあります。 +hostcom-driver = cons とすることで nono のメイン画面に +シリアルコンソールの内容が表示されます。 +カラーは現状サポートしていませんが、 +ボールド、イタリック、下線などはある程度サポートしています。 +バックログはありませんので、バックログが必要なら +stdio 等を使ってください。 +
    + + + +
    +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) です。 +
    + + + +
    +現実の Nereid はイーサネット/メモリ/USB の複合拡張ボードで、 +このうちメモリは、メインメモリの増設に使える他、 +メインメモリとして使わなかった領域をバンクメモリとして使うことも出来ます。 +nono ではこの Nereid の機能のうちイーサネット (RTL8019AS) +とバンクメモリのみサポートします。 +メインメモリの増設機能はエミュレータでは意味がないので実装しません。また +USB (SL811HS/T) の実装予定はありません。 +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. +

    +Nereid は DIPSW6,7 によりアドレス・割り込みベクタの組を2通り指定できるため、 +2枚まで同時に運用することが出来ます。 +本来 SW6 と SW7 は (衝突さえしなければ) 任意に組み合わせることが可能ですが、 +nono では簡便のためボード #0 は SW6,7 が OFF、 +ボード #1 は SW6,7 が ON と固定しています。 +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. +
    + +
    #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) +
    +
    +バンクメモリは、メインメモリとして使わなかった領域を使用します。 +そのため実機でもバンクメモリの容量は DIPSW のメインメモリ割り当て設定 +(SW1-5) に依存します。 +nono に関係する結論だけでいうと、 +メインメモリへの割り当てを一切行わない場合はバンクメモリは 16MB 確保でき、 +メインメモリへの割り当てをいくらかでも行うとバンクメモリは 4MB となります。 +設定の nereidN-ram-size はこの部分を指定していることになります。 +またこの容量とは独立に SW8 でバンクメモリの有効・無効を指定できますので、 +nereidN-ram-size が 0 (以下) というのは SW8 +でバンクメモリを無効にしたことに相当します。 +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. +
    + + +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
+
    +を実行してください) +
    + + + +
    +X68030 で Windrv を一応サポートしています。 +Human68k からホストのファイルシステムをアクセスする機構です。 +従来の Windrv とはホスト OS の前提が異なるため、 +既存実装からの移植ではありませんし、 +そもそも Human68k とホスト(UNIX)ファイルシステムの差異による制約も多くあります。 +これらを把握してから使用してください。 + +

    +Windrv を使用する場合、まず nono +の設定ファイルに windrv-path を設定します。 +次にゲストの Human68k の CONFIG.SYS に WINDRV.SYS (または WindrvXM.sys) +を設定してください。 +
    +
    +DEVICE = \SYS\WINDRV.SYS
+
    +
    @@ -1529,8 +2149,8 @@ the user has specified full speed mode a the VM is running in synchronized mode. This will happen when any of the following occurs: