Wiki source code of LTS5 LoRa HMI Touch Screen

Version 194.1 by BoYang Xie on 2025/07/17 15:44

version	line-number	content
133.2	1
	2
188.2	3	[[image:image-20241226135550-1.png\|\|data-xwiki-image-style-alignment="center"]]
2.1	4
	5
56.1	6
	7
2.1	8	(% _mstvisible="1" %)
56.1	9	(% _msthash="315238" _msttexthash="18964465" _mstvisible="3" %)Table of Contents:
2.1	10
	11	{{toc/}}
	12
	13
	14
	15
	16
	17
	18
	19
	20	= 1. Introduction =
	21
116.1	22	== 1.1 What is the LTS5 LoRa HMI Touch Screen? ==
2.1	23
56.1	24
116.1	25	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.
2.1	26
116.1	27	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.
2.1	28
116.1	29	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.
2.1	30
116.1	31	The LA66 LoRa module can be programmed to support either private LoRa protocols or the LoRaWAN protocol.
2.1	32
189.2	33
189.3	34	//Note: Due to the current incomplete functionality, it is not recommended to purchase at this time.//
189.2	35
2.1	36	== 1.2 Features ==
	37
115.1	38
55.1	39	* ESP32-WROOM MCU: 8MB RAM & 16MB ROM
	40	* Dragino LA66 LoRa Module
4.2	41	* Support Private LoRa protocol or LoRaWAN protocol
	42	* Support WiFi & BLE wireless protocol
	43	* 5.0" HMI touch screen
4.6	44	* Support LVGL case. SquareLine program.
4.2	45	* Support RS485 Interface
	46	* Open Source Project
2.1	47	* Wall Attachable.
4.2	48	* 5V DC power
2.1	49	* IP Rating: IP52
	50
116.1	51	== 1.3 Specifications ==
2.1	52
56.1	53
4.9	54	LoRa:
	55
55.1	56	* Frequency Range: 870 MHz ~~ 960 MHz
	57	* TCXO crystal to ensure RF performance on low temperature
	58	* Maximum Power +22 dBm constant RF output
	59	* High sensitivity: -148 dBm
	60	* LoRa Tx Current: <90 mA at +17 dBm, 108 mA at +22 dBm
	61	* LoRa Rx current: <9 mA
4.9	62
4.7	63	WiFi:
	64
	65	* 802.11b/g/n
	66	* Up to 150 Mbps data rate in 802.11n mode
	67	* Support A-MPDU and A-MSDU aggregation
	68	* zero point four μ S protection interval
	69	* Working channel center frequency range: 2412~~2484 MHz
	70
	71	Bluetooth:
	72
	73	* Bluetooth V4.2 BR/EDR and Bluetooth LE standard
	74	* Class-1, Class-2, and Class-3 transmitters.
	75	* AFH
	76	* CVSD and SBC
	77
4.2	78	Display:
2.1	79
4.9	80	* 5.0 Inch , 800 x 480
	81	* IPS Capacitive Touch SCreen
4.11	82	* RGB color.
	83	* Display Area: 120.7*75.80 mm
2.1	84
	85	== 1.4 Power Consumption ==
	86
56.1	87
4.5	88	* External 5V DC power adapter
2.1	89
	90	== 1.5 Storage & Operation Temperature ==
	91
56.1	92
4.10	93	* Operation Temperature: -20 ~~ 70°C (No Dew)
	94	* Storage Temperature: -30 ~~ 70°C (No Dew)
2.1	95
	96	== 1.6 Applications ==
	97
56.1	98
2.1	99	* Smart Buildings & Home Automation
	100	* Logistics and Supply Chain Management
	101	* Smart Metering
	102	* Smart Agriculture
	103	* Smart Cities
	104	* Smart Factory
	105
122.1	106	= 2. Getting Started with 'Hello World' =
2.1	107
5.1	108	== 2.1 About this demo ==
2.1	109
56.1	110
117.1	111	This getting started example demonstrates how to design and deploy a simple display UI for the LTS5 device. The example includes:
2.1	112
117.1	113	* Creating a basic UI with a single button.
	114	* Implementing functionality to navigate the Web UI to a new page when the button is clicked.
	115	* Uploading the UI to the LTS5 device.
56.1	116
117.1	117	By completing this demo, you will gain foundational knowledge for customizing the LTS5 interface and building more advanced IoT applications.
	118
	119
5.1	120	== 2.2 Install Software Running Environment ==
2.1	121
115.1	122
120.1	123	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.
2.1	124
115.1	125
120.1	126	=== 2.2.1 Install VS Code and ESP-IDF extension ===
26.2	127
56.1	128
120.1	129	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]].
26.2	130
120.1	131	Next, install the ESP-IDF extension within VS Code. Detailed steps for this process are shown in Image 1.
26.2	132
120.1	133
51.2	134	[[image:image-20240928110211-5.png\|\|height="508" width="866"]]
	135
120.1	136	Image 1: ESP-IDF extension install
26.2	137
	138	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]]
	139
