到達目標:期限の計算と通知をつなぐ
タイマーは「一定時間待った」という表示だけでは実装を確かめられません。第4弾ではEL1ゲストが仮想タイマーの比較値を設定し、実際の期限到達で発生するPPI27をEL2が処理し、ゲスト向けの仮想割り込みへつなぎます。この章ではarm_virtual_timerとhandle_host_irqを読み、TIMER_ARM、TIMER_EXPIRED、INJECTの順を実測で確認します。単なるカウンターの手動更新ではありません。
時間には、カウンター値、周波数、差分、比較値という異なる量があります。すべてが数値でも同じ単位ではありません。配布のログではそれぞれのレジスター名やDELTAが付いているため、何を読んだ値かを保って計算します。目標は、期限をどう作ったか、期限を過ぎたことをどこで確認したか、どの処理がゲストへ知らせたかを、一つの因果関係として説明することです。
カウンターと比較値を同じ単位で扱う
ゲストはCNTVCT_EL0から現在の仮想カウンターを、CNTFRQ_EL0から一秒あたりの刻み数を読みます。通常の差分はfreq / 100であり、その環境では約10ミリ秒に相当します。収録された周波数は62500000で、差分は625000です。差分をそのままマイクロ秒と読んだり、カウンター値を起動からのミリ秒と読んだりしないようにします。
仮想カウンターにはEL2のオフセットが関係しますが、この実験ではCNTVOFF_EL2を0に固定します。複数のゲストへ別々の時刻を見せる機能や、停止中の時間補正を実装したという意味ではありません。まず同じ時刻軸上のnowとdeadlineを比べる条件を固定します。異なるカウンターを混ぜて比較すると、数式が正しく見えても実際の期限判定と対応しなくなるため、レジスター名まで記録してください。
期限を記録してからタイマーを有効にする
arm_virtual_timerはnowを読み、timer_deadlineで差分を加算し、CNTV_CVAL_EL0へ期限を書きます。その後、HVCを使ってnow、期限、差分、周波数を記録してから、CNTV_CTL_EL0へ1を書いて有効化します。この順番は一tickの境界で重要です。タイマーを有効にした後にログを書こうとすると、期限到達の方が先に観測され、設定の記録と出来事の順序が分かりにくくなります。
timer_deadlineは差分0と加算のオーバーフローを拒否します。正の差分なら何でも無条件に加算する設計では、極端な値で小さな期限へ折り返してしまう可能性があります。checked_addを使う純粋な計算と、システムレジスターへの書き込みを分けることで、失敗を機械状態の変更前に検査できます。一tickは合法な境界、0はこの教材の契約では拒否という違いを明確にしてください。
実測トレース:比較値を越えてから配送する
timerNormalの収録では、TIMER_ARMのnowが0x31a23、比較値が0xca38b、差分が0x98968です。足し算は比較値と一致します。TIMER_EXPIREDではカウンター0xd328bが比較値以上で、CNTV_CTL_EL0は5、物理IARは27です。実行ごとにカウンターの具体値は変わるため、同じ16進数が再び出ることを合格条件にしません。期限との大小関係とイベントの順序を検査します。
handle_host_irqはタイマーを無効化し、物理側のEOIとDIRを行ってから、仮想番号27をLRへ用意します。その後にゲストのACK、EOI、DIRが続きます。物理側と仮想側に同じ27が現れても、同じ一回のレジスター操作を二度表示しているわけではありません。EL2が扱う物理の通知と、EL1へ届ける仮想の通知という二つの境界を、ログと関数の対応で区別します。
| 実測点 | timerNormalの例 | 検査する関係 |
|---|---|---|
| TIMER_ARM | now=0x31a23 / delta=0x98968 | now + delta = 0xca38b |
| TIMER_EXPIRED | counter=0xd328b / CVAL=0xca38b | counter ≥ CVAL |
| 物理側 | IAR=27 / CTL=5 | 期限到達をEL2が処理 |
| 仮想側 | INJECT 27 → GUEST_ACK 27 | 物理通知の後に配送 |
期限到達と即時の処理開始を同一視しない
比較条件が成立した瞬間と、UARTにTIMER_EXPIREDが出る瞬間には処理の差があります。例外配送、ベクター、Rustの処理、出力に時間がかかります。そのため実測カウンターが期限より大きいことは通常あり得ます。期限を少し過ぎた値を、タイマーが誤った時刻へ設定された証拠と即断しないでください。一方、期限より前の通知なら、単位や比較対象を含めて調べる必要があります。
QEMUのTCGによる実行記録は、ハードウェア上の厳密な割り込み遅延を保証するものではありません。ログを増やす変更もタイミングを変えます。正常系では期限以降の通知と一回の配送を検査し、境界では一tickの短い差分、失敗系では差分0とオーバーフローを検査します。時間値の完全一致よりも、設定、期限到達、配送、復帰という順序と回数を重視します。
実行できるRust:期限の算術と境界
次のホスト用Rustは、期限を作る算術と大小比較だけを検査します。周波数62500000とnow=100は入力例であり、実機から読んだ値だとは主張しません。標準的なrustcで単一ファイルとして実行でき、AArch64やQEMUを必要としません。実際のタイマーの発火や割り込み配送を、このコードが行ったように説明しないでください。
期限の一tick前、ちょうど期限、期限の後を別々のassertで調べます。加算の最大値付近では、最大値への合法な到達と、最大値を越える失敗を区別します。この純粋関数の境界検査を配布lib.rsのテストと比べた後、QEMU記録のcounterとCVALの関係を確認してください。計算が正しいことと通知が実際に発生したことに、それぞれ別の証拠を使う構成です。
#[derive(Debug, PartialEq)]
enum Reject { ZeroInterval, Overflow }
fn deadline(now: u64, delta: u64) -> Result<u64, Reject> {
if delta == 0 { return Err(Reject::ZeroInterval); }
now.checked_add(delta).ok_or(Reject::Overflow)
}
fn expired(counter: u64, compare: u64) -> bool { counter >= compare }
fn main() {
let now = 100_u64;
let freq = 62_500_000_u64;
let end = deadline(now, freq / 100).unwrap();
assert_eq!(end, 625100);
assert!(!expired(end - 1, end));
assert!(expired(end, end));
assert!(expired(end + 10, end));
assert_eq!(deadline(100, 0), Err(Reject::ZeroInterval));
assert_eq!(deadline(u64::MAX, 1), Err(Reject::Overflow));
assert_eq!(deadline(u64::MAX - 1, 1), Ok(u64::MAX));
println!("delta={} deadline={} boundary=ok", freq / 100, end);
}maskが止める段階を特定する
timerMaskedではゲストのDAIFがIRQをmaskしていますが、仮想タイマーそのものを停止した実験ではありません。期限到達のPPI27はEL2で処理され、仮想LRへ27がPendingとして用意されます。MASKED_PENDINGの時点では配送数が0で、unmask後にゲストACKが現れます。この違いを説明しないと、mask中は時間が進まない、あるいは期限イベント自体が起きないという誤解につながります。
CNTV_CTL_EL0のタイマー有効化やmaskの条件と、ゲストCPUのDAIFのIRQ受付は別の層です。どちらにもmaskという語が出る場合、レジスター名と止まる段階をセットで書きます。この教材ではEL2へ物理通知をルーティングし、その後の仮想配送をゲスト受付で待たせるため、mask中でもTIMER_EXPIREDとINJECTが観測されます。保留された要求が失われずに後で処理されるかを、次の再開の章で詳しく追います。
演習:時間値より因果関係を検査する
演習ではtimerNormalのTIMER_ARMから周波数、now、差分、CVALを抜き出し、加算を確認します。次にTIMER_EXPIREDでcounterがCVAL以上であること、物理IARが27であること、仮想ACKがその後に現れることを記録してください。収録を再生する場合も、新しく実行する場合も、具体的なcounterの一致を求めない検査条件を先に文章にします。
境界のtimerBoundaryでは差分1と、設定ログが期限到達ログより先であることを確かめます。失敗のtimerFailureではTIMER_ARM前に拒否される理由を読みます。提出物には計算、順序、配送数、実行条件、参照したソースを含めてください。発展課題では別の正の差分を使う設計を考え、単位とオーバーフローをどう検査するか説明します。待ち時間の表示だけでは得られない検証を、自分の言葉で整理してください。