--- nono/doc/index.php 2026/04/29 17:04:33 1.1.1.2 +++ nono/doc/index.php 2026/04/29 17:04:40 1.1.1.4 @@ -40,15 +40,28 @@ function get_version($filename)

nono

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

はじめに Introduction

+
+nono は NetBSD とかで動作する OMRON LUNA-I とかのエミュレータです。 +LUNA88K は実験的サポートです、まだ動きません。 + +nono is OMRON LUNA-I emulator runs on NetBSD and etc. +LUNA88K is still experimental support and it does not work yet. + +
+

ビルド方法 How to build

ビルドには以下が必要です。The following are required for build. @@ -111,12 +124,15 @@ function option_item($name, $desc) option_item("-A file", <<<_EOM_ ホストの file をロードして実行します。 +file が相対パスの場合カレントディレクトリからのパスになります。 ファイルが gzip 圧縮されていれば自動的に展開します。 (展開後の) ファイル形式は a.out (OMAGIC) か ELF で、 実際にはブートローダとカーネル程度しか想定していません。 設定ファイルの prom-image とともに指定されると -A のほうが優先します。 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. @@ -148,11 +164,13 @@ GUI 版のみ。 全サブウインドウの起動時のフォントサイズを指定します。 height には 12, 16 のいずれかを指定します。デフォルトは 12 です。 +起動後にメニューから変更できます。 GUI Only. Specifies the initial fontsize on all sub windows. height is one of 12 or 16. -The default value is 12 +The default value is 12. +You can change this value on GUI menu after boot. _EOM_ ); @@ -189,10 +207,10 @@ _EOM_ ); option_item("-V name=value", <<<_EOM_ -設定ファイルの name=configvalue の代わりに +設定ファイルで指定した name=configvalue の代わりに このオプションの name=value を適用します。 -Applies this option's name=value -instead of name=configvalue in configuration file. +Use this name=value +instead of name=configvalue specified in configuration file. _EOM_ ); @@ -209,7 +227,7 @@ function option_dev($name, $desc) print "
{$desc}
\n"; } -option_dev("-b hexaddr", <<<_EOM_ +option_dev("-b hexaddr[,skipcount]", <<<_EOM_ デバッガのブレークポイントを 16進数で指定します。 _EOM_ ); @@ -243,6 +261,7 @@ _EOM_ option_dev("-M name[,name2,...]", <<<_EOM_ 起動時に表示するモニタウィンドウを指定します。 カンマで区切って複数指定することも出来ます。 +-Mhelp で name の一覧を表示します。 _EOM_ ); @@ -275,20 +294,25 @@ function config_item($name, $desc) } config_item("vmtype = string", <<<_EOM_ -VM 種別を指定します。 -今の所 string に -指定できるのは luna (LUNA-I) だけですが、省略不可です。 -Specifies the VM type. -For now, only luna (LUNA-I) can be specified for -string. -This field is mandatory. +VM 種別を以下のいずれかから指定します。 +省略不可です。 +Specifies the VM type from the following. +This field is mandatory. + + +
 luna … LUNA-I +
luna88k … LUNA88K (experimental) +
_EOM_ ); config_item("debugger-port = integer", <<<_EOM_ デバッガの TCP 待ち受けポート番号を指定します。 0 なら待ち受けを行いません。 -デフォルトは 9999 です(適当)。 +デフォルトは 0 です。 +Specifies the TCP port number that debugger listens. +If 0, it will not listen. +The default is 0. _EOM_ ); @@ -314,18 +338,24 @@ config_item("luna-dipsw1 = string 本体前面 DIPSW#1-1..#1-8 の内容を指定します。 "0" を DOWN、"1" を UP として、 これを8つ並べた形式で、前から順に #1..#8 に対応します。 -デフォルトは 11110111 です。 -Specifies status of the front panel DIPSW#1-1..#1-8. +Specifies status of the front panel DIPSW#1-1..#1-8 using 8 digit. "0" means DOWN and "1" means UP. The first character corresponds to #1 and -the eighth character corresponds to #8. -The default value is 11110111. +the eighth character corresponds to #8. +

+LUNA-I でのデフォルトは 11110111 です。 +各スイッチの内容は以下のリンクを参照してください。 +On LUNA-I, the default value is 11110111. +See the following link about DIPSW.
+→ NetBSD/luna68k: Information
-各スイッチの内容はここ -(NetBSD/luna68k: Information) を参照してください。 -See NetBSD/luna68k: Information about DIPSW. +LUNA88K でのデフォルトは 11111111 です。 +各スイッチの内容は以下のリンクを参照してください。 +On LUNA88K, the default value is 11111111. +See the following link about DIPSW.
+→ OpenBSD manual pages: boot_luna88k(8) _EOM_ ); @@ -336,13 +366,13 @@ config_item("luna-dipsw2 = string Specifies status of the front panel DIPSW#2-1..#2-8. The same syntax as luna-dipsw1 is used. The default value is 11111111. -
-すべて "1"(UP) なら -NetBSD/luna68k のブートローダは自動的にカーネルをロードして実行し、 -どれかでも "0"(DOWN) にするとプロンプトで停止するようです。 +

+NetBSD/luna68k のブートローダは、 +DIPSW#2 が "11111111" なら自動的にカーネルをロードして実行し、 +どれかでも "0" にするとプロンプトで停止するようです。 (本当は #8 だけで制御するつもりだったんじゃないかという気がします) -If the value is 11111111, -NetBSD/luna68k bootloader will automatically load and execute the kernel. +NetBSD/luna68k bootloader will automatically load and execute the kernel, +if the DIPSW#2 is "11111111". Otherwise, the bootloader will enter interactive mode. (I doubt that they actually wanted to switch with only #8) @@ -350,6 +380,18 @@ Otherwise, the bootloader will enter int _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 change this value on GUI menu after boot, +but unlike this configuration value, there are only a few preset choices. + +_EOM_ +); + config_item("mpu-clock = value", <<<_EOM_ MPU のクロック数を MHz 単位で指定します。 デフォルトは 20MHz です。 @@ -361,12 +403,12 @@ _EOM_ config_item("mpu-has-fpu", ""); */ config_item("prom-image = path", <<<_EOM_ -外部 ROM イメージファイルのパスを指定します。 +LUNA-I/LUNA88K の外部 ROM イメージファイルのパスを指定します。 path がファイル名のみなら VM ディレクトリとその親ディレクトリからこのファイル名を検索します。 path が相対パスなら VM ディレクトリからの相対パスになります (現在のディレクトリからではありません)。 空にすると内蔵 ROM を使用します。 デフォルトは空です。 -Specifies the external ROM image file path. +Specifies the LUNA-I/LUNA88K'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, @@ -376,21 +418,37 @@ If the path is empty, internal em The default value is empty.

実機を持っていない場合はこの値を空に (= デフォルトのままに) しておくと、 -nono 内蔵のなんちゃって下位互換 ROM で起動します。 +nono 内蔵のなんちゃって下位互換 ROM で起動します(現状 LUNA-I のみ)。 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). +For now, it's only for LUNA-I. +

