Skip to content

Commit e4602ca

Browse files
jeevantelukulajsuhaas22
jeevantelukula
authored and
jsuhaas22
committed
fix: Update SDK Top Level Makefile Build Instructions for AM62A
The current top level makefile instructions are incorrect. So, add AM62A specific instructions in the common Top level Makefile instructions and point toc to it. Also common setup scripts are used for AM62A. Hence point to common setup scripts instructions in toc. Signed-off-by: Telukula Jeevan Kumar Sahu <[email protected]>
1 parent ad93a54 commit e4602ca

File tree

4 files changed

+62
-118
lines changed

4 files changed

+62
-118
lines changed

‎configs/AM62AX/AM62AX_linux_toc.txt‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ devices/AM62AX/linux/Overview
44
devices/AM62AX/linux/Overview_Getting_Started_Guide
55
devices/AM62AX/linux/Overview/Build_and_Run_the_Demos
66
devices/AM62AX/linux/Overview/Download_and_Install_the_SDK
7-
devices/AM62AX/linux/Overview/Run_Setup_Scripts
7+
linux/Overview/Run_Setup_Scripts
88
devices/AM62AX/linux/Release_Specific
99
devices/AM62AX/linux/Release_Specific_Release_Notes
1010
devices/AM62AX/linux/Release_Specific_Yocto_layer_Configuration
@@ -15,7 +15,7 @@ devices/AM62AX/linux/RT_Linux_Performance_Guide
1515
devices/AM62AX/linux/Release_Specific_Supported_Platforms_and_Versions
1616

1717
linux/Overview_Building_the_SDK
18-
linux/Overview_Top_Level_Makefile
18+
linux/Overview/Top_Level_Makefile
1919
linux/Overview_Directory_Structure_Overview
2020
linux/Overview_Technical_Support
2121
linux/Overview_GPLv3_Disclaimer

‎source/devices/AM62AX/linux/Overview.rst‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,6 @@ solutions.
1313

1414
Overview_Getting_Started_Guide
1515
/linux/Overview_Building_the_SDK
16-
/linux/Overview_Top_Level_Makefile
1716
/linux/Overview_Directory_Structure_Overview
1817
/linux/Overview_Software_Stack
1918
/linux/Overview_Technical_Support

‎source/devices/AM62AX/linux/Overview_Getting_Started_Guide.rst‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Getting Started Guide
99
:maxdepth: 5
1010

1111
Overview/Download_and_Install_the_SDK
12-
/linux/Overview/Top_Level_Makefile
1312
/linux/Overview/Processor_SDK_Linux_create_SD_card
14-
Overview/Run_Setup_Scripts
15-
/linux/Overview/GCC_ToolChain
13+
/linux/Overview/Run_Setup_Scripts
14+
/linux/Overview/Top_Level_Makefile
15+
/linux/Overview/GCC_ToolChain

‎source/linux/Overview/Top_Level_Makefile.rst‎

Lines changed: 57 additions & 112 deletions
Original file line numberDiff line numberDiff line change
@@ -102,23 +102,23 @@ makefile targets.
102102
* AM62x installer supports ``am62xx-evm`` and ``am62xx-lp-evm`` platforms. ``am62xx-evm`` is the default platform for the Toplevel Makefile. To build for ``am62xx-lp-evm``, pass ``PLATFORM=am62xx-lp-evm`` as argument to make.
103103
* No special arguments are needed to build for ``am62xxsip-evm`` in AM62xSIP Installer.
104104

105-
.. ifconfig:: CONFIG_part_variant not in ('AM62X', 'AM64X', 'AM62PX', 'AM335X', 'AM437X', 'AM65X', 'AM57X')
105+
.. ifconfig:: CONFIG_part_variant not in ('AM62X', 'AM64X', 'AM62PX', 'AM335X', 'AM437X', 'AM65X', 'AM57X', 'AM62AX')
106106

