RISC-V IDE MRS无感远程协助模块详解
一、说明
1.1 概述
针对RISC-V/ARM等内核MCU的嵌入式集成开发环境MRS(MounRiver Studio)从V1.90版本开始内置无感远程协助模块（Sensorless Remote Assistant Module，以下简称SRA模块）。SRA模块是一款支持远程下载、调试、串口数据回显等功能的集成开发环境综合单元，提供了局域网、广域网环境下的专业嵌入式开发协助解决方案。
在实际的嵌入式项目推进过程中，经常会出现目标设备已经部署到工作环境但运行结果与预期不同的问题。由于涉密或代码管控的限制，往往无法直接将目标源码发送到设备端进行远程调试，所以只能将设备寄回或安排开发者奔赴现场进行问题排查。而MRSSRA模块则适用于该硬件设备与软件代码相互隔离的场景，在保证涉密代码安全的同时，减少了项目落地过程中的时间、人力成本。
1.1.1 软硬件连接
SRA模块进行无感远程协助时,两台不同主机上的MRS分别作为近端(调试方)与远端(被调试方)。根据网络环境的差异，也分为局域网以及广域网无感远程协助模式。
1.1.2 运行环境
MRS版本V1.90及以上。
WCH-LinkE固件版本V2.10及以上。
计算机系统Win7及以上。
1.1.3 功能特点
相较于目前已有的远程桌面工具或集成开发环境自带的远程软件，MRS SRA模块有以下功能特点：
- 免网络设置:支持自适应网络模式,局域网、广域网下一键建立远程网络连接，无需网络配置。
- 防代码泄漏:支持工程源码与目标硬件存在空间隔离的远程调试场景，涉密代码无需发送到目标硬件连接的主机。
- 非独占操作:远程时不占用整个计算机操作权限，不影响被调试方使用MRS之外的其他软件。
- 集多重加密:使用IoCHub[注1]建立各网络环境下的点对点加密通信，配合WCH-LinkE进行目标代码加密烧录。
- 需操作授权:远端每次等待远程连接前，会实时生成唯一授权码，近端得到授权后才可以建立远程连接；远程下载、调试界面及操作与本地方式相同，兼容常规操作习惯。
注1: IoCHub是一种能自适应广域网、局域网的透明直传解决方案，仅需调用一套接口，就能让设备间实现高效、安全、稳定的点对点数据透传。MRS无感远程协助模块集成了IoCHub，通过其建立调试器软件的远程通信。在远程通信过程中IoCHub在远近端分别扮演调试器Client与调试器Server的角色。
1.1.4 应用场景
SRA模块支持远程下载、远程调试、远程IO信号控制、远程串口输出信息回显等功能，可应用于以下远程协助场景：
1.2 界面
SRA远程软件其整体界面如下，红框标记的分别为MRS中远程下载、远程调试以及SRA模块功能按钮。用户在远程协助时只用选择本机模式（调试方或被调试方），无需进行其他的网络配置。
未建立远程连接时,远程下载、远程调试按钮为灰化状态，此时只能进行本地下载、调试操作：
建立远程连接后,远程下载、远程调试按钮为使能状态，此时可以进行本地或远程下载、调试操作：
二、使用
2.1 建立SRA远程连接
在MRS的工具栏中点击无感远程协助按钮弹出远程软件界面，默认使用自适应网络模式，无需用户手动进行网络配置。远端用户只要点击开始远程调试按钮，将动态生成的远程授权码告知近端用户，等待近端与其建立远程连接即可。
2.2 执行SRA远程操作
2.2.1 远程下载
建立连接后，点击MRS界面的远程下载按钮，即可将近端编译生成的目标代码下载至远端设备，此时远端设备WCH-LinkE输出的信息将回显至MRS控制台。
2.2.2 远程调试
2.2.2.1 远程目标调试
SRA模块支持远程目标调试功能：近端用户将修改后编译生成的目标文件远程下载到目标芯片，然后根据远端回显的芯片运行时打印信息来调整近端源码，再重复上述下载、查看回显信息过程，直到确定最终的代码内容。
2.2.2.2 远程在线仿真
SRA模块也支持远程在线仿真功能：建立连接后，点击MRS界面的远程调试按钮，即可进行源码的远程在线仿真调试。整体操作与各项监控信息窗口与本地仿真调试无异，可以进行设断点、单步执行、全速执行、重新执行等操作。此时远端设备的调试信息仍会回显至近端。
2.2.3 远程IO控制
建立远程连接后，近端可以远程设置远端WCH-LinkE硬件的3.3v/5v引脚、RST引脚IO信号以及目标芯片的读保护状态。
2.2.4 远程串口回显
建立远程连接时，远端可以选择已连接的WCH-LinkE串口，将芯片串口TX引脚与WCH-LinkE RX引脚相连，再通过嵌入式代码将输出的打印信息流定向到该串口。
示例代码
__attribute__((used)) int _write(int fd, char *buf, int size)
{
int i;
for(i = 0; i < size; i++)
{
#if(DEBUG == DEBUG_UART1)
while(USART_GetFlagStatus(USART1, USART_FLAG_TC) == RESET);
USART_SendData(USART1, *buf++);
#elif(DEBUG == DEBUG_UART2)
while(USART_GetFlagStatus(USART2, USART_FLAG_TC) == RESET);
USART_SendData(USART2, *buf++);
#elif(DEBUG == DEBUG_UART3)
while(USART_GetFlagStatus(USART3, USART_FLAG_TC) == RESET);
USART_SendData(USART3, *buf++);
#endif
}
return size;
}
远程协助时，近端调试者可以在MRS控制台和远程软件输出框中查看目标硬件的串口输出内容。
2.3 断开SRA远程连接
建立远程连接后,近端调试者和远端被调试者都可以主动断开SRA远程连接。
2.4 用户意见在线反馈
用户可以通过MRS用户意见在线反馈功能，将文字、图片、压缩包文件等反馈内容实时发送到MRS技术支持邮箱。
