==================================================================
  FreeDV → Turbo HAMLOG UDP Bridge
  Version 1.5
  対応: FreeDV 2.2.x / 2.3.x    Turbo HAMLOG Ver5.27c以上
==================================================================

【概要】
  FreeDV が送出する WSJT-X 互換の UDP ログパケットを受信し、起動中
  の Turbo HAMLOG の入力ウィンドウへ QSO データを自動転送するツール
  です。

-----------------------------------------------------------------
【必要環境】
-----------------------------------------------------------------
  OS       : Windows 10 / 11 (64bit)
  FreeDV   : 2.2.0 以上
  HAMLOG   : Turbo HAMLOG/Win Ver 5.27c 以上

-----------------------------------------------------------------
【インストール】
-----------------------------------------------------------------
  1. freedv_hamlog.exeファイルを任意の場所においてくださ
     い。 例）OS(C:)\FreeDV_HAMLOG\freedv_hamlog.exe

  2. ファイルをダブルクリックするとプログラムが起動します。

  3. ショートカットアイコンは、exeファイルを右クリックして「そ
     の他のオプションを確認」→「ショートカットの作成(S)」で作
     成できます。
  
  4．プログラムの削除は該当ファイルの削除のみです。
  
-----------------------------------------------------------------
【設定】
----------------------------------------------------------------- 
  FreeDVの設定が必要となります。
  「Tools」→「Options...」→「Reportinng」→ Enable UDP Broadcast
  にチェックを入れます。

-----------------------------------------------------------------
【使い方】
-----------------------------------------------------------------
  1. Turbo HAMLOG を起動する。
     必ず先にHAMLOGを起動してください。

  2. 本プログラムを起動する。

  3. FreeDVを起動する。
     本プログラムの前にFreeDVを起動してもかまいません。

  4. FreeDV の「Log QSO」をクリックすると Confirm FreeDV Reporter 
     画面がポップアップします。FreeDV Reporter 画面で交信相手局を
     ダブルクリックすると Confirm Log Entry 画面に DX Call と DX
     Locater 、Frequency が自動入力されます。TX/RX Report その他は
     手動で入力します。「OK」をクリックします。
     以下のデータが HAMLOG に自動入力されます。

       ┌─────────────────────┬─── ┐
       │ FreeDV フィールド     │ HAMLOG 入力欄            │
       ├─────────────────────┼── ─┤
       │ DX Callsign           │ コールサイン             │
       │ Time On (UTC→JST変換)│ 日付 / 開始時刻          │
       │ Frequency (Hz)        │ 周波数 (MHz)             │
       │ Mode                  │ モード（FREEDVに変換）   │
       │ RST Received          │ His（RST受信）           │
       │ RST Sent              │ My（RST送信）            │
       │ Grid Locator          │ G・L（グリッドロケーター）│
       │ Name                  │ His Name                 │
       │ Comments / SNR        │ Remarks1                 │
       └─────────────────────┴─ ──┘

       内容を確認後、HAMLOG の Save ボタンで保存してください。

  5. 本プログラムの停止は Ctrl+C を押してください。

-----------------------------------------------------------------
【時刻について】
-----------------------------------------------------------------
  FreeDV の UDP パケットに含まれる時刻は UTC です。
  本ツールは自動的に JST（+9時間）に変換してから HAMLOG へ転送し
  ます。
  日付変更をまたぐ場合（例: UTC 15:30 → JST 翌日 00:30）も正しく
  処理されます。

-----------------------------------------------------------------
【モードについて】
-----------------------------------------------------------------
  FreeDV が送出するモード名 "DIGITALVOICE" は、自動的に "FREEDV"
  に変換されて転送されます。
  Turbo HAMLOGのMODE欄はデフォルト設定で4文字となっているので、
  これを６文字以上に拡張する必要があります。
  「オプション(O)」→「環境設定(K)」→「設定６」Modeを6以上に変更
  して「入力可能な桁数の変更」をクリックします。

-----------------------------------------------------------------
【FreeDV 2.3.0 以降の SNR 対応】
-----------------------------------------------------------------
  FreeDV 2.3.0 で追加された RX SNR 値を Remarks1 欄へ
  記録します。
  例）SNR RX:12dB
  FreeDV 2.2.x では記録されません。
  
-----------------------------------------------------------------
【コマンドプロンプト画面】
  画面の横幅を調整する方法
  コマンドプロンプト画面のタイトルバーを右クリックします。
  「設定」→「起動サイズ」60x30 程度にするとよいです。
  次回起動時から反映されます。

-----------------------------------------------------------------
【トラブルシューティング】
-----------------------------------------------------------------
  ■「ポートのバインドに失敗」と表示される場合
    同じポート（2237）を別のアプリケーション（WSJT-X, JTAlert 等）
    が使用しています。他のアプリを終了してください。
  ■「Turbo HAMLOG が見つかりません」と表示される場合
    HAMLOG を先に起動してください。
    スクリプト起動後に HAMLOG を起動した場合は、次回の Log QSO 時
    に自動的に検出されます。

  ■ Turbo HAMLOG を管理者権限で起動している場合
    WM_COPYDATA の権限制限により、このスクリプトも同じ権限で実行す
    る必要があります。コマンドプロンプトを「管理者として実行」して
    からスクリプトを起動してください。

-----------------------------------------------------------------
【転送フロー】
-----------------------------------------------------------------
  FreeDV 2.2+ / 2.3+
    │  UDP Broadcast (WSJT-X互換プロトコル)
    │  ポート 2237, Type 5 (QSO Logged)
    ▼
  freedv_hamlog.exe  ← このツール
    │  UTC → JST 変換
    │  WM_COPYDATA (Windows プロセス間通信)
    ▼
  Turbo HAMLOG/Win 入力ウィンドウ
    → オペレーターが確認して Save

-----------------------------------------------------------------
【ライセンス】
-----------------------------------------------------------------
 本プログラムは生成AIで作成されています。
 プログラムの改変・配布は自由です。
 
 2026/6/17
 JA3WUI/Tonaru
 https://tonaru.net/details7.html#radio-37
 
 ==================================================================