107-
.. code-block:: console
107+
.. code-block:: console
108108
109-
host# sudo apt-get install build-essential autoconf automake bison flex libssl-dev bc u-boot-tools swig
109+
host# sudo apt-get install build-essential autoconf automake bison flex libssl-dev bc u-boot-tools swig
110110
111-
.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM62X', 'AM64X', 'AM335X', 'AM437X', 'AM65X', 'AM57X')
111+
.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM62X', 'AM64X', 'AM335X', 'AM437X', 'AM65X', 'AM57X', 'AM62AX')
112112

113-
.. code-block:: console
113+
.. code-block:: console
114114
115-
host# sudo apt-get install build-essential autoconf automake bison flex libgnutls28-dev libmpc-dev libmpcdec6 libmpc3 libmpcdec-dev libssl-dev bc u-boot-tools swig python3 python3-pip
115+
host# sudo apt-get install build-essential autoconf automake bison flex libgnutls28-dev libmpc-dev libmpcdec6 libmpc3 libmpcdec-dev libssl-dev bc u-boot-tools swig python3 python3-pip
116116
117-
Following pip packages are also needed for jailhouse & binman in u-boot targets
117+
Following pip packages are also needed for jailhouse & binman in u-boot targets
118118

119-
.. code-block:: console
119+
.. code-block:: console
120120
121-
host# pip3 install jsonschema pyelftools PyYAML Mako yamllint
121+
host# pip3 install jsonschema pyelftools PyYAML Mako yamllint
122122
123123
.. ifconfig:: CONFIG_sdk in ('JACINTO','j7_foundational')
124124

@@ -204,11 +204,11 @@ devices will have following additional targets:
204204
jailhouse tools and cell configs. Applicable for only platforms with
205205
Hypervisor support enabled.
206206

207-
.. ifconfig:: CONFIG_part_variant in ('AM64X', 'AM62X', 'AM62PX')
207+
.. ifconfig:: CONFIG_part_variant in ('AM64X', 'AM62X', 'AM62PX', 'AM62AX')
208208

209-
- ``arm-benchmarks`` - Build the ARM Benchmarks
209+
- ``arm-benchmarks`` - Build the ARM Benchmarks
210210

211-
- ``cryptodev`` - Build module for cryptographic hardware accelerators.
211+
- ``cryptodev`` - Build module for cryptographic hardware accelerators.
212212

213213
.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM62X')
214214

@@ -354,25 +354,25 @@ the Makefile from the top-level of the SDK.
354354
355355
host# make am-benchmarks_install
356356
357-
.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM62X', 'AM64X' )
357+
.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM62X', 'AM64X', 'AM62AX')
358358

359-
- Build the ARM Benchmarks
359+
- Build the ARM Benchmarks
360360

361-
.. code-block:: console
361+
.. code-block:: console
362362
363-
host# make arm-benchmarks
363+
host# make arm-benchmarks
364364
365-
- Clean the ARM Benchmarks
365+
- Clean the ARM Benchmarks
366366

367-
.. code-block:: console
367+
.. code-block:: console
368368
369-
host# make arm-benchmarks_clean
369+
host# make arm-benchmarks_clean
370370
371-
- Install the ARM Benchmarks
371+
- Install the ARM Benchmarks
372372

373-
.. code-block:: console
373+
.. code-block:: console
374374
375-
host# sudo make arm-benchmarks_install
375+
host# sudo make arm-benchmarks_install
376376
377377
.. ifconfig:: CONFIG_sdk in ('JACINTO','j7_foundational') or CONFIG_part_variant in ('AM65X')
378378

@@ -427,57 +427,57 @@ the Makefile from the top-level of the SDK.
427427
428428
host# make sysfw-image_install
429429
430-
.. ifconfig:: CONFIG_part_variant not in ('AM62PX', 'AM64X', 'AM62X')
430+
.. ifconfig:: CONFIG_part_variant not in ('AM62PX', 'AM64X', 'AM62X', 'AM62AX')
431431