56.1	140
5.1	141	=== 2.2.2 Install SquareLine Studio ===
2.1	142
56.1	143
125.1	144	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.
2.1	145
133.2	146	[[image:squareline.io_downloads.png\|\|height="888" width="1294"]]
2.1	147
56.1	148
121.1	149	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:
120.1	150
121.1	151	* Max. 10 screens
	152	* Max. 150 widgets
	153	* Max. 5 global colors
	154	* Max. 2 themes
	155	* Max. 1 component
120.1	156
121.1	157	== 2.3 Simple usage of SquareLine Studio and exporting UI code ==
2.1	158
56.1	159
131.1	160	Start the SquareLine Studio. The launcher screen appears as shown in the below image. You can create a new project by clicking Create in the top menu. Then select the Desktop tab. Select the development platform, Eclipse with SDL for development on PC.
2.1	161
125.1	162	* In the PROJECT SETTINGS, select LVGL version as 8.3.11 and Resolution as 800 x 480.
	163	* Select the CREATE button to create the new project with the selected settings.
121.1	164
133.2	165	[[image:squareline-studio-launcher-screen.png\|\|height="752" width="1415"]]
26.2	166
	167
131.1	168	Next, you need to configure some additional settings for this project. To do so, select File -> Project Settings as shown in the image below.
	169
26.2	170	[[image:1727229582471-566.png]]
	171
	172
131.1	173	In the PROJECT SETTINGS dialog box, configure/modify the project settings as shown in the image below.
121.1	174
179.1	175	* UI Files Export Path: Select a folder on your computer to store the UI files.
121.1	176	* LVGL Include Path: Set this to lvgl.h
131.1	177	* Click on the APPLY CHANGES button.
121.1	178
51.2	179	[[image:image-20240928105309-4.png\|\|height="526" width="556"]]
	180
26.2	181
131.1	182	Now you can start building the user interface. Follow the steps below:
26.2	183
121.1	184
123.2	185	=== Add widgets ===
26.2	186
123.2	187
180.1	188	After creating a project, a Screen will be automatically added. Its name is Screen1 by default.
	189
131.1	190	To add a widget, navigate to the Widgets panel, and then click on the widget you want to add to the screen. You can reposition the widgets in the screen area by clicking and dragging them. Now add a Label, Button, and Image as shown in the image below. The added widgets are also displayed in the Hierarchy panel.
26.2	191
51.2	192	[[image:image-20240928111412-6.png\|\|height="526" width="864"]]
26.2	193
	194
131.1	195	Then click the Screen widget to add the second screen. After adding the second screen, it will appear in the Screens panel as Screen2.
26.2	196
131.1	197	[[image:Screenshot 2024-12-24 140459.png\|\|height="278" width="290"]]
	198
123.2	199	=== Modify widget properties ===
	200
	201
131.1	202	The area for modifying widgets is called the Inspector panel. The Inspector panel consists of four sections: COMPONENT, <WIDGET>, STYLE SETTINGS, and EVENTS, as shown in the image below. The second section allows you to adjust a widget's layout, size, position, alignment, flags, states, and more. When you select a widget on the screen, the name of this section changes to match the name of the selected widget.
26.2	203
51.2	204	[[image:1727485118799-984.png]]
26.2	205
	206
123.2	207	==== Changing the Button properties ====
122.1	208
123.2	209
131.1	210	Click the Button you have added to the screen. Under the Layout you can change the button's position and size. Use the following settings:
122.1	211
131.1	212	* Flex Flow: No Layout
	213	* Transform:
	214	X**: 331 px
	215	Y**: 203 px
	216	Width**: 100 px
	217	Height**: 50 px
	218	Align**: CENTER
122.1	219
51.2	220	[[image:1727485251053-655.png]]
26.2	221
	222
123.1	223	Next, add a click event to the button. When the button is clicked, an event should trigger to change the current screen (Screen1) to a new screen (Screen2) with a fade effect and the transition from Screen1 to Screen2 should take 500ms.
26.2	224
131.1	225	* Click ADD EVENT button. A new section will appear to configure this event.
26.2	226
131.1	227	[[image:Screenshot 2024-12-24 134937.png\|\|height="80" width="290"]]
	228
	229	* Select CLICKED from the dropdown under Trigger. Choose CHANGE SCREEN under Action, then click the ADD button. A new section will appear to configure the action.
	230
	231	[[image:Screenshot 2024-12-24 134818.png\|\|height="222" width="290"]]
	232
	233	* Select Screen2 under Screen to. Select FADE ON from Fade mode. The default value 500 means the transition takes 500 milliseconds to appear the Screen2.
	234	* Finally, click the ADD button.
	235
51.2	236	[[image:1727485480434-713.png\|\|height="395" width="290"]]
26.2	237
123.2	238	Image 8: Add an event for the button
51.2	239
	240
123.2	241	==== Changing the label properties ====
51.2	242
123.2	243
131.1	244	Click the Label you have added to the screen. Under the Label section, type "Click for Detail" in the Text textbox.
122.1	245
51.2	246	[[image:image-20240928090825-1.png\|\|height="327" width="391"]]
	247
	248
