README.md 5.9 KB

MicroLink Web Serial Terminal

一个基于Web Serial API的现代化串口终端应用,专为MicroLink设备设计,支持串口调试、烧录脚本下载、拖拽和离线脚本生成下载和实时变量分析等功能。

✨ 主要功能

🔌 串口通信

  • Web Serial API支持:现代浏览器原生串口访问
  • 多种显示模式:HEX和文本模式数据接收
  • 智能数据缓冲:优化大量数据的显示效果
  • ANSI转义序列支持:完整的颜色和格式支持

🖥️ 虚拟终端

  • 实时按键发送:所有按键实时发送到串口
  • 特殊按键支持:Tab、箭头键、Ctrl组合键等
  • ANSI序列处理:智能处理和显示ANSI颜色代码
  • 输入框自动清除:避免与远程回显重复
  • 命令历史:支持命令历史记录和回放

📡 MicroLink API

  • RTT调试功能:实时调试数据传输
  • SystemView性能分析:系统性能监控
  • Flash编程:固件下载和烧录
  • Ymodem文件传输:可靠的文件传输协议
  • 自定义命令:支持用户自定义命令

📊 变量分析

  • ELF文件解析:自动解析嵌入式可执行文件
  • 变量提取:从符号表中提取变量信息
  • 实时曲线绘制:多变量实时数据可视化
  • 内存映射:变量在内存中的分布展示
  • 数据采样:可配置的采样率和显示范围

🐍 Python脚本生成

  • 自动化脚本:图形化配置生成Python控制脚本
  • 一键下载:直接下载生成的脚本文件
  • 脚本传输:通过Ymodem协议传输脚本

📁 文件管理

  • 多文件配置:支持多个文件的批量处理
  • FLM文件处理:嵌入式Flash算法文件支持
  • 文件传输:通过Ymodem协议传输文件
  • 配置管理:参数保存和加载

🚀 快速开始

环境要求

  • 现代浏览器:Chrome 89+、Edge 89+、Opera 75+
  • HTTPS环境:Web Serial API需要安全上下文
  • MicroLink设备:支持的硬件设备

使用方式

  1. 打开文件

    • 打开index.html
  2. 连接设备

    • 点击"连接串口"按钮
    • 选择对应的串口设备
  3. 开始使用

    • 选择对应的页面
    • 使用相应的功能

📁 项目结构

microlink-web-terminal/
├── index.html                    # 主HTML文件
├── README.md                     # 项目说明文档
├── assets/                       # 资源文件夹
│   ├── style.css                # 样式文件 
│   ├── script.js                # JavaScript核心逻辑 
│   └── echarts.min.js           # ECharts本地图表库
└── config/                      # 配置文件夹
    └── microlink_web_scp.txt    # 默认配置文件

🎯 功能模块详解

1. 串口调试面板

  • 参数管理:保存、加载、重置串口参数
  • 自定义命令:添加常用命令到快捷列表
  • RTT控制:启动/停止RTT调试功能
  • SystemView控制:系统性能分析配置
  • FLM控制:Flash算法文件配置
  • 下载控制:固件文件下载配置

2. FLM配置面板

  • 文件上传:支持ELF文件拖拽上传
  • 解析显示:显示文件信息和符号表
  • 格式转换:将ELF文件转换为.o格式
  • Ymodem发送:通过串口发送文件到设备

3. Python脚本配置面板

  • 参数配置:设置脚本生成参数
  • 代码预览:实时预览生成的Python代码
  • 脚本下载:下载生成的Python脚本
  • Ymodem发送:直接发送脚本到设备

4. 变量分析面板

  • 文件解析:上传ELF文件并解析变量
  • 变量选择:选择需要监控的变量
  • 实时绘图:多变量实时数据曲线
  • 串口控制:配置数据采样参数

⚙️ 配置说明

-该功能是为了方便后续用户进行自定义配置,方便快速使用,目前尚未完全开发

RTT配置

# RTT调试参数
rtt_addr=0x20000000
rtt_size=0x4000
rtt_channel=0

SystemView配置

# SystemView参数
systemview_addr=0x20000000
systemview_size=0x4000
systemview_channel=1

🔧 高级功能

数据缓冲机制

  • 智能缓冲:根据数据特征自动调整缓冲策略
  • 分行超时:可配置的数据分行超时时间
  • 完整性检查:确保数据接收的完整性

ANSI序列支持

  • 颜色代码:支持16色、256色和RGB颜色
  • 控制序列:支持光标移动、清屏等操作
  • 格式保持:保持终端的原始格式

性能优化

  • Worker线程:图表数据处理使用Web Worker
  • 内存管理:智能内存使用和垃圾回收
  • 渲染优化:减少不必要的DOM操作

🌐 浏览器兼容性

Web Serial API支持

  • ✅ Chrome 89+
  • ✅ Edge 89+
  • ✅ Opera 75+
  • ❌ Firefox (不支持)
  • ❌ Safari (不支持)

File System Access API支持

  • ✅ Chrome 86+
  • ✅ Edge 86+
  • ✅ Opera 72+
  • ❌ Firefox (不支持)
  • ❌ Safari (不支持)

📝 使用技巧

基础操作

  1. 连接设备:确保设备已连接并选择正确串口
  2. 配置参数:根据设备要求设置波特率等参数
  3. 发送命令:在终端中输入命令或使用预设命令
  4. 查看数据:实时查看设备返回的数据

高级功能

  1. 变量分析:上传ELF文件分析变量结构
  2. 实时绘图:选择变量进行实时数据可视化
  3. 文件传输:使用Ymodem协议传输文件
  4. 脚本生成:生成Python自动化脚本

故障排除

  1. 连接失败:检查设备连接和串口权限
  2. 数据乱码:检查波特率设置是否正确
  3. 文件传输失败:确保设备支持Ymodem协议
  4. 图表不显示:检查变量选择和采样率设置

MicroLink Web Serial Terminal - 让嵌入式开发更简单、更高效!

更新日志 V1.0.1 -完成项目主要功能 -创建使用说明 -进行发布测试