Skip to content

Commit a4b0e79

Browse files
committed
fix(linux): Update Yocto User Guide
* Replace opencl with zlib in bitbake examples, as opencl is no longer a valid recipe. Fixes [0] * Remove platform-specific ifconfig for SITARA and Jacinto since zlib is a common package available across all platforms * Convert example commands to use code-blocks directive [1] for improved readability and syntax highlighting [0] - #301 [1] - https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-code-block Signed-off-by: Chirag Shilwant <[email protected]>
1 parent d61076a commit a4b0e79

File tree

1 file changed

+34
-67
lines changed

1 file changed

+34
-67
lines changed

source/linux/Overview/_Processor_SDK_Building_The_SDK.rst

Lines changed: 34 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -305,10 +305,11 @@ In addition to individual components packages, the following table
305305
provides a list of build targets supported. These are the <target> used
306306
in the command:
307307

308-
``MACHINE=<machine> bitbake <target>``
308+
.. code-block:: console
309+
310+
MACHINE=<machine> bitbake <target>
309311
310-
The "Build Output" is given relative to the
311-
**deploy-ti** directory.
312+
The build system places the "Build Output" relative to :file:`deploy-ti`
312313

313314

314315
.. ifconfig:: CONFIG_sdk in ('SITARA')
@@ -724,7 +725,6 @@ The "Build Output" is given relative to the
724725
Recipes
725726
-------
726727

727-
728728
.. rubric:: Recipe Basics
729729
:name: Recipe Basics
730730

@@ -733,94 +733,61 @@ granularity of recipe development and debug. Specifying a recipe name,
733733
minus the version (if the version is appended to the name), will build
734734
the recipe and all its dependencies.
735735

736-
.. ifconfig:: CONFIG_sdk in ('SITARA')
737-
738-
For example, the command below builds only the opencl recipe and all the
739-
dependencies it defines.
740-
741-
``MACHINE=<machine> bitbake opencl``
742-
743-
After the bitbake command above is successfully done,
744-
:file:`arago-tmp-[toolchain]/work/<machine>-linux-gnueabi/opencl` directory
745-
will be available including the original source code under the git
746-
folder, independent shared objects (.so files) under packages-split
747-
folder, and IPKs under deploy-ipks folder.
736+
For example, the command below builds only the zlib recipe and all the
737+
dependencies it defines.
748738

749-
.. ifconfig:: CONFIG_sdk in ('JACINTO','j7_foundational')
750-
751-
For example, the command below builds only the k3conf recipe and all the
752-
dependencies it defines.
739+
.. code-block:: console
753740
754-
``MACHINE=<machine> bitbake k3conf``
741+
MACHINE=<machine> bitbake zlib
755742
756-
After the bitbake command above is successfully done,
757-
**arago-tmp-[toolchain]/work/<machine>-linux/k3conf** directory
758-
will be available including the original source code under the git
759-
folder, independent shared objects (.so files) under packages-split
760-
folder, and IPKs under deploy-ipks folder.
743+
After the preceding bitbake command completes successfully, the
744+
:file:`arago-tmp-default-glibc/work/aarch64-oe-linux/zlib` directory
745+
will be available including the original source code, independent shared objects (.so files)|
746+
under packages-split folder and IPKs under deploy-ipks folder.
761747

762-
.. note:: Please note that the output of a recipe can be in another folder under "arago-tmp-[toolchain]/work" directory, depending on the defines of the recipe.
748+
.. note::
763749

750+
Please note that the output of a recipe can be in another folder under :file:`arago-tmp-[toolchain]/work` directory, depending on the defines of the recipe.
764751

765752
.. rubric:: Forced Re-compilation
766753
:name: Forced Re-compilation
767754

768-
.. ifconfig:: CONFIG_sdk in ('SITARA')
755+
When needed, source code under the work directory (e.g.,
756+
:file:`arago-tmp-default-glibc/work/aarch64-oe-linux/zlib/<version>/zlib-<version>`) can
757+
be modified. After the modification is done, run the following commands
758+
to force recompilation with the new code and rebuilding of the recipe,
759+
For example,
769760

770-
When needed, source code under the work directory (e.g.,
771-
**arago-tmp-[toolchain]/work/<machine>-linux-gnueabi/opencl**/git) can
772-
be modified. After the modification is done, run the following commands
773-
to force recompilation with the new code and rebuilding of the recipe,
774-
e.g.,
775-
``MACHINE=<machine> bitbake opencl --force -c compile``
776-
777-
``MACHINE=<machine> bitbake opencl``
778-
779-
.. ifconfig:: CONFIG_sdk in ('JACINTO','j7_foundational')
780-
781-
When needed, source code under the work directory (e.g.,
782-
**arago-tmp-[toolchain]/work/<machine>-linux/k3conf**/git) can
783-
be modified. After the modification is done, run the following commands
784-
to force recompilation with the new code and rebuilding of the recipe,
785-
e.g.,
786-
787-
``MACHINE=<machine> bitbake k3conf --force -c compile``
761+
.. code-block:: console
788762
789-
``MACHINE=<machine> bitbake k3conf``
763+
MACHINE=<machine> bitbake zlib --force -c compile
764+
MACHINE=<machine> bitbake zlib
790765
791766
.. rubric:: Installing Package
792767
:name: installing-package
793768

794-
.. ifconfig:: CONFIG_sdk in ('SITARA')
769+
To install a modified and rebuilt package, copy the new IPKs from the
770+
deploy-ipks folder (e.g., :file:`arago-tmp-default-glibc/work/aarch64-oe-linux/zlib/<version>/deploy-ipks`)
771+
to the target system and then run the following command to install the IPKs:
795772

796-
To install a modified and rebuilt package, copy the new IPKs from the
797-
deploy-ipks folder (e.g.,
798-
**arago-tmp-[toolchain]/work/<machine>-linux-gnueabi/opencl/[version]/deploy-ipks**)
799-
to the target system and then run the following command to install the
800-
IPKs:
801-
802-
``opkg install [package_ipk].ipk``
803-
804-
.. ifconfig:: CONFIG_sdk in ('JACINTO','j7_foundational')
805-
806-
To install a modified and rebuilt package, copy the new IPKs from the
807-
deploy-ipks folder (e.g.,
808-
**arago-tmp-[toolchain]/work/<machine>-linux/k3conf/[version]/deploy-ipks**)
809-
to the target system and then run the following command to install the
810-
IPKs:
773+
.. code-block:: console
811774
812-
``opkg install [package_ipk].ipk``
775+
opkg install [package_ipk].ipk
813776
814777
.. rubric:: Cleaning a Built Recipe
815778
:name: cleaning-a-built-recipe
816779

817780
A built recipe can be cleaned using:
818781

819-
``MACHINE=<machine> bitbake <target> -c cleansstate``
782+
.. code-block:: console
783+
784+
MACHINE=<machine> bitbake <target> -c cleansstate
785+
786+
OR
820787

821-
or
788+
.. code-block:: console
822789
823-
``MACHINE=<machine> bitbake <target> -c cleanall``
790+
MACHINE=<machine> bitbake <target> -c cleanall
824791
825792
The cleansstate task will clean recipe's work directory and remove the
826793
recipe's output from the dependency tree used by other recipe's during

0 commit comments

Comments
 (0)