===================================================================
  FreeDV → Turbo HAMLOG / eQSL  Bridge
  Version 3.0
  対応: FreeDV 2.2.x / 2.3.x   Turbo HAMLOG Ver5.27c以上
===================================================================
-------------------------------------------------------------------
【概要】
-------------------------------------------------------------------
  FreeDV が送出する UDP ログパケット（QSO Logged）を受信し 以下の
  サービスへ同時に自動転送・アップロードするツールです。

    1. Turbo HAMLOG      … 入力ウィンドウへ自動入力
    2. eQSL.cc           … リアルタイム ADIF アップロード

  各サービスの有効/無効・認証情報は config.ini で管理します。

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

-------------------------------------------------------------------
【インストール】
-------------------------------------------------------------------
 １．freedv_hamlog_eqsl.exeファイルとconfig.iniファイルをセット
     で任意の場所においてください。
   例）OS(C:)\FreeDV_HAMLOG\freedv_hamlog_eqsl.exe
       OS(C:)\FreeDV_HAMLOG\config.ini
 
  2. exeファイルをダブルクリックするとプログラムが起動します。

  3. ショートカットアイコンの作成方法は、exeファイルを右クリックして
    「その他のオプションを確認」→「ショートカットの作成(S)」です。
  
  ４．プログラムの削除は該当ファイルの削除のみです。

-------------------------------------------------------------------
【FreeDV側の設定】
-------------------------------------------------------------------
  FreeDVを起動して設定します。
 「Tools」→「Options...」→「Reportinng」→ Enable UDP Broadcast
  にチェックを入れます。portは2237に設定します。

-------------------------------------------------------------------
【ファイル構成】
-------------------------------------------------------------------
  freedv_hamlog_eqsl.exe       … メインプログラム
  config.ini                   … 設定ファイル（必須・編集が必要）
  readme.txt                   … このファイル

-------------------------------------------------------------------
【設定ファイル（config.ini）の編集】
-------------------------------------------------------------------
  config.ini をメモ帳などのテキストエディタで開き、使用するサービス
  の設定を行ってください。

  ■ Turbo HAMLOG
    [hamlog]
    enabled = true            ← true で有効、false で無効

  ■ eQSL.cc
    [eqsl]
    enabled = true            ← true で有効、false で無効
    username = JA1QSO         ← コールサイン
    password = yourpassword   ← eQSL のパスワード（大小文字区別）
    qth_nickname =            ← 1アカウントのみは空欄でOK
                                 固定/移動等で使い分けている場合

  ■ 全般
    [general]
    port = 2237               ← FreeDV 側の port と合わせること
    snr_in_remarks = true     ← SNR を HAMLOG の Remarks1 に転送
                                 true で有効、false で無効
    verbose = false           ← デバッグログを表示
                                 true で有効、false で無効
  
   ※ config.ini にはパスワードが平文で保存されます。
      他の人が閲覧できる場所（共有フォルダ、クラウドストレージの
      公開フォルダなど）には置かないようにしてください。

-------------------------------------------------------------------
【使い方】
-------------------------------------------------------------------
  1. config.ini をメモ帳などのエディタで編集して各サービスの利用可
     否、認証情報を設定します。

  2. Turbo HAMLOG を起動する（HAMLOG を使う場合）
     本プログラムより先に HAMLOG を起動してください。

  3. freedv_hamlog_eqsl.exeをダブルクリック、またはショートカット
     アイコンをダブルクリックすると起動します。

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

-------------------------------------------------------------------
【転送されるデータ】
-------------------------------------------------------------------
 ─────────────────────────────────
  FreeDV フィールド      → 転送先
 ─────────────────────────────────
  DX Callsign            → HAMLOG: コールサイン
                            eQSL  : CALL
  Time On (UTC→JST変換) → HAMLOG: 日付 / 開始時刻
                            eQSL  : QSO_DATE / TIME_ON (UTC)
  Frequency              → HAMLOG: 周波数(MHz)
                            eQSL  : FREQ / BAND
  Mode (→FREEDV変換)    → HAMLOG: モード
                            eQSL  : MODE
  RST Received           → HAMLOG: His欄  / eQSL: RST_RCVD
  RST Sent               → HAMLOG: My欄   / eQSL: RST_SENT
  Grid Locator           → HAMLOG: G・L欄 / eQSL: GRIDSQUARE
  Name                   → HAMLOG: His Name
  Comments               → HAMLOG: Remarks1 / eQSL: COMMENT
  RX SNR                 → HAMLOG: Remarks1（SNR RX:xxdB）
 ─────────────────────────────────
  ※ HAMLOG の時刻は JST に変換。eQSL は UTC のまま送信。
  
  ※ FreeDV が送出するモード名 "DIGITALVOICE" は、自動的に "FREEDV"
     に変換されて HAMLOG に転送されます。
     Turbo HAMLOGのMODE欄はデフォルト設定で4文字となっているので、
     これを６文字以上に拡張する必要があります。
    「オプション(O)」→「環境設定(K)」→「設定６」Modeを6以上に変更
     して「入力可能な桁数の変更」をクリックします。
     eQSL には "DIGITALVOICE" のままアップロードされます。

-------------------------------------------------------------------
【トラブルシューティング】
-------------------------------------------------------------------
  ■「ポートのバインドに失敗」
    同じポートを別のアプリ（WSJT-X、JTAlart 等）が使用しています。
    他のアプリを終了するか、config.ini の port を変更し FreeDV 側も
    同じ port に合わせてください。

  ■「Turbo HAMLOG が見つかりません」
    HAMLOG を先に起動してください。
    スクリプト起動後に HAMLOG を起動した場合は、次回の Log QSO 時に
    自動的に検出されます。

  ■ eQSL「Error: No match on eQSL_User/eQSL_Pswd」
    config.ini の username / password を確認してください。
    パスワードは大文字小文字を区別します。

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

-------------------------------------------------------------------
【コマンドプロンプト画面】
-------------------------------------------------------------------
  (画面の縦横幅を調整する方法)
  コマンドプロンプト画面のタイトルバーを右クリックします。
  「設定」→「起動サイズ」60x30 程度にすると見やすいです。
  次回起動時から反映されます。
  
-------------------------------------------------------------------
【ライセンス】
-------------------------------------------------------------------
  このプログラムは生成AIで作成されています。
  プログラムの改変、配布は自由です。
  
  2026/6/17
  JA3WUI/Tonaru
  https://tonaru.net/details7.html#radio-39
  
===================================================================
