Skip to content

Commit f7319d4

Browse files
committed
feat: linux: Add compilation instructions for TI Apps Launcher
meta-arago-toolchain lacks Qt6 support for compiling TI Apps Launcher. The correct way to compile it is to use Yocto. However, for quicker way to compile it, we can also use ARM64 Docker containers. Provide a guide on how to compile ti-apps-launcher using ARM64 Docker container which TI provides [0]. [0] https://github.com/TexasInstruments/ti-docker-images/pkgs/container/debian-arm64 Signed-off-by: Suhaas Joshi <s-joshi@ti.com>
1 parent ed62879 commit f7319d4

1 file changed

Lines changed: 46 additions & 0 deletions

File tree

source/linux/Demo_User_Guides/TI_Apps_Launcher_User_Guide.rst

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -438,3 +438,49 @@ Power Menu
438438
.. Image:: /images/ti-apps-launcher-powermenu2.png
439439
:height: 400
440440

441+
Compiling TI Apps Launcher
442+
--------------------------
443+
444+
The ideal way to compile TI Apps Launcher is to trigger a Yocto
445+
build. But for a quicker way to do it, especially during development,
446+
TI provides a `debian-arm64
447+
<https://github.com/TexasInstruments/ti-docker-images/pkgs/container/debian-arm64>`__
448+
Docker image. This image already contains all dependencies required
449+
for compiling ti-apps-launcher.
450+
451+
452+
First, clone TI Apps Launcher:
453+
454+
.. code:: console
455+
456+
git clone https://github.com/texasinstruments/ti-apps-launcher.git
457+
cd ti-apps-launcher
458+
459+
Then, add the following line in CMakeLists.txt:
460+
461+
.. code:: console
462+
463+
add_compile_definitions(SOC_AM62=1) # if target is AM62x or AM62SIP
464+
add_compile_definitions(SOC_AM62_LP=1) # if target is AM62x-LP
465+
add_compile_definitions(SOC_AM62P=1) # if target is AM62P
466+
467+
Then, pull TI's debian-arm64 Docker image and run it:
468+
469+
.. code:: console
470+
471+
docker pull ghcr.io/texasinstruments/debian-arm64:latest
472+
docker run -it -v <path_to_ti-apps-launcher>:/root/ti-apps-launcher ghcr.io/texasinstruments/debian-arm64 bash
473+
474+
Finally, run:
475+
476+
.. code:: console
477+
478+
cmake -B build -S . -DRT_BUILD=0 # if target is RT image, make -DR_BUILD=1
479+
make -C build
480+
481+
The compiled binary should be ``build/ti-apps-launcher``.
482+
483+
Note: This is a quick and easy way to compile ti-apps-launcher during
484+
development, but it is a good idea to validate with Yocto builds
485+
often. There is a possibility that compiler mismatch could present
486+
issues in the run up to production.

0 commit comments

Comments
 (0)