![[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 ! root 1: <html><?php ! 2: $nono_ver = ""; ! 3: ! 4: if ($_SERVER['argc'] > 1) ! 5: get_version($_SERVER['argv'][1]); ! 6: ! 7: function get_version($filename) ! 8: { ! 9: global $nono_ver; ! 10: ! 11: $fp = fopen($filename, "r"); ! 12: if ($fp !== false) { ! 13: while (($buf = fgets($fp)) !== false) { ! 14: if (preg_match("/NONO_MAJOR_VER\s+\((\d+)\)/", $buf, $m)) { ! 15: $nono_major = $m[1]; ! 16: } ! 17: if (preg_match("/NONO_MINOR_VER\s+\((\d+)\)/", $buf, $m)) { ! 18: $nono_minor = $m[1]; ! 19: } ! 20: if (preg_match("/NONO_PATCH_VER\s+\((\d+)\)/", $buf, $m)) { ! 21: $nono_patch = $m[1]; ! 22: } ! 23: if (preg_match("/NONO_DATE\s+\"([^\"]+)\"/", $buf, $m)) { ! 24: $nono_date = $m[1]; ! 25: } ! 26: } ! 27: fclose($fp); ! 28: ! 29: $nono_ver = "${nono_major}.${nono_minor}.${nono_patch} (${nono_date})"; ! 30: } ! 31: } ! 32: ?> ! 33: <head> ! 34: <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> ! 35: <title>nono document</title> ! 36: <style type="text/css"> ! 37: /* https://jfly.uni-koeln.de/colorset/ */ ! 38: ! 39: :root { ! 40: --blue: rgb( 0, 90, 255); ! 41: --brown: rgb(128, 64, 0); ! 42: --green: rgb( 3, 175, 122); ! 43: --grey: rgb(132, 145, 158); ! 44: --light-grey: rgb(200, 200, 203); ! 45: } ! 46: body { ! 47: background-color: var(--light-grey); ! 48: } ! 49: q { ! 50: color: var(--brown); ! 51: } ! 52: q:before { ! 53: content: "["; ! 54: } ! 55: q:after { ! 56: content: "]"; ! 57: } ! 58: dt.dt-indent { ! 59: padding-left: 1ex; ! 60: } ! 61: .main { ! 62: margin-left: 1em; ! 63: } ! 64: .cons { ! 65: background-color: black; ! 66: color: white; ! 67: } ! 68: .file { ! 69: background-color: white; ! 70: color: black; ! 71: } ! 72: .strike { ! 73: color: var(--grey); ! 74: } ! 75: </style> ! 76: </head> ! 77: <body> ! 78: <h3>nono <?=$nono_ver?></h3> ! 79: ! 80: nono は NetBSD とかで動作する OMRON LUNA-I とかのエミュレータです。 ! 81: <q>nono is OMRON LUNA-I emulator runs on NetBSD and so on.</q> ! 82: ! 83: <hr> ! 84: <h4>ビルド方法 <q>How to build</q></h4> ! 85: <div class="main"> ! 86: NetBSD/amd64-9.0 の場合以下のパッケージが必要です。 ! 87: <ul> ! 88: <li>pkgsrc/x11/wxGTK30 (OPTIONS:gtk2 is recommended) ! 89: </ul> ! 90: <?php /* ! 91: Ubuntu (18.04) ! 92: libkqueue-dev (?) ! 93: */ ! 94: ?> ! 95: </dl> ! 96: アーカイブを展開したら以下のようにします。 ! 97: <blockquote class="cons"><pre> ! 98: % ./configure ! 99: % make depend ! 100: % make ! 101: </pre></blockquote> ! 102: まだ make install はないです。 ! 103: <tt>wx/nono</tt> が GUI 版実行ファイル、 ! 104: <tt>cli/nono-cli</tt> がコマンドライン版です。 ! 105: ! 106: </div> ! 107: ! 108: ! 109: <h4>コマンドラインオプション <q>Command Line Option</q></h4> ! 110: <div class="main"> ! 111: <dl> ! 112: <?php ! 113: function item($name, $desc) ! 114: { ! 115: if (!is_array($name)) { ! 116: $name = array($name); ! 117: } ! 118: foreach ($name as $n) { ! 119: print "<dt class=dt-indent><tt>{$n}</tt></dt>\n"; ! 120: } ! 121: print "<dd>{$desc}</p></dd>\n"; ! 122: } ! 123: function option_item($name, $desc) ! 124: { ! 125: item($name, $desc); ! 126: } ! 127: ! 128: option_item("-A <i>file</i>", <<<_EOM_ ! 129: ホストの <tt><i>file</i></tt> をロードして実行します。 ! 130: ファイルが gzip 圧縮されていれば自動的に展開します。 ! 131: (展開後の) ファイル形式は a.out (OMAGIC) か ELF で、 ! 132: 実際にはブートローダとカーネル程度しか想定していません。 ! 133: 設定ファイルの <tt>prom-use-rom=1</tt> とともに指定されると ! 134: <tt>-A</tt> のほうが優先します。 ! 135: _EOM_ ! 136: ); ! 137: ! 138: option_item("-c <i>vmdir</i>", <<<_EOM_ ! 139: VM ディレクトリを指定します。省略するとカレントディレクトリとします。 ! 140: _EOM_ ! 141: ); ! 142: ! 143: option_item("-f", <<<_EOM_ ! 144: 高速モードで起動します。 ! 145: GUI なら起動後にもメニューから変更できますが、その初期値を変えるだけです。 ! 146: _EOM_ ! 147: ); ! 148: ! 149: option_item("--fontsize <i>height</i>", <<<_EOM_ ! 150: GUI 版のみ。 ! 151: 全サブウインドウの起動時のフォントサイズを指定します。 ! 152: <tt><i>height</i></tt> には 12, 16, 24 ! 153: のいずれかを指定します。デフォルトは <tt>12</tt> です。 ! 154: _EOM_ ! 155: ); ! 156: ! 157: option_item(array("-s <i>scale</i>", ! 158: "--scale <i>scale</i>"), <<<_EOM_ ! 159: GUI 版のみ。 ! 160: メインウィンドウの起動時のスケールを実数で指定します。 ! 161: 起動後にもメニューからプリセットされた倍率には変更可能ですが、 ! 162: 任意倍率は起動時のみ指定可能です ! 163: <span class=strike>(そのうちなんとかしたい)</span>。 ! 164: デフォルトは 1.0 です。 ! 165: _EOM_ ! 166: ); ! 167: ! 168: option_item("--show-config", <<<_EOM_ ! 169: 設定ファイルと <tt>-V</tt> オプションを読み込んだ結果を表示します。 ! 170: _EOM_ ! 171: ); ! 172: ! 173: option_item("-v", <<<_EOM_ ! 174: バージョンを表示します。 ! 175: _EOM_ ! 176: ); ! 177: ! 178: option_item("-V <i>name</i>=<i>value</i>", <<<_EOM_ ! 179: 設定ファイルの内容を個別に上書きします。 ! 180: _EOM_ ! 181: ); ! 182: ?> ! 183: </dl> ! 184: ! 185: 以下開発用。 ! 186: <dl> ! 187: <?php ! 188: // 項目間を空けない ! 189: function option_dev($name, $desc) ! 190: { ! 191: print "<dt class=dt-indent><tt>{$name}</tt></dt>\n"; ! 192: print "<dd>{$desc}</dd>\n"; ! 193: } ! 194: ! 195: option_dev("-b <i>hexaddr</i>", <<<_EOM_ ! 196: デバッガのブレークポイントを 16進数で指定します。 ! 197: _EOM_ ! 198: ); ! 199: ! 200: option_dev("-C", <<<_EOM_ ! 201: ログをコンソールにも出力します。 ! 202: 通常はログウィンドウにだけ出力されます。 ! 203: _EOM_ ! 204: ); ! 205: ! 206: option_dev("-d", <<<_EOM_ ! 207: 起動時にデバッガプロンプトで停止します。 ! 208: _EOM_ ! 209: ); ! 210: ! 211: option_dev("-D", <<<_EOM_ ! 212: コンソールをデバッガとして使用します。 ! 213: -d を指定しなくても起動時にプロンプトで停止します ! 214: <span class=strike>(そのうちなんとかしたい)</span>。 ! 215: _EOM_ ! 216: ); ! 217: ! 218: option_dev("-L <i>name1</i>=<i>level1</i>[,<i>name2</i>=<i>level2</i>,...]", ! 219: <<<_EOM_ ! 220: ログレベルを指定します。 ! 221: カンマで区切って複数指定することも出来ます。 ! 222: <tt>-Lhelp</tt> で name の一覧を表示します。 ! 223: _EOM_ ! 224: ); ! 225: ! 226: option_dev("-M <i>name</i>[,<i>name2</i>,...]", <<<_EOM_ ! 227: 起動時に表示するモニタウィンドウを指定します。 ! 228: カンマで区切って複数指定することも出来ます。 ! 229: _EOM_ ! 230: ); ! 231: ! 232: ! 233: ?> ! 234: </dl> ! 235: </div> ! 236: ! 237: <h4>設定 <q>Configuration</q></h4> ! 238: <div class="main"> ! 239: VM の設定ファイルはその VM ディレクトリ内の nono.cfg です。 ! 240: 書式は <tt>key = value</tt> 形式で1行1項目ずつです。 ! 241: <tt>key</tt> と <tt>value</tt> の前後の空白は取り除かれます。 ! 242: また空行と "<tt>#</tt>" で始まる行は無視します。 ! 243: 知らないキーの行も無視します。 ! 244: <p> ! 245: 設定項目は次の通りです。 ! 246: <dl> ! 247: <?php ! 248: function config_item($name, $desc) ! 249: { ! 250: item($name, $desc); ! 251: } ! 252: ! 253: config_item("vmtype = <i>string</i>", <<<_EOM_ ! 254: VM 種別を指定します。今の所 <tt><i>string</i></tt> に ! 255: 指定できるのは <tt>luna</tt> (LUNA-I) だけですが、省略不可です。 ! 256: _EOM_ ! 257: ); ! 258: ! 259: config_item("debugger-port = <i>integer</i>", <<<_EOM_ ! 260: デバッガの TCP 待ち受けポート番号を指定します。 ! 261: 0 なら待ち受けを行いません。 ! 262: デフォルトは 9999 です(適当)。 ! 263: _EOM_ ! 264: ); ! 265: ! 266: config_item("ethernet-hostdriver = <i>string</i>", <<<_EOM_ ! 267: イーサネットデバイスのホスト側ドライバを指定します。 ! 268: <tt>none</tt>、<tt>tap</tt>、<tt>bpf</tt> が指定できます。 ! 269: <tt>none</tt> ならホスト側とは一切通信を行いません。 ! 270: <tt>tap</tt> か <tt>bpf</tt> かはホスト OS によってビルド時に決定します。 ! 271: NetBSD なら <tt>tap</tt> です。 ! 272: _EOM_ ! 273: ); ! 274: ! 275: config_item("ethernet-macaddr = <i>string</i>", <<<_EOM_ ! 276: イーサネットデバイスの仮想マシン側の MAC アドレスを指定します。 ! 277: <tt><i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i>:<i>XX</i></tt> ! 278: 形式で指定します。 ! 279: <tt>auto</tt> なら自動的に決定します。 ! 280: デフォルトは <tt>auto</tt> です。 ! 281: _EOM_ ! 282: ); ! 283: ! 284: config_item("luna-dipsw1 = <i>string</i>", <<<_EOM_ ! 285: 本体前面 DIPSW#1-1..#1-8 の内容を指定します。 ! 286: "<tt>0</tt>" を DOWN、"<tt>1</tt>" を UP として、 ! 287: これを8つ並べた形式で、前から順に #1..#8 に対応します。 ! 288: デフォルトは <tt>11110111</tt> です。 ! 289: <br> ! 290: 各スイッチの内容はここ ! 291: (<a href="https://wiki.netbsd.org/ports/luna68k/luna68k_info/" ! 292: >NetBSD/luna68k: Information</a>) を参照してください。 ! 293: _EOM_ ! 294: ); ! 295: ! 296: config_item("luna-dipsw2 = <i>string</i>", <<<_EOM_ ! 297: 本体前面 DIPSW#2-1..#2-8 の内容を指定します。 ! 298: 書式は <tt>luna-dipsw1</tt> と同じです。 ! 299: デフォルトは <tt>11111111</tt> です。 ! 300: <br> ! 301: すべて "<tt>1</tt>"(UP) なら ! 302: NetBSD/luna68k のブートローダは自動的にカーネルをロードして実行し、 ! 303: どれかでも "<tt>0</tt>"(DOWN) にするとプロンプトで停止するようです。 ! 304: <span class=strike>(本当は #8 だけで制御するつもりだったんじゃないかという気がします)</span> ! 305: _EOM_ ! 306: ); ! 307: ! 308: config_item("mpu-clock = <i>value</i>", <<<_EOM_ ! 309: MPU のクロック数を MHz 単位で指定します。 ! 310: デフォルトは 20MHz です。 ! 311: _EOM_ ! 312: ); ! 313: ! 314: /* luna には不要 ! 315: config_item("mpu-has-fpu", ""); */ ! 316: ! 317: config_item("prom-use-rom = <i>integer</i>", <<<_EOM_ ! 318: 外部 ROM イメージファイルを使うかどうかを指定します。 ! 319: <tt>0</tt> なら使わない、<tt>1</tt> なら使うです。 ! 320: デフォルトは <tt>0</tt> です。 ! 321: <p> ! 322: 実機を持っていない場合はこの値を <tt>0</tt> にしておくと、 ! 323: nono 内蔵のなんちゃって下位互換 ROM で起動します。 ! 324: <p> ! 325: 実機を持っている場合は ROM ファイルを用意して ! 326: この値を <tt>1</tt> にすると実機 ROM で起動できます。 ! 327: ROM ファイルは実機の 0x41000000-0x4101ffff (128KB) を PROM.DAT (大文字) ! 328: という名前で保存したもので、VM ディレクトリに置きます。 ! 329: _EOM_ ! 330: ); ! 331: ! 332: config_item("spc0-id<i>N</i>-image = <i>devtype</i>,<i>path</i>", <<<_EOM_ ! 333: SCSI デバイスを指定します。<i>N</i> には 0 から 7 が入ります。 ! 334: ID 7 は本体が使用しますので指定しないでください。 ! 335: 値はデバイス種別 <i>devtype</i> とイメージパス <i>path</i> ! 336: を "<tt>,</tt>"(カンマ) で区切って並べた形式で、 ! 337: 今の所デバイス種別 <i>devtype</i> には "<tt>hd</tt>"(ハードディスク) のみ指定可能です。 ! 338: ディスクイメージパスが相対パスなら VM ディレクトリからの相対パスになります。 ! 339: <p> ! 340: 例えば、nono.cfg と同じディレクトリに置いたディスクイメージ luna.img ! 341: を使う場合、 ! 342: LUNA では通常 ID 6 をプライマリ HDD に割り当てるのでこんな感じになります。 ! 343: <blockquote><pre> ! 344: spc0-id6-image = hd,luna.img ! 345: </pre></blockquote> ! 346: _EOM_ ! 347: ); ! 348: ! 349: config_item("spc0-id<i>N</i>-writeprotect = <i>integer</i>", <<<_EOM_ ! 350: 指定の SCSI デバイスへの書き込みを無視するかどうか指定します。 ! 351: <tt>0</tt> なら通常動作(書き込みを行う)です。 ! 352: <tt>1</tt> なら書き込みコマンドは成功したように振る舞いますが実際には ! 353: ディスクイメージに一切書き戻しません。 ! 354: fsck を気にせずカーネルのデバッグとかを行いたい場合にはどうぞ。 ! 355: 何が起きるか意味が分からない人は指定しないでください。 ! 356: デフォルトは <tt>0</tt> です。 ! 357: _EOM_ ! 358: ); ! 359: ! 360: ! 361: ?> ! 362: </dl> ! 363: </div> ! 364: ! 365: ! 366: <h4>実行してみる <q>Try it</q></h4> ! 367: <div class="main"> ! 368: どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、 ! 369: その中に VM ディレクトリを用意します (例えば ~/nono/luna/)。 ! 370: その中に設定ファイル nono.cfg を用意します。 ! 371: nono に <tt>-c</tt> オプションで VM ディレクトリを指定して起動します。 ! 372: これだけでたぶん起動して NVRAM.DAT ファイルが自動的に作られます。 ! 373: ROM モニタについては最低限なんとなく雰囲気似せてあるので ! 374: 再びこちら (<a href="https://wiki.netbsd.org/ports/luna68k/luna68k_info/" ! 375: >NetBSD/luna68k: Information</a>) 参照のこと。 ! 376: ここからどうやって NetBSD/luna68k をインストールするかについては待て次号。 ! 377: <blockquote class="cons"><pre> ! 378: % mkdir -p ~/nono/luna/ ! 379: % echo "vmtype=luna" > ~/nono/luna/nono.cfg ! 380: % path/to/nono -c ~/nono/luna ! 381: </pre></blockquote> ! 382: ! 383: </div> ! 384: ! 385: ! 386: <h4>ネットワーク設定 <q>Setup network</q></h4> ! 387: <div class=main> ! 388: 設定ファイルに ! 389: <blockquote class="file"><pre> ! 390: ethernet-hostdriver = tap ! 391: </pre></blockquote> ! 392: を追加し、VM ディレクトリに nono-ifup、nono-ifdown ! 393: というスクリプトを用意してください。 ! 394: nono は tap(4) をオープンし、 ! 395: そのデバイス名を引数にこれらのスクリプトを呼びます。 ! 396: <p> ! 397: 最もシンプルなケースだとおそらく ! 398: <blockquote class="cons"><pre> ! 399: # brconfig bridge0 create ! 400: # brconfig bridge0 add wm0 ! 401: </pre></blockquote> ! 402: のようにして用意しておいた bridge0 に対して、 ! 403: (sudo の設定は別途行ってから) ! 404: 次のような nono-ifup、nono-ifdown を用意すれば ! 405: wm0 の物理セグメントとブリッジできると思います。 ! 406: ! 407: <blockquote> ! 408: nono-ifup ! 409: <pre class=file> ! 410: #!/bin/sh ! 411: sudo ifconfig $1 up ! 412: sudo brconfig bridge0 add $1 ! 413: </pre></blockquote> ! 414: ! 415: <blockquote> ! 416: nono-ifup ! 417: <pre class=file> ! 418: #!/bin/sh ! 419: sudo brconfig bridge0 delete $1 ! 420: sudo ifconfig $1 down ! 421: </pre></blockquote> ! 422: ! 423: </div> ! 424: ! 425: ! 426: <h4>注意 <q>Note</q></h4> ! 427: まだアルファリリースなので、 ! 428: すべての仕様は今後互換性なく変更するかも知れません。 ! 429: <q>This is alpha quality release. ! 430: All specifications on this page may be changed ! 431: without compatibility in the near future.</q> ! 432: ! 433: <hr> ! 434: [email protected] ! 435: </body> ! 436: </html>
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.