bepe3apng/Xgecu-File-Manager

# Xgecu-File-Manager 🛠️ XGecu T48 (TL866-3G) eMMC ISP 工具包与 GUI 本项目是一套基于 Python 的工具集，通过逆向 XGecu T48 (TL866-3G) 通用编程器的 USB 协议实现 - https://github.com/danusha2345/xgecu-t48-reverse。本项目专注于通过在系统编程 (ISP) 操作 eMMC 闪存，并支持通过相应适配器进行操作，旨在绕过官方专有软件，在 Linux 和 Windows 操作系统中实现直接的硬件访问。 项目的核心是一个图形用户界面 (GUI) 和经过优化的底层脚本，能够安全地初始化芯片、读取健康状态信息，并即时解析分区表。 ✨ 核心功能 图形用户界面 (GUI)：基于 Tkinter 开发的便捷且轻量级的用户界面。集成了控制面板（包括“即时”切换 VCCQ 电压）、事件日志记录器和交互式分区表。 深度硬件诊断：读取并智能解析 CID、CSD 和 EXT_CSD 寄存器。脚本能正确处理 T48 特有的 CID/CSD 字节交换，同时保持 EXT_CSD 的原始 顺序。 磨损与配置 分析：输出芯片的真实容量、隐藏分区 BOOT1/2 和 RPMB 的大小、eMMC 版本，以及 SLC (Typ A) 和 TLC (Typ B) 的磨损指标。 超高速 GPT 解析器：通过编程器的流式硬件读取 直接从 eMMC 闪电般读取分区表，无需下载完整的 dump 文件。 文件系统自动检测：通过对每个分区起始部分的几 KB 数据进行精确读取，实现“即时”识别文件系统。支持：EXT4、F2FS、EROFS、SquashFS、FAT32、exFAT、NTFS 以及 Android Boot 镜像。 总线完全控制：支持通过软件切换 VCCQ 电压 (1.8V / 3.3V)，并能将总线 CLK 频率最高提升至 ISP 的安全极限 —— 40 MHz。 ⚙️ 环境要求与安装 本项目使用 Python 语言编写，并直接与 USB 进行通信。不需要任何特定的内核级驱动程序。仅需安装 python 3.10+。 安装依赖项： （pyusb 包提供了接口，而 libusb 则作为与端口通信的物理后端）。 Windows 配置： 为确保脚本正常运行，必须使用 Zadig 工具将通用的 WinUSB 驱动绑定到编程器的接口上。 Linux 配置： 添加标准的 udev 规则，以便在不使用 root 权限的情况下，授予您的用户访问 T48 USB 接口的权限。 🔌 硬件连接 建议 (ISP) 在进行系统内连接（直接连接到设备主板）时，信号的质量至关重要： GND 线路：使用 ICSP 端口，并务必将两根 GND 线尽可能靠近 CLK 线进行焊接。 线缆长度：请尽量缩短 ISP 排线的长度，并避免线缆相互缠绕，以最大程度减少 40 MHz 频率下的信号干扰。 复位 (RST_n)：eMMC 芯片的 RST_n 引脚必须处于高逻辑电平状态。如果此处为 0V，请通过一个约 1 kΩ 的电阻将其上拉至 VCCQ 线路。 与处理器的冲突：如果 eMMC 焊接在主板上，主处理器可能会干扰信号。建议强制停止其运行（例如，将石英晶体谐振器短路至地）。 ⚠️ 重要警告！ 请仔细检查电压 (VCCQ)！在开始操作之前，请务必查阅芯片的数据手册。向严格限定为 1.8V 的 eMMC 芯片施加 3.3V 电压，会在几毫秒内导致芯片发生物理烧毁。请通过脚本参数或 GUI 中的复选框谨慎管理电压。如果目标主板已经连接了外部电源，严禁将编程器的 VCC 线路连接到该主板上。

标签：eMMC, GPT解析, Python, Tkinter, 云资产清单, 无后门, 硬件编程器, 硬件调试, 逆向工具, 逆向工程