Skip to content

Commit fc868c8

Browse files
committed
fix: Demos: Update LVGL demo user guide
update the LVGL demo user guide as the previous does not have any information for the LVGL demo of the legacy platforms(AM3xx,AM4xx). Signed-off-by: sadik <s-sadik@ti.com>
1 parent f6d7bbb commit fc868c8

File tree

5 files changed

+142
-18
lines changed

5 files changed

+142
-18
lines changed
29.2 KB
Loading
26.1 KB
Loading
26.1 KB
Loading
36.8 KB
Loading

source/linux/Demo_User_Guides/TI_LVGL_Demo_User_Guide.rst

Lines changed: 142 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,8 @@ It includes various demo applications, such as:
1313

1414
- EV Charging
1515

16+
- Arm analytics
17+
1618
- Smart Home
1719

1820
- Smart Meter
@@ -21,6 +23,64 @@ It includes various demo applications, such as:
2123

2224
- Security
2325

26+
.. note::
27+
28+
Platform compatibility varies for different demo applications. Please refer to the platform compatibility table below:
29+
30+
.. list-table:: Demo Compatibility by Platform
31+
:header-rows: 1
32+
:widths: 20 16 16 16 16 16 16
33+
34+
* - Platform
35+
- EV Charging
36+
- Arm analytics
37+
- Smart Home
38+
- Smart Meter
39+
- Thermostat
40+
- Security
41+
* - AM62L
42+
- ✓
43+
- ✗
44+
- ✓
45+
- ✓
46+
- ✓
47+
- ✓
48+
* - AM62x
49+
- ✓
50+
- ✗
51+
- ✓
52+
- ✓
53+
- ✓
54+
- ✓
55+
* - AM62P
56+
- ✓
57+
- ✗
58+
- ✓
59+
- ✓
60+
- ✓
61+
- ✓
62+
* - AM335X
63+
- ✗
64+
- ✓
65+
- ✓
66+
- ✓
67+
- ✓
68+
- ✗
69+
* - AM437X
70+
- ✗
71+
- ✓
72+
- ✓
73+
- ✓
74+
- ✓
75+
- ✗
76+
* - AM65X
77+
- ✗
78+
- ✓
79+
- ✓
80+
- ✓
81+
- ✓
82+
- ✗
83+
2484
All necessary equipment and step by step instructions are provided below:
2585

2686
.. note::
@@ -34,15 +94,28 @@ Hardware Prerequisites
3494

3595
.. ifconfig:: CONFIG_part_variant in ('AM62LX')
3696

37-
- AM62L Evaluation Module: TMDS62LEVM
97+
- AM62L Evaluation Module: `TMDS62LEVM <https://www.ti.com/tool/TMDS62LEVM>`__
3898

3999
.. ifconfig:: CONFIG_part_variant in ('AM62X')
40100

41-
- TI AM62x SK / TI AM62x-LP SK / TI AM62xSIP SK / BeaglePlay
101+
- TI AM62x SK / TI AM62x-LP SK / TI AM62xSIP SK / BeaglePlay `SK-AM62 <https://www.ti.com/tool/SK-AM62>`__
42102

43103
.. ifconfig:: CONFIG_part_variant in ('AM62PX')
44104

45-
- TI |__PART_FAMILY_DEVICE_NAMES__| SK
105+
- TI SK-AM62P-LP `TMDS62LEVM <https://www.ti.com/tool/SK-AM62P-LP>`__
106+
107+
.. ifconfig:: CONFIG_part_variant in ('AM335X')
108+
109+
- AM335x Evaluation Module: AM335x EVM or `BEAGL-BONE-GRN-ECO <https://www.ti.com/tool/BEAGL-BONE-GRN-ECO>`__
110+
- BeagleBone Black
111+
112+
.. ifconfig:: CONFIG_part_variant in ('AM437X')
113+
114+
- AM437x Evaluation Module: AM437x GP EVM `TMDSEVM437X <https://www.ti.com/tool/TMDSEVM437X>`__
115+
116+
.. ifconfig:: CONFIG_part_variant in ('AM65X')
117+
118+
- AM65x Evaluation Module: AM654x GP EVM `TMDX654IDKEVM <https://www.ti.com/tool/TMDX654IDKEVM>`__
46119

47120
- PC (Windows or Linux, to use serial terminal console)
48121

@@ -100,10 +173,16 @@ Using the TI LVGL Demo
100173

101174
The landing/home page of the LVGL demo looks like the following:
102175

103-
.. Image:: /images/ti-lvgl-demo-home-page.gif
104-
:height: 500
176+
.. ifconfig:: CONFIG_part_variant in ('AM335X' 'AM437X' 'AM65X')
177+
178+
.. Image:: /images/ti-lvgl-demo-legacy-home.png
179+
:height: 500
180+
181+
.. ifconfig:: CONFIG_part_variant in ('AM62LX' 'AM62PX' 'AM62X')
182+
183+
.. Image:: /images/ti-lvgl-demo-home-page.gif
184+
:height: 500
105185

106-
|
107186

108187
- In the demo, scroll through the various widgets to launch different apps.
109188
- The date/time panel shows the UTC timezone provided the EVM is connected to the internet.
@@ -127,6 +206,34 @@ Launching the EV Charging HMI
127206
.. Image:: /images/ti-lvgl-demo-ev-charging2.png
128207
:height: 300
129208

