ROMファイリングシステム (RFS)

概要

RFS モニター

Kuma 40/80 桁アップグレードまたはビデオモジュールが搭載されている場合、4 を入力すると 40 桁表示、8 を入力すると 80 桁表示に切り替わります。80 桁モードでは、ディレクトリ一覧コマンド（IC / IR）が 4 列で表示されます。

アップグレード済みアプリケーション

Sharp BASIC SA-5510

デフォルトのドライブレイアウトについては下記の SD カード構成 をご参照ください。

Microsoft BASIC

• MS-BASIC(MZ-80A) — オリジナル MZ-80A ハードウェア用、カセットストレージのみ対応。
• MS-BASIC(RFS40) — 40 桁表示の RFS 用；SD カード・CLOAD・CSAVE・DIR を追加。
• MS-BASIC(RFS80) — 80 桁表示の RFS 用；SD カード・CLOAD・CSAVE・DIR を追加。

各バリアントは RFS ROM ドライブおよび SD ドライブに収録されています。完全な標準コマンドセットについては NASCOM Basic Manual をご参照ください。以下の表は RFS 向けに追加された拡張機能を示します。

NASCOM カセットイメージコンバーター

nasconv v1.0

Required:
  -i | --image  <file>   Cassette image file to convert.
  -o | --output <file>   Output file for converted BASIC data.

Options:
  -l | --loadaddr <addr> MZ-80A BASIC start address.
  -n | --nasaddr  <addr> Original NASCOM BASIC start address.
  -h | --help            Show this help.
  -v | --verbose         Verbose output.

Example:
  nasconv --image 3dnc.cas --output 3dnc.bas \
          --nasaddr 0x10fa --loadaddr 0x4341

BASIC MZ-5Z008（Quick Disk）

BASIC MZ-2Z009E（Floppy Disk）

ソフトウェアアーキテクチャ

ビルドシステム

前提条件

GLASS Z80 アセンブラ（glass.jar）は tools/ ディレクトリに同梱されており、別途インストールは不要です。

自動セットアップとビルド（推奨）

macOS / Linux / WSL — setup_RFS.sh

chmod +x setup_RFS.sh
./setup_RFS.sh

Windows 10 / 11 — setup_RFS_windows_native.ps1 (推奨 — ネイティブ、WSL 不要)。PowerShell プロンプトから：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\setup_RFS_windows_native.ps1

ネイティブスクリプトは winget を使用して Git for Windows（bash、coreutils、perl、curl を提供）と Temurin JRE（Java、GLASS アセンブラ用）をインストールし、リポジトリをクローンし、コンテンツバンドルを取得し、Git Bash を通じて ./build.sh を実行します — WSL、Docker、再起動は不要です。2 つのビルド済みホストツール（tools/cpmcp.exe と tools/sdtool.exe）がバンドルされているため、Windows では RFS のビルドに C コンパイラは必要ありません。

Windows 10 / 11 — setup_RFS_windows.ps1 (代替 — WSL2 / Ubuntu 内でビルドします)。管理者 PowerShell から：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\setup_RFS_windows.ps1

この WSL バリアントは WSL2 + Ubuntu が未導入の場合はインストールします（この際、一度だけ再起動が必要です — 再起動し、スタートメニューから Ubuntu を一度起動して Linux のユーザー名／パスワードを作成してから、スクリプトを再実行してください）。その後、Ubuntu 内で setup_RFS.sh を実行します。特に WSL 環境が必要な場合を除き、上記のネイティブスクリプトを推奨します。

セットアップが尋ねる質問と対応方法

各プロンプトには角括弧内に安全なデフォルトが表示されます — 大文字のほうがデフォルトなので、Enter を押すと受け入れられます。プロンプトは以下の順で表示されます：

Windows のみ（PowerShell で、Linux セットアップが実行される前）：

macOS / Linux / WSL（Linux / Ubuntu シェルで）：

sudo パスワード（パッケージインストール）や、非公開リポジトリを選んだ場合は git の認証情報も求められることがあります。

セットアップ後 — 再ビルド

セットアップが完了するとチェックアウトのパスが表示されます。後で再ビルドするには：

