PTT/使用指南.md

采集箱出厂测试工具 - 快速使用指南

系统要求

• 操作系统: Windows 10/11 或 Linux (Ubuntu 18.04+)
• Python: 3.8 或更高版本
• 硬件: USB串口设备

安装步骤

1. 解压文件

将 production_test_tool_v1.0.zip 解压到合适的位置，例如：

C:\Tools\production_test_tool\  (Windows)
/home/user/production_test_tool/  (Linux)

2. 安装依赖

Windows:

cd production_test_tool
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt

Linux:

cd production_test_tool
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

3. 运行程序

Windows:

• 双击 run.bat
• 或在命令行运行: python src\main.py

Linux:

./run.sh
# 或
python3 src/main.py

使用流程

1. 登录系统

• 启动程序后显示登录对话框
• 默认账号: admin
• 默认密码: admin123
• 首次登录后建议修改密码

2. 连接设备

1. 使用USB转串口线连接采集箱设备
2. 在"串口"下拉框中选择对应的COM口
3. 输入设备的软件序列号

3. 开始测试

1. 点击"开始测试"按钮
2. 程序将自动执行以下测试流程：
   • 串口连接建立
   • 读取硬件信息（CPU序列号等）
   • 修改默认密码
   • 设置系统时区
   • 配置网络接口ETH-H1
   • 配置网络接口ETH-H0（含ethtool参数）
   • SSH连接测试
   • 文件传输测试
   • 网络连通性测试
   • 系统时间同步
   • 设置最终强密码
   • 生成设备标识文件

4. 查看结果

• 测试过程中实时显示进度和日志
• 每个测试项的状态会显示在右侧表格中
• 测试完成后可点击"生成报告"导出测试结果

5. 导出报告

• 点击"生成报告"按钮
• 选择保存位置
• 报告包含：设备信息、测试结果、执行时间等

配置说明

修改网络配置

编辑 config/config.json 文件：

{
    "network": {
        "eth0": {
            "ip": "192.168.0.3",
            "netmask": "255.255.255.0",
            "gateway": "192.168.0.1"
        },
        "eth1": {
            "ip": "10.0.5.232",
            "netmask": "255.255.255.0",
            "gateway": "10.0.5.1"
        }
    }
}

修改测试流程

编辑 config/test_items.json 文件可自定义测试项。

常见问题

Q: 串口列表为空？

A:

1. 检查USB转串口驱动是否正确安装
2. 尝试重新插拔USB设备
3. 点击"刷新"按钮更新串口列表

Q: SSH连接失败？

A:

1. 确认设备IP地址配置正确
2. 检查网络连通性（ping测试）
3. 确认SSH服务已启动

Q: 如何修改默认账号密码？

A:

1. 登录后点击右上角"设置"
2. 选择"修改密码"
3. 或直接在数据库中修改（高级用户）

Q: 测试过程中可以中断吗？

A: 可以，点击"停止"按钮即可中断当前测试。

Q: 如何重新测试已测过的设备？

A: 输入相同序列号，程序会提示是否重新测试。

数据存储

• 数据库: data/production_test.db (SQLite)
• 日志: logs/ 目录，按日期分割
• 报告: exports/ 目录
• 备份: backup/ 目录

技术支持

如有问题，请查看日志文件或联系技术支持。

安全提示

1. 定期修改管理员密码
2. 保护好 security/ 目录下的密钥文件
3. 测试完成后及时导出并备份数据
4. 不要将敏感信息（密码）存储在日志中