Last modified by Dilisi S on 2025/02/26 19:24
<
From version < 104.1 >
edited by BoYang Xie
on 2024/11/22 15:40
To version < 121.1 >
edited by Dilisi S
on 2024/12/22 21:12
>
Change comment: Dec 22 edits - part 2

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.xieby
1 +XWiki.pradeeka
Content
... ... @@ -21,20 +21,20 @@
21 21  
22 22  = 1.  Introduction =
23 23  
24 -== 1.1  What is LTS5 LoRa HMI touch screen ==
24 +== 1.1  What is the LTS5 LoRa HMI Touch Screen? ==
25 25  
26 26  
27 -LTS5 is a (% style="color:blue" %)LoRa / LoRaWAN HMI Touch Screen(%%) designed for display purpose of IoT project. It have a 5.0" HMI touch screen, and support WiFi, Bluetooch, LoRa wireless protocol.
27 +The LTS5 is a (% style="color:blue" %)**LoRa / LoRaWAN HMI Touch Screen**(%%) designed for displaying information in IoT projects. It features a **5.0-inch HMI touch screen** and supports **Wi-Fi**, **Bluetooth**, and **LoRa** wireless protocols.
28 28  
29 -LTS5 is an Open Source software project. The MCU is ESP32 and Dragino LA66 LoRa module. There are lots of development source for ESP32 which can greatly reduce the development time.
29 +The LTS5 is an open-source software project powered by an **ESP32 MCU** and a **Dragino LA66 LoRa** module. The extensive development resources available for ESP32 can significantly reduce development time.
30 30  
31 -The HMI touch screen of LTS5 supports drap & drop design. Developer can use SquareLine to easily customize the display UI for different application.
31 +The LTS5's HMI touch screen supports **drag-and-drop** design, allowing developers to use SquareLine to easily customize the display UI for various applications.
32 32  
33 -LTS5 use LA66 LoRa module, this module can be program to support private LoRa protocol or LoRaWAN protocol.
33 +The LA66 LoRa module can be programmed to support either private LoRa protocols or the LoRaWAN protocol.
34 34  
35 -
36 36  == 1.2  Features ==
37 37  
37 +
38 38  * ESP32-WROOM MCU: 8MB RAM & 16MB ROM
39 39  * Dragino LA66 LoRa Module
40 40  * Support Private LoRa protocol or LoRaWAN protocol
... ... @@ -47,7 +47,7 @@
47 47  * 5V DC power
48 48  * IP Rating: IP52
49 49  
50 -== 1.3  Specification ==
50 +== 1.3  Specifications ==
51 51  
52 52  
53 53  **LoRa**:
... ... @@ -107,23 +107,32 @@
107 107  == 2.1  About this demo ==
108 108  
109 109  
110 -In this Getting Started Example, we will show how to design a simple Display UI and upload it to LTS5. This UI has  a button , when user click the button. The Web UI will jump to a new page.
110 +This getting started example demonstrates how to design and deploy a simple display UI for the LTS5 device. The example includes:
111 111  
112 +* Creating a basic UI with a single button.
113 +* Implementing functionality to navigate the Web UI to a new page when the button is clicked.
114 +* Uploading the UI to the LTS5 device.
112 112  
116 +By completing this demo, you will gain foundational knowledge for customizing the LTS5 interface and building more advanced IoT applications.
117 +
118 +
113 113  == 2.2  Install Software Running Environment ==
114 114  
115 -The ESP MCU can be developed using ESP-IDF, Arduino, or MicroPython. For this project, we utilize ESP-IDF for compilation and Visual Studio Code (VSCode) for editing.
116 116  
117 -=== 2.2.1 Install VSCode and ESP-IDF extension ===
122 +The **ESP MCU** supports development with **ESP-IDF**, **Arduino**, or **MicroPython**. We use **ESP-IDF** for compilation and **Visual Studio Code (VS Code)** as the development environment for this project.
118 118  
119 119  
120 -Firstly, download and install VSCode for your computer's operating system from the official website: [[Download Visual Studio Code - Mac, Linux, Windows>>url:https://code.visualstudio.com/download]].
125 +=== 2.2.1 Install VS Code and ESP-IDF extension ===
121 121  
122 -Next, you need to install the ESP-IDF extension within VSCode. The detailed operation steps are illustrated in image 1.
123 123  
128 +First, download and install **VS Code** for your operating system from the Visual Studio Code website: [[Visual Studio Code - Mac, Linux, Windows>>https://code.visualstudio.com/download]].
129 +
130 +Next, install the **ESP-IDF** extension within **VS Code**. Detailed steps for this process are shown in Image 1.
131 +
132 +
124 124  [[image:image-20240928110211-5.png||height="508" width="866"]]
125 125  
126 - image 1 ESP-IDF extension install
135 + Image 1: ESP-IDF extension install
127 127  
128 128  Links for reference: [[Install ESP32 ESP-IDF on Windows and Integrate with VS code (esp32tutorials.com)>>url:https://esp32tutorials.com/install-esp32-esp-idf-windows-integrate-vs-code/#:~~:text=In%20this%20tutorial,%20we%20will%20show%20you%20how%20to%20install]]
129 129  
... ... @@ -131,32 +131,60 @@
131 131  === 2.2.2 Install SquareLine Studio ===
132 132  
133 133  
134 -The version we are utilizing for this software is 1.4.2. You can download it from the official link: [[SquareLine Studio - Download the current version of SquareLine Studio>>url:https://squareline.io/downloads#lastRelease]].
143 +Download and install the latest version of [[SquareLine Studio>>https://squareline.io/downloads#lastRelease]] on your computer. It supports Windows, Linux, and Mac OS. The software version we are using here is 1.4.2.
135 135  
136 -Please note that this software necessitates the registration of a license prior to usage, and various licenses come with distinct limitations. For instance, the free version imposes restrictions such as a limit of 1 component, 150 widgets, and 10 screens. However, for first-time downloads, you are granted unrestricted access for a period of 30 days without the need for immediate registration.
145 +[[image:squareline.io_downloads.png]]
137 137  
138 138  
139 -== 2.3 Simple usage of SquareLine Studio and export UI code ==
148 +After installation, you can use SquareLine Studio with a **PERSONAL license plan**. Click **LOG IN** and create a free account using your email address. Then activate your PERSONAL license plan for free. You don’t need to provide any credit card information. However, the PERSONAL license plan has the following limitations:
140 140  
150 +* Max. 10 screens
151 +* Max. 150 widgets
152 +* Max. 5 global colors
153 +* Max. 2 themes
154 +* Max. 1 component
141 141  
142 -After launching and logging in to this software, create a project as shown in the following image 2. The version of LVGL is 8.3.11.
143 143  
157 +== 2.3 Simple usage of SquareLine Studio and exporting UI code ==
158 +
159 +
160 +After launching and logging into the software, create a new project as shown in Image 2.
161 +
162 +* Select the major **LVGL** version as **8.3**.
163 +* Select the **Desktop** tab.
164 +* Select  **Eclipse with  SDL for  development on PC**:
165 +* In the **PROJECT SETTINGS**, select **LVGL version** **8.3.11**
166 +* Select the **CREATE **button.
167 +
168 +
144 144  [[image:image-20240928103357-2.png||height="680" width="708"]]
145 145  
146 - image 2 create a SquareLine project
171 + Image 2: Creating a new SquareLine project
147 147  
148 -Next, we need to make some settings for this project. By clicking in the specified order on image 3, we can see the page as shown in image 4.
149 149  
174 +Next, you need to configure some settings for this project. By clicking in the specified order shown in Image 3, you will be directed to the page displayed in Image 4.
175 +
176 +* Select File  -> Project Settings
177 +
150 150  [[image:1727229582471-566.png]]
151 151  
152 - image 3 project settings
180 + Image 3 accessing project settings
153 153  
182 +
183 +In the PROJECT SETTINGS dialog box, configure/modify the project settings:
184 +
185 +* **UI Files Export Root**: Select a folder on your computer to store the UI files.
186 +* **LVGL Include Path**: Set this to **lvgl.h**
187 +* **Click on the APPLY CHANGES button.**
188 +
154 154  [[image:image-20240928105309-4.png||height="526" width="556"]]
155 155  
156 - image 4 modify project settings
191 + Image 4 Configure/modify project settings
157 157  
158 -Now we can start to use this software. Here are some usage information for this software.
159 159  
194 +Now you can start building the UI. Follow the steps below:
195 +
196 +
160 160  **~1. add widget**
161 161  
162 162  To add a widget, you should click a widget you want to add at the area entitled “Widgets”. In image , demonstrate a add process of label, button, and image 5.
... ... @@ -291,54 +291,53 @@
291 291  
292 292  = 4. Example Project 2: LoRaWAN RS485 Alarm =
293 293  
294 -(% class="wikigeneratedid" %)
295 295  = 5.  The way to add a new panel to project =
296 296  
297 -~1. Design a panel in SquareLine Studio, using image 5.1 below as a reference.
333 +**~1. Design a panel in SquareLine Studio, using image 5.1 below as a reference.**
298 298  
299 299  [[image:image-20241121113445-1.png||height="584" width="934"]]
300 300  
301 301   image 5.1 a panel about water_leak
302 302  
303 -2. Export the ui file. You need  to adjust the export path first, then click "Export->Export UI Files". This step had been introduced before. Then you can get the ui files as shown in image 5.2.
339 +**2. Export the ui file.** You need  to adjust the export path first, then click "Export->Export UI Files". This step had been introduced before. Then you can get the ui files as shown in image 5.2.
304 304  
305 305  [[image:image-20241121141120-4.png||height="383" width="795"]]
306 306  
307 307   image 5.2 ui files exported
308 308  
309 -3. Delete or rename some file. Here are the steps:
345 +**3. Delete or rename some file.** Here are the steps:
310 310  
311 - 3.1 Delete the 'components' directory.
312 - 3.2 Delete 'filelist.txt'.
313 - 3.3 Delete 'ui_helpers.c' and 'ui_helpers.h'.
314 - 3.4 Rename 'ui_ScreenMain.c' in the 'screens' directory to 'ui_water_leak_style.c'.
315 - 3.5 Rename the 'screens' directory to 'styles'.
347 + Step1 Delete the 'components' directory.
348 + Step2 Delete 'filelist.txt'.
349 + Step3 Delete 'ui_helpers.c' and 'ui_helpers.h'.
350 + Step4 Rename 'ui_ScreenMain.c' in the 'screens' directory to 'ui_water_leak_style.c'.
351 + Step5 Rename the 'screens' directory to 'styles'.
316 316  
317 317  [[image:image-20241121151934-10.png||height="303" width="792"]]
318 318  
319 - image 5.3 rest file 1
355 + image 5.3 rest file (1)
320 320  
321 321  [[image:image-20241121142925-7.png||height="141" width="793"]]
322 322  
323 - image 5.4 rest file 2
359 + image 5.4 rest file (2)
324 324  
325 -4. Open this project in vscode.
361 +**4. Open this project in vscode.**
326 326  
327 327  5. Add file include path about water_leak in extra_lib/CMakeLists.txt as shown in image 5.5, 5.6, and its format is similar to the tem_hum or door.
328 328  
329 329  [[image:image-20241121181957-17.png||height="438" width="516"]]
330 330  
331 - image 5.5 before add
367 + image 5.5 extra_lib/CMakeLists.txt before add
332 332  
333 333  [[image:image-20241121182239-18.png||height="520" width="518"]]
334 334  
335 - image 5.6 after add
371 + image 5.6 extra_lib/CMakeLists.txt after add
336 336  
337 -6. Modify header file include in fonts and images directory. Open the fonts/ui_font_Font12.c file, as shown in image 5.7, then modify the '#include "../ui.h"' to '#include "../ui_water_leak.h"', the image 5.8 is the modified image. Other font file need to be modified in same way.
373 +**6. Modify header file include in fonts and images directory.** Open the fonts/ui_font_Font12.c file, as shown in image 5.7, then modify the '#include "../ui.h"' to '#include "../ui_water_leak.h"', the image 5.8 is the modified image. Other font file need to be modified in same way.
338 338  
339 339  [[image:image-20241121171629-11.png]]
340 340  
341 - image 5.7 before-modified font file
377 + image 5.7 before-modified font file
342 342  
343 343  [[image:image-20241121171901-12.png]]
344 344  
... ... @@ -354,28 +354,183 @@
354 354  
355 355   image 5.10 modified image file
356 356  
357 -7. Modify the ui_water_leak/CMakeLists.txt. Open this file, and modify it from image 5.11 to image 5.12.
393 +**7. Modify the ui_water_leak/CMakeLists.txt.** Open this file, and modify it from image 5.11 to image 5.12.
358 358  
359 359  [[image:image-20241121180030-15.png]]
360 360  
361 - image 5.11 before modification
397 + image 5.11 ui_water_leak/CMakeLists.txt before modification
362 362  
363 363  [[image:image-20241121180517-16.png]]
364 364  
365 - image 5.12 after modification
401 + image 5.12 ui_water_leak/CMakeLists.txt after modification
366 366  
367 -8.
403 +**8. Modify ui_water_leak.h file.** The image 5.13, 5.14 show the code before modification, and the image 5.15, 5.16 show the code after modification.
368 368  
405 +[[image:image-20241122094200-23.png]]
369 369  
407 + image 5.13 ui_water_leak.h (1) before modification
370 370  
409 +[[image:image-20241122094320-24.png||height="852" width="554"]]
371 371  
411 + image 5.14 ui_water_leak.h (2) before modification
372 372  
413 +[[image:image-20241122094600-25.png||height="1078" width="554"]]
373 373  
415 + image 5.15 ui_water_leak.h (1) after modification
374 374  
417 +[[image:image-20241122094719-26.png||height="941" width="583"]]
375 375  
419 + image 5.16 ui_water_leak.h (2) before modification
376 376  
421 +**9. Modify ui_water_leak.c file.** The image 5.17, 5.18, 5.19 show the code before modification, and the image 5.20, 5.21, 5.22 show the code after modification.
377 377  
423 +_ui_flag_modify( ((lv_obj_t *)(e->user_data)), LV_OBJ_FLAG_HIDDEN, _UI_MODIFY_FLAG_TOGGLE);  This code replaces 4 lines of code in ui_water_leak.c, so it is pasted here for convenience.
378 378  
425 +[[image:image-20241122102929-27.png||height="619" width="426"]]
426 +
427 + image 5.17 ui_water_leak.c (1) before modification
428 +
429 +[[image:image-20241122112838-30.png||height="551" width="628"]]
430 +
431 + image 5.18 ui_water_leak.c (2) before modification
432 +
433 +[[image:image-20241122110815-29.png||height="725" width="712"]]
434 +
435 + image 5.19 ui_water_leak.c (3) before modification
436 +
437 +[[image:image-20241122113158-31.png||height="872" width="677"]]
438 +
439 + image 5.20 ui_water_leak.c (1) after modification
440 +
441 +[[image:image-20241122113259-33.png||height="874" width="724"]]
442 +
443 + image 5.21 ui_water_leak.c (2) after modification
444 +
445 +[[image:image-20241122113359-34.png||height="804" width="746"]]
446 +
447 + image 5.22 ui_water_leak.c (3) after modification
448 +
449 +**10. Modify ui_water_leak_events.h file.** The image 5.23 show the code before modification, and the image 5.24 show the code after modification.
450 +
451 +[[image:image-20241122134113-35.png||height="380" width="421"]]
452 +
453 + image 5.23 ui_water_leak_events_.h before modification
454 +
455 +[[image:image-20241122134420-37.png||height="201" width="283"]]
456 +
457 +image 5.24 ui_water_leak_events_.h after modification
458 +
459 +**11. Modify ui_water_leak_events.c file.** The image 5.25 show the code before modification, and the image 5.26 show the code after modification.
460 +
461 +Step1. '#include "ui.h"'~-~->'#include "ui_water_leak.h"'
462 +
463 +Step2. add code  below in delete_object() function definition.
464 +
465 + panel_all * panel = find_upper_by_SensorPanel(&arr,((lv_obj_t *)(e->user_data~)~)~);
466 +
467 + size_t index = panel->panel_obj_index;
468 +
469 + deleteElement(&arr, index);
470 +
471 +[[image:image-20241122135023-38.png||height="358" width="372"]]
472 +
473 + image 5.25 ui_water_leak_events_.c before modification
474 +
475 +[[image:image-20241122135258-39.png||height="403" width="559"]]
476 +
477 + image 5.26 ui_water_leak_events_.c after modification
478 +
479 +**12. Modify ui_water_leak_style.c file.**
480 +
481 +Step1. '#include "../ui.h"'~-~->#include '"../ui_water_leak.h"'
482 +
483 + add '#include "../../sort.h"'
484 +
485 + add '#include "ui.h"'
486 +
487 +[[image:image-20241122141536-41.png||height="361" width="612"]]
488 +
489 + image 5.27 ui_water_leak_style.c (1) before modification
490 +
491 +[[image:image-20241122142129-42.png||height="386" width="613"]]
492 +
493 + image 5.28 ui_water_leak_style.c (1) after modification
494 +
495 +Step2. modify 'void ui_ScreenMain_screen_init(void)'~-~->'panel_with_type create_water_leak(uint8_t index)'
496 +
497 + delete code as shown in image 5.29
498 +
499 +[[image:image-20241122145620-44.png||height="757" width="671"]]
500 +
501 + image 5.29 ui_water_leak_style.c (2)
502 +
503 +Step3. The image 5.30, 5.31 show the change.
504 +
505 +[[image:image-20241122152026-45.png||height="277" width="828"]]
506 +
507 + image 5.30 ui_water_leak_style.c (3) before modification
508 +
509 +[[image:image-20241122152542-46.png||height="293" width="830"]]
510 +
511 + image 5.31 ui_water_leak_style.c (3) after modification
512 +
513 +Step4. Copy partly the code in ui_water_leak.c, paste at extra_lib/sort.h(The process is shown in image 5.32, 5.33).
514 +
515 +[[image:image-20241122153958-47.png]]
516 +
517 + image 5.32 ui_water_leak_style.c (4)
518 +
519 +[[image:image-20241122154755-49.png||height="864" width="513"]]
520 +
521 + image 5.33 ui_water_leak_style.c (4)
522 +
523 +Step5. Delete event function in code which was just pasted in extra_lib/sort.h(The process is shown in image 5.34).
524 +
525 +[[image:image-20241122155650-50.png||height="922" width="513"]]
526 +
527 + image 5.34 ui_water_leak_style.c (5)
528 +
529 +Step6. Add some lines of code in extra_lib/sort.h as shown in image 5.35.
530 +
531 +[[image:image-20241122161934-51.png]]
532 +
533 + image 5.35
534 +
535 +Step7. Add a line of code in extra_lib/sort.h as shown in image 5.36.
536 +
537 +[[image:image-20241122162852-53.png||height="330" width="529"]]
538 +
539 + image 5.37
540 +
541 +Step8. Add some code in ui_water_leak_style.c as shown in image 5.38 from line534 to line 576 in detail.
542 +
543 +panel_with_type union_sensor;
544 +
545 +union_sensor.panel_type = WATER_LEAK_TYPE;
546 +
547 +......
548 +
549 +lv_obj_set_x(union_sensor.panel_union.door.ui_PanelSensorDoor, x_by_index(index));
550 +
551 +lv_obj_set_y(union_sensor.panel_union.door.ui_PanelSensorDoor, y_by_index(index));
552 +
553 +return union_sensor;
554 +
555 +[[image:image-20241122171211-54.png||height="635" width="792"]]
556 +
557 + image 5.38
558 +
559 +**13. Modify sort.c file.**
560 +
561 +Add a line of code ~-~-'#include "ui_water_leak.h"' as shown in image 5.39 line 16.
562 +
563 +[[image:image-20241122173718-56.png||height="378" width="579"]]
564 +
565 + image 5.39 sort.c (1)
566 +
567 +There are still some changes need to be done in sort.c, and omit here for the moment.
568 +
569 +
379 379  = 6. FAQ =
380 380  
381 381  == 6.1 ==
image-20241122154745-48.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.xieby
Size
... ... @@ -1,0 +1,1 @@
1 +135.7 KB
Content
image-20241122154755-49.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.xieby
Size
... ... @@ -1,0 +1,1 @@
1 +135.7 KB
Content
image-20241122155650-50.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.xieby
Size
... ... @@ -1,0 +1,1 @@
1 +104.4 KB
Content
image-20241122161934-51.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.xieby
Size
... ... @@ -1,0 +1,1 @@
1 +230.3 KB
Content
image-20241122162612-52.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.xieby
Size
... ... @@ -1,0 +1,1 @@
1 +58.7 KB
Content
image-20241122162852-53.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.xieby
Size
... ... @@ -1,0 +1,1 @@
1 +125.5 KB
Content
image-20241122171211-54.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.xieby
Size
... ... @@ -1,0 +1,1 @@
1 +173.3 KB
Content
image-20241122173706-55.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.xieby
Size
... ... @@ -1,0 +1,1 @@
1 +37.6 KB
Content
image-20241122173718-56.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.xieby
Size
... ... @@ -1,0 +1,1 @@
1 +37.6 KB
Content
squalreline-trial.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +60.4 KB
Content
squareline.io_downloads.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.pradeeka
Size
... ... @@ -1,0 +1,1 @@
1 +1.5 MB
Content

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0