体系ガイド · 発展

Rustの仮想タイマー:期限から割り込みへ

EL1が設定した仮想タイマーの実際の期限到達をEL2で受け、仮想IRQとして配送する経路と時間の単位を学びます。

この記事をロゲイアに質問する確認問題3問に進むこれまでの誤答を復習する

更新日

この記事の目次
  1. 到達目標:期限の計算と通知をつなぐ
  2. カウンターと比較値を同じ単位で扱う
  3. 期限を記録してからタイマーを有効にする
  4. 実測トレース:比較値を越えてから配送する
  5. 期限到達と即時の処理開始を同一視しない
  6. 実行できるRust:期限の算術と境界
  7. maskが止める段階を特定する
  8. 演習:時間値より因果関係を検査する
  9. この記事をロゲイアに質問する理解を確かめる

到達目標:期限の計算と通知をつなぐ

タイマーは「一定時間待った」という表示だけでは実装を確かめられません。第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_ARMnow=0x31a23 / delta=0x98968now + delta = 0xca38b
TIMER_EXPIREDcounter=0xd328b / CVAL=0xca38bcounter ≥ 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の関係を確認してください。計算が正しいことと通知が実際に発生したことに、それぞれ別の証拠を使う構成です。

rust
#[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前に拒否される理由を読みます。提出物には計算、順序、配送数、実行条件、参照したソースを含めてください。発展課題では別の正の差分を使う設計を考え、単位とオーバーフローをどう検査するか説明します。待ち時間の表示だけでは得られない検証を、自分の言葉で整理してください。

QEMU実行記録:タイマー通知とゲスト復帰

実験の途中状態を読み込み中…

読了と問題の結果を、言語ごとにこのブラウザへ保存します。

学習コースから次を選ぶ