--- nono/doc/index.html 2026/04/29 17:05:22 1.1.1.17 +++ nono/doc/index.html 2026/04/29 17:05:26 1.1.1.18 @@ -3,9 +3,9 @@ Copyright (C) 2020 nono project Licensed under nono-license.txt --> - + + -nono document +nono document (1.0.0) -

nono 0.7.0 (2024/02/21)

+

nono 1.0.0 (2024/10/31)

nono は NetBSD とかで動作する OMRON LUNA-I/LUNA-88K のエミュレータです。 -何故か SHARP X68030 と virt68k も動いたりするかも知れません。 +何故か SHARP X68030 と virt-m68k も動いたりするかも知れません。 nono is OMRON LUNA-I/LUNA-88K emulator runs on NetBSD and etc. -It can also emulate SHARP X68030 and virt68k. - +It can also emulate SHARP X68030 and virt-m68k.
@@ -115,32 +115,42 @@ It can also emulate SHARP X68030 and vir
  • make (BSD make, not GNU make)
  • C/C++ compiler which supports -std=c++14.
    -(For gcc, 7.4 or newer works at least. -For clang, 7.0 - 15.0 works at least.) -
  • wxWidgets 3.2.x "stable" branch or 3.0.x "old stable" branch +(For gcc, at least 7.4 or later. +For clang, at least 7.0 or later.) +
  • wxWidgets 3.2.x "stable" branch. + (3.0.x "old stable" branch would also work but is not confirmed.)
  • gettext

    wxWidgets は NetBSD(pkgsrc) なら -pkgsrc/x11/wxGTK32 (OPTIONS:gtk3 で動作確認) です。 +pkgsrc/x11/wxGTK32 です (wxGTK30 でも動くはずです)。 If you use NetBSD(pkgsrc), -wxWidgets is pkgsrc/x11/wxGTK32 (OPTIONS:gtk3 is tested). +wxWidgets is pkgsrc/x11/wxGTK32 +(or wxGTK30).

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

    @@ -170,13 +180,20 @@ Also, you can specify the following opti

    make install により2つの実行ファイルがインストールされます。 @@ -246,19 +263,16 @@ This option is equivalent to fast-mo 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.

    -
    --initrd file
    -
    -(virt68k only) +
    --initrd file
    +
    (virt-m68k only) カーネルに渡す初期 RAM ディスクのパスを指定します。 file が相対パスの場合カレントディレクトリからのパスになります。 設定の exec-initrd とは相対パスの起点の違いを除いて同一です。 - -Specifies the initial ramdisk image passed to the kernel. +Specifies the initial ramdisk image passed to the kernel. If file is relative path, it is path from the current directory. This option is equivalent to exec-initrd in configuration -except for base directory of the relative path. -

    +except for base directory of the relative path.

    -s scale
    GUI 版のみ。 メインウィンドウの起動時のスケールを実数で指定します。 @@ -286,7 +300,7 @@ If name is not correct,
    -X file
    ホストの file をロードして実行します。 file が相対パスの場合カレントディレクトリからのパスになります。 -設定の exec-file とは相対パスの起点の違いを除いて同一です。 +設定の exec-file とは相対パスの起点の違いを除いて同一です。 ファイルが gzip 圧縮されていれば自動的に展開します。 (展開後の) ファイル形式は以下の通りですが、 実際にはブートローダとカーネル程度しか想定していません。 @@ -294,8 +308,8 @@ If name is not correct, Loads and executes host's file. If file is relative path, it is path from the current directory. -This option is equivalent to exec-file in configuration -except for base directory of the relative path. +This option is equivalent to exec-file in configuration +except for base directory of the relative path. If the file is gzip'd, it is automatically extracted. The supported file format (after extracting) is the following. Actually, it only assumes bootloaders or kernels. @@ -313,7 +327,6 @@ NetBSD の実行ファイルのようで If the file is assumed to be NetBSD executable, it will also load symbol tables as the bootloader does to the kernel.)
  • ELF object (Experimental) -
  • Human68k .x executable (Experimental) LUNA では設定の prom-image (後述) によらず内蔵の互換 ROM で起動します。 luna-dipsw1 の DIPSW 設定が @@ -323,10 +336,9 @@ LUNA では設定の prom-image ロードはここで指定したホストファイルをロードします。 X68030 では、IPLROM 起動の後の起動デバイスに細工がしてあり、 そこからホストファイルを実行します。 -virt68k (と NEWS) はこの方法でしか起動できませんので、 -実行ファイルの指定は必須になります。 - -On LUNA, +virt-m68k (と NEWS) はこの方法でしか起動できませんので、 +実行ファイルの指定は必須になります。 +On LUNA, regardless of prom-image configuration (see below), it boots the internal emulated PROM. If luna-dipsw1 configuration meets dipsw-autoboot=yes, @@ -337,7 +349,7 @@ will load the host file that is specifie On X68030, nono hacks the boot device after normal boot from IPLROM, and loads and executes the host file. -On virt68k (and NEWS), this is the only way to boot.

  • +On virt-m68k (and NEWS), this is the only way to boot.

    以下開発用。For developers: @@ -353,6 +365,8 @@ and loads and executes the host file.
    コンソールをデバッガとして使用します。 過去との互換性のために存在していますが、 -V debugger-driver=stdio と等価です。
    +
    -H
    +
    Human68k モードです。→ human.html
    -L name1=level1[,name2=level2,...]
    ログレベルを指定します。 カンマで区切って複数指定することも出来ます。 @@ -407,7 +421,7 @@ do in the same manner. vmtype を除くすべての設定項目はそれぞれデフォルト値を持っています。 つまり少なくとも vmtype だけは設定ファイルかコマンドラインオプションで指定する必要があります。 All configuration items except vmtype have default value. -It means, you must specify at least only vmtype +It means, you need to specify at least only vmtype by configuration file or commandline option.

    設定項目は次の通りです。 @@ -419,11 +433,11 @@ by configuration file or commandline opt Specifies the VM type from the following. This field is mandatory. -
     luna … LUNA-I -
    luna88k … LUNA-88K -
    x68030 … X68030 -
    news … NWS-1750 (Just a joke) -
    virt68k … virt68k +
     luna  … LUNA-I +
    luna88k  … LUNA-88K +
    x68030  … X68030 +
    news  … NWS-1750 (Just a joke) +
    virt-m68k (or virt68k)  … virt-m68k

    cgrom-image = path
    (X68030 Only) @@ -518,23 +532,19 @@ and NWB-512 monochrome console (not impl auto なら自動的に決定します。 デフォルトは auto です。 ethernet-macaddrethernet0-macaddr の別名です。

    -
    exec-file = path
    -
    -起動時にロードするホストの実行ファイルを指定します。 +
    exec-file = path
    +
    起動時にロードするホストの実行ファイルを指定します。 -X オプションとほぼ同等ですが、相対パスは VM ディレクトリを起点にします。 Specifiies the host file that will be loaded at startup. This is mostly the same as -X option. -The only one difference is that relative path originates the VM directory. -

    -
    exec-initrd = path
    -
    -(virt68k Only) +The only one difference is that relative path originates the VM directory.

    +
    exec-initrd = path
    +
    (virt-m68k Only) カーネルに渡す初期 RAM ディスクイメージのパスを指定します。 --initrd オプションとほぼ同等ですが、相対パスは VM ディレクトリを起点にします。 Specifies the initial ramdisk image passed to the kernel. This is mostly the same as --initrd option. -The only one difference is that relative path originates the VM directory. -

    +The only one difference is that relative path originates the VM directory.

    extram-size = integer
    (X68030 Only) 拡張メモリのサイズを MB 単位で指定します。 @@ -582,7 +592,7 @@ FPU を装着するかどうか指定し 68881 の代わりに 1 と書くこともできます。 デフォルトは 68881 です。 LUNA-I はたぶん 68881 搭載モデルのみのため設定できません。 -virt68k も現状 68881 固定としています。 +virt-m68k も現状 68881 固定としています。 Specifies whether to install FPU or not. If none, FPU is not installed. If 68881, 68881 FPU is installed. @@ -592,23 +602,35 @@ And, none can also be written a The default is 68881. This item cannot be specified on LUNA-I because (probably) all LUNA-I has 68881. -This item also cannot be specified on virt68k for now.

    -
    host-avx2 = string
    -
    -ホストが amd64(x86_64) の場合に AVX2 アクセラレーションを使うかどうかを -指定します。 +This item also cannot be specified on virt-m68k for now.

    +
    host-avx2 = string
    +
    ホストが amd64(x86_64) の場合にレンダリングに AVX2 +アクセラレーションを使うかどうかを指定します。 auto なら起動時にホスト CPU が AVX2 をサポートしているか確認し、 サポートしていれば使用します。 no なら AVX2 コードを実行しません。 デフォルトは auto です。 amd64(x86_64) 以外のホストではこの設定は無視されます。 -Specifies whether to use AVX2 acceleration on amd64(x86_64) hosts. +Specifies whether to use AVX2 acceleration for rendering +on amd64(x86_64) host. If auto, nono checks whether the host CPU supports AVX2 on startup and use it if it does. If no, nono will not execute AVX2 instructions. The default is auto. -Note that this item is ignored if the host is not amd64(x86_64). -

    +Note that this item is ignored if the host is not amd64(x86_64).

    +
    host-neon = string
    +
    ホストが aarch64 の場合にレンダリングに NEON +アクセラレーションを使うかどうかを指定します。 +auto なら使用し、 +no なら使用しません。 +デフォルトは auto です。 +aarch64 以外のホストではこの設定は無視されます。 +Specifies whether to use NEON acceleration for rendering +on aarch64 host. +If auto, nono uses NEON code. +If no, nono don't use NEON code. +The default is auto. +Note that this item is ignored if the host is not aarch64.

    hostcom-driver = string
    シリアルポートのホスト側ドライバを指定します。 stdiotcpnone が選択可能です。 @@ -873,6 +895,17 @@ The valid values are 1, 4 or 8. 4 means 16-color (4bpp) video board, 8 means 256-color (8bpp) video board. The default value is 4.

    +
    m88100-version = integer
    m88200-version = integer
    +
    (LUNA-88K Only) +MPU と CMMU のマスクバージョンを設定します。 +今の所これによるエミュレータの動作の違いはありません。 +どちらかというとこれを参照しているゲスト OS の動作確認用です。 +デフォルトは m88100-version が 11、m88200-version が 9 です。 +Specifies MPU and CMMU mask version. +This item doesn't affect any MPU/CMMU emulations for now. +But it may be useful for verifying the guest OS behaviors. +The default value is 11 for m88100-version, +9 for m88200-version.

    mainview-scale = double
    メインウィンドウの起動時のスケールを実数で指定します。 コマンドラインオプション -s で上書き可能です。 @@ -897,10 +930,10 @@ from preset rate or rate specified here.
    mpu-clock = value
    MPU のクロック数を MHz 単位で指定します。 デフォルトは LUNA-I なら 20MHz、LUNA-88K と X68030 なら 25MHz です。 -virt68k ではあまり意味はありませんが 25MHz です。 +virt-m68k ではあまり意味はありませんが 25MHz です。 Specifies the MPU clock in MHz. The default value is 20MHz on LUNA-I, or 25MHz on LUNA-88K and X68030. -On virt68k, it's less meaningful but 25MHz.

    +On virt-m68k, it's less meaningful but 25MHz.

    mpu-pseudo-stop = integer
    (LUNA-88K Only) m88100 にて疑似 STOP 状態を有効にするかどうかを指定します。 @@ -1056,13 +1089,13 @@ You can specify it in 1MB unit from 4MB See extram-size for extended memory.
  • NWS-1750 では現状 16MB で変更できません。 On NWS-1750, This is 16MB fixed for now. -
  • virt68k のデフォルトは 128MB です。 +
  • virt-m68k のデフォルトは 128MB です。 16MB から 4080MB まで(アプリケーションとしては)指定可能です。 指定された値が 16MB で割り切れない場合は 16MB 単位に切り上げになります。 -On virt68k, the default is 128MB and +On virt-m68k, the default is 128MB and the range is 16MB to 4080MB. If the specified size is not divisible by 16MB, -it will be rounded up to 16MB. +it will be rounded up to 16MB.

  • rtc-epoch-year = integer
    (LUNA Only) @@ -1197,19 +1230,16 @@ $ed0008.L (RAM size) in SRAM with config This update is performed once only if the SRAM magic string is correct at the application startup. The default is 1.

    -
    virtio-blockN-image = path
    -
    -(virt68k only) +
    virtio-blockN-image = path
    +
    (virt-m68k only) virtio のブロックデバイスのイメージを指定します。 キーの N は現状 0 から 7 です。 イメージパスが相対パスなら VM ディレクトリからの相対パスになります。 Specifies virtio block device's image. N in the key is 0 to 7 for now. -If the path is relative path, it is from the VM directory. -

    -
    virtio-blockN-writeignore = integer
    -
    -(virt68k only) +If the path is relative path, it is from the VM directory.

    +
    virtio-blockN-writeignore = integer
    +
    (virt-m68k only) 指定の virtio ブロックデバイスへの書き込みをイメージに書き戻すかどうか指定します。 0 なら通常動作(書き込みを行う)です。 1 ならディスクイメージに一切書き戻しません。 @@ -1231,15 +1261,12 @@ This is useful for kernel debugging beca after the kernel hangs or reboots. Don't use this flag if you don't understand this paragraph. The default value is 0. -

    - ちなみに、メディアを書き込み禁止にしたい場合はこれではなく、 イメージファイルの書き込み権を落としてください。 By the way, if you want to make the media write-protected, clear the write permission from the image file -(instead of this setting). -

    +(instead of this setting).

    windrv-path = path
    (X68030 Only) Windrv でゲスト側に見せるホストディレクトリを指定します。 @@ -1299,8 +1326,8 @@ Only if you run the X server on NetBSD/x
    LUNA-I
    MPU (68030) - ○ - データキャッシュ未実装 Data cache not implemented + + データキャッシュ実装 Data cache has implemented
    FPU (68881) @@ -1367,8 +1394,8 @@ Only if you run the X server on NetBSD/x
    X68030
    MPU (68030) - ○ - データキャッシュ未実装 Data cache not implemented + + データキャッシュ実装 Data cache has implemented
    MPU (68EC030) 実装予定なし Not planned @@ -1452,8 +1479,8 @@ Only if you run the X server on NetBSD/x
    NWS-1750
    MPU (68030) - ○ - データキャッシュ未実装 Data cache not implemented + + データキャッシュ実装 Data cache has implemented
    FPU (68881) 68882 は未実装 68882 not implemented @@ -1487,33 +1514,36 @@ Only if you run the X server on NetBSD/x
    電源 Power Circuit × -
    virt68k +
    virt-m68k
    MPU (68030) - ○ - データキャッシュ未実装 Data cache not implemented + + データキャッシュ実装 Data cache has implemented
    FPU (68881) 68882 は未実装 68882 not implemented -
    Goldfish PIC - +
    Goldfish PIC + -
    Goldfish RTC - +
    Goldfish RTC + ◎ + +
    Goldfish Timer + -
    Goldfish Timer - +
    Goldfish TTY + -
    Goldfish TTY - +
    virtio v1.0 block + -
    virtio v1.0 block - +
    virtio v1.0 net + -
    virtio v1.0 net - +
    virtio v1.0 entropy + -
    Power Control - +
    Power Control +
    @@ -1522,10 +1552,8 @@ Only if you run the X server on NetBSD/x
    4.2. MPU (68030)
    -68030 は命令キャッシュのみ実装し、データキャッシュは未実装です。 -また ATC (アドレス変換キャッシュ) は実際の仕様とは異なり高速化してあります。 -68030 instruction cache is implemented but data cache is not. -ATC (Address Translation Cache) is differ from and faster than the real 68030. +68030 ATC (アドレス変換キャッシュ) は実際の仕様とは異なり高速化してあります。 +68030 ATC (Address Translation Cache) is differ from and faster than the real 68030.
    @@ -1569,8 +1597,7 @@ PROM も NetBSD/news68k
    -4.6. virt68k エミュレーション
    - +4.6. virt-m68k エミュレーション
    QEMU の "virt" (架空ハードウェア仕様)の互換機wをサポートしています。 NetBSD/virt68k が動作します。 -X オプション (または設定の exec-file) @@ -1587,7 +1614,6 @@ If you want to install, you also need to --initrd option (or exec-initrd in configuration). And also, you may need to configure serial console by hostcom-driver in configuration. -
    @@ -1657,9 +1683,10 @@ Also, SW8 specifies enable/disable of th
    4.8. Windrv
    -Windrv を一応サポートしてみました。 +X68030 で Windrv を一応サポートしています。 Human68k からホストのファイルシステムをアクセスする機構です。 -既存の Windrv とは、ホスト OS の前提が異なるため既存実装からの移植ではありませんし、 +従来の Windrv とはホスト OS の前提が異なるため、 +既存実装からの移植ではありませんし、 そもそも Human68k とホスト(UNIX)ファイルシステムの差異による制約も多くあります。 これらを把握してから使用してください。
    @@ -2605,9 +2637,18 @@ In such case, you may need to upgrade it
    + +
    +9. 付属ソフトウェア Included Software
    + +
    +
    + +
    -9. 変更履歴 Changes
    +10. 変更履歴 Changes
    @@ -2615,10 +2656,10 @@ See changes.html<
    -10. 連絡先、ライセンス等 Contact, License, etc +11. 連絡先、ライセンス等 Contact, License, etc
    -10.1. ライセンス License
    +11.1. ライセンス License
    • nono 自身については @@ -2642,7 +2683,7 @@ nono は SIL Open Font License version 1
      -10.2. 連絡先 Contact us
      +11.2. 連絡先 Contact us
      バグ報告などは以下にお願いします。日本語でおk。 If you find any problems, please let me know. You may write in English.
      @@ -2653,7 +2694,7 @@ You may write in English.
      -10.3. パッチの提供について About contributes
      +11.3. パッチの提供について About contributes
      パッチを提供してくださる場合は以下に同意したものとします。 If you provide a patch to nono, we assume that you agree the following conditions: @@ -2670,7 +2711,7 @@ conditions:
      -10.4. Acknowledgements
      +11.4. Acknowledgements
      nono は以下の広告条項を含むソースコードを利用しています。 nono uses source code with the following advertising clause.