Merge pull request #358 from COOLINGXIZHOU/user

针对于MicroLink的网页端助手

Author: pikasTech

bsp/MicroLink-web-assistant/README.md

@@ -0,0 +1,186 @@
+# 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配置
+```ini
+# RTT调试参数
+rtt_addr=0x20000000
+rtt_size=0x4000
+rtt_channel=0
+```
+
+### SystemView配置
+```ini
+# 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
+-完成项目主要功能
+-创建使用说明
+-进行发布测试