Last modified by BoYang Xie on 2025/05/05 12:26
<
From version < 154.1 >
edited by BoYang Xie
on 2025/02/07 17:18
To version < 131.1 >
edited by Dilisi S
on 2024/12/24 21:45
>
Change comment: Dec 24 edits - part 2

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.xieby
1 +XWiki.pradeeka
Content
... ... @@ -1,11 +3,12 @@
1 -
2 -
3 3  (% style="text-align:center" %)
4 -[[image:image-20241226135550-1.png]]
2 +[[image:image-20240915231842-1.png]]
5 5  
6 6  
7 7  
8 8  
7 +
8 +
9 +
9 9  (% _mstvisible="1" %)
10 10  (% _msthash="315238" _msttexthash="18964465" _mstvisible="3" %)**Table of Contents:**
11 11  
... ... @@ -141,7 +141,7 @@
141 141  
142 142  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.5.0. See the image below.
143 143  
144 -[[image:squareline.io_downloads.png||height="888" width="1294"]]
145 +[[image:squareline.io_downloads.png]]
145 145  
146 146  
147 147  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:
... ... @@ -160,9 +160,11 @@
160 160  * In the **PROJECT SETTINGS**, select **LVGL version **as **8.3.11** and **Resolution** as **800** x **480**.
161 161  * Select the **CREATE **button to create the new project with the selected settings.
162 162  
163 -[[image:squareline-studio-launcher-screen.png||height="752" width="1415"]]
164 164  
165 +[[image:squareline-studio-launcher-screen.png]]
165 165  
167 +
168 +
166 166  Next, you need to configure some additional settings for this project. To do so, select** File  -> Project Settings** as shown in the image below.
167 167  
168 168  [[image:1727229582471-566.png]]
... ... @@ -266,7 +266,7 @@
266 266  Widgets commonly have two types of relationships: **parallel** and **parent-child**.
267 267  
268 268  * In a **parallel relationship**, widgets' positions are determined relative to a shared reference object.
269 -* In a **parent-child relationship**, any part of the child object outside the parent's boundaries is hidden by default. To make the child object fully visible, you must adjust its position to fit within the parent's range.
272 +* In a **parent-child relationship**, any part of the child object outside the parent's boundaries is hidden by default. To make the child object fully visible, you must adjust its position to fit within the parent's range, as shown in Image 13.
270 270  
271 271  [[image:1727486567182-334.png||height="318" width="278"]]
272 272  
... ... @@ -284,11 +284,13 @@
284 284  ==== **Preview the screen** ====
285 285  
286 286  
287 -You can test the result by clicking on the **PLAY** button as shown in the image below. The screen will change into play mode.
290 +You can test the result by clicking on the **PLAY** button. The screen will change into play mode. See Image 14.
288 288  
289 289  [[image:1727487368023-281.png]]
290 290  
294 + Image 14: Simulating the project
291 291  
296 +
292 292  For more information, please visit the official link: [[SquareLine Studio 1.4.2 Documentation ~| SquareLine Studio>>url:https://docs.squareline.io/docs/squareline/]].
293 293  
294 294  
... ... @@ -295,62 +295,57 @@
295 295  == 2.4 Integrate UI Code to ESP-IDF Project ==
296 296  
297 297  
298 -To integrate, first export the UI code, then make some modifications, and finally relocate the UI code to a specific position within the project.
303 +To achieve the integrating, we first need to export the UI code, then make some modifications, and finally relocate the UI code to a specific position within the project.
299 299  
300 -On the  menubar, click **Export -> Export UI** Files as shown in the image below.
301 -
302 302  [[image:1727229798126-306.png]]
303 303  
307 + image 15 export UI file
304 304  
305 -The exported UI files can be found in your SquareLine project folder as shown in the image below.
306 -
307 -
308 308  [[image:1727229821582-258.png||height="333" width="662"]]
309 309  
311 + image 16 exported UI file
310 310  
311 -Create a new folder named "**ui**" at path "**basic_prj/app_components/ui/**", and copy all the exported UI code into it as shown in the image below.
313 +Create a empty directory entitled "ui" in path "basic_prj/app_components/ui/", and then copy all UI code exported to this directory.
312 312  
313 313  [[image:image-20240928144830-11.png]]
314 314  
317 + image 17 open CMakeLists.txt
315 315  
316 -Open the **CMakeLists.txt** file and edit it as ahown below.
317 -
318 318  [[image:1727229892636-154.png||height="521" width="407"]]
319 319  
321 + image 18 modify CMakeLists.txt
320 320  
321 -Open the main.c file and  add two lines of code as shown in the below images.
323 +The last step of integrating is adding two lines of code in main.c file.
322 322  
323 -Add **#include "ui.h"**
324 -
325 325  [[image:1727229926561-300.png]]
326 326  
327 + image 19 add "ui.h"
327 327  
328 -Add **ui_init();**
329 -
330 330  [[image:1727229955611-607.png]]
331 331  
331 + image 20 add "ui_init()"
332 332  
333 -== 2.5 Brief introduction to the Hello World project ==
334 334  
334 +== 2.5 Brief introduction of hello world project ==
335 335  
336 -The project consists of two screens. The first screen displays the company's logo, the project name, and a button to navigate to the next screen. The second screen provides information about the HMI screen product through an image and includes a button to return to the previous screen.
337 337  
337 +The project consists of two screens. The first screen displays the company's logo, the project name, and a button to navigate to the next screen. The second screen presents some information about this HMI screen product through an image and includes a button to return to the previous screen.
338 338  
339 +
339 339  == 2.6 Test Result ==
340 340  
341 341  
342 -By pressing the button located at the bottom right, the screen switches to the next one as expected. This confirms that the UI file has been successfully integrated into the project and is functioning correctly.
343 +By pressing the button lying bottom right, the screen can switch to another as expected. This indicates that the UI file has been successfully integrated into the project and is now effective.
343 343  
344 -Screen 1:
345 -
346 346  [[image:1727488067077-684.png||height="402" width="574"]]
347 347  
347 + image 21 screen1
348 348  
349 -Screen 2:
350 -
351 351  [[image:1727488157579-949.png||height="397" width="572"]]
352 352  
351 + image 22 screen2
353 353  
353 +
354 354  = 3. Example Project 1: LoRa Central Display =
355 355  
356 356  [[image:image-20240916101737-1.png||height="468" width="683"]]
... ... @@ -358,31 +358,30 @@
358 358  
359 359  = 4. Example Project 2: LoRaWAN RS485 Alarm =
360 360  
361 -= 5. The method for adding a new type of panel to the project =
361 += 5. The way to add a new panel to project =
362 362  
363 -If you don't have this need, then this part of the content can be ignored.
364 364  
365 -1. Design a panel in SquareLine Studio, as shown in Image 5.1 below for reference.
364 +**~1. Design a panel in SquareLine Studio, using image 5.1 below as a reference.**
366 366  
367 367  [[image:image-20241121113445-1.png||height="584" width="934"]]
368 368  
369 - Image 5.1: a panel about water_leak
368 + image 5.1 a panel about water_leak
370 370  
371 371  
372 -2. **Export the UI file: **You need to adjust the export path first, then click '**Export -> Export UI Files**' on the menu bar. This step was introduced earlier. After that, you can get the UI files as shown in Image 5.2.
371 +**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.
373 373  
374 374  [[image:image-20241121141120-4.png||height="383" width="795"]]
375 375  
376 - Image 5.2: Exported UI files
375 + image 5.2 ui files exported
377 377  
378 378  
379 -3. **Delete and rename some file.** Here are the steps:
378 +**3. Delete or rename some file.** Here are the steps:
380 380  
381 - Step 1: Delete the 'components' directory.
382 - Step 2: Delete 'filelist.txt'.
383 - Step 3: Delete 'ui_helpers.c' and 'ui_helpers.h'.
384 - Step 4: Rename 'ui_ScreenMain.c' in the 'screens' directory to 'ui_water_leak_style.c'.
385 - Step 5: Rename the 'screens' directory to 'styles'.
380 + Step1 Delete the 'components' directory.
381 + Step2 Delete 'filelist.txt'.
382 + Step3 Delete 'ui_helpers.c' and 'ui_helpers.h'.
383 + Step4 Rename 'ui_ScreenMain.c' in the 'screens' directory to 'ui_water_leak_style.c'.
384 + Step5 Rename the 'screens' directory to 'styles'.
386 386  
387 387  [[image:image-20241121151934-10.png||height="303" width="792"]]
388 388  
... ... @@ -392,9 +392,9 @@
392 392  
393 393   image 5.4 rest file (2)
394 394  
395 -4. Open the project in **VS Code**.
394 +**4. Open this project in vscode.**
396 396  
397 -5. Add the file include path for **water_leak** in **extra_lib/CMakeLists.txt**, as shown in Images 5.5 and 5.6. Its format is similar to that of **tem_hum** or **door**."
396 +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.
398 398  
399 399  [[image:image-20241121181957-17.png||height="438" width="516"]]
400 400  
... ... @@ -404,10 +404,8 @@
404 404  
405 405   image 5.6 extra_lib/CMakeLists.txt after add
406 406  
407 -6.  **Modify the header files included in the fonts and images directories**.
406 +**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.
408 408  
409 -Open the **fonts/ui_font_Font12.c** file, as shown in Image 5.7, and change **#include "../ui.h"** to **#include "../ui_water_leak.h"**. The modified file is shown in Image 5.8. Other font files need to be modified in the same way.
410 -
411 411  [[image:image-20241121171629-11.png]]
412 412  
413 413   image 5.7 before-modified font file
... ... @@ -416,7 +416,7 @@
416 416  
417 417   image 5.8 modified font file
418 418  
419 -Open the **images/ui_img_battery_empty_png.c** file, as shown in Image 5.9, and change **#include "../ui.h"** to **#include "../ui_water_leak.h"**. The modified file is shown in Image 5.10. Other image files need to be modified in the same way.
416 +Open the images/ui_img_battery_empty_png.c file, as shown in image 5.9, then modify the '#include "../ui.h"' to '#include "../ui_water_leak.h"', the image 5.10 is the modified image. Other image file need to be modified in same way.
420 420  
421 421  [[image:image-20241121172714-13.png]]
422 422  
... ... @@ -426,7 +426,7 @@
426 426  
427 427   image 5.10 modified image file
428 428  
429 -7. Modify the **ui_water_leak/CMakeLists.txt**. Open this file, and modify it as shown in image 5.11 (before) and image 5.12 (after).
426 +**7. Modify the ui_water_leak/CMakeLists.txt.** Open this file, and modify it from image 5.11 to image 5.12.
430 430  
431 431  [[image:image-20241121180030-15.png]]
432 432  
... ... @@ -436,9 +436,8 @@
436 436  
437 437   image 5.12 ui_water_leak/CMakeLists.txt after modification
438 438  
436 +**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.
439 439  
440 -8. Modify the **ui_water_leak.h** file. Images 5.13 and 5.14 show the code before modification, while Images 5.15 and 5.16 show the code after modification.
441 -
442 442  [[image:image-20241122094200-23.png]]
443 443  
444 444   image 5.13 ui_water_leak.h (1) before modification
... ... @@ -455,7 +455,7 @@
455 455  
456 456   image 5.16 ui_water_leak.h (2) before modification
457 457  
458 -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.
454 +**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.
459 459  
460 460  _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.
461 461  
... ... @@ -483,7 +483,7 @@
483 483  
484 484   image 5.22 ui_water_leak.c (3) after modification
485 485  
486 -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.
482 +**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.
487 487  
488 488  [[image:image-20241122134113-35.png||height="380" width="421"]]
489 489  
... ... @@ -493,7 +493,7 @@
493 493  
494 494  image 5.24 ui_water_leak_events_.h after modification
495 495  
496 -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.
492 +**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.
497 497  
498 498  Step1. '#include "ui.h"'~-~->'#include "ui_water_leak.h"'
499 499  
... ... @@ -514,7 +514,7 @@
514 514   image 5.26 ui_water_leak_events_.c after modification
515 515  
516 516  
517 -12. **Modify ui_water_leak_style.c file.**
513 +**12. Modify ui_water_leak_style.c file.**
518 518  
519 519  Step1. '#include "../ui.h"'~-~->#include '"../ui_water_leak.h"'
520 520  
... ... @@ -557,7 +557,6 @@
557 557  
558 558   image 5.32 ui_water_leak_style.c (4)
559 559  
560 -
561 561  [[image:image-20241122154755-49.png||height="864" width="513"]]
562 562  
563 563   image 5.33 ui_water_leak_style.c (4)
... ... @@ -598,31 +598,22 @@
598 598  
599 599  return union_sensor;
600 600  
601 -[[image:image-20250122173546-6.png||height="777" width="922"]]
596 +[[image:image-20241122171211-54.png||height="635" width="792"]]
602 602  
603 603   image 5.38
604 604  
605 605  
606 -13. Rest midification in sort.h file.
601 +**13. Modify sort.c file.**
607 607  
608 -In image 5.39 as below, we can see "WATER_LEAK_TYPE" at line 24 and water leak switch status definition at line 32,33, and these are what we need to add in sort.
603 +Add a line of code ~-~-'#include "ui_water_leak.h"' as shown in image 5.39 line 16.
609 609  
610 -[[image:image-20250122170230-1.png||height="580" width="513"]]
605 +[[image:image-20241122173718-56.png||height="378" width="579"]]
611 611  
612 - image 5.39 sort.h
607 + image 5.39 sort.c (1)
613 613  
614 -13. **Modify sort.c file.**
615 -
616 -Add a line of code ~-~-'#include "ui_water_leak.h"' as shown in image 5.39 line 26.
617 -
618 -[[image:image-20250122171910-5.png||height="524" width="510"]]
619 -
620 - image 5.40 sort.c (1)
621 -
622 622  There are still some changes need to be done in sort.c, and omit here for the moment.
623 623  
624 624  
625 -
626 626  = 6. FAQ =
627 627  
628 628  == 6.1 ==
... ... @@ -655,7 +655,7 @@
655 655  
656 656  
657 657  * Datasheet
658 -* Source Code: [[dragino/LoRa-HMI-Touch-Screen: Open Source LoRa / LoRaWAN HMI Touch Screen Project>>url:https://github.com/dragino/LoRa-HMI-Touch-Screen/tree/main]]
644 +* Source Code
659 659  * Mechinical
660 660  
661 661  = 10. FCC Warning =
1738893226894-758.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -25.6 KB
Content
image-20241226135550-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -293.3 KB
Content
image-20250122170230-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -77.3 KB
Content
image-20250122171809-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -51.1 KB
Content
image-20250122171825-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -51.1 KB
Content
image-20250122171832-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -51.1 KB
Content
image-20250122171910-5.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -51.1 KB
Content
image-20250122173546-6.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -200.4 KB
Content
image-20250207100150-7.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -54.1 KB
Content
image-20250207101415-8.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -17.6 KB
Content
image-20250207101515-9.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -24.1 KB
Content
image-20250207142334-10.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -62.0 KB
Content
image-20250207143131-11.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -48.7 KB
Content
image-20250207144605-12.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -58.1 KB
Content
image-20250207164320-13.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -194.5 KB
Content
image-20250207165702-14.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -78.1 KB
Content
image-20250207170215-15.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -2.6 KB
Content
image-20250207170307-16.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -2.2 KB
Content
image-20250207171650-17.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -11.0 KB
Content
image-20250207171851-18.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.xieby
Size
... ... @@ -1,1 +1,0 @@
1 -2.5 KB
Content

Applications

Navigation

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