Icom IC-7610

前提条件

• Hamlib（rigctl）：brew install hamlib
• curl：通常已预装
• python3：通常已预装
• pyserial（仅用于串口上电）：pip3 install pyserial
• wfview（可选，用于局域网控制）：wfview.org/download

配置

台站配置位于 .env 文件中（不纳入 Git 版本管理）。首次安装时执行：cp .env.example .env。

环境变量

source "$(dirname "$0")/.env" 2>/dev/null || true
PORT="${SERIAL_PORT:-/dev/cu.usbserial-11320}"
BAUD="${BAUD_RATE:-19200}"
MODEL="${HAMLIB_MODEL:-3078}"
FLRIG="${FLRIG_URL:-http://127.0.0.1:12345/RPC2}"
RIGCTLD="${RIGCTLD_ADDR:-127.0.0.1:4533}"
MAX_POWER="${MAX_POWER_W:-50}"

RFPOWER 量纲说明

rigctl 使用 **0.0–1.0** 归一化范围表示功率，其中 1.0 = 100 W。换算公式为：RFPOWER = 实际功率（W） / 100。 例如：5 W → 0.05，50 W → 0.50。⚠️ 注意：L RFPOWER 5 表示等效 500 W，**并非** 5 W！ flrig 则直接使用瓦特数值：rig.set_power 50 即表示设置为 50 W。

连接方式

共支持三种连接方式，按优先级顺序自动检测：自动检测逻辑如下：

# 1. 检查 rigctld（wfview 局域网或独立运行的 hamlib rigctld）
if rigctl -m 2 -r "$RIGCTLD" f >/dev/null 2>&1; then
  CONN="rigctld"
# 2. 检查 flrig
elif curl -s --connect-timeout 2 --max-time 3 -X POST "$FLRIG" 
     -H "Content-Type: text/xml" 
     -d 'rig.get_vfoA' 
     | grep -q ''; then
  CONN="flrig"
# 3. 回退至直连串口
else
  CONN="serial"
fi

rigctld — 通过 wfview（推荐）或独立 hamlib daemon 实现局域网连接

通过网络（wfview UDP 或已运行的 rigctld daemon）连接 IC-7610。 完全控制能力：频率、模式、功率、S 表读数、驻波比（SWR）、CW 键控、开关机。

rigctl -m 2 -r "$RIGCTLD" 
# 读取：  f   m   l RFPOWER   l SWR
# 设置：  F 14074000   M USB 3000   L RFPOWER 0.50
# CW 发送：    b "CQ CQ DE YOURCALL K"
# 开关机：  set_powerstat 0（关）   set_powerstat 1（开）

配置步骤：wfview → Settings → 启用 LAN → 连接电台 IP → 启用 RigCtld（端口 4533）。

⚠️ 注意：M（设置模式）命令可能因等待 wfview rigctld 确认而挂起——但命令仍会实际执行。 必要时请使用超时封装，或以“即发即弃”（fire-and-forget）方式发送。

相比串口连接的优势：

• 无需 USB 线缆，仅需以太网连接
• 开关机操作简单：set_powerstat 1 即可完成上电（无需原始 CI-V 指令或 pyserial）
• 多个程序可通过 wfview 共享电台（rigctld + 虚拟串口）
• 传输距离更长（以太网最大 100 米 vs USB 最大 5 米）

rigctl 串口直连（USB，支持完整控制，含 CW 与开关机）

rigctl -m $MODEL -r "$PORT" -s $BAUD 
# 读取：  f（频率）  m（模式+带宽）  l RFPOWER  l SWR
# 设置：  F 14074000   M USB 3000   L RFPOWER 0.50
# CW 发送：    b "CQ CQ DE YOURCALL K"
# 快捷调用：  f m l RFPOWER   → 单次调用同时获取频率、模式、带宽、功率

⚠️ 波特率必须为 19200（非 115200！）。务必使用超时封装：timeout 10 rigctl ... ⚠️ 当 flrig 正在运行时，串口将被占用。如需使用 CW 或开关机功能，请先关闭 flrig。

flrig XML-RPC

