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

## 系统要求

- **操作系统**: 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. 不要将敏感信息（密码）存储在日志中