432-
- Build u-boot
432+
- Build u-boot
433433

434-
.. code-block:: console
434+
.. code-block:: console
435435
436-
host# make u-boot
436+
host# make u-boot
437437
438-
- Clean u-boot
438+
- Clean u-boot
439439

440-
.. code-block:: console
440+
.. code-block:: console
441441
442-
host# make u-boot_clean
442+
host# make u-boot_clean
443443
444-
.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM64X', 'AM62X')
444+
.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM64X', 'AM62X', 'AM62AX')
445445

446-
- Build u-boot
446+
- Build u-boot
447447

448-
.. code-block:: console
448+
.. code-block:: console
449449
450-
host# make u-boot
450+
host# make u-boot
451451
452-
- Build A53
452+
- Build A53
453453

454454
.. code-block:: console
455455
456-
host# make u-boot-a53
456+
host# make u-boot-a53
457457
458-
- Build R5
458+
- Build R5
459459

460460
.. code-block:: console
461461
462-
host# make u-boot-r5
462+
host# make u-boot-r5
463463
464-
- Copy boot-binaries to built-images folder
464+
- Copy boot-binaries to built-images folder
465465

466466
.. code-block:: console
467467
468-
host# make u-boot_stage
468+
host# make u-boot_stage
469469
470-
- Install boot-binaries to SD card boot partition
470+
- Install boot-binaries to SD card boot partition
471471

472472
.. code-block:: console
473473
474-
host# sudo DESTDIR=/media/$USER/boot make u-boot_install
474+
host# sudo DESTDIR=/media/$USER/boot make u-boot_install
475475
476-
- Clean u-boot
476+
- Clean u-boot
477477

478478
.. code-block:: console
479479
480-
host# make u-boot_clean
480+
host# make u-boot_clean
481481
482482
.. ifconfig:: CONFIG_part_variant in ('AM62X')
483483

@@ -498,53 +498,6 @@ the Makefile from the top-level of the SDK.
498498
499499
Similar argument can be added to all u-boot targets discussed above.
500500

501-
.. ifconfig:: CONFIG_part_variant in ('AM62AX')
502-
503-
- Build the combined boot image (tiboot3.bin)
504-
505-
This requires first building the R5 boot image. This will generate the u-boot-spl.bin. Then build sysfw-image to generate combined boot image.
506-
507-
**For GP**
508-
509-
.. code-block:: console
510-
511-
host# make u-boot
512-
host# make sysfw-image DEVICE_TYPE=gp
513-
514-
The combined boot image will be at <TI_SDK_PATH>/board-support/k3-image-gen*/tiboot3-am6*-gp-evm.bin
515-
516-
**For HS-FS**
517-
518-
.. code-block:: console
519-
520-
host# make u-boot
521-
host# export TI_SECURE_DEV_PKG=<path-to-board-support>/core-secdev-k3
522-
host# make sysfw-image DEVICE_TYPE=hs-fs
523-
524-
The combined boot image will be at <TI_SDK_PATH>/board-support/k3-image-gen*/tiboot3-am6*-hs-fs-evm.bin
525-
526-
**For HS-SE**
527-
528-
.. code-block:: console
529-
530-
host# make u-boot
531-
host# export TI_SECURE_DEV_PKG=<path-to-board-support>/core-secdev-k3
532-
host# make sysfw-image DEVICE_TYPE=hs
533-
534-
The combined boot image will be at <TI_SDK_PATH>/board-support/k3-image-gen*/tiboot3-am6*-hs-evm.bin
535-
536-
.. note:: If TI_SECURE_DEV_PKG environment variable is not defined, tiboot3.bin can still be built for GP devices. The following errors will occur in K3-Image-Gen build logs when building for HS-FS or HS-SE devices without the TI_SECURE_DEV_PKG environment variable defined and K3-Image-Gen build may fail:
537-
538-
.. code-block:: console
539-
540-
TI_SECURE_DEV_PKG must be set for HS, defaults will not work. Stop.
541-
542-
To fix the above issue, do the following and rebuild the `sysfw-image`.
543-
544-
.. code-block:: console
545-
546-
host# export TI_SECURE_DEV_PKG=<path-to-board-support>/core-secdev-k3
547-
548501
.. ifconfig:: CONFIG_sdk in ('JACINTO','j7_foundational')
549502

