alltechdev/mtk-imei-switcherooLegge e scrive record IMEI e indirizzi WiFi/Bluetooth nei file NVRAM di MediaTek o nelle immagini di partizione. Include strumenti ADB interattivi per dispositivi con root e patcher separati per modem/LK specifici per versione per biloba.
Legge e scrive record IMEI e indirizzi WiFi/Bluetooth nei file NVRAM MediaTek o nelle immagini di partizione. Include strumenti ADB interattivi per dispositivi con root e patcher separati per modem/LK specifici per versione per biloba.
git clone https://github.com/alltechdev/mtk-imei-switcheroo
cd mtk-imei-switcheroo
python3 -m pip install -r requirements.txt
Gli strumenti NVRAM richiedono Python 3.6+. Le operazioni IMEI richiedono pycryptodome;
le operazioni WiFi/Bluetooth utilizzano solo la libreria standard. Gli strumenti live richiedono anche
ADB e un dispositivo con root. Il flusso di verifica completo di Biloba ha
dipendenze separate.
| Attività | Comando | Guida |
|---|---|---|
| IMEI in un file locale o immagine di partizione | python3 tools/nvram/imei_tool.py | IMEI offline |
| IMEI su un dispositivo con root | ./tools/nvram/live_patch.sh | IMEI live |
| Indirizzi WiFi/BT in un file locale o immagine | python3 tools/nvram/mac_tool.py | MAC offline |
| Indirizzi WiFi/BT su un dispositivo con root | ./tools/nvram/live_patch_mac.sh | MAC live |
| Coppia esatta di firmware modem/LK biloba | Patcher Python versionati | Patcher Biloba |
Esegui dalla radice del repository:
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
Gli strumenti offline accettano record individuali o immagini di partizione supportate. Consulta le guide per le regole di rilevamento, i record duplicati, i backup e la gestione degli errori.
./tools/nvram/live_patch.sh e ./tools/nvram/live_patch_mac.sh estraggono i record, richiedono le modifiche, inviano i file modificati e offrono un riavvio. Segui la guida IMEI live o MAC live per i requisiti e la verifica.
| Dispositivo | Risultato registrato |
|---|---|
| F21 Pro | Flussi IMEI e WiFi/BT verificati su hardware |
| F25 | IMEI verificato tramite il tester; WiFi/BT confermato tramite il port Java |
| TIQ M5 | Flussi IMEI dual-SIM e WiFi/BT verificati su hardware |
| Modem Biloba V12 + LK fornito | Patch firmware abbinata segnalata funzionante; patch solo modem in bootloop |
| Modem Biloba V13 + LK incluso | Controlli offline superati; nessun risultato su hardware segnalato |
| Modem Biloba V14 + LK incluso | Controlli offline superati; nessun risultato su hardware segnalato |
La validazione dettagliata distingue test diretti, segnalazioni esterne e controlli offline. L'identità condivisa del chipset non stabilisce la compatibilità. Biloba aggiunge un controllo firmato dei dati critici; gli strumenti NVRAM non applicano le sue modifiche al firmware. Vedi stato e limiti di Biloba.
La randomizzazione MAC per rete di Android può nascondere l'indirizzo del dispositivo. Android 12+ memorizza inoltre nella cache il MAC WiFi di fabbrica; lo script live aggiorna quella cache, mentre una modifica offline della partizione da sola non lo fa. Vedi comportamento del MAC live e riscontri sul dispositivo.
| Posizione | Scopo |
|---|---|
| tools/nvram/ | Strumenti NVRAM offline e script ADB live |
| docs/ | Guide, formati, riscontri sui dispositivi e spiegazioni della ricerca |
| firmware/biloba/ | Patcher firmware versionati e runner di riproduzione |
| research/biloba/ | Helper di analisi, harness di esecuzione e prove salvate |
| tests/ | Driver di regressione NVRAM e controlli del repository |
tmp/, runs/ | Campioni locali, backup e risultati generati ignorati |
Le immagini firmware, i dump delle partizioni e le chiavi private non sono inclusi.