--- nono/doc/index.php 2026/04/29 17:05:00 1.1.1.10 +++ nono/doc/index.php 2026/04/29 17:05:07 1.1.1.12 @@ -4,16 +4,10 @@ Licensed under nono-license.txt --> 1) - get_version($_SERVER['argv'][1]); - -function get_version($filename) -{ - global $nono_ver; - - $fp = fopen($filename, "r"); + $fp = fopen("../lib/header.h", "r"); if ($fp !== false) { while (($buf = fgets($fp)) !== false) { if (preg_match("/NONO_MAJOR_VER\s+\((\d+)\)/", $buf, $m)) { @@ -31,32 +25,69 @@ function get_version($filename) } fclose($fp); - $nono_ver = "${nono_major}.${nono_minor}.${nono_patch} (${nono_date})"; + $nono_ver = "${nono_major}.${nono_minor}.${nono_patch}"; } -} ?> -

nono

+

nono ()

-nono は NetBSD とかで動作する OMRON LUNA-I や LUNA88K とかのエミュレータです。 -nono is OMRON LUNA-I and LUNA88K emulator runs on NetBSD and etc. +nono は NetBSD とかで動作する OMRON LUNA-I や LUNA-88K とかのエミュレータです。 +nono is OMRON LUNA-I and LUNA-88K emulator runs on NetBSD and etc.

Index of this page:

+0. ver 0.2.x から ver 0.3.0 への移行方法 How to migrate from ver 0.2.x to ver 0.2.0
1. ビルド方法 How to build
2. コマンドラインオプション Command Line Option
3. 設定 Configuration
4. VM について About VM
5. 実行してみる Try it
6. ネットワーク設定例 Example of network setup
-7. 過去のバージョンからの移行方法 +7. 既知の問題 Known Issues
+8. 過去のバージョンからの移行方法 How to migrate from old versions
-8. 変更履歴 Changes
-9. 連絡先、ライセンス等 Contact, License, etc
+9. 変更履歴 Changes
+10. 連絡先、ライセンス等 Contact, License, etc
+

+

+緑背景は新規または目立った更新のあった箇所です。 +Green Background is new or updated paragraph. +
+ + + +

0. ver 0.2.x から ver 0.3.0 への移行方法 How to migrate from ver 0.2.x to ver 0.3.0

+
+ver 0.3.0 ではデバッガに関する設定項目が ver 0.2.x までとは変更になっています。 +これらを設定ファイルに記載している場合は +このドキュメントの設定の章を参照して修正してください。 +Configuration about debugger has been changed from ver 0.2.x to ver 0.3.0. +If your configuration file has them, please update by yourself. +See Configuration section in this document. + +

+ +以下の設定項目は廃止になりました。 +The following item has been removed. +
+

+debugger-port = (default: 0)
+
+ +代わりに以下の2つが追加されています。 +Instead, the following two items are added. +
+debugger-driver   = (default: none)
+debugger-tcp-port = (default: 0)
+
+ +
+

1. ビルド方法 How to build

@@ -72,9 +103,10 @@ wxWidgets is pkgsrc/x11/wxGTK30 (OPTIONS
  • make (BSD make, not GNU make)
  • C/C++ compiler which supports -std=c++14.
    -(For gcc, 7.4 works but 5.5 doesn't work, at least. -For clang, 7.0 and 8.0 works at least.) -
  • wxWidgets >= 3.0 +(For gcc, 7.4 or newer works at least. +For clang, 7.0 - 13.0 works at least.) +
  • wxWidgets 3.0.x "stable" branch +(but 3.1.x "development" branch is not recommended)
  • gettext @@ -106,10 +138,15 @@ You can specify C/C++ compiler using env if configure cannot find standard name suitable compiler. Also, you can specify wx-config path using environment variable WX_CONFIG if configure cannot find wx-config. +

    +-DNOTEST は開発者用のテストツールをビルドしないためのものです。 +With -DNOTEST, the build excludes test tools which is needed +for developers only. + 

     % ./configure
-% make depend
-% make
+% make -DNOTEST depend
+% make -DNOTEST
 % su
 # make install
    @@ -161,8 +198,7 @@ make the specified file a configuration And in both cases, make the directory where that file is located a VM directory. If -c option is omitted, -vmpath is considered as the current directory. - +vmpath is considered as the current directory. _EOM_ ); @@ -171,8 +207,7 @@ option_item("-f", <<<_EOM_ GUI なら起動後にもメニューから変更できますが、その初期値を変えるだけです。 Boot as the fast mode. You can change this mode on GUI menu after boot, -and the option only changes its initial state. - +and the option only changes its initial state. _EOM_ ); @@ -187,8 +222,7 @@ GUI Only. Specifies the initial fontsize on all sub windows. height is one of 12 or 16. The default value is 12. -You can change this value on GUI menu after boot. - +You can change this value on GUI menu after boot. _EOM_ ); @@ -226,9 +260,10 @@ _EOM_ option_item("-V name=value", <<<_EOM_ 設定ファイルで指定した name=configvalue の代わりに このオプションの name=value を適用します。 +name が正しくない場合はエラー終了します。 Use this name=value instead of name=configvalue specified in configuration file. - +If name is not correct, it will exit on error. _EOM_ ); @@ -238,18 +273,17 @@ option_item("-X file", <<<_EOM_ ファイルが gzip 圧縮されていれば自動的に展開します。 (展開後の) ファイル形式は a.out (OMAGIC) か ELF で、 実際にはブートローダとカーネル程度しか想定していません。 -設定ファイルの prom-image とともに指定されると --X のほうが優先します。 +設定の prom-image、luna-dipsw1 の内容(後述)によらず +内蔵の互換 PROM で起動し、直ちにホストファイルを実行します。 Loads and executes host's file. If file is relative path, it is path from the current directory. If the file is gzip'd, it is automatically extracted. The supported file format (after extracting) is a.out (OMAGIC) or ELF. Actually, it only assumes bootloaders or kernels. -If this option is specified at the same time as -prom-image in configuration file, -this option preceeds. - +Regardless of prom-image and luna-dipsw1 configuration +(see below), +the internal emulated PROM loads and executes the host file immediately. _EOM_ ); ?> @@ -283,8 +317,10 @@ _EOM_ option_dev("-D", <<<_EOM_ コンソールをデバッガとして使用します。 --d を指定しなくても起動時にプロンプトで停止します -(そのうちなんとかしたい)。 + +過去との互換性のために存在していますが、 +-V debugger-driver=stdio と等価です。 + _EOM_ ); @@ -296,6 +332,11 @@ option_dev("-L name1=level1file", <<<_EOM_ +-X オプションと同様ですが、PROM のプロンプトで停止します。 +_EOM_ +); + option_dev("-M name[,name2,...]", <<<_EOM_ 起動時に表示するモニタウィンドウを指定します。 カンマで区切って複数指定することも出来ます。 @@ -317,14 +358,13 @@ VM の設定ファイルはその VM デ 書式は key = value 形式で1行1項目ずつです。 key と value の前後の空白は取り除かれます。 また空行と "#" で始まる行は無視します。 -知らないキーの行も無視します。 +知らないキーは警告を出した上で無視します。 VM configuration file is nono.cfg (or the file specified by -c option) in the VM directory. Its syntax is key = value format, one per line. White spaces before and after key and value are ignored. -Blank lines, lines beginning with "#", and -lines with unrecognized key are also ignored. - +Blank lines, lines beginning with "#" are also ignored. +The lines with unrecognized key are ignored with a warning.

    設定項目は次の通りです。 The configuration items are: @@ -339,11 +379,10 @@ config_item("vmtype = string", << VM 種別を以下のいずれかから指定します。 省略不可です。 Specifies the VM type from the following. -This field is mandatory. - +This field is mandatory.
     luna … LUNA-I -
    luna88k … LUNA88K +
    luna88k … LUNA-88K
    _EOM_ ); @@ -358,18 +397,34 @@ If real, synchronize with the r if virtual, synchronize with the virtual time. The default is real. This feature is under experimentation and may be changed in the future -without notice. - +without notice. _EOM_ ); -config_item("debugger-port = integer", <<<_EOM_ -デバッガの TCP 待ち受けポート番号を指定します。 -0 なら待ち受けを行いません。 -デフォルトは 0 です。 -Specifies the TCP port number that debugger listens. -If 0, it will not listen. -The default is 0. +config_item("debugger-driver = string", <<<_EOM_ + +デバッガのコンソールドライバを指定します。 +stdio、tcp、none が選択可能です。 +stdio は標準入出力を使用します。 +tcp は TCP ポートで TELNET プロトコルで待ち受けます。 +none ならホスト側とは一切通信を行いません。 +デフォルトは none です。 +Specifies console driver of the debugger. +stdio, tcp, and none can be specified. +stdio uses the standard input/output. +tcp listens on TCP port using TELNET protocol. +none doesn't make any communication with the host. +The default is none. + +_EOM_ +); + +config_item("debugger-tcp-port = integer", +<<<_EOM_ + +デバッガのコンソールドライバが tcp の時の TCP 待ち受けポート番号を指定します。 +Specify the TCP port number that debugger console driver listens. + _EOM_ ); @@ -382,6 +437,40 @@ config_item("ethernet-macaddr = strin _EOM_ ); +config_item("hostcom-driver = string", <<<_EOM_ +シリアルポートのホスト側ドライバを指定します。 +stdio、tcp、none が選択可能です。 +stdio は標準入出力を使用します。 +tcp は TCP ポートで TELNET プロトコルで待ち受けます。 +none ならホスト側とは一切通信を行いません。 +デフォルトは none です。 +Specifies the host driver of serial port. +stdio, tcp, and none can be specified. +stdio uses the standard input/output. +tcp listens on TCP port using TELNET protocol. +none doesn't make any communication with the host. +The default is none. +_EOM_ +); + +config_item("hostcom-tcp-port = integer", <<<_EOM_ +ホストドライバが tcp の時の TCP 待ち受けポート番号を指定します。 +Specify the TCP port number that host driver listens. +_EOM_ +); + +config_item("hostcom-fallback = integer", <<<_EOM_ +hostcom-driver で指定したドライバが使用可能でなかった時、 +0 ならプロセスを終了します。1 なら none を選択して実行を継続します。 +デフォルトは 0 です。 +Specify the behavior when the driver which is selected by +hostcom-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("hostkbd-input = string", <<<_EOM_ ホストキーボードの入力モードを指定します。 char ならキャラクタ入力モード、 @@ -422,7 +511,7 @@ The default is auto. _EOM_ ); -config_item("hostdriver-afpacket-ifname = ifname", <<<_EOM_ +config_item("hostnet-afpacket-ifname = ifname", <<<_EOM_ ホストドライバが afpacket の時にバインドするインタフェースを1つ指定します。 ifname が auto なら使用可能なインタフェースを1つ自動的に選択します。 @@ -436,7 +525,7 @@ Note that this host driver cannot commun _EOM_ ); -config_item("hostdriver-bpf-ifname = ifname", <<<_EOM_ +config_item("hostnet-bpf-ifname = ifname", <<<_EOM_ ホストドライバが bpf の時にバインドするインタフェースを1つ指定します。 ifname が auto なら使用可能なインタフェースを1つ自動的に選択します。 @@ -450,7 +539,7 @@ Note that this host driver cannot commun _EOM_ ); -config_item("hostdriver-tap-devpath = path", <<<_EOM_ +config_item("hostnet-tap-devpath = path", <<<_EOM_ ホストドライバが tap の時に使用するデバイスを1つフルパスで指定します。 デフォルトは auto で、この場合は自動的にデバイスを選択します。 この時の探し方はホスト OS によって異なります。 @@ -477,8 +566,7 @@ In all cases, you need to prepare two sh nono-ifup and nono-ifdown in the VM directory or its parent directory. Even if you don't have anything to do in these scripts, -you need to prepare empty scripts that will terminate successfully. - +you need to prepare empty scripts that will terminate successfully. _EOM_ ); @@ -495,6 +583,16 @@ The default is 0. _EOM_ ); +config_item("keyboard-connect = integer", <<<_EOM_ +起動時にキーボードを本体に接続するかどうかを指定します。 +1 なら接続し、0 なら接続しません。デフォルトは 1 です。 +起動後はメニューから変更可能です。 +Specify whether to connect keyboard on boot. +If 1, it is connected; if 0, it isn't connected. The default is 1. +You can change it on GUI menu after boot. +_EOM_ +); + config_item("luna-adjust-misused-epoch = integer", <<<_EOM_ LUNA で誤った RTC epoch を採用している OS 向けに RTC エミュレーションを補正するかどうかを @@ -512,14 +610,12 @@ The default is 1. Normally, leave it 1.

    LUNA で採用している RTC (MK48T02) は2桁で保持している年の値が 4 で割り切れる年をうるう年とする仕様です。 -ところが NetBSD/luna68k、OpenBSD/luna88k など現存してソースが確認できる OS -はいずれもこの RTC の年の値を 1970年からの経過年として使用しています -(LUNA が本来どういう仕様だったのかは分かりませんが、 -異なる OS を起動し直すたびに RTC epoch をずらす運用は考えにくいので -おそらくすべての OS で同じだと思います)。 +ところが NetBSD/luna68k、OpenBSD/luna88k などはこの +RTC の年の値を 1970年からの経過年として使用しています。 例えば1970年はうるう年ではないため 2月28日の翌日は 3月1日ですが、 MK48T02 的には 00年であるためうるう年と認識し 2月28日の翌日が2月29日になります。 -このように、実機の RTC は4年のうち約2年間、1日ずれた日付を指しているようです。 +このように、これらの OS を使っている場合実機の +RTC は4年のうち約2年間、1日ずれた日付を指しているようです。 しかしながら、RTC の時刻は OS 起動時に一度読んだ後は基本的に参照しない上、 今時必要なら NTP で時間を合わせるため、 実機でも問題が顕在化することはまずないと思います。 @@ -548,9 +644,9 @@ See the following link about DIPSW.< → NetBSD/luna68k: Information
    -LUNA88K でのデフォルトは 11111111 です。 +LUNA-88K でのデフォルトは 11111111 です。 各スイッチの内容は以下のリンクを参照してください。 -On LUNA88K, the default value is 11111111. +On LUNA-88K, the default value is 11111111. See the following link about DIPSW.
    → OpenBSD manual pages: boot_luna88k(8) @@ -573,8 +669,22 @@ DIPSW#2 が "11111111" なら if the DIPSW#2 is "11111111". Otherwise, the bootloader will enter interactive mode. (I doubt that they actually wanted to switch with only #8) - -     + +_EOM_ +); + +config_item("luna-video-plane = integer", <<<_EOM_ +LUNA のビデオボードのプレーン数を 1 か 4 で指定します。 +1 ならモノクロビデオボード、 +4 なら16色 (4bpp) ビデオボードに相当します。 +8bpp ボードは(まだ?)サポートしていません。 +デフォルトは今の所 1 です (将来変更するかもしれません)。 +Specify number of planes on LUNA video board. +The valid values are 1 or 4. +1 means a monochrome video board, +4 means 16-color (4bpp) video board. +Note that 8bpp video board is not (yet?) supported. +The default value is 1 for now (It may be changed in the future). _EOM_ ); @@ -585,16 +695,15 @@ config_item("monitor-rate = integerSpecifies refresh rate of all text monitor windows in Hz. It ranges from 1 to 60. The default is 20Hz. You can change this value on GUI menu after boot, -but unlike this configuration value, there are only a few preset choices. - +but unlike this configuration value, there are only a few preset choices. _EOM_ ); config_item("mpu-clock = value", <<<_EOM_ MPU のクロック数を MHz 単位で指定します。 -デフォルトは LUNA-I なら 20MHz、LUNA88K なら 25MHz です。 +デフォルトは LUNA-I なら 20MHz、LUNA-88K なら 25MHz です。 Specifies the MPU clock in MHz. -The default value is 20MHz on LUNA-I, or 25MHz on LUNA88K. +The default value is 20MHz on LUNA-I, or 25MHz on LUNA-88K. _EOM_ ); @@ -617,12 +726,12 @@ _EOM_ ); config_item("prom-image = path", <<<_EOM_ -LUNA-I/LUNA88K の外部 ROM イメージファイルのパスを指定します。 +LUNA-I/LUNA-88K の外部 ROM イメージファイルのパスを指定します。 path がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。 path が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。 空にすると内蔵 ROM を使用します。 デフォルトは空です。 -Specifies the LUNA-I/LUNA88K's external ROM image file path. +Specifies the LUNA-I/LUNA-88K's external ROM image file path. If the path does not have any path delimiters, the VM directory and then its parent directory will be searched. If the path is a relative path, @@ -635,8 +744,7 @@ The default value is empty. nono 内蔵のなんちゃって下位互換 ROM で起動します。 If you does not have the real LUNA machines, you can boot with nono's internal downward compatible emulated ROM -if you set this field empty (or leave it as the default). - +if you set this field empty (or leave it as the default).

    LUNA-I 実機を持っている場合は ROM ファイルを指定することで実機 ROM で起動できます。 @@ -648,16 +756,14 @@ you can boot with the real ROM spcifying The ROM file is extracted from 0x41000000-0x4101ffff (128KB) of the real LUNA-I machine. For now, only V4.22 (Thu Jul 27 11:45:42 1989) is supported. -I have no idea about other ROMs. - +I have no idea about other ROMs.

    -LUNA88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。 +LUNA-88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。 今のところ ROM は version 1.20 のみサポートしています。 -For LUNA88K, +For LUNA-88K, the ROM file is extracted from 0x41000000-0x4103ffff (256KB). -For now, only version 1.20 is supported. - +For now, only version 1.20 is supported. _EOM_ ); @@ -667,7 +773,7 @@ LUNA-I のデフォルトは 16MB です 16MB 未満は 4MB 単位で、 16MB 以上は 255MB まで 1MB 単位で指定できます (ちなみに NetBSD/luna68k の起動には最低でも 8MB 必要です)。 -LUNA88K のデフォルトは 64MB です。 +LUNA-88K のデフォルトは 64MB です。 64MB 未満は 16MB 単位で、 64MB 以上は暫定で 255MB まで 1MB 単位で指定できます。 Specifies the RAM size in MB. @@ -675,10 +781,23 @@ On LUNA-I, the default is 16MB. If the size is less than 16MB, you can specify in 4MB unit. If larger, you can specify up to 255MB in 1MB unit. By the way, NetBSD/luna68k needs at least 8MB to boot. -On LUNA88K, the default is 64MB. +On LUNA-88K, the default is 64MB. If the size is less than 64MB, you can specify in 16MB unit. -If larger, you can specify up to tentative 255MB in 1MB unit. - +If larger, you can specify up to tentative 255MB in 1MB unit. +_EOM_ +); + +config_item("rtc-epoch-year = integer", <<<_EOM_ +RTC の基準年を指定します。 +デフォルトは 1970年です。 +NetBSD/luna68k、OpenBSD/luna88k はいずれも基準年を 1970年としていますので、 +デフォルトのままで構いません。 +ゲスト OS に 4.4BSD を使用する際は 1900 を指定します。 +Specifies the RTC epoch year. +The default is 1970. +Since both NetBSD/luna68k and OpenBSD/luna88k use 1970 as epoch year, +there is no need to touch this value. +If you boot 4.4BSD on LUNA-I as the guest OS, specify 1900. _EOM_ ); @@ -688,8 +807,7 @@ config_item("show-statuspanel = integ 起動後はメニューから変更可能です。 Specifies whether to display the status panel or not. If 0, it is hidden; if 1, it is shown. -You can change it on GUI menu after boot. - +You can change it on GUI menu after boot. _EOM_ ); @@ -704,8 +822,7 @@ Specifies SCSI device and image. Ndevtype and the disk image path path separated by ","(comma). -devtype can be one of the following: - +devtype can be one of the following: