# DearSH

**Repository Path**: xialing78/dear-sh

## Basic Information

- **Project Name**: DearSH
- **Description**: 一个基于PySerial 和 DearPyGui 的串口助手 demo
- **Primary Language**: Python
- **License**: CC0-1.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 0
- **Created**: 2023-03-01
- **Last Updated**: 2025-06-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Python, imgui, serial, 串口助手, 串口

## README

# DearSH

#### 介绍

一个基于PySerial 和 DearPyGui 的串口助手 demo

![输入图片说明](cb62f4974f19d6d7baeccb430dcf818.png)

#### 软件架构

- 功能是基于 `PySerial` 包
- 界面是基于 `DearPyGui` 包
- 字体是 凤凰点阵体


#### 安装教程

1.  安装 `python` 环境
2.  安装依赖库

```
# 安装 PySerial 包
pip3 install pyserial

# 安装 DearPyGui 包
pip3 install dearpygui
``` 

3. 启动运行

``` powershell
python main.py
```

#### 使用说明

1.  连接并选择串口设备 , 程序默认会识别电脑上已连接的所有串口设备 , 如果没有找到可以点击 ` 搜索 ` 尝试刷新
2.  选择连接参数
3.  点击连接

![输入图片说明](image.png)

4. 程序预制了一个简单通用的自定义数据解析协议 , 正确设置标志位, 数据会被解析成表格数据以直观的进行监控

![输入图片说明](image1.png)

5. 程序预制了一个简单的数据发送协议 , 配合下位机的程序可以实现主从控制

![输入图片说明](image6.png)

![输入图片说明](image2.png)

6. 鼠标悬停在数据表对应行 , 可以实时显示趋势的 ` mini_plot `

![输入图片说明](image3.png)
 
7. 同时还具备更丰富功能和交互的示波器模块, 选择监视的数据行会同步到示波器进行展示 ( 暂未写 ) 

![输入图片说明](image4.png)