call_flrig() {
  curl -s --connect-timeout 3 --max-time 5 -X POST "$FLRIG" 
    -H "Content-Type: text/xml" 
    -d "$1$2" | 
    grep -o '[^<]*' | head -1 | sed 's/<[^>]*>//g'
}
# 读取：  call_flrig rig.get_vfoA / rig.get_modeA / rig.get_power / rig.get_Sunits / rig.get_SWR
# 设置：  call_flrig rig.set_vfoA '14074000'
#         call_flrig rig.set_modeA 'USB'
#         call_flrig rig.set_power '50'

远程开关机

前提条件：电台后部 POWER 开关置于 ON 位，并设置： MENU → SET → Network → Power OFF Setting = Standby/Shutdown。

通过 rigctld（wfview 局域网）——最简方案

rigctl -m 2 -r "$RIGCTLD" set_powerstat 0   # 关机
rigctl -m 2 -r "$RIGCTLD" set_powerstat 1   # 开机 — 可行！wfview 自动处理

通过串口 — 关机可行，开机需原始 CI-V 指令

关机： rigctl -m $MODEL -r "$PORT" -s $BAUD set_powerstat 0

开机： rigctl 的 set_powerstat 1 在待机状态下无法通过串口工作（rig_open 失败）。需使用原始 CI-V 指令：

python3 -c "
import serial, time
ser = serial.Serial('$PORT', $BAUD, timeout=2)
ser.reset_input_buffer()
ser.write(bytes([0xFE,0xFE,0x98,0xE0,0x18,0x01,0xFD]))
time.sleep(1); resp = ser.read(100); ser.close()
print('Power ON: OK' if 0xFB in resp else 'FAIL')
"

开机后需等待 7–10 秒 再发送其他指令。“启动过程中命令被拒绝”属正常现象。

CW 与信标

支持通过 rigctld（局域网）和串口直连两种方式实现。

# 通过 rigctld（局域网）：
rigctl -m 2 -r "$RIGCTLD" b "CQ CQ CQ DE $CALLSIGN $CALLSIGN K"

# 通过串口：
rigctl -m $MODEL -r "$PORT" -s $BAUD b "CQ CQ CQ DE $CALLSIGN $CALLSIGN K"

# 信标循环（两种连接方式均适用）
for i in $(seq 1 $REPEATS); do
  rigctl -m 2 -r "$RIGCTLD" b "VVV DE $CALLSIGN VVV DE $CALLSIGN"
  [ $i -lt $REPEATS ] && sleep $INTERVAL
done

电台 CW 设置路径：MENU → SET → Connectors → USB Keying (CW) → RTS

安全规范

发射前检查清单（每次发射前必须执行）

1. 已获得操作员确认
2. 频率处于业余频段内（1.8–2.0、3.5–4.0、7.0–7.3、10.1–10.15、14.0–14.35、18.068–18.168、21.0–21.45、24.89–24.99、28.0–29.7 MHz）
3. 模式匹配该频段划分（例如：CW/数据段下方不得使用话音模式）
4. 发射功率 ≤ $MAX_POWER_W（默认 50 W）；超出此值需额外确认
5. 若可获取 SWR 值，则须 ≤ 3.0；若 >3.0，则禁止发射（天线异常）

无需确认的操作

读取频率/模式/S 表/SWR、切换 VFO、更改频率/模式、开关机。

始终需要确认的操作

PTT 触发、CW 键控、信标发射、功率 > $MAX_POWER_W。所有射频发射行为均属此类。

自动拒绝（即使已获确认）

在业余频段外发射；或 SWR > 3.0 时发射。

信标相关法规（FCC）

远程操作合法（§97.109d）。无人值守信标仅允许在 28.2–28.3 MHz 和 50.06–50.08+ MHz 频段内运行； 28 MHz 以下频段运行信标时，操作员必须保持通信联络状态。

参考文档

完整技术文档见 references/FULL-REFERENCE.md，按需查阅：

• flrig 全量 XML-RPC 方法列表（30+ 个方法）
• CI-V 协议参考（指令集、模式定义、地址编码）
• 错误恢复对照表（常见错误及其修复方案）
• Shell 辅助函数（freq_valid、set_power_safe、rig_retry、preflight、quick_status）
• 电台菜单设置说明（Network、CI-V、Connectors 等）
• 其他 Icom 收发信机兼容性说明
• 美国业余频段规划表（含 CW/数据/话音子段的详细划分）