🌐 翻译
可通过 Google 翻译进行自动翻译：打开翻译版本。

UV Studio

UV Studio 是 UV-K1 和 UV-K5 V3 上兼容 F4HWN 固件的浏览器配套软件。它将实时显示和远程键盘功能、固件安装、无线电维护、多启动管理和实验室应用程序管理集成在一个界面中。

点击这里打开：

https://armel.github.io/uvstudio/

UV Studio 通过 Web Serial API 直接与无线电设备通信。无线电数据在浏览器本地处理；无需安装应用程序、服务器帐户或云端上传。

[!IMPORTANT] UV Studio 并非仅限于 Fusion 版本。其通用工具可与兼容的 F4HWN 版本配合使用，但某些视图需要特定的固件功能。特别是，叠加应用程序管理和外部闪存工具仅适用于实验室版本。

版本状态

UV Studio v1.6.0随稳定版固件v6.1.0 一同发布。除了 v6 固件目录、多启动槽位管理和版本化的官方应用目录外，它还新增了以下功能：

重新设计的界面，将校准备份/恢复和启动徽标下载/上传功能集中在一起。
兼容 Labs 版本的完整外部闪存备份和恢复 2 MiB
CRC32 校验和验证，实现更快、更安全的外部闪存恢复
指导用户恢复重建后的原厂外部闪存，并安装适用于 UV-K1 或 UV-K5 V3 的正确原厂固件

要求

你需要：

兼容PY32F071单片机的泉生UV-K1或UV-K5 V3
具备数据传输功能的USB-C接口或兼容的宝峰/建伍式双插孔USB转串口线缆
支持 Web Serial 的桌面浏览器，例如 Chrome、Brave、Edge、Opera 或 Firefox 151+

下载的完整 UV Studio 源代码树副本也可以在本地打开。它是一个静态 HTML/CSS/JavaScript 应用程序，无需构建步骤或本地 Web 服务器。

功能和无线电模式概述

工具	所需无线电状态	固件要求
实时查看器和实时射频日志	正常启动	兼容的查看器/射频日志支持
刷写固件	`DFU` / 刷写模式	UV-K1 或 UV-K5 V3 引导加载程序
校准、启动徽标、射频日志导出	正常启动	兼容 F4HWN 固件
固件插槽	正常启动	支持多系统启动 `v6.0.0` 或更新版本
应用	正常启动	支持叠加应用的实验室
外部闪存备份/恢复	正常启动	`v6.1.0` 具备外部闪存访问权限的实验室
恢复出厂设置	正常启动 Labs 系统，然后根据提示进入 DFU 模式	`v6.1.0` 第一阶段 Labs 系统

要进入DFU模式，请关闭收音机，按住PTT，然后在继续按住PTT的同时打开收音机。松开PTT，然后连接或重新连接数据线。无需使用侧键。

UV Studio 的功能

UV Studio 提供：

实时128x64无线电显示屏
虚拟 UV-K1 和 UV-K5 键盘，支持短按和长按
可拆卸键盘窗口和收音机重启控制
收音机屏幕截图和可调节液晶显示屏渲染
实时射频活动、会话标记、过滤器和分析
将存储的射频日志活动导出为 CSV 文件
可通过官方目录、滚动开发版本或本地 .bin 文件安装固件
直接下载与稳定版 F4HWN 固件匹配的 CHIRP 驱动程序
多启动固件插槽的安装、验证、命名、擦除和配置重置
从版本化的官方目录或本地 .app 文件安装和移除 Labs 叠加应用程序
校准备份和恢复
自定义启动徽标的下载、预览、转换和上传
外部闪存备份、恢复和引导式工厂软件恢复（v1.6.0）
提供浅色和深色主题，并支持十种语言翻译

UV Studio 全局占用串口连接。它防止两个操作同时使用该端口，并在兼容的普通模式工具之间切换时保持或重新建立连接。

实时查看器

实时查看器镜像收音机显示屏，并提供匹配的 UV-K1 和 UV-K5 虚拟键盘。

正常启动收音机。
将收音机连接到电脑。
打开 Live Viewer，选择合适的键盘，然后点击 Connect。
选择无线电串口。
使用虚拟键盘或电脑键盘。
在拔下电缆之前，点击Disconnect。

工具栏可以重启连接的收音机、截屏、更改模拟液晶显示屏的外观，以及将键盘分离成一个浮动窗口。内置的Help面板列出了所有键盘快捷键；常用控制包括用于导航的方向键、用于短按的数字键、Shift加一个键用于长按、Enter或M用于菜单、Esc用于退出，以及F1/F2用于侧边按钮。

[!IMPORTANT] 查看器控制无法启动传输。显示的PTT不可用，UV Studio不是远程传输工具。