cd ~/RFS                 # or the directory you chose
source ./rfs_env.sh      # macOS only (adds GNU coreutils + the JRE to PATH); harmless elsewhere
./build.sh -m            # FIRST build: process MZF -> MZB, then build everything
./build.sh               # subsequent builds (re-run -m only when MZF sources change)
./build.sh -h            # list variants and options

Windows では、Ubuntu ターミナルを開き（スタートメニュー →「Ubuntu」、または PowerShell で wsl と入力）、~/RFS 内で同じコマンドを実行します。ROM イメージは ~/RFS/roms に生成されます。

build.sh はデフォルトですべてのハードウェアバリアントをビルドします。1 つ以上のバリアント名（sfd700・romdisk_mz80a・picoz80_mz80a・picoz80_kuma・picoz80_mz700・picoz80_mz1500・picoz80_mz80k、または all）を渡すと、それらのみをビルドします。バリアントを選択するとすべてが自動的に設定され、ソースの編集は不要です。オプション：-m（MZF を処理）・-s（共有アセンブリをスキップ）・-c（クリーン）・-v（詳細）・-h（ヘルプ）。

上級：ビルドターゲットフラグ

ほとんどのビルドではこのセクションは不要です — 上記の build.sh でバリアントを選択すると、すべてが自動的に設定されます。その内部メカニズムは asm/include/rfs_definitions.asm 内のフラグ群で、特定のターゲットに対して以下のうち正確に 1 つだけが 1（その他はすべて 0）に設定されます。これは build.sh がバリアントごとに行います。カスタム構成の場合のみ、手動で編集してください：

同ファイル内の追加オプションフラグ：

手動ビルドと build.sh の動作

セットアップスクリプトを使いたくない場合（または CI ビルドをスクリプト化する場合）は、直接クローンしてビルドできます — その場合も前提条件をインストール済みである必要があり、新規の単独クローンでは自分でコンテンツイメージを取得する必要があります（または、それを代行してくれる setup_RFS.sh を実行してください）：

git clone --recurse-submodules https://git.eaw.app/eaw/RFS.git
cd RFS

# Full build (assembles all ROMs, packages ROM images, builds SD card image):
./build.sh

# Full build including re-processing all MZF application files
# (only needed when MZF source files in MZF/ have changed):
./build.sh -m

build.sh は以下の手順を順番に実行します：

