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