射频日志

当运行的固件支持 RF Log 和 Viewer 桥接器时，UV Studio 会显示实时接收和发送会话：

方向、频率和信道信息
会话时长
接收信号电平或发射功率
电池电压
ALL、RX和TX 滤光片
活动、通话时长、频率、会话和电池分析

单独的工具Export RF Log会读取最新的512存储的活动和开机标记，并创建rf-log.csv。请将收音机保持在正常模式。如果频道名称或配置库信息有误，请更新到包含最新v6射频日志修复程序的固件版本。

刷写固件

[!WARNING] 刷入不兼容或损坏的镜像文件可能会导致收音机无法使用。请确认型号和引导程序兼容性，做好校准备份，并保持连接线直至操作完成。

固件目录按版本对当前稳定的 F4HWN 版本进行分组，包含滚动更新的 Fusion 开发版本，并且还可以提供兼容的官方镜像。如果目录无法加载或使用自定义版本，则本地的 .bin 文件仍然可用。

将收音机启动到DFU模式。
打开 Flash Firmware 。
选择正确的目录条目或选择兼容的本地 .bin 文件。
点击 Flash firmware 并选择串口。
等待进度操作完成，并等待收音机重新启动。

当选择稳定的 F4HWN 版本时，UV Studio 会提供为该固件版本发布的共享 CHIRP 驱动程序。滚动开发版本和标准版本则不使用此自动驱动程序链接。

固件插槽

所有四个官方版本v6.0.0均支持多系统启动。UV Studio管理外部闪存中的用户插槽1至4。受保护的备份Main由固件维护，并且有意不将其作为可写插槽公开。

安装其他版本：

正常启动支持多启动的无线电。
打开 Firmware Slots 并刷新表格。
从目录中选择兼容的稳定 v6.xF4HWN 图像或加载本地.bin 文件。
选择插槽 1至4，并可选择输入最多 15 个字符的显示名称。
选择 Write to slot，确认，然后等待擦除、写入和完整的 CRC 验证。

插槽目录有意排除了官方固件、v5 固件和滚动开发镜像，因为这些条目不能保证会返回到多启动选择器中。

每个已安装设备的插槽都有两个独立的维护操作：

Erase FW 删除已存储的固件映像，但不会重置该插槽的配置库。
Reset config 删除与该插槽关联的通道和设置库，但保留其固件映像。

请参阅 Multiboot 和 Multiconfig 以了解 Main 插槽选择、配置库、SetCfg 和恢复行为。

应用（实验室）

Apps 视图管理 Labs 版本中的八个实验性叠加应用程序插槽。

正常启动实验室并打开Apps。
刷新应用插槽表。
选择固件版本，然后从其版本目录中选择官方应用程序；或者，加载本地 .app 文件。
选择目标插槽并选择Install app。
在收音机上，使用F + 7，选择应用程序，然后按M。

UV Studio 会显示应用程序名称、版本、大小和验证状态。删除应用程序只会清除该应用程序槽位中的数据。

[!IMPORTANT] 覆盖层应用程序与固件的 ABI、API 级别、RAM 地址和功能相关。请选择与已安装固件匹配的应用程序目录版本。固件更新后，如有需要，请重新安装兼容的应用程序。

有关加载器兼容性，请参阅 Overlay apps，有关每个应用程序的用途和控制，请参阅 Overlay applications。

选择合适的备份或副本

这些操作保护或复制的是收音机的不同部件，它们之间不能互换：

操作方法	包含内容	最佳用途	校准特性
UV Studio `Calibration`	设备专用射频和硬件校准	单个无线电的基本安全备份	明确读取或恢复校准；仅与同一台无线电一起使用
CHIRP 无线电映像	该驱动程序版本支持的频道和设置	编辑和迁移存储器/设置	不能替代校准备份
UV Studio `External Flash`	原始`2 MiB` 外部闪存映像，包括备份文件中的配置、插槽、应用程序、日志、徽标和校准数据	完整的文件备份和恢复	恢复过程中会特意保留目标无线电上已有的校准数据
AirCopy 内存或 `Settings`	选定的内存库和/或兼容的无线电设置	在两个无线电之间同步选定的数据	不复制硬件校准
AirCopy `Flash 2M`	通过电缆直接克隆外部闪存	使另一台无线电的共享外部闪存状态与源状态匹配	排除并保留目标无线电的校准扇区

对于常规升级，至少要制作一份校准备份和一个 CHIRP 镜像。在尝试多重启动、应用槽、恢复出厂设置或底层存储等操作之前，请使用完整的外部闪存备份。

外部闪存备份和恢复 (v1.6.0)

此工具需要 v6.1.0 Labs 提供的外部 Flash 命令。v6.0.0 中不提供此功能。