131.1	249	Once you enter the text, it will immediately appear on the label.
51.2	250
131.1	251
123.2	252	==== Changing image properties ====
122.1	253
123.2	254
131.1	255	To use the Image widget, you should first add an image to your project. The image format must be PNG, and its resolution should not exceed 800x480 pixels. There are two ways to add an image file.
51.2	256
131.1	257	One way is to move your image into the folder "…/squareline project/assets/", as shown in the image below.
	258
51.2	259	[[image:image-20240928113424-9.png\|\|height="355" width="505"]]
	260
	261
131.1	262	The other way is to click the "ADD FILE INTO ASSETS" button, then select an image from your computer to import. After adding, you can see the image in the "assets" panel in SquareLine Studio, as shown in the image below.
	263
51.2	264	[[image:image-20240928114139-10.png\|\|height="559" width="810"]]
	265
	266
123.2	267	==== The relationship between widgets ====
51.2	268
123.2	269
123.1	270	Widgets commonly have two types of relationships: parallel and parent-child.
	271
	272	* In a parallel relationship, widgets' positions are determined relative to a shared reference object.
132.1	273	* 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.
123.1	274
51.2	275	[[image:1727486567182-334.png\|\|height="318" width="278"]]
	276
	277
131.1	278	Move the label, Label1 to make it a child of Button1 as shown in the image below.
123.1	279
51.2	280	[[image:image-20240928112001-8.png\|\|height="431" width="796"]]
	281
	282
131.1	283	Then set the X and Y position of the label to 0 as shown in the image below. The label will appear on the button. If you move the button on the screen, the label will move along with it as part of the button.
51.2	284
131.1	285	[[image:Screenshot 2024-12-24 144005.png\|\|height="360" width="290"]]
	286
	287
123.2	288	==== Preview the screen ====
51.2	289
123.2	290
132.1	291	You can test the result by clicking on the PLAY button as shown in the image below. The screen will change into play mode.
122.1	292
51.2	293	[[image:1727487368023-281.png]]
	294
	295
