Buildroot — del 2. Skapa konfiguration för din enhet; använda external tree, rootfs-overlay, post-build skript

I detta avsnitt behandlar jag en del av de anpassningsmöjligheter som jag behövde. Det är inte en komplett lista över vad buildroot erbjuder, men de är funktionella och kräver inte ingrepp i buildroot-filerna.

Användning av EXTERNAL-mekanismen för anpassning

I den föregående artikeln ett enkelt exempel på att lägga till sin egen konfiguration, genom att lägga till defconfig för kortet och nödvändiga filer direkt i Buildroot-katalogen.

Men denna metod är inte särskilt praktisk, särskilt vid uppdateringar av buildroot. För att lösa detta problem finns det en mekanism external tree. I grunden innebär detta att man kan lagra kataloger för board, configs, packages och andra i en separat katalog (till exempel använder jag katalogen patches för att applicera patchar på paketen, mer om detta i ett separat avsnitt) och buildroot kommer själv att lägga till dem till de som redan finns i sin katalog.

Anmärkning: flera external trees kan appliceras samtidigt, det finns ett exempel i buildroot-guiden.

Skapa en katalog my_tree, som ligger bredvid buildroot-katalogen och flytta vår konfiguration dit. Resultatet bör bli följande filstruktur:

[alexey@alexey-pc my_tree]$ tree
.
├── board
│   └── my_x86_board
│       ├── bef_cr_fs_img.sh
│       ├── linux.config
│       ├── rootfs_overlay
│       └── users.txt
├── Config.in
├── configs
│   └── my_x86_board_defconfig
├── external.desc
├── external.mk
├── package
└── patches

6 kataloger, 7 filer

Som man kan se, upprepar strukturen i stort sett buildroot-strukturen.

Katalog board innehåller filer som är specifika för varje kort i vårt fall:

• bef_cr_fs_img.sh — ett skript som kommer att köras efter byggandet av målfilsystemet, men före packningen av det i bilder. Vi kommer att använda det senare.
• linux.config — kärnkonfiguration
• rootfs_overlay — en katalog för att applicera ovanpå målfilsystemet
• users.txt — en fil med beskrivning av de användare som skapas

Katalog configs innehåller defconfig för våra kort. Vi har bara en.

Package — katalogen med våra paket. Ursprungligen innehåller buildroot beskrivningar och byggregler för ett begränsat antal paket. Senare kommer vi att lägga till fönsterhanteraren icewm och inloggningshanteraren Slim.
Patches — gör att man enkelt kan lagra sina patchar för olika paket. Mer om detta i ett separat avsnitt längre fram.
Nu behöver vi lägga till beskrivningsfilerna för vårt external-tree. Det ansvarar tre filer: external.desc, Config.in, external.mk.

external.desc innehåller själva beskrivningen:

[alexey@alexey-pc my_tree]$ cat external.desc 
name: my_tree
desc: Min enkla externa träd för artikel

Den första raden är namnet. I fortsättningen kommer buildroot att skapa en variabel $(BR2_EXTERNAL_MY_TREE_PATH), som ska användas vid konfigureringen av bygget. Till exempel kan sökvägen till filen med användare anges som följer:

$(BR2_EXTERNAL_my_tree_PATH)/board/my_x86_board/users.txt

Den andra raden är en kort, begriplig beskrivning.

Config.in, external.mk — filer för att beskriva tillagda paket. Om du inte lägger till egna paket, kan dessa filer lämnas tomma. Så kommer vi att göra för tillfället.
Nu har vi vårt external-tree klart, som innehåller defconfig för vårt kort och nödvändiga filer. Vi går till buildroot-katalogen och anger att vi ska använda external-tree:

[alexey@alexey-pc buildroot]$ make BR2_EXTERNAL=../my_tree/ my_x86_board_defconfig
#
# konfiguration skriven till /home/alexey/dev/article/ramdisk/buildroot/.config
#
[alexey@alexey-pc buildroot]$ make menuconfig

I det första kommandot använder vi argumentet BR2_EXTERNAL=../my_tree/, som anger att vi använder external tree. Flera external-tree kan anges samtidigt. Det är tillräckligt att göra detta en gång, varefter en fil output/.br-external.mk skapas som lagrar information om det använda external-tree:

[alexey@alexey-pc buildroot]$ cat output/.br-external.mk 
#
# Autogenerated file; FÅ INTE REDIGERA.
#

BR2_EXTERNAL ?= /home/alexey/dev/article/ramdisk/my_small_linux/my_tree
BR2_EXTERNAL_NAMES = 
BR2_EXTERNAL_DIRS = 
BR2_EXTERNAL_MKS = 