External Flash视图通过物理地址读取或恢复完整的2 MiB PY25Q16外部SPI Flash。这包括配置库、固件插槽、应用程序插槽、射频日志、多重启动状态、启动徽标和其他共享数据。

备份

正常启动兼容的 Labs 构建。
打开 External Flash并选择Back up 。
点击Read external flash并选择串口。
等待芯片完全读取完毕；这可能需要几分钟时间。
下载 external-flash.bin 。

备份文件编号为2 MiB。请妥善保管：其中包含无线电配置和设备特定的校准数据。

恢复

正常启动兼容的 Labs 构建。
打开 External Flash并选择Restore 。
选择此工具创建的完整备份 2 MiB。
点击Restore external flash并确认破坏性操作。
保持无线电通电并连接，直到验证完成且无线电重新启动。

UV Studio 拒绝非 2 MiB格式的文件。它以4 KiB 为单位逐扇区进行处理，并且从不擦除或写入设备特定的校准扇区。在当前固件中，它会比较 CRC32 值，跳过已相同的扇区，仅写入剩余的扇区，并对每个扇区进行验证。当 CRC 校验命令不可用时，它会回退到直接字节比较。

[!WARNING] 恢复操作会替换几乎所有外部闪存内容，包括设置、日志、徽标、应用程序、固件插槽和多重启动状态。接收无线电的校准扇区会被保留，因此无法通过对一台无线电进行完整备份来将该无线电的校准信息复制到另一台无线电。

要直接通过无线电对无线电复制外部闪存，请参阅 AirCopy 中的单独电缆 Flash 2M 功能。

工厂软件恢复（v1.6.0）

Factory reset视图是一种引导式两阶段恢复方法，用于将UV-K1或UV-K5 V3恢复到与泉生软件匹配的状态：

正常启动 v6.1.0 实验室。
打开 Factory reset 并选择确切型号：UV-K1或UV-K5 V3 。
确认警告。UV Studio 会加载匹配的重建工厂外部闪存映像和官方固件，然后在写入任何内容之前验证它们的大小和 SHA-256 值。
UV Studio 恢复并验证外部闪存，同时保留设备特定的校准扇区。
出现提示时，关闭收音机并进入DFU模式。在这两个阶段之间，请勿正常启动收音机。
选择 Continue in DFU；UV Studio 会自动安装匹配的官方固件。

捆绑的原厂固件版本为 UV-K1 v7.03.01和 UV-K5 V3v7.00.11 。

[!WARNING] 这是一个破坏性的软件恢复操作。它会移除 F4HWN 设置、多启动状态、固件插槽、叠加应用、射频日志和自定义徽标。外部镜像文件是重建的出厂状态，并非未经修改的物理镜像。请选择正确的型号，并且不要中断任何步骤。

校准

校准是针对特定设备的。在进行固件实验或底层维护之前，请创建备份，并将文件命名为无线电型号或序列号，以避免不同设备的备份混淆。

为了佐证这一点：

正常启动收音机。
打开 Calibration并选择Back up 。
点击Read calibration data。
下载 calibration.dat 。

要恢复它：

正常启动收音机。
打开 Calibration并选择Restore 。
选择其 calibration.dat 文件。
点击Restore calibration data并等待完成。

[!WARNING] 除非您完全了解后果，否则请仅恢复该收音机的校准数据。

启动标志

兼容的版本可以在启动时或作为屏幕保护程序使用自定义的128x64单色图像。

上传徽标：

正常启动收音机。
打开 Boot Logo并选择Upload 。
选择PNG、JPEG或BMP等常用格式的图像。
在查看预览的同时调整 Threshold和Invert colors。
选择 Upload logo to radio 。
在 POnMsg中选择LOGO，或在 SetSav 中选择兼容的徽标模式。

Download选项卡读取当前图像，预览它，并将其保存为logo.png 。

故障排除

如果 UV Studio 无法与无线电通信：

确认所选操作使用正确的正常启动模式或 DFU 启动模式
断开电缆，在该模式下重启收音机，重新连接电缆，然后再次选择串口。
关闭可能占用串口的其他程序或浏览器标签页
确认电缆传输数据且已完全插入
使用能够提供所需功能的固件版本。
对于应用程序或外部闪存，请检查运行的是 Labs 而不是 Fusion、FieldOps 或 Transfer。

可扩展的 Console 记录协议和操作详情，可以帮助识别不支持的命令、超时、验证失败或错误的文件。

GLOBALIS Ⓖ co-founder/CTO

Web, Security, Performance, Apple  Addict, Geek Life, Astronomy, Arduino, M5Stack, ESP32, Ham Radio Operator F4HWN & RRF Admin, Nature, Fly Fishing and more.