Un material despre BitBake - Revizia istoricului

Yo3iti: /* Alte concepte importante din BitBake și OpenEmbedded */

2026-11-07T15:47:54Z

Alte concepte importante din BitBake și OpenEmbedded

Yo3iti la 7 noiembrie 2026 15:45

2026-11-07T15:45:38Z

← Versiunea anterioară		Versiunea de la data 7 noiembrie 2026 17:45
Linia 1:		Linia 1:


	= BitBake – Sistemul de automatizare a compilării în Yocto și PetaLinux =		= BitBake – Sistemul de automatizare a compilării în Yocto și PetaLinux =

Linia 38:		Linia 36:
	Când se execută comanda:		Când se execută comanda:

	<syntaxhighlight ~~code~~="bash">		<syntaxhighlight lang="bash">
	petalinux-build		petalinux-build
	</syntaxhighlight>		</syntaxhighlight>
Linia 290:		Linia 288:
	=== Construirea întregului proiect ===		=== Construirea întregului proiect ===

	<syntaxhighlight ~~code~~="bash">		<syntaxhighlight lang="bash">
	# Construiește proiectul PetaLinux.		# Construiește proiectul PetaLinux.
	petalinux-build		petalinux-build
Linia 299:		Linia 297:
	=== Construirea kernelului Linux ===		=== Construirea kernelului Linux ===

	<syntaxhighlight ~~code~~="bash">		<syntaxhighlight lang="bash">
	# Construiește componenta kernel.		# Construiește componenta kernel.
	petalinux-build -c kernel		petalinux-build -c kernel
Linia 306:		Linia 304:
	=== Curățarea rezultatelor de compilare ===		=== Curățarea rezultatelor de compilare ===

	<syntaxhighlight ~~code~~="bash">		<syntaxhighlight lang="bash">
	# Elimină rezultatele de build ale componentei kernel.		# Elimină rezultatele de build ale componentei kernel.
	petalinux-build -c kernel -x clean		petalinux-build -c kernel -x clean
Linia 315:		Linia 313:
	=== Afișarea informațiilor suplimentare ===		=== Afișarea informațiilor suplimentare ===

	<syntaxhighlight ~~code~~="bash">		<syntaxhighlight lang="bash">
	# Activează afișarea detaliată.		# Activează afișarea detaliată.
	petalinux-build -v		petalinux-build -v
Linia 326:		Linia 324:
	Afișarea task-urilor unei ''recipes'':		Afișarea task-urilor unei ''recipes'':

	<syntaxhighlight ~~code~~="bash">		<syntaxhighlight lang="bash">
	bitbake -c listtasks virtual/kernel		bitbake -c listtasks virtual/kernel
	</syntaxhighlight>		</syntaxhighlight>
Linia 332:		Linia 330:
	Afișarea variabilelor de mediu calculate pentru o ''recipe'':		Afișarea variabilelor de mediu calculate pentru o ''recipe'':

	<syntaxhighlight ~~code~~="bash">		<syntaxhighlight lang="bash">
	bitbake -e virtual/kernel		bitbake -e virtual/kernel
	</syntaxhighlight>		</syntaxhighlight>
Linia 338:		Linia 336:
	Construirea unei ''recipes'':		Construirea unei ''recipes'':

	<syntaxhighlight ~~code~~="bash">		<syntaxhighlight lang="bash">
	bitbake my-recipe		bitbake my-recipe
	</syntaxhighlight>		</syntaxhighlight>

Yo3iti la 7 noiembrie 2026 15:43

2026-11-07T15:43:31Z