BR2_EXTERNAL_NAMES += my_tree
BR2_EXTERNAL_DIRS += /home/alexey/dev/article/ramdisk/my_small_linux/my_tree
BR2_EXTERNAL_MKS += /home/alexey/dev/article/ramdisk/my_small_linux/my_tree/external.mk
export BR2_EXTERNAL_my_tree_PATH = /home/alexey/dev/article/ramdisk/my_small_linux/my_tree
export BR2_EXTERNAL_my_tree_DESC = Min enkla externa träd för artikel

Viktigt! I denna fil kommer sökvägarna att vara absoluta!

Det har tillkommit ett alternativ i menyn: External options:

I denna undermeny kommer våra paket från vårt external-tree att finnas. För tillfället är denna sektion tom.

Nu är det viktigare för oss att skriva om nödvändiga sökvägar för att använda external-tree.

Observera att i avsnittet Build options → Location to save buildroot config, kommer det att finnas en absolut sökväg till den sparade defconfigen. Den skapas vid angivandet av användning av external_tree.

I avsnittet System configuration kommer vi också att justera sökvägarna. För tabellen med skapade användare:

$(BR2_EXTERNAL_my_tree_PATH)/board/my_x86_board/users.txt

I avsnittet Kernel ändrar vi sökvägen till kärnkonfigurationen:

$(BR2_EXTERNAL_my_tree_PATH)/board/my_x86_board/linux.config

Nu kommer våra filer från vårt external-tree att användas vid bygget. Flyttas vi till en annan katalog eller uppdaterar buildroot, kommer vi att ha minimalt med problem.

Lägg till root fs overlay:

Denna mekanism gör det enkelt att lägga till/ersätta filer i target-filsystemet.
Om filen finns i root fs overlay men inte i target, kommer den att läggas till.
Om filen finns i både root fs overlay och target, kommer den att ersättas.
Först anger vi sökvägen till root fs overlay-katalogen. Detta görs i avsnittet Systemkonfiguration → Root filesystem overlay directories:

$(BR2_EXTERNAL_my_tree_PATH)/board/my_x86_board/rootfs_overlay/

Nu ska vi skapa två filer.

[alexey@alexey-pc my_small_linux]$ cat my_tree/board/my_x86_board/rootfs_overlay/etc/hosts 
127.0.0.1   localhost
127.0.1.1   my_small_linux
8.8.8.8     google-public-dns-a.google.com.
[alexey@alexey-pc my_small_linux]$ cat my_tree/board/my_x86_board/rootfs_overlay/new_file.txt 
This is new file from overlay

Den första filen (my_tree/board/my_x86_board/rootfs_overlay/etc/hosts) kommer att ersätta filen /etc/hosts i det färdiga systemet. Den andra filen (cat my_tree/board/my_x86_board/rootfs_overlay/new_file.txt) kommer att läggas till.

Vi samlar ihop och kontrollerar:

Körning av anpassningsskript vid olika steg i systemuppbyggnaden.

Det är ofta nödvändigt att utföra vissa åtgärder inom target-filssystemet innan det packas in i bilder.

Detta kan göras i avsnittet Systemkonfiguration:

De första två skripten körs efter att target-filssystemet har byggts, men före packningen i bilder. Skillnaden är att fakeroot-skriptet körs i fakeroot-kontext, det vill säga det imiterar arbete från användaren root.

Det sista skriptet körs efter att systembilderna har skapats. Här kan man utföra ytterligare åtgärder, till exempel kopiera de nödvändiga filerna till en nfs-server eller skapa en bild av sin enhets firmware.

Som exempel kommer jag att skapa ett skript som skriver versionen och byggdatumet till /etc/.
Först anger jag sökvägen till denna fil i mitt externa träd:

Och nu själva skriptet:

[alexey@alexey-pc buildroot]$ cat ../my_tree/board/my_x86_board/bef_cr_fs_img.sh 
#! /bin/sh
echo "my small linux 1.0 pre alpha" > output/target/etc/mysmalllinux-release
date >> output/target/etc/mysmalllinux-release

Efter byggandet kan denna fil ses i systemet.

I praktiken kan skriptet bli stort. Så i ett verkligt projekt valde jag en mer avancerad väg:

1. Skapade en katalog (my_tree/board_my_x86_board/inside_fakeroot_scripts) där skripten som ska köras ligger, numrerade i ordning. Till exempel, 0001-add-my_small_linux-version.sh, 0002-clear-apache-root-dir.sh.
2. Skrev skriptet (my_tree/board_my_x86_board/run_inside_fakeroot.sh) som går igenom denna katalog och kör skripten i ordning.
3. Angav detta skript i plattans inställningar i avsnittet Systemkonfiguration → Anpassade skript att köra inuti fakeroot-miljön ($(BR2_EXTERNAL_my_tree_PATH)/board/my_x86_board/run_inside_fakeroot.sh).

Källa: habr.com