# G0 — Baseline đo latency (kết quả)

Ngày: 2026-08-27. Probe: `native_bridge/debug/g0_latency_probe.py` (chạy với
`timeBeginPeriod(1)`, 10k block/config, pipeline thật Python→SHM→fx_vst_bridge→SHM).
Log: `native_bridge/debug/g0_probe_run_full.log`.

## 1. Bảng latency plugin (getLatencySamples, @48kHz)

| Plugin | getLatencySamples | ms @48k | Ghi chú |
|---|---|---|---|
| Sonible pureComp | 2108 | 43.9 | báo latency thật (lookahead) |
| iZotope Ozone 11 | 0 | 0 | không báo latency (realtime mode) |
| empty (passthrough) | — | — | chain rỗng |

Nguồn: probe `plugin_latency` + log app thật `fxrt_bridge.log`
(`[RenderFx] STEP getLatencySamples = 2108/0`).

## 2. Jitter round-trip (10k block, 53.3s/config)

Round-trip = thời gian từ lúc probe gọi `write_input(block j)` đến lúc nhận
`read_output()` block j (FIFO theo index). Đã sửa pacing probe bằng
`timeBeginPeriod(1)` (bridge C++ đã gọi — `RealtimeFxLoop.cpp:160`); lần chạy
trước thiếu nó → Sleep 15.6ms granularity → pump ~22ms/batch ≠ 21.33ms realtime
→ pureComp bị "stall 1.9s" giả. Với pacing chuẩn, stall đó biến mất — là
artifact probe, KHÔNG phải VST stall.

| Config | mean ms | σ | p50 | p99 | max | recv/sent |
|---|---|---|---|---|---|---|
| empty | 21.54 | 1.74 | 21.64 | 22.03 | 25.73 | 9996/10000 |
| pureComp | 21.69 | 0.26 | 21.66 | 22.02 | 28.94 | 9996/10000 |
| Ozone 11 | 21.68 | 0.15 | 21.65 | 22.02 | 23.20 | 9996/10000 |

- Round-trip ≈ 21.5–21.7ms = đúng 1 batch 4 block (21.33ms) + overhead nhỏ
  (SHM copy + bridge proc 0.001–0.45ms). Latency plugin KHÔNG nằm trong
  round-trip — plugin latency bù bằng PDC (không chặn pipeline).
- σ round-trip: 0.15–0.26ms (pureComp/Ozone) — RẤT nhỏ → **Gate G2 MỞ**: PDC
  mẫu có ý nghĩa, không cần giảm jitter trước (không cần relay WS→SHM sớm).
- empty σ=1.74: 1 outlier khởi động (min=0.04ms), p50/p99 vẫn 21.6/22.0.
- recv=9996 < 10000: 4 block cuối chưa drain hết lúc probe kết thúc (bridge
  chậm hơn pace probe — xem §4), không phải mất block.

## 3. Inter-arrival deviation

| Config | σ ms | min | max |
|---|---|---|---|
| empty | 9.44 | −5.33 | 38.4 |
| pureComp | 9.36 | −5.33 | 23.5 |
| Ozone 11 | 9.36 | −5.33 | 17.8 |

Block về theo batch 4 (bridge xử lí take=4/lần) → inter-arrival lệch so với
5.33ms lý tưởng là đặc tính batching, không phải jitter ngẫu nhiên. Round-trip
σ (§2) là thước đo đúng cho PDC; inter-arrival dùng cho sizing FILL — xem §5.

## 4. Bridge FxRTPerf

| Nguồn | procAvg | procMax | loopAvg | loopMax | rate blk/s | vs realtime 187.5 |
|---|---|---|---|---|---|---|
| probe empty | 0.001ms | 0.05ms | 22.0ms | 1010ms | 181.7 | −3.1% |
| probe pureComp | 0.45ms | 0.80ms | 22.0ms | 1012ms | 181.6 | −3.1% |
| probe Ozone | 0.14ms | 0.35ms | 22.0ms | 1008ms | 181.7 | −3.1% |
| app thật (master chain đầy) | 3.4ms | 10.0ms | 21.4ms | 156ms | 186.5 | −0.5% |

- **loopMax ≈ 1s ở MỌI config probe kể cả empty** — spike 1s/lần chạy ~53s,
  không phải VST (empty cũng có). Không xuất hiện trong log app thật gần nhất
  (loopMax 156ms) — nghi Windows scheduler/antivirus/power, cần theo dõi khi
  chạy thật. Probe round-trip max vẫn ≤29ms → spike xảy ra lúc bridge idle,
  không chặn block đang xử lí.
- **Drift: bridge chậm 0.5–3.1% so realtime** (rate < 187.5). App thật −0.5%
  (186.5): mỗi giây thiếu ~1 block → FILL 8 block (42.7ms) cạn sau ~8s nếu
  không có cơ chế bù. Probe −3.1% là đo có pace probe riêng (nhịp probe + nhịp
  bridge lệch nhau); con số tin cậy cho drift thật là từ app: −0.5%.

## 5. ~0.22s gồm gì (xác nhận)

Latency path thực đo + hằng số app:

| Thành phần | ms | Nguồn |
|---|---|---|
| Batching 4 block (pipeline) | ~21.6 | probe round-trip (§2) |
| FILL buffer worklet 8 block | 42.7 | `sf-fx-realtime.js` FILL=8 |
| Plugin latency (pureComp) | 43.9 | `getLatencySamples=2108` @48k |
| WS/main-thread jitter (warm, p50) | ~101 | dbg.log `fx_play_first` sincePlay 38–160ms |
| **Tổng nghe thấy (warm)** | **~210ms ≈ 0.21s** | khớp ~0.22s quan sát |

- PDC hiện tại `FX_RT_ROUNDTRIP_SAMPLES=3840` (80ms) = batching ~7 block +
  FILL 8 block — khớp thực đo (21.6 + 42.7 ≈ 64ms + WS jitter margin). Giữ
  nguyên; `latencyTotal` (plugin thật qua `{cmd:'latency'}`) cộng thêm đúng
  (pureComp +43.9ms).
- Cold start VST load: 8–17s (dbg.log sincePlay 8111–17211ms), warm sau đó
  38–160ms — là plugin init, không phải latency pipeline; không nằm trong PDC.
- fx_stats app thật (session master): u=3 h=3 f=13 s=13 cap=1 fi=13 q=5–11 —
  underrun hiếm, queue duy trì 5–11 block → FILL đủ hấp thụ jitter thường.

## 6. Kết luận cho G2+

1. **Gate G2: MỞ.** σ round-trip 0.15–0.26ms → PDC mẫu có nghĩa; không cần
   relay WS→SHM trước G2.
2. **Drift bridge −0.5% là phát hiện mới** (không có trong plan §1–§8): FILL
   cạn dần trên session dài → cần quyết định: (a) chấp nhận (underrun hiếm, có
   resume), (b) bù/resync định kỳ, (c) thêm giám sát rate. **Báo user để review
   trước khi đưa vào plan.**
3. **loopMax ~1s spike** (probe, cả empty): theo dõi, chưa thấy ở app thật.
4. Plugin latency bảng §1 đủ cho G2: `graph.getLatencySamples()` sẽ thay hằng
   số; dữ liệu hiện tại xác nhận pureComp là plugin duy nhất có latency thật.