-実機を持っている場合は ROM ファイルを指定することで実機 ROM で起動できます。 +LUNA-I 実機を持っている場合は +ROM ファイルを指定することで実機 ROM で起動できます。 ROM ファイルは実機の 0x41000000-0x4101ffff (128KB) を保存したものです。 -If you have the real LUNA machines, +今のところ ROM は V4.22 (Thu Jul 27 11:45:42 1989) のみサポートしています。 +それ以外については何も分かりません。 +If you have the real LUNA-I machine, you can boot with the real ROM spcifying the ROM file path. -The ROM file is extracted from 0x41000000-0x4101ffff (128KB) from -the real machine. +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. + +

+LUNA88K 実機の場合は 0x41000000-0x4103ffff (256KB) を保存したものです。 +ただし現状サポートしていません。 + +For LUNA88K, +the ROM file is extracted from 0x41000000-0x4103ffff (256KB). +However, it's not supported yet. + _EOM_ ); -config_item("ram-size = value", <<<_EOM_ +config_item("ram-size = integer", <<<_EOM_ 搭載する RAM サイズを MB 単位で指定します。 デフォルトは 16MB です。 Specifies the RAM size in MB. The default is 16MB. @@ -427,6 +485,20 @@ spc0-id6-image = hd,luna.img _EOM_ ); +config_item("spc0-idN-seektime = integer", <<<_EOM_ +指定の SCSI HDD の平均シークタイムを msec 単位で指定します。 +現在のデフォルトは 0 です (S・S・D!! S・S・D!!)。 +16 程度を指定すると幾分往時に思いを馳せることが出来るかもしれませんが、 +今の所あまり安定していません。 +Specifies the average seek time of specified SCSI HDD in msec. +Currently, the default value is 0 +(This may be something like SSD :-). +If you specify about 16 or so, you can feel nostalgic, +but this feature is still unstable. + +_EOM_ +); + config_item("spc0-idN-writeprotect = integer", <<<_EOM_ 指定の SCSI デバイスへの書き込みを無視するかどうか指定します。 0 なら通常動作(書き込みを行う)です。 @@ -467,17 +539,17 @@ _EOM_

  1. どこかに nono 用のディレクトリを用意し(例えば ~/nono/)、 その中に VM ディレクトリを用意します (例えば ~/nono/luna/)。 -Create a directory for nono somewhere (for example ~/nono/), +Create a directory somewhere for nono (for example ~/nono/), and create subdirectory for individual VMs in it (for example ~/nono/luna). -
  2. http://teokurebsd.org/netbsd/liveimage/20200518-luna68k/ から -イメージファイルをダウンロードして展開し、 +
  3. 以下のリンクからイメージファイルをダウンロードして展開し、 VM ディレクトリ ~/nono/luna/ に置きます。 -Download imagefile from -http://teokurebsd.org/netbsd/liveimage/20200518-luna68k/, +Download imagefile from the following link, extract it and place it in the VM directory, ~/nono/luna. +
    +http://teokurebsd.org/netbsd/liveimage/20200518-luna68k/ +
  4. 同じく VM ディレクトリに設定ファイル nono.cfg を以下の内容で用意します。 Create a configuration file nono.cfg in the same VM directory, ~/nono/luna, @@ -489,7 +561,7 @@ spc0-id6-image = hd,liveimage-luna68k-ra
  5. nono -c ~/nono/luna で起動します (VM ディレクトリに自動的に NVRAM.DAT が作られます)。 Run as nono -c ~/nono/luna. -(It creates NVRAM.DAT automatically in the VM directory) +(NVRAM.DAT will be created automatically in the VM directory)
  6. Emulated ROM Monitor が起動するので、 初回は以下のように入力すると NetBSD が起動します。 The emulated ROM Monitor will be executed. @@ -563,21 +635,6 @@ sudo ifconfig $1 down
-

既知の問題 Known problems

-
- - - -
- -

変更履歴 Changes

See changes.html. @@ -590,6 +647,16 @@ See nono-lice
+

連絡先 Contact us

+
+バグ報告などは以下にお願いします。日本語でおk。 +If you find any problems, please let me know. +You may write in English.
+https://github.com/isaki68k/nono-issue/issues +
+ +

パッチの提供について About contributes

パッチを提供してくださる場合は以下に同意したものとします。