--- nono/doc/index.php 2026/04/29 17:05:04 1.1.1.11 +++ nono/doc/index.php 2026/04/29 17:05:07 1.1.1.12 @@ -32,25 +32,63 @@

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

@@ -65,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 @@ -99,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
    @@ -216,8 +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. +instead of name=configvalue specified in configuration file. +If name is not correct, it will exit on error. _EOM_ ); @@ -271,8 +317,10 @@ _EOM_ option_dev("-D", <<<_EOM_ コンソールをデバッガとして使用します。 --d を指定しなくても起動時にプロンプトで停止します -(そのうちなんとかしたい)。 + +過去との互換性のために存在していますが、 +-V debugger-driver=stdio と等価です。 + _EOM_ ); @@ -310,13 +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: @@ -334,7 +382,7 @@ VM 種別を以下のいずれかから This field is mandatory.
     luna … LUNA-I -
    luna88k … LUNA88K +
    luna88k … LUNA-88K
    _EOM_ ); @@ -353,13 +401,30 @@ 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_ ); @@ -372,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 ならキャラクタ入力モード、 @@ -412,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つ自動的に選択します。 @@ -426,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つ自動的に選択します。 @@ -440,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 によって異なります。 @@ -484,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 エミュレーションを補正するかどうかを @@ -501,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 で時間を合わせるため、 実機でも問題が顕在化することはまずないと思います。 @@ -537,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) @@ -566,6 +673,21 @@ Otherwise, the bootloader will enter int _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_ +); + config_item("monitor-rate = integer", <<<_EOM_ テキスト系モニタウィンドウの更新頻度を Hz 単位で指定します。 1 から 60 までの間で指定でき、デフォルトは 20Hz です。 @@ -579,9 +701,9 @@ _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_ ); @@ -604,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, @@ -636,10 +758,10 @@ 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.

    -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. _EOM_ @@ -651,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. @@ -659,12 +781,26 @@ 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. _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_ +); + config_item("show-statuspanel = integer", <<<_EOM_ ステータスパネルを表示するかどうかを指定します。 0 なら非表示、1 なら表示です。 @@ -1293,7 +1429,7 @@ In addition, after the first login, you This is because the infamous makemandb(8) runs heavily in the background for a looooong time. It's very sad to me that these two accidents which are far from the ideal -are the first experiences of a newcomer. +are the first experiences of newcomers.

  • 終了する時は root ユーザで “shutdown -p now” を実行してください。 @@ -1307,11 +1443,11 @@ and nono will terminate when the VM is p
    5.2. OpenBSD/luna88k を実行してみる Try OpenBSD/luna88k
    -あおやまさんが OpenBSD/luna88k 7.0-beta の liveimage を用意されています。 -Aoyama-san has provided a liveimage of OpenBSD/luna88k 7.0-beta. +あおやまさんが OpenBSD/luna88k 7.0 の liveimage を用意されています。 +Aoyama-san has provided a liveimage of OpenBSD/luna88k 7.0.
    -
    https://twitter.com/ao_kenji/status/1439351714033766402 +
    https://twitter.com/ao_kenji/status/1473611893386661888
    ここではこれを起動してみます。Let's try it.
    @@ -1322,10 +1458,10 @@ and nono will terminate when the VM is p and create subdirectories for individual VMs in it (for example ~/nono/luna88k/). -
  • 以下のリンクから liveimage-luna88k-raw-20210918.img.gz +
  • 以下のリンクから liveimage-luna88k-raw-20211221.img.gz をダウンロードして展開し、 VM ディレクトリ ~/nono/luna88k/ に置きます。 -Download liveimage-luna88k-raw-20210918.img.gz from the following link, +Download liveimage-luna88k-raw-20211221.img.gz from the following link, extract it and place it in the VM directory, ~/nono/luna88k/. 
     vmtype = luna88k
-spc0-id6-image = hd,liveimage-luna88k-raw-20210918.img
+spc0-id6-image = hd,liveimage-luna88k-raw-20211221.img
 hostnet-driver = none
    @@ -1379,10 +1515,10 @@ so next time it boots OpenBSD automatica
  • 終了する時は root ユーザで “shutdown -p now” を実行してください。 -LUNA88K はソフトウェアから電源オフでき、 +LUNA-88K はソフトウェアから電源オフでき、 VM の電源オフで nono も終了します。 To quit, type “shutdown -p now” as the root user. -LUNA88K can be powered off by software, +LUNA-88K can be powered off by software, and nono will terminate when the VM is powered off.
    • @@ -1481,9 +1617,38 @@ It's OK if you can see "HostNet Driver: + +

    7. 既知の問題 Known Issues

    +
    + +
    -

    7. 過去のバージョンからの移行方法 How to migrate from old versions

    +

    8. 過去のバージョンからの移行方法 How to migrate from old versions

    バージョンアップに伴い設定ファイル等に非互換が発生する場合があります。 その場合は以下の移行方法を参照して設定ファイル等を更新してください。 @@ -1495,20 +1660,20 @@ In such case, you may need to upgrade it
    -

    8. 変更履歴 Changes

    +

    9. 変更履歴 Changes

    See changes.html.
    -

    9. 連絡先、ライセンス等 Contact, License, etc

    +

    10. 連絡先、ライセンス等 Contact, License, etc

    -
    9.1. ライセンス License
    +
    10.1. ライセンス License
    See nono-license.txt.
    -
    9.2. 連絡先 Contact us
    +
    10.2. 連絡先 Contact us
    バグ報告などは以下にお願いします。日本語でおk。 If you find any problems, please let me know. @@ -1517,10 +1682,10 @@ You may write in English.
    >https://github.com/isaki68k/nono-issue/issues
    -
    9.3. パッチの提供について About contributes
    +
    10.3. パッチの提供について About contributes
    パッチを提供してくださる場合は以下に同意したものとします。 -If you provide a patch to nono, you must agree to the following +If you provide a patch to nono, we assume that you agree the following conditions:
    • 成果物が nono のライセンスに従って運用あるいは配布されること。 @@ -1533,7 +1698,7 @@ conditions:
    -
    9.4. Acknowledgements
    +
    10.4. Acknowledgements
    nono は以下の広告条項を含むソースコードを利用しています。 nono uses source code with the following advertising clause.