¶ Репозиторий
Система сборки находится здесь
¶ Общая схема
Сборка основана на Buildroot и выполняется в Docker-контейнере.
Сборочный target выбирает не конкретную плату, а семейство/версию ядра. Поддержка конкретных плат добавляется через DTS/DTB, которые включаются в образ.
Итоговый образ содержит:
- boot-раздел с
Image, DTB иextlinux.conf; - busybox rootfs;
- Debian rootfs.
¶ Поддерживаемые target
Актуальный список target можно посмотреть командой:
make
На текущий момент доступны:
make atb_arm64_mainline_linux_6_1
make atb_arm64_mainline_linux_6_18
make atb_arm64_vendor_linux_6_1
make atb_arm64_vendor_linux_5_10_190_alt
| Target | Ядро |
|---|---|
atb_arm64_mainline_linux_6_1 |
mainline Linux 6.1 |
atb_arm64_mainline_linux_6_18 |
mainline Linux 6.18 |
atb_arm64_vendor_linux_6_1 |
vendor Linux 6.1 |
atb_arm64_vendor_linux_5_10_190_alt |
vendor Linux 5.10.190 |
¶ Поддержка плат
Конкретная плата выбирается не отдельным Buildroot target, а через DTB/DTS.
DTS и board-specific скрипты находятся в дереве:
atb_tree/board/<soc>/<board>/<kernel>/
Общие Buildroot defconfig находятся здесь:
atb_tree/configs/
Общие kernel config и patches находятся здесь:
atb_tree/board/common/kernel_config/
atb_tree/board/common/kernel_patch/
DTS добавляются в kernel source через ATB Linux extension hooks. Скрипты подключения называются:
add.sh
¶ Рекомендуемая операционная система
Рекомендуется использовать системы на базе Debian:
- Debian
- Ubuntu
- Linux Mint
В теории подойдёт любая Linux-система с установленными:
gitgit-lfsmake- Docker
¶ Установка зависимостей в Ubuntu 22.04
¶ Docker
wget -O get-docker.sh https://get.docker.com
sudo sh get-docker.sh
sudo usermod -aG docker ${USER}
newgrp docker
¶ git, git-lfs и make
sudo apt update
sudo apt -y install git git-lfs make
¶ Сборка
Для сборки необходимо стабильное интернет-соединение.
¶ Последовательность действий
- Скачать репозиторий:
git clone https://git.atb-e.ru/cpu_soft/atb-buildroot.git
- Перейти в директорию проекта:
cd atb-buildroot
- Посмотреть список доступных target:
make
- Выбрать нужную версию ядра и запустить соответствующий target.
Например, для сборки ARM64-образа с vendor Linux 6.1:
make atb_arm64_vendor_linux_6_1
После этой команды будет подготовлен Buildroot, собран Docker-образ и запущен Docker-контейнер. Внутри контейнера автоматически применяется соответствующий Buildroot defconfig.
Консоль контейнера выглядит примерно так:
root@atb-buildroot:/build/output#
- Внутри контейнера запустить сборку:
make
Сборка загрузит необходимые исходники и соберёт систему. Процесс может занять несколько часов.
При успешном завершении появится сообщение:
################################
# BUILD COMPLETED SUCCESSFULLY #
################################
- Выйти из контейнера:
exit
¶ Собранный образ системы
После сборки образ находится в директории:
output/<TARGET>/images/sd_emmc_<TARGET>.img
Например:
output/atb_arm64_vendor_linux_6_1/images/sd_emmc_atb_arm64_vendor_linux_6_1.img
¶ Запись на SD карту
¶ Запись через консоль
Чтобы записать SD карту необходимо выйти из контейнера!
Для записи SD карты подготовлена специальная команда:
make burn_sd_card
После запуска скрипт покажет список доступных target:
Image list:
1: atb_arm64_mainline_linux_6_1
2: atb_arm64_mainline_linux_6_18
3: atb_arm64_vendor_linux_6_1
4: atb_arm64_vendor_linux_5_10_190_alt
Select image (number):
Нужно выбрать номер target, который был собран ранее.
После этого скрипт покажет список подключённых hotplug-накопителей:
Storage list:
1: /dev/sdb usb 59.7G SD Card Reader
Нужно выбрать номер накопителя для записи.
Затем скрипт покажет выбранный образ и накопитель:
Image: atb_arm64_vendor_linux_6_1
Storage: /dev/sdb
Do you want to continue? [y/N]
Для продолжения нужно ввести: y
После подтверждения будет выполнена запись образа: output/<TARGET>/images/sd_emmc_<TARGET>.img, на выбранный накопитель.
Например, для target atb_arm64_vendor_linux_6_1 будет записан файл: output/atb_arm64_vendor_linux_6_1/images/sd_emmc_atb_arm64_vendor_linux_6_1.img
ВНИМАНИЕ: запись полностью перезапишет выбранный накопитель. Перед подтверждением обязательно проверьте, что выбран правильный /dev/sdX.
¶ Запись через графический интерфейс
Записать файл "sd_emmc_<TARGET>.img" на sd карту можно с помощью графической утилиты.
Например balenaEtcher
¶ Запись на EMMC
EMMC память напаяна на плату с процессором, поэтому запись EMMC осуществляется с целевого устройства.
- Записать файл "sd_emmc_<TARGET>.img" в корень USB Flash накопителя
- Вставить USB Flash накопитель в целевое устройство
- Запустить на целевом устройстве систему с SD карты
- Примонтировать USB накопитель командой
mount /dev/<sdX> /mnt
Где:
<path_to_sd_emmc.img> - путь к собранному образу системы
<sdX> - идентификатор диска (USB накопителя)
- записать образ на EMMC командой
sudo dd if=mnt/sd_emmc_<TARGET>.img of=/dev/mmcblk0; sync
¶ Готовые образы
В GIT репозитории включена автоматическая сборка.
Чтобы скачать образ необходимо перейти по данной ссылке
- Убедитесь что есть пометка "latest"
- Нажмите на кнопку загрузки
- В выпадающем списке выберите необходимый файл
Образы упакованы в zip архив.
Перед запистью архив необходимо распаковать!!!