mtk-imei-switcheroo

Чтение и запись записей IMEI и адресов WiFi/Bluetooth в файлах NVRAM MediaTek или образах разделов. Включает интерактивные инструменты ADB для рутированных устройств и отдельные патчеры модема/LK для конкретных версий для biloba.

Установка

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/Bluetooth используют только стандартную библиотеку. Для live-инструментов также требуются ADB и устройство с root-доступом. Полный процесс верификации Biloba имеет отдельные зависимости.

Выбор инструмента

Задача	Команда	Руководство
IMEI в локальном файле или образе раздела	python3 tools/nvram/imei_tool.py	Offline IMEI
IMEI на устройстве с root-доступом	./tools/nvram/live_patch.sh	Live IMEI
Адреса WiFi/BT в локальном файле или образе	python3 tools/nvram/mac_tool.py	Offline MAC
Адреса WiFi/BT на устройстве с root-доступом	./tools/nvram/live_patch_mac.sh	Live MAC
Точная пара прошивок модема/LK biloba	Версионированные Python-патчеры	Biloba patchers

Использование

Запускайте из корня репозитория:

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	Сценарии IMEI для двух SIM и WiFi/BT проверены на оборудовании
Модем Biloba V12 + прилагаемый LK	Патч парной прошивки, по сообщениям, работает; патч только модема привёл к bootloop
Модем Biloba V13 + встроенный LK	Офлайн-проверки пройдены; результат на оборудовании не сообщался
Модем Biloba V14 + встроенный LK	Офлайн-проверки пройдены; результат на оборудовании не сообщался

Подробная валидация различает прямые тесты, внешние отчёты и офлайн-проверки. Общая идентичность чипсета не устанавливает совместимость. Biloba добавляет проверку подписанных критических данных; инструменты NVRAM не применяют её изменения прошивки. См. статус и ограничения biloba.

MAC-адрес WiFi и адрес Bluetooth

Рандомизация MAC-адреса для каждой сети в Android может скрывать адрес устройства. Android 12+ также кэширует заводской MAC-адрес WiFi; живой скрипт обновляет этот кэш, тогда как офлайн-правка раздела сама по себе этого не делает. См. поведение живого MAC и находки по устройствам.

Структура репозитория

Расположение	Назначение
tools/nvram/	Офлайн-инструменты NVRAM и живые скрипты ADB
docs/	Руководства, форматы, находки по устройствам и объяснения исследований
firmware/biloba/	Версионированные патчеры прошивки и средство воспроизведения
research/biloba/	Вспомогательные средства анализа, среды выполнения и сохранённые доказательства
tests/	Драйверы регрессионных тестов NVRAM и проверки репозитория
tmp/, runs/	Игнорируемые локальные образцы, резервные копии и сгенерированные результаты

Образы прошивки, дампы разделов и закрытые ключи не включены.

Связанное

Порт Android-приложения · Благодарности и происхождение · Лицензия