メモリに見える場所へ機器の操作を割り当てる
MMIOでは、アドレス空間の一部をデバイスのレジスタとして扱います。RAMへ値を保存する操作と同じように見えても、そこへの読み書きが文字の送信や状態の取得を意味する場合があります。この教材はPL011の考え方を参考にした小さな仮想UARTを扱います。データレジスタへの文字出力に範囲を限定し、実際のPL011全レジスタ、FIFO、割り込み、細かなタイミングを再現するものではありません。どこまで実装したかを先に確認すると、期待外の出力が仕様の不足か不具合かを切り分けられます。
RAMとデバイスを区別する試験として、同じ書き込み値を二つの領域へ送った場合を考えます。RAM側ではメモリの内容が変わり、仮想UART側では出力列が増える、という異なる効果を観測します。単に代入文が動いたから機器を実装したとは言えません。レジスタの意味、対応する副作用、未対応の場合の応答を一組で作ることがデバイスモデルの出発点です。
デバイスの位置はゲストの配置の一部にする
ゲストへUARTの存在を伝えるには、どの範囲がそのデバイスで、どのインターフェースを持つかを決めます。Device Treeは機器情報を伝える方法の一つです。実際のQEMU環境では、選んだ機種や構成が提供する情報を読みます。UARTは常にどの機械でも同じアドレスにある、と決め打ちするのは避けます。教材中の例ではUARTのIPA基点を0x09000000と明示し、データレジスタのオフセットを0に固定します。これはこの例の配置であり、任意のArm実機で使える物理アドレス表ではありません。
基点からの差を取ると、0x09000000へのアクセスはオフセット0、0x09000004ならオフセット4です。第一弾は前者だけを実装するので、後者では出力を増やしません。Device Treeがあるとしても、広告した機能と実装したレジスタが食い違えばゲストは正常に動けません。教材の範囲を小さくすることと、未実装の機能まで存在すると伝えることは区別します。
第2段階のトラップから仮想デバイスへ渡す
ゲストの命令がUART領域へ到達したとき、直接RAMへ対応させずEL2で受ける構成を考えます。管理側はまずそのIPAが登録したUARTの範囲かを調べます。次に、今回の命令が読み取りか書き込みか、何バイトのアクセスか、どのレジスタの値を扱うかを確かめます。AArch64の例外情報だけで必要なデータが得られる場合もありますが、関連フィールドが有効でない命令もあります。第一弾の実装は対応できる形を限定し、分からない操作を推測で模倣せず拒否します。
デモでは操作の復号結果を既知の入力から作り、実CPUのESR_EL2を読んでいるわけではありません。実装版ではISVなどの条件を確認し、値を取り出す項目が有効な場合にだけ使います。必要なら命令の復号を追加しますが、その実装もない状態で不足情報を補ってはいけません。画面にレジスタ名が出ることと、その値を実機から取得したことは別です。
レジスタの幅と転送する文字は別に扱う
ゲストの汎用レジスタが64ビット幅でも、デバイスの操作が64ビットの文字送信とは限りません。デバイスの契約で許されるアクセス幅と、有効なデータのビットを確認します。教材の文字出力では、対応したデータレジスタへの書き込み値0x41の低位8ビットを文字Aとして扱います。これはUnicodeの任意の文字列を一度で送るAPIではありません。また実デバイスで8ビット、32ビット、64ビットのアクセスがどう許されるかは仕様に従います。模型で対応した幅だけから、他の幅も動くと広げないようにします。
第一弾の操作条件は、データレジスタへの32ビット書き込みです。同じ値を64ビットで書く条件へ変えると、模型は未対応として止めます。これは64ビット書き込みを実PL011が必ずどう扱うかを測定した結果ではありません。教材の受理条件を固定した負の試験です。成功条件と拒否条件で出力件数を比較すれば、幅の検査が実際に処理へ反映されていることを確認できます。
def teaching_uart_write(address, width, value):
if address != 0x09000000 or width != 32:
raise ValueError('unsupported register or width')
return chr(value & 0xff)
assert teaching_uart_write(0x09000000, 32, 0x41) == 'A'
for address, width in [(0x09000004, 32), (0x09000000, 64)]:
try:
teaching_uart_write(address, width, 0x41)
except ValueError:
pass
else:
raise AssertionError('unsupported access was accepted')
print('A; two unsupported accesses rejected')
処理済みの操作を二度実行しない
仮想UARTが文字Aを出力したら、そのゲスト操作を完了したと記録します。該当する命令と例外の契約に従って、復帰時には次へ進める必要があります。同じ命令へ戻って再び代行するとAAと出力される恐れがあります。一方、RAMの変換を修復しただけなら、まだ元の書き込みを実行していないので再試行する方針になります。この違いは前の教材で学んだ復帰位置の責任です。デモでは出力バッファの増加と命令位置の変更を同じ手順にまとめ、二重の副作用がないかを確かめます。
正常例の状態表では、最初のPCを0x4000とし、一文字の処理後に0x4004へ進めます。これは選んだA64命令についての説明です。未対応の幅やレジスタでは、出力件数を0のまま保ち、処理済みとして0x4004へ進める結果にはしません。拒否の後にどうゲストへ障害を伝えるかは発展項目ですが、少なくとも正常終了を偽って表示しないことを守ります。
実機の測定と模型のイベントを区別する
このデモで一段階進めた時間は、UARTの実際の通信速度ではありません。表示しているのは、ゲスト操作、トラップ、検査、仮想デバイスの更新、再開という論理的な順序です。実装を発展させるときは、送信FIFOが満杯ならどうするか、入力が来たときにどう通知するか、割り込みの有効・無効をどう扱うかを追加します。最初から全てを一つの出力アニメーションへ混ぜると、どこが実装されているか見えなくなります。単純な出力を完成させてから、状態と通知の契約を別々に増やしていきます。
実環境へ進むときは、同じ短い文字列をゲスト側と管理側の両方で記録し、どの経路から出たものかを確かめます。管理側が直接出したログが見えただけでは、ゲストのMMIO経路が動いた証拠にはなりません。出力の印、操作したアドレス、ハンドラに入った回数を対応させると、ゲストからの一操作が仮想デバイスで処理されたという確認ができます。
課題:一文字を出すのに必要な検査を並べる
ゲストがIPA 0x09000000へ値0x42を書き込む例を考えます。解答の流れは、登録したUART範囲を確認し、データレジスタのオフセットと対応する幅・方向を検査し、有効な操作情報から値を得て、文字Bを一度出し、処理済みとして再開する、です。次にIPAを0x08000000へ変えた場合もBを出してよいか考えてください。登録外という前提なら、その操作をUARTとして受理しません。さらに例外情報が不足する命令へ変えた場合は、現在の模型が対応していないことを示します。黙って同じ文字を出すのは正しい互換性ではありません。
解答の自己点検では、Bという結果だけでなく、出力前に何を確かめたか、拒否ケースでは何が変わらなかったかを説明します。正常一件、幅が違う一件、レジスタが違う一件を同じ条件で並べると、想定外の操作が成功する欠陥を見つけやすくなります。この三件が揃ったら、入力・FIFO・割り込みを加える際にも、既存の文字出力の契約を維持できるかを確認します。