RT-Thread 的灵魂伴侣 | 技术集结
RT-Thread正式启动硬件产品生态共建计划"你有创意，我帮你推广"，我们寻找那些藏在工作台、实验室和创客空间的嵌入式硬件创意——无论是一块开发板、一个智能工具，还是一套完整的解决方案。我们诚挚邀请社区开发者、创客和硬件公司，将您的创意原型带到RT-Thread生态，也欢迎已有成熟产品直接入驻！！欢迎加入我们的硬件生态计划，可发送作品(建议包含：产品介绍、演示视频/图片、技术亮点、您的介绍)邮件至hardware@rt-thread.com。
今天给大家介绍一下MicroKeen（MKLink）的使用方法，以下来自MKLink创作者的作品内容，欢迎支持！
一、下载口也可以同时当串口用会有多爽
二、SEGGER RTT+MKLink，让串口调试真正自由
在嵌入式开发中，我们总是离不开“串口打印”来调试。
但传统串口调试存在很多明显的痛点：
- 速度慢：输出数据卡顿，占用CPU时间，不能在中断中使用；
- 硬件占用：需要额外占用 MCU 的 UART 接口资源；
- 接线麻烦：需要 USB 转串口工具 + 杜邦线接线，步骤繁琐；
- 资源受限：串口数量有限，调试与功能常常冲突。
如何打破这些痛点？
SEGGER RTT + MKLink完美结合了双方的优势：
- SEGGER RTT：提供高速、非侵入式的数据传输；
- MKLink：将 RTT 通道虚拟为标准 USB CDC 串口，不再占用 MCU 的串口！
让调试既拥有 RTT 的性能，又能使用任意串口助手，真正做到“即插即用，自由畅快”！
三、一分钟了解 SEGGER RTT 是什么、怎么用
1、SEGGER RTT是什么？
RTT，全称Real Time Transfer（实时传输），是一种无需中断 MCU 程序执行，就能实现数据与主机交互的调试技术。
它使用一种内存共享机制，将 MCU 内部的数据实时“搬运”到 PC 上。
形象理解：
就像你在 MCU 的 RAM 里放了个“邮箱”，PC 随时来收信，MCU 照常干活，互不打扰。
2、SEGGER RTT 的基本工作原理
在 MCU RAM 中，有一个非常重要的结构体：
_SEGGER_RTT 控制块
它的作用是：
- 保存多个UpBuffer（MCU PC）和DownBuffer（PC MCU）的信息；
- 包括每个缓冲区的起始地址、大小、写指针、读指针等。
收发数据过程：
- MCU发送数据➔ 把数据memcpy拷贝到UpBuffer的空闲区域；
- PC接收数据➔ 通过MKLink 读取 UpBuffer 的数据；
- PC发送指令➔ 通过MKLink 把数据写入 DownBuffer；
- MCU读取指令➔ 从 DownBuffer 中memcpy出来。
由于只是内存拷贝，整个收发过程极快，微秒级完成，不会打断 MCU 正常工作。
3、SEGGER RTT怎么用？
只需简单三步：
步骤一：集成 RTT 源码
从 SEGGER J-Link 安装目录Samples/RTT复制以下文件到工程中，并添加头文件路径。
如我电脑上的路径：
C:\Program Files (x86)\SEGGER\JLink_V632f\Samples\RTT
步骤二：输出日志到 RTT
#include"SEGGER_RTT.h"
intmain(void)
{
SEGGER_RTT_Init();
SEGGER_RTT_printf(0,"hello RTT\n");
while(1){
}
}
步骤三：连接调试工具
- 如果使用传统 J-Link，只能用 RTT Viewer 上位机；
- 如果用 MKLink ，可以用任意串口助手直接访问 RTT 数据！
四、MKLink ：释放 SEGGER RTT的真正威力
MKLink突破传统，打通了 RTT 和通用串口调试工具之间的隔阂，直接把 RTT 数据转发到USB CDC 虚拟串口，让 MCU 仿佛接了一个超级快的“软串口”！
MCU端：
- 继续使用 RTT 库发送日志，不需要改变一行代码。
MKLink端：
- 通过 USB CDC 映射成标准串口；
- 自动扫描 MCU 内存中_SEGGER_RTT控制块地址（如 0x20000000）；
- 直接读写 UpBuffer / DownBuffer；
- 完美支持双向通信！
PC端：
- 用你最喜欢的串口助手直接连 MKLink串口，爽快收发！
MKLink 数据流示意图：
效果总结：
- 不再局限于官方 Viewer；
- 不再受限于波特率；
- 不再需要额外串口硬件和线缆；
- 打开任意串口助手即用，极致灵活！
五、多种使用 SEGGER RTT 功能的方法
1、如何开启MKLink的SEGGER RTT功能
步骤一：找到MKLink 的 USB CDC 虚拟串口
使用USB TypeC数据线与MKLink连接以后，电脑设备端会弹出三个设备：
V2和V3会弹出两个USB串行设备端口号，分别是USB转串口和虚拟串口
V4会弹出三个USB串行设备端口号，分别是USB转串口、USB转485端口和虚拟串口
打开虚拟串口后，下载器会自动打印如下信息：
V4版本可以通过屏幕界面，来高速你打开的是什么端口，分别打开三个串口号，效果如下:
步骤二：使用串口助手类工具访问 MKLink 的 USB CDC 虚拟串口
比如使用SSCOM，连接MicroLink的串口，输入以下指令：
RTTView.start(0x20000000,1024,0)
- 0x20000000:搜索RTT控制块的起始地址；
- 1024：搜寻范围大小；
- 0：启动RTT的通道。
_SEGGER_RTT控制块地址可以通过查看MDK编译生成的.map文件来查找，如下：
可知，_SEGGER_RTT在地址0x20000040处，可以通过设置搜寻的地址和大小来重新启动MicroLink的RTT功能。
2、固定_SEGGER_RTT的地址的方法
步骤一：打开SEGGER_RTT.c，添加红框中的代码，宏SEGGER_RTT_OPS_ADDR可以将_SEGGER_RTT的地址固定在0x20000000
代码如下，方便直接复制：
#defineSEGGER_RTT_OPS_ADDR 0X20000200
#define__ARM_AT(x)".ARM.__at_"#x
#defineARM_AT(x) __ARM_AT(x)
#ifdefined(__CC_ARM) // ARM Compiler 5 (AC5)
#defineSEGGER_RTT_SECTION __attribute__((at(BOOT_FLASH_OPS_ADDR)))
#elifdefined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6000000) // ARM Compiler 6 (AC6)
#defineSEGGER_RTT_SECTION __attribute__((section(ARM_AT(SEGGER_RTT_OPS_ADDR))))
#elifdefined(__GNUC__) // GCC
#defineSEGGER_RTT_SECTION __attribute__((section(".segger_rtt_ops"), used, aligned(4)))
#else
#defineSEGGER_RTT_SECTION
#endif
SEGGER_RTT_SECTION
SEGGER_RTT_PUT_CB_SECTION(SEGGER_RTT_CB_ALIGN(SEGGER_RTT_CB _SEGGER_RTT));
3、上电自动开启SEGGER_RTT功能的方法
步骤一：打开U盘中python文件夹下的default_config.py,添加红框中的代码，下载器上电会自动执行default_config.py脚本。
4、MDK中将printf重定向到SEGGER_RTT通道的方法
步骤一：RTE配置
1.打开RTE 配置窗口（菜单：Project -> Manage -> Run-Time Environment）。
2.勾选以下选项：
- 在CMSIS-Compiler下勾选CORE；
- 在STDOUT(API)下勾选Custom；
如果你在RTE中找不到CMSIS-Compiler，说明你的MDK版本较低——如果不想升级MDK，则可以通过下面的链接从官方直接下载对应的cmsis-pack：
https://www.keil.arm.com/packs/cmsis-compiler-arm/
或者老版本的cmsis-pack中，找到Compiler：
步骤二：添加stdout_putchar()
在代码中实现stdout_putchar()函数——用它来把printf重定向到RTT通道：
intstdout_putchar(intch)
{
SEGGER_RTT_PutChar(0, ch);
returnch;
}
5、将 RT-Thread 系统命令行重定向到RTT通道的方法
方法一：安装SEGGER_RTT软件包
SEGGER_RTT软件包是将 RT-Thread 的msh重定向到SEGGER RTT
方法二：安装agile_console软件包
agile_console软件包可以将 RT-Thread 的msh重定向到多个端口，比如可以不影响原先uart打印的基础上，再增加一路RTT端口，比较适合两种方式需要同时使用的场景。
步骤一：安装软件包
步骤二：单片机添加SEGGER_RTT源码
从 SEGGER J-Link 安装目录Samples/RTT复制以下文件到工程中，并添加头文件路径。
如我电脑上的路径：
C:\Program Files (x86)\SEGGER\JLink_V632f\Samples\RTT
步骤三：单片机添加agile软件包的适配代码
添加一个agile_console_rtt_be.c文件，代码如下：
#include
#include
#include"SEGGER_RTT.h"
staticstructagile_console_backend_console_backend= {0};
staticvoidrtt_backend_output(rt_device_tdev,constuint8_t*buf,intlen)
{
SEGGER_RTT_Write(0,buf,len);
}
staticintrtt_backend_read(rt_device_tdev,uint8_t*buf,intlen)
{
return SEGGER_RTT_Read(0,buf, len);
}
staticvoidsegger_rtt_check(void)
{
while(SEGGER_RTT_HasKey())
{
agile_console_wakeup();
}
}
staticintagile_console_rtt_init(void)
{
SEGGER_RTT_Init();
rt_thread_idle_sethook(segger_rtt_check);
_console_backend.output = rtt_backend_output;
_console_backend.read = rtt_backend_read;
agile_console_backend_register(&_console_backend);
return0;
}
INIT_BOARD_EXPORT(agile_console_rtt_init);
六、用户真实评价
-
硬件
+关注
关注
12文章
3626浏览量
69160 -
串口
+关注
关注
15文章
1626浏览量
83307 -
实时传输
+关注
关注
0文章
14浏览量
6765 -
RT-Thread
+关注
关注
32文章
1636浏览量
45190
发布评论请先 登录
RT-Thread Vector软件包：嵌入式开发的动态数组容器 | 技术集结
RT-Thread编程指南
RT-Thread全球技术大会：RT-Thread开源重塑软件发展新生态
RT-Thread全球技术大会：萤石研发团队使用RT-Thread的技术挑战
2022 RT-Thread全球技术大会：萤石EZIOT SDK对RT-Thread的支持
RT-Thread全球技术大会：RT-Thread Smart更好的兼容Linux生态
RT-Thread全球技术大会：Kconfig在RT-Thread中的工作机制
RT-Thread全球技术大会：在RT-Thread上编写测试用例
RT-Thread全球技术大会：RT-Thread测试用例集合案例
RT-Thread全球技术大会：RT-Thread对POSIX的实现情况介绍
RT-Thread学习笔记 RT-Thread的架构概述
RT-Thread文档_RT-Thread 潘多拉 STM32L475 上手指南
评论