![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to index.php CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Isaki's NoNo m68k/m88k emulator] / nono / doc|
Return to index.php CVS log | Up to [Isaki's NoNo m68k/m88k emulator] / nono / doc |
1.1.1.2 root 1: <!--
2: nono
3: Copyright (C) 2020 nono project
4: Licensed under nono-license.txt
5: -->
1.1 root 6: <html><?php
1.1.1.11 root 7: $nono_ver = "@version@";
8: $nono_date = "@date@";
1.1 root 9:
1.1.1.11 root 10: $fp = fopen("../lib/header.h", "r");
1.1 root 11: if ($fp !== false) {
12: while (($buf = fgets($fp)) !== false) {
13: if (preg_match("/NONO_MAJOR_VER\s+\((\d+)\)/", $buf, $m)) {
14: $nono_major = $m[1];
15: }
16: if (preg_match("/NONO_MINOR_VER\s+\((\d+)\)/", $buf, $m)) {
17: $nono_minor = $m[1];
18: }
19: if (preg_match("/NONO_PATCH_VER\s+\((\d+)\)/", $buf, $m)) {
20: $nono_patch = $m[1];
21: }
22: if (preg_match("/NONO_DATE\s+\"([^\"]+)\"/", $buf, $m)) {
23: $nono_date = $m[1];
24: }
25: }
26: fclose($fp);
27:
1.1.1.11 root 28: $nono_ver = "${nono_major}.${nono_minor}.${nono_patch}";
1.1 root 29: }
30: ?>
1.1.1.2 root 31: <?php require_once "common.php"; ?>
1.1 root 32: <body>
1.1.1.11 root 33: <h3>nono <?=$nono_ver?> (<?=$nono_date?>)</h3>
1.1 root 34:
1.1.1.13! root 35: nono は NetBSD とかで動作する OMRON LUNA-I/LUNA-88K
! 36: (と SHARP X68030) のエミュレータです。
! 37: <q>nono is OMRON LUNA-I/LUNA-88K (and SHARP X68030) emulator
! 38: runs on NetBSD and etc.</q>
1.1.1.8 root 39:
40: <hr>
41:
42: <h4>Index of this page:</h4>
1.1.1.7 root 43: <div class="main">
1.1.1.10 root 44: <a href="#build">1. ビルド方法 <q>How to build</q></a><br>
1.1.1.13! root 45: <a href="#execute">2. 実行方法 <q>How to execute</q></a><br>
1.1.1.10 root 46: <a href="#configuration">3. 設定 <q>Configuration</q></a><br>
47: <a href="#aboutvm">4. VM について <q>About VM</q></a><br>
48: <a href="#tryit">5. 実行してみる <q>Try it</q></a><br>
1.1.1.13! root 49: <a href="#network">6. ホストネットワーク設定例 <q>Example of host network setup</q></a><br>
1.1.1.12 root 50: <a href="#knownissues">7. 既知の問題 <q>Known Issues</q></a><br>
51: <a href="#migrate">8. 過去のバージョンからの移行方法
1.1.1.9 root 52: <q>How to migrate from old versions</q></a><br>
1.1.1.12 root 53: <a href="#changes">9. 変更履歴 <q>Changes</q></a><br>
54: <a href="#license">10. 連絡先、ライセンス等 <q>Contact, License, etc</q></a><br>
55: </div>
56: <p>
57: <div class="main">
58: <span class="new">緑背景</span>は新規または目立った更新のあった箇所です。
59: <q><span class="new">Green Background</span> is new or updated paragraph.</q>
60: </div>
61:
62:
1.1.1.7 root 63: <a name="build"></a>
1.1.1.10 root 64: <h4>1. ビルド方法 <q>How to build</q></h4>
1.1 root 65: <div class="main">
1.1.1.5 root 66: ビルドには以下が必要です。
1.1.1.13! root 67: <q>The followings are required for build.</q>
1.1.1.5 root 68:
1.1 root 69: <ul>
1.1.1.2 root 70: <li>make (BSD make, not GNU make)
1.1.1.4 root 71: <li>C/C++ compiler which supports -std=c++14.
72: <br>
1.1.1.12 root 73: (For gcc, 7.4 or newer works at least.
74: For clang, 7.0 - 13.0 works at least.)
75: <li>wxWidgets 3.0.x "stable" branch
76: (but 3.1.x "development" branch is not recommended)
1.1.1.2 root 77: <li>gettext
1.1 root 78: </ul>
1.1.1.2 root 79:
1.1.1.5 root 80: <p>
1.1.1.13! root 81: wxWidgets は NetBSD(pkgsrc) なら pkgsrc/x11/wxGTK30 です。
! 82: OPTIONS:gtk3 で動作確認しています。
! 83: <q>If you use NetBSD(pkgsrc),
! 84: wxWidgets is pkgsrc/x11/wxGTK30 (OPTIONS:gtk3 is tested).</q>
! 85:
! 86: <p>
1.1.1.5 root 87: (NetBSD 以外でのビルドはサポートしていませんが)
1.1.1.9 root 88: Ubuntu 20.04 ではたぶん以下のパッケージが必要です。
1.1.1.10 root 89: <q>You may need the following packages on Ubuntu 20.04
1.1.1.5 root 90: (though we won't support non-NetBSD platform).</q>
91: </p>
1.1.1.7 root 92: <ul>
93: <li>
1.1.1.5 root 94: bmake
95: build-essential
96: gettext
97: libbsd-dev
98: libedit-dev
99: libkqueue-dev
1.1.1.9 root 100: libwxgtk3.0-gtk-dev
1.1.1.5 root 101: zlib1g-dev
1.1.1.7 root 102: </ul>
1.1.1.5 root 103:
1.1.1.2 root 104: <p>
1.1.1.8 root 105: nono のソースアーカイブを展開したら以下のようにビルドします。
1.1.1.2 root 106: configure には環境変数 CC、CXX でコンパイラを指定することが出来ます。
107: また wx-config が標準的な名前で提供されていないために見付けられない場合には
108: 環境変数 WX_CONFIG にパスを指定することが出来ます。
1.1.1.8 root 109: <q>Extract the nono's source archive and build as following.
1.1.1.2 root 110: You can specify C/C++ compiler using environment variable CC and CXX
111: if configure cannot find standard name suitable compiler.
112: Also, you can specify wx-config path using environment variable WX_CONFIG
113: if configure cannot find wx-config.</q>
1.1.1.12 root 114: </p><p>
115: <tt>-DNOTEST</tt> は開発者用のテストツールをビルドしないためのものです。
116: <q>With <tt>-DNOTEST</tt>, the build excludes test tools which is needed
117: for developers only.</q>
118:
1.1 root 119: <blockquote class="cons"><pre>
120: % ./configure
1.1.1.12 root 121: % make -DNOTEST depend
122: % make -DNOTEST
1.1.1.2 root 123: % su
124: # make install
1.1 root 125: </pre></blockquote>
1.1.1.2 root 126:
127: <p>
128: 2つの実行ファイルがインストールされます。
129: <tt>nono</tt> が GUI 版実行ファイル、
130: <tt>nono-cli</tt> がコマンドライン版です。
131: <q>Two executables will be installed.
1.1.1.7 root 132: <tt>nono</tt> is the GUI executable and <tt>nono-cli</tt> is
133: the command line executable.</q>
1.1 root 134:
135: </div>
136:
137:
1.1.1.13! root 138: <a name="execute"></a>
! 139: <h4>2. 実行方法 <q>How to execute</q></h4>
! 140: <div class="main">
! 141: nono は複数機種に対応しているため、設定なしでは起動できません。
! 142: デフォルトではカレントディレクトリの nono.cfg という設定ファイルを探します。
! 143: <tt>-c</tt> オプションで設定ファイル (VM ディレクトリ) の位置を指定したり、
! 144: あるいは <tt>-V</tt> オプションで設定を列挙することも出来ます。
! 145: </div>
! 146:
1.1.1.7 root 147: <a name="commandline"></a>
1.1.1.13! root 148: <h5>2.1. コマンドラインオプション <q>Command Line Option</q></h5>
1.1 root 149: <div class="main">
150: <dl>
151: <?php
152: function item($name, $desc)
153: {
154: if (!is_array($name)) {
155: $name = array($name);
156: }
157: foreach ($name as $n) {
158: print "<dt class=dt-indent><tt>{$n}</tt></dt>\n";
159: }
160: print "<dd>{$desc}</p></dd>\n";
161: }
162: function option_item($name, $desc)
163: {
164: item($name, $desc);
165: }
166:
1.1.1.6 root 167: option_item("-c <i>vmpath</i>", <<<_EOM_
168: VM ディレクトリ/設定ファイルを指定します。
169: <i>vmpath</i> がディレクトリならそのディレクトリの中の nono.cfg
170: を設定ファイルとします。
171: <i>vmpath</i> がファイルならそれを設定ファイルとします。
172: そしていずれの場合も
173: 設定ファイルがあるディレクトリを VM ディレクトリとします。
174: -c オプションを省略すると <i>vmpath</i> をカレントディレクトリとします。
175: <q>Specifies the VM directory/configuration file.
176: If <i>vmpath</i> is a directory,
177: make nono.cfg in that directory a configuration file.
178: Or if <i>vmpath</i> is a file,
179: make the specified file a configuration file.
180: And in both cases,
181: make the directory where that file is located a VM directory.
182: If <tt>-c</tt> option is omitted,
1.1.1.11 root 183: <i>vmpath</i> is considered as the current directory.</q>
1.1 root 184: _EOM_
185: );
186:
187: option_item("-f", <<<_EOM_
188: 高速モードで起動します。
189: GUI なら起動後にもメニューから変更できますが、その初期値を変えるだけです。
1.1.1.2 root 190: <q>Boot as the fast mode.
191: You can change this mode on GUI menu after boot,
1.1.1.11 root 192: and the option only changes its initial state.</q>
1.1 root 193: _EOM_
194: );
195:
196: option_item("--fontsize <i>height</i>", <<<_EOM_
197: GUI 版のみ。
198: 全サブウインドウの起動時のフォントサイズを指定します。
1.1.1.2 root 199: <tt><i>height</i></tt> には 12, 16
1.1 root 200: のいずれかを指定します。デフォルトは <tt>12</tt> です。
1.1.1.3 root 201: 起動後にメニューから変更できます。
1.1.1.2 root 202: <q>
203: GUI Only.
204: Specifies the initial fontsize on all sub windows.
205: <tt><i>height</i></tt> is one of 12 or 16.
1.1.1.3 root 206: The default value is <tt>12</tt>.
1.1.1.11 root 207: You can change this value on GUI menu after boot.</q>
1.1 root 208: _EOM_
209: );
210:
211: option_item(array("-s <i>scale</i>",
212: "--scale <i>scale</i>"), <<<_EOM_
213: GUI 版のみ。
214: メインウィンドウの起動時のスケールを実数で指定します。
215: 起動後にもメニューからプリセットされた倍率には変更可能ですが、
216: 任意倍率は起動時のみ指定可能です
217: <span class=strike>(そのうちなんとかしたい)</span>。
218: デフォルトは 1.0 です。
1.1.1.2 root 219: <q>
220: GUI Only.
221: Specifies the initial main window scale in real number.
222: You can change this scale on GUI menu after boot,
223: but unlike this option, there are only a few preset choices
224: <span class=strike>(Should be improved in someday)</span>.
225: The default value is 1.0</q>
1.1 root 226: _EOM_
227: );
228:
229: option_item("--show-config", <<<_EOM_
230: 設定ファイルと <tt>-V</tt> オプションを読み込んだ結果を表示します。
1.1.1.2 root 231: <q>Shows the result of reading configuration file and
232: parsing <tt>-V</tt> options.</q>
1.1 root 233: _EOM_
234: );
235:
236: option_item("-v", <<<_EOM_
237: バージョンを表示します。
1.1.1.2 root 238: <q>Shows the version.</q>
1.1 root 239: _EOM_
240: );
241:
242: option_item("-V <i>name</i>=<i>value</i>", <<<_EOM_
1.1.1.3 root 243: 設定ファイルで指定した <tt><i>name</i>=<i>configvalue</i></tt> の代わりに
1.1.1.2 root 244: このオプションの <tt><i>name</i>=<i>value</i></tt> を適用します。
1.1.1.12 root 245: <tt><i>name</i></tt> が正しくない場合はエラー終了します。
1.1.1.3 root 246: <q>Use this <i>name</i>=<i>value</i>
1.1.1.12 root 247: instead of <i>name</i>=<i>configvalue</i> specified in configuration file.
248: If <tt><i>name</i></tt> is not correct, it will exit on error.</q>
1.1 root 249: _EOM_
250: );
1.1.1.9 root 251:
252: option_item("-X <i>file</i>", <<<_EOM_
253: ホストの <tt><i>file</i></tt> をロードして実行します。
254: <tt><i>file</i></tt> が相対パスの場合カレントディレクトリからのパスになります。
255: ファイルが gzip 圧縮されていれば自動的に展開します。
256: (展開後の) ファイル形式は a.out (OMAGIC) か ELF で、
257: 実際にはブートローダとカーネル程度しか想定していません。
1.1.1.11 root 258: 設定の <tt>prom-image</tt>、<tt>luna-dipsw1</tt> の内容(後述)によらず
259: 内蔵の互換 PROM で起動し、直ちにホストファイルを実行します。
1.1.1.9 root 260: <q>Loads and executes host's <tt><i>file</i></tt>.
261: If <tt><i>file</i></tt> is relative path,
262: it is path from the current directory.
263: If the file is gzip'd, it is automatically extracted.
264: The supported file format (after extracting) is a.out (OMAGIC) or ELF.
265: Actually, it only assumes bootloaders or kernels.
1.1.1.11 root 266: Regardless of <tt>prom-image</tt> and <tt>luna-dipsw1</tt> configuration
267: (see below),
268: the internal emulated PROM loads and executes the host file immediately.</q>
1.1.1.9 root 269: _EOM_
270: );
1.1 root 271: ?>
272: </dl>
273:
1.1.1.2 root 274: 以下開発用。<q>For developers:</q>
1.1 root 275: <dl>
276: <?php
277: // 項目間を空けない
278: function option_dev($name, $desc)
279: {
280: print "<dt class=dt-indent><tt>{$name}</tt></dt>\n";
281: print "<dd>{$desc}</dd>\n";
282: }
283:
1.1.1.3 root 284: option_dev("-b <i>hexaddr</i>[,<i>skipcount</i>]", <<<_EOM_
1.1 root 285: デバッガのブレークポイントを 16進数で指定します。
286: _EOM_
287: );
288:
289: option_dev("-C", <<<_EOM_
290: ログをコンソールにも出力します。
291: 通常はログウィンドウにだけ出力されます。
292: _EOM_
293: );
294:
295: option_dev("-d", <<<_EOM_
296: 起動時にデバッガプロンプトで停止します。
297: _EOM_
298: );
299:
300: option_dev("-D", <<<_EOM_
301: コンソールをデバッガとして使用します。
1.1.1.12 root 302: 過去との互換性のために存在していますが、
303: <tt>-V debugger-driver=stdio</tt> と等価です。
1.1 root 304: _EOM_
305: );
306:
307: option_dev("-L <i>name1</i>=<i>level1</i>[,<i>name2</i>=<i>level2</i>,...]",
308: <<<_EOM_
309: ログレベルを指定します。
310: カンマで区切って複数指定することも出来ます。
311: <tt>-Lhelp</tt> で name の一覧を表示します。
312: _EOM_
313: );
314:
1.1.1.11 root 315: option_dev("--load-only <i>file</i>", <<<_EOM_
316: <tt>-X</tt> オプションと同様ですが、PROM のプロンプトで停止します。
317: _EOM_
318: );
319:
1.1 root 320: option_dev("-M <i>name</i>[,<i>name2</i>,...]", <<<_EOM_
321: 起動時に表示するモニタウィンドウを指定します。
322: カンマで区切って複数指定することも出来ます。
1.1.1.3 root 323: <tt>-Mhelp</tt> で name の一覧を表示します。
1.1 root 324: _EOM_
325: );
326:
327:
328: ?>
329: </dl>
330: </div>
331:
1.1.1.7 root 332:
333: <a name="configuration"></a>
1.1.1.10 root 334: <h4>3. 設定 <q>Configuration</q></h4>
1.1 root 335: <div class="main">
1.1.1.6 root 336: VM の設定ファイルはその VM ディレクトリ内の nono.cfg
337: (または -c で指定したファイル) です。
1.1 root 338: 書式は <tt>key = value</tt> 形式で1行1項目ずつです。
339: <tt>key</tt> と <tt>value</tt> の前後の空白は取り除かれます。
340: また空行と "<tt>#</tt>" で始まる行は無視します。
1.1.1.12 root 341: 知らないキーは警告を出した上で無視します。
1.1.1.6 root 342: <q>VM configuration file is nono.cfg
343: (or the file specified by -c option) in the VM directory.
1.1.1.2 root 344: Its syntax is <tt>key = value</tt> format, one per line.
345: White spaces before and after <tt>key</tt> and <tt>value</tt> are ignored.
1.1.1.12 root 346: Blank lines, lines beginning with "<tt>#</tt>" are also ignored.
347: The lines with unrecognized key are ignored with a warning.</q>
1.1 root 348: <p>
349: 設定項目は次の通りです。
1.1.1.2 root 350: <q>The configuration items are:</q>
1.1 root 351: <dl>
352: <?php
353: function config_item($name, $desc)
354: {
355: item($name, $desc);
356: }
357:
358: config_item("vmtype = <i>string</i>", <<<_EOM_
1.1.1.4 root 359: VM 種別を以下のいずれかから指定します。
360: 省略不可です。
361: <q>Specifies the VM type from the following.
1.1.1.11 root 362: This field is mandatory.</q>
1.1.1.4 root 363: <table cellspacing=0 cellpadding=0>
364: <tr><td> <td><tt>luna</tt> <td>… LUNA-I
1.1.1.12 root 365: <tr><td><td><tt>luna88k</tt> <td>… LUNA-88K
1.1.1.13! root 366: <tr class="new"><td><td><tt>x68030</tt> <td>… X68030 (Experimental)
1.1.1.4 root 367: </table>
1.1 root 368: _EOM_
369: );
370:
1.1.1.13! root 371: config_item("<span class='new'>cgrom-image = <i>path</i></span>", <<<_EOM_
! 372: <span class="new">
! 373: (X68030 Only)
! 374: X68030 の外部 CGROM イメージファイルのパスを指定します。
! 375: CGROM は 768KB です。
! 376: <i>path</i> がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
! 377: <i>path</i> が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
! 378: 空にすると nono 内蔵の互換 CGROM を使用します。
! 379: デフォルトは空です。
! 380: <q>Specifies the X68030's external CGROM image file path.
! 381: This CGROM is 768KB.
! 382: If the <i>path</i> does not have any path delimiters,
! 383: the VM directory and then its parent directory will be searched.
! 384: If the <i>path</i> is a relative path,
! 385: it will be path from the VM directory, not from the current directory.
! 386: If the <i>path</i> is empty, nono's builtin compatible CGROM will be used.
! 387: The default value is empty.</q></span>
! 388: _EOM_
! 389: );
! 390:
1.1.1.8 root 391: config_item("clock-sync = <i>value</i>", <<<_EOM_
392: 仮想マシン内の時刻の同期方法を指定します。
393: <tt>real</tt> なら実時間に同期、<tt>virtual</tt> なら仮想時間に同期します。
394: デフォルトは <tt>real</tt> です。
395: この機能は実験中のため将来予告なく仕様が変更になる可能性があります。
396: <q>Specify how to synchronize the time in virtual machine.
397: If <tt>real</tt>, synchronize with the real time;
398: if <tt>virtual</tt>, synchronize with the virtual time.
399: The default is <tt>real</tt>.
400: This feature is under experimentation and may be changed in the future
1.1.1.11 root 401: without notice.</q>
1.1.1.8 root 402: _EOM_
403: );
404:
1.1.1.13! root 405: config_item("debugger-driver = <i>string</i>", <<<_EOM_
1.1.1.12 root 406: デバッガのコンソールドライバを指定します。
407: <tt>stdio</tt>、<tt>tcp</tt>、<tt>none</tt> が選択可能です。
408: <tt>stdio</tt> は標準入出力を使用します。
409: <tt>tcp</tt> は TCP ポートで TELNET プロトコルで待ち受けます。
410: <tt>none</tt> ならホスト側とは一切通信を行いません。
411: デフォルトは <tt>none</tt> です。
412: <q>Specifies console driver of the debugger.
413: <tt>stdio</tt>, <tt>tcp</tt>, and <tt>none</tt> can be specified.
414: <tt>stdio</tt> uses the standard input/output.
415: <tt>tcp</tt> listens on TCP port using TELNET protocol.
416: <tt>none</tt> doesn't make any communication with the host.
417: The default is <tt>none</tt>.</q>
418: _EOM_
419: );
420:
1.1.1.13! root 421: config_item("debugger-tcp-port = <i>integer</i>",
1.1.1.12 root 422: <<<_EOM_
423: デバッガのコンソールドライバが tcp の時の TCP 待ち受けポート番号を指定します。
424: <q>Specify the TCP port number that debugger console driver listens.</q>
1.1 root 425: _EOM_
426: );
427:
1.1.1.8 root 428: config_item("ethernet-macaddr = <i>string</i>", <<<_EOM_
1.1.1.13! root 429: (LUNA Only)
1.1.1.8 root 430: イーサネットデバイスの仮想マシン側の MAC アドレスを指定します。
431: <tt><i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i></tt>
432: 形式で指定します。
433: <tt>auto</tt> なら自動的に決定します。
434: デフォルトは <tt>auto</tt> です。
435: _EOM_
436: );
437:
1.1.1.13! root 438: config_item("<span class='new'>fd-drive = <i>integer</i></span>", <<<_EOM_
! 439: <span class="new">(X68030 Only)
! 440: フロッピードライブの数を 0 から 4 で指定します。
! 441: デフォルトは 2 です。
! 442: <q>Specify the number of floppy drives from <tt>0</tt> to <tt>4</tt>.
! 443: The default is <tt>2</tt>.</q>
! 444: _EOM_
! 445: );
! 446:
! 447: config_item("<span class='new'>fd<i>N</i>-image = <i>path</i>", <<<_EOM_
! 448: <span class="new">(X68030 Only)
! 449: フロッピードライブ <i>N</i> に起動時に挿入するディスクイメージを指定します。
! 450: イメージパスが相対パスなら VM ディレクトリからの相対パスになります。
! 451: 起動後はメニューから操作できます。
! 452: デフォルトは空です。
! 453: <q>Specify a diskimage to be inserted to floppy drive <i>N</i> at startup.
! 454: If the <i>path</i> is relative path, it is from the VM directory.
! 455: You can also operate them from menu after startup.
! 456: The default is empty.</q>
! 457: _EOM_
! 458: );
! 459:
! 460: config_item("<span class='new'>fpu-type = <i>value</i></span>", <<<_EOM_
! 461: <span class="new">(X68030 Only)
! 462: FPU を装着するかどうか指定しています。
! 463: <tt>none</tt> なら FPU を装着しません。
! 464: <tt>68881</tt> なら FPU として 68881 を装着します。
! 465: 現状 68882 はサポートしていません。
! 466: また <tt>none</tt> の代わりに <tt>0</tt>、
! 467: <tt>68881</tt> の代わりに <tt>1</tt> と書くこともできます。
! 468: デフォルトは <tt>68881</tt> です。
! 469: LUNA-I はたぶん 68881 搭載モデルのみのため設定できません。
! 470: <q>Specify whether to install FPU or not.
! 471: If <tt>none</tt>, FPU is not installed.
! 472: If <tt>68881</tt>, 68881 FPU is installed.
! 473: 68882 is not supported yet.
! 474: And, <tt>none</tt> can also be written as <tt>0</tt>,
! 475: <tt>68881</tt> can also be written as <tt>1</tt>.
! 476: The default is <tt>68881</tt>.
! 477: This item cannot be specified on LUNA-I
! 478: because (probably) all LUNA-I has 68881.</q>
! 479: </span>
! 480: _EOM_
! 481: );
! 482:
1.1.1.12 root 483: config_item("hostcom-driver = <i>string</i>", <<<_EOM_
484: シリアルポートのホスト側ドライバを指定します。
485: <tt>stdio</tt>、<tt>tcp</tt>、<tt>none</tt> が選択可能です。
486: <tt>stdio</tt> は標準入出力を使用します。
487: <tt>tcp</tt> は TCP ポートで TELNET プロトコルで待ち受けます。
488: <tt>none</tt> ならホスト側とは一切通信を行いません。
489: デフォルトは <tt>none</tt> です。
490: <q>Specifies the host driver of serial port.
491: <tt>stdio</tt>, <tt>tcp</tt>, and <tt>none</tt> can be specified.
492: <tt>stdio</tt> uses the standard input/output.
493: <tt>tcp</tt> listens on TCP port using TELNET protocol.
494: <tt>none</tt> doesn't make any communication with the host.
495: The default is <tt>none</tt>.</q>
496: _EOM_
497: );
498:
499: config_item("hostcom-tcp-port = <i>integer</i>", <<<_EOM_
500: ホストドライバが tcp の時の TCP 待ち受けポート番号を指定します。
501: <q>Specify the TCP port number that host driver listens.</q>
502: _EOM_
503: );
504:
505: config_item("hostcom-fallback = <i>integer</i>", <<<_EOM_
506: <tt>hostcom-driver</tt> で指定したドライバが使用可能でなかった時、
507: 0 ならプロセスを終了します。1 なら <tt>none</tt> を選択して実行を継続します。
508: デフォルトは 0 です。
509: <q>Specify the behavior when the driver which is selected by
510: <tt>hostcom-driver</tt> is unusable;
511: terminate the process if 0,
512: or continue to run using the <tt>none</tt> driver if 1.
513: The default is 0.</q>
514: _EOM_
515: );
516:
1.1.1.10 root 517: config_item("hostkbd-input = <i>string</i>", <<<_EOM_
518: ホストキーボードの入力モードを指定します。
519: <tt>char</tt> ならキャラクタ入力モード、
520: <tt>jp</tt> なら日本語キーボードモードです。
521: デフォルトは <tt>char</tt> です。
522: 詳細は <a href="#aboutvm">VM について</a> の章を参照してください。
523: <q>Specifies the input mode of the host keyboard.
524: <tt>char</tt> means the character mode,
525: <tt>jp</tt> means the Japanese keyboard mode.
526: The defualt is <tt>char</tt>.
527: See <a href="#aboutvm">About VM</a> for details.</q>
528: _EOM_
529: );
530:
1.1.1.8 root 531: config_item("hostnet-driver = <i>string</i>", <<<_EOM_
1.1.1.13! root 532: (LUNA Only)
1.1 root 533: イーサネットデバイスのホスト側ドライバを指定します。
1.1.1.8 root 534: <tt>afpacket</tt>、<tt>bpf</tt>、<tt>tap</tt> のうち
535: ホスト OS がサポートしているものと <tt>auto</tt>、<tt>none</tt> が選択可能です。
536: <tt>afpacket</tt> は Linux の AF_PACKET ソケットを使用します。
537: <tt>bpf</tt> は bpf(4) デバイスを使用します。
538: <tt>tap</tt> は tap(4) インタフェースを使用します。
1.1 root 539: <tt>none</tt> ならホスト側とは一切通信を行いません。
1.1.1.8 root 540: <tt>auto</tt> ならホスト OS がサポートしているもののうち
541: <tt>tap</tt> → <tt>afpacket</tt> → <tt>bpf</tt> を順に試します。
542: デフォルトは <tt>auto</tt> です。
1.1.1.6 root 543: <q>Specifies the host driver of ethernet device.
1.1.1.8 root 544: <tt>afpacket</tt>, <tt>bpf</tt>, and <tt>tap</tt> can be specified
545: only if the host OS supports them.
546: <tt>auto</tt> and <tt>none</tt> can always be specified.
547: <tt>afpacket</tt> uses Linux's AF_PACKET socket,
548: <tt>bpf</tt> uses bpf(4) device,
549: and <tt>tap</tt> uses tap(4) interface.
550: <tt>none</tt> doesn't make any communication with the host.
551: If <tt>auto</tt> is specified,
552: it tries <tt>tap</tt>, <tt>afpacket</tt>, and <tt>bpf</tt> in that order
553: (if the host OS supports them).
554: The default is <tt>auto</tt>.</q>
1.1.1.6 root 555: _EOM_
556: );
557:
1.1.1.12 root 558: config_item("hostnet-afpacket-ifname = <i>ifname</i>", <<<_EOM_
1.1.1.13! root 559: (LUNA Only)
1.1.1.8 root 560: ホストドライバが afpacket の時にバインドするインタフェースを1つ指定します。
561: <i>ifname</i> が <tt>auto</tt>
562: なら使用可能なインタフェースを1つ自動的に選択します。
563: デフォルトは <tt>auto</tt> です。
564: なお、このホストドライバではローカルホストとの通信は出来ません。
565: <q>Specify an interface name to bind to, when the host driver is afpacket.
566: If <tt>auto</tt> is specified as <i>ifname</i>,
567: it selects an usable interface automatically.
568: The default is <tt>auto</tt>.
569: Note that this host driver cannot communicate with the localhost.</q>
570: _EOM_
571: );
572:
1.1.1.12 root 573: config_item("hostnet-bpf-ifname = <i>ifname</i>", <<<_EOM_
1.1.1.13! root 574: (LUNA Only)
1.1.1.8 root 575: ホストドライバが bpf の時にバインドするインタフェースを1つ指定します。
576: <i>ifname</i> が <tt>auto</tt>
577: なら使用可能なインタフェースを1つ自動的に選択します。
578: デフォルトは <tt>auto</tt> です。
579: なお、このホストドライバではローカルホストとの通信は出来ません。
580: <q>Specify an interface name to bind to, when the host driver is bpf.
581: If <tt>auto</tt> is specified as <i>ifname</i>,
582: it selects an usable interface automatically.
583: The default is <tt>auto</tt>.
584: Note that this host driver cannot communicate with the localhost.</q>
585: _EOM_
586: );
587:
1.1.1.12 root 588: config_item("hostnet-tap-devpath = <i>path</i>", <<<_EOM_
1.1.1.13! root 589: (LUNA Only)
1.1.1.8 root 590: ホストドライバが tap の時に使用するデバイスを1つフルパスで指定します。
591: デフォルトは <tt>auto</tt> で、この場合は自動的にデバイスを選択します。
592: この時の探し方はホスト OS によって異なります。
593: Linux なら <tt>/dev/net/tun</tt> を指定したのと同じです。
1.1.1.6 root 594: OpenBSD なら <tt>/dev/tap0</tt> から <tt>/dev/tap9</tt> まで
595: 順番にオープンできるまで試します。
596: NetBSD (と FreeBSD) ならまず <tt>/dev/tap</tt> でクローニングを試み、
597: それが失敗すれば <tt>/dev/tap0</tt> から <tt>/dev/tap9</tt> までを
598: 順番にオープンできるまで試します。
1.1.1.8 root 599: いずれの場合も VM ディレクトリかその親ディレクトリに
600: <tt>nono-ifup</tt>, <tt>nono-ifdown</tt> という名前のシェルスクリプトが必要です。
601: 何もすることがない場合でも正常終了する空のシェルスクリプトを用意してください。
602: <q>
603: Specify a device pathname, when the host driver is tap.
604: The default is <tt>auto</tt>.
1.1.1.6 root 605: The behavior in this case depends on the host OS.
606: On Linux, it's the same as <tt>/dev/net/tun</tt>.
607: On OpenBSD, it will try from <tt>/dev/tap0</tt> to <tt>/dev/tap9</tt>
608: until successful.
609: On NetBSD (and FreeBSD), it will try cloning by <tt>/dev/tap</tt> first.
610: If that fails, then try from <tt>/dev/tap0</tt> to <tt>/dev/tap9</tt>
611: until successful.
1.1.1.8 root 612: In all cases, you need to prepare two shell script files which names are
613: <tt>nono-ifup</tt> and <tt>nono-ifdown</tt> in the VM directory or
614: its parent directory.
615: Even if you don't have anything to do in these scripts,
1.1.1.11 root 616: you need to prepare empty scripts that will terminate successfully.</q>
1.1 root 617: _EOM_
618: );
619:
1.1.1.8 root 620: config_item("hostnet-fallback = <i>integer</i>", <<<_EOM_
1.1.1.13! root 621: (LUNA Only)
1.1.1.8 root 622: <tt>hostnet-driver</tt> で指定したドライバが使用可能でなかった時、
623: 0 ならプロセスを終了します。
624: 1 なら none を選択して実行を継続します。
625: デフォルトは 0 です。
626: <q>Specify the behavior when the driver which is selected by
627: <tt>hostnet-driver</tt> is unusable;
628: terminate the process if 0,
629: or continue to run using the <tt>none</tt> driver if 1.
630: The default is 0.</q>
1.1 root 631: _EOM_
632: );
633:
1.1.1.13! root 634: config_item("<span class='new'>iplrom1-image = <i>path</i></span>", <<<_EOM_
! 635: <span class="new">
! 636: (X68030 Only)
! 637: X68030 の外部 IPLROM イメージファイルのパスを指定します。
! 638: こちらは 0xfe0000..0xffffff の 128KB の部分で、IPLROM30 と呼ばれているほうです。
! 639: <i>path</i> がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
! 640: <i>path</i> が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
! 641: 空にすると無償配布されている IPLROM30 を使用します。
! 642: デフォルトは空です。
! 643: <q>Specifies the X68030's external IPLROM image file path.
! 644: This one contains 128KB at 0xfe0000..0xffffff and is known as IPLROM30.
! 645: If the <i>path</i> does not have any path delimiters,
! 646: the VM directory and then its parent directory will be searched.
! 647: If the <i>path</i> is a relative path,
! 648: it will be path from the VM directory, not from the current directory.
! 649: If the <i>path</i> is empty, the public released IPLROM30 will be used.
! 650: The default value is empty.</q></span>
! 651: _EOM_
! 652: );
! 653:
! 654: config_item("<span class='new'>iplrom2-image = <i>path</i></span>", <<<_EOM_
! 655: <span class="new">
! 656: (X68030 Only)
! 657: X68030 の外部 IPLROM イメージファイルのパスを指定します。
! 658: こちらは 0xfc0000..0xfdffff の 128KB の部分で、ROM30 と呼ばれているほうです。
! 659: <i>path</i> がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
! 660: <i>path</i> が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
! 661: 空にすると内蔵 ROM を使用します。
! 662: 内蔵 ROM は NetBSD/x68k が起動する程度の SCSI IOCS のみサポートしています。
! 663: デフォルトは空です。
! 664: <q>Specifies the X68030's external IPLROM image file path.
! 665: This one contains 128KB at 0xfc0000..0xfdffff and is known as ROM30.
! 666: If the <i>path</i> does not have any path delimiters,
! 667: the VM directory and then its parent directory will be searched.
! 668: If the <i>path</i> is a relative path,
! 669: it will be path from the VM directory, not from the current directory.
! 670: If the <i>path</i> is empty, internal emulated ROM will be used.
! 671: The ROM supports only enough SCSI IOCS to boot NetBSD/x68k.
! 672: The default value is empty.</q></span>
! 673: _EOM_
! 674: );
! 675:
1.1.1.12 root 676: config_item("keyboard-connect = <i>integer</i>", <<<_EOM_
677: 起動時にキーボードを本体に接続するかどうかを指定します。
678: 1 なら接続し、0 なら接続しません。デフォルトは 1 です。
679: 起動後はメニューから変更可能です。
680: <q>Specify whether to connect keyboard on boot.
681: If 1, it is connected; if 0, it isn't connected. The default is 1.
682: You can change it on GUI menu after boot.</q>
683: _EOM_
684: );
685:
1.1.1.9 root 686: config_item("luna-adjust-misused-epoch = <i>integer</i>", <<<_EOM_
1.1.1.13! root 687: (LUNA Only)
1.1.1.9 root 688: LUNA で誤った RTC epoch を採用している OS 向けに RTC
689: エミュレーションを補正するかどうかを
690: 指定します。0 なら補正をしません(実機と同じ動作)、
691: 1 なら補正します(現実世界と同じ動作)。
692: デフォルトは 1 で、通常 1 のままで使用して問題ありません。
693: <q>
694: Specifies whether nono corrects RTC emulation for OSes
695: that adopts wrong RTC epoch on LUNA.
696: 0 means making no correction
697: (this is the same behavior as the actual machine).
698: 1 means making correction
699: (this is the same behavior as the real world).
700: The default is 1. Normally, leave it 1.</q>
701: <p>
702: LUNA で採用している RTC (MK48T02) は2桁で保持している年の値が
703: 4 で割り切れる年をうるう年とする仕様です。
1.1.1.12 root 704: ところが NetBSD/luna68k、OpenBSD/luna88k などはこの
705: RTC の年の値を 1970年からの経過年として使用しています。
1.1.1.9 root 706: 例えば1970年はうるう年ではないため 2月28日の翌日は 3月1日ですが、
707: MK48T02 的には 00年であるためうるう年と認識し 2月28日の翌日が2月29日になります。
1.1.1.12 root 708: このように、これらの OS を使っている場合実機の
709: RTC は4年のうち約2年間、1日ずれた日付を指しているようです。
1.1.1.9 root 710: しかしながら、RTC の時刻は OS 起動時に一度読んだ後は基本的に参照しない上、
711: 今時必要なら NTP で時間を合わせるため、
712: 実機でも問題が顕在化することはまずないと思います。
713: nono の場合は実機と異なり、アプリケーション実行中しか RTC が進まないため、
714: 補正がない場合の動作が問題になるのは
715: nono を起動したまま偶数年の2月末日から日付をまたいで、
716: かつ nono を起動したまま OS を再起動して NTP などで時刻修正を行わなかった時
717: だけだと思います。
718: このオプションはほぼ開発者向けの動作確認用です。
719: _EOM_
720: );
721:
1.1 root 722: config_item("luna-dipsw1 = <i>string</i>", <<<_EOM_
1.1.1.13! root 723: (LUNA Only)
1.1 root 724: 本体前面 DIPSW#1-1..#1-8 の内容を指定します。
725: "<tt>0</tt>" を DOWN、"<tt>1</tt>" を UP として、
726: これを8つ並べた形式で、前から順に #1..#8 に対応します。
1.1.1.4 root 727: <q>Specifies status of the front panel DIPSW#1-1..#1-8 using 8 digit.
1.1.1.2 root 728: "<tt>0</tt>" means DOWN and "<tt>1</tt>" means UP.
729: The first character corresponds to #1 and
1.1.1.3 root 730: the eighth character corresponds to #8.</q>
731: <p>
732: LUNA-I でのデフォルトは <tt>11110111</tt> です。
733: 各スイッチの内容は以下のリンクを参照してください。
734: <q>On LUNA-I, the default value is <tt>11110111</tt>.
1.1.1.4 root 735: See the following link about DIPSW.</q><br>
1.1.1.3 root 736: → <a href="https://wiki.netbsd.org/ports/luna68k/luna68k_info/"
737: >NetBSD/luna68k: Information</a>
1.1 root 738: <br>
1.1.1.12 root 739: LUNA-88K でのデフォルトは <tt>11111111</tt> です。
1.1.1.4 root 740: 各スイッチの内容は以下のリンクを参照してください。
1.1.1.12 root 741: <q>On LUNA-88K, the default value is <tt>11111111</tt>.
1.1.1.4 root 742: See the following link about DIPSW.</q><br>
743: → <a href="http://man.openbsd.org/boot_luna88k.8"
744: >OpenBSD manual pages: boot_luna88k(8)</a>
1.1 root 745: _EOM_
746: );
747:
748: config_item("luna-dipsw2 = <i>string</i>", <<<_EOM_
1.1.1.13! root 749: (LUNA Only)
1.1 root 750: 本体前面 DIPSW#2-1..#2-8 の内容を指定します。
751: 書式は <tt>luna-dipsw1</tt> と同じです。
752: デフォルトは <tt>11111111</tt> です。
1.1.1.2 root 753: <q>Specifies status of the front panel DIPSW#2-1..#2-8.
754: The same syntax as <tt>luna-dipsw1</tt> is used.
755: The default value is <tt>11111111</tt>.</q>
1.1.1.3 root 756: <p>
1.1.1.4 root 757: NetBSD/luna68k のブートローダは、
758: DIPSW#2 が "<tt>11111111</tt>" なら自動的にカーネルをロードして実行し、
759: どれかでも "<tt>0</tt>" にするとプロンプトで停止するようです。
1.1 root 760: <span class=strike>(本当は #8 だけで制御するつもりだったんじゃないかという気がします)</span>
1.1.1.4 root 761: <q>NetBSD/luna68k bootloader will automatically load and execute the kernel,
762: if the DIPSW#2 is "<tt>11111111</tt>".
1.1.1.2 root 763: Otherwise, the bootloader will enter interactive mode.
764: <span class=strike>(I doubt that they actually wanted to switch with only #8)
1.1.1.11 root 765: </span></q>
1.1 root 766: _EOM_
767: );
768:
1.1.1.12 root 769: config_item("luna-video-plane = <i>integer</i>", <<<_EOM_
1.1.1.13! root 770: (LUNA Only)
1.1.1.12 root 771: LUNA のビデオボードのプレーン数を 1 か 4 で指定します。
772: 1 ならモノクロビデオボード、
773: 4 なら16色 (4bpp) ビデオボードに相当します。
774: 8bpp ボードは(まだ?)サポートしていません。
775: デフォルトは今の所 1 です (将来変更するかもしれません)。
776: <q>Specify number of planes on LUNA video board.
777: The valid values are 1 or 4.
778: 1 means a monochrome video board,
779: 4 means 16-color (4bpp) video board.
780: Note that 8bpp video board is not (yet?) supported.
781: The default value is 1 for now (It may be changed in the future).</q>
782: _EOM_
783: );
784:
1.1.1.3 root 785: config_item("monitor-rate = <i>integer</i>", <<<_EOM_
786: テキスト系モニタウィンドウの更新頻度を Hz 単位で指定します。
787: 1 から 60 までの間で指定でき、デフォルトは 20Hz です。
788: 起動後にメニューからプリセットされた頻度には変更可能です。
789: <q>Specifies refresh rate of all text monitor windows in Hz.
790: It ranges from 1 to 60. The default is 20Hz.
791: You can change this value on GUI menu after boot,
1.1.1.11 root 792: but unlike this configuration value, there are only a few preset choices.</q>
1.1.1.3 root 793: _EOM_
794: );
795:
1.1 root 796: config_item("mpu-clock = <i>value</i>", <<<_EOM_
797: MPU のクロック数を MHz 単位で指定します。
1.1.1.13! root 798: デフォルトは LUNA-I なら 20MHz、LUNA-88K <span class="new">と X68030</span> なら 25MHz です。
1.1.1.5 root 799: <q>Specifies the MPU clock in MHz.
1.1.1.13! root 800: The default value is 20MHz on LUNA-I, or 25MHz on LUNA-88K
! 801: <span class="new">and X68030</span>.</q>
1.1 root 802: _EOM_
803: );
804:
1.1.1.8 root 805: config_item("mpu-pseudo-stop = <i>integer</i>", <<<_EOM_
1.1.1.13! root 806: (LUNA-88K Only)
1.1.1.8 root 807: m88100 にて疑似 STOP 状態を有効にするかどうかを指定します。
808: 0 なら無効(実機と同じ動作)、1 なら有効で、デフォルトは 1 です。
809: m88100 には、m68k の STOP 命令 (割り込みが上がるまで何もせず待つ)
810: に相当する命令がなく、
811: 大抵ビジーウェイトループで割り込みが上がるのを待つことになります。
812: これは実機では (消費電力を減らす手段がないという些細な問題以外には)
813: 何のデメリットもないのですが、
814: エミュレータで特に高速動作させている時には割り込みが上がるまで
815: (例えば人間がキーを入力するまで) ホスト CPU パワーを使い潰してビジーウェイトループを実行し続けることになり、ホスト CPU があっつあつになります。
816: それを防ぐための機能です。
817: 特徴的な命令列を検出して実現しているので、すべての状況で動作するわけではありません。
818: _EOM_
819: );
820:
1.1.1.2 root 821: config_item("prom-image = <i>path</i>", <<<_EOM_
1.1.1.13! root 822: (LUNA Only)
1.1.1.12 root 823: LUNA-I/LUNA-88K の外部 ROM イメージファイルのパスを指定します。
1.1.1.2 root 824: <i>path</i> がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。
825: <i>path</i> が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。
826: 空にすると内蔵 ROM を使用します。
827: デフォルトは空です。
1.1.1.12 root 828: <q>Specifies the LUNA-I/LUNA-88K's external ROM image file path.
1.1.1.2 root 829: If the <i>path</i> does not have any path delimiters,
830: the VM directory and then its parent directory will be searched.
831: If the <i>path</i> is a relative path,
1.1.1.13! root 832: it will be path from the VM directory, not from the current directory.
1.1.1.2 root 833: If the <i>path</i> is empty, internal emulated ROM will be used.
834: The default value is empty.</q>
1.1 root 835: <p>
1.1.1.2 root 836: 実機を持っていない場合はこの値を空に (= デフォルトのままに) しておくと、
1.1.1.8 root 837: nono 内蔵のなんちゃって下位互換 ROM で起動します。
1.1.1.2 root 838: <q>If you does not have the real LUNA machines,
839: you can boot with nono's internal downward compatible emulated ROM
1.1.1.11 root 840: if you set this field empty (or leave it as the default).</q>
1.1 root 841: <p>
1.1.1.4 root 842: LUNA-I 実機を持っている場合は
843: ROM ファイルを指定することで実機 ROM で起動できます。
1.1.1.2 root 844: ROM ファイルは実機の 0x41000000-0x4101ffff (128KB) を保存したものです。
1.1.1.3 root 845: 今のところ ROM は V4.22 (Thu Jul 27 11:45:42 1989) のみサポートしています。
846: それ以外については何も分かりません。
1.1.1.4 root 847: <q>If you have the real LUNA-I machine,
1.1.1.2 root 848: you can boot with the real ROM spcifying the ROM file path.
1.1.1.4 root 849: The ROM file is extracted from 0x41000000-0x4101ffff (128KB) of
850: the real LUNA-I machine.
1.1.1.3 root 851: For now, only V4.22 (Thu Jul 27 11:45:42 1989) is supported.
1.1.1.11 root 852: I have no idea about other ROMs.</q>
1.1.1.4 root 853: <p>
1.1.1.12 root 854: LUNA-88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。
1.1.1.8 root 855: 今のところ ROM は version 1.20 のみサポートしています。
1.1.1.4 root 856: <q>
1.1.1.12 root 857: For LUNA-88K,
1.1.1.4 root 858: the ROM file is extracted from 0x41000000-0x4103ffff (256KB).
1.1.1.11 root 859: For now, only version 1.20 is supported.</q>
1.1.1.2 root 860: _EOM_
861: );
862:
1.1.1.3 root 863: config_item("ram-size = <i>integer</i>", <<<_EOM_
1.1.1.13! root 864: 搭載する RAM サイズを MB 単位で指定します。<q>Specifies the RAM size in MB.</q>
! 865: <ul>
! 866: <li>LUNA-I のデフォルトは 16MB です。
1.1.1.6 root 867: 16MB 未満は 4MB 単位で、
868: 16MB 以上は 255MB まで 1MB 単位で指定できます
869: (ちなみに NetBSD/luna68k の起動には最低でも 8MB 必要です)。
1.1.1.13! root 870: <q>On LUNA-I, the default is 16MB.
1.1.1.6 root 871: If the size is less than 16MB, you can specify in 4MB unit.
872: If larger, you can specify up to 255MB in 1MB unit.
1.1.1.13! root 873: By the way, NetBSD/luna68k needs at least 8MB to boot.</q>
! 874: <li>LUNA-88K のデフォルトは 64MB です。
! 875: 64MB 未満は 16MB 単位で、
! 876: 64MB 以上は暫定で 255MB まで 1MB 単位で指定できます。
! 877: <q>On LUNA-88K, the default is 64MB.
1.1.1.6 root 878: If the size is less than 64MB, you can specify in 16MB unit.
1.1.1.11 root 879: If larger, you can specify up to tentative 255MB in 1MB unit.</q>
1.1.1.13! root 880: <li><span class="new">X68030 のデフォルトは 12MB です。
! 881: 4MB から 12MB まで 1MB 単位で指定できます。
! 882: <q><span class="new">On X68030, the default is 12MB.
! 883: You can specify it in 1MB unit from 4MB to 12MB.</q></span>
! 884: </ul>
1.1 root 885: _EOM_
886: );
887:
1.1.1.12 root 888: config_item("rtc-epoch-year = <i>integer</i>", <<<_EOM_
1.1.1.13! root 889: (LUNA Only)
! 890: RTC (MK48T02) の基準年を指定します。
1.1.1.12 root 891: デフォルトは 1970年です。
892: NetBSD/luna68k、OpenBSD/luna88k はいずれも基準年を 1970年としていますので、
893: デフォルトのままで構いません。
894: ゲスト OS に 4.4BSD を使用する際は 1900 を指定します。
1.1.1.13! root 895: <q>Specifies the RTC (MK48T02) epoch year.
1.1.1.12 root 896: The default is 1970.
897: Since both NetBSD/luna68k and OpenBSD/luna88k use 1970 as epoch year,
898: there is no need to touch this value.
899: If you boot 4.4BSD on LUNA-I as the guest OS, specify 1900.</q>
900: _EOM_
901: );
902:
1.1.1.7 root 903: config_item("show-statuspanel = <i>integer</i>", <<<_EOM_
904: ステータスパネルを表示するかどうかを指定します。
905: 0 なら非表示、1 なら表示です。
906: 起動後はメニューから変更可能です。
907: <q>Specifies whether to display the status panel or not.
908: If 0, it is hidden; if 1, it is shown.
1.1.1.11 root 909: You can change it on GUI menu after boot.</q>
1.1.1.7 root 910: _EOM_
911: );
912:
1.1.1.9 root 913: config_item("spc0-id<i>N</i>-image = <i>devtype</i>[,<i>path</i>]", <<<_EOM_
914: SCSI デバイスとイメージを指定します。キーの <i>N</i> には 0 から 7 が入ります。
915: ただし ID 7 は本体が使用しますので指定しないでください。
916: 値はデバイス種別 <i>devtype</i> とディスクイメージパス <i>path</i>
917: を "<tt>,</tt>"(カンマ) で区切って並べた形式です。
918: デバイス種別 <i>devtype</i> は以下のいずれかです。
1.1.1.2 root 919: <q>
1.1.1.9 root 920: Specifies SCSI device and image. <i>N</i> in the key is 0 to 7.
1.1.1.2 root 921: But don't specify ID 7 because the host uses it.
922: The value is in a form of device type <i>devtype</i> and
1.1.1.9 root 923: the disk image path <i>path</i> separated by "<tt>,</tt>"(comma).
1.1.1.11 root 924: <i>devtype</i> can be one of the following:</q>
1.1.1.9 root 925: <ul>
926: <li><tt>hd</tt> … HD drive
927: <li><tt>cd</tt> … CD-ROM drive
928: <li><tt>mo</tt> … MO drive
929: </ul>
930:
931: <p>
932: <i>devtype</i> が <tt>hd</tt> なら <i>path</i> は省略できません。
933: <i>devtype</i> が <tt>cd</tt> か <tt>mo</tt> なら <i>path</i> は省略可能です。
934: イメージパスが相対パスなら VM ディレクトリからの相対パスになります。
935: <q>
936: If <i>devtype</i> is <tt>hd</tt>, <i>path</i> cannot be ommitted.
937: If <i>devtype</i> is <tt>cd</tt> or <tt>mo</tt>, <i>path</i> can be ommitted.
1.1.1.11 root 938: If the <i>path</i> is relative path, it is from the VM directory.</q>
1.1.1.2 root 939:
1.1 root 940: <p>
1.1.1.9 root 941: 例えば、nono.cfg と同じディレクトリに置いた sd0.img を
942: 起動 HDD ディスクイメージとして使い
943: (LUNA では通常 ID 6 をプライマリ HDD に割り当てます)、
944: ID 5 に同じディレクトリの install.iso をセットした CD ドライブを、
945: ID 4 に起動時メディアなしの MO ドライブを接続する場合は次のようになります。
946: <q>For example, if you use a harddisk image sd0.img placed in the same
947: directory as nono.cfg
948: (LUNA usually assigns ID 6 to the primary HDD),
949: ID 5 for CD-ROM drive that loads install.iso in the same directory,
950: and ID 4 for MO drive without media on boot,
1.1.1.2 root 951: write as following:</q>
1.1 root 952: <blockquote><pre>
1.1.1.9 root 953: spc0-id6-image = hd,sd0.img
954: spc0-id5-image = cd,install.iso
955: spc0-id4-image = mo
1.1 root 956: </pre></blockquote>
957: _EOM_
958: );
959:
1.1.1.4 root 960: config_item("spc0-id<i>N</i>-seektime = <i>integer</i>", <<<_EOM_
961: 指定の SCSI HDD の平均シークタイムを msec 単位で指定します。
962: 現在のデフォルトは <tt>0</tt> です (S・S・D!! S・S・D!!)。
963: 16 程度を指定すると幾分往時に思いを馳せることが出来るかもしれませんが、
964: 今の所あまり安定していません。
965: <q>Specifies the average seek time of specified SCSI HDD in msec.
966: Currently, the default value is <tt>0</tt>
967: (This may be something like SSD :-).
968: If you specify about 16 or so, you can feel nostalgic,
1.1.1.11 root 969: but this feature is still unstable.</q>
1.1.1.4 root 970: _EOM_
971: );
972:
1.1.1.9 root 973: config_item("spc0-id<i>N</i>-writeignore = <i>integer</i>", <<<_EOM_
974: 指定の SCSI HD デバイスへの書き込みを無視するかどうか指定します。
1.1 root 975: <tt>0</tt> なら通常動作(書き込みを行う)です。
976: <tt>1</tt> なら書き込みコマンドは成功したように振る舞いますが実際には
977: ディスクイメージに一切書き戻しません。
978: fsck を気にせずカーネルのデバッグとかを行いたい場合にはどうぞ。
979: 何が起きるか意味が分からない人は指定しないでください。
980: デフォルトは <tt>0</tt> です。
1.1.1.9 root 981: <q>Specifies whether nono ignores writing to SCSI HD devices.
1.1.1.2 root 982: <tt>0</tt> means normal operation (writes to the devices).
1.1.1.6 root 983: If <tt>1</tt> is specified,
1.1.1.2 root 984: nono will not actually write back to the disk image
985: even though the write command is succeeded.
986: nono's SCSI devices acts as
987: write command is successfully done but it never writes back
988: to the actual disk image.
989: This is useful for kernel debugging because it does not require fsck
990: after the kernel hangs.
991: But don't use this flag if you don't understand this paragraph.
1.1.1.9 root 992: The default value is <tt>0</tt>.</q>
993: <p>
994: ちなみに、メディアを書き込み禁止にしたい場合はこれではなく、
995: イメージファイルの書き込み権を落としてください。
996: <q>By the way, if you want to make the media write-protected,
997: clear the write permission from the image file
998: (instead of this setting).</q>
999: _EOM_
1000: );
1001:
1002: config_item("spc0-id<i>N</i>-writeprotect = <i>integer</i>", <<<_EOM_
1003: 古いオプションです。
1004: 代わりに <tt>spc0-id<i>N</i>-writeignore</tt> を使ってください。
1005: このオプションは開発用です。
1006: <q>Obsolete.
1007: Use <tt>spc0-id<i>N</i>-writeignore</tt> instead.
1.1.1.11 root 1008: This option is for developers.</q>
1.1 root 1009: _EOM_
1010: );
1.1.1.13! root 1011:
! 1012: config_item("<span class='new'>sram-sync-ramsize = <i>integer</i></span>", <<<_EOM_
! 1013: <span class="new">
! 1014: (X68030 Only)
! 1015: SRAM の RAM 容量欄を実際の RAM サイズに合わせるかどうかを指定します。
! 1016: <tt>0</tt> なら何もしません (実機と同じ)。
! 1017: <tt>1</tt> なら、アプリケーション起動時に
! 1018: SRAM の \$ed0008.L (RAM 容量) を ram-size の設定値で更新します。
! 1019: この更新は、
! 1020: アプリケーション起動時に SRAM マジックが正しく書かれている場合のみ行われます。
! 1021: デフォルトは <tt>1</tt> です。
! 1022: <q>Specify whether to synchronize a RAM size field in SRAM
! 1023: with real RAM size or not.
! 1024: If <tt>0</tt>, the application will do nothing (as same as the real).
! 1025: If <tt>1</tt>, the application updates(synchronizes)
! 1026: \$ed0008.L (RAM size) in SRAM with configuration value of ram-size.
! 1027: This update is performed once only if
! 1028: the SRAM magic string is correct at the application startup.
! 1029: The default is <tt>1</tt>.</q>
! 1030: </span>
! 1031: _EOM_
! 1032: );
1.1 root 1033: ?>
1034: </dl>
1035: </div>
1036:
1037:
1.1.1.7 root 1038: <a name="aboutvm"></a>
1.1.1.13! root 1039: <?php
! 1040: $section = 4;
! 1041: $subsection = 1;
! 1042: function sub()
! 1043: {
! 1044: global $section;
! 1045: global $subsection;
! 1046: print "${section}.${subsection}.";
! 1047: $subsection++;
! 1048: }
! 1049: ?>
1.1.1.10 root 1050: <h4>4. VM について <q>About VM</q></h4>
1.1.1.13! root 1051:
! 1052: <h5><?php sub(); ?> 実装状況 <q>Implementation Status</q>
! 1053: <div class="main">
! 1054: <table cellpadding=0 cellspacing=0>
! 1055: <tr><td style="padding-right: 1em">◎ <td>: ほぼ実装済み <q>Mostly implemented</q>
! 1056: <tr><td>○ <td>: 困らない程度には実装済み <q>Works</q>
! 1057: <tr><td>△ <td>: とりあえず動いてる程度 <q>Works somehow</q>
! 1058: <tr><td>× <td>: 未実装 <q>Not implemented</q>
! 1059: <tr><td>— <td>: 実装予定なし <q>Not planned</q>
! 1060: </table>
! 1061: <style type="text/css">
! 1062: .pghd {
! 1063: border: 0px none;
! 1064: border-bottom: 1px solid black;
! 1065: padding-top: 1em;
! 1066: }
! 1067: .pgth {
! 1068: border-top: 0px none;
! 1069: border-left: 1px solid black;
! 1070: border-right: 1px solid black;
! 1071: border-bottom: 1px solid black;
! 1072: padding-right: 1ex;
! 1073: }
! 1074: .pgtd {
! 1075: border-top: 0px none;
! 1076: border-left: 0px none;
! 1077: border-right: 1px solid black;
! 1078: border-bottom: 1px solid black;
! 1079: }
! 1080: </style>
! 1081: <table cellspacing=0 cellpadding=0>
! 1082: <?php
! 1083: $table = <<<__EOM__
! 1084: LUNA-I
! 1085: MPU (68030) ○ キャッシュ未実装 <q>Cache not implemented</q>
! 1086: FPU (68881) ◎
! 1087: BT454 ◎
! 1088: CRTC2 ○ 標準で使用する値のみサポート
! 1089: Frame buffer ◎
! 1090: Keyboard/Mouse ◎
! 1091: SIO ◎
! 1092: PIO ○
! 1093: Ethernet (AM7990) ◎ LARF を除く <q>Except LARF</q>
! 1094: NVRAM&RTC (MK48T02) ◎
! 1095: Front LCD ◎
! 1096: SPC ◎
! 1097: SCSI HD/CD/MO Devices ○
! 1098: XP とその向こう<wbr><q>XP and beyonds</q> ×
! 1099: 電源 <q>Power Circuit</q> ○
! 1100:
! 1101: LUNA-88K specific
! 1102: MPU (88100 part) ○ マルチプロセッサ未実装、バグも未実装? <wbr><q>MP (and bugs?) not implemented</q>
! 1103: MPU (88200 part) ◎
! 1104: MPU (88110) — 実装予定なし <q>Not planned</q>
! 1105: FUSEROM ○
! 1106:
! 1107: X68030
! 1108: MPU (68030) ○ キャッシュ未実装、ファンクションコード未実装 <wbr><q>Cache and FC not implemented</q>
! 1109: MPU (68EC030) — 実装予定なし <q>Not planned</q>
! 1110: FPU (68881) ◎ 68882 は未実装 <q>68882 not implemented</q>
! 1111: DMAC ○
! 1112: CRTC/VC △ 768x512 のテキスト画面のみサポート <wbr><q>Only 768x512 text screen supported</q>
! 1113: FDC/FDD ○
! 1114: 標準・拡張エリアセット <q>Areaset</q> ×
! 1115: ADPCM/OPM ×
! 1116: グラフィック機能全般 <wbr><q>All other graphics</q> × 当面予定なし <q>Not scheduled</q>
! 1117: Keyboard ◎ TVコントロールを除く <q>Except TV Control</q>
! 1118: Mouse ◎ 本体接続のみ
! 1119: MFP △
! 1120: PPI △
! 1121: Printer ×
! 1122: RTC ◎ アラームを除く <q>Except Alarm</q>
! 1123: SPC ◎
! 1124: SCSI HD/CD/MO Devices ○
! 1125: SCC ◎
! 1126: SRAM ◎
! 1127: システムポート<q>System port</q> △
! 1128: テキスト画面<q>Text screen</q> ○
! 1129: 電源 <q>Power curcuit</q> ○
! 1130: Nereid Ethernet ×
! 1131: Nereid Bank memory ×
! 1132: Nereid USB — 実装予定なし <q>Not planned</q>
! 1133: 拡張メモリ <q>Extended memory</q> ×
! 1134: __EOM__;
! 1135: $table_lines = preg_split("/\n/", $table);
! 1136: foreach ($table_lines as $line) {
! 1137: if ($line == "") {
! 1138: continue;
! 1139: } else if (preg_match("/\t/", $line) == false) {
! 1140: // table title
! 1141: print "<tr><td colspan=3 class=pghd>{$br}{$line}\n";
! 1142: $br = "";
! 1143: } else {
! 1144: list ($h, $m, $d) = preg_split("/\t+/", $line, 3);
! 1145: print "<tr><td class=pgth>{$h}\n";
! 1146: print " <td class=pgtd style='padding: 0 1ex 0 1ex'>{$m}\n";
! 1147: print " <td class=pgtd style='padding-left: 0.5ex'>{$d}\n";
! 1148: }
! 1149: }
! 1150: ?>
! 1151: </table>
! 1152: </div>
! 1153:
! 1154: <h5><?php sub(); ?> MPU (68030)</h5>
! 1155: <div class="main"><span class="new">
! 1156: 68030 はキャッシュが未実装です。
! 1157: これに伴い命令の所要クロック数もまだ正しくなく、
! 1158: そのためクロック測定などでは正確な値が出ません。
! 1159: また ATC (アドレス変換キャッシュ) は実際の仕様とは異なり高速化してあります。
! 1160: <q>68030 cache is not implemented.
! 1161: Therefore, number of clock cycle is not correct.
! 1162: ATC (Address Translation Cache) is differ from and faster than the real 68030.</q>
! 1163: </span>
! 1164: </div>
! 1165:
! 1166: <h5><?php sub(); ?> LUNA の ROM エミュレーション</h5>
! 1167: <div class="main"><span class="new">
! 1168: LUNA-I、LUNA-88K で PROM の外部イメージを指定しない場合
! 1169: (<tt>prom-image</tt> が空の場合)、
! 1170: 内蔵の独自 ROM が動作し、コンソールモニタが起動します。
! 1171: このコンソールモニタの動作は実機のそれとよく似ていますが、
! 1172: これは実機確認の際に操作方法が違いすぎると(自分が)困るため仕方なく似せているもので、
! 1173: 忠実なコピーを作る目的ではありません。
! 1174: </span>
! 1175: </div>
! 1176:
! 1177: <h5><?php sub(); ?> X68030 の ROM (ROM30) エミュレーション</h5>
! 1178: <div class="main"><span class="new">
! 1179: X68030 で ROM30 の外部イメージを指定しない場合
! 1180: (<tt>iplrom2-image</tt> が空の場合)、内蔵の独自 ROM が組み込まれます。
! 1181: 本来の ROM30 には SCSIIOCS の他に ROM デバッガなどが含まれていますが、
! 1182: 内蔵 ROM はこのうち SCSIIOCS を NetBSD/x68k が起動するのに十分なだけしか
! 1183: 実装していません。
! 1184: Human68k を起動する場合はお手元の実機から ROM イメージを作成してください。
! 1185: </span>
! 1186: </div>
! 1187:
! 1188: <h5><?php sub(); ?> ステータスパネル <q>Status Panel</q></h5>
1.1.1.7 root 1189: <div class="main">
1190: ステータスパネル中央にあるパフォーマンスメータのアイコンは
1191: 高速モードの状態を表示しています。
1192: ダブルクリックすると高速/等速モードの指定を切り替えることができます。
1193: <q>The performance meter's icon at the center of the status panel
1194: shows the VM speed status.
1.1.1.11 root 1195: You can switch full speed / syncronized mode by double-clicking
1196: on this icon.</q>
1.1.1.7 root 1197: <table>
1198: <tr><td valign=top>
1199: <image src="image/sp-ffmark0.png" style="padding:0.5ex; background-color:white">
1200: <td valign=top>…
1201: <td valign=top>
1202: マークなしの場合、ユーザが等速モードを指定していて、等速モードで実行中です。
1203: <q>When no icons are displayed,
1204: the user has specified syncronized mode and
1205: the VM is running in synchronized mode.</q>
1206: <tr><td valign=top>
1.1.1.11 root 1207: <image src="image/sp-ffmark2.png" style="padding:0.5ex; background-color:white">
1.1.1.7 root 1208: <td valign=top>…
1209: <td valign=top>
1.1.1.11 root 1210: 三角3つの場合、ユーザが高速モードを指定していて、高速モードで実行中です。
1.1.1.8 root 1211: 高速モード中はパーセントではなく何倍速で動作しているかを表します。
1.1.1.11 root 1212: <q>When an icon (three triangles) is displayed,
1.1.1.7 root 1213: the user has specified full speed mode and
1.1.1.11 root 1214: the VM is running in full speed mode.
1.1.1.7 root 1215: <tr><td valign=top>
1.1.1.11 root 1216: <image src="image/sp-ffmark1.png" style="padding:0.5ex; background-color:white">
1.1.1.7 root 1217: <td valign=top>…
1218: <td valign=top>
1.1.1.11 root 1219: 三角2つの場合、ユーザが高速モードを指定していて、等速モードで実行中です。
1220: 以下のいずれかの状態で起きます。
1221: <q>When an icon (two triangles) is displayed,
1.1.1.7 root 1222: the user has specified full speed mode and
1.1.1.11 root 1223: the VM is running in synchronized mode.
1224: This will happen when any of the following occurs:</q>
1225: <ul>
1226: <li>キー押下中(後述)あるいはキーボードブザー発声中
1227: <q>When any keys are pressed (see below),
1228: or the keyboard buzzer is sounding.
1229: <li>STOP instruction on m68k.
1230: <li>pseudo STOP state on m88k.
1231: </ul>
1.1.1.7 root 1232: </table>
1233: </div>
1234:
1.1.1.13! root 1235: <h5><?php sub(); ?> キー入力モード <q>Key input mode</q></h5>
1.1.1.10 root 1236: <div class="main">
1.1.1.13! root 1237: LUNA も X68030 もキーボードは通常日本語キーボードです
! 1238: (LUNA には英語キーボードも存在するようですが…)。
1.1.1.10 root 1239: そのため、ホストが日本語キーボードの場合とそうでない場合のために
1240: 2つの入力モードを用意しています。
1241: どちらも一長一短があります。
1.1.1.13! root 1242: <q>LUNA and X68030 has the Japanese keyboard
! 1243: (though I ever heard there are US keyboard for LUNA...).
1.1.1.10 root 1244: So nono provides two input modes
1245: for Japanese keyboard users and non Japanese keyboard users.
1246: Both have advantages and disadvantages.</q>
1247: <p>
1248: JP キーボードモードは、ホストが日本語キーボードであることを前提に
1249: 対応するキーの押下、開放をその都度 VM に入力します。
1250: メリットとしては動作が実機に近くなり、
1251: 特にキーリピート(をハードウェアが行わないこと)も忠実に再現可能です。
1252: デメリットは ALT + TAB やアクセラレータキーでメニューを開く場合などに
1253: キー入力が残ることがあることです
1254: (キーを押した後でフォーカスが外れるとキーを離したことが
1255: アプリケーションに通知されないため)。
1256: またホストが日本語キーボードでなければ使いづらいです。
1257: <q>JP keyboard mode assumes that the host uses the Japanese keyboard.
1258: Each time you presses and releases a key,
1259: nono sends the corresponding key-pressed or key-released to the VM.
1260: One advantage is that it's close to the real machine behavior,
1261: and another is that it can reproduce
1262: the LUNA keyboard itself does not perform a key repeat.
1263: On the other hand,
1264: one disadvantage is that key sometimes remains pressed,
1265: especially when you enter ALT + TAB to switch the application
1266: or enter accelerator key to open the menu
1267: (If the application loses the focus after the key is pressed,
1268: the application will not receive the subsequent key release).
1269: And another disadvantage is that
1.1.1.11 root 1270: it will be hard to use for non Japenese keyboard users.</q>
1.1.1.10 root 1271: <p>
1272: 一方、キャラクタ入力モードは、ホストから入力された「文字」を
1.1.1.13! root 1273: 再び LUNA/X68030 のキーコードに解釈し直して VM に入力するモードです。
1.1.1.10 root 1274: 例えばゲスト OS に "@" を入力したい場合、
1275: US キーボードなら [SHIFT] + [2] を、
1276: JP キーボードなら [@] キーを押しますが、
1277: どちらも VM には [@] キーの押下、[@] キーの開放が連続して送られます。
1278: US キーボードで [SHIFT] を押したことは通知されません。
1279: 逆に "=" を入力したい場合、
1280: US キーボードなら [=] キーを、
1281: JP キーボードなら [SHIFT] + [-] を押しますが、
1282: どちらも VM には
1283: [SHIFT]押下 → [-]押下 → [-]開放 → [SHIFT]開放のシーケンスが送られます。
1284: このようにホストキーボードのレイアウトによらず、
1285: 入力したい文字が入力できるようになり、
1286: 通常のタイピングで困ることはないと思います。
1287: デメリットは、通常の文字入力以外のタイピングはほぼ出来ないことです。
1288: [SHIFT] キーを押したままにすることや、
1289: 文字が入力できないキーの組み合わせは入力出来ません。
1290: もう一つのデメリットはキーリピート(をハードウェアが行わないこと)が再現できず、
1291: ホスト側のキーリピートが効いてしまうことです
1292: (本来キーリピートが動作しない ROM やブートローダでもキーリピートが効くことは
1293: 一般ユーザからはメリットに感じられるかも知れませんが)。
1294: <q>In contrast, in the character mode, when you type a character,
1.1.1.13! root 1295: nono re-converts it into the LUNA/X68030's key code and sends it to the VM.
1.1.1.10 root 1296: For example if you want to type "@" in the guest OS,
1297: you would press [SHIFT] + [2] on the US keyboard or [@] on the JP keyboard.
1298: In both cases, the sequence of
1299: [@]-pressed and [@]-released will be sent to the VM.
1300: Note that the fact that you pressed [SHIFT] key on the US keyboard
1301: will not be sent to the VM.
1302: Another example, if you want to type "=",
1303: you would press [=] on the US keyboard or [SHIFT] + [-] on the JP keyboard.
1304: In both cases, the sequence of
1305: [SHIFT]-pressed, [-]-pressed, [-]-released, and [SHIFT]-released
1306: will be sent to the VM.
1307: Thus, you can type what character you want to type,
1308: regardless of your keyboard layout.
1309: Of course there are some disadvantages.
1310: Firstly, it's hard to type any special characters,
1311: for example, you can not type any key conbinations
1312: that don't generate a character.
1313: Or you can not hold [SHIFT] key pressed.
1314: Secondly, the key repeat works (by the host),
1315: even though it should not work as a correct emulation
1316: (Although some of you may feel it an advantage).</q>
1317: </div>
1318:
1.1.1.13! root 1319: <h5><?php sub(); ?> キャラクタ入力モードのキーコード対応表
1.1.1.10 root 1320: <q>Keycode table in the character mode</h5>
1321: <div class="main">
1322: キャラクタ入力モードでの、ホストから入力した文字と
1323: VM に送信されるキーの対応は次の通りです。
1324: ファンクションキーとカーソルキーは文字ではありませんが
1325: 特別に対応しています。
1.1.1.13! root 1326: ここに記載のないゲストキーはソフトウェアキーボードからのみ入力できます。
1.1.1.10 root 1327: <q>The following table shows the correspondence between
1328: the character that typed from the host
1329: and the key that will be sent to the VM.
1330: nono can recognize the function keys and arrow keys.
1.1.1.13! root 1331: The keys that not listed in this table can
1.1.1.10 root 1332: only be typed from the software keyboard window.</q>
1333: <p>
1334: <center>
1335: <style type="text/css">
1336: .keytable-whole {
1337: display: inline-block;
1338: vertical-align: top;
1339: border: solid 1px;
1340: }
1341: .keytable-middle {
1342: margin-left: 1em;
1343: margin-right: 1em;
1344: }
1345:
1346: .keytable-head {
1347: text-align: left;
1348: border-bottom: solid 1px;
1349: }
1350: .keytable-headl {
1351: padding-right: 1em;
1352: }
1353:
1354: .keytable-tdl {
1355: padding-right: 1em;
1356: }
1357: .keytable-tdr {
1358: }
1359: </style>
1360: <?php
1361: $str = <<<__EOM__
1362: <tt>a</tt> 〜 <tt>z</tt> [A] 〜 [Z]
1363: <tt>0</tt> 〜 <tt>9</tt> [0] 〜 [9]
1364: SPACE [SPACE]
1365: <tt>-</tt> [-]
1366: <tt>^</tt> [^]
1367: <tt>\</tt> [\]
1368: <tt>@</tt> [@]
1369: <tt>[</tt> [[]
1370: <tt>;</tt> [;]
1371: <tt>:</tt> [:]
1372: <tt>]</tt> []]
1373: <tt>,</tt> [,]
1374: <tt>.</tt> [.]
1375: <tt>/</tt> [/]
1376:
1377: <tt>A</tt> 〜 <tt>Z</tt> [SHIFT]+[A] 〜 [SHIFT]+[Z]
1378: <tt>!</tt> [SHIFT]+[1]
1379: <tt>"</tt> [SHIFT]+[2]
1380: <tt>#</tt> [SHIFT]+[3]
1381: <tt>$</tt> [SHIFT]+[4]
1382: <tt>%</tt> [SHIFT]+[5]
1383: <tt>&</tt> [SHIFT]+[6]
1384: <tt>'</tt> [SHIFT]+[7]
1385: <tt>(</tt> [SHIFT]+[8]
1386: <tt>)</tt> [SHIFT]+[9]
1387: <tt>=</tt> [SHIFT]+[-]
1388: <tt>~</tt> [SHIFT]+[^]
1389: <tt>|</tt> [SHIFT]+[\]
1390: <tt>`</tt> [SHIFT]+[@]
1391: <tt>{</tt> [SHIFT]+[[]
1392: <tt>+</tt> [SHIFT]+[;]
1393: <tt>*</tt> [SHIFT]+[:]
1394: <tt>]</tt> [SHIFT]+[]]
1395: <tt><</tt> [SHIFT]+[,]
1396: <tt>></tt> [SHIFT]+[.]
1397: <tt>?</tt> [SHIFT]+[/]
1398: <tt>_</tt> [SHIFT]+[_]
1399:
1400: F1 〜 F10 [PF1] 〜 [PF10]
1.1.1.13! root 1401: <span class='new'>F11</span> <span class='new'>[PF10]</span>
1.1.1.10 root 1402: ↑ [↑]
1403: ← [←]
1404: → [→]
1405: ↓ [↓]
1.1.1.13! root 1406: <tt>^@</tt> [CTRL]+[@]
! 1407: <tt>^A</tt> 〜 <tt>^Z</tt> [CTRL]+[A] 〜 [CTRL]+[Z]
! 1408: <tt>^[</tt> [ESC]
! 1409: <tt>^\</tt> [CTRL]+[\]
! 1410: <tt>^]</tt> [CTRL]+[]]
! 1411: <tt>^^</tt> [CTRL]+[^]
! 1412: <tt>^_</tt> [CTRL]+[_]
! 1413: <tt>^H</tt> [BS]
! 1414: <tt>^I</tt> [TAB]
! 1415: <tt>^M</tt> [Enter]
1.1.1.10 root 1416: __EOM__;
1417: $table = array();
1418: $table[0] = array();
1419: $table[1] = array();
1420: $table[2] = array();
1421: $i = 0;
1422: foreach (split("\n", $str) as $s) {
1423: if ($s == "") {
1424: $i++;
1425: continue;
1426: }
1427: $s = preg_replace("/^\t+/", "", $s);
1428: list ($hkey, $gkey) = preg_split("/\t+/", $s);
1429: $table[$i][] = array($hkey, $gkey);
1430: }
1431:
1432: for ($j = 0; $j < count($table); $j++) {
1433: switch ($j) {
1434: case 0: $classname = "left"; break;
1.1.1.13! root 1435: default: $classname = "middle"; break;
! 1436: case 3: $classname = "right"; break;
1.1.1.10 root 1437: }
1438: print "<table class='keytable-whole keytable-${classname}'";
1439: print " cellspacing=0 cellpadding=1>\n";
1440: print "<tr>";
1441: print "<th class='keytable-head keytable-headl'>HostChar";
1442: print "<th class='keytable-head keytable-headr'>GuestKey\n";
1443: for ($i = 0; $i < count($table[$j]); $i++) {
1444: list ($h, $g) = $table[$j][$i];
1445: print "<tr>";
1446: print "<td class='keytable-tdl'>{$h}";
1447: print "<td class='keytable-tdr'>${g}\n";
1448: }
1449: print "</table>\n";
1450: }
1451: ?>
1452: </center>
1453: </div>
1454:
1.1.1.13! root 1455: <h5><?php sub(); ?> JP キーボードモードのキーコード対応表
1.1.1.10 root 1456: <q>Keycode table in the JP keyboard mode</q></h5>
1457: <div class="main">
1458: JP キーボードモードでの、ホストキーと VM に送信されるキーの対応は次の通りです。
1.1.1.13! root 1459: ここに記載のないキーはソフトウェアキーボードからのみ入力出来ます。
1.1.1.10 root 1460: <q>The following table shows the correspondence between
1461: the host key and the guest key.
1.1.1.13! root 1462: The keys that not listed in this table can only be enter from
1.1.1.10 root 1463: the software keyboard window.</q>
1464: <p>
1465: <center>
1466: <?php
1467: $str = <<<__EOM__
1468: [0] 〜 [9] [0] 〜 [9]
1469: [A] 〜 [Z] [A] 〜 [Z]
1470: [-] [-]
1471: [^] [^]
1472: [\] [\]
1473: [@] [@]
1474: [[] [[]
1475: [;] [;]
1476: [:] [:]
1477: []] []]
1478: [,] [,]
1479: [.] [.]
1480: [/] [/]
1481: [_] [_]
1482:
1483: [ESC] [ESC]
1484: [TAB] [TAB]
1485: [CTRL] [CTRL]
1486: [BS] [BS]
1487: [Enter] [Enter]
1488: [F1] 〜 [F10] [PF1] 〜 [PF10]
1.1.1.13! root 1489: <span class='new'>[F11]</span> <span class='new'>[PF10]</span>
! 1490: [SHIFT-L] [SHIFT-L]
! 1491: [SHIFT-R] [SHIFT-R]
! 1492: [↑] [↑]
! 1493: [←] [←]
! 1494: [→] [→]
! 1495: [↓] [↓]
! 1496:
1.1.1.10 root 1497: [DEL] Numpad[DEL]
1498: Numpad[0]〜[9] Numpad[0]〜[9]
1499: Numpad[+] Numpad[+]
1500: Numpad[-] Numpad[-]
1501: Numpad[*] Numpad[*]
1502: Numpad[/] Numpad[/]
1503: Numpad[=] Numpad[=]
1504: Numpad[.] Numpad[.]
1505: Numpad[Enter] Numpad[Enter]
1506: __EOM__;
1507: $table = array();
1508: $table[0] = array();
1509: $table[1] = array();
1510: $table[2] = array();
1511: $i = 0;
1512: foreach (split("\n", $str) as $s) {
1513: if ($s == "") {
1514: $i++;
1515: continue;
1516: }
1517: $s = preg_replace("/^\t+/", "", $s);
1518: list ($hkey, $gkey) = preg_split("/\t+/", $s);
1519: $table[$i][] = array($hkey, $gkey);
1520: }
1521:
1522: for ($j = 0; $j < count($table); $j++) {
1523: switch ($j) {
1524: case 0: $classname = "left"; break;
1525: case 1: $classname = "middle"; break;
1526: case 2: $classname = "right"; break;
1527: }
1528: print "<table class='keytable-whole keytable-${classname}'";
1529: print " cellspacing=0 cellpadding=0>\n";
1530: print "<tr>";
1531: print "<th class='keytable-head keytable-headl'>HostKey";
1532: print "<th class='keytable-head keytable-headr'>GuestKey\n";
1533: for ($i = 0; $i < count($table[$j]); $i++) {
1534: list ($h, $g) = $table[$j][$i];
1535: print "<tr>";
1536: print "<td class='keytable-tdl'>{$h}";
1537: print "<td class='keytable-tdr'>${g}\n";
1538: }
1539: print "</table>\n";
1540: }
1541: ?>
1542: </center>
1543: </div>
1544:
1.1.1.13! root 1545: <h5><?php sub(); ?> キーリピート <q>Key Repeat</q></h5>
1.1.1.7 root 1546: <div class="main">
1547: LUNA では、キーボードがハードウェア側でキーリピートを行わず、
1548: ソフトウェア(OS など)がキーリピートの処理を行います。
1549: そのため、キーリピートを実装していない LUNA の PROM や
1550: NetBSD/luna68k のブートローダではキーリピートは起きず、
1551: キーリピートを実装している NetBSD/luna68k カーネルではキーリピートが起こせます。
1.1.1.8 root 1552: キーリピートを起こす間隔をゲストのソフトウェアが測定しているということは、
1.1.1.7 root 1553: VM が高速動作するとキーリピートもそれに合わせて発生することになり、
1554: これをホスト側から防ぐ手段はありません。
1555: そこで nono ではキー入力が発生している間
1556: (キーが一つでも押されてからキーが全て離されるまでの間)、
1557: 高速モードが指示されていても VM を一時的に等速モードに落として実行します。
1558: 上記のアイコンがそれを区別しているのはこのためです。
1559: そのため、何らかの理由でキーが入りっぱなしになった場合
1560: (ALT + TAB やアクセラレータキーでメニューを開くと起きがちです)
1561: 高速モードが抑制されたままということが起きえます。
1562: その場合はソフトウェアキーボードからキー入力を解除するなどしてください。
1.1.1.10 root 1563: <q>On LUNA,
1.1.1.7 root 1564: key repeat is done by software(OS), not by the keyboard hardware.
1565: For this reason,
1566: key repeat doesn't occur on LUNA's PROM or NetBSD/luna68k's bootloader
1567: that don't implement it, and
1568: key repeat occurs on NetBSD/luna68k kernel that implements it.
1.1.1.8 root 1569: Since the timing of key repeat is measured by the guest software,
1.1.1.7 root 1570: if the VM is running faster than the real,
1571: the key repeat will occur faster, too.
1572: The host application doesn't have the way to avoid it.
1573: Therefore, nono will temporarily suppress the full speed mode
1574: while any keys are pressed.
1575: That is why the above-mentioned icon distinguishes them.
1.1.1.8 root 1576: If keys continue to be pressed for some reasons,
1.1.1.7 root 1577: the VM also continues to run syncronized mode.
1.1.1.11 root 1578: In this case, you can resolve it by using the software keyboard window.</q>
1.1.1.7 root 1579: </div>
1580:
1581:
1.1.1.13! root 1582:
1.1.1.7 root 1583: <a name="tryit"></a>
1.1.1.10 root 1584: <h4>5. 実行してみる <q>Try it</q></h4>
1585: <h5>5.1. NetBSD/luna68k を実行してみる <q>Try NetBSD/luna68k</q></h5>
1.1 root 1586: <div class="main">
1.1.1.8 root 1587: つついさんが NetBSD/luna68k 9.2 の liveimage を用意されています。
1588: <q>Tsutsui-san has provided a liveimage of NetBSD/luna68k 9.2.</q>
1589: <dl>
1.1.1.11 root 1590: <dd><a href="https://twitter.com/tsutsuii/status/1436381589211017217"
1591: >https://twitter.com/tsutsuii/status/1436381589211017217</a><br>
1.1.1.8 root 1592: </dl>
1593: ここではこれを起動してみます。<q>Let's try it.</q>
1.1.1.2 root 1594: <br>
1595: <ol>
1596: <li>どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、
1.1 root 1597: その中に VM ディレクトリを用意します (例えば ~/nono/luna/)。
1.1.1.3 root 1598: <q>Create a directory somewhere for nono (for example ~/nono/),
1.1.1.8 root 1599: and create subdirectories for individual VMs in it
1600: (for example ~/nono/luna/).</q>
1.1 root 1601:
1.1.1.3 root 1602: <li>以下のリンクからイメージファイルをダウンロードして展開し、
1.1.1.2 root 1603: VM ディレクトリ ~/nono/luna/ に置きます。
1.1.1.3 root 1604: <q>Download imagefile from the following link,
1.1.1.7 root 1605: extract it and place it in the VM directory, ~/nono/luna/.</q>
1.1.1.3 root 1606: <blockquote>
1.1.1.11 root 1607: <a href="http://teokurebsd.org/netbsd/liveimage/20210910-luna68k/"
1608: >http://teokurebsd.org/netbsd/liveimage/20210910-luna68k/</a>
1.1.1.3 root 1609: </blockquote>
1.1.1.2 root 1610:
1.1.1.8 root 1611: <li>以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/luna/
1612: に作成します。
1613: ここでは説明を簡単にするためネットワークなしにしていますが、
1614: ネットワーク設定は必要に応じて行ってください。
1.1.1.7 root 1615: <q>Create a configuration file nono.cfg in the VM directory, ~/nono/luna/,
1.1.1.8 root 1616: with following contents.
1617: By the way, to simplify the explanation, we assume there is no network here.
1618: However, please configure the network if necessary.</q>
1.1.1.2 root 1619: <blockquote class="file"><pre>
1620: vmtype = luna
1.1.1.11 root 1621: spc0-id6-image = hd,liveimage-luna68k-with-packages-20210910.img
1.1.1.8 root 1622: hostnet-driver = none
1.1.1.2 root 1623: </pre></blockquote>
1.1.1.8 root 1624:
1.1.1.2 root 1625: <li><tt>nono -c ~/nono/luna</tt> で起動します
1626: (VM ディレクトリに自動的に NVRAM.DAT が作られます)。
1627: <q>Run as <tt>nono -c ~/nono/luna</tt>.
1.1.1.4 root 1628: (NVRAM.DAT will be created automatically in the VM directory)</q>
1.1.1.13! root 1629:
1.1.1.2 root 1630: <li>Emulated ROM Monitor が起動するので、
1631: 初回は以下のように入力すると NetBSD が起動します。
1632: <q>The emulated ROM Monitor will be executed.
1633: Then, only for the first time,
1634: entering the following can boot NetBSD.</q>
1.1.1.8 root 1635: <blockquote><pre>
1636: k⏎
1637: ⏎
1638: ⏎
1639: d⏎
1640: boot⏎
1641: g⏎
1642: x⏎
1643: </pre></blockquote>
1644: 画面はこんな感じのはずです (太字が入力部分)。
1645: <q>You will see a screen like this. The bold text indicates
1646: the characters you need to enter.</q>
1.1.1.2 root 1647: <blockquote class="file"><pre>
1.1.1.11 root 1648: NONO <?=$nono_ver?> Emulated ROM Monitor for LUNA-I
1.1.1.8 root 1649:
1650: ** NVRAM Initialized.
1651:
1652: ><b>k⏎</b>
1653: controller: dk ?<b>⏎</b>
1654: drive unit: 0 ?<b>⏎</b>
1655: partition : c ?<b>d⏎</b>
1656: filename : vmunix ?<b>boot⏎</b>
1657: ><b>g⏎</b>
1658: Loaded. Entry point = $00700000
1659: ><b>x⏎</b>
1.1.1.2 root 1660: </pre></blockquote>
1661: この内容は NVRAM.DAT に記録されているので次回以降は直接 NetBSD が起動します。
1.1.1.7 root 1662: <q>The information you have just entered is recorded in the NVRAM,
1.1.1.13! root 1663: so next time it will boot NetBSD automatically.</q>
1.1.1.8 root 1664: <li>初回起動時、
1665: Updating fontconfig cache はあほみたいに時間がかかりますが、
1666: nono がハングアップしてるわけではありません(>_<)。
1.1.1.13! root 1667: また初回は起動後数時間めちゃくちゃ重たいですが、
1.1.1.8 root 1668: これはバックグラウンドで makemandb が動くためで
1669: nono のせいではありません(>_<)。
1670: <q>At the first boot, you will see the console stops after printing
1671: "Updating fontconfig cache".
1672: This is because the infamous fontconfig takes very looooong time.
1673: nono would not have hang-up.
1.1.1.13! root 1674: In addition, at the first boot, you will feel it's too heavy for several hours.
1.1.1.8 root 1675: This is because the infamous makemandb(8) runs heavily in the background
1676: for a looooong time.
1677: It's very sad to me that these two accidents which are far from the ideal
1.1.1.12 root 1678: are the first experiences of newcomers.</q>
1.1.1.8 root 1679:
1680: <li>終了する時は root
1681: ユーザで “<tt>shutdown -p now</tt>” を実行してください。
1682: LUNA はソフトウェアから電源オフでき、
1683: VM の電源オフで nono も終了します。
1684: <q>To quit, type “<tt>shutdown -p now</tt>” as the root user.
1685: LUNA can be powered off by software,
1686: and nono will terminate when the VM is powered off.</q>
1687: </ol>
1688: </div>
1689:
1.1.1.10 root 1690: <h5>5.2. OpenBSD/luna88k を実行してみる <q>Try OpenBSD/luna88k</q></h5>
1.1.1.8 root 1691: <div class="main">
1.1.1.12 root 1692: あおやまさんが OpenBSD/luna88k 7.0 の liveimage を用意されています。
1693: <q>Aoyama-san has provided a liveimage of OpenBSD/luna88k 7.0.</q>
1.1.1.8 root 1694: <dl>
1.1.1.12 root 1695: <dd><a href="https://twitter.com/ao_kenji/status/1473611893386661888"
1696: >https://twitter.com/ao_kenji/status/1473611893386661888</a>
1.1.1.8 root 1697: </dl>
1698: ここではこれを起動してみます。<q>Let's try it.</q>
1699: <br>
1700: <ol>
1701: <li>どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、
1702: その中に VM ディレクトリを用意します (例えば ~/nono/luna88k/)。
1703: <q>Create a directory somewhere for nono (for example ~/nono/),
1704: and create subdirectories for individual VMs in it
1705: (for example ~/nono/luna88k/).</q>
1706:
1.1.1.12 root 1707: <li>以下のリンクから liveimage-luna88k-raw-20211221.img.gz
1.1.1.8 root 1708: をダウンロードして展開し、
1709: VM ディレクトリ ~/nono/luna88k/ に置きます。
1.1.1.12 root 1710: <q>Download liveimage-luna88k-raw-20211221.img.gz from the following link,
1.1.1.8 root 1711: extract it and place it in the VM directory, ~/nono/luna88k/.</q>
1712: <blockquote>
1713: <a href="http://www.nk-home.net/~aoyama/liveimage/"
1714: >http://www.nk-home.net/~aoyama/liveimage/</a>
1715: </blockquote>
1716:
1717: <li>以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/luna88k/
1718: に作成します。
1719: ここでは説明を簡単にするためネットワークなしにしていますが、
1720: ネットワーク設定は必要に応じて行ってください。
1721: <q>Create a configuration file nono.cfg in the VM directory, ~/nono/luna88k/,
1722: with following contents.
1723: By the way, to simplify the explanation, we assume there is no network here.
1724: However, please configure the network if necessary.</q>
1725: <blockquote class="file"><pre>
1726: vmtype = luna88k
1.1.1.12 root 1727: spc0-id6-image = hd,liveimage-luna88k-raw-20211221.img
1.1.1.8 root 1728: hostnet-driver = none
1729: </pre></blockquote>
1730:
1731: <li><tt>nono -c ~/nono/luna88k</tt> で起動します
1732: (VM ディレクトリに自動的に NVRAM.DAT が作られます)。
1733: <q>Run as <tt>nono -c ~/nono/luna88k</tt>.
1734: (NVRAM.DAT will be created automatically in the VM directory)</q>
1735: <li>Emulated ROM Monitor が起動するので、
1736: 初回は以下のように入力すると OpenBSD が起動します。
1737: <q>The emulated ROM Monitor will be executed.
1738: Then, only for the first time,
1739: entering the following can boot OpenBSD.</q>
1740: <blockquote><pre>
1741: nvram boot_filename boot⏎
1742: y
1743: b⏎
1744: </pre></blockquote>
1745: 画面はこんな感じのはずです (太字が入力部分)。
1746: <q>You will see a screen like this. The bold text indicates
1747: the characters you need to enter.</q>
1748: <blockquote class="file"><pre>
1.1.1.11 root 1749: NONO <?=$nono_ver?> Emulated ROM Monitor for LUNA88K
1.1.1.8 root 1750:
1751: ** NVRAM Initialized.
1752:
1753: N><b>nvram boot_filename boot⏎</b>
1754: Update boot_filename : "vmunix" -> "boot" (Y/[N]):<b>y</b>
1755: Updated
1756: N><b>b⏎</b>
1757: </pre></blockquote>
1758: この内容は NVRAM.DAT に記録されているので次回以降は直接 OpenBSD が起動します。
1759: <q>The information you have just entered is recorded in the NVRAM,
1.1.1.13! root 1760: so next time it will boot OpenBSD automatically.</q>
1.1.1.8 root 1761:
1762: <li>終了する時は root
1763: ユーザで “<tt>shutdown -p now</tt>” を実行してください。
1.1.1.12 root 1764: LUNA-88K はソフトウェアから電源オフでき、
1.1.1.8 root 1765: VM の電源オフで nono も終了します。
1766: <q>To quit, type “<tt>shutdown -p now</tt>” as the root user.
1.1.1.12 root 1767: LUNA-88K can be powered off by software,
1.1.1.8 root 1768: and nono will terminate when the VM is powered off.</q>
1.1.1.2 root 1769: </ol>
1.1 root 1770: </div>
1771:
1.1.1.13! root 1772: <div class="new">
! 1773: <h5>5.3 NetBSD/x68k を実行してみる <q>Try NetBSD/x68k</q></h5>
! 1774: <div class="main">
! 1775: つついさんが NetBSD/x68k 9.2 の liveimage を用意されています。
! 1776: ここではこれを起動してみます。
! 1777: <q>Tsutsui-san has provided a liveimage of NetBSD/x68k 9.2. Let's try it.</q>
! 1778: <br>
! 1779: <ol>
! 1780: <li>どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、
! 1781: その中に VM ディレクトリを用意します (例えば ~/nono/x68k/)。
! 1782: <q>Create a directory somewhere for nono (for example ~/nono/),
! 1783: and create subdirectories for individual VMs in it
! 1784: (for example ~/nono/x68k/).</q>
! 1785:
! 1786: <li>以下のリンクから
! 1787: plain-install か with-packages のお好みのほうをダウンロードして展開し、
! 1788: VM ディレクトリ ~/nono/x68k/ に置きます。
! 1789: <q>Download your favorite one of plain-install or with-packages
! 1790: from the following link,
! 1791: extract it and place it in the VM directory, ~/nono/x68k/.</q>
! 1792: <blockquote class="new">
! 1793: <a href="http://teokurebsd.org/netbsd/liveimage/20210613-x68k/"
! 1794: >http://teokurebsd.org/netbsd/liveimage/20210613-x68k/</a>
! 1795: </blockquote>
! 1796:
! 1797: <li>以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/x68k/
! 1798: に作成します。
! 1799: 初回起動時は liveimage は接続しません。
! 1800: <q>Create a configuration file nono.cfg in the VM directory, ~/nono/x68k/,
! 1801: with following contents.
! 1802: You don't need to add the liveimage first time.</q>
! 1803: <blockquote class="file"><pre>
! 1804: vmtype = x68030
! 1805: </pre></blockquote>
! 1806:
! 1807: <li><tt>nono -c ~/nono/x68k</tt> で起動します。
! 1808: しばらくすると起動メディアが見付からず白帯が出ますので
! 1809: メニューの「File > Exit」か×ボタンで終了します。
! 1810: これで IPLROM により初期化された SRAM が
! 1811: VM ディレクトリに SRAM.DAT として保存されます。
! 1812: <q>Run as <tt>nono -c ~/nono/x68k</tt>.
! 1813: After a few seconds, a message will be displayed like this captured screen.
! 1814: It says in Japanese that "Cannot boot from disk. Please set correct one".
! 1815: Then, terminate the nono by "File > Exit" in menu or close button.
! 1816: By this operation, SRAM will be initialized by X68030 IPLROM and
! 1817: be saved as SRAM.DAT in the VM directory.</q>
! 1818: <center><img src="image/x68030-nodisk.png"></center>
! 1819:
! 1820: <li>ここで設定ファイル nono.cfg に先程ダウンロードしてきたディスクイメージを追加します (2行目)。
! 1821: <q>Then, add a disk image downloaded earlier to configuration file nono.cfg
! 1822: (see 2nd line).</q>
! 1823: <blockquote class="file"><pre>
! 1824: vmtype = x68030
! 1825: spc0-id0-image = hd,liveimage-x68k-with-packages-20210613.hds
! 1826: </pre></blockquote>
! 1827:
! 1828: <li>もう一度 <tt>nono -c ~/nono/x68k</tt> で起動すると、
! 1829: HDD から NetBSD/x68k が起動します。
! 1830: 次回以降はこれだけで直接 NetBSD が起動します。
! 1831: <q>Again, run as <tt>nono -c ~/nono/x68k</tt>.
! 1832: NetBSD/x68k will be booted from HDD.
! 1833: Next time, it will boot NetBSD automatically.</q>
! 1834:
! 1835: <li>初回起動後数時間はめちゃくちゃ重たいですが、
! 1836: これはバックグラウンドで makemandb が動くためで
! 1837: nono のせいではありません(>_<)。
! 1838: <q>At the first boot, you will feel it's too heavy for several hours.
! 1839: This is because the infamous makemandb(8) runs heavily in the background
! 1840: for a looooong time.
! 1841: It's very sad to me that an accident which is far from the ideal
! 1842: is the first experiences of newcomers.</q>
! 1843:
! 1844: <li>NetBSD が起動した後なら (正確には powerd(8) が起動していれば)、
! 1845: 終了する時はメニューの「デバイス > 操作 > 電源ボタンを押す」
! 1846: でシャットダウンして電源オフになり、
! 1847: VM の電源オフで nono も終了します。
! 1848: <q>After NetBSD boots up (more precisely, if powerd(8) is running),
! 1849: you can shutdown and power off by
! 1850: "Device > Operation > Push Power button" on menu,
! 1851: and nono will terminate when the VM is powered off.</q>
! 1852: </ul>
! 1853: </div>
! 1854: </div>
1.1 root 1855:
1.1.1.8 root 1856:
1.1.1.7 root 1857: <a name="network"></a>
1.1.1.13! root 1858: <h4>6. ホストネットワーク設定例 <q>Example of host network setup</q></h4>
1.1 root 1859: <div class=main>
1.1.1.8 root 1860: wm0 を持つ NetBSD ホストに tap(4) デバイスを用いて
1861: nono のゲスト OS を接続する場合の設定例です。
1862: <ol>
1863: <li>
1864: 設定ファイル nono.cfg に以下の行を追加します
1865: (と言いつつ NetBSD では書かなくてもデフォルトでこの動作になりますが)
1866: <q>Add the following line to configuration file, nono.cfg.
1867: (Although you don't need to write it since these are default behavior
1868: on NetBSD)</q>
1.1 root 1869: <blockquote class="file"><pre>
1.1.1.8 root 1870: hostnet-driver = tap
1871: hostnet-tap-devpath = auto
1.1 root 1872: </pre></blockquote>
1.1.1.8 root 1873:
1.1.1.5 root 1874: <li>デフォルトでは /dev/tap は一般ユーザからアクセスできないので、
1875: chmod で適当にパーミッションを与えます。
1876: 番号の付いていないほうの /dev/tap だけでいいです。
1877: sysinst 等で OS をアップグレードするとパーミッションが 600
1878: に戻るのがハマりポイントです。
1.1.1.8 root 1879: <q>By default, /dev/tap is only accessible to privileged user.
1880: You need to chmod /dev/tap (without unit number) appropriately.
1.1.1.11 root 1881: Note that upgrading using sysinst always reset the permission to 600.</q>
1.1.1.5 root 1882:
1883: <li>bridge(4) インタフェースを作成し、
1.1.1.8 root 1884: ホストの外部(物理)インタフェースをブリッジに追加しておきます。
1.1.1.5 root 1885: <q>Create a bridge(4) interface, and
1886: add your physical interface to the bridge.</q>
1.1 root 1887: <blockquote class="cons"><pre>
1.1.1.5 root 1888: # ifconfig bridge0 create
1.1 root 1889: # brconfig bridge0 add wm0
1890: </pre></blockquote>
1.1.1.8 root 1891: 常用するなら /etc の設定ファイルに書いておきましょう。
1892: <q>If you use it regularly,
1.1.1.5 root 1893: you can put configuration file into /etc.</q>
1894: <blockquote>
1895: /etc/ifconfig.bridge0
1896: <pre class=file>
1897: create
1898: up
1899: !/sbin/brconfig $int add wm0
1900: </pre>
1901: <pre class=cons>
1902: # /etc/rc.d/network restart
1903: </pre>
1904: </blockquote>
1905:
1906: <li>
1907: 一般ユーザに戻って、
1908: VM ディレクトリかその親ディレクトリに
1909: 次のような 2つのスクリプトを用意します。
1.1.1.8 root 1910: nono は tap(4) をオープンし、
1911: そのデバイス名を引数にこれらのスクリプトを呼びます。
1.1.1.5 root 1912: sudo の設定は別途行ってください。
1913: <q>Return to non-privileged user, and
1914: create following two scripts in the VM directory or its parent directory.
1.1.1.8 root 1915: nono will open tap(4) and
1916: invoke these scripts with the name of the device as an argument.
1.1.1.5 root 1917: In addition, you need to set up sudo separately.</q>
1.1 root 1918: <blockquote>
1919: nono-ifup
1920: <pre class=file>
1921: #!/bin/sh
1.1.1.5 root 1922: sudo /sbin/ifconfig $1 up
1923: sudo /sbin/brconfig bridge0 add $1
1.1 root 1924: </pre></blockquote>
1925:
1926: <blockquote>
1.1.1.5 root 1927: nono-ifdown
1.1 root 1928: <pre class=file>
1929: #!/bin/sh
1.1.1.5 root 1930: sudo /sbin/brconfig bridge0 delete $1
1931: sudo /sbin/ifconfig $1 down
1932: </pre></blockquote>
1933:
1934: <blockquote class="cons"><pre>
1935: % chmod +x nono-ifup nono-ifdown
1.1 root 1936: </pre></blockquote>
1937:
1.1.1.5 root 1938: <li>nono を起動し、
1939: メニューの「モニタ > ホスト > ホストネットワーク」を開いて
1.1.1.8 root 1940: HostNet Driver: tap になっていれば動いてるはずです。
1.1.1.5 root 1941: <q>Run nono,
1942: and open "Monitor > Host > Host Network" window from menu.
1.1.1.8 root 1943: It's OK if you can see "HostNet Driver: tap".</q>
1.1.1.5 root 1944:
1945: </ol>
1946:
1.1 root 1947: </div>
1948:
1.1.1.12 root 1949: <a name="knownissues"></a>
1950: <h4>7. 既知の問題 <q>Known Issues</q></h4>
1951: <div class="main">
1952: <ul>
1.1.1.13! root 1953: <li>デバッガのコンソール入力で、
1.1.1.12 root 1954: バックスペースやカーソルキーの入力に対する表示が動作していません。
1955: <q>In debugger console, some special characters like backspace or cursor keys
1956: aren't printed correctly.</q>
1.1.1.13! root 1957: (since ver 0.3.0)
1.1.1.12 root 1958: <li>ホストが VirtualBox (on Windows?) で、
1959: VirtualBox の「マウス統合」が有効にしている場合、
1960: nono の「マウスモード」でマウスポインタが正しく移動しません。
1961: <q>If the host OS is running on VirtualBox (on Windows?) and
1962: "Mouse integration" on VirtualBox is enabled,
1963: the mouse pointer will not move as expected in nono's Mouse Mode.</q>
1964: (2021/12/30)
1965:
1966: <li>Wayland の場合にウィンドウサイズが正しく設定されない場合があります。
1967: wxWidgets (3.0.5) のバグと思われます。
1968: <q>On Wayland, window size may be incorrect.
1969: This may be due to wxWidgets (3.0.5) bug.</q>
1970: (2021/12/30)
1971:
1972: <li>メインウィンドウの中央付近に nono のサブウィンドウや他のウィンドウが存在する場合、マウスモードに入れません。
1973: <q>If there are nono's sub windows or other windows near the center of
1974: the main window, you will not enter the mouse mode.</q> (since ver 0.0.2)
1975:
1976: </ul>
1977: </div>
1.1 root 1978:
1.1.1.9 root 1979: <a name="migrate"></a>
1.1.1.12 root 1980: <h4>8. 過去のバージョンからの移行方法 <q>How to migrate from old versions</q></h4>
1.1.1.9 root 1981: <div class="main">
1982: バージョンアップに伴い設定ファイル等に非互換が発生する場合があります。
1983: その場合は以下の移行方法を参照して設定ファイル等を更新してください。
1984: <q>Some versions may have incompatibilities in the configuration files, etc.
1985: In such case, you may need to upgrade it by referring the following link.</q>
1986: <ul>
1.1.1.13! root 1987: <li><a href="upgrade-0.3.0.html">From ver 0.2.x to ver 0.3.0</a>
1.1.1.9 root 1988: <li><a href="upgrade-0.2.0.html">From ver 0.1.x to ver 0.2.0</a>
1989: </ul>
1990: </div>
1.1.1.2 root 1991:
1.1.1.10 root 1992: <a name="changes"></a>
1.1.1.12 root 1993: <h4>9. 変更履歴 <q>Changes</q></h4>
1.1.1.10 root 1994: <div class="main">
1995: See <a href="changes.html">changes.html</a>.
1996: </div>
1997:
1.1.1.7 root 1998: <a name="license"></a>
1.1.1.12 root 1999: <h4>10. 連絡先、ライセンス等 <q>Contact, License, etc</q></h4>
1.1.1.10 root 2000:
1.1.1.12 root 2001: <h5>10.1. ライセンス <q>License</q></h5>
1.1.1.2 root 2002: <div class="main">
2003: See <a href="nono-license.txt">nono-license.txt</a>.
2004: </div>
1.1.1.13! root 2005: <br>
! 2006: <div class="main"><span class="new">
! 2007: また nono は無償公開されている X68030 の IPLROM を使用しています。
! 2008: <a href="fsharp-license.txt">許諾条件</a>を読んでください。
! 2009: <q>nono uses X68030 IPLROM image distributed without charge.
! 2010: You must read
! 2011: <a href="fsharp-license.txt">the license agreement</a>
! 2012: (even though it's Japanese original text only).</q>
! 2013: </span></div>
1.1.1.2 root 2014:
1.1.1.12 root 2015: <h5>10.2. 連絡先 <q>Contact us</q></h5>
1.1.1.4 root 2016: <div class="main">
2017: バグ報告などは以下にお願いします。日本語でおk。
2018: <q>If you find any problems, please let me know.
2019: You may write in English.</q><br>
2020: <a href="https://github.com/isaki68k/nono-issue/issues"
2021: >https://github.com/isaki68k/nono-issue/issues</a>
2022: </div>
2023:
1.1.1.12 root 2024: <h5>10.3. パッチの提供について <q>About contributes</q></h5>
1.1.1.2 root 2025: <div class="main">
2026: パッチを提供してくださる場合は以下に同意したものとします。
1.1.1.12 root 2027: <q>If you provide a patch to nono, we assume that you agree the following
1.1.1.11 root 2028: conditions:</q>
1.1.1.2 root 2029: <ul>
2030: <li>成果物が nono のライセンスに従って運用あるいは配布されること。
2031: <q>All your work are operated or distributed under the nono license.</q>
2032: <li>ライセンスが将来変わる可能性があること。
2033: <q>The license may be changed in the future.</q>
2034: <li>著作部分に関して著作者人格権を行使しないこと。
2035: <q>Do not exercise your author's rights.</q>
2036: </ul>
2037: <ul>
2038: </div>
2039:
1.1.1.12 root 2040: <h5>10.4. Acknowledgements</h5>
1.1.1.2 root 2041: <div class="main">
2042: nono は以下の広告条項を含むソースコードを利用しています。
2043: <q>nono uses source code with the following advertising clause.</q>
2044: <blockquote>
2045: This product includes software developed by Gordon Ross<br>
2046: This product includes software developed by the University of California, Lawrence Berkeley Laboratory.<br>
2047: </blockquote>
2048: </div>
2049:
1.1 root 2050:
2051: <hr>
1.1.1.2 root 2052: nono project
1.1 root 2053: </body>
2054: </html>
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.