# ControllorSimulator-public
**Repository Path**: frankliugang/ControllorSimulator-public
## Basic Information
- **Project Name**: ControllorSimulator-public
- **Description**: 遥控器测试模拟器
- **Primary Language**: C#
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-23
- **Last Updated**: 2025-11-26
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 遥控器自动化测试平台 - 帮助文档
## 下载地址
## 最新版本
[V1.1.9 ](https://gitee.com/frankliugang/ControllorSimulator-public/blob/master/version/%E9%81%A5%E6%8E%A7%E5%99%A8%E6%B5%8B%E8%AF%95%E6%A8%A1%E6%8B%9F%E5%99%A8V1.1.9.zip)
### 历史版本
[V1.1.8 ](https://gitee.com/frankliugang/ControllorSimulator-public/blob/master/version/%E9%81%A5%E6%8E%A7%E5%99%A8%E6%B5%8B%E8%AF%95%E6%A8%A1%E6%8B%9F%E5%99%A8V1.1.8.zip)
[V1.1.7 ](https://gitee.com/frankliugang/ControllorSimulator-public/blob/master/version/%E9%81%A5%E6%8E%A7%E5%99%A8%E6%B5%8B%E8%AF%95%E6%A8%A1%E6%8B%9F%E5%99%A8V1.1.7.zip)
[V1.1.6 ](https://gitee.com/frankliugang/ControllorSimulator-public/blob/master/version/%E9%81%A5%E6%8E%A7%E5%99%A8%E6%B5%8B%E8%AF%95%E6%A8%A1%E6%8B%9F%E5%99%A8V1.1.6.zip)
[V1.1.5 ](https://gitee.com/frankliugang/ControllorSimulator-public/blob/master/version/%E9%81%A5%E6%8E%A7%E5%99%A8%E6%B5%8B%E8%AF%95%E6%A8%A1%E6%8B%9F%E5%99%A8V1.1.5.zip)
[V1.1.4 ](https://gitee.com/frankliugang/ControllorSimulator-public/blob/master/version/%E9%81%A5%E6%8E%A7%E5%99%A8%E6%B5%8B%E8%AF%95%E6%A8%A1%E6%8B%9F%E5%99%A8V1.1.4.zip)
[V1.1.3 ](https://gitee.com/frankliugang/ControllorSimulator-public/blob/master/version/%E9%81%A5%E6%8E%A7%E5%99%A8%E6%B5%8B%E8%AF%95%E6%A8%A1%E6%8B%9F%E5%99%A8V1.1.3.zip)
[V1.1.2 ](https://gitee.com/frankliugang/ControllorSimulator-public/blob/master/version/%E9%81%A5%E6%8E%A7%E5%99%A8%E6%B5%8B%E8%AF%95%E6%A8%A1%E6%8B%9F%E5%99%A8V1.1.2.zip)
[V1.1.1 ](https://gitee.com/frankliugang/ControllorSimulator-public/blob/master/version/%E9%81%A5%E6%8E%A7%E5%99%A8%E6%B5%8B%E8%AF%95%E6%A8%A1%E6%8B%9F%E5%99%A8V1.1.1.zip)
[V1.1.0 ](https://gitee.com/frankliugang/ControllorSimulator-public/blob/master/version/%E9%81%A5%E6%8E%A7%E5%99%A8%E6%B5%8B%E8%AF%95%E6%A8%A1%E6%8B%9F%E5%99%A8V1.1.0.zip)
[V1.0.4 ](https://gitee.com/frankliugang/ControllorSimulator-public/blob/master/version/%E9%81%A5%E6%8E%A7%E5%99%A8%E6%B5%8B%E8%AF%95%E6%A8%A1%E6%8B%9F%E5%99%A8V1.0.4.zip)
[V1.0.3 ](https://gitee.com/frankliugang/ControllorSimulator-public/blob/master/version/%E9%81%A5%E6%8E%A7%E5%99%A8%E6%B5%8B%E8%AF%95%E6%A8%A1%E6%8B%9F%E5%99%A8v1.0.3.zip)
[V1.0.2 ](https://gitee.com/frankliugang/ControllorSimulator-public/blob/master/version/%E9%81%A5%E6%8E%A7%E5%99%A8%E6%B5%8B%E8%AF%95%E6%A8%A1%E6%8B%9F%E5%99%A8v1.0.2.zip)
[V1.0.1](https://gitee.com/frankliugang/ControllorSimulator-public/blob/master/version/%E9%81%A5%E6%8E%A7%E5%99%A8%E6%B5%8B%E8%AF%95%E6%A8%A1%E6%8B%9F%E5%99%A8V1.0.1.zip)
[V1.0.0](https://gitee.com/frankliugang/ControllorSimulator-public/blob/master/version/%E9%81%A5%E6%8E%A7%E5%99%A8%E6%B5%8B%E8%AF%95%E6%A8%A1%E6%8B%9F%E5%99%A8V1.0.0.zip)
## 软件主要功能
**当前版本：v1.1.6**
* 支持遥控器测试用例的导入、编辑、执行与结果导出
* 串口通信自动化测试，目前只支持 "单步测试"，其他模式还未启用
* 测试结果自动判定，支持超时机制
* 支持多种映射表、步骤表的导入
* 测试数据以树形结构展示，支持主 / 子用例管理
* 测试结果可导出为 Excel 报表
* 支持监控窗口和 LCD 模拟器
* 丰富的状态栏统计与操作日志
## 各页面功能说明 - 还需要整理完善
### 主测试页面
* 显示所有测试用例（树形结构）
* 支持用例的编辑、添加主 / 子记录
* 按钮区功能：连接 / 断开串口、一键测试、单步测试、暂停 / 停止测试、清空结果、按区间测试、导出测试报告
### 文件菜单
* 新建测试：生成新的测试模板
* 导入映射表：导入按键和 LCD 映射表
* 导入步骤表：导入测试步骤表
### 调试菜单
* 步骤表填写：手动编辑测试步骤
* 数据收发：串口数据收发调试
### 监控菜单
* 打开监控：显示实时监控窗口
* 关闭监控：关闭监控窗口
* LCD 模拟器：打开 LCD 模拟器窗口
### 帮助菜单
* 查看帮助：打开本帮助文档
* 关于：显示软件版本和开发信息
## 版本升级记录
## v1.2.0（2025-11-26）
- 修改多回复用例的处理逻问题
1. 在多回复用例中，接收不到中间层返回的多恢复数据。
2. 原因：在上次的改动中，错误的将多回复用例的主用例的"期待送信代码"，"期待LCD buffer"字段没有赋值。
导致在计算送信码的时候，红外或LCD 字段送错，所以中间层没有返回多回复。
3. 解决：在多回复的用例上，设置主用例的字段从第一个子回复的用例来。
## v1.1.9（2025-11-17）
- 优化了系统
1. 在文件菜单下加入了“统计用例数”功能。能够查看每个sheet展开后的用例数。
2. 解决V.1.1.8代入得解析步骤表的问题。
## v1.1.8（2025-11-07）
修改多回复用例的处理逻辑如下：
- 在多回复的情况下
1. 在超时时长范围内，对收到的子回复，按照子回复的情况检查每一个收到的子回复的结果。
2. 如果有一个子回复的结果是ok,那总用例也被认为是ok.
3. 如果没有一个子回复的结果是ok,那总用例也被认为是NG. 但程序不终止
4. 如果子回复的次数小于“期望记录次数”，没有收到的记录，被标记成NG.
5. 如果一个子回复都没有，那子回复都是NG,那总用例也被认为是NG. 但程序不终止
6. 如果有一条子回复的SendResultOK 是ok, 那这条的LCDResult如果是ok,总用例的LCDResult就ok。
条的SendResultOK如果是ok,总用例的SendResultOK就ok
7. 注意这个逻辑只适用于多用里超时的的情况。第一次处理的时候还是会按照之前的逻辑处理。也就是说如果要让Timeout处理生效，需要开启"超时重发"
## v1.1.7（2025-11-05）
- 1. 优化log
## v1.1.6（2025-10-25）
- 1. 解决“time + 重试”对于多回复用例，回复匹配问题。
## v1.1.5（2025-10-15）
- 1.统一日志(Log)并支持控制台/文件输出；
- 2.settings: 增加“开启Debug Log”并持久化到setup.config；
- 3.main: 启动与主窗体按配置初始化日志；
- 4.ui: 状态栏显示调试/重发/时长信息并在启动/设置后刷新；
- 5.serial: 记录原始收发并写入serial.log；
- 6.refactor: Console.WriteLine -> Log.Write
## v1.1.4（2025-10-15）
- 1 .修复用户在测试中发现的问题
18 "超时弹窗后，弹窗在软件下面，要把测试界面缩小才能看到弹窗，如果不一直监控软件运行情况，不知软件何时停止运转。如果弹窗能弹在最上层就方便多了。"
19 "超时弹窗后，软件死了，按下右上角叉图标X没有反应。对着任务栏该软件按下右键选择关闭也没有反应。"
21 "单步执行一步复位，软件就死了，需重新打开软件。"
23 "步骤表0923 自动415行，第一回测试停止，再次按下此步可以执行，但是弹窗，软件停止。实际遥控器也没变化。按软件右上角的叉X时，才发送除臭SW送信值，遥控器画面变化。另外，弹窗后，软件停止，下排按键无反应。"
26 "按暂停时，才会出现No.19 OK的结果，进度条不是显示实际测试正在进行的项目"
27 "按了清空表格后，结果里面会显示结果NG。使用步骤表“长按项目”
## v1.1.3（2025-09-23）
- 1 .修复用户在测试中发现的问题
1. (5) 正在测试的进度条，有时不能对齐. (已解决)
2. (7) LCD模拟器实际值、掩码值、期望值显示不全；如果能把byte0-37列出就能帮助理解数值。经讨论，修改界面，将LCD模拟器下显示27个字节的输入框设置长宽度和窗口一致。 (已解决)
3. (8) 试过一次，测得很多NG项目. (已解决)
1. 新加一个设置，可以控制是否超时需要重发。重发次数，间隔。
2. 注意，在1.1.3中，设置 窗口中，可以设置超时是否重发参数。
4. (9) LCD模拟器显示与实际显示不一致 (已解决)1.没有掩码和期望值的时候，LCD模拟器显示：由于没有掩码，不会画边框颜色。
5. (10) 送信期待值为NULL时，记录实际送信值，但是结果判断为OK；而不是NG； (已解决)
1. 如果期待送信吗，期待时长，期待LCD寄存器是空或Null，相对的result默认为OK.
2. 注意：软件增加了导入导出项目。可以保存测试进度。"
6. (11) 关于NO.8大片NG问题；20250911上午也同样出现大片NG(已解决)和（8）同一个问题。
7. (16) 需要追加延时2秒的功能指令,2秒期间不执行下一条按键操作，只是等待2秒。(已解决)
1. 在按键列加入一个关键字符"等待"，如果是"等待"按键，程序会等待 "超时时长"字段指定的时间。"
## v1.1.2（2025-09-12）
- 1 .修改用例执行中，如果回复超时，程序执行停止。报错提示
## v1.1.1 （2025-09-08）
- 1 .LCD 模拟器：选择需要显示的图标，buffer数值会设置，但颜色不会变化"
- 2 右键菜单功能
1. ** 添加主用例
2. ** 添加子用例
3. ** 删除用例
4. ** 从此执行
5. ** 执行此步
- 3 优化每个用例中间需要等待间隔时间
- 4 优化主界面上的按钮
- 5 解决用户反映的问题
1. •重复执行用例的问题:添加了“从此执行”，“执行此步”按钮，用户可以随意执行想要的用例。
2. •清除结果按钮，没有清除感觉：已解决
3. •用例接受多个回复消息问题：已解决
## v1.1.0 （2025-09-03）
- 支持测试case中使用变量块 `{{}}` 定义重复执行的case
- 支持测试case中记录次数大于1的情况，系统会接受多次回复
- 优化导出报告功能，加入序列号，方便对比查找case
- 更新 setup.config，加入一些默认配置
- 解决用户反馈的下面的问题：
1. **"一键测试针对一个表格也没问题，能用。"**
回复：一键测试功能确定是执行全部sheet里的全部case
更新：包含在v1.1.0 版本。
2. **"一键测试完成后，暂停测试，恢复测试，不能继续测试。软件无法动作，按键按不了。"**
回复：在新的版本里，对此有优化。正常情况不会发生这种问题。
更新：包含在v1.1.0 版本。
3. **“sheet 00初期值设定可以一键测试。Sheet 01自动 一键测试不可以。”**
回复：一键测试，全部sheet.
更新：包含在v1.1.0 版本。
4. **“长按功能不可以，请参照00长按测试表格。是因为长按未设定指令？”**
回复：需要修改按下时长指令。如果传入的是数字，直接转换成指令。
更新：包含在v1.1.0 版本。
5. **"正确配置，才能测02.暖房356行"**
回复：
- 需要你们给我你们那边最新的setup.config 文件。
- 我会把它放到软件里最后默认版本。
- 同时我会把你们最新的步骤表里的动作和操作列的值配置进来。
6. **"LCD 模拟器：选择需要显示的图标，buffer数值会设置，但颜色不会变化"**
回复：
- 模式->显示模式，功能是好用的。
- 设置模式，有问题，下个版本会修改。
7. **请参照最新的步骤表**
回复：这个不需要有改动。
- 其他问题：
1. **出现过一次导出结果数据不全。**
回复：请帮忙在后面的测试中观察一下时候还会出现。
2. **是否可以把数据保存到数据库。**
回复：如果需要，可以后期再讨论需求。目前不做改动。
3. **数据加载慢。**
回复：我会尽量优化程序加载的速度。
更新：优化已经包含在v1.1.0 版本。
4. **当前进度条改成浅蓝色， 成功--绿色 / 失败：红色**
更新：包含在v1.1.0 版本。
### v1.0.4（2024-08-27）
* 1. 一键调试功能可用
* 2.按区间调试功能可用
* 3.修改默认的setup.config的值
### v1.0.3（2024-08-26）
* 1. LCD 颜色显示对于文字，几何图形，数码管的不一致问题
* 2. 解决导出测试结果“详细操作”列内容不对问题,解决报表合并单元格问题。
* 3. 单步调试优化
* 4. 增加全屏模式，可以自动全屏，把相关窗口打开，方便使用
* 5. 调整菜单，将不用得菜单项删除。
* 6. 修改设置-环境参数，删除不用的设置，添加配置文件/log的备份选项
### v1.0.2（2024-08-21.2）
* 1. 修复安装程序后，程序点击没反应问题
### v1.0.1（2024-08-21）
* 优化 Excle 导入数据处理功能
* 增加 LCD 模拟器功能
* 优化串口连接流程，增加 "时长偏移量" 设置。调节此参数，可以控制消息返回时长的判断
* 设置面板，怎么了 LCD 监控配置。可以设置 LCD 寄存器对应关系， LCD 颜色显示
### v1.0.0（2024-08-08）
* 软件首发，内测版本
* 支持 Excel 步骤表导入与结果导出
* 支持主 / 子用例管理
* 状态栏显示总用例数、当前序号、成功 / 失败统计
## 常见问题
### help.md 文件未找到怎么办？
请将 help.md 放在程序 exe 所在目录（如 bin\Debug 或 bin\Release），并设置为 "始终复制到输出目录"。
### 如何导入测试用例？
通过 "文件" 菜单选择 "导入步骤表"，支持 Excel 格式。
### 如何导出测试结果？
测试完成后点击 "导出报告" 按钮，选择保存路径即可。
## 关于
遥控器自动化测试平台
开发团队：[powerone.cn](https://powerone.cn)
联系方式：frankliugang@163.com
版权所有 © 2025
> （注：文档部分内容可能由 AI 生成）