Buildroot — самый быстрый путь от голой платы до загружающегося Linux

Содержание
  1. Как его получить
  2. Начните с defconfig
  3. Доводка через menuconfig
  4. Сборка
  5. Добавление пакета
  6. Buildroot или Yocto

Встраиваемая система на Linux — это четыре вещи: кросс-компиляторный тулчейн, загрузчик, ядро и корневая файловая система ровно с теми программами, которые вам нужны, и ничем больше. Каждую можно собрать вручную. Годами так и делали, и каждый, кто это делал, писал кучу шелл-скриптов, понятных только ему самому. Buildroot — это та же куча скриптов, написанная один раз, как следует, для всех.

Buildroot берёт один конфигурационный файл и воспроизводимо создаёт из исходников все четыре эти вещи. Эта заметка — самый короткий обзор того, как это работает, какой я могу дать.

Как его получить

Скачайте архив релиза или склонируйте репозиторий и распакуйте куда-нибудь, где много места на диске. Сборки объёмны, потому что тулчейн тоже собирается из исходников.

wget https://buildroot.org/downloads/buildroot-2014.02.tar.gz
tar xzf buildroot-2014.02.tar.gz
cd buildroot-2014.02

Нужны обычные инструменты хоста: компилятор C, make, patch, wget и заголовочные файлы ncurses, если вам нужен интерфейс с меню. Buildroot проверяет их наличие и сообщает, чего не хватает.

Начните с defconfig

Buildroot поставляется с конфигурациями по умолчанию для многих распространённых плат. Посмотреть список:

make list-defconfigs

Выберите ближайшую к вашему железу и загрузите её. Например, для Raspberry Pi:

make raspberrypi_defconfig

Это записывает файл .config в корне дерева. Всё дальнейшее читает его. Если вашей платы в списке нет, начните с ближайшего родственника и поменяйте архитектуру и настройки ядра; это всё равно куда меньше работы, чем начинать с нуля.

Доводка через menuconfig

make menuconfig

Меню — то же самое, что у ядра, и организовано оно по четырём перечисленным компонентам:

  • Target options: архитектура, вариант процессора, ABI для плавающей точки.
  • Toolchain: собрать свой из исходников или указать на внешний, который у вас уже есть. Сборка занимает больше времени один раз; внешний путь быстрее, но вы наследуете его выбор библиотеки C и заголовков ядра.
  • Kernel: какая версия, какой defconfig, собирать ли дерево устройств.
  • Bootloader: U-Boot, Barebox или ничего, если у платы свой.
  • Target packages: программы, которые попадут в корневую файловую систему. Busybox включён по умолчанию и даёт вам оболочку и стандартные утилиты в одном маленьком двоичном файле. Всё остальное подключается по желанию.
  • Filesystem images: ext4, squashfs, тарбол, initramfs.

Сохраните и выйдите. Файл .config — единственное состояние, так что держите его в системе контроля версий.

Сборка

make

Идите займитесь чем-нибудь другим. Первая сборка скачивает все архивы исходников, собирает тулчейн, затем ядро, затем все пакеты, затем собирает корневую файловую систему и упаковывает её в образ. Последующие сборки инкрементальны и намного быстрее.

Когда всё закончится, нужное вам лежит в одном каталоге:

output/images/

Там вы найдёте образ ядра, блоб дерева устройств, если он есть, загрузчик и корневую файловую систему в выбранном вами формате. Как записать их на SD-карту или прошить в плату, зависит от платы, и в defconfig обычно прилагается readme.txt в board/<vendor>/<board>/, где это описано.

Добавление пакета

Допустим, вам нужна программа, о которой Buildroot не знает. Каждый пакет — это каталог в package/ с двумя файлами. Файл Config.in, который добавляет его в меню:

config BR2_PACKAGE_HELLO
	bool "hello"
	help
	  A small example program.

и файл hello.mk, который говорит, откуда берутся исходники и как их собирать:

HELLO_VERSION = 1.0
HELLO_SITE = http://example.org/downloads
HELLO_LICENSE = GPL-2.0

$(eval $(autotools-package))

Если программа использует autotools, эта последняя строка — весь рецепт сборки. Есть аналоги для CMake, обычных Makefile, пакетов Python и ещё нескольких случаев. Добавьте строку source "package/hello/Config.in" в package/Config.in, запустите make menuconfig, отметьте галочку и пересоберите.

Buildroot или Yocto

Другой серьёзный вариант — Yocto, и сравнение сводится к одному вопросу: это один продукт или семейство продуктов?

Buildroot собирает один образ из одной конфигурации. Его легко понять, всё целиком — это обычные make и Kconfig, новичок становится продуктивным за день, а пересборка с нуля — ответ на большинство проблем. Он не делает бинарных пакетов, не управляет несколькими образами с общими слоями, и если вы существенно меняете конфигурацию, вы пересобираете всё.

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

Я сначала берусь за Buildroot и перехожу на другое, только когда проект докажет, что ему нужно больше. Большинству никогда не нужно.