Last modified by Dilisi S on 2025/02/26 19:24
<
From version < 120.1 >
edited by Dilisi S
on 2024/12/22 15:47
To version < 102.1 >
edited by BoYang Xie
on 2024/11/22 15:20
>
Change comment: Uploaded new attachment "image-20241122152026-45.png", version {1}

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.pradeeka
1 +XWiki.xieby
Content
... ... @@ -21,20 +21,20 @@
21 21  
22 22  = 1.  Introduction =
23 23  
24 -== 1.1  What is the LTS5 LoRa HMI Touch Screen? ==
24 +== 1.1  What is LTS5 LoRa HMI touch screen ==
25 25  
26 26  
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.
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.
28 28  
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.
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.
30 30  
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.
31 +The HMI touch screen of LTS5 supports drap & drop design. Developer can use SquareLine to easily customize the display UI for different application.
32 32  
33 -The LA66 LoRa module can be programmed to support either private LoRa protocols or the LoRaWAN protocol.
33 +LTS5 use LA66 LoRa module, this module can be program to support private LoRa protocol or LoRaWAN protocol.
34 34  
35 +
35 35  == 1.2  Features ==
36 36  
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  Specifications ==
50 +== 1.3  Specification ==
51 51  
52 52  
53 53  **LoRa**:
... ... @@ -107,32 +107,23 @@
107 107  == 2.1  About this demo ==
108 108  
109 109  
110 -This getting started example demonstrates how to design and deploy a simple display UI for the LTS5 device. The example includes:
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.
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.
115 115  
116 -By completing this demo, you will gain foundational knowledge for customizing the LTS5 interface and building more advanced IoT applications.
117 -
118 -
119 119  == 2.2  Install Software Running Environment ==
120 120  
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.
121 121  
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.
117 +=== 2.2.1 Install VSCode and ESP-IDF extension ===
123 123  
124 124  
125 -=== 2.2.1 Install VS Code and ESP-IDF extension ===
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]].
126 126  
122 +Next, you need to install the ESP-IDF extension within VSCode. The detailed operation steps are illustrated in image 1.
127 127  
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 -
133 133  [[image:image-20240928110211-5.png||height="508" width="866"]]
134 134  
135 - Image 1: ESP-IDF extension install
126 + image 1 ESP-IDF extension install
136 136  
137 137  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]]
138 138  
... ... @@ -140,17 +140,11 @@
140 140  === 2.2.2 Install SquareLine Studio ===
141 141  
142 142  
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.
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]].
144 144  
145 -[[image:squareline.io_downloads.png]]
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.
146 146  
147 147  
148 -After installation, you can use SquareLine Studio as a trial version for 30 days without activation. Click **CONTINUE WITH TRIAL** to use the trial version, or click **LOG IN** to activate the software with your license key.
149 -
150 -[[image:squalreline-trial.png||height="602" width="400"]]
151 -
152 -The free version restricts usage to 1 component, 150 widgets, and 10 screens.
153 -
154 154  == 2.3 Simple usage of SquareLine Studio and export UI code ==
155 155  
156 156  
... ... @@ -306,53 +306,54 @@
306 306  
307 307  = 4. Example Project 2: LoRaWAN RS485 Alarm =
308 308  
294 +(% class="wikigeneratedid" %)
309 309  = 5.  The way to add a new panel to project =
310 310  
311 -**~1. Design a panel in SquareLine Studio, using image 5.1 below as a reference.**
297 +~1. Design a panel in SquareLine Studio, using image 5.1 below as a reference.
312 312  
313 313  [[image:image-20241121113445-1.png||height="584" width="934"]]
314 314  
315 315   image 5.1 a panel about water_leak
316 316  
317 -**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.
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.
318 318  
319 319  [[image:image-20241121141120-4.png||height="383" width="795"]]
320 320  
321 321   image 5.2 ui files exported
322 322  
323 -**3. Delete or rename some file.** Here are the steps:
309 +3. Delete or rename some file. Here are the steps:
324 324  
325 - Step1 Delete the 'components' directory.
326 - Step2 Delete 'filelist.txt'.
327 - Step3 Delete 'ui_helpers.c' and 'ui_helpers.h'.
328 - Step4 Rename 'ui_ScreenMain.c' in the 'screens' directory to 'ui_water_leak_style.c'.
329 - Step5 Rename the 'screens' directory to 'styles'.
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'.
330 330  
331 331  [[image:image-20241121151934-10.png||height="303" width="792"]]
332 332  
333 - image 5.3 rest file (1)
319 + image 5.3 rest file 1
334 334  
335 335  [[image:image-20241121142925-7.png||height="141" width="793"]]
336 336  
337 - image 5.4 rest file (2)
323 + image 5.4 rest file 2
338 338  
339 -**4. Open this project in vscode.**
325 +4. Open this project in vscode.
340 340  
341 341  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.
342 342  
343 343  [[image:image-20241121181957-17.png||height="438" width="516"]]
344 344  
345 - image 5.5 extra_lib/CMakeLists.txt before add
331 + image 5.5 before add
346 346  
347 347  [[image:image-20241121182239-18.png||height="520" width="518"]]
348 348  
349 - image 5.6 extra_lib/CMakeLists.txt after add
335 + image 5.6 after add
350 350  
351 -**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.
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.
352 352  
353 353  [[image:image-20241121171629-11.png]]
354 354  
355 - image 5.7 before-modified font file
341 + image 5.7 before-modified font file
356 356  
357 357  [[image:image-20241121171901-12.png]]
358 358  
... ... @@ -368,183 +368,28 @@
368 368  
369 369   image 5.10 modified image file
370 370  
371 -**7. Modify the ui_water_leak/CMakeLists.txt.** Open this file, and modify it from image 5.11 to image 5.12.
357 +7. Modify the ui_water_leak/CMakeLists.txt. Open this file, and modify it from image 5.11 to image 5.12.
372 372  
373 373  [[image:image-20241121180030-15.png]]
374 374  
375 - image 5.11 ui_water_leak/CMakeLists.txt before modification
361 + image 5.11 before modification
376 376  
377 377  [[image:image-20241121180517-16.png]]
378 378  
379 - image 5.12 ui_water_leak/CMakeLists.txt after modification
365 + image 5.12 after modification
380 380  
381 -**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.
367 +8.
382 382  
383 -[[image:image-20241122094200-23.png]]
384 384  
385 - image 5.13 ui_water_leak.h (1) before modification
386 386  
387 -[[image:image-20241122094320-24.png||height="852" width="554"]]
388 388  
389 - image 5.14 ui_water_leak.h (2) before modification
390 390  
391 -[[image:image-20241122094600-25.png||height="1078" width="554"]]
392 392  
393 - image 5.15 ui_water_leak.h (1) after modification
394 394  
395 -[[image:image-20241122094719-26.png||height="941" width="583"]]
396 396  
397 - image 5.16 ui_water_leak.h (2) before modification
398 398  
399 -**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.
400 400  
401 -_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.
402 402  
403 -[[image:image-20241122102929-27.png||height="619" width="426"]]
404 -
405 - image 5.17 ui_water_leak.c (1) before modification
406 -
407 -[[image:image-20241122112838-30.png||height="551" width="628"]]
408 -
409 - image 5.18 ui_water_leak.c (2) before modification
410 -
411 -[[image:image-20241122110815-29.png||height="725" width="712"]]
412 -
413 - image 5.19 ui_water_leak.c (3) before modification
414 -
415 -[[image:image-20241122113158-31.png||height="872" width="677"]]
416 -
417 - image 5.20 ui_water_leak.c (1) after modification
418 -
419 -[[image:image-20241122113259-33.png||height="874" width="724"]]
420 -
421 - image 5.21 ui_water_leak.c (2) after modification
422 -
423 -[[image:image-20241122113359-34.png||height="804" width="746"]]
424 -
425 - image 5.22 ui_water_leak.c (3) after modification
426 -
427 -**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.
428 -
429 -[[image:image-20241122134113-35.png||height="380" width="421"]]
430 -
431 - image 5.23 ui_water_leak_events_.h before modification
432 -
433 -[[image:image-20241122134420-37.png||height="201" width="283"]]
434 -
435 -image 5.24 ui_water_leak_events_.h after modification
436 -
437 -**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.
438 -
439 -Step1. '#include "ui.h"'~-~->'#include "ui_water_leak.h"'
440 -
441 -Step2. add code  below in delete_object() function definition.
442 -
443 - panel_all * panel = find_upper_by_SensorPanel(&arr,((lv_obj_t *)(e->user_data~)~)~);
444 -
445 - size_t index = panel->panel_obj_index;
446 -
447 - deleteElement(&arr, index);
448 -
449 -[[image:image-20241122135023-38.png||height="358" width="372"]]
450 -
451 - image 5.25 ui_water_leak_events_.c before modification
452 -
453 -[[image:image-20241122135258-39.png||height="403" width="559"]]
454 -
455 - image 5.26 ui_water_leak_events_.c after modification
456 -
457 -**12. Modify ui_water_leak_style.c file.**
458 -
459 -Step1. '#include "../ui.h"'~-~->#include '"../ui_water_leak.h"'
460 -
461 - add '#include "../../sort.h"'
462 -
463 - add '#include "ui.h"'
464 -
465 -[[image:image-20241122141536-41.png||height="361" width="612"]]
466 -
467 - image 5.27 ui_water_leak_style.c (1) before modification
468 -
469 -[[image:image-20241122142129-42.png||height="386" width="613"]]
470 -
471 - image 5.28 ui_water_leak_style.c (1) after modification
472 -
473 -Step2. modify 'void ui_ScreenMain_screen_init(void)'~-~->'panel_with_type create_water_leak(uint8_t index)'
474 -
475 - delete code as shown in image 5.29
476 -
477 -[[image:image-20241122145620-44.png||height="757" width="671"]]
478 -
479 - image 5.29 ui_water_leak_style.c (2)
480 -
481 -Step3. The image 5.30, 5.31 show the change.
482 -
483 -[[image:image-20241122152026-45.png||height="277" width="828"]]
484 -
485 - image 5.30 ui_water_leak_style.c (3) before modification
486 -
487 -[[image:image-20241122152542-46.png||height="293" width="830"]]
488 -
489 - image 5.31 ui_water_leak_style.c (3) after modification
490 -
491 -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).
492 -
493 -[[image:image-20241122153958-47.png]]
494 -
495 - image 5.32 ui_water_leak_style.c (4)
496 -
497 -[[image:image-20241122154755-49.png||height="864" width="513"]]
498 -
499 - image 5.33 ui_water_leak_style.c (4)
500 -
501 -Step5. Delete event function in code which was just pasted in extra_lib/sort.h(The process is shown in image 5.34).
502 -
503 -[[image:image-20241122155650-50.png||height="922" width="513"]]
504 -
505 - image 5.34 ui_water_leak_style.c (5)
506 -
507 -Step6. Add some lines of code in extra_lib/sort.h as shown in image 5.35.
508 -
509 -[[image:image-20241122161934-51.png]]
510 -
511 - image 5.35
512 -
513 -Step7. Add a line of code in extra_lib/sort.h as shown in image 5.36.
514 -
515 -[[image:image-20241122162852-53.png||height="330" width="529"]]
516 -
517 - image 5.37
518 -
519 -Step8. Add some code in ui_water_leak_style.c as shown in image 5.38 from line534 to line 576 in detail.
520 -
521 -panel_with_type union_sensor;
522 -
523 -union_sensor.panel_type = WATER_LEAK_TYPE;
524 -
525 -......
526 -
527 -lv_obj_set_x(union_sensor.panel_union.door.ui_PanelSensorDoor, x_by_index(index));
528 -
529 -lv_obj_set_y(union_sensor.panel_union.door.ui_PanelSensorDoor, y_by_index(index));
530 -
531 -return union_sensor;
532 -
533 -[[image:image-20241122171211-54.png||height="635" width="792"]]
534 -
535 - image 5.38
536 -
537 -**13. Modify sort.c file.**
538 -
539 -Add a line of code ~-~-'#include "ui_water_leak.h"' as shown in image 5.39 line 16.
540 -
541 -[[image:image-20241122173718-56.png||height="378" width="579"]]
542 -
543 - image 5.39 sort.c (1)
544 -
545 -There are still some changes need to be done in sort.c, and omit here for the moment.
546 -
547 -
548 548  = 6. FAQ =
549 549  
550 550  == 6.1 ==
image-20241122152542-46.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -95.3 KB
Content
image-20241122153958-47.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -241.1 KB
Content
image-20241122154745-48.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -135.7 KB
Content
image-20241122154755-49.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -135.7 KB
Content
image-20241122155650-50.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -104.4 KB
Content
image-20241122161934-51.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -230.3 KB
Content
image-20241122162612-52.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -58.7 KB
Content
image-20241122162852-53.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -125.5 KB
Content
image-20241122171211-54.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -173.3 KB
Content
image-20241122173706-55.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -37.6 KB
Content
image-20241122173718-56.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -37.6 KB
Content
squalreline-trial.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.pradeeka
Size
... ... @@ -1,1 +1,0 @@
1 -60.4 KB
Content
squareline.io_downloads.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.pradeeka
Size
... ... @@ -1,1 +1,0 @@
1 -1.5 MB
Content

Applications

Navigation

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