155 lines
3.4 KiB
Markdown
155 lines
3.4 KiB
Markdown
# 采集箱出厂测试工具 - 快速使用指南
|
||
|
||
## 系统要求
|
||
|
||
- **操作系统**: 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:
|
||
```cmd
|
||
cd production_test_tool
|
||
python -m venv venv
|
||
venv\Scripts\activate
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
#### Linux:
|
||
```bash
|
||
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:
|
||
```bash
|
||
./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` 文件：
|
||
```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. 不要将敏感信息（密码）存储在日志中
|