← Versiunea anterioară		Versiunea de la data 7 noiembrie 2026 17:43
Linia 138:		Linia 138:
	Funcția <code>do_compile()</code> stabilește modul în care se compilează aplicația:		Funcția <code>do_compile()</code> stabilește modul în care se compilează aplicația:

	<syntaxhighlight ~~code~~="~~bitbake~~">		<syntaxhighlight lang="bash">
	do_compile() {		do_compile() {
	${CC} ${CFLAGS} ${LDFLAGS} \		${CC} ${CFLAGS} ${LDFLAGS} \
Linia 151:		Linia 151:
	Funcția <code>do_install()</code> stabilește unde va fi instalat executabilul:		Funcția <code>do_install()</code> stabilește unde va fi instalat executabilul:

	<syntaxhighlight ~~code~~="~~bitbake~~">		<syntaxhighlight lang="bash">
	do_install() {		do_install() {
	install -d ${D}${bindir}		install -d ${D}${bindir}
Linia 278:		Linia 278:
	De exemplu, o ''recipe'' poate utiliza clasa <code>cmake</code>:		De exemplu, o ''recipe'' poate utiliza clasa <code>cmake</code>:

	<syntaxhighlight ~~code~~="~~bitbake~~">		<syntaxhighlight lang="bash">
	inherit cmake		inherit cmake
	</syntaxhighlight>		</syntaxhighlight>
Linia 514:		Linia 514:
	<li>OpenEmbedded, ''OpenEmbedded Layer Index''. [https://layers.openembedded.org/ Indexul layerelor și ''recipes''lor].</li>		<li>OpenEmbedded, ''OpenEmbedded Layer Index''. [https://layers.openembedded.org/ Indexul layerelor și ''recipes''lor].</li>
	</ol>		</ol>

			[[category:FPGA]]
			[[category:petalinux]]
			[[category:bitbake]]

Yo3iti la 7 noiembrie 2026 15:41

2026-11-07T15:41:57Z

← Versiunea anterioară		Versiunea de la data 7 noiembrie 2026 17:41
Linia 73:		Linia 73:
	O ''recipe'' simplificată poate avea următorul conținut:		O ''recipe'' simplificată poate avea următorul conținut:

	<syntaxhighlight ~~code~~="~~bitbake~~">		<syntaxhighlight lang="bash">
	SUMMARY = "Simple I/Q processing application"		SUMMARY = "Simple I/Q processing application"
	LICENSE = "CLOSED"		LICENSE = "CLOSED"

Yo3iti: /* Funcțiile din recipe */

2026-11-07T15:37:44Z

Funcțiile din recipe

← Versiunea anterioară		Versiunea de la data 7 noiembrie 2026 17:37
Linia 134:		Linia 134:
	\|}		\|}

	=== Funcțiile din ''~~recipe~~'' ===		=== Funcțiile din rețete (''recipes'') ===

	Funcția <code>do_compile()</code> stabilește modul în care se compilează aplicația:		Funcția <code>do_compile()</code> stabilește modul în care se compilează aplicația:

Yo3iti: /* Rețetele BitBake */

2026-11-07T15:31:50Z

Rețetele BitBake

← Versiunea anterioară		Versiunea de la data 7 noiembrie 2026 17:31
Linia 92:		Linia 92:
	}		}
	</syntaxhighlight>		</syntaxhighlight>

			Se observă asemănarea sintactică cu fișierele ''Makefile''.

	'''Notă:''' Exemplul este simplificat pentru a ilustra structura unei ''recipe''. În versiunile moderne Yocto, directorul în care se despachetează sursele este definit de variabila <code>UNPACKDIR</code>. Pentru o ''recipe'' reală trebuie verificată structura directoarelor folosită de versiunea Yocto/PetaLinux instalată.		'''Notă:''' Exemplul este simplificat pentru a ilustra structura unei ''recipe''. În versiunile moderne Yocto, directorul în care se despachetează sursele este definit de variabila <code>UNPACKDIR</code>. Pentru o ''recipe'' reală trebuie verificată structura directoarelor folosită de versiunea Yocto/PetaLinux instalată.

Yo3iti: /* Rețetele BitBake */

2026-11-07T15:30:38Z

Rețetele BitBake

← Versiunea anterioară		Versiunea de la data 7 noiembrie 2026 17:30
Linia 65:		Linia 65:
	== Rețetele BitBake ==		== Rețetele BitBake ==

	~~''recipes''le~~ BitBake sunt fișiere cu extensia <code>.bb</code>, denumite ''BitBake recipes''.		Rețetele BitBake sunt fișiere cu extensia <code>.bb</code>, denumite ''BitBake recipes''.

	O ''recipe'' descrie modul în care trebuie obținut, configurat, compilat, instalat și împachetat un anumit pachet software.		O ''recipe'' descrie modul în care trebuie obținut, configurat, compilat, instalat și împachetat un anumit pachet software.
Linia 93:		Linia 93:
	</syntaxhighlight>		</syntaxhighlight>

	'''Notă:''' Exemplul este simplificat pentru a ilustra structura unei ''~~recipes~~''. În versiunile moderne Yocto, directorul în care se despachetează sursele este definit de variabila <code>UNPACKDIR</code>. Pentru o ''recipe'' reală trebuie verificată structura directoarelor folosită de versiunea Yocto/PetaLinux instalată.		'''Notă:''' Exemplul este simplificat pentru a ilustra structura unei ''recipe''. În versiunile moderne Yocto, directorul în care se despachetează sursele este definit de variabila <code>UNPACKDIR</code>. Pentru o ''recipe'' reală trebuie verificată structura directoarelor folosită de versiunea Yocto/PetaLinux instalată.

	=== Explicația variabilelor ===		=== Explicația variabilelor ===

Yo3iti: /* recipesle BitBake */

2026-11-07T15:29:30Z

recipesle BitBake

← Versiunea anterioară		Versiunea de la data 7 noiembrie 2026 17:29
Linia 63:		Linia 63:
	În schimb, analizează dependențele și semnăturile task-urilor pentru a determina ce operații trebuie executate din nou.		În schimb, analizează dependențele și semnăturile task-urilor pentru a determina ce operații trebuie executate din nou.

	== ~~''recipes''le~~ BitBake ==		== Rețetele BitBake ==

	''recipes''le BitBake sunt fișiere cu extensia <code>.bb</code>, denumite ''BitBake recipes''.		''recipes''le BitBake sunt fișiere cu extensia <code>.bb</code>, denumite ''BitBake recipes''.

Yo3iti: /* BitBake – Sistemul de automatizare a compilării în Yocto și PetaLinux */

2026-11-07T15:28:58Z

BitBake – Sistemul de automatizare a compilării în Yocto și PetaLinux

Afișare diferențe

Yo3iti: Pagină nouă: = BitBake – Sistemul de automatizare a compilării în Yocto și PetaLinux = '''BitBake''' este un sistem de automatizare a procesului de compilare (''build automation engine''), utilizat în principal de '''Yocto Project''', '''OpenEmbedded''' și '''AMD PetaLinux''' pentru construirea distribuțiilor Linux destinate sistemelor embedded. În cazul unui proiect bazat pe '''Arty Z7-20 și PetaLinux 2025.2''', BitBake este una dintre componentele fundamentale care transfor...

2026-11-07T15:20:39Z

Pagină nouă: = BitBake – Sistemul de automatizare a compilării în Yocto și PetaLinux = '''BitBake''' este un sistem de automatizare a procesului de compilare (''build automation engine''), utilizat în principal de '''Yocto Project''', '''OpenEmbedded''' și '''AMD PetaLinux''' pentru construirea distribuțiilor Linux destinate sistemelor embedded. În cazul unui proiect bazat pe '''Arty Z7-20 și PetaLinux 2025.2''', BitBake este una dintre componentele fundamentale care transfor...

Pagină nouă

= BitBake – Sistemul de automatizare a compilării în Yocto și PetaLinux =

'''BitBake''' este un sistem de automatizare a procesului de compilare (''build automation engine''), utilizat în principal de '''Yocto Project''', '''OpenEmbedded''' și '''AMD PetaLinux''' pentru construirea distribuțiilor Linux destinate sistemelor embedded.

În cazul unui proiect bazat pe '''Arty Z7-20 și PetaLinux 2025.2''', BitBake este una dintre componentele fundamentale care transformă configurația proiectului, codul sursă și rețetele software într-un sistem Linux funcțional pentru procesorul ARM Cortex-A9 din familia Zynq-7000.

== Arhitectura BitBake în PetaLinux ==

PetaLinux nu este un compilator propriu-zis. Este un ansamblu de instrumente AMD construit deasupra infrastructurii Yocto/OpenEmbedded.

Arhitectura poate fi reprezentată astfel:

<pre>
AMD PetaLinux
|
v
Yocto Project / OpenEmbedded
|
v
BitBake
|
+---------+---------+
| | |
v v v
Linux RootFS Boot
Kernel Components
</pre>

Fiecare nivel îndeplinește un rol specific:

* '''PetaLinux''' – oferă comenzile și interfața de configurare specifice platformelor AMD.
* '''Yocto Project / OpenEmbedded''' – furnizează rețetele, layerele, configurațiile și infrastructura necesare construirii distribuției.
* '''BitBake''' – analizează rețetele, rezolvă dependențele și execută task-urile de build.
* '''Instrumentele de compilare''' – GCC, linkerul, Make, CMake și alte utilitare realizează efectiv compilarea și asamblarea componentelor.

Când se execută comanda:

<syntaxhighlight code="bash">
petalinux-build
</syntaxhighlight>

PetaLinux pregătește mediul de build și invocă infrastructura Yocto/BitBake, care coordonează compilarea componentelor necesare.

== Funcționalitățile BitBake ==

BitBake nu compilează el însuși cod C sau C++. În schimb, coordonează instrumentele necesare construirii aplicațiilor, bibliotecilor și imaginilor Linux.

Principalele responsabilități sunt:

* '''Analiza rețetelor''' – identifică pachetele și componentele care trebuie construite.
* '''Rezolvarea dependențelor''' – stabilește ordinea corectă a operațiilor de compilare.
* '''Descărcarea surselor''' – obține codul sursă din depozite Git, arhive și alte surse configurate.
* '''Aplicarea patch-urilor''' – modifică sursele conform instrucțiunilor din rețete.
* '''Configurarea și compilarea''' – invocă instrumente precum GCC, Make, CMake sau Meson.
* '''Instalarea și împachetarea''' – generează pachete software și componentele sistemului de fișiere.
* '''Gestionarea cache-ului''' – reutilizează rezultatele operațiilor deja executate atunci când configurația și dependențele permit acest lucru.
* '''Execuția paralelă''' – permite executarea simultană a task-urilor independente, reducând durata procesului de build.

Un avantaj esențial este faptul că BitBake nu reconstruiește în mod obligatoriu întreaga distribuție Linux după fiecare modificare.

În schimb, analizează dependențele și semnăturile task-urilor pentru a determina ce operații trebuie executate din nou.

== Rețetele BitBake ==

Rețetele BitBake sunt fișiere cu extensia <code>.bb</code>, denumite ''BitBake recipes''.

O rețetă descrie modul în care trebuie obținut, configurat, compilat, instalat și împachetat un anumit pachet software.

De exemplu, presupunem că dorim să includem în PetaLinux o aplicație C care procesează eșantioane I/Q provenite de la un receptor SDR.

O rețetă simplificată poate avea următorul conținut:

<syntaxhighlight code="bitbake">
SUMMARY = "Simple I/Q processing application"
LICENSE = "CLOSED"

SRC_URI = "file://iq-processor.c"

S = "${WORKDIR}"

do_compile() {
${CC} ${CFLAGS} ${LDFLAGS} \
iq-processor.c -o iq-processor
}

do_install() {
install -d ${D}${bindir}
install -m 0755 iq-processor \
${D}${bindir}/iq-processor
}
</syntaxhighlight>

'''Notă:''' Exemplul este simplificat pentru a ilustra structura unei rețete. În versiunile moderne Yocto, directorul în care se despachetează sursele este definit de variabila <code>UNPACKDIR</code>. Pentru o rețetă reală trebuie verificată structura directoarelor folosită de versiunea Yocto/PetaLinux instalată.

=== Explicația variabilelor ===

{| class="wikitable"
! Variabilă
! Semnificație
|-
| <code>SUMMARY</code>
| Descriere scurtă a pachetului software.
|-
| <code>LICENSE</code>
| Specifică licența asociată pachetului. Valoarea <code>CLOSED</code> este utilizată pentru software proprietar, fără un fișier de licență declarat prin mecanismul obișnuit.
|-
| <code>SRC_URI</code>
| Identifică sursele necesare construirii pachetului.
|-
| <code>WORKDIR</code>
| Directorul de lucru al rețetei, utilizat pentru fișiere intermediare și operații de build.
|-
| <code>S</code>
| Directorul care conține sursele utilizate pentru compilare.
|-
| <code>CC</code>
| Compilatorul C configurat de sistemul de cross-compilare.
|-
| <code>CFLAGS</code>
| Opțiunile de compilare C.
|-
| <code>LDFLAGS</code>
| Opțiunile transmise la etapa de link-editare.
|-
| <code>D</code>
| Directorul temporar în care se instalează fișierele pachetului înainte de împachetare.
|-
| <code>bindir</code>
| Directorul standard destinat executabilelor utilizatorilor, de regulă <code>/usr/bin</code>.
|}

=== Funcțiile din rețetă ===

Funcția <code>do_compile()</code> stabilește modul în care se compilează aplicația:

<syntaxhighlight code="bitbake">
do_compile() {
${CC} ${CFLAGS} ${LDFLAGS} \
iq-processor.c -o iq-processor
}
</syntaxhighlight>

Variabila <code>${CC}</code> identifică compilatorul configurat pentru arhitectura țintă.

În cazul Arty Z7-20, acesta este un compilator pentru arhitectura ARM corespunzătoare procesorului Zynq-7000, nu compilatorul nativ x86-64 utilizat de Ubuntu pe calculatorul gazdă.

Funcția <code>do_install()</code> stabilește unde va fi instalat executabilul:

<syntaxhighlight code="bitbake">
do_install() {
install -d ${D}${bindir}

install -m 0755 iq-processor \
${D}${bindir}/iq-processor
}
</syntaxhighlight>

După includerea pachetului în imaginea Linux, executabilul va fi disponibil în mod normal la:

<code>/usr/bin/iq-processor</code>

Prezența executabilului în imagine presupune ca pachetul rezultat din rețetă să fie inclus în configurația imaginii, de exemplu prin mecanismul <code>IMAGE_INSTALL</code> sau prin configurarea PetaLinux.

== Task-urile BitBake ==

Fiecare rețetă este descompusă în operații numite '''task-uri'''.

Acestea pot include descărcarea surselor, configurarea, compilarea, instalarea și împachetarea.

Un flux tipic este:

<pre>
do_fetch
|
v
do_unpack
|
v
do_patch
|
v
do_configure
|
v
do_compile
|
v
do_install
|
v
do_package
</pre>

Acest flux reprezintă o simplificare conceptuală. În practică, BitBake construiește un graf de dependențe între task-uri, inclusiv task-uri provenite din rețete diferite.

{| class="wikitable"
! Task
! Funcționalitate
|-
| <code>do_fetch</code>
| Descarcă sau localizează sursele specificate în rețetă.
|-
| <code>do_unpack</code>
| Despachetează arhivele și pregătește sursele.
|-
| <code>do_patch</code>
| Aplică patch-urile necesare.
|-
| <code>do_configure</code>
| Configurează mediul și parametrii de compilare.
|-
| <code>do_compile</code>
| Compilează codul sursă.
|-
| <code>do_install</code>
| Instalează fișierele rezultate într-un director temporar de destinație.
|-
| <code>do_package</code>
| Pregătește împărțirea și metadatele pachetelor software.
|}

Dacă se modifică doar fișierul sursă <code>iq-processor.c</code>, BitBake poate recompila aplicația respectivă și operațiile dependente, reutilizând rezultatele nemodificate ale celorlalte componente.

Acest mecanism este important deoarece o distribuție embedded Linux poate conține sute sau mii de pachete și task-uri.

== Compararea BitBake cu Make și CMake ==

BitBake, Make și CMake sunt instrumente cu responsabilități diferite.

{| class="wikitable"
! Caracteristică
! Make
! CMake
! BitBake
|-
| Compilarea aplicațiilor
| Execută reguli de build.
| Generează și configurează sistemul de build.
| Coordonează task-urile care invocă instrumentele de compilare.
|-
| Construirea unei distribuții Linux
| Necesită infrastructură suplimentară.
| Nu este scopul principal.
| Da, împreună cu OpenEmbedded.
|-
| Gestionarea dependențelor
| Între ținte (''targets'').
| Între ținte și componente ale proiectului.
| Între rețete, pachete și task-uri.
|-
| Cross-compilare
| Posibilă prin configurarea instrumentelor.
| Posibilă folosind un ''toolchain file''.
| Integrată în configurația distribuției și a mașinii țintă.
|-
| Descărcarea surselor
| Necesită reguli sau instrumente suplimentare.
| Posibilă prin mecanisme dedicate.
| Integrată prin task-uri și fetchere.
|-
| Gestionarea cache-ului
| Bazată în principal pe dependențe și timpi de modificare.
| Depinde de generator și de instrumentele folosite.
| Include mecanismul Shared State Cache.
|-
| Utilizare obișnuită
| Compilarea proiectelor software.
| Configurarea proiectelor software portabile.
| Construirea distribuțiilor Linux embedded.
|}

BitBake poate utiliza Make sau CMake în interiorul unei rețete. Aceste instrumente nu se exclud reciproc.

De exemplu, o rețetă poate utiliza clasa <code>cmake</code>:

<syntaxhighlight code="bitbake">
inherit cmake
</syntaxhighlight>

În acest caz, BitBake coordonează procesul, iar infrastructura CMake configurează și generează regulile de construire a aplicației.

== Utilizarea BitBake în PetaLinux ==

În PetaLinux, operațiile de build sunt executate în mod obișnuit prin comenzile AMD.

=== Construirea întregului proiect ===

<syntaxhighlight code="bash">
# Construiește proiectul PetaLinux.
petalinux-build
</syntaxhighlight>

Această comandă construiește componentele necesare proiectului, în funcție de configurația curentă.

=== Construirea kernelului Linux ===

<syntaxhighlight code="bash">
# Construiește componenta kernel.
petalinux-build -c kernel
</syntaxhighlight>

=== Curățarea rezultatelor de compilare ===

<syntaxhighlight code="bash">
# Elimină rezultatele de build ale componentei kernel.
petalinux-build -c kernel -x clean
</syntaxhighlight>

Operația <code>clean</code> elimină rezultatele locale ale task-urilor componentei selectate, dar nu reprezintă neapărat eliminarea tuturor artefactelor reutilizabile din Shared State Cache.

=== Afișarea informațiilor suplimentare ===

<syntaxhighlight code="bash">
# Activează afișarea detaliată.
petalinux-build -v
</syntaxhighlight>

=== Invocarea directă a BitBake ===

Într-un mediu Yocto/BitBake inițializat corespunzător, pot fi utilizate comenzi directe.

Afișarea task-urilor unei rețete:

<syntaxhighlight code="bash">
bitbake -c listtasks virtual/kernel
</syntaxhighlight>

Afișarea variabilelor de mediu calculate pentru o rețetă:

<syntaxhighlight code="bash">
bitbake -e virtual/kernel
</syntaxhighlight>

Construirea unei rețete:

<syntaxhighlight code="bash">
bitbake my-recipe
</syntaxhighlight>

În aceste exemple, <code>virtual/kernel</code> reprezintă un furnizor virtual pentru kernelul Linux, iar <code>my-recipe</code> reprezintă numele unei rețete disponibile în configurația curentă.

'''Important:''' Comenzile BitBake directe presupun inițializarea mediului de build. În PetaLinux este recomandată utilizarea comenzilor <code>petalinux-build</code>, deoarece acestea gestionează integrarea specifică platformei AMD.

== Utilizarea BitBake în proiectele FPGA și SDR ==

Un exemplu practic este dezvoltarea unui sistem SDR bazat pe placa '''Digilent Arty Z7-20'''.

Arhitectura sistemului poate fi:

<pre>
Raspberry Pi 5
|
| Ethernet / UDP
v
PetaLinux
|
| AXI DMA
v
FPGA DSP
|
+-- Frequency shifting
|
+-- Digital filtering
|
+-- Doppler correction
</pre>

Pentru o asemenea aplicație, sistemul PetaLinux poate necesita:

* O aplicație C/C++ care recepționează eșantioane I/Q prin Ethernet.
* Un driver Linux pentru un periferic AXI personalizat.
* Un serviciu care inițializează automat aplicația SDR.
* Biblioteci pentru procesare digitală de semnal.
* Fișiere de configurare pentru parametrii de recepție și procesare.

Aceste componente pot fi integrate în distribuția PetaLinux prin rețete BitBake, fișiere de configurare și layere OpenEmbedded.

=== Avantajele integrării în imagine ===

Fără integrarea în sistemul de build, după fiecare instalare a unei imagini Linux ar putea fi necesare operații manuale:

* Copierea aplicațiilor compilate.
* Instalarea bibliotecilor.
* Configurarea serviciilor.
* Modificarea fișierelor de configurare.
* Stabilirea drepturilor de acces.
* Configurarea pornirii automate.

Prin utilizarea rețetelor BitBake, aceste operații pot fi incluse în procesul automat de construire a imaginii.

În acest fel, configurația sistemului devine reproductibilă, iar imaginea PetaLinux rezultată poate fi distribuită și instalată pe alte plăci compatibile.

== Cache-ul BitBake și compilarea incrementală ==

Unul dintre mecanismele importante ale infrastructurii Yocto este '''Shared State Cache''', cunoscut și sub denumirea <code>sstate-cache</code>.

Acesta păstrează rezultatele reutilizabile ale anumitor task-uri.

În loc să execute din nou fiecare operație de compilare, BitBake poate recupera rezultatele din cache atunci când semnăturile task-urilor și dependențele sunt compatibile.

De exemplu, dacă s-a construit deja kernelul Linux și se modifică numai o aplicație SDR, nu este necesară în mod normal recompilarea completă a kernelului.

=== Directoare importante ===

{| class="wikitable"
! Director sau variabilă
! Rol
|-
| <code>DL_DIR</code>
| Directorul în care sunt păstrate sursele descărcate.
|-
| <code>SSTATE_DIR</code>
| Directorul utilizat pentru Shared State Cache.
|-
| <code>TMPDIR</code>
| Directorul principal pentru fișierele temporare și rezultatele intermediare ale build-ului.
|-
| <code>WORKDIR</code>
| Directorul de lucru al unei rețete.
|-
| <code>DEPLOY_DIR</code>
| Directorul principal pentru artefactele rezultate și destinate distribuției.
|}

Într-un mediu cu mai multe instalații Yocto/PetaLinux, directoarele de descărcări și cache pot fi configurate astfel încât să reutilizeze rezultate între proiecte compatibile.

Acest aspect este util atunci când PetaLinux este instalat atât pe o mașină Ubuntu dedicată, cât și într-un mediu Ubuntu 22.04 rulând în WSL2.

Totuși, reutilizarea cache-ului nu este garantată între versiuni diferite de Yocto, PetaLinux sau configurații incompatibile.

De asemenea, cache-ul nu înlocuiește instalarea corectă a instrumentelor și a dependențelor necesare pe sistemul gazdă.

== Reproductibilitatea sistemului embedded Linux ==

Un obiectiv important al Yocto și PetaLinux este construirea reproductibilă a unui sistem Linux personalizat.

Prin păstrarea sub controlul versiunilor a rețetelor, configurațiilor, patch-urilor și codului sursă, se poate reconstrui o imagine Linux cu aceleași componente și parametri.

Totuși, o configurație reproductibilă nu garantează automat un rezultat identic la nivel de octet.

Pentru reproductibilitate completă trebuie controlate și versiunile surselor, instrumentele de compilare, metadatele, timestamp-urile și alți factori care pot influența artefactele generate.

Într-un proiect FPGA/SDR, această abordare oferă avantaje importante:

* Urmărirea modificărilor efectuate în sistem.
* Reconstituirea unei versiuni funcționale anterioare.
* Integrarea automată a aplicațiilor și driverelor.
* Reducerea intervențiilor manuale după instalarea imaginii.
* Posibilitatea automatizării procesului de construire și testare.

== Alte concepte importante din BitBake și OpenEmbedded ==

Pe lângă rețetele <code>.bb</code>, infrastructura BitBake utilizează mai multe tipuri de fișiere și mecanisme.

{| class="wikitable"
! Element
! Descriere
|-
| <code>.bb</code>
| Rețetă BitBake, care definește modul de construire a unui pachet.
|-
| <code>.bbappend</code>
| Fișier care extinde sau modifică metadatele unei rețete existente.
|-
| <code>.bbclass</code>
| Clasă reutilizabilă care furnizează funcționalități comune mai multor rețete.
|-
| <code>.conf</code>
| Fișier de configurare pentru distribuție, mașină, layer sau mediu de build.
|-
| <code>meta-*</code>
| Denumire convențională folosită frecvent pentru layere OpenEmbedded.
|-
| <code>DEPENDS</code>
| Declară dependențele necesare în timpul construirii unei rețete.
|-
| <code>RDEPENDS</code>
| Declară dependențele necesare la rularea unui pachet.
|-
| <code>IMAGE_INSTALL</code>
| Specifică pachetele care trebuie incluse într-o imagine Linux.
|-
| <code>inherit</code>
| Permite unei rețete să reutilizeze funcționalitățile unei clase BitBake.
|}

În special, fișierele <code>.bbappend</code> și layerele personalizate sunt importante pentru modificarea distribuției PetaLinux fără editarea directă a rețetelor furnizate de AMD.

== Concluzii ==

'''BitBake este motorul de automatizare care coordonează construirea componentelor unei distribuții Linux embedded.'''

Relația dintre principalele instrumente poate fi sintetizată astfel:

* '''PetaLinux''' – oferă interfața AMD pentru configurarea și construirea sistemelor Linux destinate platformelor sale embedded.
* '''Yocto Project / OpenEmbedded''' – furnizează infrastructura, rețetele, layerele și mecanismele de configurare a distribuției.
* '''BitBake''' – interpretează metadatele, rezolvă dependențele și coordonează task-urile de build.
* '''GCC, Make, CMake și alte instrumente''' – realizează operațiile concrete de compilare, link-editare și construire.

Înțelegerea BitBake permite personalizarea avansată a imaginilor PetaLinux, integrarea aplicațiilor și driverelor proprii și automatizarea construirii unor sisteme embedded complexe.

== Referințe ==

<ol>
<li>Yocto Project, ''BitBake User Manual''. [https://docs.yoctoproject.org/bitbake/singleindex.html Documentație oficială].</li>
<li>Yocto Project, ''Reference Manual – Tasks''. [https://docs.yoctoproject.org/ref-manual/tasks.html Documentație oficială].</li>
<li>Yocto Project, ''Overview and Concepts Manual''. [https://docs.yoctoproject.org/overview-manual/concepts.html Documentație oficială].</li>
<li>Yocto Project, ''Reference Manual – Variables Glossary''. [https://docs.yoctoproject.org/ref-manual/variables.html Documentație oficială].</li>
<li>AMD, ''PetaLinux Tools Documentation: Reference Guide (UG1144)''. [https://docs.amd.com/r/en-US/ug1144-petalinux-tools-reference-guide Documentație oficială].</li>
<li>OpenEmbedded, ''OpenEmbedded Layer Index''. [https://layers.openembedded.org/ Indexul layerelor și rețetelor].</li>
</ol>

[[category:FPGA]]
[[category:petalinux]]
[[category:bitbake]]