HSLink

📖 项目介绍

HSLink Nexus是HSLink系列产品的上位机，用于与HSLink硬件进行通信和控制。该项目提供了完整的上位机产品需求文档和通信协议规范。

🖥️ 上位机界面需求

界面风格建议偏向Fluent风格。

设备选择栏

该信息栏除了设置/关于页面之外，其他页面均需要显示：

• 选择设备下拉栏
• 连接/断开按钮

需要显示的设备信息有：

• 设备序列号
• 设备型号
• 设备版本
• 设备Bootloader版本
• 设备硬件版本
• 设备昵称（如有）

软件功能页面

1. 设备设置

设置项包括：

• 是否开启速度Boost模式（x10）
• SWD输出模式选择：
  • SPI模拟
  • GPIO模拟

  注意：IO模拟速度可能达不到设定值；SPI模拟可能存在兼容性问题

• JTAG输出模式选择：
  • SPI模拟
  • GPIO模拟

  注意：同上

• 上电输出设置：
  • 是否开启输出
  • 默认Vref电平设置
  • 是否默认打开电源输出
  • 是否默认打开端口输出
• 默认复位方式（可多选）：
  • NRST输出
  • 电源复位（POR）
  • Arm SWD软复位
• RGB LED设置：
  • 是否启用
  • LED亮度调节

在设备设置页面中，需要有一个保存按钮。未连接设备时该按钮不可点击，显示默认设置。连接设备后，会自动读取设备的设置并显示在界面上。

2. 设备升级页

• 选择升级类型：
  • 升级APP
  • 升级Bootloader

  注意：如果选择uf2文件，将强制修改为升级APP

• 文件选择区
• 开始升级按钮
• 升级进度条
• 固件信息显示区

3. 烧录页面（可选功能）

该页面用于为其它MCU提供友好的烧录界面，可作为后续开发计划。

4. 设置/关于页面

• 主题选择：
  • 暗色
  • 亮色
  • 跟随系统
• 语言选择：
  • 中文
  • 英文
  • 跟随系统
• 软件版本信息
• 贡献者列表
• 开源协议信息

📡 通信协议

HSLink上位机与下位机之间通过HID进行通信，实现设备信息获取、配置设置、固件升级等功能。

完整的通信协议规范请参考 通信协议文档，其中包含：

• 通信基本机制
• 各类消息的JSON格式定义
• 请求与响应示例
• 固件升级流程说明

📄 许可证

本项目采用 CC-BY-SA 许可证。

您可以：

• 共享 — 在任何媒介以任何形式复制、发行本作品
• 演绎 — 修改、转换或以本作品为基础进行创作

惟须遵守下列条件：

• 署名 — 您必须给出适当的署名，提供指向本许可协议的链接，同时标明是否对原始作品作了修改
• 相同方式共享 — 如果您再混合、转换或者基于本作品进行创作，您必须基于与原先许可协议相同的条款分发您的作品

© 2025 HSLink团队 版权所有。保留所有权利。