Cloudlog helper
Cloudlog helper是一款轻量级的Cloudlog/Wavelog辅助程序，支持自动上传当前电台信息以及实时QSO数据到Cloudlog/Wavelog/Clublog，同时支持大部分主流电台以及与JTDX/WSJT-X等软件协同工作！
如果您的电脑性能捉襟见肘，或单纯需要一个自动化QSO/电台信息上传工具，不妨来试试Cloudlog Helper！
下载地址详见文末～
💻 支持的平台
- Windows 7 SP1+
- Ubuntu 20.04+ 或其他主流发行版
- 正在适配macOS...
⚡️ 快速开始!
📌 Cloudlog配置
📌 Clublog配置
📌 Hamlib配置
如果您不需要电台数据自动上传功能，可直接忽略这一步。
由于在开启JTDX（或WSJT-X，下称JTDX）后，电台的控制权将被JTDX独占，因此在未设置JTDX前，此功能和JTDX不能同时启用。可查看与JTDX协同工作部分获取解决方法。
本软件可以定时上传电台信息（频率、模式等）到您的Cloudlog服务器。当您需要记录QSO信息时，Cloudlog会自动获取当前的频率、模式等数据，并自动填充至对应输入框中，避免手动输入错误。同时，Cloudlog 主界面中也会实时显示电台的 频率、模式等信息，方便操作时参考。
在电台型号下拉框中选择您使用的电台的型号。
在设备端口中选择您的设备所在的端口。
点击“测试”按钮。测试无误后方可勾选“电台数据自动上报”。点击“确认”保存配置。
软件主界面应该出现了读取到的电台相关信息。打开您的Cloudlog网站，主页应该出现了您的电台信息：
在"Station"中选择您的电台。此后，在您填写QSO信息时，Cloudlog都将自动帮您填充频率、模式等信息。
📌 UDP服务器配置
此部分的工作原理类似GridTracker，JTDX会通过 UDP 协议 广播当前解码的呼号、频率、信号报告等信息，而CloudlogHelper将接收这些信息并解码，将通联结果实时上传至您的Cloudlog服务器。
🚀 高级
🎯 与JTDX/Wsjt-x协同工作
如果您希望在开启JTDX的情况下实时上报电台数据，请参考以下内容。Wsjt-x的操作过程与此类似。
当您开启JTDX后，电台的控制权将被JTDX独占，此时您将无法通过本软件读取电台频率。幸运的是，JTDX和本软件均可以使用Rigctld作为电台的控制后端，您只需修改一下JTDX中的网络服务器地址，使本软件和JTDX共享一个Rigctld后端即可。
请勿将JTDX和本软件的轮询间隔设置得过小，太频繁的数据请求可能导致电台来不及反应导致出错。一个建议值是在JTDX的设置-电台中设置时间间隔为8s，本软件的轮询间隔为15s。请注意，两者不能为整数倍数
具体做法如下（以Windows7为例）：
打开Cloudlog Helper，进入“设置”页面，填写电台相关信息后勾选“电台信息自动上报”。注意，不要勾选禁用PTT控制。JTDX依赖此功能控制电台发射。
点击“应用更改”。
打开JTDX，进入设置-电台，将无线电设备更改为Hamlib NET rigctl
，CAT控制中的网络服务器填写rigctld后端地址（默认为127.0.0.1:4534），PTT方法保持原配置不变.
测试CAT和PTT均可用后，点击“确定”。
现在您就成功实现了CloudlogHelper和JTDX的协同工作。
🎯 各配置项说明
⚙️ Hamlib配置
| 配置项 | 说明 |
|---|
| 电台数据自动上报 | 如此项被勾选，软件将自动上传获取到的电台信息到指定的cloudlog服务器。 |
| 轮询间隔 | 指定向rigctld后端获取电台数据的时间间隔。默认为9秒。 |
| 电台型号 | 目前使用电台的型号。型号列表从rigctld中读取，因此理论上只要hamlib支持的电台本软件均支持。 |
| 设备端口 | 电台所在的端口。 |
| 报告异频信息 | 在轮询时向rigctld请求异频（在接收和发射时使用不同频率）信息。部分电台不支持此功能或读取的数据有误。 |
| 报告发射功率 | 在轮询时向rigctld请求当前的发射功率。部分电台不支持此功能或读取的数据有误。 |
| 高级设置-rigctld命令行参数 | 手动指定启动rigctld后端的命令行参数。此项具有最高的优先级，如果此项不为空，其他相关配置（禁用PTT控制/允许外部控制）均会被忽略。如果您选择手动指定命令行参数，则必须显式指定rigctld的ip地址和端口（-T <ip> -t <port>）,软件将从命令行参数中自动解析port。 |
| 高级设置-禁用PTT控制 | 在启动时禁用rts和dtr控制（增加参数--set-conf=""rts_state=OFF"" --set-conf ""dtr_state=OFF""）。仅在部分Lnux上需要启用。如需与JTDX等第三方软件协同工作，此选项不应该勾选。 |
| 高级设置-允许外部控制 | 允许从localhost以外的设备与rigctld后端交互（增加参数 -T 0.0.0.0 ）。 |
高级设置-允许请求代理 | 启动一个代理服务器，可以将外部的请求代理至软件中，由软件按照优先级按顺序自动发送至rigctld。 |
| 使用外部rigctld服务 | 使用外部的rigctld作为软件的rigctld后端。例如您手动启动了一个rigctld实例，就可以勾选此选项，配置软件使用您指定的rigctld后端。 |
⚙️ UDP服务器配置
| 配置项 | 说明 |
|---|
| 启用UDP服务器 | 启动一个UDP服务器，用于接收来自第三方软件发送的QSO数据。 |
| 端口号 | UDP服务器的端口号。 |
| 允许外部连接 | 允许接收localhost以外的设备发来的请求。 |
| 自动上传QSO到Cloudlog | 自动上传接收到的QSO到指定的Cloudlog服务器。 |
| 自动上传QSO到Clublog | 自动上传接收到的QSO到指定的Clublog服务器。 |
| QSO上传失败重试次数 | 指定QSO上传失败重试次数。 |
🛠️ 编译
详见github readme
✨ 其他
详见github readme
🙏 致谢
- Hamlib: 业余无线电设备控制库（支持电台、旋转器、调谐器及功放）
- WsjtxUtils: 基于 C# 的类库及示例代码，通过 .NET & .NET Framework 4.8 的 UDP 接口与 WSJT-X 交互
📝 许可证
Cloudlog Helper是释放至公共领域的免费无约束软件。任何人可出于任何目的（商业或非商业），以任何形式（源代码或编译文件），自由地复制、修改、发布、使用、编译、出售或分发本软件。
完整的许可证信息请参考仓库中的Unlicense文件。
⚠️ 免责声明
软件使用
Cloudlog Helper 是一款免费的开源软件，旨在为业余无线电爱好者提供便捷的 Cloudlog/Wavelog 辅助功能。用户可自由下载、使用或修改本软件，但所有使用行为均需自行承担风险。开发者及贡献者不对因使用本软件导致的任何直接或间接损失负责，包括但不限于：
- 数据丢失或损坏
- 电台设备异常或故障
- 网络通信问题
- 其他因软件兼容性、配置错误或操作不当引发的后果
功能限制
测试阶段声明：本软件目前处于测试阶段（UNDER TESTING），可能存在未发现的缺陷或功能不稳定性。建议用户在使用前备份重要数据，并避免完全依赖本软件进行关键操作。
第三方依赖：本软件依赖 Hamlib、JTDX/WSJT-X 等第三方库或工具，其功能及兼容性受限于这些组件的支持范围。开发者无法保证所有设备或软件的适配性。
数据安全与隐私
用户需自行确保输入的 Cloudlog/Wavelog API Key、Clublog 账户信息等敏感数据的安全性。本软件不会主动收集或存储这些信息，但因用户设备或网络环境导致的数据泄露风险需由用户自行承担。
通过 UDP 服务器接收的 QSO 数据默认仅在本地处理，启用“允许外部连接”功能可能增加安全风险，请谨慎配置。
设备操作风险
使用 Hamlib 控制电台时，请确保遵循设备制造商的操作规范。错误的轮询间隔或配置可能导致电台异常。建议首次使用时在不连接电台的情况下测试功能。
与 JTDX/WSJT-X 等软件协同工作时，需注意避免端口冲突或控制权竞争问题。开发者不承担因配置错误导致的设备损坏责任。
下载地址
github: https://github.com/SydneyOwl/cloudlog-helper 欢迎star~
蓝奏云：https://wwbk.lanzouq.com/b00uz66gsd 密码:5ii8
闽ICP备2021006864号-7
闽公网安备35020602002794号