1. cpmtools をソースからコンパイルし（初回のみ）、結果を PATH に追加。
2. tools/assemble_rfs.sh — rfs.asm と rfs_mrom.asm を roms/rfs.rom と roms/rfs_mrom.rom にアセンブル。
3. tools/assemble_cpm.sh — CP/M 2.2 CBIOS（cbios.asm・cbios_bank1–4.asm・cpm22.asm）を roms/*.rom にアセンブル。
4. tools/assemble_roms.sh — 全モニターバリアント（SA-1510・80c SA-1510・1Z-013A・ハイロードバリアント・Kuma バージョン・IPL）と MZF アプリケーションファイル（SA-5510・MS-BASIC バリアントなど）を roms/ と MZB/ にアセンブル。
5. tools/make_roms.sh — アセンブルされた ROM と MZF アプリケーションを Flash ROM イメージにパッケージング（下記「出力ファイル」参照）。
6. tools/make_cpmdisks.sh — プリポピュレートされた各 CP/M ドライブセット用に、RAW 形式と CPC 拡張ディスク形式で CP/M ディスクイメージをビルド。
7. tools/make_sdcard.sh — 10 個の RFS ドライブイメージと 7 個の CP/M ディスクイメージを組み合わせた最終的な SD カードイメージを作成。

個々のスクリプトは部分的な再ビルドのために tools/ ディレクトリ内から直接実行することもできます。

出力ファイル

ビルドが成功すると、roms/ ディレクトリに以下のファイルが生成されます：

Flash ROM のプログラミング

ROM イメージは、TL866 または互換プログラマーを使用して SST39SF040（512 KB）Flash RAM チップに書き込みます：

# Monitor ROM (RomDisk build):
minipro --infoic /path/to/minipro/infoic.xml -p SST39SF040 -s -w roms/MROM_ROMDISK_256.bin

# User ROM 1:
minipro --infoic /path/to/minipro/infoic.xml -p SST39SF040 -s -w roms/USER_ROM_256.bin

# SFD-700:
minipro --infoic /path/to/minipro/infoic.xml -p SST39SF040 -s -w roms/SFD700_256.bin

SD カードイメージの書き込み

統合 SD カードイメージを dd で SD カードに直接書き込みます：

# Replace /dev/sdX with your SD card device:
dd if=roms/SHARP_MZ80A_RFS_CPM_IMAGE_1.img of=/dev/sdX bs=512
sync

パーティション設定は不要です。SDCFS イメージはセクター 0 から始まります。SD カードを RomDisk ボードのリーダーに挿入してください。

ROM ドライブへのアプリケーション追加

Flash ROM ドライブに保存するアプリケーションは、まず MZF 形式からセクターパッドされたバイナリイメージに変換する必要があります。MZF ファイルを MZF/ 以下の適切なサブディレクトリに配置し、以下を実行します：

tools/processMZFfiles.sh

これにより、すべての MZF ファイルが 128 バイトおよび 256 バイトのセクターパッドイメージに変換され、MZB/ に保存されます。これらは make_roms.sh によって自動的に取り込まれます。

各 ROM ドライブに収録するアプリケーションを選択するには、tools/make_roms.sh を編集し、addMZFToROMImageList の呼び出しを調整します。各呼び出しは 4 つのフラグ（ROMDISK ビルドに含める・SFD700 ビルドに含める・picoZ80 ビルドに含める・予約済み）とセクター化バイナリのパスを受け取ります：

# Format:
#   addMZFToROMImageList  <ROMDISK>  <SFD700>  <picoZ80>  <reserved>  "<MZB path>"
#
# Example — include in all builds:
addMZFToROMImageList 1 1 1 0 "${MZB_PATH}/Common/sa-5510_rfs.${SECTORSIZE}.bin"

# Example — RomDisk and picoZ80 only:
addMZFToROMImageList 1 0 1 0 "${MZB_PATH}/MZ-80A/defender.${SECTORSIZE}.bin"

アプリケーションはリストに記載された順に詰め込まれ、まずユーザー ROM 1、次にユーザー ROM 2 と 3 が埋められます。常に利用可能にしたいアプリケーションはリストの先頭に配置してください。

ビルドツールリファレンス

SD カードファイリングシステム

SDCFS 構造

各ファイルブロックは、最大 CMT（テープ）ブロックサイズと一致する固定 64 KB です。これによりレイアウトがシンプルに保たれ、テープ上にあるかのようにファイルを読み書きできるため、透過的な SD↔CMT コピー操作が可能になります。

SD カードレイアウト

ADDRESS    SECTOR   CONTENT
00000000   00000  ┌─────────────────────────────────────────────────────────────┐
                  │  RFS DRIVE 0                                                │
00000000   00000  │  Directory entry 000 (32 bytes)                             │
                  │  ...                                                        │
00001FE0   0000F  │  Directory entry 255 (32 bytes)                             │
00002000   00010  │  File block 0     (64 KB)                                   │
                  │  ...                                                        │
00FF2000   7FF90  │  File block 255   (64 KB)                                   │
01001FFF   8000F  └─────────────────────────────────────────────────────────────┘
                  ...  (RFS drives 1–8 follow the same pattern)
09012000   48090  ┌─────────────────────────────────────────────────────────────┐
                  │  RFS DRIVE 9                                                │
0A013FFF   5009F  └─────────────────────────────────────────────────────────────┘
                  ... padding to 256 MB boundary ...
10000000   80000  ┌─────────────────────────────────────────────────────────────┐
                  │  CP/M DISK IMAGE 0   (16 MB, 32 sectors × 1024 tracks)     │
11000000   88000  ├─────────────────────────────────────────────────────────────┤
                  │  CP/M DISK IMAGE 1                                          │
                  │  ...                                                        │
XX000000          │  CP/M DISK IMAGE n                                          │
                  └─────────────────────────────────────────────────────────────┘

SD カード構成

リポジトリのツールでビルドされる SD カードイメージは、以下の内容であらかじめ用意されています：

マニュアル

クレジット

ライセンス

GNU Public License v3

</div>