MZ-80A ROMディスク — デベロッパーズガイド

RomDisk 開発者ガイド

アセンブリ言語を知らない開発者のための Z80 アセンブリ入門

ソースツリー

アセンブリソースファイルとその役割：

設定：rfs_definitions.asm

; SPI ハードウェア選択 — 正確に 1 つが 1 である必要があります：
HW_SPI_ENA    EQU 1    ; RomDisk v2+ PCB 上のハードウェア SPI（74HCT595/165 シフトレジスター）
SW_SPI_ENA    EQU 0    ; Z80 I/O ポートビットを介したソフトウェアビットバン SPI
PP_SPI_ENA    EQU 0    ; パラレルプリンターポート SPI（v1 ボードのみ）

; プラットフォームオプション：
FUSIONX_ENA   EQU 1    ; tranZPUter FusionX サポートを含める
KUMA80_ENA    EQU 0    ; ターゲットに Kuma 40/80 アップグレードが取り付けられている
VIDEOMODULE_ENA EQU 0  ; ターゲットに 40/80 列カラービデオモジュールが取り付けられている

; ビルドターゲット — 正確に 1 つが 1 である必要があります：
BUILD_ROMDISK EQU 1    ; MZ-80A RomDisk カード用にビルド
BUILD_SFD700  EQU 0    ; SFD-700 フロッピーインターフェイス用にビルド
BUILD_PICOZ80 EQU 0    ; picoZ80 ボード用にビルド

; デバッグ：
ENADEBUG      EQU 0    ; アセンブリ中のデバッグ出力を有効にする（1 = 有効）

UROMADDR     EQU 0E800H          ; ユーザー ROM ウィンドウのベースアドレス
UROMBSTBL    EQU UROMADDR + 020H ; バンク切り替えテーブルエントリーポイント（0xE820）
RFSJMPTABLE  EQU UROMADDR + 0B0H ; ジャンプテーブル開始（0xE8B0）
FDCROMADDR   EQU 0F000H          ; フロッピー AFI ROM アドレス

; バンク制御レジスター（コード化ラッチのロック解除後にのみアクセス可能）：
BNKCTRLRST   EQU 0EFF8H    ; 制御レジスターのロックを解除するにはここを 16 回読み取る
BNKCTRLDIS   EQU 0EFF9H    ; 制御レジスターを再ロック（無効化）するにはここを 1 回読み取る
HWSPIDATA    EQU 0EFFBH    ; ハードウェア SPI データレジスター（読み書き）
HWSPISTART   EQU 0EFFCH    ; ハードウェア SPI 開始トリガー（転送を開始するために書き込む）
BNKSELMROM   EQU 0EFFDh    ; モニター ROM バンク選択レジスター
BNKSELUSER   EQU 0EFFEh    ; ユーザー ROM バンク選択レジスター
BNKCTRL      EQU 0EFFFH    ; バンク制御レジスター（読み書き）

BELL    EQU 007H    ; ターミナルベル
CR      EQU 00DH    ; キャリッジリターン
LF      EQU 00AH    ; ラインフィード
CS      EQU 00CH    ; 画面クリア（FF）
SPACE   EQU 020H    ; ASCII スペース
DELETE  EQU 07FH    ; デリートキー

バンク切り替えの詳細

; 1 つのコマンドテーブルエントリー：
;
;   DB  FLAGS          ; 1 バイト：END|MATCH|BANK[5:3]|SIZE[2:0]
;   DB  "COMMAND"      ; SIZE バイト：コマンド文字列（ヌルターミネーターなし）
;   DW  HANDLER_ADDR   ; 2 バイト：指定バンク内のハンドラールーティンのアドレス
;
; フラグバイトのビットフィールド：
;   ビット 7 = 1：テーブル終端マーカー（最後のエントリー）
;   ビット 6 = 1：完全一致が必要（入力全体が一致する必要がある；後続の文字は不可）
;   ビット 5:3   ハンドラーが存在するバンク番号（0–7 はユーザー ROM バンク 0–7 にマップ）
;   ビット 2:0   コマンド文字列のバイト長（1–7）
;
; 例 — 'D'（ダンプ）コマンド、ハンドラーはバンク 3 にあり、1 文字の文字列：
    DB  000H | 000H | 018H | 001H    ; テーブル終端でない、完全一致でない、バンク 3（011<<3=0x18）、長さ 1
    DB  "D"
    DW  DUMPX

モジュールウォークスルー

SPI ドライバー：ハードウェア対ソフトウェア

HW_SPI_ENA   EQU 1    ; RomDisk v2+ PCB 上の 74HCT595/74HCT165 ハードウェアシフトレジスター
SW_SPI_ENA   EQU 0    ; RomDisk v2+ I/O ポートビットを使用したソフトウェアビットバン SPI
PP_SPI_ENA   EQU 0    ; Sharp MZ-80A パラレルプリンターポート経由のソフトウェアビットバン SPI

新しいモニターコマンドの追加

ステップ 1：rfs_bank3.asm にハンドラーを書く

; rfs_bank3.asm（バンク 3、メモリユーティリティ）内：
PEEK:   CALL  HLHEX              ; 入力バッファから 4 桁の 16 進アドレスを HL に解析
        LD    A,(HL)              ; そのアドレスのバイトを読み取る
        CALL  PRTHX              ; A を 2 桁の 16 進数として表示
        RET

ステップ 2：rfs.asm にコマンドテーブルエントリーを追加する

; rfs.asm 内、CMDTABLE ブロック内（IF BUILD_ROMDISK+BUILD_PICOZ80 = 1 内）：
;
; フラグバイト：テーブル終端でない（bit7=0）、完全一致でない（bit6=0）、
;             バンク 3（bits5:3 = 011 = 0x18）、長さ 4（bits2:0 = 100 = 0x04）
    DB  000H | 000H | 018H | 004H
    DB  "PEEK"
    DW  PEEK

ステップ 3：rfs_bank6.asm にヘルプテキストを追加する

; rfs_bank6.asm 内、HELPSCR ブロック内（000H ターミネーターの前）：
    DB  "PEEKXXXX - read byte at XXXX",    00DH

ステップ 4：ビルドする

cd /dvlp/Projects/MZ80A_RFS/software/RFS
./build.sh

新しいハードウェアサポートの追加

PP2_SPI_ENA  EQU 0    ; 第 2 のパラレルポート SPI バリアント（カスタムハードウェア）

; ガード：一度に設定できる SPI フラグは 1 つのみです。
; GLASS には組み込みの ASSERT ディレクティブがないため、これをビルド時の値チェックとしてエンコードします。
; 複数のフラグが設定されている場合、合計が 1 を超え、SPI ドライバー関数に
; 誤ったコードがアセンブルされるというエラーとして現れます。
; （SDINIT の上のコメントブロックにこの制約を明記してください。）

SPIOUT:     IF HW_SPI_ENA = 1
              ; ハードウェア SPI パス（既存コード）
              LD    (HWSPIDATA),A
              LD    (HWSPISTART),A
              RET
            ELSE
              IF SW_SPI_ENA = 1
                ; ソフトウェアビットバンパス（既存コード）
              ELSE
                IF PP2_SPI_ENA = 1
                  ; 新しい PP2 パス：
                  ; （新しいポートレイアウト用のビットバングをここに実装）
                  RET
                ELSE
                  ; 元の PP_SPI_ENA（Centronics）パス（既存コード）
                ENDIF
              ENDIF
            ENDIF

デバッグのヒント

参考サイト