MRRC Modern Web 遥控 — 操作指南

适用于 MRRC Web Control（v1.11.x，2026-08 之后的界面），支持 FT-710、IC-7300 与 IC-7300MK2。本文档逐项说明界面上每一个按钮、滑杆、下拉框的功能与用法，编号与文末插图（图 1 主界面、图 2 菜单）中的琥珀色序号一一对应。

0. 开始之前：连接与登录

⚠️ 电台硬件电源开关不在本界面内——⏻ 只控制浏览器与服务器的 Web 连接，不控制电台电源（V2.13 已撤回电台电源软开关功能）。

0.5 电台型号差异

服务器通过 MRRC_RADIO_MODEL（ft710、ic7300、ic7300mk2）选择后端，前端会根据后端上报的 capabilities 自动调整可用控件。

0.6 Windows 配置与运行

本章说明 IC-7300 与 FT-710 在 Windows 桌面版（MRRC-Modern-Setup.exe） 下分别如何配置并使其工作：装驱动 → 确认串口 → 编辑配置 → 电台侧设置 → 启动验证。

配置统一写在 %LOCALAPPDATA%\MRRC-Modern\mrrc_modern.env（开始菜单里的 Edit Configuration 快捷键会打开它）。变量名用新的 MRRC_* 前缀；旧的 FT710_* 前缀仍被兼容接受（MRRC_* 优先），升级用户可保留原配置。修改后需重启 MRRC Modern 生效。

0.6.1 通用步骤（两台都适用）

1. 安装 MRRC-Modern-Setup.exe（开始菜单出现 MRRC Modern 与 Edit Configuration 两个快捷方式）。
2. 用 USB 线连接电台到电脑，并开机。
3. 打开 设备管理器，在「端口 (COM 和 LPT)」下确认电台的串口：
   • IC-7300：一个 COM 口（USB CI-V）。
   • FT-710：两个 Silicon Labs CP210x COM 口（较低编号通常是 CAT 用的 Enhanced COM Port）。
4. 打开 mrrc_modern.env，设置 MRRC_RADIO_MODEL（ic7300 / ic7300mk2 / ft710，见 0.6.2 / 0.6.3 的完整示例），并确保 MRRC_SERIAL_PORT 指向第 3 步确认的串口。
5. 启动 MRRC Modern，浏览器自动打开登录页。输入 MRRC_WEB_PASSWORD 后，状态栏 ●Serial 变绿即表示 CAT 已连通。

换电台时不需要重装：改 MRRC_RADIO_MODEL 和串口/波特率即可，其余步骤照对应小节核对。

0.6.2 IC-7300 / IC-7300MK2

驱动：IC-7300 用标准 Windows USB-serial 驱动（通常自动安装），不需要 FTDI 驱动。

设备管理器确认：「端口 (COM 和 LPT)」显示一个 COM 口，即 USB CI-V。

mrrc_modern.env 完整示例：

MRRC_RADIO_MODEL=ic7300        # 或 ic7300mk2
MRRC_SERIAL_PORT=COM5          # 改成设备管理器里看到的 CI-V COM 口
MRRC_BAUD_RATE=115200
MRRC_WEB_HOST=127.0.0.1
MRRC_WEB_PORT=8888
MRRC_WEB_PASSWORD=change_this_password
MRRC_AUDIO_RX_DEVICE=USB Audio
MRRC_AUDIO_TX_DEVICE=USB Audio
# IC-7300 地址覆盖（默认 0x94）：
#IC7300_CIV_ADDR=0x94
# IC-7300MK2 地址覆盖（默认 0xB6）：
#IC7300MK2_CIV_ADDR=0xB6
# IC-7300 用 CI-V 0x27 频谱，无需 FTDI 库——删掉/注释 MRRC_FTDI_LIB_DIR

电台侧设置（面板菜单，开机时设置一次）：

