Changes for page LTS5 LoRa HMI Touch Screen

Last modified by Dilisi S on 2025/02/26 19:24

From version < 112.1 >

edited by BoYang Xie
on 2024/11/22 17:37

To version < 117.1 >

edited by Dilisi S
on 2024/12/20 21:52

Change comment: Dec 20 edits - part 1

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)
Attachments (0 modified, 1 added, 0 removed)
- image-20241122173718-56.png

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.xieby
++XWiki.pradeeka

Content

@@ -21,20 +21,20 @@
  = 1.  Introduction =
--== 1.1  What is LTS5 LoRa HMI touch screen ==
++== 1.1  What is the LTS5 LoRa HMI Touch Screen? ==
--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.
++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.
--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.
++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.
--The HMI touch screen of LTS5 supports drap & drop design. Developer can use SquareLine to easily customize the display UI for different application.
++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.
--LTS5 use LA66 LoRa module, this module can be program to support private LoRa protocol or LoRaWAN protocol.
++The LA66 LoRa module can be programmed to support either private LoRa protocols or the LoRaWAN protocol.
--
  == 1.2  Features ==
++
  * ESP32-WROOM MCU: 8MB RAM & 16MB ROM
  * Dragino LA66 LoRa Module
  * Support Private LoRa protocol or LoRaWAN protocol
@@ -47,7 +47,7 @@
  * 5V DC power
  * IP Rating: IP52
--== 1.3  Specification ==
++== 1.3  Specifications ==
  **LoRa**:
@@ -107,13 +107,22 @@
  == 2.1  About this demo ==
--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.
++This getting started example demonstrates how to design and deploy a simple display UI for the LTS5 device. The example includes:
++* Creating a basic UI with a single button.
++* Implementing functionality to navigate the Web UI to a new page when the button is clicked.
++* Uploading the UI to the LTS5 device.
++
++By completing this demo, you will gain foundational knowledge for customizing the LTS5 interface and building more advanced IoT applications.
++
++
  == 2.2  Install Software Running Environment ==
--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.
++The **ESP MCU** supports development using **ESP-IDF**, **Arduino**, or **MicroPython**. For this project, we use **ESP-IDF** for compilation and **Visual Studio Code (VS Code)** as the development environment.
++
++
  === 2.2.1 Install VSCode and ESP-IDF extension ===
@@ -291,54 +291,53 @@
  = 4. Example Project 2: LoRaWAN RS485 Alarm =
--(% class="wikigeneratedid" %)
  = 5.  The way to add a new panel to project =
--~1. Design a panel in SquareLine Studio, using image 5.1 below as a reference.
++**~1. Design a panel in SquareLine Studio, using image 5.1 below as a reference.**
  [[image:image-20241121113445-1.png||height="584" width="934"]]
                                                                                    image 5.1 a panel about water_leak
--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.
++**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.
  [[image:image-20241121141120-4.png||height="383" width="795"]]
                                                                                image 5.2 ui files exported
--3. Delete or rename some file. Here are the steps:
++**3. Delete or rename some file.** Here are the steps:
--    3.1 Delete the 'components' directory.
--    3.2 Delete 'filelist.txt'.
--    3.3 Delete 'ui_helpers.c' and 'ui_helpers.h'.
--    3.4 Rename 'ui_ScreenMain.c' in the 'screens' directory to 'ui_water_leak_style.c'.
--    3.5 Rename the 'screens' directory to 'styles'.
++    Step1 Delete the 'components' directory.
++    Step2 Delete 'filelist.txt'.
++    Step3 Delete 'ui_helpers.c' and 'ui_helpers.h'.
++    Step4 Rename 'ui_ScreenMain.c' in the 'screens' directory to 'ui_water_leak_style.c'.
++    Step5 Rename the 'screens' directory to 'styles'.
  [[image:image-20241121151934-10.png||height="303" width="792"]]
--                                                                                 image 5.3 rest file 1
++                                                                                 image 5.3 rest file (1)
  [[image:image-20241121142925-7.png||height="141" width="793"]]
--                                                                                 image 5.4 rest file 2
++                                                                                 image 5.4 rest file (2)
--4. Open this project in vscode.
++**4. Open this project in vscode.**
 . 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.
  [[image:image-20241121181957-17.png||height="438" width="516"]]
--                                            image 5.5 before add
++                          image 5.5 extra_lib/CMakeLists.txt before add
  [[image:image-20241121182239-18.png||height="520" width="518"]]
--                                            image 5.6 after add
++                              image 5.6 extra_lib/CMakeLists.txt after add
--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.
++**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.
  [[image:image-20241121171629-11.png]]
--                                image 5.7 before-modified font file
++                               image 5.7 before-modified font file
  [[image:image-20241121171901-12.png]]
@@ -354,28 +354,183 @@
                                                    image 5.10 modified image file
--7. Modify the ui_water_leak/CMakeLists.txt. Open this file, and modify it from image 5.11 to image 5.12.
++**7. Modify the ui_water_leak/CMakeLists.txt.** Open this file, and modify it from image 5.11 to image 5.12.
  [[image:image-20241121180030-15.png]]
--                        image 5.11 before modification
++  image 5.11 ui_water_leak/CMakeLists.txt before modification
  [[image:image-20241121180517-16.png]]
