Робота з низькорівневим системним ПЗ
Цей посібник призначений для системних інженерів, які готують BSP для образу Modalix. Працюйте з вихідним кодом ядра й дерев пристроїв за допомогою Palette SDK, а потім використовуйте PIB для складання сумісних із випуском пакетів в образ. API застосунків і навчальні матеріали доступні на developer.sima.ai/software.
Почніть із сумісного випуску BSP
Використовуйте ревізію вихідного коду та конфігурацію постачальника, що відповідають цільовій версії платформи. Типова гілка репозиторію не обов’язково відповідає образу, який ви підтримуєте. Зберігайте ревізії, зміни конфігурації та версії пакетів у документації випуску.
Виконуйте команди збирання в контейнері Palette SDK із налаштованим середовищем крос-компіляції ARM64. Нижче показано отримання коду; перед налаштуванням і збиранням виберіть відповідну ревізію випуску.
Налаштуйте та зберіть ядро
git clone https://github.com/SiMa-ai/simaai-linux.git
cd simaai-linux
make ARCH=arm64 simaai_modalix_defconfig
make all -j8 ARCH=arm64 LOCALVERSION="-modalix" DTC_FLAGS=-@
Образ ядра створюється в arch/arm64/boot/Image, а дерева пристроїв платформи — у arch/arm64/boot/dts/simaai/. Зафіксуйте використані конфігурацію та ревізію коду.
Це результати компіляції, а не повний пакет ядра для PIB. Використовуйте підтримуваний платформою процес створення Debian-пакетів, щоб зберегти потрібні файли завантаження, сценарії пакетів та інтеграцію з випуском.
Скомпілюйте накладання дерева пристроїв
dtc -@ -I dts -O dtb -o imx415.dtbo imx415.dtso
Замініть імена файлів своїми. Перевірте апаратні прив’язки й роботу периферії на платі розробника. Пакуйте або встановлюйте накладання через підтримувану конфігурацію завантаження вашого випуску: саме копіювання .dtbo не вмикає його автоматично.
Врахуйте межі змін ланцюжка завантаження
Компоненти ядра, U-Boot, ATF і tRoot в образі мають залишатися сумісними. У поточному процесі PIB власне ядро має зберігати назву пакета ядра випуску та бути єдиним установленим ядром. Назву наведено в configs/images/image-params.yaml.
PIB відхиляє локальні пакети заміни tRoot, ATF і U-Boot. U-Boot в образі має відповідати копії у fip.bin. Збирання u-boot.bin не є дозволом або підтримуваною процедурою перезапису завантажувальної прош ивки. Узгоджуйте такі зміни з постачальником платформи та його процесом відновлення й підписування.
Варіант securepalette додає перевірки підпису FIT ядра та потребує виробничо підписаних завантажувальних пакетів для постачання. Його поведінка захищеного завантаження на апаратурі не перевіряється кваліфікацією мінімального образу в CI.
Запакуйте системні зміни за допомогою PIB
Помістіть сумісні Debian-пакети ARM64 у custom-debs/, підпишіть їх своїм ключем пакетів і зберіть образ:
pib sign-debs
pib verify-debs
pib build --sign
pib verify
У image.yaml перелічіть додаткові назви пакетів, у overlay/ розмістіть конфігурацію, а в хуках після встановлення — увімкнення служб та завершальні зміни. Правила для ядра й пакетів наведено в довіднику PIB.
Зберігайте маніфести та контрольні суми, тестуйте образ на платі розробника, яку можна відновити, і перевіряйте периферію та поведінку оновлення/відкату, на які вплинули зміни. Успішне створення артефактів не підтверджує апаратну сумісність.