Changes for page LTS5 LoRa HMI Touch Screen

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

From version < 113.1 >

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

To version < 115.1 >

edited by Xiaoling
on 2024/12/17 17:47

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

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

Content

@@ -24,11 +24,11 @@
  == 1.1  What is 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.
++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**.
  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 HMI touch screen of LTS5 supports drap & drop design. Developer can use SquareLine to easily customize the display UI for different application.
++The HMI touch screen of LTS5 **supports drap & drop design**. Developer can use SquareLine to easily customize the display UI for different application.
  LTS5 use LA66 LoRa module, this module can be program to support private LoRa protocol or LoRaWAN protocol.
@@ -35,6 +35,7 @@
  == 1.2  Features ==
++
  * ESP32-WROOM MCU: 8MB RAM & 16MB ROM
  * Dragino LA66 LoRa Module
  * Support Private LoRa protocol or LoRaWAN protocol
@@ -86,6 +86,7 @@
  * External 5V DC power adapter
++
  == 1.5  Storage & Operation Temperature ==
@@ -92,6 +92,7 @@
  * Operation Temperature: -20 ~~ 70°C  (No Dew)
  * Storage Temperature: -30 ~~ 70°C  (No Dew)
++
  == 1.6  Applications ==
@@ -102,6 +102,7 @@
  * Smart Cities
  * Smart Factory
++
  = 2.  Getting Started with Hello World =
  == 2.1  About this demo ==
@@ -112,8 +112,10 @@
  == 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.
++
  === 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 ==

Changes for page LTS5 LoRa HMI Touch Screen

Summary

Details

Applications

Navigation