# ls-pfr-tools

**Repository Path**: linkedsemi/ls-pfr-tools

## Basic Information

- **Project Name**: ls-pfr-tools
- **Description**: Host computer software for PFR (Platform Firmware Resiliency) functional verification, used for testing and validating security features.
- **Primary Language**: HTML
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-25
- **Last Updated**: 2026-08-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# pfr_tool

本仓库用于存放 **LS1028 平台 PFR（Platform Firmware Resilience，平台固件韧性）功能测试** 相关的 **上位机（PC 端）软件源码** 及 **配套工具脚本**。

## 1. 用途说明

- **上位机应用**：与待测设备（BMC / 目标板）通信，执行 PFR 相关测试流程、采集与展示结果。
- **辅助工具**：如固件打包、签名解析、QSH 固件烧录、自动化脚本等，便于测试与问题定位。

## 2. 仓库结构

| 路径 | 说明 |
|------|------|
| `pfr_test_panel/` | **PFR 测试上位机**：I2C / SPI / 串口（CH347），入口 `pfr_qt_test.py` |
| `bin_add_header_sign/` | **固件签名与解析上位机**：入口 `start_qt.py` |
| `qsh_update.py` | **QSH 固件自动升级脚本**：通过玄铁 DebugServerConsole 自动烧录 QSH 芯片固件 |

## 3. PFR 测试上位机

目录：`pfr_test_panel/`

**环境要求**：Python 3.x，PySide6、hidapi、ecdsa；需安装 CH347 USB 驱动（HID 模式）。

```bash
cd pfr_test_panel
pip install PySide6 hidapi ecdsa
python pfr_qt_test.py
```

更多说明见 `pfr_test_panel/README.md`、`pfr_test_panel/uartReadme.md`。

## 4. 固件签名与解析上位机

目录：`bin_add_header_sign/`

**环境要求**：Python 3.x，PySide6。

```bash
cd bin_add_header_sign
pip install PySide6
python start_qt.py
```

更多说明见 `bin_add_header_sign/README.md`。

## 5. QSH 固件自动升级工具

文件：`qsh_update.py`（详细文档见 `qsh_update.md`）

通过 T-Head DebugServerConsole 自动完成 QSH 芯片的固件烧录，依次执行复位暂停、加载 Flash 算法、初始化、全片擦除、烧录校验、复位运行等步骤。

**环境要求**：

- 操作系统：Windows 10 及以上
- Python：3.6+（无需额外第三方依赖）
- 硬件：CKLink 调试器已连接目标板
- 软件：已安装 [玄铁调试器](https://www.xrvm.cn/)（XuanTie DebugServer）

**快速开始**：

1. 打开 `qsh_update.py`，编辑顶部的默认路径配置（DebugServerConsole、Flash 算法、固件文件、烧录地址）。
2. 在 **cmd 或 PowerShell 窗口** 中运行（不支持 IDE 内置终端）：

```powershell
python qsh_update.py
```

**常用命令行参数**：

| 参数 | 说明 |
|------|------|
| `-f`, `--firmware` | 固件 `.bin` 文件路径 |
| `-a`, `--algo` | Flash 算法 `.elf` 文件路径 |
| `-d`, `--debugserver` | DebugServerConsole.exe 路径 |
| `--addr` | Flash 烧录起始地址（默认 `0x8000000`） |
| `--timeout` | 整体流程超时秒数（默认 `300`） |

```powershell
# 使用默认配置
python qsh_update.py

# 指定固件文件
python qsh_update.py -f "D:\build\output\firmware.bin"

# 大固件烧录较慢时增加超时
python qsh_update.py --timeout 600
```

常见问题（初始化超时、擦除/烧录超时、IDE 终端无响应等）见 `qsh_update.md`。

## 6. 许可证与贡献

若项目有统一许可证或贡献规范，请在此说明；暂无则可删除本节或改为内部约定链接。