mtk-imei-switcheroo

读取和写入 MediaTek NVRAM 文件或分区镜像中的 IMEI 记录以及 WiFi/蓝牙地址。包含用于已 root 设备的交互式 ADB 工具，以及针对 biloba 的独立、特定版本的 modem/LK 补丁程序。

安装

git clone https://github.com/alltechdev/mtk-imei-switcheroo
cd mtk-imei-switcheroo
python3 -m pip install -r requirements.txt

NVRAM 工具需要 Python 3.6+。IMEI 操作需要 pycryptodome； WiFi/蓝牙操作仅使用标准库。实时工具还需要 ADB 和已 root 的设备。Biloba 的完整验证工作流有 单独的依赖项。

选择工具

任务	命令	指南
本地文件或分区镜像中的 IMEI	python3 tools/nvram/imei_tool.py	离线 IMEI
已 root 设备上的 IMEI	./tools/nvram/live_patch.sh	实时 IMEI
本地文件或镜像中的 WiFi/BT 地址	python3 tools/nvram/mac_tool.py	离线 MAC
已 root 设备上的 WiFi/BT 地址	./tools/nvram/live_patch_mac.sh	实时 MAC
精确匹配的 biloba 调制解调器/LK 固件对	带版本号的 Python 补丁工具	Biloba 补丁工具

用法

从仓库根目录运行：

python3 tools/nvram/imei_tool.py read LD0B_001
python3 tools/nvram/imei_tool.py read nvdata.img
python3 tools/nvram/imei_tool.py write LD0B_001 350859600862948 -s 1 -o LD0B_001_new
# Dual-SIM: use -s 2 for the second slot.

python3 tools/nvram/mac_tool.py read WIFI
python3 tools/nvram/mac_tool.py write WIFI --wifi 02:11:22:33:44:66 -o WIFI.patched
python3 tools/nvram/mac_tool.py write BT_Addr --bt 02:11:22:33:44:55 -o BT_Addr.patched

离线工具接受单条记录或受支持的分区镜像。有关检测规则、重复记录、备份和错误处理，请参阅相关指南。

实时设备修补

./tools/nvram/live_patch.sh 和 ./tools/nvram/live_patch_mac.sh 会拉取记录、提示输入更改、推送修补后的文件并提供重启选项。有关要求和验证，请遵循 实时 IMEI 或 实时 MAC 指南。

验证状态

设备	记录结果
F21 Pro	IMEI 和 WiFi/BT 流程已在硬件上验证
F25	IMEI 已通过测试器验证；WiFi/BT 已通过 Java 移植版确认
TIQ M5	双 SIM IMEI 和 WiFi/BT 流程已在硬件上验证
Biloba V12 调制解调器 + 随附 LK	配对固件补丁报告可用；仅调制解调器补丁导致启动循环
Biloba V13 调制解调器 + 捆绑 LK	离线检查通过；未报告硬件结果
Biloba V14 调制解调器 + 捆绑 LK	离线检查通过；未报告硬件结果

详细验证区分了直接测试、外部报告和离线检查。共享芯片组身份并不能确立兼容性。Biloba 增加了签名关键数据检查；NVRAM 工具不会应用其固件更改。请参阅 biloba 状态与限制。

WiFi MAC 和蓝牙地址

Android 的按网络 MAC 随机化可能会隐藏设备地址。Android 12+ 还会缓存出厂 WiFi MAC；实时脚本会更新该缓存，而仅进行离线分区编辑则不会。请参阅 实时 MAC 行为和 设备发现。

仓库布局

位置	用途
tools/nvram/	离线 NVRAM 工具和实时 ADB 脚本
docs/	指南、格式、设备发现和研究说明
firmware/biloba/	版本化固件修补器和复现运行器
research/biloba/	分析辅助工具、执行框架和保存的证据
tests/	NVRAM 回归驱动程序和仓库检查
tmp/、runs/	被忽略的本地样本、备份和生成结果

不包含固件镜像、分区转储和私钥。

相关

Android 应用移植版 · 致谢与来源 · 许可证