ZX Spectrum システムツアー:テキストモード
ZX Spectrum System Tour: Text Mode (bumbershootsoft.wordpress.com)
要約
この記事は、ZX Spectrumの機械語レベルでのシステム操作、特にテキスト表示機能に焦点を当てています。BASICとの連携方法、メモリ構造、そして画面表示のためのシステム変数やROMルーチンについて解説し、ユーザー定義グラフィックスやキーボード入力についても触れています。機械語プログラムのロードと実行、BASICとの共存メカニズムも説明されています。
全文翻訳
ZX Spectrum システムツアー:テキストモード
以前、SpectrumのBASICがハードウェアに対してどのような制御を提供してくれるかを見てきましたが、今回はマシン語の世界に踏み込み、そこで提供されるものを見ていきましょう。この領域はさらに多くのことをカバーする必要があり、いくつかの投稿にまたがるだろうと予想しています。
また、他の多くのプラットフォームよりもかなり困難でもあります。なぜなら、Sinclairは一貫性のある構造化されたファームウェアインターフェースを公開することに最小限の注意しか払わなかったからです。Commodoreの8ビット機は、オリジナルのPETからC128に至るまで、すべて互換性のあるジャンプテーブルを「KERNAL」ROMの末尾に持っており、ファイル処理やディスクアクセスのようなことを行う場合でも、かなりのマシン語コードが同一に機能することを意味していました。MSXは単一のコンピュータではなく、メーカーが準拠する業界標準であり、その主要な部分はその割り込みベクタの近くにある明確に定義されたジャンプテーブルでした。IBM PCのBIOSも同様の役割を果たしましたが、それほど自発的ではありませんでした。
しかし、Spectrumには定義されたエントリポイントがわずかしかなく、その結果、開発者は望む結果を得るためにシステムROMの奥深くを直接呼び出す傾向がありました。Timex Sinclair 2068は互換性のないROMを持っており、その結果、Spectrumのソフトウェアはほとんど動作しませんでした。これが米国市場での失敗の大きな要因であったと理解されているようです。私はこれに少し懐疑的です。なぜなら、その急激な米国でのクラッシュは、MSX、Commodore 16、Coleco Adamも共有しており、これらはすべてTS2068の直接の競合となりうるものだったからです。しかし、2068の失敗後に128がリリースされ、128がROMの関連部分を48Kバージョンと非常に注意深く互換性を保っていたことを考えると、Sinclairはそれでもここで重要な教訓を学んだと推測します。
このシリーズの目的のために、私は48K Spectrumをターゲットプラットフォームとして使用しますが、説明するテクニックが16Kおよび128Kマシンでも機能することを確認します。さまざまな忠実度のスペクトルクローンや後継機が膨大に存在しました。もし途中でそれらに関して興味深いものに出くわしたら、それを取り上げますが、それは純粋にサイドバーの領域になるでしょう。
最初の試みとして、先週紹介した100%BASICの「Manic Mechanic」ゲームのようなディスプレイを取得するために、私たちがコマンドできる機能を見ていきます。
この記事では、まず基本的なシステム構成を見ていきます。マシン語プログラムがシステム上にどのように存在し、どのようにロードされ実行されるか、そしてBASICやBIOSとどのように共存するかです。次に、システム上のテキストベースのディスプレイ機能、そして「Manic Mechanic」自体が依存している「ユーザー定義グラフィックス」機能について掘り下げていきます。最後に、キーボードとジョイスティックの入力を見ていきます。これはBASICで行ったことと非常に近いことがわかります。
最初の原則:コードの実行
私がZX Spectrumを探求し始めたとき、BASICがマシンコードとどれほど簡単に共存できるかに非常に満足しました。多くの標準BASICコマンドには追加モードがあり、純粋なマシン語プログラムだけでなく、BASIC/MLの混合コンビネーションにも非常に適しています。
- カセット上のファイルは、BASICコード、BASICデータ、またはバイナリデータとして識別されます。BASICの
SAVEおよびLOADコマンドには、他のBASICのLOADおよびBLOADコマンドのように、何をロードするかを正確に指定する拡張機能があります。テープからマシン語をロードするには、ファイル名の後にキーワードCODEを付けます。 - BASICは、
CLEARコマンドにパラメータを渡すことでメモリ使用量を制限できます。BASICのメモリの上限をマシンコードのロードポイントのすぐ下に下げることで、メモリの競合を完全に回避できます。 - BASICは、
USR関数を使用してマシン語サブルーチンを呼び出します。これはルーチンのアドレスを引数として取ります。ルーチンは作業を行い、RET命令でBASICに戻ります。BCレジスタペアの値は、16ビット符号なし整数として関数の値としてBASICに返されます。意味のある戻り値のないルーチンは、一般的に乱数ジェネレータに渡すことでそれを処分します。Sinclair BASICのRANDOMIZE USRは、C64 BASICのSYSとほぼ同じことを行います。
バイナリデータの範囲を保存するだけでなく、SAVE関数は、LOAD直後に実行が開始されるようにBASICプログラムを保存することもできます。そして、任意の行番号から実行を開始できます。2017年に、私はSpectrumプログラム用に、それ以来使用している、より洗練されたBASICスタブを作成しました。一般的な戦略は次のとおりでした。
- BASICプログラムは、行10ではなく行30から実行が開始されるように保存されます。
- 行30のコードは、
CLEARコマンドでBASICのメモリを制限し、次にテープ上の次のファイル(実際のプログラム)をバイナリとしてロードします。ロードが完了すると、プログラムの上部へジャンプします。 - 行10と20は、
RANDOMIZE USRでロードされたマシンコードを呼び出し、ローダーロジックをスキップしてプログラムが正常に終了するようにします。
これらすべてを終えると、実行時にマシンコードコンポーネントを実行するプログラムになりますが、ロード時には必要な準備がすべて一度だけ実行されます。これをターンキーパッケージングスクリプトとして使用できるものにすることは、このツアーの範囲外なので、それに関する元の記事と、必要であればスクリプト自体(Python)のコピーへのリンクを貼るだけにしておきます。
マシンコードから見たSpectrum
Z80は64KBのアドレス空間を持ち、48K Spectrumではそのすべてが使用されます。
$0000–$3FFFはシステムROMです。$4000–$5AFFは、ビットマップデータとカラーテーブルの両方のグラフィックスRAMです。- それ以外はシステム用のRAMです。
これは基本的に16Kおよび128K Spectrumでも同様ですが、16KのRAMは$7FFFで終了し、128のROMとRAMの両方はバンク切り替えされています。
アセンブリ言語コードを書く際、システムROMが所有する機能を使用することはできません。これには、割り込み、シャドウレジスタ、およびIYレジスタに関連するすべてのものが含まれます。
IYレジスタは特別ですが、編集することは許可されていませんが、読み取ること(常に$5C3Aです)や、そこからインデックスを付けることはできます。これは、Sinclairがシステム変数と呼ぶもののベースアドレスを保持しており、現在のシステム状態に関するデータのコレクションであり、定期的に読み書きすることになります。これらの変数の場所は、ROMよりも互換性のないバリアント間でより一貫性があります。私は最初のプロジェクトを作成したときにこれに大きく依存しました。
ROM自体はかなりカジュアルで、システム変数を直接アドレスで参照することがよくありますが、必要に応じてIYからインデックスを付けてアクセスすることもあります。インデックス操作はより高価ですが、より柔軟です。そのため、ベースアドレスが正確にわかっているがインデックスレジスタもあるこのユースケースでは、絶対アドレスの使用とインデックスアクセスとの間で切り替えることになります。ここでは、すべてのシステム変数アクセスがIYを経由するようにコードを書きますが、これは一般的には行われていませんでした。(実際、私自身もSpectrumプラットフォームガイドではそうしていません。)
テキストの表示
BASICツアーで見たように、Spectrumは画面をメインディスプレイ用の22行の上部ウィンドウと、入力およびステータスメッセージ用の2行の下部ウィンドウに分割します。これはBASICのアーティファクトではありません。この分割はマシンコードレベルでも存在します。上部ウィンドウにテキストを表示するには、システム変数を適切に設定して、その出力ルーチンがテキスト出力をそこに誘導するように指示する必要があります。これは、IY+2にあるTVFLAGに0を書き込むことで実行できます。これが完了したら、アドレス$10にあるROMルーチンを呼び出して、Aレジスタにある文字を表示できます。SpectrumはASCIIを使用しているため、通常のテキストは私たちにとって非常に馴染み深いものになるでしょう。
これにより、「Hello World」は非常に簡単になります。
org $7000
ld (iy+2),0 ; 上部スクリーンに書き込む
ld hl,msg
lp:
ld a,(hl)
inc hl
or a
ret z
rst $10
jr lp
msg:
db "Hello, world!",13,0
私は通常、$7000をオリジンアドレスとして使用します。これはRAMの奥深くにあるため、BASICに十分な余裕を残しつつ、小さなプロジェクトでも16Kマシンに収まる可能性のある十分なスペースを残すことができます。これをsjasm hello.asm hello.binのようなコマンドでアセンブルし、spectralink.py hello.bin 7000でパッケージ化し、FUSEにhello.bin.tzxをロードして…
離陸しました!
グラフィック文字の定義と使用
BASICで作業していたとき、2種類のグラフィック文字があることを見つけました。組み込みのセミグラフィックスと、プログラム可能な文字のセットである「ユーザー定義グラフィックス」です。これらは、「グラフィックス入力モード」に切り替えてから、キー1〜8(必要に応じて反転ビデオモードを使用して16通りの可能な組み合わせすべてを取得)およびA〜U(ユーザー定義文字)を押すことで入力しました。
これは、マシン語の方がBASICよりも少し簡単な場所です。「グラフィックスモード」は入力システムの奇妙な機能であり、必要な文字を直接入力する手間から解放されるため、拡張文字を文字表示ルーチンRST $10に渡すだけで済みます。
定義済みのセミグラフィックスを使用すると、もう1つの大きな利点があります。反転ビデオの厄介な回避策は、キーボードに十分なキーがなかったために直面したものでした。内部的には、$80–$8Fの範囲で16通りのセミグラフィックス文字すべてがすぐに利用できます。それらは合理的な順序で配置されています。ビット1、2、4、8は、それぞれ文字の右上、左上、右下、左下の象限に対応します。
ユーザー定義グラフィックスも同様です。これらは$90–$A4の範囲を占め、グラフィックAからグラフィックUまで実行されます。(128では、利用可能な文字が2つ少ないため、$A2までしか提供されません。)$FFまでの残りの文字セットは、BASICキーワードの省略形です。(ちなみに、128でいくつかのスポットを失うのはそのためです。SPECTRUMとPLAYコマンドが表示される場所です。)
ユーザー定義グラフィックスの正確な場所はシステムによって異なりますが、IY+65にはUDGという16ビットポインタがあります。これはBASIC関数USR "A"によって返される値とまったく同じであり、BASIC自体がそれをPOKEするためのバッファとして扱っていたため、マシンコードでも同様に行うことができます。以下は非常に簡単なローダーです。gfxにあるnum_chars分の文字データがあると仮定します。
これらは実際にはBASICでも機能します。グラフィックスモードや反転モードに切り替えることなく、CHR$でグラフィック文字すべてをPRINTできます。
テキストをより魅力的にする
先週の時間の多くは、独自に提供したり、PRINTおよびDRAWコマンドに織り込んだりして、位置、色、点滅テキストのような動作を制御できる7つのコマンドに費やされました。文字表示ルーチンはこれらのほとんどを自動的に処理しますが、プロトコルはBASICとは少し異なります。
基本的な洞察は、特別な制御コードを表示することで、テキスト属性のインライン変更を再現できるということです。文字コード$10から$17は、先週見たテキスト制御コマンドを再現しており、順にINK、PAPER、FLASH、BRIGHT、INVERSE、OVER、AT、TABを表します。(まあ、先週TABについては触れませんでした。それは標準BASICであり、実際にはSpectrumのものではないためですが、これもこの方法で実装されていることがわかりました。)これらのすべては、ATを除いて、後続の1バイトを引数として取ります。ATは2バイト取ります。これらはすべて、色8と9のPAPERおよびINKの特別な透明/高コントラストモード、およびAT引数が行、列の順で(0,0)が左上隅にあることを含め、BASICでの動作とまったく同じように機能します。
BASICで見たものとまったく同じように機能しないのは、PRINTステートメントが終了してもリセットされないことです。改行(このシステムでは単なるキャリッジリターン、$0D)を印刷しても、初期状態は復元されません。システムには「永続的」と「一時的」な文字属性の区別がありますが、それはROM自体の内部とより密接に関連しています。それらを適切に使用するには、Sinclairが当初期待していなかった、より詳しく調べる必要があります。
システムROMとのより密接な連携
テキスト表示と相互作用するシステム変数には6バイトあります。
ATTR-T(IY+85):「一時的」なテキスト属性。RST $10命令で文字を表示すると、この変数内のバイトが対応するカラーメモリセルにコピーされ、色、明るさ、点滅が設定されます。MASK-T(IY+86):「一時的」な属性マスク。実際には、ATTR-Tのバイトは正確にはコピーされません。このバイトで設定されたビットは、コピーの一部として変更されません。これがPAPER 8とINK 8の仕組みです。それらはこの変数の関連部分をマスクし、表示ルーチンはカラーセルのそれらの部分をそのままにします。ATTR-PおよびMASK-P(IY+83およびIY+84):「永続的」なテキスト属性とマスク。これらは、BASICで単独のコマンドとしてINKやPAPERのようなコマンドが使用されたときに更新され、PRINTステートメントの最初のことは、それらを一時スロットにコピーすることです。これが一時的な色の変更を一時的なものにしている理由です。画面クリア命令も、画面を何色でクリアするかを決定するためにATTR-Pを参照します。P-FLAGS(IY+87):非カラーテキスト制御。OVERおよびINVERSEモディファイアはテキスト属性の一部ではなく、特別なINK 9およびPAPER 9モードに必要なロジックは、ATTRまたはMASKのいずれにも直接キャプチャされません。これらの値はここに単一ビットとして格納され、一時値は偶数ビットに、永続値は奇数ビットに格納されます。このインターリーブにより、システムROMはコンパクトなビット操作で永続的な値を一時的な値にコピーできます。BORDERCR(IY+14):境界色。これを書き込んでも、境界色は実際には設定されません。それはI/Oポート$FEの下位3ビットを書き込むことで制御されます。しかし、システムROMは、境界自体をリセットするとき、そしてさらに重要なことに、下部入力ウィンドウのカラー属性を設定するときにこれを参照します。このバイトの値はビット3〜5に格納されます。色値を8倍してからここに格納してください。
ここでも、これらは正式なBIOSインターフェースの一部ではありませんでした。システムROM機能の使用は、注釈付きROM逆アセンブリを手元に持っていることを前提としています。幸いなことに、私たちは持っています。私たちはskoolkidのサイトにあるハイパーリンク版を使用しています。これにより、状況を把握できます。
文字表示コードを通じてアクセスするものは、永続データに触れることは決してありません。しかし、公開されている逆アセンブリがTEMPSと呼ぶ内部ROMルーチンが$0D4Dにあり、すべての永続値を一時スペースにコピーして、属性リセットを実行します。この関数は引数を取りませんが、AとHLを破壊します。それ以外はいつでも呼び出すことができます。
永続属性は主に画面クリア機能CLS($0D6BのROMルーチン)によって使用されます。これらは上部ウィンドウの属性セルを埋めるために使用され、下部ウィンドウはBORDERCRと、基本的にINK 9が行うことを再現するロジックから値を取得します。また、一時的な色を永続的なものにリセットします。残念ながら、BORDERCRをここでチェックしても、実際には境界は設定されません。さらに残念なことに、出力位置を下部ウィンドウにリセットします。
これらすべてを、独自のヘルパー関数に依存し、それに依存することで処理できます。このclrto関数は、Aレジスタに属性バイトを取り、画面全体をその色でクリアします。上部ウィンドウ、下部ウィンドウ、境界もクリアします。また、オンになっている可能性のある非カラーモードをすべてクリアし、出力時に上部ウィンドウに戻します。これはTVFLAGで行うことができますが、システムROMルーチンを直接呼び出している限りは、「正しく」行って上部ウィンドウの出力チャネルを開くのが良いでしょう。$1601のCHAN-OPENルーチンは、文字を送信する出力デバイスを選択し、デバイス2が上部ウィンドウです。完全なclrto関数は次のようになります。
clrto:
push af
push bc
push de
push hl
; Clear screen to specified color
ld bc, $d800 ; Screen RAM start
ld de, $5f7f ; Screen RAM end (22 lines * 32 chars * 2 bytes/char)
ld (iy+85),a ; Set temporary attribute
ld hl, $0000 ; Clear mask (all bits change)
ld (iy+86),l
call $0d6b ; CLS
; Restore permanent attributes and clear non-color modes
call $0d4d ; TEMPS (copy permanent to temporary)
; Set border color
ld a, (iy+14) ; Get border color from BORDERCR
and $38 ; Mask to bits 3-5
or $08 ; Set bits 3-5 for border color
out (c),a ; Output to port FE
; Set output to upper window
ld a, 2 ; Device 2 is upper window
call $1601 ; CHAN-OPEN
pop hl
pop de
pop bc
pop af
ret
Spectrumのテキストシステムには、まだ遭遇していない最後の奇妙な点があります。画面がスクロールするのに十分なテキストを印刷すると、デフォルトでは実際にはスクロールしません。代わりに、出力が一時停止し、ユーザーが画面をスクロールさせたいか、プログラムを終了したいかを確認するのを待ちます。システム変数SCR-CT(IY+82)は、プロンプトが表示される前に印刷する行数を測定します。これを定期的に大きな正の数にリセットすることで、連続スクロールを保証できます。
キー入力の読み取りとI/Oの実行
BASICには、入力読み取りの2つのオプションがありました。キー入力が処理されるのを待っているかどうかを確認するINKEY$関数と、IN関数を使用したキーボードやジョイスティックとの直接の対話です。どちらもマシンコードレベルで並列性があります。
フレームごとに割り込みが発生し、ファームウェアがそれをインターセプトします。その割り込みハンドラはタイマー(IY+64にある3バイトの値FRAMES)を更新し、キーボードポートをスキャンします。キー入力が見つかると、それを文字にデコードし、その文字をIY-50のLAST-Kに配置し、IY+1のFLAGSのビット5を設定します。これは、キーが押されるのを待ってから、その値をAで返す簡単なルーチンです。
getkey:
ld a, (iy+1)
bit 5, a
jr z, getkey ; Wait for key press flag
ld a, (iy-50) ; Get character from LAST-K
ret
ここでHALTをループに入れています。これらのフラグを更新するのは割り込みハンドラだけだからです。スキャンを待つだけでよいので、それらにスピンロックする必要はありません。
アセンブリ言語プログラマとしてINとOUTでI/Oバスに直接アクセスできるため、直接入力はさらに簡単です。ただし、1つの小さな奇妙な点があります。BASICとは異なり、命令セットは16ビットではなく8ビットのI/Oアドレスしか持たないことを示唆しています。これはZilogによる設計上の見落としでしたが、Sinclairが依存する機能になりました。命令IN A,(C)とOUT (C),Aは、アドレスバスにCだけでなく、レジスタBC全体を置きます。Aキーが押されているかどうかを確認するには、次のようなものを記述できます。
ld bc,$fdfe ; BASICのIN 65022
in a,(c)
rra
jr nc,pressedA
Kempstonジョイスティックは8ビットポートアドレスのみを使用するため、そのコードはさらに簡単になります。以下は、デルタXをL、デルタYをH、ファイアボタンをCで返す完全なリーダーです。
joystick:
ld bc,$1f ; Kempston joystick port
in a,(c)
ld c,a ; Store raw input in C
and $01 ; Fire button (bit 0)
ld c,a
rra ; Right (bit 1)
jr nc,no_right
ld l,1
no_right:
rra ; Left (bit 2)
jr nc,no_left
ld l,-1
no_left:
rra ; Down (bit 3)
jr nc,no_down
ld h,-1
no_down:
rra ; Up (bit 4)
jr nc,no_up
ld h,1
no_up:
ret
どのポートがどのキーに対応するか、およびさまざまなジョイスティックレイアウトの詳細については、Martin KorthのZX Docsに多くの便利な表があります。ジョイスティック操作は基本的にBASICと同じなので、先週の私のさまざまな注意点は引き続き適用されますが、少しだけ影響力が弱まります。エミュレータは合成SHIFTキーに関してまだ一貫性がありませんが、移動と射撃を同時に行うときに、誤ってL BREAK INTO PROGRAMエラーが発生する心配はなくなりました。
すべてをまとめる
ここで学んだすべてのことをまとめるために、先週BASICから得たのと同じバナーディスプレイを生成するプログラムに編み込みましょう。
メインプログラムは、直接のキーボードまたはジョイスティックの読み取りを除いて、ここで実行した各ことを順番に呼び出すだけです。
org $7000
ld a,$20 ; 黒地に緑でクリア
call clrto
ld hl,gfx ; 4つのカスタム文字を$90-$93にロード
ld e,(iy+65) ; UDG
ld d,(iy+66)
ld bc,32
ldir
ld hl,msg ; ディスプレイを表示
call print
call getkey ; キー入力を待つ
ld a,$38 ; 白地に黒に戻してクリア
jp clrto ; 完了したら終了
clrtoとgetkey関数は、上記でリストしたとおりです。しかし、私たちのprint関数は、Hello Worldプログラムから少し変更する必要があります。そこでは0バイトを文字列終端子として使用していましたが、それはもはや妥当なことではありません。ディスプレイのさまざまな場所でPAPERとBRIGHTをゼロに設定しており、実際のCHR$ 0文字を表示することでこれを行う必要があります。解決策は難しくありません。Aをゼロと比較するOR A命令を、255と比較するCP $FF関数に置き換えるだけです。これは、表示する予定のないBASICキーワードCOPYに対応する、より安全なコードです。
次に、表示するメッセージと傘のグラフィック定義というデータ自体があります。メッセージデータは上記のテキスト制御コードを多用しており、その結果、ほとんど読めません。グラフィックデータは、BASICオリジナルのDATAステートメントとまったく同じですが、TI BASICオリジナルにあったように、今回は16進数で表されています。
msg:
db $01,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00
db $02,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00
db $03,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00
db $04,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00
db $00
gfx:
db $00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00
db $00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00
db $00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00
db $00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00,$00
これは、オリジナルのBASICプログラムよりも大幅に小さいプログラムであることがわかりました。BASICスタブと追加のテープヘッダーを考慮しても、このプログラムはサイズの半分強です。
ベニーは最後の笑いを得るか?
今日カバーした資料は、先週の例として使用した「Manic Mechanic」タイプインゲームの純粋なマシン語バージョンを想像するのに十分です。メインゲームディスプレイを再現し、入力とアニメーションを管理する方法を見てきました。まだサウンドが欠けており、タイトル画面を一致させることはできません。
DRAWコマンドが作成するもののような線画は、マシン語では不便ですが、BASICではまったく一致できないトリックをまだいくつか持っています。乞うご期待。