Отказ от ответственности

Автоматически экспортировано с google.com/p/firmware-mod-kit

Firmware Modification Kit

Этот набор представляет собой коллекцию скриптов и утилит для извлечения и пересборки образов встроенного ПО на базе Linux.

Извлечение образа прошивки на составные части
Пользователь вносит желаемые изменения в файловую систему прошивки или веб-интерфейс (webif)
Пересборка прошивки
Загрузка модифицированной прошивки на устройство и превращение его в «кирпич» (ха)

ПРЕДУПРЕЖДЕНИЕ: Используя этот набор, вы превратите ваше устройство в «кирпич» (возможно, нет, но лучше сказать, что превратите). «Кирпич» означает, что устройство фактически становится неработоспособным. Иногда восстановление возможно без аппаратных модификаций. Иногда требуются аппаратные доработки (например, припайка разъёмов последовательного порта или JTAG на печатную плату). Иногда это просто нецелесообразно или затраты на восстановление превышают стоимость самого устройства.

НЕ используйте этот набор, если вы не готовы к тому, что ваш роутер превратится в «кирпич»!

Лицензионное соглашение (EULA): Загружая или используя этот набор, вы соглашаетесь принять на себя ответственность за последствия использования или неправильного использования Firmware Mod Kit. Эти последствия включают превращение вашего устройства в «кирпич». Авторы набора вас предупредили. Данный набор предназначен только для инженеров-программистов встраиваемых систем.

Firmware Mod Kit

• Введение
• Предварительные требования
• Использование набора
  • Исполняемые файлы набора
  • Рабочий каталог прошивки
  • Извлечение прошивки
  • Пересборка прошивки
  • Изменение веб-страниц DD-WRT
  • Возврат к заводской прошивке
  • Примеры
  • Прошивки Linksys
  • Инструменты / Утилиты
• Ссылки

Введение

Firmware Mod Kit позволяет легко разбирать и собирать образы прошивок для различных встраиваемых устройств. Хотя он в первую очередь ориентирован на роутеры на базе Linux, он должен быть совместим с большинством прошивок, использующих распространённые форматы прошивок и файловые системы, такие как TRX/uImage и SquashFS/CramFS.

Предварительные требования

Для использования Firmware Mod Kit вам понадобится клиент Subversion, стандартные инструменты разработки Linux (gcc, make и т.д.), модуль python-magic и пакеты разработки zlib и lzma. Если вы используете дистрибутив Linux с apt-get, например Ubuntu или Debian, выполните:

Для Ubuntu 18.04 и старше:

sudo apt-get install git build-essential zlib1g-dev liblzma-dev python-magic autoconf

Для Ubuntu 20.04 и новее:

sudo apt-get install git build-essential zlib1g-dev liblzma-dev python3-magic autoconf python-is-python3

Для RedHat:

yum groupinstall "Development Tools"
yum install git zlib1g-dev xz-devel python-magic zlib-devel util-linux

Для Arch Linux:

Существует пакет AUR для https://aur.archlinux.org/packages/firmware-mod-kit/

Для других дистрибутивов установите эквивалентные пакеты с помощью менеджера пакетов вашего дистрибутива.

git clone https://github.com/rampageX/firmware-mod-kit.git
cd firmware-mod-kit/src
make

Binwalk 2.1.1

[Back in firmware-mod-kit directory]
cd src/binwalk-2.1.1
sudo python2 setup.py install

Firmware Mod Kit поддерживается только на платформе Linux. С небольшими изменениями он должен работать на других POSIX-платформах.

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

Клонируйте репозиторий Firmware Modification Kit с помощью Git.

Исполняемые файлы набора

Firmware Mod Kit представляет собой набор утилит и скриптов оболочки. Утилиты можно использовать напрямую, а скрипты оболочки — для автоматизации и объединения типовых операций с прошивкой (например, извлечение и пересборка). Основные скрипты для работы с прошивкой перечислены ниже.

Основные скрипты:

Вспомогательные скрипты:

Рабочий каталог прошивки

Firmware Mod Kit использует «жёстко заданный» рабочий каталог с именем «fmk». Скрипт извлечения извлекает данные в эту папку, а скрипт пересборки собирает из неё. Возможность использования альтернативных рабочих каталогов поддерживается для некоторых операций, но не для всех. В будущем мы расширим эту возможность. Пока же, если у вас несколько рабочих каталогов, рекомендуем переименовывать те, с которыми вы сейчас не работаете.

Извлечение прошивки

Автоматизированное извлечение прошивки обычно работает с большинством образов прошивок, использующих заголовки uImage/TRX и файловые системы SquashFS или CramFS. В настоящее время extract-firmware.sh является предпочтительным методом извлечения, так как поддерживает больше типов прошивок, чем старый скрипт old-extract.sh. Однако old-extract.sh всё ещё включён в состав и работает со многими форматами прошивок.

