소개
WaveLogGate는 아마추어 무선 로그 프로그램인 WSJT-X 및 FLDigi와 무전기 제어 소프트웨어 FLRig, Hamlib를 웹 기반 로그 플랫폼 Wavelog에 연결해 주는 데스크톱 게이트웨이 응용 프로그램입니다. Wavelog 프로젝트에서 DJ7NT 게시자가 개발한 이 도구는 UDP로 수신한 QSO 로그 데이터를 Wavelog에 전달하고, 무선기의 주파수·모드를 Wavelog 측 QSY 요청과 동기화하는 역할을 합니다. Go와 Wails v2, Svelte로 만들어져 단일 바이너리로 배포되며 별도 런타임 의존성 없이 동작합니다.
상세정보
WSJT-* 및 FLDigi 로그 데이터 중계
WSJT-X와 FLDigi에서 보내는 QSO 로그 패킷을 UDP 포트 2333(설정 가능)으로 수신해 Wavelog로 전달합니다. WSJT-X에서는 File → Settings → Reporting의 Secondary UDP Server만 사용해야 하며, FLDigi에서는 Configure → User Interface → Logging에서 UDP 로그 출력을 활성화해 호스트를 localhost, 포트를 2333으로 지정합니다.
FLRig 및 Hamlib 무전기 제어 연동
Configuration 탭의 Radio Control에서 백엔드를 선택할 수 있습니다. None은 UDP 로그만 전달하는 모드이고, FLRig는 XML-RPC로 127.0.0.1:12345에 연결하며, Hamlib는 rigctld 데몬에 127.0.0.1:4532로 연결합니다. Wavelog에서 QSY 요청이 오면 무전기 모드도 함께 변경할 수 있고, Hamlib 모드에서는 Set MODE on QSY 및 Ignore Power 같은 세부 동작을 설정할 수 있습니다.
Internal Hamlib(내장 rigctld) 관리
별도 rigctld를 실행하지 않고도 WaveLogGate가 자체적으로 rigctld 프로세스를 실행하고 관리할 수 있습니다. 라디오 모델 번호, 시리얼 포트, 보드레이트, 패리티, 정지 비트, 핸드셰이크, rigctld 포트 등을 지정하면 WaveLogGate가 이를 rigctld에 전달하고 프로세스를 감시합니다. 상태는 Status 탭에서 Stopped, Starting…, Running, Error로 표시됩니다.
안테나 로테이터 제어
Config → Rotator에서 rotctld 호스트와 포트(기본 4533), Az/El 임계값, 파크 위치를 설정할 수 있습니다. Status 탭의 로테이터 패널은 호스트가 설정되어야 표시되며, Follow Off, Follow HF, Follow SAT, Park 모드를 제공합니다. Wavelog의 lookup_result 또는 satellite_position WebSocket 메시지를 받아 HF 또는 SAT 추적 모드에서 azimuth/elevation을 자동으로 추종하며, 명령 사이에는 150 ms의 최소 간격이 적용됩니다.
다중 프로필 관리
여러 개의 명명된 구성 프로필을 지원하며 항상 최소 2개가 존재해야 합니다. 프로필 간 전환, 이름 변경, 추가, 삭제가 가능하고, 활성 프로필과 마지막 2개는 삭제되지 않습니다. 프로필을 전환하면 라디오 폴러와 Wavelog 클라이언트가 즉시 새 설정으로 전환되며, 저장하지 않은 필드 변경은 사라지므로 전환 전에 저장해야 합니다.
Wavelog 연동 및 라이브 상태 브로드캐스트
Wavelog URL(https://log.example.com/index.php 형식), Station, Radio name(WLGate 기본값)을 입력하고 Wavelog → Settings의 API 키를 등록하면 Station 드롭다운이 자동으로 채워집니다. ↻ 버튼으로 다시 불러올 수 있고, Test 버튼은 dry-run 엔드포인트로 데모 QSO를 보내 연결을 확인합니다. 54322 포트의 WebSocket으로는 frequency, mode, power, radio, timestamp를 포함한 radio_status 메시지를 실시간으로 송출합니다.
QSO UDP Emit
Wavelog에 성공적으로 기록된 QSO를 ADIF 데이터그램으로 설정된 UDP 대상에 다시 송출하는 기능입니다. ⚙ Advanced에서 활성화하며 기본 호스트 127.0.0.1, 기본 포트 2334입니다. 이 기능은 기본값이 비활성화되어 있으며 전역 설정으로 저장되고, Wavelog 측에서 기록된 QSO에 대해서만 동작합니다.
Q: 소스 코드는 어디에서 확인할 수 있나요?
공식 GitHub 저장소(wavelog/WaveLogGate)에서 확인할 수 있으며 라이선스는 MIT입니다.
Q: 라이선스는 무엇인가요?
MIT 라이선스로 배포되며 자세한 내용은 저장소의 LICENSE 파일에서 확인할 수 있습니다.
Q: 어떤 WSJT-* 모드를 지원하나요?
README에는 WSJT-X와 FLDigi를 UDP 로그 소스로 지원한다고 명시되어 있으며 구체적인 모드 목록은 별도로 정리되어 있지 않습니다.
Q: winget으로 설치할 수 있나요?
winget install –id DJ7NT.WaveLogGate –exact 명령으로 설치할 수 있습니다.
시스템 요구사항
MIT 라이선스 하에 배포되며, 소스 코드는 공식 GitHub 저장소에서 확인할 수 있습니다. winget 패키지 식별자는 DJ7NT.WaveLogGate이며 installer_type은 portable, architecture는 x86입니다. Windows 설치 시 winget을 이용하거나 GitHub 릴리스 페이지에서 .exe 파일을 직접 내려받아 실행할 수 있습니다. 내부 Hamlib(InternalHamlib)을 사용할 경우 rigctld 바이너리가 시스템에 존재해야 하며, Windows에서는 설정 화면의 Download 버튼으로 자동으로 내려받을 수 있습니다.