MicroLink¶

一、产品概述¶

MicroLink是一款集多功能于一体的嵌入式系统开发工具，专为加速和简化开发者在研发、调试、量产和售后服务各阶段的工作流程而设计。不同于传统的开发工具链，MicroLink在DAPLink的基础上将调试器、USB转串口、离线下载器和固件升级工具等多种功能集成到一个设备中，为开发者提供一站式解决方案。无论您是下载固件、调试代码、批量生产还是固件升级，MicroLink都能满足您的需求，大大提升开发效率，减少工具切换带来的时间和财务成本。

产品特点¶

结合以上产品特点，为开发者提供了下载调试，批量生产，售后维护，固件升级等一站式解决方案。

源码地址¶

github链接：https://github.com/Aladdin-Wang/MicroLink

购买地址¶

淘宝链接：https://item.taobao.com/item.htm?ft=t&id=895964393739

SJTB

二、功能介绍¶

1、DAPLink 在线下载和调试¶

MicroLink基于标准的CMSIS-DAP在线调试下载协议，针对传统DAPLink工具下载和调试速度缓慢的问题进行了全面优化。为了弥补DAPLINK性能上的不足，硬件方面，采用了先辑半导体的高性能HPM5301芯片，该芯片主频高达480MHz，内置PHY的高速USB接口；软件方面，将USB协议替换为传输速度更快的CherryUSB协议栈，并且对DAPLink固件中的数据处理和通信代码进行了深度优化，减少了内部延迟和等待时间，将SWD时钟速度提升至10MHz。

高速SWD支持高达10MHz的稳定时钟频率，为资源有限的嵌入式设备提供快速、可靠的单线调试和下载体验。

下载过程中CLK的时钟波形：

下载速度对比测试

与目前市面上最新的J-LINK-V12速度对比，目标芯片使用STM32H743，开发环境MDK V5.39，分别使用MicroLink和Jlink V12将2558KB的HEX文件下载到内部FLASH中。使用逻辑分析仪测试时钟引脚，计算出擦除，编程，校验全过程的时间，MicroLink使用时间为24.205秒，Jlink V12使用时间为33.439秒，测试数据如下图：

Jlink V12测试结果：

MicroLink测试结果：

测试结果对比：

调试器	总耗时（擦除，编程，校验）
MicroLink	24.205秒
J-LINK V12	33.439秒

2、USB转串口¶

MicroLink内置USB转串口功能，支持常见的串口和485通信，串口最大支持10M波特率，无丢包。

使用逻辑分析仪抓取波形如图所示，每个bit传输的时间为1/10M=100ns。

3、RTT¶

只要拥有了MicroLink，你就可以享受以下的便利：

无需占用USART或者USB转串口工具，将printf重定位到一个由MicroLink提供的虚拟串口上；
不需要使用专门的RTTView上位机，支持任意串口助手；
高速通信，不影响芯片的实时响应。

启动RTT功能：打开任意串口助手，输入以下指令：

RTTView.start(0x20000000,1024,0)

0x20000000:搜索RTT控制块的起始地址；
1024：搜寻RTT控制块地址范围大小
0: RTT通道

以SSCOM串口助手为例：

4、SystemView¶

MicroLink 加入了 SEGGER SystemView 协议支持，让你可以在无需额外硬件的情况下，轻松进行任务级别的运行态分析与可视化调试。

MicroLink 会将目标设备中 RTOS（如 RT-Thread、FreeRTOS）产生的 SystemView 日志数据通过 RTT 协议采集，并通过 USB CDC 虚拟串口转发给 PC。

启动SystemView 功能：打开任意串口助手，输入以下指令：

SystemView.start(0x20000000,1024,1)

0x20000000:搜索RTT控制块的起始地址；
1024：搜寻RTT控制块地址范围大小
1：SystemView使用RTT的通道

📌 示例画面：

5、脱机下载¶

MicroLink支持脱机离线下载的功能，借助于强大的PikaPython开源项目，让MicroLink可以使用python脚本进行二次开发，可以非常容易得定制升级流程。

MicroLink的虚拟U盘中有一个offline_download.py文件，内容如下：

import FLMConfig
import PikaStdLib
import PikaStdDevice
import time

time = PikaStdDevice.Time()
buzzer = PikaStdDevice.GPIO()
buzzer.setPin('PA4') # 蜂鸣器
buzzer.setMode('out')

ReadFlm = FLMConfig.ReadFlm()
# 加载第一个 FLM 下载算法文件
result = ReadFlm.load("STM32/STM32F7x_1024.FLM.o", 0x08000000, 0x20000000)
if result != 0:
    return 

# 烧写 boot.bin和rtthread.bin
result = load.bin("boot.bin", 0x08000000,"rtthread.bin", 0x08020000)
if result != 0:
    return 

# 加载外部 Flash 的 FLM 下载算法文件
result = ReadFlm.load("STM32F767_W25QXX.FLM.o", 0x90000000, 0x20000000)
if result != 0:
    return 

# 烧写 HZK.bin
result = load.bin("HZK.bin", 0x90000000)
if result != 0:
    return 
# 蜂鸣器响一声，表示烧写完成
buzzer.enable()
buzzer.high()
time.sleep_ms(500)
buzzer.low()
time.sleep_ms(500)

该代码通过加载FLM算法文件，将多个二进制文件（如boot.bin、rtthread.bin和HZK.bin）分别烧录到STM32内部和外部Flash中，并通过蜂鸣器响声提示烧录完成。

