Last modified by Dilisi S on 2025/02/26 19:24
<
From version < 121.1 >
edited by Dilisi S
on 2024/12/22 21:12
To version < 109.1 >
edited by BoYang Xie
on 2024/11/22 16:26
>
Change comment: Uploaded new attachment "image-20241122162612-52.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,60 +140,32 @@
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 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:
139 +== 2.3 Simple usage of SquareLine Studio and export UI code ==
149 149  
150 -* Max. 10 screens
151 -* Max. 150 widgets
152 -* Max. 5 global colors
153 -* Max. 2 themes
154 -* Max. 1 component
155 155  
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.
156 156  
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 -
169 169  [[image:image-20240928103357-2.png||height="680" width="708"]]
170 170  
171 - Image 2: Creating a new SquareLine project
146 + image 2 create a SquareLine project
172 172  
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.
173 173  
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 -
178 178  [[image:1727229582471-566.png]]
179 179  
180 - Image 3 accessing project settings
152 + image 3 project settings
181 181  
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 -
189 189  [[image:image-20240928105309-4.png||height="526" width="556"]]
190 190  
191 - Image 4 Configure/modify project settings
156 + image 4 modify project settings
192 192  
158 +Now we can start to use this software. Here are some usage information for this software.
193 193  
194 -Now you can start building the UI. Follow the steps below:
195 -
196 -
197 197  **~1. add widget**
198 198  
199 199  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.
... ... @@ -328,53 +328,54 @@
328 328  
329 329  = 4. Example Project 2: LoRaWAN RS485 Alarm =
330 330  
294 +(% class="wikigeneratedid" %)
331 331  = 5.  The way to add a new panel to project =
332 332  
333 -**~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.
334 334  
335 335  [[image:image-20241121113445-1.png||height="584" width="934"]]
336 336  
337 337   image 5.1 a panel about water_leak
338 338  
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.
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.
340 340  
341 341  [[image:image-20241121141120-4.png||height="383" width="795"]]
342 342  
343 343   image 5.2 ui files exported
344 344  
345 -**3. Delete or rename some file.** Here are the steps:
309 +3. Delete or rename some file. Here are the steps:
346 346  
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'.
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'.
352 352  
353 353  [[image:image-20241121151934-10.png||height="303" width="792"]]
354 354  
355 - image 5.3 rest file (1)
319 + image 5.3 rest file 1
356 356  
357 357  [[image:image-20241121142925-7.png||height="141" width="793"]]
358 358  
359 - image 5.4 rest file (2)
323 + image 5.4 rest file 2
360 360  
361 -**4. Open this project in vscode.**
325 +4. Open this project in vscode.
362 362  
363 363  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.
364 364  
365 365  [[image:image-20241121181957-17.png||height="438" width="516"]]
366 366  
367 - image 5.5 extra_lib/CMakeLists.txt before add
331 + image 5.5 before add
368 368  
369 369  [[image:image-20241121182239-18.png||height="520" width="518"]]
370 370  
371 - image 5.6 extra_lib/CMakeLists.txt after add
335 + image 5.6 after add
372 372  
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.
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.
374 374  
375 375  [[image:image-20241121171629-11.png]]
376 376  
377 - image 5.7 before-modified font file
341 + image 5.7 before-modified font file
378 378  
379 379  [[image:image-20241121171901-12.png]]
380 380  
... ... @@ -390,183 +390,28 @@
390 390  
391 391   image 5.10 modified image file
392 392  
393 -**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.
394 394  
395 395  [[image:image-20241121180030-15.png]]
396 396  
397 - image 5.11 ui_water_leak/CMakeLists.txt before modification
361 + image 5.11 before modification
398 398  
399 399  [[image:image-20241121180517-16.png]]
400 400  
401 - image 5.12 ui_water_leak/CMakeLists.txt after modification
365 + image 5.12 after modification
402 402  
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.
367 +8.
404 404  
405 -[[image:image-20241122094200-23.png]]
406 406  
407 - image 5.13 ui_water_leak.h (1) before modification
408 408  
409 -[[image:image-20241122094320-24.png||height="852" width="554"]]
410 410  
411 - image 5.14 ui_water_leak.h (2) before modification
412 412  
413 -[[image:image-20241122094600-25.png||height="1078" width="554"]]
414 414  
415 - image 5.15 ui_water_leak.h (1) after modification
416 416  
417 -[[image:image-20241122094719-26.png||height="941" width="583"]]
418 418  
419 - image 5.16 ui_water_leak.h (2) before modification
420 420  
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.
422 422  
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.
424 424  
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 -
570 570  = 6. FAQ =
571 571  
572 572  == 6.1 ==
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