--- nono/doc/index.php 2026/04/29 17:05:15 1.1.1.14 +++ nono/doc/index.php 2026/04/29 17:05:18 1.1.1.15 @@ -130,7 +130,6 @@ bmake build-essential gettext libbsd-dev -libedit-dev libkqueue-dev libwxgtk3.0-gtk-dev zlib1g-dev @@ -175,18 +174,16 @@ the command line executable.
nono は複数機種に対応しているため設定なしでは起動できません。 設定は設定ファイルかコマンドラインオプションで指定します。 -nono はまず設定ファイル ~/.nono.cfg -があれば読み込み、続いて -カレントディレクトリの設定ファイル nono.cfg -があれば読みます +nono はまず設定ファイル ~/.nono.cfg +があれば読み込み、続いてカレントディレクトリの設定ファイル nono.cfg +があれば読みます (-c オプションで設定ファイル (VM ディレクトリ) の位置を指定することも出来ます)。 詳細は以下の設定の章を参照してください。 nono supports multiple architectures so that it needs configuration. -First, nono reads a configuration file -names ~/.nono.cfg if exists, then -reads a configuration file names nono.cfg in the current directory -if exists +First, nono reads a configuration file +names ~/.nono.cfg if exists, then +reads a configuration file names nono.cfg in the current directory if exists (You can specify the configuration file path (or VM directory) using -c option). See the following Configuration section for @@ -233,26 +230,23 @@ If -c option is omitted, _EOM_ ); -option_item("--create-sram", <<<_EOM_ - +option_item("--create-sram", <<<_EOM_ (X68030 Only) VM ディレクトリに X68030 用の SRAM.DAT がなければ初期状態で作成して終了します。 nono will create the initial SRAM.DAT for X68030 and exit, if there is no SRAM.DAT in the VM directory. - _EOM_ ); option_item("-f", <<<_EOM_ 高速モードで起動します。 GUI なら起動後にもメニューから変更できますが、その初期値を変えるだけです。 -設定の fast-mode=1 と等価です。 +設定の fast-mode=1 と等価です。 Boot as the fast mode. You can change this mode on GUI menu after boot, and the option only changes its initial state. -This option is equivalent to fast-mode=1 in configuration. +This option is equivalent to fast-mode=1 in configuration. _EOM_ ); @@ -260,27 +254,23 @@ option_item("--fontsize height", GUI 版のみ。 全サブウインドウの起動時のフォントサイズを指定します。 起動後にメニューから変更できます。 -設定の monitor-fontsize と等価です。 +設定の monitor-fontsize と等価です。 GUI Only. Specifies the initial fontsize of all sub windows. You can change this value on GUI menu after boot. -This option is equivalent to monitor-fontsize in configuration. +This option is equivalent to monitor-fontsize in configuration. _EOM_ ); option_item("-s scale", <<<_EOM_ GUI 版のみ。 メインウィンドウの起動時のスケールを実数で指定します。 - 設定の mainview-scale と等価です。 起動後はメニューからプリセットされた倍率と -mainview-scale で指定された倍率には変更可能です。 +mainview-scale で指定された倍率には変更可能です。 GUI Only. Specifies the initial main window scale in real number. - -This is equivalent to mainview-scale in configuration. +This is equivalent to mainview-scale in configuration. You can change this scale on GUI menu after boot. _EOM_ ); @@ -417,11 +407,9 @@ _EOM_ Configuration"); ?>
- nono の設定はいずれも以下の順序で適用されます。 nono's configurations are always applied in the following order. - -
    +
    1. デフォルト値 Default value
    2. ~/.nono.cfg があればその内容 Contents of ~/.nono.cfg if exists @@ -430,7 +418,6 @@ nono の設定はいずれも以下の Contents of nono.cfg in the VM directory (or the file specified by -c option) if exists
    3. コマンドラインオプション Command line option
    - ファイルの書式はどちらも key = value 形式で1行1項目ずつです。 key と value の前後の空白は取り除かれます。 また空行と "#" で始まる行は無視します。 @@ -453,15 +440,12 @@ the latter overwrites the former in the Then, command line option -V etc. overwrites it. If the same key appears more than once in the command line option, do in the same manner. -

    - vmtype を除くすべての設定項目はそれぞれデフォルト値を持っています。 つまり少なくとも vmtype だけは設定ファイルかコマンドラインオプションで指定する必要があります。 All configuration items except vmtype have default value. It means, you must specify at least only vmtype by configuration file or commandline option. -

    設定項目は次の通りです。 The configuration items are: @@ -591,24 +575,27 @@ and NWB-512 monochrome console (not impl _EOM_ ); -config_item("ethernet-macaddr = string", <<<_EOM_ -(LUNA and NEWS only) +config_item( + "ethernet-macaddr = string
    " . + "ethernetN-macaddr = string
    ", +<<<_EOM_ +N 番目の イーサネットデバイスの仮想マシン側の MAC アドレスを指定します。 XX:XX:XX:XX:XX:XX 形式で指定します。 auto なら自動的に決定します。 デフォルトは auto です。 +ethernet-macaddr は ethernet0-macaddr の別名です。 _EOM_ ); -config_item("extram-size = integer", <<<_EOM_ - +config_item("extram-size = integer", <<<_EOM_ (X68030 Only) 拡張メモリのサイズを MB 単位で指定します。 今の所以下だけが指定できます。 Specifies the extended RAM size in MB. For now, only the following can be specified. -

      +
      • 0 … 拡張メモリを使用しません。デフォルトです。 No extended memory. It's default.
      • 16 … TS-6BE16 互換モードで、 @@ -620,16 +607,14 @@ Its address is $0100'0000〜$01ff'ffff a 060turbo compatible mode. Its address is $1000'0000〜$17ff'ffff/$1fff'ffff and the size is 128 or 256MB. -
      +
    _EOM_ ); -config_item("fast-mode = integer", <<<_EOM_ - +config_item("fast-mode = integer", <<<_EOM_ 起動時の動作モードを指定します。0 なら通常モード、1 なら高速モードです。 デフォルトは 0 です。 コマンドラインオプション -f でも高速モードへのみ指定可能です。 - _EOM_ ); @@ -726,8 +711,8 @@ See About VM for _EOM_ ); -config_item("hostnet-driver = string", <<<_EOM_ -(LUNA and NEWS Only) +config_item("hostnetN-driver = string", <<<_EOM_ +N 番目の イーサネットデバイスのホスト側ドライバを指定します。 afpacket、bpf、tap のうち ホスト OS がサポートしているものと auto、none が選択可能です。 @@ -737,8 +722,10 @@ config_item("hostnet-driver = string< none ならホスト側とは一切通信を行いません。 auto ならホスト OS がサポートしているもののうち tap → afpacket → bpf を順に試します。 -デフォルトは auto です。 -Specifies the host driver of ethernet device. +hostnet0-driver のデフォルトは auto、 +hostnet1-driver のデフォルトは none です。 +Specifies the host driver of N-th +ethernet device. afpacket, bpf, and tap can be specified only if the host OS supports them. auto and none can always be specified. @@ -749,12 +736,12 @@ and tap uses tap(4) interface. If auto is specified, it tries tap, afpacket, and bpf in that order (if the host OS supports them). -The default is auto. +The default of hostnet0-driver is auto, +the default of hostnet1-driver is none. _EOM_ ); -config_item("hostnet-afpacket-ifname = ifname", <<<_EOM_ -(LUNA and NEWS Only) +config_item("hostnetN-afpacket-ifname = ifname", <<<_EOM_ ホストドライバが afpacket の時にバインドするインタフェースを1つ指定します。 ifname が auto なら使用可能なインタフェースを1つ自動的に選択します。 @@ -768,8 +755,7 @@ Note that this host driver cannot commun _EOM_ ); -config_item("hostnet-bpf-ifname = ifname", <<<_EOM_ -(LUNA and NEWS Only) +config_item("hostnetN-bpf-ifname = ifname", <<<_EOM_ ホストドライバが bpf の時にバインドするインタフェースを1つ指定します。 ifname が auto なら使用可能なインタフェースを1つ自動的に選択します。 @@ -783,8 +769,7 @@ Note that this host driver cannot commun _EOM_ ); -config_item("hostnet-tap-devpath = path", <<<_EOM_ -(LUNA and NEWS Only) +config_item("hostnetN-tap-devpath = path", <<<_EOM_ ホストドライバが tap の時に使用するデバイスを1つフルパスで指定します。 デフォルトは auto で、この場合は自動的にデバイスを選択します。 この時の探し方はホスト OS によって異なります。 @@ -815,20 +800,29 @@ you need to prepare empty scripts that w _EOM_ ); -config_item("hostnet-fallback = integer", <<<_EOM_ -(LUNA and NEWS Only) -hostnet-driver で指定したドライバが使用可能でなかった時、 +config_item("hostnetN-fallback = integer", <<<_EOM_ +hostnetN-driver で指定したドライバが使用可能でなかった時、 0 ならプロセスを終了します。 1 なら none を選択して実行を継続します。 デフォルトは 0 です。 Specifies the behavior when the driver which is selected by -hostnet-driver is unusable; +hostnetN-driver is unusable; terminate the process if 0, or continue to run using the none driver if 1. The default is 0. _EOM_ ); +config_item("" . + "hostnet-driver = string
    " . + "hostnet-afpacket-ifname = ifname
    " . + "hostnet-bpf-ifname = ifname
    " . + "hostnet-tap-devpath = path
    " . + "hostnet-fallback = integer
    ", <<<_EOM_ +それぞれ hostnet0-* の別名です。 +_EOM_ +); + config_item("iplrom1-image = path", <<<_EOM_ (X68030 Only) X68030 の外部 IPLROM イメージファイルのパスを指定します。 @@ -978,47 +972,44 @@ LUNA のビデオボードのプレー 1 ならモノクロビデオボード、 4 なら16色 (4bpp) ビデオボード、 8 なら 256色 (8bpp) ビデオボードです。 -デフォルトは 4 です。 +デフォルトは 4 です。 Specifies number of planes on LUNA video board. The valid values are 1, 4 or 8. 1 means a monochrome video board, 4 means 16-color (4bpp) video board, 8 means 256-color (8bpp) video board. -The default value is 4. +The default value is 4. _EOM_ ); -config_item("mainview-scale = double", <<<_EOM_ - +config_item("mainview-scale = double", <<<_EOM_ メインウィンドウの起動時のスケールを実数で指定します。 コマンドラインオプション -s で上書き可能です。 起動後はメニューから、 プリセットされた倍率とここで指定した倍率には変更可能です。 -デフォルトは 1.0 です。 +デフォルトは 1.0 です。 _EOM_ ); -config_item("monitor-fontsize = integer", +config_item("monitor-fontsize = integer", <<<_EOM_ - テキスト系モニタとステータスパネルのフォントサイズを 12, 16, 24 から指定します。 コマンドラインオプション --fontsize で上書き可能です。 起動後はメニューから変更することができます。 デフォルトは 12 です。 - _EOM_ ); config_item("monitor-rate = integer", <<<_EOM_ テキスト系モニタウィンドウの更新頻度を Hz 単位で指定します。 1 から 60 までの間で指定でき、デフォルトは 20Hz です。 -起動後にメニューから、プリセットされた頻度 -とここで指定した頻度には変更可能です。 +起動後にメニューから、 +プリセットされた頻度とここで指定した頻度には変更可能です。 Specifies refresh rate of all text monitor windows in Hz. It ranges from 1 to 60. The default is 20Hz. You can choose this value on GUI menu after boot, -from preset rate or rate specified here. +from preset rate or rate specified here. _EOM_ ); @@ -1046,6 +1037,73 @@ m88100 には、m68k の STOP 命令 ( _EOM_ ); +config_item("" . + "nereid0-enable = integer
    " . + "nereid1-enable = integer
    ", <<<_EOM_ + +(X68030 Only) +Nereid 拡張ボードを装着するかどうかを指定します。 +Nereid は同時に2枚まで使用することができます。 +値は 0 なら装着せず、1 なら装着します。 +デフォルトは 0 (装着しない) です。 +詳細は 4.5 Nereid の章を参照してください。 +Specifies whether install Nereid expansion board or not. +Up to two board can be operated at the same time. +If 0, the board is not installed. +If 1, the board is installed. +The default value is 0. +See also Section 4.5 Nereid below for details. + +_EOM_ +); + +config_item("" . + "nereid0-net = integer
    " . + "nereid1-net = integer
    ", <<<_EOM_ + +(X68030 Only) +Nereid ボードの NIC (RTL8019AS) のみを無効にすることが出来ます +(実機では通常そのようなことは出来ません)。 +0 なら無効、1 なら有効です。デフォルトは 1 です。 +通常は 1 のまま使用してください。 +この設定は対応する nereidN-enable が 0 +(ボードを装着しない) の場合は意味を持ちません。 +This can disable only NIC (RTL8019AS) of Nereid expansion board +(although it's not possible normally in the real world). +It's disabled if 0, or enabled if 1. +The default is 1. Normally, leave it 1. +This item will be ignored if the corresponding nereidN-enable +is 0. + +_EOM_ +); + +config_item("" . + "nereid0-ram-size = integer
    " . + "nereid1-ram-size = integer
    ", <<<_EOM_ + +(X68030 Only) +Nereid ボードのバンクメモリのサイズを MB 単位で指定します。 +指定できるのは 0, 4, 16 です。 +0 を指定するとバンクメモリを無効にします。 +デフォルトは 16 です。 +この設定は対応する nereidN-enable が 0 +(ボードを装着しない) の場合は意味を持ちません。 +Specifies bank memory size in MB of Nereid expansion board. +The valid values are 0, 4 or 16. +If 0, disable the bank memory. +The default is 16. +This item will be ignored if the corresponding nereidN-enable +is 0. +

    +また通常は必要ありませんが -4 または -16 を指定すると、 +バンクメモリは無効にした上で Nereid 制御ポートのビット6の読み出し値 +(バンクメモリの容量) を再現することが出来ます。 +-4 ならビット6は 0 (4MB)、0 か -16 なら 1(16MB) が読み出せます。 +     +_EOM_ +); + config_item("news-dipsw = string", <<<_EOM_ (NEWS Only) DIPSW の内容を指定します。 @@ -1135,10 +1193,10 @@ If the size is less than 64MB, you can s If larger, you can specify up to tentative 255MB in 1MB unit.
  1. X68030 ではメイン RAM 容量を示し、デフォルトは 12MB です。 4MB から 12MB まで 1MB 単位で指定できます。 -拡張メモリについては extram-size を参照してください。 +拡張メモリについては extram-size を参照してください。 On X68030, the default is 12MB. You can specify it in 1MB unit from 4MB to 12MB. -See extram-size for extended memory. +See extram-size for extended memory.
  2. NWS-1750 では現状 16MB で変更できません。 On NWS-1750, This is 16MB fixed for now. @@ -1370,15 +1428,15 @@ Frame buffer ◎ Keyboard/Mouse ◎ SIO (uPD7201) ◎ PIO (8255) ○ -Ethernet (AM7990) ◎ LARF を除く Except LARF +Ethernet (AM7990) ◎ マルチキャストフィルタを除く Except multicast filter NVRAM&RTC (MK48T02) ◎ Front LCD ◎ SPC (MB89352) ◎ SCSI HD/CD/MO Devices ○ -XP(HD647180) CPU △ -XP(HD647180) Timer0/1 ○ -XP(HD647180) その他の内蔵デバイス
    Other internal devices     × -XP 周辺デバイス Peripheral devices × +XP(HD647180) CPU △ +XP(HD647180) Timer0/1 ○ +XP(HD647180) その他の内蔵デバイス
    Other internal devices × +XP 周辺デバイス Peripheral devices × 電源 Power Circuit ○ LUNA-88K specific @@ -1410,17 +1468,17 @@ SRAM ◎ システムポートSystem port △ テキスト画面Text screen ○ 電源 Power curcuit ○ -Nereid Ethernet × -Nereid Bank memory × +Nereid Ethernet ◎ マルチキャストフィルタを除く Except multicast filter +Nereid Bank memory ◎ Nereid USB — 実装予定なし Not planned -拡張メモリ Extended memory ○ +拡張メモリ Extended memory ○ NWS-1750 MPU (68030) ○ キャッシュ未実装 Cache not implemented FPU (68881) ◎ 68882 は未実装 68882 not implemented PROM × SCC (Z8530) ◎ チャンネル A のみホストに接続 Only channel A is connected to the host -Ethernet (AM7990) ◎ LARF を除く Except LARF +Ethernet (AM7990) ◎ マルチキャストフィルタを除く Except multicast filter NVRAM&RTC (MK48T02) ◎ Video Board × Keyboard/Mouse × @@ -1484,6 +1542,68 @@ Human68k を起動する場合はお手
+ +
+現実の Nereid はイーサネット/メモリ/USB の複合拡張ボードで、 +このうちメモリは、メインメモリの増設に使える他、 +メインメモリとして使わなかった領域をバンクメモリとして使うことも出来ます。 +nono ではこの Nereid の機能のうちイーサネット (RTL8019AS) +とバンクメモリのみサポートします。 +メインメモリの増設機能はエミュレータでは意味がないので実装しません。また +USB (SL811HS/T) の実装予定はありません。 +Nereid in the real world is a combined Ethernet/memory/USB expansion board. +Of these, the memory can be used to expand main memory, +and areas not used for the main memory can be used as bank memory. +nono supports only ethernet (RTL8019AS) and bank memory among +the functions of the Nereid expansion board. +Main memory expansion is not supported because it's meaningless on emulators. +Also, USB (SL811HS/T) is not planned for implementation. +

+Nereid は DIPSW6,7 によりアドレス・割り込みベクタの組を2通り指定できるため、 +2枚まで同時に運用することが出来ます。 +本来 SW6 と SW7 は (衝突さえしなければ) 任意に組み合わせることが可能ですが、 +nono では簡便のためボード #0 は SW6,7 が OFF、 +ボード #1 は SW6,7 が ON と固定しています。 +Since Nereid can set to two different combinations of addresses and +interrupt vectors by DIPSW, +so up to two boards can be operated at the same time. +Originally, SW6 and SW7 can be arbitrarily combined +(as long as they don't collide), in nono however, for simpility, +SW6 and SW7 are fixed to be OFF on board #0, and +SW6 and SW7 are fixed to be ON on board #1. +
+ +
#0 (nereid0-*)#1 (nereid1-*) +
ベースアドレス・割り込みベクタ
Base address and interrupt vectors + 		$ece300,$f9,$fb
(SW7=OFF) + 		$eceb00,$f8,$fa
(SW7=ON) +
バンクメモリウィンドウ
Bank memory window + 		$ee0000
(SW6=OFF) + 		$ef0000
(SW6=ON) +
+
+バンクメモリは、メインメモリとして使わなかった領域を使用します。 +そのため実機でもバンクメモリの容量は DIPSW のメインメモリ割り当て設定 +(SW1-5) に依存します。 +nono に関係する結論だけでいうと、 +メインメモリへの割り当てを一切行わない場合はバンクメモリは 16MB 確保でき、 +メインメモリへの割り当てをいくらかでも行うとバンクメモリは 4MB となります。 +設定の nereidN-ram-size はこの部分を指定していることになります。 +またこの容量とは独立に SW8 でバンクメモリの有効・無効を指定できますので、 +nereidN-ram-size が 0 (以下) というのは SW8 +でバンクメモリを無効にしたことに相当します。 +Bank memory uses memory areas not used as the main memory. +So the bank memory size depends on the main memory settings (SW1-5). +As a result, +only if you don't allocate any memories to main memory, +the bank memory can be allocated 16MB. +Otherwise, the bank memory will be allocated 4MB. +Thus, nereidN-ram-size specifies this value. +Also, SW8 specifies enable/disable of the bank memory regardless of the size, +nereidN-ram-size = 0 (or less) means disabling the bank memory. +
+ +
NEWS エミュレーションは未完成です。 @@ -1555,24 +1675,24 @@ PIO(8255) がラッチするのが概ね から選択できます。 また 68030/88200 の MMU ディスクリプタとして表示させることもできます (この位置が正しいディスクリプタかどうかは関係なく表示します)。 -逆アセンブルも、逆アセンブルウィンドウからこちらにマージしました。 +逆アセンブルも、逆アセンブルウィンドウからこちらにマージしました。 LUNA-I なら m68k、HD64180 の逆アセンブルが、 LUNA-88K なら m88k、HD64180 の逆アセンブルが、 -X68030 と NEWS なら m68k の逆アセンブルが選択できます。 +X68030 と NEWS なら m68k の逆アセンブルが選択できます。 On memory dump monitor, you can choose the output format from byte, word and longword (In m88k, it is represented as byte, halfword and word respectively). Also you can choose 68030/88200 MMU descriptor format (It displays regardless of whether this address is used as descriptor or not). -Disassemble is now merged from disassemble monitor. +Disassemble is now merged from disassemble monitor. On LUNA-I, you can choose m68k and HD64180 disassemble. On LUNA-88K, you can choose m88k and HD64180 disassemble. -On X68030 and NEWS, you can choose m68k disassemble. +On X68030 and NEWS, you can choose m68k disassemble.

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

  • NVRAM (LUNA and NEWS Only) … 編集するとただちにファイルも更新します。 @@ -1588,6 +1708,16 @@ The last 8 bytes are not editable since
+Device Map Monitor"); ?> +
+m68k/m88k バスに接続されているデバイスを表示します。 +32ビットアドレスのうち上位 8 ビット、256個分を表示しています。 +1枠が 16MB になります。 +また、X68030 ではこのうち 24ビット空間を別モニタで表示します。 +こちらは 1枠 8KB x 2048個です。 +どちらも内部構造を表示しているだけなので名前に馴染みがない場合があるかもしれません。 +
+ Key input mode"); ?>
LUNA も X68030 もキーボードは通常日本語キーボードです @@ -2157,23 +2287,22 @@ extract it and place it in the VM direct
  • 以下の内容の設定ファイル nono.cfg を VM ディレクトリ ~/nono/x68k/ に作成します。 -ここでは説明を簡単にするためネットワークなしにしていますが、 -ネットワーク設定は必要に応じて行ってください。 +ここでは説明を簡単にするためネットワークなしにしていますが、 +ネットワーク設定は必要に応じて行ってください。 Create a configuration file nono.cfg in the VM directory, ~/nono/x68k/, with following contents. -By the way, to simplify the explanation, we assume there is no network here. -However, please configure the network if necessary. +By the way, to simplify the explanation, we assume there is no network here. +However, please configure the network if necessary. 
     vmtype = x68030
 spc0-id0-image = hd,liveimage-x68k-with-packages-20210613.hds
-hostnet-driver = none
+hostnet0-driver = none
    -
  • 初回のみ nono -c ~/nono/x68k --create-sram を実行します。 +
  • 初回のみ nono -c ~/nono/x68k --create-sram を実行します。 これで VM ディレクトリに初期状態の SRAM.DAT が作られます。 Only the first time, run as nono -c ~/nono/x68k --create-sram. -This will create initial SRAM.DAT in the VM directory. +This will create an initial SRAM.DAT in the VM directory.
  • nono -c ~/nono/x68k で起動すると、 HDD から NetBSD/x68k が起動します。 @@ -2344,6 +2473,12 @@ In such case, you may need to upgrade it Changes"); ?>
    See changes.html. +changes.php)\n"; + } +?>
    @@ -2390,7 +2525,7 @@ You may write in English.
    conditions:
    • 成果物が nono のライセンスに従って運用あるいは配布されること。 -All your work are operated or distributed under the nono license. +All your work will be operated or distributed under the nono license.
    • ライセンスが将来変わる可能性があること。 The license may be changed in the future.
    • 著作部分に関して著作者人格権を行使しないこと。