feat: Update demos and build instruction for ti-apps-launcher

- Add info about Wi-Fi demo showing steps including how to enable Wi-Fi, scanning SSIDs and handling connections. - Add info about terminal demo for accessing terminal from the ti-apps-launcher. - Update build instruction for Linux and RT-Linux build. - Mention Wi-Fi and Terminal demo info in Release Notes for 10.1. Signed-off-by: Paresh Bhagat <[email protected]>
TexasInstruments · Dec 16, 2024 · 0c374ed · 0c374ed
1 parent 92f23db
commit 0c374ed
Show file tree

Hide file tree

Showing 7 changed files with 79 additions and 6 deletions.
diff --git a/source/devices/AM62PX/linux/Release_Specific_Release_Notes.rst b/source/devices/AM62PX/linux/Release_Specific_Release_Notes.rst
@@ -50,6 +50,7 @@ What's new
   - Important Bug Fixes on top of Processor SDK 10.00.07.04 Release
   - RT Kernel : Real-Time Linux Interrupt Latency numbers here - :ref:`RT Interrupt Latencies <RT-linux-performance>`
   - Power Management: DeepSleep, MCU-Only and Partial IO mode - :ref:`Power Management Overview <Power-Management>`
+  - TI Apps Launcher: New Wi-Fi and Terminal Demo - :ref:`TI Apps Launcher <TI-Apps-Launcher-User-Guide-label>`
 
 
 **Component version:**

diff --git a/source/devices/AM62X/linux/Release_Specific_Release_Notes.rst b/source/devices/AM62X/linux/Release_Specific_Release_Notes.rst
@@ -49,6 +49,7 @@ What's new
   - Important Bug Fixes on top of Processor SDK 10.00.07.04 Release
   - RT Kernel : Real-Time Linux Interrupt Latency numbers here - :ref:`RT Interrupt Latencies <RT-linux-performance>`
   - Power Management: DeepSleep, MCU-Only and Partial IO mode - :ref:`Power Management Overview <Power-Management>`
+  - TI Apps Launcher: New Wi-Fi and Terminal Demo - :ref:`TI Apps Launcher <TI-Apps-Launcher-User-Guide-label>`
 
 
 **Component version:**

diff --git a/source/images/terminal.png b/source/images/terminal.png
diff --git a/source/images/wifi_connected.png b/source/images/wifi_connected.png
diff --git a/source/images/wifi_home.png b/source/images/wifi_home.png
diff --git a/source/images/wifi_ssid.png b/source/images/wifi_ssid.png
diff --git a/source/system/Demo_User_Guides/TI_Apps_Launcher_User_Guide.rst b/source/system/Demo_User_Guides/TI_Apps_Launcher_User_Guide.rst
@@ -365,14 +365,70 @@ _________________________
 
 3. Once you enter the necessary values for both HTTPS and No proxy, click on `Set Proxy` to set the proxy configuration.
 
+
+Using terminal
+______________
+
+.. ifconfig:: CONFIG_sdk in ('SITARA')
+
+   The terminal button on the left panel can be used to open a terminal application, which is
+   based on QMLtermwidget.
+
+   .. Image:: /images/terminal.png
+      :height: 400
+
+.. ifconfig:: CONFIG_sdk not in ('SITARA')
+
+   This section is not applicable for this platform.
+
+Using Wi-Fi Demo
+________________
+
+.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62PX')
+
+   The *Wifi* button on the left panel allows you to connect to an external Wi-Fi network.
+
+   Ensure the required overlay is applied and the M.2 Wi-Fi card is connected to SK-EVM. For more
+   information, refer to :ref:`enable_m2cc3301`.
+
+   Click the toggle button to turn on Wi-Fi.
+
+   .. Image:: /images/wifi_home.png
+      :height: 400
+
+   * Click on the *Refresh* button to scan for available SSIDs.
+   * Select an SSID from the list, then enter the passphrase and Wi-Fi security type.
+   * For certain security types, you may need to provide additional details.
+   * After entering all the required info, click on *Connect*.
+
+   .. Image:: /images/wifi_ssid.png
+      :height: 400
+
+   If the all entered details are correct, device will be connected to the selected Wi-Fi
+   network. If needed, click *Disconnect* to disconnect from the network and return to
+   SSID selection menu.
+
+   .. Image:: /images/wifi_connected.png
+      :height: 400
+
+   .. ifconfig:: CONFIG_part_variant in ('AM62X')
+
+      .. note::
+
+         This section is not applicable for AM62xLP and AM62xSIP.
+
+.. ifconfig:: CONFIG_part_variant not in ('AM62X', 'AM62PX')
+
+   This section is not applicable for this platform.
+
 Power Menu
 __________
 
 1. The top right corner of the TI Apps Launcher is dedicated for the Power Menu.
 
 .. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62PX')
 
