4
правки
N.maslov (обсуждение | вклад) (Привёл в порядок скрипт автоматического создания FIT-образа) |
|||
(не показана 21 промежуточная версия 5 участников) | |||
Строка 2: | Строка 2: | ||
= Подготовка = | = Подготовка = | ||
== Установка Docker и подготовка хост-системы == | == Установка Docker и подготовка хост-системы == | ||
Перый шаг — это установка [https://docs.docker.com/ Docker]. | Перый шаг — это установка [https://docs.docker.com/ Docker]. | ||
Строка 33: | Строка 33: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== Выкачивание образа == | == Выкачивание образа Docker-контейнера == | ||
{{note|info|Учитывайте, что образ контейнера займет ~5.5 Гб на <code>/var</code>}} | |||
Запускаем: | Запускаем: | ||
<syntaxhighlight lang="console"> | <syntaxhighlight lang="console"> | ||
$ ./wbdev root exit | $ ./wbdev root exit | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Команда выкачает, затем запустит контейнер и завершится. Отсутствие ошибок - покажет что контейнер работает нормально. | |||
=Cборка образа= | =Cборка образа= | ||
Про идеологию разделов контроллера можно прочитать на странице [[WB_Firmware_Update_Details | Обновление прошивки, информация для разработчиков]]. | Про идеологию разделов контроллера можно прочитать на странице [[WB_Firmware_Update_Details | Обновление прошивки, информация для разработчиков]]. | ||
==Автоматическая сборка== | ==Автоматическая сборка== | ||
Готовим файл с командами. Для Wiren Board 6 версии до 6.7 задаём переменную <code>BOARD=6x</code>, от 6.7 и выше - <code>BOARD=67</code>. | Готовим файл с командами. Для Wiren Board 6 версии до 6.7 задаём переменную <code>BOARD=6x</code>, от 6.7 и выше - <code>BOARD=67</code>. Для WB7 - <code>BOARD=7x</code> | ||
Сразу создаем каталог <code>mkdir ./output/images/</code> | |||
Релиз, на основе которого будет собран образ, задаётся в переменной <code>WB_RELEASE</code>. | |||
'''Обратите внимание''': если корневая ФС была отредактирована, нужно удалить строки в скрипте, отвечающие за удаление старой и создание новой корневой ФС | '''Обратите внимание''': если корневая ФС была отредактирована, нужно удалить строки в скрипте, отвечающие за удаление старой и создание новой корневой ФС | ||
(отмечены комментарием в скрипте): | (отмечены комментарием в скрипте): | ||
<blockquote>'''Важно:''' кэш сохраняется по пути /home/XXX/wbdev/go/src/github.com/contactless/wirenboard/output - | |||
эта же папка шарена между нашим хостом и докером, из неё мы и запускаем ./wbdev. Если у вас что-то сбоит на старых версиях - можно переиначить все пути на | |||
<syntaxhighlight>/root/rootfs/ </syntaxhighlight> | |||
но при этом будет потеряна возможность использовать кэш при сборке. | |||
'''дополнительно:''' DEBIAN_RELEASE= в скрипте есть смысл ставить тот который требуется в зависимости от версии board. wb6 со скриптом ниже не заработает без изменения релиза на предыдущий. | |||
</blockquote> | |||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
$ BOARD= | $ BOARD=7x; WB_RELEASE=stable; DEBIAN_RELEASE=stretch; cat << EOFcommand > tmp.sh | ||
#!/bin/bash | #!/bin/bash | ||
apt-get update | apt-get update | ||
apt-get install -y kpartx zip device-tree-compiler u-boot-tools | apt-get install -y kpartx zip device-tree-compiler u-boot-tools libfdt1 binutils | ||
mount -t devtmpfs none /dev | mount -t devtmpfs none /dev | ||
export ROOTFS=./output/rootfs_wb${BOARD} | export ROOTFS=./output/rootfs_wb${BOARD} | ||
Строка 61: | Строка 74: | ||
echo "Create new clean rootfs" | echo "Create new clean rootfs" | ||
rm -rf \$ROOTFS | rm -rf \$ROOTFS | ||
/root/rootfs/create_rootfs.sh ${BOARD} | WB_RELEASE=${WB_RELEASE} DEBIAN_RELEASE=${DEBIAN_RELEASE} rootfs/create_rootfs.sh ${BOARD} | ||
# можно использовать /root/rootfs/create_rootfs.sh ${BOARD} но в этом случае у вас не будет использоваться кэш сокращающий время компиляции в 2 раза | |||
echo "Create .fit image" | echo "Create .fit image" | ||
./image/create_images.sh ${BOARD} | ./image/create_images.sh ${BOARD} | ||
echo "fix permissions" | echo "fix permissions" | ||
chown ${UID} -R ./output/images/ | |||
rm tmp.sh | #Uncomment next string for remove script | ||
#rm tmp.sh | |||
EOFcommand | EOFcommand | ||
</syntaxhighlight> | </syntaxhighlight> | ||
<blockquote>'''Важно:'''u-boot-tools=2016.11+dfsg1-4 - больше не требуется. Но если вам вдруг надо на старой wb поставить именно его - | |||
<syntaxhighlight>wget https://cloudfront.debian.net/debian-archive/debian/pool/main/u/u-boot/u-boot-tools_2016.11+dfsg1-4_amd64.deb | |||
dpkg -i u-boot-tools_2016.11+dfsg1-4_amd64.deb | |||
rm u-boot-tools_2016.11+dfsg1-4_amd64.deb </syntaxhighlight></blockquote> | |||
Запускаем скрипт в контейнере: | |||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
$ | $ ./wbdev root bash ./tmp.sh | ||
</syntaxhighlight> | </syntaxhighlight> | ||
<blockquote>'''Важно:''' Изменения внутри контейнера не сохранятся </blockquote> | <blockquote>'''Важно:''' Изменения внутри контейнера не сохранятся </blockquote> | ||
После завершения — «корневая» файловая система остается в каталоге <code>./output/ | После завершения — «корневая» файловая система остается в каталоге <code>./output/rootfs_wbXX</code> (XX соответствует значению <code>BOARD</code>)и доступна для следующего использования. Можно изменять и дополнять в «ручном» режиме. | ||
Готовый для загрузки в контроллер образ — в <code>./output/images/YYYYMMDDHHMM</code> | Готовый для загрузки в контроллер образ — в <code>./output/images/YYYYMMDDHHMM</code> | ||
Строка 88: | Строка 108: | ||
Запускаем в том же каталоге <code>~/wirenboard-wbdev/wirenboard</code> следующую команду: | Запускаем в том же каталоге <code>~/wirenboard-wbdev/wirenboard</code> следующую команду: | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
~/wirenboard-wbdev/wirenboard | ~/wirenboard-wbdev/wirenboard$ ./wbdev root | ||
</syntaxhighlight> | </syntaxhighlight> | ||
и после запуска контейнера готовим среду, команды те же что и в «автоматическом» режиме: | и после запуска контейнера готовим среду, команды те же что и в «автоматическом» режиме: | ||
<syntaxhighlight lang=" | <syntaxhighlight lang="console"> | ||
apt-get update && \ | # apt-get update && \ | ||
apt-get install -y kpartx zip device-tree-compiler u-boot-tools=2016.11+dfsg1-4 libfdt1 binutils && \ | apt-get install -y kpartx zip device-tree-compiler u-boot-tools=2016.11+dfsg1-4 libfdt1 binutils && \ | ||
mount -t devtmpfs none /dev | mount -t devtmpfs none /dev | ||
Строка 101: | Строка 120: | ||
Если rootfs уже создана ранее, то просто указываем ее расположение (переменная ROOTFS). | Если rootfs уже создана ранее, то просто указываем ее расположение (переменная ROOTFS). | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
export ROOTFS=./output/ | export ROOTFS=./output/rootfs_wb7x | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Скрипт для подготовки корневой файловой системы находится в директории <code> | Скрипт для подготовки корневой файловой системы находится в директории <code>wirenboard/rootfs</code>. | ||
Синтаксис запуска скрипта <code>create_rootfs.sh</code>: | Синтаксис запуска скрипта <code>create_rootfs.sh</code>: | ||
Строка 114: | Строка 133: | ||
Здесь: | Здесь: | ||
* ''board_ver'' — версия контроллера, для которого готовится образ. Допустимые значения: | * ''board_ver'' — версия контроллера, для которого готовится образ. Допустимые значения: | ||
** 7x - для Wiren Board 7 | |||
** 67 — для Wiren Board 6.7 и выше | |||
** 6x — для Wiren Board 6-6.6 | ** 6x — для Wiren Board 6-6.6 | ||
** 5 — для Wiren Board 5 | ** 5 — для Wiren Board 5 | ||
Строка 129: | Строка 150: | ||
Зададим расположение ФС, уже существующей или вновь создаваемой: | Зададим расположение ФС, уже существующей или вновь создаваемой: | ||
<syntaxhighlight lang=" | <syntaxhighlight lang="console"> | ||
export ROOTFS=./output/rootfs_wb6x | # export ROOTFS=./output/rootfs_wb6x | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Пример. Собираем базовую (без доп. репозиториев) корневую ФС в директории <code>rootfs/rootfs</code> для Wiren Board | Пример. Собираем базовую (без доп. репозиториев) корневую ФС в директории <code>rootfs/rootfs</code> для Wiren Board 7x: | ||
< | <syntaxhighlight lang="console"> | ||
# cd rootfs | |||
# ROOTFS=./rootfs/rootfs_7x WB_RELEASE=stable DEBIAN_RELEASE=stretch ./create_rootfs.sh 7x | |||
</ | </syntaxhighlight> | ||
Если не используем уже существующую, то создаем: | Если не используем уже существующую, то создаем: | ||
<syntaxhighlight lang=" | <syntaxhighlight lang="console"> | ||
export ROOTFS=./output/ | # export ROOTFS=./output/rootfs_wb7x | ||
# export WB_RELEASE=stable DEBIAN_RELEASE=stretch | |||
# wirenboard/rootfs/create_rootfs.sh 7x | |||
</syntaxhighlight> | </syntaxhighlight> | ||
Строка 152: | Строка 174: | ||
Добавление дополнительных репозиториев необходимо, если вы хотите добавить свои версии пакетов в собираемую корневую ФС. | Добавление дополнительных репозиториев необходимо, если вы хотите добавить свои версии пакетов в собираемую корневую ФС. | ||
Добавляется при помощи wbrepo, общий мануал https://github.com/wirenboard/wirenboard/blob/master/README-wbrepo.md | |||
В скрипт передаются ''только адреса'' репозиториев. Например: | В скрипт передаются ''только адреса'' репозиториев. Например: | ||
< | <syntaxhighlight lang="console"> | ||
# ./create_rootfs.sh 55 http://server1.net/ http://server2.net:8086/ | |||
</ | </syntaxhighlight> | ||
Формат репозиториев соответствует тому, который создаётся с помощью утилиты [[Special:MyLanguage/wbrepo|wbrepo]]. К дополнительному репозиторию предъявляются требования: | Формат репозиториев соответствует тому, который создаётся с помощью утилиты [[Special:MyLanguage/wbrepo|wbrepo]]. К дополнительному репозиторию предъявляются требования: | ||
* В корне на сервере репозитория должен храниться публичный GPG-ключ в файле <code>/repo.gpg.key</code>. Например, если репозиторий расположен по адресу http://localhost:8086/, то ключ должен быть доступен по ссылке http://localhost:8086/repo.gpg.key | * В корне на сервере репозитория должен храниться публичный GPG-ключ в файле <code>/repo.gpg.key</code>. Например, если репозиторий расположен по адресу http://localhost:8086/, то ключ должен быть доступен по ссылке http://localhost:8086/repo.gpg.key | ||
* Имя используемого дистрибутива — testing | * Имя используемого дистрибутива — testing (если не менялся код в ) | ||
* Используемый компонент — main | * Используемый компонент — main | ||
При использовании wbrepo с хоста из докера можно найти их на http://172.17.0.1:8086/ - просто оставьте wbrepo serve запущенным на хосте и вызовите из докера | |||
<syntaxhighlight lang="console"> | |||
# ./create_rootfs.sh 7x http://172.17.0.1:8086/ | |||
</syntaxhighlight> | |||
При изменении имени дистрибутива - отредактировать в https://github.com/wirenboard/wirenboard/blob/master/wbrepo | |||
<pre> | |||
DISTRIBUTION=testing #меняем тут testing на нужное наименование дистрибутива | |||
</pre> | |||
Или смотрим под какой дистрибутив запустился сервер под wbrepo serve и меняем на нужный в ручном запуске | |||
<pre> | |||
./rootfs/create_rootfs.sh 7x http://172.17.0.1:8086@testing:main | |||
</pre> | |||
То есть, если передан адрес репозитория http://localhost:8086/, то в <code>sources.list</code> он будет представлен как | То есть, если передан адрес репозитория http://localhost:8086/, то в <code>sources.list</code> он будет представлен как | ||
Строка 169: | Строка 204: | ||
deb http://localhost:8086/ testing main | deb http://localhost:8086/ testing main | ||
</pre> | </pre> | ||
При проблемах - посмотрите внимательно на <code>curl -v</code> вывод адреса репозитория | |||
=== Работа внутри корневой ФС === | === Работа внутри корневой ФС === | ||
Строка 174: | Строка 210: | ||
Для того чтобы установить какие-нибудь дополнительные пакеты в корневую систему используется chroot. | Для того чтобы установить какие-нибудь дополнительные пакеты в корневую систему используется chroot. | ||
Если уже создана ФС в каталоге <code>./output/rootfs_wb6x</code> то делаем chroot в нее: | Если уже создана ФС в каталоге <code>./output/rootfs_wb6x</code> то делаем chroot в нее: | ||
<syntaxhighlight lang=" | |||
./output/rootfs_wb6x/chroot_this.sh | <syntaxhighlight lang="console"> | ||
# ./output/rootfs_wb6x/chroot_this.sh | |||
</syntaxhighlight> | </syntaxhighlight> | ||
и можно изменить параметры и/или добавить пакеты. Добавим, например, lsof | и можно изменить параметры и/или добавить пакеты. Добавим, например, lsof | ||
<syntaxhighlight lang=" | <syntaxhighlight lang="console"> | ||
apt update && apt install lsof -y | # apt update && apt install lsof -y | ||
</syntaxhighlight> | </syntaxhighlight> | ||
<blockquote>''Не забывайте '''выйти''' из chroot</blockquote> | <blockquote>''Не забывайте '''выйти''' из chroot</blockquote> | ||
<syntaxhighlight lang=" | <syntaxhighlight lang="console"> | ||
exit | # exit | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== Сборка образа для загрузки на контроллер == | == Сборка образа для загрузки на контроллер == | ||
Скрипты для сборки образов находятся в директории images. Перед сборкой образа необходима '''готовая''' корневая ФС. | Скрипты для сборки образов находятся в директории images. Перед сборкой образа необходима '''готовая''' корневая ФС. | ||
<blockquote>''Не забывайте установить путь у ФС в переменную ROOTFS</blockquote> | <blockquote>''Не забывайте установить путь у ФС в переменную ROOTFS</blockquote> | ||
Пример: собираем образ прошивки для Wiren Board '''6x''', корневая ФС находится по пути $ROOTFS: | |||
<syntaxhighlight lang="console"> | |||
<syntaxhighlight lang=" | # ./image/create_images.sh 6x | ||
./image/create_images.sh 6x | |||
</syntaxhighlight> | </syntaxhighlight> | ||
Владельцем созданных файлов образов будет пользователь root, поэтому после создания файла может понадобиться отдельно дать доступ к нему обычным пользователям, например, так: | |||
<syntaxhighlight lang="console"> | |||
# chown a+rw -R ./output/images/ | |||
</syntaxhighlight> | |||
Готовый образ будет лежать по пути <code>output/image/<current_datetime>/<current_datetime> | Готовый образ будет лежать по пути <code>output/image/<current_datetime>/<current_datetime>_webupd_wb<board>.fit</code>. | ||
== См. также == | == См. также == |
правки