ログキャッシュの状態を返す。

交信数、ユニークコールサイン数、日付範囲、使われているバンドとモード、 取り込み元ファイルと取り込み日時。まず最初にこれを呼ぶと全体像がつかめる。

HAMLOG からエクスポートしたログファイルを読み込んでキャッシュを更新する。

HAMLOG 側のデータは読むだけで変更しない。書き込むのは自前の SQLite のみ。 ADIF (.adi/.adif) を推奨。HAMLOG 独自 CSV も best-effort で読める。

Args: path: ログファイルのパス。省略時は環境変数 HAMLOG_EXPORT を使う。 replace: True なら既存キャッシュを破棄して入れ直す。False なら追記。 csv_columns: CSV の列順が既定と違う場合に指定する列名リスト。

条件を指定して交信記録を検索する。

Args: callsign: コールサイン。JA1* のようにワイルドカード (* ?) が使える。 band: "40m" のようなバンド名。db_info で使用中の一覧が分かる。 mode: "CW" など。大文字小文字は問わない。 date_from: 開始日 YYYY-MM-DD (この日を含む)。 date_to: 終了日 YYYY-MM-DD (この日を含む)。 jcc_prefix: JCC/JCG コードの前方一致。"09" で長野県など。 qsl_rcvd: True で QSL 受領済みのみ、False で未受領のみ。 name_contains: 相手局名の部分一致。 qth_contains: QTH の部分一致。 limit: 返す件数の上限 (既定 50)。総件数は total に入る。 offset: 読み飛ばす件数。ページングに使う。 order: qso_date の並び順。

交信数を指定した軸で集計する。

絞り込み条件は search_qso と同じものが使える。 group_by の意味: band/mode バンド別・モード別 year/month 年別・月別 hour 時間帯別 (交信時刻の時。ログの時刻が JST か UTC かに依存) call 相手局別 (よく交信している局) jcc JCC/JCG コード別 prefecture JCC 上 2 桁別 (都府県名は award_progress のほうが読みやすい) gridsquare グリッドロケータの上 4 桁別

特定の局との交信履歴をまとめて返す。

初回交信日、最終交信日、交信したバンドとモード、記録されている名前と QTH、 および各交信の明細。交信中に相手の履歴を確認する用途を想定している。

Args: callsign: 相手局のコールサイン (完全一致)。 limit: 返す明細の上限。

アワードの進捗を出す。取得済みと未取得の両方を返す。

prefecture は都府県 47 の取りこぼしが分かるので「次にどこを狙うか」に使える。 jcc と gridsquare は全体の母数が定義できないため、取得済みの一覧と数のみ返す。

Args: kind: prefecture (都府県) / jcc (市郡区コード) / gridsquare (GL 上 4 桁)。 band: バンドで絞る (バンドごとの進捗を見るとき)。 mode: モードで絞る。 date_from: 開始日 YYYY-MM-DD。 date_to: 終了日 YYYY-MM-DD。 qsl_rcvd: True にすると QSL 受領済みの交信のみで判定する。 include_worked_detail: True で取得済みの各項目に交信数と初回/最終日を付ける。

起動中の Turbo HAMLOG の入力ウィンドウの内容を読む (読み取りのみ)。

今まさに入力中のコールサイン・レポート・周波数などが取れる。 交信中に「この局とは前にいつ交信したか」を調べる起点に使う。 HAMLOG 側は一切変更しない。

Windows かつ HAMLOG (Ver5.27c 以降) が起動している必要がある。 HAMLOG と本サーバは同じユーザー・同じ権限レベルで動かすこと。

HAMLOG.HDB を HAMLOG50.DLL 経由で直接読み、キャッシュを更新する。

ADIF エクスポートの手間なしに、常に最新のログを取り込める。 読み取り専用で、HAMLOG のデータは変更しない (書き込み API は未バインド)。

HAMLOG50.DLL は 32 ビットなので、DLL を触る部分だけを 32 ビット Python の 子プロセスに分離して実行する。MCP サーバ本体は 64 ビットのままでよく、 32 ビット側に追加パッケージを入れる必要もない。

Args: hdb_path: HAMLOG.HDB のフルパス。省略時は環境変数 HAMLOG_HDB。 dll_path: HAMLOG50.DLL のフルパス。省略時は環境変数 HAMLOG_DLL。 py32_path: 32 ビット python.exe のパス。省略時は環境変数 HAMLOG_PY32。 本サーバ自体が 32 ビットで動いている場合は不要。 use_copy: True (既定) なら HDB と MST を一時領域へ複製してから開く。 HamlogOpen はインデックスが無ければ生成するため、原本のフォルダに ファイルを作らせないための措置。HAMLOG 起動中でも安全に読める。 limit: 先頭から読む件数の上限。動作確認用。

HDB 読み込み経路の自己診断。DLL や HDB が無くても実行できる。

構造体サイズの検証と、合成レコードでの読み出しテストを行う。 32 ビット Python が指定されていればそちらで実行し、経路全体を確認する。 import_from_hdb が失敗するとき、まずこれを呼んで切り分けること。