• CI-V USB Port = Unlink from [REMOTE]。
• CI-V USB Baud Rate = 115200，必须明确选择 115200，不能保留 Auto；Icom 规定 27 11 波形输出仅在 Unlink + 115200 下可设置。选择 ic7300/ic7300mk2 后服务端默认即为 115200；显式设置 MRRC_BAUD_RATE 时必须一致。
• CI-V Address：IC-7300 默认 94h（IC7300_CIV_ADDR）；IC-7300MK2 默认 B6h（IC7300MK2_CIV_ADDR）。
• 建议开启 CI-V Transceive（连接时服务端会按型号自动发送开启命令：IC-7300 项目 0071，MK2 项目 0089）。

音频：IC-7300 的 USB 音频是 48 kHz 原生，服务端直接透传，无需重采样。Windows 下该声卡以 USB Audio CODEC / USB Audio Device 形式枚举（本地化系统可能是「麦克风 (USB Audio Device)」）。MRRC_AUDIO_RX_DEVICE / MRRC_AUDIO_TX_DEVICE 填 USB Audio 即可同时匹配两种形式。启动及 RX/TX 打开日志会列出 host、default、actual、channels；IC 正常值应为 actual=48000Hz。

频谱：来自 CI-V 0x27 帧，走 CAT 串口，不需要 FT4222。启动时依次发送 Scope Display ON（27 10 01）、Center、±100 kHz Span、Data Output ON（27 11 01）；两个 ON 开关缺一不可。分片队列最多保留 44 个片段，积压时丢弃最旧数据；WebSocket 以 30 Hz 调度且只发送新完成的真实帧。菜单 SPAN 可调跨度，SPD 对 IC 只提供 FAST/MID/SLOW。

验证清单：

1. 状态栏 ●Serial 变绿。
2. 频率、模式、S 表跟随电台面板变化（面板改动也会回传——Transceive）。
3. 浏览器能听到接收声音（📶 音量滑杆、状态栏无「无声」告警）。
4. 瀑布图有信号（频谱来自 CI-V 0x27；发射期间仍会刷新，这是与 FT-710 不同之处）。
5. 长按 PTT 说话，功率/ALC 表有反应（首次发射请用小功率确认）。

0.6.3 FT-710

驱动：

• 必须：Silicon Labs CP210x Universal Windows Driver（CAT 串口用）。
• 可选：FTDI D2XX 驱动 —— 仅当需要 FT4222 真频谱时。没装则自动回退到 S-meter 合成频谱（可用但不含真实 FFT 数据）。

设备管理器确认：「端口 (COM 和 LPT)」显示两个 Silicon Labs CP210x COM 口。较低编号的那个通常是 CAT 用的 Enhanced COM Port；另一个是 FT4222 频谱口（MRRC_SCOPE_PORT，留空即自动探测）。

mrrc_modern.env 完整示例：

MRRC_RADIO_MODEL=ft710
MRRC_SERIAL_PORT=COM3          # 改成 Enhanced COM Port（两个 CP210x 里较低编号）
MRRC_BAUD_RATE=38400
MRRC_WEB_HOST=127.0.0.1
MRRC_WEB_PORT=8888
MRRC_WEB_PASSWORD=change_this_password
MRRC_AUDIO_RX_DEVICE=USB Audio
MRRC_AUDIO_TX_DEVICE=USB Audio
MRRC_FTDI_LIB_DIR=vendor\ftdi\windows\bin\x64
#MRRC_SCOPE_PORT=              # 留空自动探测 FT4222 频谱口

电台侧设置（FT-710 面板 FUNC → RADIO SETTING）：

• 各模式的 MOD SOURCE 设为 USB（SSB 必设；AM / FM / PSK/DATA 若要用也设 USB），否则 PTT 按下没有调制。
• RPTT SELECT 保持 OFF：PTT 由 CAT 命令控制，不走 RTS/DTR。

音频：FT-710 的 USB 音频是 44.1 kHz 原生，服务端会把它重采样到 48 kHz 再走网络。Windows 下该声卡同样以 USB Audio CODEC / USB Audio Device 形式枚举，MRRC_AUDIO_RX_DEVICE / MRRC_AUDIO_TX_DEVICE 填 USB Audio 即可。

频谱：真频谱来自 FT4222 SPI（需要 MRRC_FTDI_LIB_DIR 指向含 FT4222.dll / ftd2xx.dll 的目录）；缺失时回退到 S-meter 合成频谱。发射期间频谱暂停并显示「频谱暂停」，属正常现象。