123.1	296	For more information, please visit the official link: [[SquareLine Studio 1.4.2 Documentation ~\| SquareLine Studio>>url:https://docs.squareline.io/docs/squareline/]].
51.2	297
123.1	298
181.1	299	== 2.4 Integrate UI Code into an ESP-IDF Project ==
26.2	300
56.1	301
132.1	302	To integrate, first export the UI code, then make some modifications, and finally relocate the UI code to a specific position within the project.
26.2	303
135.1	304	On the menubar, click Export -> Export UI Files as shown in the image below.
	305
26.2	306	[[image:1727229798126-306.png]]
	307
	308
135.1	309	The exported UI files can be found in your SquareLine project folder as shown in the image below.
	310
	311
51.2	312	[[image:1727229821582-258.png\|\|height="333" width="662"]]
26.2	313
	314
135.1	315	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.
26.2	316
54.1	317	[[image:image-20240928144830-11.png]]
26.2	318
	319
135.1	320	Open the CMakeLists.txt file and edit it as ahown below.
	321
51.2	322	[[image:1727229892636-154.png\|\|height="521" width="407"]]
26.2	323
	324
135.1	325	Open the main.c file and add two lines of code as shown in the below images.
132.1	326
135.1	327	Add #include "ui.h"
26.2	328
	329	[[image:1727229926561-300.png]]
	330
	331
135.1	332	Add ui_init();
	333
26.2	334	[[image:1727229955611-607.png]]
	335
	336
135.1	337	== 2.5 Brief introduction to the Hello World project ==
56.1	338
2.1	339
135.1	340	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.
56.1	341
51.2	342
	343	== 2.6 Test Result ==
	344
56.1	345
135.1	346	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.
2.1	347
135.1	348	Screen 1:
	349
51.2	350	[[image:1727488067077-684.png\|\|height="402" width="574"]]
26.2	351
	352
135.1	353	Screen 2:
	354
51.2	355	[[image:1727488157579-949.png\|\|height="397" width="572"]]
26.2	356
	357
5.1	358	= 3. Example Project 1: LoRa Central Display =
2.1	359
7.1	360	[[image:image-20240916101737-1.png\|\|height="468" width="683"]]
2.1	361
7.1	362
8.1	363	= 4. Example Project 2: LoRaWAN RS485 Alarm =
2.1	364
165.2	365	= 5. Example Project 3: P2P =
164.2	366
	367	The project achieves the function of receiving LoRa P2P messages and displaying them on the screen. The workflow is as follows: A LA66, running a P2P program, sends a message in a particular format via an AT command. Then, the LTS5 receives the message and displays it on the screen.
	368
	369	The project can be found at [[this link>>url:https://github.com/dragino/LoRa-HMI-Touch-Screen/tree/main/Example/P2P]].
	370
182.1	371	== 5.1 Firmware Flashing ==
164.2	372
	373
182.1	374	The following software tools are required to flash firmware to the ESP32 and LA66.
164.2	375
182.1	376	* Download the ESP32 firmware flash tool from [[this link>>https://docs.espressif.com/projects/esp-test-tools/en/latest/esp32/production_stage/tools/flash_download_tool.html]].
	377	* Download the LA66 firmware flash tool from [[this link>>https://www.dropbox.com/scl/fo/9kqeqf6wmet10o9hgxuwa/h?rlkey=4ikrg6kg5v0yjxwhp0i37wrv7&e=1&dl=0]].
164.2	378
182.1	379	=== 5.1.1 Upload the Firmware to the ESP32 ===
164.2	380
182.1	381	Open //flash_download_tool.exe// and follow the steps below.
	382
	383	* Chip Type: ESP32-S3
	384	* WorkMode: Develop
	385	* LoadMode: UART
	386	* Click on the OK button.
	387
164.2	388	[[image:1738893226894-758.png\|\|height="170" width="176"]]
	389
182.1	390
	391	In the SPIDownload tab,
	392
188.1	393	* Select the checkboxes for ESP32_LoRaC-P2P_CommonFW_v1.0.0.bin.
	394	* SPI Flashing Config(default configuration):
182.1	395	SPI SPEED**: 40MHz
	396	SPI MODE**: DIO
	397	Check DoNotChgBin** option.
	398	* COM: Select the correct COM port.
	399	* BAUD: 1152000
	400	* Click on the START button.
	401
188.1	402	[[image:image-20250505122103-4.png\|\|height="551" width="705"]]
164.2	403
182.1	404	The progress bar will indicate the firmware update progress and display a FINISH message once the update is complete.
164.2	405
182.1	406
191.2	407	If you want to compile your own ESP32 project and burn the firmware instead of using the pre-provided firmware in the Firmware folder, please use the following method.
	408
193.3	409	~1. The first method is to use the IDF plugin in VSCode for flashing. Just click the button circled in red in the picture.
191.2	410
193.2	411	[[image:1752737375843-555.png]]
	412
193.4	413	2. The second method is to use the FLASH DOWNLOAD TOOL. Select the 4 bin files under the build folder in the project as shown in the following figure.
193.2	414
193.5	415	Click the "CombineBin" button in the figure below to combine the selected firmware. The combined firmware can be found in the "flash_download_tool_3.9.7/combine/" directory of this software.
	416
192.2	417	[[image:1752737128542-192.png\|\|height="574" width="674"]]
	418
	419
182.1	420	=== 5.1.2 Upload the Firmware to the LA66 ===
	421
	422	Open Dragino_Sensor_Manager_Utility.exe, and then follow the steps below.
	423
	424	* Click on the UART Update Firmware tab.
	425	* Select the correct COM port.
188.1	426	* Click on the Upload_File button and select the LA66_P2P_FW_v1.0.0.bin file.
182.1	427	* Click on the Start button.
	428
164.2	429
182.1	430
188.1	431	[[image:image-20250505121328-2.png]]
164.2	432
182.1	433
188.1	434	[[image:image-20250505121531-3.png]]
	435
182.1	436	(% class="wikigeneratedid" %)
	437	The progress bar will indicate the firmware update progress.
	438
	439
183.1	440	== 5.2 AT commands and LTS5 Panel Data Formats ==
164.2	441
	442	AT+SEND=1,014b69746368656e2d467269676531FFFFA84041000181D4A801A4CBBB0A8E085C02,0,3
	443
	444	AT+SEND=1,014b69746368656e2d467269676531FFFFA84041000181D4A802A4CB00,0,3
	445
	446	AT+SEND=1,014b69746368656e2d467269676531FFFFA84041000181D4A803A4CB00,0,3
	447
	448	AT+SEND=1,014b69746368656e2d467269676531FFFFA84041000181D4A804A4CB00,0,3
	449
	450	AT+SEND=1,014b69746368656e2d467269676531FFFFA84041000181D4A805A4CB00,0,3
	451
	452	AT+SEND=1,014b69746368656e2d467269676531FFFFA84041000181D4A806A4CB00,0,3
	453
178.1	454	LTS5 panel data format:
164.2	455
178.1	456	~1. AT+SEND=1,01 4b69746368656e2d467269676531FFFF A84041000181D4A8 01 A4CB BB0A 8E08 5C02,0,3
164.2	457
	458	01: encrypt. 1 Byte. 01 ~-~-> no encryption. This 1-byte information is now invalid; simply write 0x01 instead.
	459
	460	4b69746368656e2d467269676531FFFF: Device Name. 16 Bytes. The Device Name for this piece of information is "Kitchen-Frige1," and the subsequent "FFFF" is intended to pad it up to 16 Bytes. The Device Name for this piece of information is 'Kitchen-Frige1,' and the subsequent 'FFFF' is intended to pad it up to 16 Bytes, but it is not necessary as the system can handle shorter names as well.
	461
	462	A84041000181D4A8: Device EUI. 8 Bytes. The last three Bytes will be extracted by the ESP32-S3 and displayed on the screen.
	463
	464	01: Panel Type. 1 Byte. 0x01~-~->Tem & Hum,
	465
	466	0x02~-~->Door,
	467
	468	0x03~-~->Water Leak,
	469
	470	0x04~-~->Occupied,
	471
	472	0x05~-~->Button,
	473
	474	0x06~-~->Alarm,
	475
	476	A4CB: Battery level//. //2 Bytes. Battery Voltage =0xCBA4&0x3FFF=0x0BA4=2980mV
	477
	478	BB0A: The temperature of the built-in sensor in LHT65N.// //2 Bytes. Temperature: 0x0ABB/100=27.47℃
	479
	480	8E08: The temperature of the External temperature sensor.// //2 Bytes. Temperature: 0x088E/100=21.90℃
	481
	482	5C02：The humidity of the built-in sensor in LHT65N. 2 Bytes. Humidity: 0x025C/10=60.4%
	483
	484	2. AT+SEND=1,01 4b69746368656e2d467269676531FFFF A84041000181D4A8 02 A4CB 00,0,3
	485
	486	Specific sections of the data share the same function.
	487
	488	00: Status. 1 Byte//. //If Panel Type is 0x02, Status: 00~-~->Open; 01~-~->Close.
	489
	490	If Panel Type is 0x03, Status: 00~-~->Normal; 01~-~->Water Leaking.
	491
	492	If Panel Type is 0x04, Status: 00~-~->Free; 01~-~->Occupied.
	493
	494	If Panel Type is 0x05, Status: 00~-~->OFF; 01~-~->ON.
	495
	496	If Panel Type is 0x06, Status: 00~-~->OFF; 01~-~->Alarm.
	497
	498	== 5.3 Usage ==
	499
	500	After burning the firmware into LTS5, you can use an LA66 equipped with peer-to-peer firmware to send data to LTS5 via AT commands.
	501
	502	5.3.1 Connect LA66 to the computer, open Serial Port Utility, and send the AT+CFG instruction to check whether the LA66 has downloaded correct program.
	503
	504	[[image:image-20250207143131-11.png\|\|height="527" width="547"]]
	505
	506	5.3.2 Copy an AT instruction example, click "Send" button, then the led in LA66 will flash and the LTS5 will display the LoRa information.
	507
	508	[[image:image-20250207144605-12.png\|\|height="634" width="548"]]
	509
178.1	510	LTS5 receives this message and displays it on its screen as the image below shows.
	511
	512	[[image:image-20250208181700-8.jpeg\|\|height="528" width="704"]]
	513
164.2	514	= 6. Example Project 4: LoRaWAN_CLASS_C =
	515
	516
	517	The project achieves the function of receiving LoRaWAN Class C messages and displaying them on the screen. Note: The Things Network (TTN) needs to enable Class C support, and the LA66 within the LTS5 needs to operate in Class C mode.
	518
	519	The downlink workflow proceeds as follows: The Things Network (TTN) sends a message in a specific format via downlink. Then, a LoRaWAN gateway relays this message to the LTS5. Finally, the LTS5 receives the message and displays it on its screen.
	520
	521	The uplink workflow is as follows: The LA66 within the LTS5 sends a LoRaWAN message, for some reason, to a LoRaWAN gateway, which then forwards it to The Things Network (TTN).
	522
	523	The project can be found at [[this link>>https://github.com/dragino/LoRa-HMI-Touch-Screen/tree/main/Example/LoRaWAN_CLASS_C]].
	524
	525	== 6.1 firmware flashing approach ==
	526
165.3	527	The firmware flashing approach is the same as described in section 5.1.
164.2	528
	529	== 6.2 flowchart ==
	530
	531	[[image:image-20250207164320-13.png\|\|height="696" width="1344"]]
	532
	533	== 6.3 Usage ==
	534
165.3	535	This section now describes a process involving TTN downlink panel data that is to be displayed on the LTS5 screen.
164.2	536
	537	6.3.1 Connect LA66 to the computer, open Serial Port Utility, and send the AT+CFG instruction to check whether the LA66 has downloaded correct program.
	538
	539	[[image:image-20250207165702-14.png\|\|height="830" width="563"]]
	540
	541	6.3.2 Switch to Class C using "AT+CLASS=C", and check the class with "AT+CLASS=?".
	542
	543	[[image:image-20250207173212-27.png]]
	544
	545	[[image:image-20250207172246-20.png]]
	546
	547	6.3.3 Verify LA66's join status (in LTS5) with "AT+NJS=?". If not joined, connect manually to LoRaWAN with "AT+JOIN".
	548
	549	[[image:image-20250207172010-19.png]]
	550
	551	[[image:image-20250207171650-17.png]]
	552
	553	6.3.4 After joining, send a message to TTN, such as "AT+SENDB=01,02,8,05820802581ea0a5", to activate communication.
	554
	555	[[image:image-20250207192107-28.png]]
	556
165.3	557	6.3.5 TTN distributes panel data in three phases: DEUI, Dev Name, and Sensor Data. The Dev Name, the last three bytes of the DEUI, and the panel type union together ensure the identification of a panel. Data about the same panel type will update the existing panel display, while data about a different panel type will create a new panel display on the LTS5 screen.
164.2	558
165.3	559	There is an example for TTN downlink.
165.2	560
164.2	561	1. downlink DEUI F1A84041000181D4A8
	562	1. downlink Dev Name F24B69746368656E2D467269676531FFFF
165.2	563	1. downlink Sensor Data 5501A4CBBB0A8E085C02 or 5504A4CB01. Both of them are vaild formats for LTS5. Note: 0x55 as prefix and any other prefix except 0xF1, 0xF2, 0xF3 means downlink is Sensor Data.
164.2	564
178.1	565	[[image:image-20250208175819-1.png\|\|height="503" width="502"]]
	566
	567
	568	[[image:image-20250208175918-2.png\|\|height="505" width="502"]]
	569
	570
	571	[[image:image-20250208180010-3.png\|\|height="507" width="503"]]
	572
	573
	574	[[image:image-20250208181019-4.jpeg\|\|height="592" width="790"]]
	575
	576
	577	[[image:image-20250208181328-7.png\|\|height="505" width="504"]]
	578
	579
	580	[[image:image-20250208181139-5.jpeg\|\|height="594" width="792"]]
	581
	582
165.3	583	= 7. The method for adding a new type of panel to the project =
2.1	584
141.2	585	If you don't have this need, then this part of the content can be ignored.
123.2	586
165.3	587	1. Design a panel in SquareLine Studio, as shown in Image 7.1 below for reference.
75.1	588
	589	[[image:image-20241121113445-1.png\|\|height="584" width="934"]]
	590
165.3	591	Image 7.1: a panel about water_leak
75.1	592
123.2	593
190.11	594	2. Export the UI file.
75.1	595
190.12	596	You need to adjust the export path first, then click 'Export -> Export UI Files' on the menu bar. The method for exporting UI files using the SquareLine software has already been described earlier.
190.11	597
190.3	598	Next, create a new folder named "ui_water_leak" under "app_components/extra_lib/", and then cut all the UI files you just exported into this newly created folder.
	599
190.4	600	Image 7.2 shows the result of the operation.
190.3	601
75.1	602	[[image:image-20241121141120-4.png\|\|height="383" width="795"]]
	603
165.3	604	Image 7.2: Exported UI files
75.1	605
123.2	606
141.2	607	3. Delete and rename some file. Here are the steps:
75.1	608
135.1	609	Step 1: Delete the 'components' directory.
	610	Step 2: Delete 'filelist.txt'.
	611	Step 3: Delete 'ui_helpers.c' and 'ui_helpers.h'.
	612	Step 4: Rename 'ui_ScreenMain.c' in the 'screens' directory to 'ui_water_leak_style.c'.
	613	Step 5: Rename the 'screens' directory to 'styles'.
75.1	614
	615	[[image:image-20241121151934-10.png\|\|height="303" width="792"]]
	616
165.3	617	image 7.3 rest file (1)
75.1	618
	619	[[image:image-20241121142925-7.png\|\|height="141" width="793"]]
	620
165.3	621	image 7.4 rest file (2)
75.1	622
165.3	623	4. Open the project in VS Code.
75.1	624
165.3	625	5. Add the file include path for water_leak in extra_lib/CMakeLists.txt, as shown in Images 7.5 and 7.6. Its format is similar to that of tem_hum or door."
75.1	626
	627	[[image:image-20241121181957-17.png\|\|height="438" width="516"]]
	628
165.3	629	image 7.5 extra_lib/CMakeLists.txt before adding
75.1	630
	631	[[image:image-20241121182239-18.png\|\|height="520" width="518"]]
	632
165.3	633	image 7.6 extra_lib/CMakeLists.txt after adding
75.1	634
141.2	635	6. Modify the header files included in the fonts and images directories.
75.1	636
165.3	637	Open the fonts/ui_font_Font12.c file, as shown in Image 7.7, and change #include "../ui.h" to #include "../ui_water_leak.h". The modified file is shown in Image 7.8. Other font files need to be modified in the same way.
135.1	638
75.1	639	[[image:image-20241121171629-11.png]]
	640
165.3	641	image 7.7 unmodified font file
75.1	642
	643	[[image:image-20241121171901-12.png]]
	644
165.3	645	image 7.8 modified font file
75.1	646
165.3	647	Open the images/ui_img_battery_empty_png.c file, as shown in Image 7.9, and change #include "../ui.h" to #include "../ui_water_leak.h". The modified file is shown in Image 7.10. Other image files need to be modified in the same way.
75.1	648
	649	[[image:image-20241121172714-13.png]]
	650
165.3	651	image 7.9 unmodified image file
75.1	652
	653	[[image:image-20241121172908-14.png]]
	654
165.3	655	image 7.10 modified image file
75.1	656
165.3	657	7. Modify the ui_water_leak/CMakeLists.txt. Open this file, and modify it as shown in image 7.11 (before) and image 7.12 (after).
75.1	658
	659	[[image:image-20241121180030-15.png]]
	660
165.3	661	image 7.11 ui_water_leak/CMakeLists.txt before modification
75.1	662
	663	[[image:image-20241121180517-16.png]]
	664
165.3	665	image 7.12 ui_water_leak/CMakeLists.txt after modification
75.1	666
	667
165.3	668	8. Modify the ui_water_leak.h file. Images 7.13 and 7.14 show the code before modification, while Images 7.15 and 7.16 show the code after modification.
135.1	669
113.2	670	[[image:image-20241122094200-23.png]]
75.1	671
165.3	672	image 7.13 ui_water_leak.h (1) before modification
75.1	673
113.2	674	[[image:image-20241122094320-24.png\|\|height="852" width="554"]]
75.1	675
165.3	676	image 7.14 ui_water_leak.h (2) before modification
75.1	677
113.2	678	[[image:image-20241122094600-25.png\|\|height="1078" width="554"]]
75.1	679
165.3	680	image 7.15 ui_water_leak.h (1) after modification
75.1	681
113.2	682	[[image:image-20241122094719-26.png\|\|height="941" width="583"]]
75.1	683
165.3	684	image 7.16 ui_water_leak.h (2) before modification
75.1	685
165.3	686	9. Modify ui_water_leak.c file. The image 7.17, 7.18, 7.19 show the code before modification, and the image 7.20, 7.21, 7.22 show the code after modification.
75.1	687
113.2	688	_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.
75.1	689
113.2	690	[[image:image-20241122102929-27.png\|\|height="619" width="426"]]
	691
165.3	692	image 7.17 ui_water_leak.c (1) before modification
113.2	693
	694	[[image:image-20241122112838-30.png\|\|height="551" width="628"]]
	695
165.3	696	image 7.18 ui_water_leak.c (2) before modification
113.2	697
	698	[[image:image-20241122110815-29.png\|\|height="725" width="712"]]
	699
165.3	700	image 7.19 ui_water_leak.c (3) before modification
113.2	701
	702	[[image:image-20241122113158-31.png\|\|height="872" width="677"]]
	703
165.3	704	image 7.20 ui_water_leak.c (1) after modification
113.2	705
	706	[[image:image-20241122113259-33.png\|\|height="874" width="724"]]
	707
165.3	708	image 7.21 ui_water_leak.c (2) after modification
113.2	709
	710	[[image:image-20241122113359-34.png\|\|height="804" width="746"]]
	711
165.3	712	image 7.22 ui_water_leak.c (3) after modification
113.2	713
165.3	714	10. Modify ui_water_leak_events.h file. The image 7.23 show the code before modification, and the image 7.24 show the code after modification.
113.2	715
	716	[[image:image-20241122134113-35.png\|\|height="380" width="421"]]
	717
165.3	718	image 7.23 ui_water_leak_events_.h before modification
113.2	719
	720	[[image:image-20241122134420-37.png\|\|height="201" width="283"]]
	721
165.3	722	image 7.24 ui_water_leak_events_.h after modification
113.2	723
165.3	724	11. Modify ui_water_leak_events.c file. The image 7.25 show the code before modification, and the image 7.26 show the code after modification.
113.2	725
	726	Step1. '#include "ui.h"'~-~->'#include "ui_water_leak.h"'
	727
	728	Step2. add code below in delete_object() function definition.
	729
	730	panel_all * panel = find_upper_by_SensorPanel(&arr,((lv_obj_t *)(e->user_data~)~)~);
	731
	732	size_t index = panel->panel_obj_index;
	733
	734	deleteElement(&arr, index);
	735
	736	[[image:image-20241122135023-38.png\|\|height="358" width="372"]]
	737
165.3	738	image 7.25 ui_water_leak_events_.c before modification
113.2	739
	740	[[image:image-20241122135258-39.png\|\|height="403" width="559"]]
	741
165.3	742	image 7.26 ui_water_leak_events_.c after modification
113.2	743
123.2	744
141.2	745	12. Modify ui_water_leak_style.c file.
113.2	746
	747	Step1. '#include "../ui.h"'~-~->#include '"../ui_water_leak.h"'
	748
	749	add '#include "../../sort.h"'
	750
	751	add '#include "ui.h"'
	752
	753	[[image:image-20241122141536-41.png\|\|height="361" width="612"]]
	754
165.3	755	image 7.27 ui_water_leak_style.c (1) before modification
113.2	756
	757	[[image:image-20241122142129-42.png\|\|height="386" width="613"]]
	758
165.3	759	image 7.28 ui_water_leak_style.c (1) after modification
113.2	760
123.2	761
113.2	762	Step2. modify 'void ui_ScreenMain_screen_init(void)'~-~->'panel_with_type create_water_leak(uint8_t index)'
	763
165.3	764	delete code as shown in image 7.29
113.2	765
	766	[[image:image-20241122145620-44.png\|\|height="757" width="671"]]
	767
165.3	768	image 7.29 ui_water_leak_style.c (2)
113.2	769
123.2	770
165.3	771	Step3. The image 7.30, 7.31 show the change.
113.2	772
	773	[[image:image-20241122152026-45.png\|\|height="277" width="828"]]
	774
165.3	775	image 7.30 ui_water_leak_style.c (3) before modification
113.2	776
	777	[[image:image-20241122152542-46.png\|\|height="293" width="830"]]
	778
165.3	779	image 7.31 ui_water_leak_style.c (3) after modification
113.2	780
123.2	781
165.3	782	Step4. Copy partly the code in ui_water_leak.c, paste at extra_lib/sort.h(The process is shown in image 7.32, 7.33).
113.2	783
	784	[[image:image-20241122153958-47.png]]
	785
165.3	786	image 7.32 ui_water_leak_style.c (4)
113.2	787
141.2	788
113.2	789	[[image:image-20241122154755-49.png\|\|height="864" width="513"]]
	790
165.3	791	image 7.33 ui_water_leak_style.c (4)
113.2	792
123.2	793
165.3	794	Step5. Delete event function in code which was just pasted in extra_lib/sort.h(The process is shown in image 7.34).
113.2	795
	796	[[image:image-20241122155650-50.png\|\|height="922" width="513"]]
	797
165.3	798	image 7.34 ui_water_leak_style.c (5)
113.2	799
123.2	800
165.3	801	Step6. Add some lines of code in extra_lib/sort.h as shown in image 7.35.
113.2	802
	803	[[image:image-20241122161934-51.png]]
	804
165.3	805	image 7.35
113.2	806
123.2	807
165.3	808	Step7. Add a line of code in extra_lib/sort.h as shown in image 7.36.
113.2	809
	810	[[image:image-20241122162852-53.png\|\|height="330" width="529"]]
	811
165.3	812	image 7.37
113.2	813
123.2	814
165.3	815	Step8. Add some code in ui_water_leak_style.c as shown in image 7.38 from line534 to line 576 in detail.
113.2	816
	817	panel_with_type union_sensor;
	818
	819	union_sensor.panel_type = WATER_LEAK_TYPE;
	820
	821	......
	822
	823	lv_obj_set_x(union_sensor.panel_union.door.ui_PanelSensorDoor, x_by_index(index));
	824
	825	lv_obj_set_y(union_sensor.panel_union.door.ui_PanelSensorDoor, y_by_index(index));
	826
	827	return union_sensor;
	828
141.2	829	[[image:image-20250122173546-6.png\|\|height="777" width="922"]]
113.2	830
165.3	831	image 7.38
113.2	832
123.2	833
141.2	834	13. Rest midification in sort.h file.
113.2	835
165.3	836	In image 7.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.h.
113.2	837
141.2	838	[[image:image-20250122170230-1.png\|\|height="580" width="513"]]
113.2	839
165.3	840	image 7.39 sort.h
113.2	841
141.2	842	13. Modify sort.c file.
	843
	844	Add a line of code ~-~-'#include "ui_water_leak.h"' as shown in image 5.39 line 26.
	845
	846	[[image:image-20250122171910-5.png\|\|height="524" width="510"]]
	847
165.3	848	image 7.40 sort.c (1)
141.2	849
113.2	850	There are still some changes need to be done in sort.c, and omit here for the moment.
	851
	852
141.2	853
165.3	854	= 8. FAQ =
2.1	855
165.3	856	== 8.1 ==
2.1	857
	858
165.3	859	= 9. Order Info =
2.1	860
165.3	861	== 9.1 Part Number ==
2.1	862
56.1	863
4.4	864	Part Number: (% style="color:#4472c4" %)LTS5
2.1	865
	866
165.3	867	== 9.2 Packing Info ==
2.1	868
56.1	869
4.4	870	Package Includes:
2.1	871
4.4	872	* LTS5 HMI Touch Screen
	873	* 5V,2A DC Power Adapter.
	874	* USB Type C Program Cable
2.1	875
165.3	876	= 10. Support =
2.1	877
56.1	878
2.1	879	* Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
	880	* Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]].
	881
165.3	882	= 11. Reference material =
2.1	883
56.1	884
188.2	885	* Datasheet: [[https:~~/~~/www.dropbox.com/scl/fo/fr7wjsdfh9huchg59p7bv/APASCR0elWtp_EbUZ1W9K-A?rlkey=pcuptw3dtg5pw9vgt4ag6hs9z&st=ds6hdztg&dl=0>>https://www.dropbox.com/scl/fo/fr7wjsdfh9huchg59p7bv/APASCR0elWtp_EbUZ1W9K-A?rlkey=pcuptw3dtg5pw9vgt4ag6hs9z&st=ds6hdztg&dl=0]]
188.3	886	* schematic: [[LTS5-V1>>https://www.dropbox.com/scl/fo/grwr5b4x1tk2omyjwg06y/ACleSdi5f7p5zRB2mfPH7CE?rlkey=vhcs83jrj9tkmw8wa9m9wo5rx&st=hkhe3bbj&dl=0]]
141.2	887	* 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]]
4.3	888	* Mechinical
2.1	889
165.3	890	= 12. FCC Warning =
2.1	891
	892
	893	This device complies with part 15 of the FCC Rules.Operation is subject to the following two conditions:
	894
	895	(1) This device may not cause harmful interference;
	896
	897	(2) this device must accept any interference received,including interference that may cause undesired operation.
	898

Wiki source code of LTS5 LoRa HMI Touch Screen

Applications