mtk-imei-switcheroo

Lê e grava registros de IMEI e endereços WiFi/Bluetooth em arquivos NVRAM da MediaTek ou imagens de partição. Inclui ferramentas ADB interativas para dispositivos com root e patchers separados de modem/LK específicos por versão para biloba.

Instalação

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

As ferramentas de NVRAM precisam de Python 3.6+. As operações de IMEI requerem pycryptodome; as operações de WiFi/Bluetooth usam apenas a biblioteca padrão. As ferramentas ao vivo também precisam de ADB e de um dispositivo com root. O fluxo de verificação completo do Biloba tem dependências separadas.

Escolha uma ferramenta

Tarefa	Comando	Guia
IMEI num ficheiro local ou imagem de partição	python3 tools/nvram/imei_tool.py	IMEI offline
IMEI num dispositivo com root	./tools/nvram/live_patch.sh	IMEI ao vivo
Endereços WiFi/BT num ficheiro local ou imagem	python3 tools/nvram/mac_tool.py	MAC offline
Endereços WiFi/BT num dispositivo com root	./tools/nvram/live_patch_mac.sh	MAC ao vivo
Par exato de firmware modem/LK do biloba	Patchers Python versionados	Patchers do Biloba

Utilização

Execute a partir da raiz do repositório:

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

Ferramentas offline aceitam registros individuais ou imagens de partição suportadas. Consulte os guias para regras de detecção, registros duplicados, backups e tratamento de erros.

Aplicação de patch em dispositivo ao vivo

./tools/nvram/live_patch.sh e ./tools/nvram/live_patch_mac.sh extraem registros, solicitam alterações, enviam os arquivos corrigidos e oferecem uma reinicialização. Siga o guia de IMEI ao vivo ou MAC ao vivo para requisitos e verificação.

Status de verificação

Dispositivo	Resultado registrado
F21 Pro	Fluxos de IMEI e WiFi/BT verificados em hardware
F25	IMEI verificado através do testador; WiFi/BT confirmado através da porta Java
TIQ M5	Fluxos de IMEI dual-SIM e WiFi/BT verificados em hardware
Modem Biloba V12 + LK fornecido	Patch de firmware emparelhado relatado como funcional; patch somente de modem causou bootloop
Modem Biloba V13 + LK incluído	Verificações offline aprovadas; nenhum resultado em hardware relatado
Modem Biloba V14 + LK incluído	Verificações offline aprovadas; nenhum resultado em hardware relatado

A validação detalhada distingue testes diretos, relatos externos e verificações offline. A identidade de chipset compartilhada não estabelece compatibilidade. O Biloba adiciona uma verificação de dados críticos assinada; as ferramentas NVRAM não aplicam suas alterações de firmware. Consulte status e limites do biloba.

MAC WiFi e endereço Bluetooth

A randomização de MAC por rede do Android pode ocultar o endereço do dispositivo. O Android 12+ também armazena em cache o MAC WiFi de fábrica; o script ao vivo atualiza esse cache, enquanto uma edição offline de partição sozinha não o faz. Consulte comportamento do MAC ao vivo e descobertas do dispositivo.

Estrutura do repositório

Local	Finalidade
tools/nvram/	Ferramentas NVRAM offline e scripts ADB ao vivo
docs/	Guias, formatos, descobertas de dispositivos e explicações de pesquisa
firmware/biloba/	Patchers de firmware versionados e executor de reprodução
research/biloba/	Auxiliares de análise, harnesses de execução e evidências salvas
tests/	Drivers de regressão NVRAM e verificações do repositório
tmp/, runs/	Amostras locais, backups e resultados gerados ignorados

Imagens de firmware, dumps de partição e chaves privadas não estão incluídos.

Relacionados

Port do aplicativo Android · Créditos e proveniência · Licença