ROMファイリングシステム (RFS) — テクニカルガイド

RFS テクニカルガイド

ハードウェアプラットフォーム

メモリアーキテクチャ

Address     Size    Contents
─────────────────────────────────────────────────────────────────────
0x0000      4 KB    Monitor ROM (MROM)  — 4 KB window into 512 KB Flash
                    Paged across 16 banks:
                      banks 0–5 = monitor variants + CP/M CBIOS + RFS mrom utils,
                      banks 6–7 = ASM/DASM opcode tables,
                      bank 8 = IPL, bank 9 = RFS message strings,
                      banks 10–15 = reserved
0x1000      256 B   MZ-80A system variables / stack
0x1200    ~46 KB    User RAM  (main program area)
0xCFFF
0xD000      12 KB   Video RAM + memory-mapped I/O (MZ-80A hardware)
0xE800       2 KB   User ROM (UROM) — 2 KB window into 512 KB Flash
                    Paged: banks 0–11 = RFS modules,
                           banks 12–15 = CP/M CBIOS banks
                    Note: on the SFD-700 build the UROM window starts at
                    0xE300 (0xE000–0xE2FF is MZ-700 memory-mapped I/O).
                    The command table (CMDTABLE2) is placed at 0xE300 and
                    the main bank code remains at 0xE800 as on other builds.
0xEFFF
0xF000       4 KB   Floppy AFI ROM / FDC ROM (SFD-700 MROM location)
─────────────────────────────────────────────────────────────────────

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

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

ADDRESS    CONTENT
────────────────────────────────────────────────────────────
0x00000000  RFS DRIVE 0
              0x00000000–0x00001FE0  Directory (256 × 32 B)
              0x00002000–0xFF2000    File blocks (256 × 64 KB)
0x01002000  RFS DRIVE 1  (same structure)
...
0x09012000  RFS DRIVE 9  (same structure)
0x0A014000  (padding to 256 MB boundary)
────────────────────────────────────────────────────────────
0x10000000  CP/M DISK IMAGE 0   (16 MB — 32 sectors × 1024 tracks)
0x11000000  CP/M DISK IMAGE 1
...
0xXX000000  CP/M DISK IMAGE 6
────────────────────────────────────────────────────────────

CP/M 2.2 の実装

ビルドシステム

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（GLASS アセンブラ用）をインストールし、リポジトリをクローンし、コンテンツバンドルを取得し、Git Bash 経由で ./build.sh を実行します — WSL、Docker、再起動は不要です。2 つのビルド済みホストツール（tools/cpmcp.exe、tools/sdtool.exe）がバンドルされているため、Windows では 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 の認証情報も求められることがあります。

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

# フルビルド — すべての ROM をアセンブルし、イメージをパッケージ化し、SD カードイメージをビルドします：
./build.sh

# MZF アプリケーションファイルの再処理を含むフルビルド
# （MZF/ のファイルが変更された場合にのみ必要）：
./build.sh -m

tools/processMZFfiles.sh

# Format: addMZFToROMImageList <ROMDISK> <SFD700> <picoZ80> <reserved> "<path>"
#
# Include in all builds:
addMZFToROMImageList 1 1 1 0 "${MZB_PATH}/Common/sa-5510_rfs.${SECTORSIZE}.bin"
#
# RomDisk and picoZ80 only (no SFD700 — needs SD card):
addMZFToROMImageList 1 0 1 0 "${MZB_PATH}/MZ-80A/defender.${SECTORSIZE}.bin"

参考サイト