验证清单：

1. 状态栏 ●Serial 变绿。
2. 频率、模式、S 表跟随电台。
3. 浏览器能听到接收声音。
4. 瀑布图有信号；若只有 S-meter 合成频谱，说明 FTDI 库缺失或未指向正确目录。
5. 长按 PTT 说话，功率/ALC 表有反应（确保 MOD SOURCE=USB）。

0.6.4 常见问题（FAQ）

0.7 macOS 安装与初始化

本章面向 macOS 桌面版（MRRC-Modern-v1.13.0-arm64.dmg）：安装 → 首次启动（零配置）→ 连接设置 → 局域网访问。全程不需要打开终端、不需要编辑配置文件；安装包把最常用的设置都做成了图形化。

适用：Apple Silicon（M1/M2/M3/M4），macOS 11 及以上。应用是自包含的，拖到「应用程序」只是标准做法；从桌面/下载文件夹直接双击也能运行。

0.7.1 安装（5 步）

1. 打开官网 https://www.vlsc.net/mrrc_modern/ ，点 Download for macOS 下载 MRRC-Modern-v1.13.0-arm64.dmg（约 56 MB）。
2. 双击刚下载的 .dmg → 弹出窗口里看到 MRRC Modern 图标和一个 Applications 文件夹。
3. 把 MRRC Modern 图标拖进 Applications 文件夹（松手即完成安装）。
4. 第一次启动请右键点 Applications 里的 MRRC Modern → 选 打开 → 弹窗里再点一次 打开（因为免费签名，系统会拦一次；只第一次需要）。
5. 以后双击即可直接打开。

如果双击后系统提示「无法打开，因为它来自身份不明的开发者」或「已损坏」，就用第 4 步的 右键 → 打开 → 打开，这是正常的一次性放行，不是软件坏了。

0.7.2 首次启动：零配置 + HTTPS

启动后什么都不用配，软件会自动完成：

1. 屏幕右上角菜单栏出现 MRRC Modern :8888 图标。
2. 浏览器自动打开登录页。首次访问是 HTTPS，浏览器会提示「连接不安全 / 您的连接不是私密连接」——这是正常的，因为用的是软件自动生成的自签名证书：点 高级 → 继续访问 即可（只需这一次）。
3. 登录页顶部显示自动生成的登录密码；忘记就点菜单栏 Show Password… 随时查看。
4. 用这个密码登录，进入主界面。
5. 插上电台（FT-710 或 IC-7300/MK2，USB 线 A→B 或 C→B）：首次运行自动探测电台型号、串口和音频设备，插上就能用。

为什么默认 HTTPS？ 局域网里密码和遥控数据默认加密传输，避免被同网段的人抓包。自签名证书不代表”不安全”，只是浏览器不认识签名者；点一次「继续访问」即可。

0.7.3 连接设置（改电台 / 串口 / 音频 / 密码）

想换电台、换串口、换声卡或改密码，不用重装、不用碰配置文件：

1. 登录后点网页顶栏菜单 →「连接设置…」。
2. 在弹出的对话框里修改：
   • 电台型号（ft710 / ic7300 / ic7300mk2）
   • 串口（下拉列表自动列出可用的 /dev/cu.*）
   • RX 音频设备 / TX 音频设备（下拉列表列出本机音频设备，FT-710 一般是 USB Audio Device，IC-7300 一般是 USB Audio Codec）
   • 登录密码
3. 点 保存并重启 —— 软件自动重启生效；只点 重启服务 则不改设置、仅重启。

0.7.4 进阶：Edit Configuration（可选）

普通用户用不到。高级用户可在菜单栏 Edit Configuration… 用文本编辑器打开配置文件：

~/Library/Application Support/MRRC-Modern/mrrc_modern.env

• 变量用 MRRC_* 前缀（旧的 FT710_* 仍兼容）；改完在菜单栏 Restart Server 重启生效。
• HTTPS 默认开启（无需任何配置）；仅当想退回明文 HTTP 时才加一行 MRRC_SSL=off。
• 配置、自签名证书、记忆频道都在这一个目录里；彻底卸载时把应用拖进废纸篓、再删掉 ~/Library/Application Support/MRRC-Modern/ 即可完全清除。

