Skip to content

Commit ede2531

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 <[email protected]>
1 parent acfa2f5 commit ede2531

File tree

6 files changed

+135
-14
lines changed

6 files changed

+135
-14
lines changed

source/images/home_screen.png

36.8 KB
Loading
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: 135 additions & 14 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::
@@ -44,6 +104,19 @@ Hardware Prerequisites
44104

45105
- TI |__PART_FAMILY_DEVICE_NAMES__| SK
46106

107+
.. ifconfig:: CONFIG_part_variant in ('AM335X')
108+
109+
- AM335x Evaluation Module: AM335x EVM
110+
- BeagleBone Black
111+
112+
.. ifconfig:: CONFIG_part_variant in ('AM437X')
113+
114+
- AM437x Evaluation Module: AM437x GP EVM
115+
116+
.. ifconfig:: CONFIG_part_variant in ('AM65X')
117+
118+
- AM65x Evaluation Module: AM654x GP EVM
119+
47120
- PC (Windows or Linux, to use serial terminal console)
48121

49122
- HDMI/DSI Display (to view the Demo on Display)
@@ -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/lvgl_legacy_home_screen.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,22 @@ 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+
130225
Launching the Smart Home HMI
131226
============================
132227

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

348-
1. First clone the git repository and its submodules using:
443+
.. note::
444+
445+
**Source Code Repositories by Platform**
446+
447+
For AM335X, AM437X, and AM65X platforms, use the legacy repository:
349448

350449
.. code-block:: console
351450
352-
$ git clone --recurse-submodules https://github.com/TexasInstruments/ti-lvgl-demo.git
451+
$ git clone -b legacy --recurse-submodules https://github.com/TexasInstruments/ti-lvgl-demo-legacy.git
452+
453+
1. First clone the appropriate git repository and its submodules using:
454+
455+
.. ifconfig:: CONFIG_part_variant in ('AM62LX', 'AM62X', 'AM62PX')
456+
457+
.. code-block:: console
458+
459+
$ git clone --recurse-submodules https://github.com/TexasInstruments/ti-lvgl-demo.git
460+
461+
.. ifconfig:: CONFIG_part_variant in ('AM335X', 'AM437X', 'AM65X')
462+
463+
.. code-block:: console
464+
465+
$ git clone -b legacy --recurse-submodules https://github.com/TexasInstruments/ti-lvgl-demo.git
353466
354467
2. Create the docker environment and build the application:
355468

356-
.. code-block:: console
357469

358-
$ cd ti-lvgl-demo
359-
$ sudo ./scripts/docker_setup.sh --create-image
360-
$ sudo ./scripts/docker_setup.sh --build-app
470+
.. code-block:: console
471+
472+
$ cd ti-lvgl-demo
473+
$ sudo ./scripts/docker_setup.sh --create-image
474+
$ sudo ./scripts/docker_setup.sh --build-app
361475
362476
3. Copy the compiled binary to :file:`/usr/bin` directory of the device
363477

364-
.. code-block:: console
478+
.. ifconfig:: CONFIG_part_variant in ('AM62LX', 'AM62X', 'AM62PX')
479+
480+
.. code-block:: console
481+
482+
$ scp lv_port_linux/bin/lvglsim root@<ip-addr-of-device>:/usr/bin/
483+
$ 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
484+
$ 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
485+
$ 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
365486
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
487+
.. ifconfig:: CONFIG_part_variant in ('AM335X', 'AM437X', 'AM65X')
370488

489+
.. code-block:: console
371490
491+
$ scp lv_port_linux/build-arm64/bin/lvglsim root@<ip-addr-of-device>:/usr/bin/
492+
$ 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)