2026年7月、V1.75〜V1.93 の集中デバッグの全記録です。

収録ファイル

• 詳細版（全9章＋付録） — 実測データ・コード差分・仮説と棄却の経緯まで残した技術ドキュメント。別記事「OpenCCVoice for DVSwitch — デバッグ・ジャーニー」を参照。
• 連輈5本（読み物版） — 既存の「ハマりどころ」シリーズと同じトーンの連載記事。各記事は以下を参照：
  • TGIF の無音ゲートを見つけた話 ─ MD-619 が固まる本当の理由
  • パケットキャプチャで電波の中身を見る ─ DMR フレームの読み方
  • AMBE ボコーダとホワイトノイズの相性問題 ─ 100Hz トーンにたどり着くまで
  • 無人ボットの並行制御と Race Condition ─ /dev/shm ディレクトリ消失事件
  • Talker Alias 表示引きずりの謎 ─ 送信は正しいのに表示が違う
• 版数履歴・定数一覧 — V1.75〜V1.93 の版数表と最終定数一覧（索引用）。デバッグ・ジャーニー記事内に記載。

主要な発見のインデックス

関連ツール（別途納品済み）DL

• dmrd_analyze.py v1.3 — pcap → DMRD ストリーム分析器
• emblc.py — 埋め込み LC / Talker Alias デコーダ（MMDVMHost 移植）
• dvswitch_bot193.py — 最終の bot 本体

執筆スタンス

• 棄却された仮説も、棄却プロセスごと残す（後から同じ症状に遭遇した人の役に立つため）
• 実測データ（フレーム数、振幅、時間）は数字で残す
• 「原因不明のまま保険で守る」判断もあえて明記する（実運用の現実として）
• AI 協働開発の実際（AI が生成したバグと、それが実測で修正されるサイクル）も第9章と終章に記す

dvswitch_bot.py 版数表（V1.75〜V1.93）

デバッグ・ジャーニー期間中の全版数の主題・変更点・結果を一覧化したものです。

主要な発見と対応版数の対応

最終確定した主要定数（V1.93 時点）

# ─── タイミング ─────────────────────────────
REPLY_TX_LEAD_DELAY_SEC = 1.0        # 命中時 SFR 折り返し保護（wall-clock 待ち）
PRE_AUDIO_SILENCE_SEC = 1.5           # 焼き込み助走（受信機の途中参加同期用）
PACKET_INTERVAL = 0.02                # USRP パケット間隔 20ms
PRE_POST_PADDING_PACKETS = 75         # 前後パディング 1.5秒
SUPPRESS_DURATION_SEC = 15.0          # 応答後の抑制期間
QSO_SESSION_GAP_SEC = 15.0            # QSO セッション判定
QSO_ID_INTERVAL_SEC = 600.0           # 法令準拠 10 分 ID

# ─── TGIF ゲート対策 ─────────────────────────
NOISE_FILL_ENABLED = True             # 100Hz 微小トーンでの先頭リード
NOISE_FILL_AMP = 100                  # トーン振幅（-50dBFS）
NOISE_LEAD_PACKETS = 65               # リード継続時間（1.3s）
GATE_BURST_PACKETS = 0                # バーストは無効（実測で効果なし）

# ─── USRP プロトコル ───────────────────────
UDP_IP = "127.0.0.1"
UDP_PORT = 51000
TX_METADATA_ENABLED = True            # 送信前 SET_INFO（pyUC 互換）
USRP_EOT_REPEAT = 1                   # 終端 keyup=0 の送出回数

# ─── キャッシュ ─────────────────────────────
REPLY_CACHE_ENABLED = True
PREWARM_ON_HEADER = True
CACHE_SCHEMA = "v1"
CACHE_DIR = f"/dev/shm/ocv_reply_cache_{PID}"

# ─── 受信判定 ─────────────────────────────
RX_DURATION_MIN_SEC = 0.5             # カーチャンク下限
RX_DURATION_MAX_SEC = 3.9             # 通常経路でのカーチャンク上限
WATCHDOG_RX_MAX_SEC = 5.0             # watchdog 経路でのカーチャンク上限（SFR EOT 欠落対策）