0.7.5 手机 / 其他设备访问（局域网）

1. Mac 和手机连同一个 Wi-Fi / 局域网。
2. 查看 Mac 的 IP：系统设置 → Wi-Fi → 详细信息 → IP 地址（或以太网同理）。
3. 手机上浏览器打开 https://你的Mac的IP:8888（例如 https://192.168.1.50:8888）。
4. 首次同样会提示证书不受信任，点高级 → 继续访问。
5. 用登录页上的密码登录，手机就能遥控电台、看频谱、说话。

0.7.6 常见问题（FAQ）

1. 主界面控件编号图

图 1 为主界面（手机竖屏布局，桌面端宽度放大但控件一致）。琥珀色圆点为控件序号，与第 3 节速查表对应。

图 2 为点顶栏 ☰ 后滑出的左侧抽屉菜单。

2. 控件速查表（编号 → 名称 → 功能 → 操作）

2.1 顶栏（图 1 序号 1–7）

2.2 频谱区（序号 8–10）

点击 8/9 实现「指哪打哪」跳频；按住拖动则是页面滚动，不会误触发。

2.3 仪表区（序号 11–14）

2.4 快捷控制区（序号 15–19）

2.5 DSP 开关区（序号 20–24）

NR/NB 的强度滑杆（NR Level 1–15、NB Level 0–10）保留在 DOM 中但默认隐藏（移动端空间不足）；如需调节可在浏览器开发者工具中显示或留待后续版本。

2.6 音量滑杆（序号 25）

电台侧的 AF 增益（AF Gain）不受本滑杆控制；需要调电台面板音量时请用实体旋钮。

2.7 调谐区（序号 26–30）

调谐作用于活动 VFO（VFO-A 或 VFO-B，见序号 31/32）。

2.8 VFO 区（序号 31–34）

2.9 记忆频道（序号 35）

频道编辑/清空：菜单 → Memory Manager（序号 41）里对每个槽点 Clear 清空。频道数据由服务端持久化，换浏览器也能读到（Cookie 只做首屏快速回显）。

2.10 底部 PTT 区（序号 36–38）

PTT 键盘快捷键：桌面端按 空格键 等效于按住/松开 PTT（详见第 4 节）。

2.11 抽屉菜单（图 2 序号 39–51）

菜单底部显示版本号 FT-710 v1.0（前端资源版本，非电台固件版本）。

3. 键盘快捷键（桌面端）

安全细节：键盘事件忽略长按自动重复（e.repeat），也不在输入框内触发 PTT/调谐，避免打字时误发射。

4. 安全须知（请先阅读）

1. PTT 是「按住才发射」，没有任何自锁模式；松开即停。若页面或浏览器崩溃，服务端死手开关会在最后一个客户端断开时自动强制释放发射（TX0）。
2. TUNE 同理，长按出载波、松手即停——调谐时请确认天线已接好、SWR 正常，长时间发射前建议先用小功率。
3. 发射期间频谱暂停（FT-710 电台会干扰频谱数据流），瀑布图显示「TX 发射中 — 频谱暂停」是正常现象。IC-7300 使用 CI-V 0x27 频谱，发射期间通常继续刷新。
4. 无声（🔇）告警：状态栏出现红色「无声」表示 RX 音频流 20 秒全零——电台 USB 音频接口可能卡死，请重启电台或重插 USB 线。
5. 多人共用时，PTT 所有权按「最后按下者 + 同一登录令牌」仲裁（V2.1 修复）：别在别人发射时抢按。
6. 无线局域网内建议使用 HTTPS（自签名证书首次会有浏览器警告，属于预期行为）；http:// 明文下浏览器会禁用麦克风与音频工作线程（AudioWorklet），iPhone 上尤其如此。

5. 常见问题（FAQ）

附：界面元素与后台命令对照（供高级用户/排障）

文档维护：与 static/index.html、static/ft710_main.js、static/ft710_ui.js 保持一致；界面改动后请同步本指南与编号图。