209+
210+
Launching the Arm analytics
211+
=============================
212+
213+
1. Launch the Arm Analytics demo by clicking the **Arm Analytics** widget in the apps scroll menu.
214+
2. Connect the microphone and click the **Play** button to start audio recognition.
215+
216+
.. Image:: /images/ti-lvgl-demo-arm-analytics1.png
217+
:height: 300
218+
3. Expose multiple audio sources to the microphone to view the output results. Click the **Stop** button to stop audio recognition.
219+
220+
.. Image:: /images/ti-lvgl-demo-arm-analytics2.png
221+
:height: 300
222+
.. Image:: /images/ti-lvgl-demo-arm-analytics3.png
223+
:height: 300
224+
225+
**Technical Details:**
226+
227+
The Arm Analytics demo leverages machine learning for real-time audio recognition:
228+
229+
- **ML Framework**: The demo uses :ref:`TensorFlow Lite (LiteRT) <tflite-label>` as the deep learning runtime for efficient on-device inference on Arm Cortex-A cores
230+
- **Pipeline Management**: :ref:`NNStreamer <nnstreamer-label>` is used to manage the neural network pipeline, providing seamless integration between audio capture and ML inference through GStreamer plugins
231+
232+
For more information on the underlying technologies:
233+
234+
- :ref:`TensorFlow Lite (LiteRT) <tflite-label>` - Deep learning inference framework
235+
- :ref:`NNStreamer <nnstreamer-label>` - Neural network pipeline management
236+
130237
Launching the Smart Home HMI
131238
============================
132239

@@ -345,27 +452,44 @@ assets here while making any modifications.
345452
The source code is available at `TI LVGL Demo <https://github.com/TexasInstruments/ti-lvgl-demo.git/>`__ and can be re-compiled with the
346453
following steps:
347454

348-
1. First clone the git repository and its submodules using:
349455

350-
.. code-block:: console
456+
1. First clone the appropriate git repository and its submodules using:
457+
458+
.. ifconfig:: CONFIG_part_variant in ('AM62LX', 'AM62X', 'AM62PX')
459+
460+
.. code-block:: console
461+
462+
$ git clone --recurse-submodules https://github.com/TexasInstruments/ti-lvgl-demo.git
463+
464+
.. ifconfig:: CONFIG_part_variant in ('AM335X', 'AM437X', 'AM65X')
351465

352-
$ git clone --recurse-submodules https://github.com/TexasInstruments/ti-lvgl-demo.git
466+
.. code-block:: console
467+
468+
$ git clone -b legacy --recurse-submodules https://github.com/TexasInstruments/ti-lvgl-demo.git
353469
354470
2. Create the docker environment and build the application:
355471

356-
.. code-block:: console
357472

358-
$ cd ti-lvgl-demo
359-
$ sudo ./scripts/docker_setup.sh --create-image
360-
$ sudo ./scripts/docker_setup.sh --build-app
473+
.. code-block:: console
474+
475+
$ cd ti-lvgl-demo
476+
$ sudo ./scripts/docker_setup.sh --create-image
477+
$ sudo ./scripts/docker_setup.sh --build-app
361478
362479
3. Copy the compiled binary to :file:`/usr/bin` directory of the device
363480

364-
.. code-block:: console
481+
.. ifconfig:: CONFIG_part_variant in ('AM62LX', 'AM62X', 'AM62PX')
482+
483+
.. code-block:: console
484+
485+
$ scp lv_port_linux/bin/lvglsim root@<ip-addr-of-device>:/usr/bin/
486+
$ scp -r lv_port_linux/demos/high_res/assets/* root@<ip-addr-of-device>:/usr/share/ti-lvgl-demo/assets/ #make sure assets directory is there on target
487+
$ scp -r lv_port_linux/demos/high_res/slides/* root@<ip-addr-of-device>:/usr/share/ti-lvgl-demo/slides/ #make sure slides directory is there on target
488+
$ scp lv_port_linux/certs/<certificate> root@<ip-addr-of-device>:/usr/share/ti-lvgl-demo/cert/ #make sure cert directory is there on target
365489
366-
$ scp lv_port_linux/bin/lvglsim root@<ip-addr-of-device>:/usr/bin/
367-
$ scp -r lv_port_linux/demos/high_res/assets/* root@<ip-addr-of-device>:/usr/share/ti-lvgl-demo/assets/ #make sure assets directory is there on target
368-
$ scp -r lv_port_linux/demos/high_res/slides/* root@<ip-addr-of-device>:/usr/share/ti-lvgl-demo/slides/ #make sure slides directory is there on target
369-
$ scp lv_port_linux/certs/<certificate> root@<ip-addr-of-device>:/usr/share/ti-lvgl-demo/cert/ #make sure cert directory is there on target
490+
.. ifconfig:: CONFIG_part_variant in ('AM335X', 'AM437X', 'AM65X')
370491

492+
.. code-block:: console
371493
494+
$ scp lv_port_linux/build-arm64/bin/lvglsim root@<ip-addr-of-device>:/usr/bin/
495+
$ scp -r lv_port_linux/build-arm64/_deps/lv_demos_ext-src/src/high_res/assets/* root@<ip-addr-of-device>:/usr/share/ti-lvgl-demo/assets/ #make sure assets directory is there on target

0 commit comments

Comments
 (0)