--- nono/doc/index.php 2026/04/29 17:05:11 1.1.1.13 +++ nono/doc/index.php 2026/04/29 17:05:15 1.1.1.14 @@ -29,6 +29,40 @@ } ?> + +
+{$h4number}. {$title} +_EOM_; +} +function H4end() +{ + print "
\n"; +} + +function H5($name, $title) +{ + global $h4number; + global $h5number; + $h5number++; + print <<<_EOM_ + +
+{$h4number}.{$h5number}. {$title} +_EOM_; +} +function H5end() +{ + print "
\n"; +} +?>

nono ()

@@ -60,8 +94,7 @@ runs on NetBSD and etc. - -

1. ビルド方法 How to build

+How to build"); ?>
ビルドには以下が必要です。 The followings are required for build. @@ -73,15 +106,17 @@ runs on NetBSD and etc. (For gcc, 7.4 or newer works at least. For clang, 7.0 - 13.0 works at least.)
  • wxWidgets 3.0.x "stable" branch -(but 3.1.x "development" branch is not recommended) +or 3.2.x "new stable" branch
  • gettext

    -wxWidgets は NetBSD(pkgsrc) なら pkgsrc/x11/wxGTK30 です。 -OPTIONS:gtk3 で動作確認しています。 +wxWidgets は NetBSD(pkgsrc) なら +pkgsrc/x11/wxGTK30 (OPTIONS:gtk3 で動作確認) です。 +2022Q3 の wxGTK32 ではビルドできないようです。 If you use NetBSD(pkgsrc), -wxWidgets is pkgsrc/x11/wxGTK30 (OPTIONS:gtk3 is tested). +wxWidgets is pkgsrc/x11/wxGTK30 (OPTIONS:gtk3 is tested). +wxGTK32 in 2022Q3 doesn't seem to build for now.

    (NetBSD 以外でのビルドはサポートしていませんが) @@ -133,19 +168,33 @@ for developers only. the command line executable.

    • + - -

    2. 実行方法 How to execute

    +How to execute"); ?>
    -nono は複数機種に対応しているため、設定なしでは起動できません。 -デフォルトではカレントディレクトリの nono.cfg という設定ファイルを探します。 --c オプションで設定ファイル (VM ディレクトリ) の位置を指定したり、 -あるいは -V オプションで設定を列挙することも出来ます。 +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.
    - -
    2.1. コマンドラインオプション Command Line Option
    +Command Line Option"); +?>
    -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 と等価です。 Boot as the fast mode. You can change this mode on GUI menu after boot, -and the option only changes its initial state. +and the option only changes its initial state. +This option is equivalent to fast-mode=1 in configuration. _EOM_ ); option_item("--fontsize height", <<<_EOM_ GUI 版のみ。 全サブウインドウの起動時のフォントサイズを指定します。 -height には 12, 16 -のいずれかを指定します。デフォルトは 12 です。 起動後にメニューから変更できます。 - -GUI Only. -Specifies the initial fontsize on all sub windows. -height is one of 12 or 16. -The default value is 12. -You can change this value on GUI menu after boot. +設定の monitor-fontsize と等価です。 +GUI Only. +Specifies the initial fontsize of all sub windows. +You can change this value on GUI menu after boot. +This option is equivalent to monitor-fontsize in configuration. _EOM_ ); -option_item(array("-s scale", - "--scale scale"), <<<_EOM_ +option_item("-s scale", <<<_EOM_ GUI 版のみ。 メインウィンドウの起動時のスケールを実数で指定します。 -起動後にもメニューからプリセットされた倍率には変更可能ですが、 -任意倍率は起動時のみ指定可能です -(そのうちなんとかしたい)。 -デフォルトは 1.0 です。 - -GUI Only. + +設定の mainview-scale と等価です。 +起動後はメニューからプリセットされた倍率と +mainview-scale で指定された倍率には変更可能です。 +GUI Only. Specifies the initial main window scale in real number. -You can change this scale on GUI menu after boot, -but unlike this option, there are only a few preset choices -(Should be improved in someday). -The default value is 1.0 + +This is equivalent to mainview-scale in configuration. +You can change this scale on GUI menu after boot. _EOM_ ); @@ -253,19 +312,43 @@ option_item("-X file", <<<_EOM_ ホストの file をロードして実行します。 file が相対パスの場合カレントディレクトリからのパスになります。 ファイルが gzip 圧縮されていれば自動的に展開します。 -(展開後の) ファイル形式は a.out (OMAGIC) か ELF で、 +(展開後の) ファイル形式は以下の通りですが、 実際にはブートローダとカーネル程度しか想定していません。 -設定の prom-image、luna-dipsw1 の内容(後述)によらず -内蔵の互換 PROM で起動し、直ちにホストファイルを実行します。 +また、いずれも起動元デバイスが取得できないなどの問題はあるかも知れません。 Loads and executes host's file. If file is relative path, it is path from the current directory. If the file is gzip'd, it is automatically extracted. -The supported file format (after extracting) is a.out (OMAGIC) or ELF. +The supported file format (after extracting) is the following. Actually, it only assumes bootloaders or kernels. -Regardless of prom-image and luna-dipsw1 configuration +And note that it may not obtain some information that where did I boot from, +for example. + +LUNA では、設定の prom-image、luna-dipsw1 の内容(後述)によらず +内蔵の互換 PROM で起動し、直ちにホストファイルを実行します。 +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. +the internal emulated PROM loads and executes the host file immediately. +On X68030, +nono hacks the boot device after normal boot from IPLROM, +and loads and executes the host file. _EOM_ ); ?> @@ -328,23 +411,57 @@ _EOM_ ?>
    + + - -

    3. 設定 Configuration

    +Configuration"); ?>
    -VM の設定ファイルはその VM ディレクトリ内の nono.cfg -(または -c で指定したファイル) です。 -書式は key = value 形式で1行1項目ずつです。 + +nono の設定はいずれも以下の順序で適用されます。 +nono's configurations are always applied in the following order. + +
      +
    1. デフォルト値 Default value +
    2. ~/.nono.cfg があればその内容 +Contents of ~/.nono.cfg if exists +
    3. VM ディレクトリ内の nono.cfg (または -c で指定したファイル) +があればその内容 +Contents of nono.cfg in the VM directory (or the file specified by -c option) if exists +
    4. コマンドラインオプション Command line option +
    + +ファイルの書式はどちらも key = value 形式で1行1項目ずつです。 key と value の前後の空白は取り除かれます。 また空行と "#" で始まる行は無視します。 知らないキーは警告を出した上で無視します。 -VM configuration file is nono.cfg -(or the file specified by -c option) in the VM directory. -Its syntax is key = value format, one per line. +同じキーが複数回現れた場合、 +上に列挙した順に後から書いたほうで上書きし、 +同じファイル内でも同様に後に書いたほうで上書きします。 +コマンドラインオプション -V 等はこれをさらに上書きします。 +コマンドラインオプションで同じキーが複数回現れた場合も後に書いたほうが上書きします。 + +The syntax of both files is key = value format, one per line. White spaces before and after key and value are ignored. Blank lines, lines beginning with "#" are also ignored. -The lines with unrecognized key are ignored with a warning. +The lines with unrecognized key are ignored with a warning. + +If the same key appears more than once, +the latter overwrites the former in the above order. +If the same key appears in a file, +the latter overwrites the former in the same manner. +Then, command line option -V etc. overwrites it. +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 +by configuration file or commandline option. +

    設定項目は次の通りです。 The configuration items are: @@ -363,13 +480,13 @@ This field is mandatory.
     luna … LUNA-I
    luna88k … LUNA-88K -
    x68030 … X68030 (Experimental) +
    x68030 … X68030 (Experimental) +
    news … NWS-1750 (Just a joke)
    _EOM_ ); -config_item("cgrom-image = path", <<<_EOM_ - +config_item("cgrom-image = path", <<<_EOM_ (X68030 Only) X68030 の外部 CGROM イメージファイルのパスを指定します。 CGROM は 768KB です。 @@ -384,7 +501,7 @@ the VM directory and then its parent dir If the path is a relative path, it will be path from the VM directory, not from the current directory. If the path is empty, nono's builtin compatible CGROM will be used. -The default value is empty. +The default value is empty. _EOM_ ); @@ -393,7 +510,7 @@ config_item("clock-sync = value", real なら実時間に同期、virtual なら仮想時間に同期します。 デフォルトは real です。 この機能は実験中のため将来予告なく仕様が変更になる可能性があります。 -Specify how to synchronize the time in virtual machine. +Specifies how to synchronize the time in virtual machine. If real, synchronize with the real time; if virtual, synchronize with the virtual time. The default is real. @@ -421,12 +538,61 @@ _EOM_ config_item("debugger-tcp-port = integer", <<<_EOM_ デバッガのコンソールドライバが tcp の時の TCP 待ち受けポート番号を指定します。 -Specify the TCP port number that debugger console driver listens. +Specifies the TCP port number that debugger console driver listens. +_EOM_ +); + +?>yesno", <<<_EOM_ +(LUNA and NEWS Only) +機種に依存せず DIPSW を自動起動に設定するかどうか指定します。 +"yes" なら自動起動するように、 +"no" なら自動起動しないように DIPSW 設定を上書きします。 +"" (空) なら何もしません。デフォルトは "" です。 +このオプションは luna-dipsw1 や news-dipsw +の状態が設定ファイルやコマンドラインオプションによって確定した後に +該当のスイッチだけを変更します。 +Specifies whether to configure DIPSW to boot automatically, +regardless of the models. +"yes" overwrites DIPSW, to boot automatically. +"no" overwrites DIPSW, not to boot automatically. +"" (Empty) does nothing. +The default value is "". +This option only changes the appropriate switch(es) +after the luna-dipsw1 or news-dipsw configuration +is determined by the configuration file or command line options. +_EOM_ +); + +config_item("dipsw-serial = yesno", <<<_EOM_ +(LUNA and NEWS Only) +機種に依存せず DIPSW をシリアルコンソールを使うかどうか指定します。 +"yes" ならシリアルコンソールを使うように、 +"no" ならシリアルコンソールを使わないように DIPSW 設定を上書きします。 +"" (空) なら何もしません。デフォルトは "" です。 +luna-dipsw1 もしくは news-dipsw (機種による) +の状態が設定ファイルやコマンドラインオプションによって確定した後に +このオプションによって該当のスイッチだけを変更します。 +NEWS でシリアルコンソールを使わないを選択した場合、 +SW1,2,3 は OFF, OFF, ON にセットされ、 +NWB-512 モノクロコンソール(未実装) が選択されます。 +Specifies whether to configure DIPSW to use serial console, +regardless of the models. +"yes" overwrites DIPSW, to use serial console. +"no" overwrites DIPSW, not to use serial console. +"" (Empty) does nothing. +The default value is "". +This option only changes the appropriate switch(es) +after the luna-dipsw1 or news-dipsw configuration +is determined by the configuration file or command line options. +If you choose not to use serial console on NEWS, +SW1,2,3 will be set OFF, OFF, ON respectively, +and NWB-512 monochrome console (not implemented) will be chosen. _EOM_ ); config_item("ethernet-macaddr = string", <<<_EOM_ -(LUNA Only) +(LUNA and NEWS only) イーサネットデバイスの仮想マシン側の MAC アドレスを指定します。 XX:XX:XX:XX:XX:XX 形式で指定します。 @@ -435,30 +601,62 @@ config_item("ethernet-macaddr = strin _EOM_ ); -config_item("fd-drive = integer", <<<_EOM_ -(X68030 Only) +config_item("extram-size = integer", <<<_EOM_ + +(X68030 Only) +拡張メモリのサイズを MB 単位で指定します。 +今の所以下だけが指定できます。 +Specifies the extended RAM size in MB. +For now, only the following can be specified. +

    +_EOM_ +); + +config_item("fast-mode = integer", <<<_EOM_ + +起動時の動作モードを指定します。0 なら通常モード、1 なら高速モードです。 +デフォルトは 0 です。 +コマンドラインオプション -f でも高速モードへのみ指定可能です。 + +_EOM_ +); + +config_item("fd-drive = integer", <<<_EOM_ +(X68030 Only) フロッピードライブの数を 0 から 4 で指定します。 デフォルトは 2 です。 -Specify the number of floppy drives from 0 to 4. +Specifies the number of floppy drives from 0 to 4. The default is 2. _EOM_ ); -config_item("fdN-image = path", <<<_EOM_ -(X68030 Only) +config_item("fdN-image = path", <<<_EOM_ +(X68030 Only) フロッピードライブ N に起動時に挿入するディスクイメージを指定します。 イメージパスが相対パスなら VM ディレクトリからの相対パスになります。 起動後はメニューから操作できます。 デフォルトは空です。 -Specify a diskimage to be inserted to floppy drive N at startup. +Specifies a diskimage to be inserted to floppy drive N at startup. If the path is relative path, it is from the VM directory. You can also operate them from menu after startup. The default is empty. _EOM_ ); -config_item("fpu-type = value", <<<_EOM_ -(X68030 Only) +config_item("fpu-type = value", <<<_EOM_ +(X68030 Only) FPU を装着するかどうか指定しています。 none なら FPU を装着しません。 68881 なら FPU として 68881 を装着します。 @@ -467,7 +665,7 @@ FPU を装着するかどうか指定し 68881 の代わりに 1 と書くこともできます。 デフォルトは 68881 です。 LUNA-I はたぶん 68881 搭載モデルのみのため設定できません。 -Specify whether to install FPU or not. +Specifies whether to install FPU or not. If none, FPU is not installed. If 68881, 68881 FPU is installed. 68882 is not supported yet. @@ -476,7 +674,6 @@ And, none can also be written a The default is 68881. This item cannot be specified on LUNA-I because (probably) all LUNA-I has 68881. - _EOM_ ); @@ -498,7 +695,7 @@ _EOM_ config_item("hostcom-tcp-port = integer", <<<_EOM_ ホストドライバが tcp の時の TCP 待ち受けポート番号を指定します。 -Specify the TCP port number that host driver listens. +Specifies the TCP port number that host driver listens. _EOM_ ); @@ -506,7 +703,7 @@ config_item("hostcom-fallback = integ hostcom-driver で指定したドライバが使用可能でなかった時、 0 ならプロセスを終了します。1 なら none を選択して実行を継続します。 デフォルトは 0 です。 -Specify the behavior when the driver which is selected by +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. @@ -515,6 +712,7 @@ _EOM_ ); config_item("hostkbd-input = string", <<<_EOM_ +(LUNA and X68030 only) ホストキーボードの入力モードを指定します。 char ならキャラクタ入力モード、 jp なら日本語キーボードモードです。 @@ -529,7 +727,7 @@ _EOM_ ); config_item("hostnet-driver = string", <<<_EOM_ -(LUNA Only) +(LUNA and NEWS Only) イーサネットデバイスのホスト側ドライバを指定します。 afpacket、bpf、tap のうち ホスト OS がサポートしているものと auto、none が選択可能です。 @@ -556,13 +754,13 @@ _EOM_ ); config_item("hostnet-afpacket-ifname = ifname", <<<_EOM_ -(LUNA Only) +(LUNA and NEWS Only) ホストドライバが afpacket の時にバインドするインタフェースを1つ指定します。 ifname が auto なら使用可能なインタフェースを1つ自動的に選択します。 デフォルトは auto です。 なお、このホストドライバではローカルホストとの通信は出来ません。 -Specify an interface name to bind to, when the host driver is afpacket. +Specifies an interface name to bind to, when the host driver is afpacket. If auto is specified as ifname, it selects an usable interface automatically. The default is auto. @@ -571,13 +769,13 @@ _EOM_ ); config_item("hostnet-bpf-ifname = ifname", <<<_EOM_ -(LUNA Only) +(LUNA and NEWS Only) ホストドライバが bpf の時にバインドするインタフェースを1つ指定します。 ifname が auto なら使用可能なインタフェースを1つ自動的に選択します。 デフォルトは auto です。 なお、このホストドライバではローカルホストとの通信は出来ません。 -Specify an interface name to bind to, when the host driver is bpf. +Specifies an interface name to bind to, when the host driver is bpf. If auto is specified as ifname, it selects an usable interface automatically. The default is auto. @@ -586,7 +784,7 @@ _EOM_ ); config_item("hostnet-tap-devpath = path", <<<_EOM_ -(LUNA Only) +(LUNA and NEWS Only) ホストドライバが tap の時に使用するデバイスを1つフルパスで指定します。 デフォルトは auto で、この場合は自動的にデバイスを選択します。 この時の探し方はホスト OS によって異なります。 @@ -600,7 +798,7 @@ NetBSD (と FreeBSD) ならまず /d nono-ifup, nono-ifdown という名前のシェルスクリプトが必要です。 何もすることがない場合でも正常終了する空のシェルスクリプトを用意してください。 -Specify a device pathname, when the host driver is tap. +Specifies a device pathname, when the host driver is tap. The default is auto. The behavior in this case depends on the host OS. On Linux, it's the same as /dev/net/tun. @@ -618,12 +816,12 @@ _EOM_ ); config_item("hostnet-fallback = integer", <<<_EOM_ -(LUNA Only) +(LUNA and NEWS Only) hostnet-driver で指定したドライバが使用可能でなかった時、 0 ならプロセスを終了します。 1 なら none を選択して実行を継続します。 デフォルトは 0 です。 -Specify the behavior when the driver which is selected by +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. @@ -631,8 +829,7 @@ The default is 0. _EOM_ ); -config_item("iplrom1-image = path", <<<_EOM_ - +config_item("iplrom1-image = path", <<<_EOM_ (X68030 Only) X68030 の外部 IPLROM イメージファイルのパスを指定します。 こちらは 0xfe0000..0xffffff の 128KB の部分で、IPLROM30 と呼ばれているほうです。 @@ -647,12 +844,11 @@ the VM directory and then its parent dir If the path is a relative path, it will be path from the VM directory, not from the current directory. If the path is empty, the public released IPLROM30 will be used. -The default value is empty. +The default value is empty. _EOM_ ); -config_item("iplrom2-image = path", <<<_EOM_ - +config_item("iplrom2-image = path", <<<_EOM_ (X68030 Only) X68030 の外部 IPLROM イメージファイルのパスを指定します。 こちらは 0xfc0000..0xfdffff の 128KB の部分で、ROM30 と呼ばれているほうです。 @@ -669,15 +865,16 @@ If the path is a relative path, it will be path from the VM directory, not from the current directory. If the path is empty, internal emulated ROM will be used. The ROM supports only enough SCSI IOCS to boot NetBSD/x68k. -The default value is empty. +The default value is empty. _EOM_ ); config_item("keyboard-connect = integer", <<<_EOM_ +(LUNA and X68030 Only) 起動時にキーボードを本体に接続するかどうかを指定します。 1 なら接続し、0 なら接続しません。デフォルトは 1 です。 起動後はメニューから変更可能です。 -Specify whether to connect keyboard on boot. +Specifies whether to connect keyboard on boot. If 1, it is connected; if 0, it isn't connected. The default is 1. You can change it on GUI menu after boot. _EOM_ @@ -724,7 +921,7 @@ config_item("luna-dipsw1 = string 本体前面 DIPSW#1-1..#1-8 の内容を指定します。 "0" を DOWN、"1" を UP として、 これを8つ並べた形式で、前から順に #1..#8 に対応します。 -Specifies status of the front panel DIPSW#1-1..#1-8 using 8 digit. +Specifies status of the front panel DIPSW#1-1..#1-8 using 8 digits. "0" means DOWN and "1" means UP. The first character corresponds to #1 and the eighth character corresponds to #8. @@ -742,6 +939,15 @@ LUNA-88K でのデフォルトは 11 See the following link about DIPSW.
    → OpenBSD manual pages: boot_luna88k(8) +

    +自動起動するかどうかとシリアルコンソールを使うかどうかを指定したい場合は +こちらではなく +dipsw-autoboot、dipsw-serial +設定を使うほうが便利です。 +If you only want to specify whether to autoboot and/or +to use serial console, +dipsw-autoboot, dipsw-serial +configurations are useful. _EOM_ ); @@ -768,37 +974,59 @@ _EOM_ config_item("luna-video-plane = integer", <<<_EOM_ (LUNA Only) -LUNA のビデオボードのプレーン数を 1 か 4 で指定します。 +LUNA のビデオボードのプレーン数を 1、4、8 から指定します。 1 ならモノクロビデオボード、 -4 なら16色 (4bpp) ビデオボードに相当します。 -8bpp ボードは(まだ?)サポートしていません。 -デフォルトは今の所 1 です (将来変更するかもしれません)。 -Specify number of planes on LUNA video board. -The valid values are 1 or 4. +4 なら16色 (4bpp) ビデオボード、 +8 なら 256色 (8bpp) ビデオボードです。 +デフォルトは 4 です。 +Specifies number of planes on LUNA video board. +The valid values are 1, 4 or 8. 1 means a monochrome video board, -4 means 16-color (4bpp) video board. -Note that 8bpp video board is not (yet?) supported. -The default value is 1 for now (It may be changed in the future). +4 means 16-color (4bpp) video board, +8 means 256-color (8bpp) video board. +The default value is 4. +_EOM_ +); + +config_item("mainview-scale = double", <<<_EOM_ + +メインウィンドウの起動時のスケールを実数で指定します。 +コマンドラインオプション -s で上書き可能です。 +起動後はメニューから、 +プリセットされた倍率とここで指定した倍率には変更可能です。 +デフォルトは 1.0 です。 +_EOM_ +); + +config_item("monitor-fontsize = integer", +<<<_EOM_ + +テキスト系モニタとステータスパネルのフォントサイズを +12, 16, 24 から指定します。 +コマンドラインオプション --fontsize で上書き可能です。 +起動後はメニューから変更することができます。 +デフォルトは 12 です。 + _EOM_ ); config_item("monitor-rate = integer", <<<_EOM_ テキスト系モニタウィンドウの更新頻度を Hz 単位で指定します。 1 から 60 までの間で指定でき、デフォルトは 20Hz です。 -起動後にメニューからプリセットされた頻度には変更可能です。 +起動後にメニューから、プリセットされた頻度 +とここで指定した頻度には変更可能です。 Specifies refresh rate of all text monitor windows in Hz. It ranges from 1 to 60. The default is 20Hz. -You can change this value on GUI menu after boot, -but unlike this configuration value, there are only a few preset choices. +You can choose this value on GUI menu after boot, +from preset rate or rate specified here. _EOM_ ); config_item("mpu-clock = value", <<<_EOM_ MPU のクロック数を MHz 単位で指定します。 -デフォルトは LUNA-I なら 20MHz、LUNA-88K と X68030 なら 25MHz です。 +デフォルトは LUNA-I なら 20MHz、LUNA-88K と X68030 なら 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. _EOM_ ); @@ -818,6 +1046,34 @@ m88100 には、m68k の STOP 命令 ( _EOM_ ); +config_item("news-dipsw = string", <<<_EOM_ +(NEWS Only) +DIPSW の内容を指定します。 +"0" を OFF、"1" を ON として、 +これを8つ並べた形式で、前から順に SW1..SW8 に対応します。 +デフォルトは 00001000 です。 +Specifies status of the DIPSW using 8 digits. +"0" means OFF and "1" is ON. +The first character corresponds to SW1 and +the eighth character corresponds to SW8. +The default valus is 00001000. +

    +各スイッチの内容は以下のリンクを参照してください。 +See the following link about DIPSW.
    +→ NetBSD/news68k Frequently Asked Questions +

    +自動起動するかどうかとシリアルコンソールを使うかどうかを指定したい場合は +こちらではなく +dipsw-autoboot、dipsw-serial +設定を使うほうが便利です。 +If you only want to specify whether to autoboot and/or +to use serial console, +dipsw-autoboot, dipsw-serial +configurations are useful. +_EOM_ +); + config_item("prom-image = path", <<<_EOM_ (LUNA Only) LUNA-I/LUNA-88K の外部 ROM イメージファイルのパスを指定します。 @@ -877,10 +1133,14 @@ By the way, NetBSD/luna68k needs at leas 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. -

  • X68030 のデフォルトは 12MB です。 +
  • X68030 ではメイン RAM 容量を示し、デフォルトは 12MB です。 4MB から 12MB まで 1MB 単位で指定できます。 -On X68030, the default is 12MB. -You can specify it in 1MB unit from 4MB to 12MB. +拡張メモリについては 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. +
  • NWS-1750 では現状 16MB で変更できません。 +On NWS-1750, This is 16MB fixed for now. _EOM_ ); @@ -892,25 +1152,30 @@ RTC (MK48T02) の基準年を指定し NetBSD/luna68k、OpenBSD/luna88k はいずれも基準年を 1970年としていますので、 デフォルトのままで構いません。 ゲスト OS に 4.4BSD を使用する際は 1900 を指定します。 +NEWS では今の所 1900 固定で変更出来ません。 Specifies the RTC (MK48T02) epoch year. The default is 1970. Since both NetBSD/luna68k and OpenBSD/luna88k use 1970 as epoch year, there is no need to touch this value. -If you boot 4.4BSD on LUNA-I as the guest OS, specify 1900. +If you boot 4.4BSD on LUNA-I as the guest OS, specify 1900. +On NEWS, it is fixed at 1900. _EOM_ ); config_item("show-statuspanel = integer", <<<_EOM_ ステータスパネルを表示するかどうかを指定します。 0 なら非表示、1 なら表示です。 +デフォルトは 1(表示) です。 起動後はメニューから変更可能です。 Specifies whether to display the status panel or not. If 0, it is hidden; if 1, it is shown. +The default is 1 (show). You can change it on GUI menu after boot. _EOM_ ); config_item("spc0-idN-image = devtype[,path]", <<<_EOM_ +(LUNA and X68030 Only) SCSI デバイスとイメージを指定します。キーの N には 0 から 7 が入ります。 ただし ID 7 は本体が使用しますので指定しないでください。 値はデバイス種別 devtype とディスクイメージパス path @@ -958,6 +1223,7 @@ _EOM_ ); config_item("spc0-idN-seektime = integer", <<<_EOM_ +(LUNA and X68030 Only) 指定の SCSI HDD の平均シークタイムを msec 単位で指定します。 現在のデフォルトは 0 です (S・S・D!! S・S・D!!)。 16 程度を指定すると幾分往時に思いを馳せることが出来るかもしれませんが、 @@ -971,24 +1237,27 @@ _EOM_ ); config_item("spc0-idN-writeignore = integer", <<<_EOM_ -指定の SCSI HD デバイスへの書き込みを無視するかどうか指定します。 +(LUNA and X68030 Only) +指定の SCSI HD デバイスへの書き込みをイメージに書き戻すかどうか指定します。 0 なら通常動作(書き込みを行う)です。 -1 なら書き込みコマンドは成功したように振る舞いますが実際には -ディスクイメージに一切書き戻しません。 +1 ならディスクイメージに一切書き戻しません。 +デバイスへ書き込んだはずのデータは Copy-On-Write の要領で、 +VM ディレクトリ内の一時ファイルに書き込みます。 +この一時ファイルはアプリケーション終了時に削除します。 fsck を気にせずカーネルのデバッグとかを行いたい場合にはどうぞ。 何が起きるか意味が分からない人は指定しないでください。 デフォルトは 0 です。 -Specifies whether nono ignores writing to SCSI HD devices. -0 means normal operation (writes to the devices). -If 1 is specified, -nono will not actually write back to the disk image -even though the write command is succeeded. -nono's SCSI devices acts as -write command is successfully done but it never writes back -to the actual disk image. +Specifies whether nono writes a writing to SCSI HD devices back +to the diskimage. +0 means normal operation (writes to the diskimage). +1 means that nono will not write to the diskimage back. +Data that the guest wrote to the device will be written to a temporary file +in the VM directory, +like Copy-On-Write. +The temporary file will be removed when the application exits. This is useful for kernel debugging because it does not require fsck -after the kernel hangs. -But don't use this flag if you don't understand this paragraph. +after the kernel hangs or reboots. +Don't use this flag if you don't understand this paragraph. The default value is 0.

    ちなみに、メディアを書き込み禁止にしたい場合はこれではなく、 @@ -1000,6 +1269,7 @@ _EOM_ ); config_item("spc0-idN-writeprotect = integer", <<<_EOM_ +(LUNA and X68030 Only) 古いオプションです。 代わりに spc0-idN-writeignore を使ってください。 このオプションは開発用です。 @@ -1009,8 +1279,7 @@ This option is for developers. _EOM_ ); -config_item("sram-sync-ramsize = integer", <<<_EOM_ - +config_item("sram-sync-ramsize = integer", <<<_EOM_ (X68030 Only) SRAM の RAM 容量欄を実際の RAM サイズに合わせるかどうかを指定します。 0 なら何もしません (実機と同じ)。 @@ -1019,7 +1288,7 @@ SRAM の \$ed0008.L (RAM 容量) を ram この更新は、 アプリケーション起動時に SRAM マジックが正しく書かれている場合のみ行われます。 デフォルトは 1 です。 -Specify whether to synchronize a RAM size field in SRAM +Specifies whether to synchronize a RAM size field in SRAM with real RAM size or not. If 0, the application will do nothing (as same as the real). If 1, the application updates(synchronizes) @@ -1027,29 +1296,40 @@ If 1, the application updates(s This update is performed once only if the SRAM magic string is correct at the application startup. 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. +_EOM_ +); + ?>

    • + - - -

    4. VM について About VM

    +About VM"); ?> -
    実装状況 Implementation Status +Implementation Status"); ?>
    ◎ : ほぼ実装済み Mostly implemented @@ -1088,14 +1368,17 @@ BT454 ◎ CRTC2 ○ 標準で使用する値のみサポート Frame buffer ◎ Keyboard/Mouse ◎ -SIO ◎ -PIO ○ +SIO (uPD7201) ◎ +PIO (8255) ○ Ethernet (AM7990) ◎ LARF を除く Except LARF NVRAM&RTC (MK48T02) ◎ Front LCD ◎ -SPC ◎ +SPC (MB89352) ◎ SCSI HD/CD/MO Devices ○ -XP とその向こうXP and beyonds × +XP(HD647180) CPU △ +XP(HD647180) Timer0/1 ○ +XP(HD647180) その他の内蔵デバイス
    Other internal devices     × +XP 周辺デバイス Peripheral devices × 電源 Power Circuit ○ LUNA-88K specific @@ -1117,12 +1400,12 @@ ADPCM/OPM × Keyboard ◎ TVコントロールを除く Except TV Control Mouse ◎ 本体接続のみ MFP △ -PPI △ +PPI (8255) △ Printer × RTC ◎ アラームを除く Except Alarm -SPC ◎ +SPC (MB89352) ◎ SCSI HD/CD/MO Devices ○ -SCC ◎ +SCC (Z8530) ◎ SRAM ◎ システムポートSystem port △ テキスト画面Text screen ○ @@ -1130,7 +1413,22 @@ SRAM ◎ Nereid Ethernet × Nereid Bank memory × Nereid USB — 実装予定なし Not planned -拡張メモリ Extended memory × +拡張メモリ Extended memory ○ + +NWS-1750 +MPU (68030) ○ キャッシュ未実装 Cache not implemented +FPU (68881) ◎ 68882 は未実装 68882 not implemented +PROM × +SCC (Z8530) ◎ チャンネル A のみホストに接続 Only channel A is connected to the host +Ethernet (AM7990) ◎ LARF を除く Except LARF +NVRAM&RTC (MK48T02) ◎ +Video Board × +Keyboard/Mouse × +SCSI Controller × +IDROM, DIP-SW, 100Hz Timer, 診断用LED ○ +AST, Lv2Intr × +電源 Power Circuit × + __EOM__; $table_lines = preg_split("/\n/", $table); foreach ($table_lines as $line) { @@ -1150,9 +1448,10 @@ __EOM__; ?>
    + -
    MPU (68030)
    -
    + +
    68030 はキャッシュが未実装です。 これに伴い命令の所要クロック数もまだ正しくなく、 そのためクロック測定などでは正確な値が出ません。 @@ -1160,32 +1459,39 @@ __EOM__; 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. -
    + -
    LUNA の ROM エミュレーション
    -
    + +
    LUNA-I、LUNA-88K で PROM の外部イメージを指定しない場合 (prom-image が空の場合)、 内蔵の独自 ROM が動作し、コンソールモニタが起動します。 このコンソールモニタの動作は実機のそれとよく似ていますが、 これは実機確認の際に操作方法が違いすぎると(自分が)困るため仕方なく似せているもので、 忠実なコピーを作る目的ではありません。 -
    + -
    X68030 の ROM (ROM30) エミュレーション
    -
    + +
    X68030 で ROM30 の外部イメージを指定しない場合 (iplrom2-image が空の場合)、内蔵の独自 ROM が組み込まれます。 本来の ROM30 には SCSIIOCS の他に ROM デバッガなどが含まれていますが、 内蔵 ROM はこのうち SCSIIOCS を NetBSD/x68k が起動するのに十分なだけしか 実装していません。 Human68k を起動する場合はお手元の実機から ROM イメージを作成してください。 -
    + + + +
    +NEWS エミュレーションは未完成です。 +今の所 -X でカーネルを直接起動することしか出来ません。 +
    + -
    ステータスパネル Status Panel
    +Status Panel"); ?>
    ステータスパネル中央にあるパフォーマンスメータのアイコンは 高速モードの状態を表示しています。 @@ -1231,8 +1537,58 @@ or the keyboard buzzer is sounding.
    + -
    キー入力モード Key input mode
    + +
    +DIPSW 設定ウィンドウでの変更はアプリケーション起動中のみ有効です。 +またここでの設定は即 VM に反映されますが、 +LUNA の場合 DIPSW の状態を +PIO(8255) がラッチするのが概ね起動時および再起動時のみとなっています +(厳密には PROM と XP が云々ですが)。 +
    + +Memory Dump Monitor"); ?> +
    +メモリダンプモニタの出力形式を、バイト、ワード、ロングワード +(m88k ではそれぞれバイト、ハーフワード、ワードと表現します) +から選択できます。 +また 68030/88200 の MMU ディスクリプタとして表示させることもできます +(この位置が正しいディスクリプタかどうかは関係なく表示します)。 +逆アセンブルも、逆アセンブルウィンドウからこちらにマージしました。 +LUNA-I なら m68k、HD64180 の逆アセンブルが、 +LUNA-88K なら m88k、HD64180 の逆アセンブルが、 +X68030 と 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). +Also you can choose 68030/88200 MMU descriptor format +(It displays regardless of whether this address is used as descriptor or not). +Disassemble is now merged from disassemble monitor. +On LUNA-I, you can choose m68k and HD64180 disassemble. +On LUNA-88K, you can choose m88k and HD64180 disassemble. +On X68030 and NEWS, you can choose m68k disassemble. +

    +表示されているダンプ値をダブルクリックすることでメモリの値を編集できます。 +編集できるのはメモリと以下の部分のみです。 +You can edit the memory value by double click. +Only memory and the following areas are ediable. +

      +
    • NVRAM (LUNA and NEWS Only) … +編集するとただちにファイルも更新します。 +後ろの8バイトは時計レジスタを兼ねているため編集不可です。 +The backend file is also updated immediately when edited. +The last 8 bytes are not editable since there are the clock register. +
    • Bitmap framebuffer (LUNA Only) … 共通プレーンは書き込み不可です。 +The common plane is not editable. +
    • SRAM (X68030 Only) … +編集するとただちにファイルも更新します。 +The backend file is also updated immediately when edited. +
    • TVRAM とテキストパレット (X68030 Only) Text VRAM and text palette +
    +
    + +Key input mode"); ?>
    LUNA も X68030 もキーボードは通常日本語キーボードです (LUNA には英語キーボードも存在するようですが…)。 @@ -1315,9 +1671,10 @@ Secondly, the key repeat works (by the h even though it should not work as a correct emulation (Although some of you may feel it an advantage).
    + -
    キャラクタ入力モードのキーコード対応表 -Keycode table in the character mode
    +Keycode table in the character mode"); ?>
    キャラクタ入力モードでの、ホストから入力した文字と VM に送信されるキーの対応は次の通りです。 @@ -1398,7 +1755,7 @@ only be typed from the software keyboard _ [SHIFT]+[_] F1 〜 F10 [PF1] 〜 [PF10] - F11 [PF10] + F11 [PF10] ↑ [↑] ← [←] → [→] @@ -1451,9 +1808,10 @@ __EOM__; ?>
    + -
    JP キーボードモードのキーコード対応表 -Keycode table in the JP keyboard mode
    +Keycode table in the JP keyboard mode"); ?>
    JP キーボードモードでの、ホストキーと VM に送信されるキーの対応は次の通りです。 ここに記載のないキーはソフトウェアキーボードからのみ入力出来ます。 @@ -1486,7 +1844,7 @@ the software keyboard window. [BS] [BS] [Enter] [Enter] [F1] 〜 [F10] [PF1] 〜 [PF10] - [F11] [PF10] + [F11] [PF10] [SHIFT-L] [SHIFT-L] [SHIFT-R] [SHIFT-R] [↑] [↑] @@ -1541,8 +1899,9 @@ __EOM__; ?>
    + -
    キーリピート Key Repeat
    +Key Repeat"); ?>
    LUNA では、キーボードがハードウェア側でキーリピートを行わず、 ソフトウェア(OS など)がキーリピートの処理を行います。 @@ -1577,12 +1936,12 @@ If keys continue to be pressed for some the VM also continues to run syncronized mode. In this case, you can resolve it by using the software keyboard window.
    + + - - -

    5. 実行してみる Try it

    -
    5.1. NetBSD/luna68k を実行してみる Try NetBSD/luna68k
    +Try it"); ?> +Try NetBSD/luna68k"); ?>
    つついさんが NetBSD/luna68k 9.2 の liveimage を用意されています。 Tsutsui-san has provided a liveimage of NetBSD/luna68k 9.2. @@ -1686,8 +2045,9 @@ LUNA can be powered off by software, and nono will terminate when the VM is powered off.
    + -
    5.2. OpenBSD/luna88k を実行してみる Try OpenBSD/luna88k
    +Try OpenBSD/luna88k"); ?>
    あおやまさんが OpenBSD/luna88k 7.0 の liveimage を用意されています。 Aoyama-san has provided a liveimage of OpenBSD/luna88k 7.0. @@ -1746,7 +2106,7 @@ b⏎ You will see a screen like this. The bold text indicates the characters you need to enter. 
    -NONO  Emulated ROM Monitor for LUNA88K
+NONO  Emulated ROM Monitor for LUNA-88K
 
 ** NVRAM Initialized.
 
@@ -1768,9 +2128,10 @@ LUNA-88K can be powered off by software,
 and nono will terminate when the VM is powered off.
    + + -
    -
    5.3 NetBSD/x68k を実行してみる Try NetBSD/x68k
    +Try NetBSD/x68k"); ?>
    つついさんが NetBSD/x68k 9.2 の liveimage を用意されています。 ここではこれを起動してみます。 @@ -1789,43 +2150,32 @@ 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/. -
    +
    http://teokurebsd.org/netbsd/liveimage/20210613-x68k/
  • 以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/x68k/ に作成します。 -初回起動時は liveimage は接続しません。 +ここでは説明を簡単にするためネットワークなしにしていますが、 +ネットワーク設定は必要に応じて行ってください。 Create a configuration file nono.cfg in the VM directory, ~/nono/x68k/, with following contents. -You don't need to add the liveimage first time. -
    -vmtype = x68030
-
    - -
  • nono -c ~/nono/x68k で起動します。 -しばらくすると起動メディアが見付からず白帯が出ますので -メニューの「File > Exit」か×ボタンで終了します。 -これで IPLROM により初期化された SRAM が -VM ディレクトリに SRAM.DAT として保存されます。 -Run as nono -c ~/nono/x68k. -After a few seconds, a message will be displayed like this captured screen. -It says in Japanese that "Cannot boot from disk. Please set correct one". -Then, terminate the nono by "File > Exit" in menu or close button. -By this operation, SRAM will be initialized by X68030 IPLROM and -be saved as SRAM.DAT in the VM directory. -
    - -
  • ここで設定ファイル nono.cfg に先程ダウンロードしてきたディスクイメージを追加します (2行目)。 -Then, add a disk image downloaded earlier to configuration file nono.cfg -(see 2nd line). +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
+hostnet-driver = none
    -
  • もう一度 nono -c ~/nono/x68k で起動すると、 +
  • 初回のみ nono -c ~/nono/x68k --create-sram を実行します。 +これで VM ディレクトリに初期状態の SRAM.DAT が作られます。 +Only the first time, run as nono -c ~/nono/x68k --create-sram. +This will create initial SRAM.DAT in the VM directory. + +
  • nono -c ~/nono/x68k で起動すると、 HDD から NetBSD/x68k が起動します。 次回以降はこれだけで直接 NetBSD が起動します。 Again, run as nono -c ~/nono/x68k. @@ -1851,11 +2201,12 @@ you can shutdown and power off by and nono will terminate when the VM is powered off.
    • -
    + + - -

    6. ホストネットワーク設定例 Example of host network setup

    +Example of host network setup"); ?>
    wm0 を持つ NetBSD ホストに tap(4) デバイスを用いて nono のゲスト OS を接続する場合の設定例です。 @@ -1943,16 +2294,16 @@ and open "Monitor > Host > Host Ne It's OK if you can see "HostNet Driver: tap". -
    + + - -

    7. 既知の問題 Known Issues

    +Known Issues"); ?>
    • デバッガのコンソール入力で、 -バックスペースやカーソルキーの入力に対する表示が動作していません。 -In debugger console, some special characters like backspace or cursor keys +カーソルキーなどの特殊文字入力に対する表示が動作していません。 +In debugger console, some special characters like cursor keys aren't printed correctly. (since ver 0.3.0)
    • ホストが VirtualBox (on Windows?) で、 @@ -1969,15 +2320,14 @@ wxWidgets (3.0.5) のバグと思われ This may be due to wxWidgets (3.0.5) bug. (2021/12/30) -
    • メインウィンドウの中央付近に nono のサブウィンドウや他のウィンドウが存在する場合、マウスモードに入れません。 -If there are nono's sub windows or other windows near the center of -the main window, you will not enter the mouse mode. (since ver 0.0.2) -
    + + - -

    8. 過去のバージョンからの移行方法 How to migrate from old versions

    +How to migrate from old versions"); +?>
    バージョンアップに伴い設定ファイル等に非互換が発生する場合があります。 その場合は以下の移行方法を参照して設定ファイル等を更新してください。 @@ -1988,31 +2338,42 @@ In such case, you may need to upgrade it
  • From ver 0.1.x to ver 0.2.0
    • + + - -

    9. 変更履歴 Changes

    +Changes"); ?>
    See changes.html.
    + + - -

    10. 連絡先、ライセンス等 Contact, License, etc

    +Contact, License, etc"); ?> -
    10.1. ライセンス License
    +License"); ?>
    -See nono-license.txt. -
    -
    -
    -また nono は無償公開されている X68030 の IPLROM を使用しています。 +
      +
    • +nono 自身については +nono-license.txt を読んでください。 +See nono-license.txt about nono itself. +
    • +nono は無償公開されている X68030 の IPLROM を使用しています。 許諾条件を読んでください。 nono uses X68030 IPLROM image distributed without charge. You must read the license agreement (even though it's Japanese original text only). -
    +
  • +nono は SIL Open Font License version 1.1 で配布されているフォントの +一部を改変して組み込んでいます。 +nono modifies and embeds the font distributed as SIL Open Font License version 1.1. + +
    • + + -
    10.2. 連絡先 Contact us
    +Contact us"); ?>
    バグ報告などは以下にお願いします。日本語でおk。 If you find any problems, please let me know. @@ -2020,8 +2381,9 @@ You may write in English.
    https://github.com/isaki68k/nono-issue/issues
    + -
    10.3. パッチの提供について About contributes
    +About contributes"); ?>
    パッチを提供してくださる場合は以下に同意したものとします。 If you provide a patch to nono, we assume that you agree the following @@ -2034,10 +2396,10 @@ conditions:
  • 著作部分に関して著作者人格権を行使しないこと。 Do not exercise your author's rights. -
    • + -
    10.4. Acknowledgements
    +
    nono は以下の広告条項を含むソースコードを利用しています。 nono uses source code with the following advertising clause. @@ -2046,7 +2408,8 @@ This product includes software developed This product includes software developed by the University of California, Lawrence Berkeley Laboratory.
    - + +
    nono project