README.md · JefferyZh/SerialGenius

# 说明

其中SerialGenius为在64位windows上直接打包好的可执行文件，你可以先下载使用。

其他的一些说明参照：[http://www.eamonning.com/project/view/7](http://www.eamonning.com/project/view/7)

# 综述

SerialGenius是为嵌入式开发人员编写用于串口调试的工具，包含了不同的面板模块，可选择使用指定模块，最多可统一界面显示4个不同模块，通过不同的模块的功能组合，为程序开发人员提供在线调试信息。

各模块的不同组合，为您提供了更加方便快捷的调试界面，软件整体界面如下：

![](http://doc.tecmz.com/data/image/201508/30/66555_yjrX_3350.png)

# 模块

## 接收模块

![](http://doc.tecmz.com/data/image/201508/30/66579_RisL_7578.png)

**模块名称：**

接收

**模块介绍**

用于显示接收到的数据

**帮助**

1数据显示分为ASCII模式和十六进制显示模式

2保存数据用于将当前接收区域的数据保存至软件根目录中，文件名为：`Receive_[年月日]_[时]_[分]_[秒].txt`

## 发送模块

![](http://doc.tecmz.com/data/image/201508/30/66972_Sjzn_5352.png)

**模块名称**

发送模块

**模块介绍**

主要用于发送数据

**使用帮助**

1. 发送数据有两个缓冲区：ASCII字符发送缓冲区和十六进制格式发送缓冲区，使用复选框“十六进制格式”可以切换发送缓冲区；
2. “发送新行”复选框用于在使用ASCII缓冲区发送模式下，是否在发送的文件最后添加`\n`字符；
1. “选择文件”按钮用于选择需要发送的二进制文件，该文件会自动加载至十六进制格式发送缓冲区；
1. “定时发送”复选框用于是否启用定时发送数据，其后的文本框用于填写定时发送时间间隔，单位MS；

## 超级终端模块

![](http://doc.tecmz.com/data/image/201508/30/67266_wyWC_4900.png)

**模块名称**

超级终端

**模块介绍**

用于模拟超级终端

**使用帮助**

1. “保存数据”用于将当前接收区域的数据保存至软件根目录中，文件名为：`Receive_[年月日]_[时]_[分]_[秒].txt`
1. “同时发送换行符”复选框的作用是，在超级终端的末行输入字符串并点击回车时是否同时发送换行符；
1. 编码方式是选择超级终端接收到的字符的显示编码，目前支持“ASCII编码”、“UTF8编码”和“GBK编码”；

## 变量助手模块

![](http://doc.tecmz.com/data/image/201508/30/67093_Huzk_6444.png)

**模块名称**

变量助手

**模块介绍**

用于方便调试变量

**使用帮助**

1. “十六进制显示”复选框改变用于变量的显示格式；
1. 具体变量发送的协议请参阅“高级发送协议”章节；

## 变量跟踪模块

![](http://doc.tecmz.com/data/image/201508/30/67435_dmQX_9867.png)

**模块名称**

变量跟踪

**模块介绍**

用于方便跟踪一个变量的变化趋势

**使用帮助**

1. “清空”按钮用于清空图像；
2. “数据”按钮用于选择数据源；
3. ![](http://doc.tecmz.com/data/image/201508/30/68127_rAkJ_7750.png)用于返回Home；
4. ![](http://doc.tecmz.com/data/image/201508/30/68152_DyXW_9595.png)用于切换历史视图；
5. ![](http://doc.tecmz.com/data/image/201508/30/68162_MSkX_2701.png)用于平移图像，在该状态下，使用鼠标左键可以平移图像，使用鼠标右键拖拽可以缩放图像；
6. ![](http://doc.tecmz.com/data/image/201508/30/68172_zCNX_1117.png)用于缩放指定区域；
7. ![](http://doc.tecmz.com/data/image/201508/30/68181_GNnF_5243.png)用于设定显示边框；
8. ![](http://doc.tecmz.com/data/image/201508/30/68189_gtAx_4725.png)用于保存图像到文件；

具体变量跟踪发送的协议请参阅“高级发送协议”章节；

## 二维图像模块

![](http://doc.tecmz.com/data/image/201508/30/67233_cHge_6289.png)

**模块名称**

二维图像

**模块介绍**

用于方便显示一个二维图像

**使用帮助**

1. “清空”按钮用于清空图像；
2. “保存按钮” 用于将图片保存至JPG文件，文件名： `Video_static_[年月日]_[时]_[分]_[秒].jpg`
4. 图像帧数用于显示所有传回历史图像帧数；
5. 勾选“同时保存到JPG”，在一帧图像传送完毕后会自动保存到文件，文件名：`Video_[帧数]_[年月日]_[时]_[分]_[秒].jpg`
6. 具体变量跟踪发送的协议请参阅“高级发送协议”章节；

# 高级发送协议

## 协议说明

对于变量助手、变量跟踪、二维图像三个模块，使用了高级发送协议。

**命令开始符** 简称 FS_CHAR （Frame Start）

**转义符** 简称 SL_CHAR  （Char Slash）

一个数据包数据部分最大大小为258字节；由于转义符的存在，一个数据包最大能发送127字节的数据；

FS_CHAR 标志一个数据包的开始

如果数据包含FS_CHAR，在其前添加转义符SL_CHAR

如果数据包含SL_CHAR，在其前添加转义符SL_CHAR

## 数据帧格式

|  偏移量 | 值说明  |
| ------------ | ------------ |
| [0] | 数据帧开始标志 FS_CHAR  |
| [1]  | 数据帧类型  |
|  [2] | 数据部分长度，单位字节，包括转义符  |
| [3]  | 数据帧类型与数据部分长度的异或值，主要用于校验  |
| [4:N] | 数据部分，N<=130，此部分数据最大长度为127|

### 变量助手数据包

> 说明：发送1个8 位无符号数到变量助手
> 帧类型：0x01
> 数据部分：[编号]:[数据]

&nbsp;

> 说明：发送1个8 位有符号数到变量助手
> 帧类型：0x02
> 数据部分：[编号]:[数据]

&nbsp;

> 说明：发送1个16位无符号数到变量助手
> 帧类型：0x03
> 数据部分：[编号]:[数据H]:[数据L]

&nbsp;

> 说明：发送1个16位有符号数到变量助手
> 帧类型：0x04
> 数据部分：[编号]:[数据H]:[数据L]

&nbsp;

> 说明：发送1个32位无符号数到变量助手
> 帧类型：0x05
> 数据部分：[编号]:[数据HH]:[数据HL]:[数据LH]:[数据LL]

&nbsp;

> 说明：发送1个32位有符号数到变量助手
> 帧类型：0x06
> 数据部分：[编号]:[数据HH]:[数据HL]:[数据LH]:[数据LL]

&nbsp;

### 变量跟踪数据包

> 说明：发送1个8 位无符号数到变量跟踪
> 帧类型：0x07
> 数据部分：[编号]:[数据]

&nbsp;

> 说明：发送1个8 位有符号数到变量跟踪
> 帧类型：0x08
> 数据部分：[编号]:[数据]

&nbsp;

> 说明：发送1个16位无符号数到变量跟踪
> 帧类型：0x09
> 数据部分：[编号]:[数据H]:[数据L]

&nbsp;

> 说明：发送1个16位有符号数到变量跟踪
> 帧类型：0x0A
> 数据部分：[编号]:[数据H]:[数据L]

&nbsp;

> 说明：发送1个32位无符号数到变量跟踪
> 帧类型：0x0B
> 数据部分：[编号]:[数据HH]:[数据HL]:[数据LH]:[数据LL]

&nbsp;

> 说明：发送1个32位有符号数到变量跟踪
> 帧类型：0x0C
> 数据部分：[编号]:[数据HH]:[数据HL]:[数据LH]:[数据LL]

&nbsp;

### 二维图像数据包

> 说明：发送二维图像
> 帧类型：0x0D
> 数据部分：[宽度H]:[宽度L]:[高度H]:[高度L]:[模式 ( 1=RGB色 2=灰度 ) ]
> 说明：灰度模式下依次发送灰度图像，RGB模式下每个像素依次发送RGB

## 数据帧举例

说明：编号表示变量在上位机显示的标号，范围为0x00-0xFF，下同

显示8位无符号数（假设为0x12）到0x01编号

`0F 01 02 03 01 12`

显示8位有符号数（假设为0x12）到0x01编号

`0F 02 02 00 01 12`

显示16位无符号数（0x0F1F）到0x01编号

`0F 03 05 06 01 0F 0F 0F 1F`

显示16位有符号数（0x0F1F）到0x01编号

`0F 04 05 01 01 0F 0F 0F 1F`

显示32位无符号数（0x12340F1F）到0x01编号

`0F 05 07 02 01 12 34 0F 0F 0F 1F`

显示32位有符号数（0x12340F1F）到0x01编号

`0F 06 07 01 01 12 34 0F 0F 0F 1F`

发送图像灰度数据 (5x5)

`0F 0D 05 08 00 05 00 05 02`

`01 02 ....`

发送图像RGB数据 (5x5)

`0F 0D 05 08 00 05 00 05 02`

`01 01 01 02 02 02 ....`

JefferyZh/SerialGenius

简介

发行版

贡献者

近期动态

JefferyZh/SerialGenius .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

JefferyZh/SerialGenius