--- nono/doc/index.php 2026/04/29 17:04:40 1.1.1.4 +++ nono/doc/index.php 2026/04/29 17:04:48 1.1.1.6 @@ -46,16 +46,22 @@ nono は NetBSD とかで動作する OM

はじめに Introduction

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

ビルド方法 How to build

-ビルドには以下が必要です。The following are required for build. +ビルドには以下が必要です。 +NetBSD(pkgsrc) なら wxWidgets は pkgsrc/x11/wxGTK30 です +(OPTIONS:gtk2 で動作確認しています)。 +The followings are required for build. +If you use NetBSD(pkgsrc), +wxWidgets is pkgsrc/x11/wxGTK30 (Only OPTIONS:gtk2 is tested). + -wxWidgets は NetBSD(pkgsrc) なら -pkgsrc/x11/wxGTK30 (OPTIONS:gtk2 推奨) です。 -If you use NetBSD(pkgsrc), -wxWidgets is pkgsrc/x11/wxGTK30 (OPTIONS:gtk2 is recommended). +

+(NetBSD 以外でのビルドはサポートしていませんが) +Ubuntu 18.04 ではたぶん以下のパッケージが必要です。 +You may need the following packages on Ubuntu 18.04 +(though we won't support non-NetBSD platform). +

+
+
+bmake +build-essential +gettext +libbsd-dev +libedit-dev +libkqueue-dev +libwxgtk3.0-dev +zlib1g-dev +
+

アーカイブを展開したら以下のようにビルドします。 configure には環境変数 CC、CXX でコンパイラを指定することが出来ます。 @@ -88,10 +108,6 @@ if configure cannot find wx-config. # make install - -

2つの実行ファイルがインストールされます。 nono が GUI 版実行ファイル、 @@ -143,9 +159,24 @@ this option preceeds. _EOM_ ); -option_item("-c vmdir", <<<_EOM_ -VM ディレクトリを指定します。省略するとカレントディレクトリとします。 -Specifies the VM directory. If omitted, the current directory is used. +option_item("-c vmpath", <<<_EOM_ +VM ディレクトリ/設定ファイルを指定します。 +vmpath がディレクトリならそのディレクトリの中の nono.cfg +を設定ファイルとします。 +vmpath がファイルならそれを設定ファイルとします。 +そしていずれの場合も +設定ファイルがあるディレクトリを VM ディレクトリとします。 +-c オプションを省略すると vmpath をカレントディレクトリとします。 +Specifies the VM directory/configuration file. +If vmpath is a directory, +make nono.cfg in that directory a configuration file. +Or if vmpath is a file, +make the specified file a configuration file. +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. + _EOM_ ); @@ -272,12 +303,14 @@ _EOM_

設定 Configuration

-VM の設定ファイルはその VM ディレクトリ内の nono.cfg です。 +VM の設定ファイルはその VM ディレクトリ内の nono.cfg +(または -c で指定したファイル) です。 書式は key = value 形式で1行1項目ずつです。 keyvalue の前後の空白は取り除かれます。 また空行と "#" で始まる行は無視します。 知らないキーの行も無視します。 -VM configuration file is nono.cfg in the VM directory. +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. And, blank lines, lines beginning with "#", and @@ -321,7 +354,39 @@ config_item("ethernet-hostdriver = st nonetapbpf が指定できます。 none ならホスト側とは一切通信を行いません。 tapbpf かはホスト OS によってビルド時に決定します。 -NetBSD なら tap です。 +NetBSD、OpenBSD、FreeBSD、Linux なら tap です。 +Specifies the host driver of ethernet device. +none, tap and bpf can be specified. +If none, it doesn't make any communication with the host. +tap or bpf is determined at build time for the host OS. +If the host is NetBSD, OpenBSD, FreeBSD, or Linux, it's tap. +_EOM_ +); + +config_item("ethernet-hostdevice = string", <<<_EOM_ +イーサネットデバイスのホスト側のデバイス名を指定します。 +ethernet-hostdrivertap の場合ここには +tap デバイスを(フルパスで)指定します。 +Specifies the host device name of ethernet device. +If ethernet-hostdriver is tap, +this field specifies the full path to the tap device. +

+デフォルトは auto で、この場合の動作はホスト OS ごとに異なります。 +Linux なら "/dev/net/tun" を指定したのと同じです。 +OpenBSD なら /dev/tap0 から /dev/tap9 まで +順番にオープンできるまで試します。 +NetBSD (と FreeBSD) ならまず /dev/tap でクローニングを試み、 +それが失敗すれば /dev/tap0 から /dev/tap9 までを +順番にオープンできるまで試します。 +The default is auto. +The behavior in this case depends on the host OS. +On Linux, it's the same as /dev/net/tun. +On OpenBSD, it will try from /dev/tap0 to /dev/tap9 +until successful. +On NetBSD (and FreeBSD), it will try cloning by /dev/tap first. +If that fails, then try from /dev/tap0 to /dev/tap9 +until successful. + _EOM_ ); @@ -394,8 +459,9 @@ _EOM_ config_item("mpu-clock = value", <<<_EOM_ MPU のクロック数を MHz 単位で指定します。 -デフォルトは 20MHz です。 -Specifies the MPU clock in MHz. The default value is 20MHz. +デフォルトは LUNA-I なら 20MHz、LUNA88K なら 25MHz です。 +Specifies the MPU clock in MHz. +The default value is 20MHz on LUNA-I, or 25MHz on LUNA88K. _EOM_ ); @@ -450,8 +516,22 @@ _EOM_ config_item("ram-size = integer", <<<_EOM_ 搭載する RAM サイズを MB 単位で指定します。 -デフォルトは 16MB です。 -Specifies the RAM size in MB. The default is 16MB. +LUNA-I のデフォルトは 16MB です。 +16MB 未満は 4MB 単位で、 +16MB 以上は 255MB まで 1MB 単位で指定できます +(ちなみに NetBSD/luna68k の起動には最低でも 8MB 必要です)。 +LUNA88K のデフォルトは 64MB です。 +64MB 未満は 16MB 単位で、 +64MB 以上は暫定で 255MB まで 1MB 単位で指定できます。 +Specifies the RAM size in MB. +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. +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_ ); @@ -509,7 +589,7 @@ fsck を気にせずカーネルのデ デフォルトは 0 です。 Specifies whether nono ignores writing to SCSI devices. 0 means normal operation (writes to the devices). -If 1 is specified, +If 1 is specified, nono will not actually write back to the disk image even though the write command is succeeded. nono's SCSI devices acts as @@ -602,36 +682,78 @@ in the VM directory or its parent direct nono will open tap(4) and invoke these scripts with the name of the device as an argument.

-最もシンプルなケースだとおそらく -For example, in the simplest case, probably, +例えば、NetBSD ホストで、ホストの wm0 セグメントに nono のゲスト OS を接続する場合、 +For example, if you want to connect guest OS to host's wm0 segment +on NetBSD, +

    +
  1. デフォルトでは /dev/tap は一般ユーザからアクセスできないので、 +chmod で適当にパーミッションを与えます。 +番号の付いていないほうの /dev/tap だけでいいです。 +By default, /dev/tap is only accessible to privileged user. +You need to chmod /dev/tap (without unit number) appropriately. +sysinst 等で OS をアップグレードするとパーミッションが 600 +に戻るのがハマりポイントです。 + +
  2. bridge(4) インタフェースを作成し、 +ホストの外側のインタフェースをブリッジに追加しておきます。 +Create a bridge(4) interface, and +add your physical interface to the bridge.
    -# brconfig bridge0 create
    +# ifconfig bridge0 create
     # brconfig bridge0 add wm0
     
    -のようにして用意しておいた bridge0 に対して、 -(sudo の設定は別途行ってから) -次のような nono-ifup、nono-ifdown を用意すれば -wm0 の物理セグメントとブリッジできると思います。 -If you setup bridge0 as above (and setup sudo) and -prepare the following nono-ifup, nono-ifdown scripts, -you can bridge between the guest network and host's wm0. - +常用するなら設定ファイルに書いておきましょう。 +If you want to use this all the time, +you can put configuration file into /etc. +
    +/etc/ifconfig.bridge0 +
    +create
    +up
    +!/sbin/brconfig $int add wm0
    +
    +
    +# /etc/rc.d/network restart
    +
    +
    + +
  3. +一般ユーザに戻って、 +VM ディレクトリかその親ディレクトリに +次のような 2つのスクリプトを用意します。 +sudo の設定は別途行ってください。 +Return to non-privileged user, and +create following two scripts in the VM directory or its parent directory. +In addition, you need to set up sudo separately.
    nono-ifup
     #!/bin/sh
    -sudo ifconfig $1 up
    -sudo brconfig bridge0 add $1
    +sudo /sbin/ifconfig $1 up
    +sudo /sbin/brconfig bridge0 add $1
     
    -nono-ifup +nono-ifdown
     #!/bin/sh
    -sudo brconfig bridge0 delete $1
    -sudo ifconfig $1 down
    +sudo /sbin/brconfig bridge0 delete $1
    +sudo /sbin/ifconfig $1 down
     
    +
    +% chmod +x nono-ifup nono-ifdown
    +
    + +
  4. nono を起動し、 +メニューの「モニタ > ホスト > ホストネットワーク」を開いて +NetDriver が None 以外 (この場合 BSD tap) になっていれば動いてるはずです。 +Run nono, +and open "Monitor > Host > Host Network" window from menu. +It's OK if you can see "NetDriver: BSD tap" (in this case). + +
+