--                       image 5.12 after modification
++  image 5.12 ui_water_leak/CMakeLists.txt after modification
--8.
++**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.
++[[image:image-20241122094200-23.png]]
++                           image 5.13 ui_water_leak.h (1) before modification
++[[image:image-20241122094320-24.png||height="852" width="554"]]
++                       image 5.14 ui_water_leak.h (2) before modification
++[[image:image-20241122094600-25.png||height="1078" width="554"]]
++                       image 5.15 ui_water_leak.h (1) after modification
++[[image:image-20241122094719-26.png||height="941" width="583"]]
++                         image 5.16 ui_water_leak.h (2) before modification
++**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.
++_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.
++[[image:image-20241122102929-27.png||height="619" width="426"]]
++
++           image 5.17 ui_water_leak.c (1) before modification
++
++[[image:image-20241122112838-30.png||height="551" width="628"]]
++
++                                     image 5.18 ui_water_leak.c (2) before modification
++
++[[image:image-20241122110815-29.png||height="725" width="712"]]
++
++                                                image 5.19 ui_water_leak.c (3) before modification
++
++[[image:image-20241122113158-31.png||height="872" width="677"]]
++
++                                             image 5.20 ui_water_leak.c (1) after modification
++
++[[image:image-20241122113259-33.png||height="874" width="724"]]
++
++                                                image 5.21 ui_water_leak.c (2) after modification
++
++[[image:image-20241122113359-34.png||height="804" width="746"]]
++
++                                                         image 5.22 ui_water_leak.c (3) after modification
++
++**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.
++
++[[image:image-20241122134113-35.png||height="380" width="421"]]
++
++              image 5.23 ui_water_leak_events_.h before modification
++
++[[image:image-20241122134420-37.png||height="201" width="283"]]
++
++image 5.24 ui_water_leak_events_.h after modification
++
++**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.
++
++Step1. '#include "ui.h"'~-~->'#include "ui_water_leak.h"'
++
++Step2. add code  below in delete_object() function definition.
++
++        panel_all * panel = find_upper_by_SensorPanel(&arr,((lv_obj_t *)(e->user_data~)~)~);
++
++        size_t index = panel->panel_obj_index;
++
++        deleteElement(&arr, index);
++
++[[image:image-20241122135023-38.png||height="358" width="372"]]
++
++   image 5.25 ui_water_leak_events_.c before modification
++
++[[image:image-20241122135258-39.png||height="403" width="559"]]
++
++                        image 5.26 ui_water_leak_events_.c after modification
++
++**12. Modify ui_water_leak_style.c file.**
++
++Step1. '#include "../ui.h"'~-~->#include '"../ui_water_leak.h"'
++
++            add '#include "../../sort.h"'
++
++            add '#include "ui.h"'
++
++[[image:image-20241122141536-41.png||height="361" width="612"]]
++
++                        image 5.27 ui_water_leak_style.c (1) before modification
++
++[[image:image-20241122142129-42.png||height="386" width="613"]]
++
++                           image 5.28 ui_water_leak_style.c (1) after modification
++
++Step2. modify 'void ui_ScreenMain_screen_init(void)'~-~->'panel_with_type create_water_leak(uint8_t index)'
++
++           delete code as shown in image 5.29
++
++[[image:image-20241122145620-44.png||height="757" width="671"]]
++
++                                               image 5.29 ui_water_leak_style.c (2)
++
++Step3. The image 5.30, 5.31 show the change.
++
++[[image:image-20241122152026-45.png||height="277" width="828"]]
++
++                                                      image 5.30 ui_water_leak_style.c (3) before modification
++
++[[image:image-20241122152542-46.png||height="293" width="830"]]
++
++                                                         image 5.31 ui_water_leak_style.c (3) after modification
++
++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).
++
++[[image:image-20241122153958-47.png]]
++
++                           image 5.32 ui_water_leak_style.c (4)
++
++[[image:image-20241122154755-49.png||height="864" width="513"]]
++
++                           image 5.33 ui_water_leak_style.c (4)
++
++Step5. Delete event function in code which was just pasted in extra_lib/sort.h(The process is shown in image 5.34).
++
++[[image:image-20241122155650-50.png||height="922" width="513"]]
++
++              image 5.34 ui_water_leak_style.c (5)
++
++Step6. Add some lines of code in extra_lib/sort.h as shown in image 5.35.
++
++[[image:image-20241122161934-51.png]]
++
++                           image 5.35
++
++Step7. Add a line of code in extra_lib/sort.h as shown in image 5.36.
++
++[[image:image-20241122162852-53.png||height="330" width="529"]]
++
++                                         image 5.37
++
++Step8. Add some code in ui_water_leak_style.c as shown in image 5.38 from line534 to line 576 in detail.
++
++panel_with_type union_sensor;
++
++union_sensor.panel_type = WATER_LEAK_TYPE;
++
++......
++
++lv_obj_set_x(union_sensor.panel_union.door.ui_PanelSensorDoor, x_by_index(index));
++
++lv_obj_set_y(union_sensor.panel_union.door.ui_PanelSensorDoor, y_by_index(index));
++
++return union_sensor;
++
++[[image:image-20241122171211-54.png||height="635" width="792"]]
++
++                                                                       image 5.38
++
++**13. Modify sort.c file.**
++
++Add a line of code ~-~-'#include "ui_water_leak.h"' as shown in image 5.39 line 16.
++
++[[image:image-20241122173718-56.png||height="378" width="579"]]
++
++                                           image 5.39 sort.c (1)
++
++There are still some changes need to be done in sort.c, and omit here for the moment.
++
++
  = 6.  FAQ =
  == 6.1 ==

image-20241122173718-56.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.xieby

Size

...	...	@@ -1,0 +1,1 @@
	1	+37.6 KB

Content

Changes for page LTS5 LoRa HMI Touch Screen

Summary

Details

Applications

Navigation