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