-    2. The Power Menu supports Shutdown, Reboot, Suspend to RAM and Exit (from TI Apps Launcher) functions.
+    2. The Power Menu supports Shutdown, Reboot, Suspend to RAM (For Linux only) and Exit (from TI Apps Launcher) functions.
 
     .. Image:: /images/ti-apps-launcher-powermenu1.png
        :height: 400
@@ -403,18 +459,33 @@ The source code is available at `TI Apps Launcher <https://github.com/TexasInstr
 
       .. code-block:: console
 
-         $ qmake "SOURCES += configs/am62pxx-evm.cpp" "DEFINES += SOC_AM62P" ./ti-apps-launcher.pro ; make
+         For Linux build
+
+         $ qmake "SOURCES += configs/am62pxx-evm.cpp" "DEFINES += SOC_AM62P" "DEFINES += RT_BUILD=0" ./ti-apps-launcher.pro ; make
+
+         For RT-Linux build
+
+         $ qmake "SOURCES += configs/am62pxx-evm.cpp" "DEFINES += SOC_AM62P" "DEFINES += RT_BUILD=1" ./ti-apps-launcher.pro ; make
 
       |
 
    .. ifconfig:: CONFIG_part_variant in ('AM62X')
 
       .. code-block:: console
 
-         $ qmake "SOURCES += configs/am62xx-evm.cpp" "DEFINES += SOC_AM62" ./ti-apps-launcher.pro ; make # For AM62x SK
-         $ qmake "SOURCES += configs/am62xx-lp-evm.cpp" "DEFINES += SOC_AM62_LP" ./ti-apps-launcher.pro ; make # For AM62x LP SK
-         $ qmake "SOURCES += configs/am62xxsip-evm.cpp" "DEFINES += SOC_AM62_LP" ./ti-apps-launcher.pro ; make # For AM62xSIP SK
-         $ qmake "SOURCES += configs/beagleplay.cpp" "DEFINES += SOC_AM62" ./ti-apps-launcher.pro ; make # For Beagleplay
+         For Linux build
+
+         $ qmake "SOURCES += configs/am62xx-evm.cpp" "DEFINES += SOC_AM62" "DEFINES += RT_BUILD=0" ./ti-apps-launcher.pro ; make # For AM62x SK
+         $ qmake "SOURCES += configs/am62xx-lp-evm.cpp" "DEFINES += SOC_AM62_LP" "DEFINES += RT_BUILD=0" ./ti-apps-launcher.pro ; make # For AM62x LP SK
+         $ qmake "SOURCES += configs/am62xxsip-evm.cpp" "DEFINES += SOC_AM62_LP" "DEFINES += RT_BUILD=0" ./ti-apps-launcher.pro ; make # For AM62xSIP SK
+         $ qmake "SOURCES += configs/beagleplay.cpp" "DEFINES += SOC_AM62" "DEFINES += RT_BUILD=0" ./ti-apps-launcher.pro ; make # For Beagleplay
+
+         For RT-Linux build
+
+         $ qmake "SOURCES += configs/am62xx-evm.cpp" "DEFINES += SOC_AM62" "DEFINES += RT_BUILD=1" ./ti-apps-launcher.pro ; make # For AM62x SK
+         $ qmake "SOURCES += configs/am62xx-lp-evm.cpp" "DEFINES += SOC_AM62_LP" "DEFINES += RT_BUILD=1" ./ti-apps-launcher.pro ; make # For AM62x LP SK
+         $ qmake "SOURCES += configs/am62xxsip-evm.cpp" "DEFINES += SOC_AM62_LP" "DEFINES += RT_BUILD=1" ./ti-apps-launcher.pro ; make # For AM62xSIP SK
+         $ qmake "SOURCES += configs/beagleplay.cpp" "DEFINES += SOC_AM62" "DEFINES += RT_BUILD=1" ./ti-apps-launcher.pro ; make # For Beagleplay
 
       |