TOOLKIT EXAMPLE / FIFO RECORDING

FIFO Recording + Loss Check

INSOLE を1台または2台(左右同時)接続し、FIFO(端末内バッファ)で収録して、serialの連続性から欠損があったかどうかをデバイスごとに確認しCSVを保存します。

2台つなぐと同時収録します。片側だけ欠損が出ることがあるため、1台での結果と見比べてください。

WAITING
INSOLE を接続してください タイトル横のスイッチから1台接続します。
FIFO収録を使いたいときは、Toolkit UI の歯車を開き、次のように設定してください。

Data Outputs: Raw Sensor Data をON / Step Analysis はOFF Raw Data Acquisition: FIFO Realtime Streaming Format: FIFOでは使いません(quatは含まれません) このデモプログラムでは収録開始時に fifo-recording プロファイルへ自動で切り替え、停止後に Realtime へ戻します

DEVICE BUFFER ≈ 30 s 経過時間 0.0 s
0s 30s(推奨の上限) 60s+

この帯は「収まりやすさ」の目安です。30秒以内でも回収が滞れば欠損し、30秒を超えても追いつけていれば欠損しません。

SERIAL CONTINUITY INSOLE 01
received missing
missing 0 / expected 0

収録するとここに serial の連続性を表示します

欠損range なし
FIFO BATCH 届いているデータ・直近
INSOLE 01 INSOLE 02
最新sample
—

AFTER STOP AND DRAIN

収録結果と欠損

drain(未回収データの回収)が完了した時点の正式計測区間について集計します。CSVに保存されるのはこの区間だけです。

未計測

まだ収録していません。上の操作パネルから収録を開始してください。

項目 INSOLE 01 意味
最終更新 —

「30秒以内なら絶対に無欠損」ではありません。 端末内バッファは約30秒分ですが、回収が生成に追いつかなければ30秒以内でも古いデータが上書きされ、回復不能な欠損になります。

CSVは正式計測区間(開始〜drain完了)のsampleだけを含みます。

WHY FIFO

RealtimeとFIFOの違い

Realtime(垂れ流し / push)

  • INSOLEが計測したデータをそのまま次々に送ります

FIFO(いったん貯める / pull)

  • 計測データをINSOLE本体にいったん保存します

端末内バッファ 約30秒の根拠

推測値ではなく、SDK実装の定数からの換算です。

ORPHE-CORE-INSOLE.js src/fifo/protocol.ts
  FIFO_RING_BUFFER_CAPACITY = 1500   // max lag treated as recoverable (packets)
  NOTIFY_DATA_NUM      = 4      // frames per serial packet
  decodePacket()                // frame interval is 5 ms

  1 serial packet = 4 frame × 5 ms       =     20 ms
  buffer window   = 1500 packet × 20 ms  = 30,000 ms  ≈ 30 s
  (equivalent: 200 sample/s ÷ 4 = 50 packet/s → 1500 ÷ 50 = 30 s)

30秒以内の短時間計測は計測区間の全体をバッファに保持しやすく、安定した記録に向いています。

HOW IT WORKS

このexampleが使う Toolkit の設定プログラム

buildInsoleToolkit(toolkit, "INSOLE 01", 0, {
  profile: "realtime-full",
  fifo: {
    startupDelayMs: 1000,
    drainTimeoutMs: 5000,
    onSamples(deviceId, samples) { updateLiveCharts(samples); },
    onProgress(info) { updateLag(info.lag); },
    onDataLoss(info) { logLoss(info); }
  }
});
const session = getInsoleToolkitSession(0);

// Start FIFO recording. The SDK handles the read-mode switch,
// buffer clearing, polling and re-requests.
await session.startMeasurement({ profile: "fifo-recording", restoreProfile: true });

// Resolves only after drain (recovering outstanding serials) completes.
const result = await session.stopMeasurement();
result.raw.serial;   // { first, last, expected, received, missing, missingRate }
result.fifo.dropped; // unrecoverable-loss tally (a different metric from missing)

// CSV for the formal measurement window only.
// With two devices, combine both results into one file keyed by device_id.
const csv = insoleToolkitMeasurementToCSV(result, "raw");

FIFOのプロトコルは orphe-core-insole.js と orphe-core-insole-toolkit.js が担当します。

EVENT LOG

イベントログ

収録の経過・欠損・CSV照合の結果を記録します。環境情報つきでコピーできます。