Initial commit: 上传完整代码

This commit is contained in:
2026-06-19 20:47:06 +08:00
commit 78b5898da2
71 changed files with 8767 additions and 0 deletions
+102
View File
@@ -0,0 +1,102 @@
# Draw.io 使用指南:绘制UML状态图并保存本地
## 一、进入绘制界面
1. 打开 [draw.io](https://app.diagrams.net/)
2. 选择「Create New Diagram」(创建新图表)
3. 选择存储位置:点击「Device」(设备)→ 暂时不保存
4. 选择模板:点击「Blank Diagram」(空白图表)→ 点击「Create」
## 二、绘制UML状态图
### 1. 启用UML状态图工具
在左侧工具栏找到并点击「More Shapes」(更多形状):
- 展开「Software」(软件)→ 勾选「UML」
- 特别勾选「UML State Machine」(UML状态机)
- 点击「Apply」(应用)
### 2. 绘制基本元素
#### 初始状态
- 从左侧「UML State Machine」工具栏拖拽「Initial State」(实心圆)到画布
#### 普通状态
- 拖拽「State」(圆角矩形)到画布
- 双击状态框输入状态名称(如:`scanner1_scanning`)
- 右键点击状态 → 「Edit Style」(编辑样式)可修改颜色、边框等
#### 状态转换
- 从左侧工具栏拖拽「Transition」(带箭头的线)到画布
- 连接两个状态(起点状态 → 终点状态)
- 双击箭头输入触发事件(如:`scanner1_complete`)
#### 终止状态
- 从左侧工具栏拖拽「Final State」(同心圆)到画布(如果需要)
### 3. 高级设置
#### 转换条件
- 右键点击转换箭头 → 「Edit」(编辑)→ 「Add Condition」(添加条件)
- 输入条件(如:`if position == upper_limit`)
#### 状态动作
- 双击状态 → 进入编辑模式
- 输入格式:`状态名称\n/进入动作\n退出动作`
- 示例:`scanner1_scanning\n/on_scanner1_scanning_start()\non_scanner1_scanning_stop()`
#### 并行区域(可选)
- 使用「Composite State」(复合状态)创建嵌套区域
- 用于表示并发执行的状态
## 三、保存到本地
### 1. 保存为.drawio格式(可编辑)
- 点击顶部菜单栏「File」(文件)→ 「Save As」(另存为)
- 选择「Device」(设备)
- 选择保存位置(推荐保存到 `motor_service` 目录)
- 输入文件名(如:`scanner_state_machine.drawio`)
- 点击「Save」(保存)
### 2. 导出为图片格式(用于查看)
- 点击顶部菜单栏「File」(文件)→ 「Export As」(导出为)→ 「PNG」
- 设置图片参数:
- 「Include a border」(包含边框):可选
- 「Zoom」(缩放):100%
- 「Transparent Background」(透明背景):可选
- 点击「Export」(导出)
- 选择保存位置和文件名(如:`scanner_state_machine.png`)
- 点击「Save」(保存)
### 3. 导出为PDF格式(用于文档)
- 点击顶部菜单栏「File」(文件)→ 「Export As」(导出为)→ 「PDF」
- 设置PDF参数后点击「Export」(导出)
## 四、绘制示例(扫描器状态图)
按照之前的设计指南,绘制以下状态:
- 初始状态
- `all_stopped`
- `scanner1_scanning`
- `scanner1_waiting`
- `scanner2_scanning`
- `scanner2_waiting`
并添加以下转换:
- 初始状态 → `all_stopped`
- `all_stopped` → `scanner1_scanning`(触发:`start_scanner1`)
- `all_stopped` → `scanner2_scanning`(触发:`start_scanner2`)
- `scanner1_scanning` → `scanner1_waiting`(触发:`scanner1_complete`)
- `scanner2_scanning` → `scanner2_waiting`(触发:`scanner2_complete`)
- `scanner1_waiting` → `scanner2_scanning`(触发:`start_scanner2`)
- `scanner2_waiting` → `scanner1_scanning`(触发:`start_scanner1`)
- 所有状态 → `all_stopped`(触发:`stop_all` 或 `emer_stop_all`)
## 五、注意事项
1. 定期保存:绘制过程中可按 Ctrl+S(Windows)或 Command+S(Mac)快速保存
2. 命名规范:使用有意义的状态名称和事件名称
3. 布局清晰:使用「Arrange」(排列)菜单调整状态布局
4. 颜色区分:使用不同颜色表示不同类型的状态(如:运行状态用绿色,停止状态用红色)
绘制完成后,将 `.drawio` 文件保存到 `motor_service` 目录,然后告诉我,我将根据您的状态图实现代码。