Использование как extract-firmware.sh, так и build-firmware.sh просто:

./extract-firmware.sh firmware.bin

По умолчанию выходные данные extract-firmware.sh будут расположены в каталоге «fmk», в то время как old-extract.sh помещает извлечённые данные в указанный рабочий каталог.

Пересборка прошивки

Какой скрипт сборки использовать, зависит от того, какой скрипт извлечения применялся. Если вы извлекли образ прошивки с помощью extract-firmware.sh, то для пересборки необходимо использовать build-firmware.sh. Аналогично, если использовался old-extract.sh, то для пересборки образа следует вызывать old-build.sh:

./build-firmware.sh [-nopad] [-min]

Новая прошивка, созданная build-firmware.sh, будет находиться по пути «fmk/new-firmware.bin», в то время как old-build.sh создаёт образы прошивок в нескольких различных форматах и сохраняет их в указанном выходном каталоге.

Необязательный параметр -nopad указывает build-firmware.sh НЕ дополнять прошивку до исходного размера.

Необязательный параметр -min использует максимальный размер блока squashfs в 1 МБ. Это уменьшит размер образа прошивки ценой увеличения загрузки ЦП и оперативной памяти на целевом устройстве. Не используйте этот параметр без необходимости. Это очень большой размер блока для встраиваемых систем. Исходный размер блока squashfs прошивки сохраняется при пересборке, и следует использовать исходный размер блока, если вы не уверены в том, что делаете. Слишком большой размер блока может работать нормально, но производительность прошивки во время выполнения может снизиться как при всех, так и при некоторых нагрузках.

Изменение веб-страниц DD-WRT

Одной из уникальных особенностей Firmware Mod Kit является возможность извлекать и пересобирать файлы из веб-интерфейса DD-WRT. Это автоматизируется скриптами ddwrt-gui-extract.sh и ddwrt-gui-restore.sh.

После того как вы извлекли образ прошивки DD-WRT с помощью extract-firmware.sh, вы можете извлечь веб-файлы, выполнив:

./ddwrt-gui-extract.sh

Это создаст каталог с именем «www» и извлечёт туда веб-файлы. Вы можете изменять файлы любым способом, но не можете добавлять или удалять файлы.

Когда вы закончите редактирование, вы можете пересобрать веб-файлы, выполнив:

./ddwrt-gui-rebuild.sh

Возврат к заводской прошивке

Иногда вы с энтузиазмом прошиваете стороннюю прошивку, например Gargoyle или DD-WRT, только чтобы обнаружить, что в ней отсутствуют необходимые функции, она работает хуже заводской прошивки или имеет функциональные проблемы. В такой ситуации вы можете захотеть вернуться к заводской прошивке, но не иметь возможности это сделать!

Вот как Firmware Mod Kit может помочь вам вернуться к заводской прошивке. Процесс выглядит следующим образом:

1. Извлеките заводскую прошивку. Затем переименуйте каталог 'fmk'.
2. Извлеките стороннюю 'upgrade' прошивку (например, Gargoyle-sysupgrade)
3. Замените извлечённые rootfs и image_parts сторонней прошивки на соответствующие из заводской прошивки.
4. Пересоберите образ прошивки
5. Прошейте образ заводской прошивки (теперь упакованный в формате, ожидаемом вашей сторонней прошивкой).
6. Если всё прошло успешно, вы снова используете заводскую прошивку.

Как только вы вернулись к заводской прошивке, она снова принимает образы заводских прошивок.

Примеры

В этом примере показано, как извлечь образ прошивки, заменить существующий демон telnet на собранный вручную, а затем собрать новый образ прошивки:

./extract-firmware.sh firmware.bin
cp new-telnetd fmk/rootfs/usr/sbin/telnetd
./build-firmware.sh

Ниже приведён пример команд, необходимых для извлечения образа прошивки DD-WRT, изменения веб-страницы индекса и сборки нового образа прошивки:

./extract-firmware.sh firmware.bin
./ddwrt-gui-extract.sh
echo "HELLO WORLD" > www/index.asp
./ddwrt-gui-rebuild.sh
./build-firmware.sh

Прошивки Linksys

Linksys использует пользовательские футеры с проверкой контрольной суммы, поэтому был написан этот скрипт для автоматизации процесса расчёта контрольной суммы образа и соответствующего изменения футера. Новый образ будет записан в modified_checksum.img. Запускайте этот скрипт после модификации и build-firmware.sh.

./linksys_footer.sh modified_firmware.img

Инструменты / Утилиты

Firmware Mod Kit состоит из набора инструментов, полезных при работе с образами встраиваемого ПО. Сюда входят перечисленные ниже, но есть МНОГО ДРУГИХ, которые здесь не указаны.

Другие ссылки

Форум