注意：请根据您的实际项目需求，修改以下内容：

下载算法文件名称（如 "STM32/STM32F7x_1024.FLM.o" 和 "STM32F767_W25QXX.FLM.o"）：应替换为对应芯片和Flash型号的 FLM 文件。

BIN 文件名称及地址（如 "boot.bin"、"rtthread.bin"、"HZK.bin" 及其对应的地址）：请确保文件名和烧录地址与您的程序结构一致。

若文件名或地址设置不当，可能导致程序无法正常运行或烧录失败。

🚀 触发烧录的方式

MicroLink 下载器支持以下两种方式触发脱机烧录脚本的执行：

按键触发 按下 MicroLink 脱机下载扩展板上的按键，即可启动脱机烧录流程并执行该脚本。

Python 虚拟终端手动触发

使用一个串口助手，连接虚拟串口端口，输入load.offline()加回车，效果如下：

6、拖拽下载¶

MicroLink支持任意Cotex-M内核芯片的U盘拖拽下载功能，使固件更新变得像复制文件一样简单。用户只需将固件文件拖放到虚拟U盘中，MicroLink便能自动完成下载，摆脱对上位机的依赖，极大地降低了操作门槛。

U盘拖拽下载支持BIN文件，BIN文件的下载地址可以通过drag_download.py脚本进行配置。

打开U盘内的drag_download.py脚本，代码如下所示：

import FLMConfig
ReadFlm = FLMConfig.ReadFlm()
res1 = ReadFlm.load("STM32/STM32F10x_512.FLM.o",0X08000000,0x20000000)

ReadFlm.load函数的三个参数：

"STM32/STM32F10x_512.FLM.o" ：选择对应单片机的下载算法文件；

0X08000000：默认U盘拖拽下载的FLASH位置；
0x20000000：单片机的RAM基地址；

7、内置Ymodem协议下载¶

MicroLink内置Ymodem协议，支持通过串口进行可靠的文件传输。ymodem协议在多次重传时仍能保持数据的完整性，非常适用于嵌入式系统的固件升级。

使用内置的ymodem协议发送文件，首先需要目标设备支持ymodem协议接收文件，MicorBoot开源框架集成了ymodem模块，可以方便用户直接安装使用，具体使用方法请看MicorBoot简介。

MicroBoot简介：https://microboot.readthedocs.io/zh-cn/latest/

MicroBoot开源代码：https://github.com/Aladdin-Wang/MicroBoot

将需要升级的固件拷贝到U盘中，比如updata.bin，然后随便使用一个串口助手，打开虚拟串口，输入ym.send("updata.bin")加回车

参数的含义：

"updata.bin"：下载的文件名字；
支持多个参数，多个文件连续发送；

如果你的bootloader中还没有ymodem协议，可以使用xshell等待ymodem接收协议的上位机，进行快速验证，演示视频如下，使用MicroLink和另外一个串口工具，分别使用sscom5上位机输入命令和xshell上位机进行文件接收

8、FLM通用下载算法转换工具¶

以STM32F4xx_1024.FLM为例，下载算法在ARM CMSIS Pack文件夹（通常在D:\Users\Administrator\AppData\Local\Arm\Packs\Keil\STM32F4xx_DFP\2.15.0\CMSIS\Flash）中，通过FLM下载算法转换工具打开文件，可以生成对应的下载算法驱动文件，将生成的STM32F4xx_512.FLM.o文件，拷贝到MicroLink的U盘中，然后通过flm_config.py脚本指定使用此下载算法文件。

借助单片机原厂提供的FLM下载算法文件，便可以几乎适配所有的Cortex-M系列单片机。

9、固件升级¶

MicroLink支持系统固件升级，可以为后续添加更多的功能，升级方式非常简单，只需要将microlink.rbl升级包，复制到MicroLink的U盘中即可自动完成升级，升级完成后会自动重启设备，并删除升级包。升级完成可以查看version.txt文件，了解升级后的新功能。

⚠️ 需要注意的是，升级前先格式化U盘，然后再把升级固件复制到U盘，如果Microlink没有自动重启升级，请手动重新上电。

开发资料下载地址：https://pan.baidu.com/s/1Dr8Ss16cBRWXtQpyOGrROg?pwd=zyo0

三、使用说明¶

1、U盘文件说明¶

Version.txt

Version.txt记录了MicroLink软硬件版本和每次版本更新的内容。

Help.htm

Help.htm是一个在线文档的网址链接，双击该文件即可访问在线文档，进一步了解更多的功能。

拖拽下载脚本drag_download.py

设备上电会首先读取drag_download.py脚本，根据脚本内容加载Flash下载算法，执行用户指令。

脱机下载脚本offline_download.py

根据脚本，执行脱机下载流程。

xxx.FLM.o

借助单片机厂家提供的pack包里的xxx.FLM下载算法文件，提取出擦写函数，生成xxx.FLM.o文件。

比如STM32F1系列的下载算法所在的电脑默认位置如下：

2、引脚说明¶

引脚名称	功能
5V	5V电源输出
3.3V	3.3V电源输出
GND	GND公共地
DIO/TMS	SWD接口数据信号，或JTAG接口模式选择
CLK/TCK	SWD接口时钟信号，或JTAG接口时钟
TDO	JTAG接口数据输出
TDI	JTAG接口数据输入
RX/A	串口数据接收，或者485接口A
TX/B	串口数据发生，或者485接口B
RST	复位脚输出