Настройка Yocto (Mender)
Мы используем ветвь Yocto Kirkstone для разработки. Предполагается, что у вас уже установлена и настроена рабочая среда разработки (см. статью VisionFive — Mender — Yocto — часть 1).
Настройка сервера Mender
Установка сервера Mender в этой серии статей не описана. Для нашей тестовой среды мы установили сервер Mender в соответствии с руководством по установке с docker-compose (см. статью Установка с Docker Compose).
Примечание
Отклоняясь от руководства, мы используем индивидуально настроенный групповой сертификат ЦС. Если вы хотите это сделать, cкопируйте открытый и закрытый ключи в каталог "/mender-server/production/keys-generated/cert" перед выполнением команды "./run up -d".
Для продолжения вы должны заходить на сервер Mender без сообщений об ошибках.
Клонирование meta-mender
Перейдите в свой каталог poky (в моем случае poky-kirkstone) и клонируйте репозиторий meta-mender. Поскольку ветви Kirkstone еще нет, необходимо клонировать ветвь "master-next".
cd poky-kirkstone
git clone -b master-next https://github.com/mendersoftware/meta-mender.git
local.conf и bblayers.conf
Скопируйте bblayers.conf.sample-mender и local.conf.sample-mender из каталога meta-interelectronix-visionfive в каталог conf и измените названия на bblayers.conf и local.conf:
cp ../poky-kirkstone/meta-interelectronix-visionfive/conf/bblayers.conf.sample-mender conf/bblayers.conf
cp ../poky-kirkstone/meta-interelectronix-visionfive/conf/local.conf.sample-mender conf/local.conf
В файле bblayers.conf задайте путь к каталогу poky-kirkstone. Также удалите строку "/workdir/poky-kirkstone/meta-interelectronix ": она нужна только для настройки psplash.
Важные настройки в local.conf:
# mender settings
# The name of the disk image and Artifact that will be built.
# This is what the device will report that it is running, and different updates must have different names
# because Mender will skip installation of an Artifact if it is already installed.
MENDER_ARTIFACT_NAME = "release-1"
INHERIT += "mender-full"
# The version of Mender to build. This needs to match an existing recipe in the meta-mender repository.
#
# Given your Yocto Project version, see which versions of Mender you can currently build here:
# https://docs.mender.io/overview/compatibility#mender-client-and-yocto-project-version
#
# Given a Mender client version, see the corresponding version of the mender-artifact utility:
# https://docs.mender.io/overview/compatibility#mender-clientserver-and-artifact-format
#
# By default this will select the latest version of the tools that is backwards compatible with the
# given Yocto branch.
# If you need an earlier version, or a later version even though it may not be backwards compatible,
# please uncomment the following and set to the required version. If you want to use the bleeding
# edge version, specify "master-git%", but keep in mind that these versions may not be stable:
#
# PREFERRED_VERSION_mender-client = "3.3.0"
# PREFERRED_VERSION_mender-artifact = "3.8.0"
# PREFERRED_VERSION_mender-artifact-native = "3.8.0"
# PREFERRED_VERSION_mender-connect = "2.0.1"
# The following settings to enable systemd are needed for all Yocto
# releases sumo and older. Newer releases have these settings conditionally
# based on the MENDER_FEATURES settings and the inherit of mender-full above.
DISTRO_FEATURES:append = " systemd"
VIRTUAL-RUNTIME:init_manager = "systemd"
DISTRO_FEATURES_BACKFILL_CONSIDERED = "sysvinit"
VIRTUAL-RUNTIME_initscripts = ""
ARTIFACTIMG_FSTYPE = "ext4"
# Example: Memory card storage
MENDER_STORAGE_DEVICE = "/dev/mmcblk0"
# Example: Memory card with 2GiB of storage.
#MENDER_STORAGE_TOTAL_SIZE_MB = "29476"
#MENDER_STORAGE_TOTAL_SIZE_MB = "14738"
MENDER_STORAGE_TOTAL_SIZE_MB = "7369"
MENDER_UBOOT_STORAGE_INTERFACE = "mmc"
MENDER_UBOOT_STORAGE_DEVICE = "0"
MENDER_BOOT_PART = "${MENDER_STORAGE_DEVICE_BASE}1"
MENDER_DATA_PART = "${MENDER_STORAGE_DEVICE_BASE}4"
MENDER_ROOTFS_PART_A = "${MENDER_STORAGE_DEVICE_BASE}2"
MENDER_ROOTFS_PART_B = "${MENDER_STORAGE_DEVICE_BASE}3"
MENDER_FEATURES_ENABLE:append = " mender-uboot mender-image-sd"
MENDER_FEATURES_DISABLE:append = " mender-grub mender-image-uefi"
MACHINE_ESSENTIAL_EXTRA_RDEPENDS:append = " kernel-image kernel-devicetree"
PREFERRED_VERSION:mender-client = "3.3.0"
Настройка meta-starfive-bsp
Создайте ветвь meta-starfive-bsp, чтобы добавить настройки, необходимые для установки Mender.
Требуются следующие изменения:
— conf/machine/starfive-visionfive-jh7100.conf: удалите или прокомментируйте две следующие строки:
UBOOT_ENV ?= "uEnv"
UBOOT_ENV_SUFFIX = "txt"
— recipes-bsp/bootfiles/files/uEnv.txt: замените следующую строку, чтобы задействовать переменные Mender при загрузке:
bootcmd=load mmc 0:1 ${kernel_addr_r} @IMAGETYPE@; load mmc 0:1 ${fdt_addr_r} jh7100-starfive-visionfive-v1.dtb; setenv bootargs 'root=${mender_kernel_root} rw rootfstype=ext4 rootwait earlycon console=ttyS0,115200n8'; booti ${kernel_addr_r} - ${fdt_addr_r}
— recipes-bsp/u-boot/u-boot-visionfive_v2022.03.bb: добавьте следующие строки, чтобы сообщить meta-mender, что используется пользовательский u-boot:
require recipes-bsp/u-boot/u-boot-mender.inc
PROVIDES += "u-boot"
RPROVIDES_${PN} += "u-boot"
BOOT_FILES:append = " uEnv.txt"
Рецепты в meta-interelectronix-visionfive
Некоторые настройки и переменные необходимо установить в пользовательском метаслое, как в случае с meta-interelectronix-visionfive.
— recipes-mender/mender-client/mender-client_%.bbappend: добавьте URL-адрес сервера Mender:
MENDER_SERVER_URL = "https://mender.interelectronix.com"
— recipes-bsp/u-boot/u-boot-visionfive_%.bbappend: добавьте следующие строки:
MENDER_UBOOT_AUTO_CONFIGURE = "1"
BOOTENV_SIZE = "0x20000"
— recipes-bsp/u-boot-env/*: добавьте этот рецепт из загруженного ZIP-файла. Он содержит два uEnv-файла, которые используются в корневой файловой системе. Файл uEnv_visionfive.txt используется в rootfs при загрузке из раздела A, а файл uEnv_visionfive3.txt — при загрузке из раздела B.
— recipes-core/images/vision-five-image-mender.bb: используйте этот рецепт образа или добавьте "u-boot-env" в свой рецепт образа.
IMAGE_INSTALL:append = " v4l-utils u-boot-env"
Важно!
Перед выполнением bitbake образа настройте u-boot согласно инструкциям, приведенным в следующей части серии статей.
Как настроить u-boot для Mender: VisionFive — Mender — Yocto — часть 3.
Лицензия на авторские права
Авторское право © 2022 Interelectronix e.K.
Данный исходный код проекта лицензирован под лицензией GPL-3.0.
Часть 1 серии статей о настройке среды Yocto для создания Yocto Linux с интеграцией клиента Mender.
Часть 4 посвящена настройке среды Yocto для создания Yocto Linux с интеграцией клиента Mender.
Часть 3 серии статей о настройке среды Yocto для создания Yocto Linux с интеграцией клиента Mender.