550503
.. ifconfig:: CONFIG_part_variant in ('J7200')
@@ -579,14 +532,14 @@ the Makefile from the top-level of the SDK.
579532
.. rubric:: Installing boot binaries
580533
:name: installing-boot-binaries
581534

582-
.. ifconfig:: CONFIG_part_variant not in ('AM62PX', 'AM62X', 'AM64X')
535+
.. ifconfig:: CONFIG_part_variant not in ('AM62PX', 'AM62X', 'AM64X', 'AM62AX')
583536

584-
All the install targets copy the files in the rootfs pointed by the DESTDIR variable.
585-
*make install* command only copies the files in rootfs. If you have built either of
586-
system firmware or u-boot, you should copy these binaries in the boot partition of
587-
the SD card. e.g. run following to copy boot binaries in SD card boot partition.
537+
All the install targets copy the files in the rootfs pointed by the DESTDIR variable.
538+
*make install* command only copies the files in rootfs. If you have built either of
539+
system firmware or u-boot, you should copy these binaries in the boot partition of
540+
the SD card. e.g. run following to copy boot binaries in SD card boot partition.
588541

589-
.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM62X', 'AM64X')
542+
.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM62X', 'AM64X', 'AM62AX')
590543

591544
All the install targets copy the files in the rootfs pointed by the DESTDIR variable.
592545
Run following commands to copy boot binaries in SD card boot partition.
@@ -608,27 +561,19 @@ the Makefile from the top-level of the SDK.
608561
609562
.. ifconfig:: CONFIG_part_variant in ('AM62AX')
610563

611-
**For GP**
612-
613-
.. code-block:: console
614-
615-
host# sudo cp board-support/k3-image-gen*/tiboot3-am62*-gp-evm.bin /media/$USER/boot/tiboot3.bin
616-
host# sudo cp board-support/u-boot_build/a53/u-boot.img board-support/u-boot_build/a53/tispl.bin /media/$USER/boot
564+
**For HS-FS**
617565

618-
**For HS-FS**
566+
.. code-block:: console
619567
620-
.. code-block:: console
568+
host# sudo cp board-support/built-images/tiboot3-am62a*-hs-fs-evm.bin /media/$USER/boot/tiboot3.bin
569+
host# sudo cp board-support/built-images/u-boot.img board-support/built-images/tispl.bin /media/$USER/boot
621570
622-
host# sudo cp board-support/k3-image-gen*/tiboot3-am62*-hs-fs-evm.bin /media/$USER/boot/tiboot3.bin
623-
host# sudo cp board-support/u-boot_build/a53/u-boot.img board-support/u-boot_build/a53/tispl.bin /media/$USER/boot
571+
**For HS-SE**
624572

625-
**For HS-SE**
626-
627-
.. code-block:: console
573+
.. code-block:: console
628574
629-
host# sudo cp board-support/k3-image-gen*/tiboot3-am62*-hs-evm.bin /media/$USER/boot/tiboot3.bin
630-
host# sudo cp board-support/u-boot_build/a53/tispl.bin_HS /media/$USER/boot/tispl.bin
631-
host# sudo cp board-support/u-boot_build/a53/u-boot.img_HS /media/$USER/boot/u-boot.img
575+
host# sudo cp board-support/built-images/tiboot3-am62a*-hs-evm.bin /media/$USER/boot/tiboot3.bin
576+
host# sudo cp board-support/built-images/tispl.bin board-support/built-images/u-boot.img /media/$USER/boot
632577
633578
.. ifconfig:: CONFIG_part_variant in ('AM62X')
634579

0 commit comments

Comments
 (0)