Сборка образов прошивки
Для сборки образов прошивки контроллера подготовлен специальный образ Docker. Процесс сборки можно производить внутри этого образа как в автоматическом так и в ручном режиме. Также возможно использовать скрипты для сборки без контейнера, после предварительной настройки окружения.
Подготовка
Установка Docker
Перый шаг - это установка Docker В зависимости от используемого дистрибутива - устанавливается по-разному, для Debian:
sudo apt install apt-transport-https ca-certificates curl gnupg2 software-properties-common -y
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"
sudo apt update
sudo apt install docker-ce -y
Не забудьте добавить пользователя в группу docker, чтобы не использовать sudo
sudo usermod -aG docker ${USER}
После добавления пользователя надо выйти-зайтичтобы изменения применились
Скачивание скрипта
Создаем папку и скачиваем скрипт
Более подробно - тут: [1]
mkdir ~/wirenboard-wbdev
cd ~/wirenboard-wbdev
git clone https://github.com/wirenboard/wirenboard
cd wirenboard
Выкачивание образа
Запускаем:
./wbdev root exit
Важно: Образ займет ~5,5 ГБ на /var
Cборка образа
Автоматическая сборка
Готовим файл с командами:
cat << EOFcommand > tmp.sh
#!/bin/bash
apt-get update
apt-get install -y kpartx zip device-tree-compiler u-boot-tools=2016.11+dfsg1-4 libfdt1 binutils
echo Remove exist rootfs for re-create
rm -rf /rootfs/$WBDEV_TARGET
mount -t devtmpfs none /dev
rm -rf ./output/rootfs_wb6x
bash -x ./rootfs/create_rootfs.sh 6x
echo Create new clean rootfs
./image/create_images.sh 6x
rm tmp.sh
EOFcommand
chmod a+x tmp.sh
Запускаем контейнер, при этом передаем архитектуру "цели":
WBDEV_TARGET=stretch-armhf ./wbdev root ./tmp.sh
Важно: Изменения внутри контейнера не сохранятся
Ручная сборка
По сути - то же самое, но команды выполняются вручную, есть возможность изменить параметры.
Запуск контейнера
Запускаем в том же каталоге ~/wirenboard-wbdev/wirenboard
~/wirenboard-wbdev/wirenboard
WBDEV_TARGET=stretch-armhf ./wbdev root
Подготовка rootfs
Скрипт для подготовки корневой ФС находится в директории rootfs.
Как использовать скрипт create_rootfs.sh:
$ ./create_rootfs.sh <path_to_new_rootfs> <board_ver> [<list of additional repos>]
Здесь:
- path_to_new_rootfs - имя директории, в которой будет создана корневая ФС. Директория будет создана автоматически;
- board_ver - версия контроллера, для которого готовится образ. Допустимые значения:
- 5 - для Wiren Board 5
- 55 - для Wiren Board 5.5
- 4 - для Wiren Board 4
- 32 - для WB Smart Home (3.2)
- 28
- NETMON
- MKA3
- CQC10
- MKA31
- AC-E1
- list of additional repos - адреса дополнительных репозиториев с тестовыми пакетами (см. ниже). Опциональный параметр.
Пример. Собираем базовую (без доп. репозиториев) корневую ФС в директории rootfs/rootfs для Wiren Board 5.5:
$ cd rootfs $ ./create_rootfs.sh ./rootfs/ 55
Дополнительные репозитории
Добавление дополнительных репозиториев необходимо, если вы хотите добавить свои версии пакетов в собираемую корневую ФС.
В скрипт передаются только адреса репозиториев. Например:
$ ./create_rootfs.sh ./rootfs/ 55 http://server1.net/ http://server2.net:8086/
Формат репозиториев соответствует тому, который создаётся с помощью утилиты wbrepo. Конкретно, к дополнительному репозиторию предъявляются следующие требования:
- В корне на сервере репозитория должен храниться публичный GPG-ключ в файле /repo.gpg.key. Например, если репозиторий расположен по адресу http://localhost:8086/, то ключ должен быть доступен по ссылке http://localhost:8086/repo.gpg.key
- Имя используемого дистрибутива - testing
- Используемый компонент - main
То есть, если передан адрес репозитория http://localhost:8086/, то в sources.list он будет представлен как
deb http://localhost:8086/ testing main
Сборка образа для загрузки на контроллер
TODO: раздел требует дополнения
Скрипты для сборки образов находятся в директории images. Перед сборкой образа необходима готовая корневая ФС.
Дополнительно на хост-машине потребуются утилиты (названия приведены для Debian/Ubuntu):
- kpartx
- device-tree-compiler
- u-boot-tools
Пример: собираем образ прошивки для Wiren Board 5, корневая ФС находится по пути rootfs/rootfs/:
$ cd image $ ./create_images_wb5.sh ../rootfs/rootfs/ <tag>
Здесь tag - суффикс, который будет добавлен к имени файла образа.
Готовый образ будет лежать по пути image/image/wb5/<current_datetime>/<current_datetime>_emmc_<tag>.img.