Wiki source code of UART Access for LoRa ST v4 base model

Last modified by Mengting Qiu on 2025/03/03 15:18

version	line-number	content
26.16	1	(% class="wikigeneratedid" %)
14.1	2	Table of Contents:
	3
	4	{{toc/}}
	5
	6
	7
	8
15.1	9	= 1. LoRaST v4 base Hardware =
1.1	10
15.2	11
29.1	12	Below hardware use LoRaST v4 module. They supports UART Access for AT Command and Firmware Upgrade.
1.1	13
47.8	14
26.22	15	{{velocity}}
	16	$xwiki.ssfx.use("js/xwiki/table/table.css")
	17	$xwiki.jsfx.use("js/xwiki/table/tablefilterNsort.js", true)
	18	{{/velocity}}
26.13	19
47.9	20	(% border="1" cellspacing="5" class="doOddEven filterable grid sortable" id="tableid" style="background-color:#f2f2f2; width:869px" %)
86.1	21	(% class="sortHeader" %)\|=(% style="width: 269px; background-color: rgb(217, 226, 243);" %)[[Models(% class="wikiinternallink sortarrow wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)~[~[image:/xwiki/resources/js/xwiki/table/img/arrow-none.gif?cache-version=1648720710000~\|~\|alt="⇵" border="0"~]~]>>path:#\|\|onclick="ts_resortTable(this);return false;" class="sortHeader"]]\|=(% style="width: 158px; background-color: rgb(217, 226, 243);" %)[[Mother Board(% class="wikiinternallink sortarrow wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)~[~[image:/xwiki/resources/js/xwiki/table/img/arrow-none.gif?cache-version=1648720710000~\|~\|alt="⇵" border="0"~]~]>>path:#\|\|onclick="ts_resortTable(this);return false;" class="sortHeader"]]\|=(% style="width: 214px; background-color: rgb(217, 226, 243);" %)[[UART for AT Commands(% class="wikiinternallink sortarrow wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)~[~[image:/xwiki/resources/js/xwiki/table/img/arrow-none.gif?cache-version=1648720710000~\|~\|alt="⇵" border="0"~]~]>>path:#\|\|onclick="ts_resortTable(this);return false;" class="sortHeader"]]\|=(% style="width: 226px; background-color: rgb(217, 226, 243);" %)[[UART for Upgrade Firmware(% class="wikiinternallink sortarrow wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)~[~[image:/xwiki/resources/js/xwiki/table/img/arrow-none.gif?cache-version=1648720710000~\|~\|alt="⇵" border="0"~]~]>>path:#\|\|onclick="ts_resortTable(this);return false;" class="sortHeader"]]
54.3	22	(% class="even" %)\|(% style="width:269px" %)PS-LB, PS-LB-NA, SDI12-LB\|(% style="width:158px" %)SIB\|(% style="width:214px" %)[[Instruction>>\|\|anchor="H2.2UARTConnectionforSIBmotherboard"]]\|(% style="width:226px" %)[[Instruction>>\|\|anchor="H3.UARTforFirmwareUpgrade"]]
54.1	23	(% class="odd" %)\|(% style="width:269px" %)(((
66.1	24	SN50v3, S31-LB, S31B-LB,D20-LB.D20S-LB, D21-LB, D22-LB , SW3L-LB
54.3	25	)))\|(% style="width:158px" %)SN50v3\|(% style="width:214px" %)[[Instruction>>\|\|anchor="H2.3UARTConnectionforSN50v3basemotherboard"]]\|(% style="width:226px" %)[[Instruction>>\|\|anchor="H3.UARTforFirmwareUpgrade"]]
54.1	26	(% class="even" %)\|(% style="width:269px" %)LHT65N\|(% style="width:158px" %)LHT65N\|(% style="width:214px" %) \|(% style="width:226px" %)
	27	(% class="odd" %)\|(% style="width:269px" %)(((
	28	RS485-LB, SE01-LB, SPH01-LB,
26.24	29
54.5	30	LMS01-LB, LDS12-LB, LDS40-LB,
54.1	31
54.5	32	DDS75-LB, DDS45-LB, DDS04-LB,
54.1	33
73.1	34	DDS20-LB, MDS120-LB, MDS200-LB, WSC2-LB, LDS25-LB
54.3	35	)))\|(% style="width:158px" %)RS485-BL\|(% style="width:214px" %)[[Instruction>>\|\|anchor="H2.4UARTConnectionforRS485-BLbasemotherboard"]]\|(% style="width:226px" %)[[Instruction>>\|\|anchor="H3.UARTforFirmwareUpgrade"]]
54.1	36
15.1	37	= 2. UART for AT Commands =
	38
50.1	39	== 2.1 General software set up for AT Commands via UART ==
15.1	40
15.2	41
26.25	42	~1. Use a general serial tool.
9.1	43
26.25	44	2. Connect PC to device's UART interface
	45
	46	3. Set up serial tool with : BaudRate: 9600, databit:8, No parity, No flow control.
	47
	48	(((
	49	4. The password is the last six characters of APPSKEY or PIN of box
	50
47.6	51
20.2	52	Example：
16.1	53
	54	APPSKEY= 41 85 71 A7 5D 7E 54 52 25 58 74 85 96 14 74 85
	55
	56	The password：147485
19.1	57
20.1	58	[[image:image-20230329162900-1.png\|\|height="302" width="648"]]
19.1	59
	60
16.1	61	)))
	62
9.1	63	[[image:image-20221224170218-1.png\|\|height="497" width="640"]]
	64
	65
15.1	66	== 2.2 UART Connection for SIB mother board ==
9.1	67
15.3	68
9.1	69	[[image:image-20221224171304-3.png\|\|height="545" width="863"]]
	70
	71
21.1	72	== 2.3 UART Connection for SN50v3 base mother board ==
	73
47.6	74
54.1	75	[[image:image-20230515102801-1.png\|\|height="635" width="860"]]
21.1	76
26.24	77
54.1	78	== 2.4 UART Connection for RS485-BL base mother board ==
	79
	80
	81	[[image:微信图片_20230809144604.jpg\|\|height="673" width="791"]]
	82
	83
56.1	84	== 2.5 UART Connection for DS20L mother board ==
	85
	86
62.1	87	UART Connection for DS20L mother board:
	88
60.1	89	[[image:image-20231212145142-1.jpeg\|\|height="676" width="796"]]
56.1	90
62.1	91	Interface definition:
56.1	92
58.1	93	[[image:image-20231212144745-2.png\|\|height="279" width="510"]]
56.1	94
62.1	95	DS20L programming line:
56.1	96
62.1	97	[[image:image-20231212150405-2.jpeg\|\|height="297" width="669"]]
56.1	98
62.1	99
64.1	100	== 2.6 UART Connection for AQS01-L mother board ==
62.1	101
64.1	102	[[image:image-20240115110027-1.jpeg\|\|height="749" width="953"]]
62.1	103
64.1	104
72.1	105	== 2.7 UART Connection for LWL04 mother board ==
64.1	106
	107
72.1	108	[[image:image-20240910163111-1.jpeg\|\|height="560" width="727"]]
64.1	109
72.1	110
77.1	111	== 2.8 UART Connection for T68DL mother board ==
	112
	113
86.1	114	(% style="color:red" %)Note: For T68DL, the device needs to be reset to put the device into burn mode before the firmware is burned. After the burning is completed, you need to unplug the battery to power off the device, and then power it on again, otherwise the device cannot exit the burning mode.
77.1	115
79.1	116	[[image:image-20241029105722-1.jpeg\|\|height="478" width="705"]]
77.1	117
	118
86.1	119	== 2.9 UART Connection for PB05 mother board ==
	120
	121
	122	* If you use Dragino Sensor Manager Utility.exe to upgrade the PB05 firmware, connect as follows:
	123
	124	[[image:image-20250303142854-1.jpeg\|\|height="509" width="798"]]
	125
	126
	127	* To use TremoProgrammer to burn firmware, the PB05 must be in burn mode, i.e. the USB-TTL adapter 3.3V must be connected to the BOOT_CONTROL pin of the PB05.
	128
	129	[[image:image-20250303151218-2.jpeg\|\|height="574" width="790"]]
	130
	131	(% style="color:red" %)Note:
	132
	133	(% style="color:red" %)1. How to enter burn mode
	134
	135	Connect the PB05, E2 cable and USB-TTL adapter according to the above wiring diagram, and then press the ACT button to reactivate the PB05 (or directly install the battery again). After this operation, the PB05 will enter the burn mode.
	136
	137	[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/PB05--LoRaWAN_Button_User_Manual/WebHome/image-20250303105945-3.jpeg?width=518&height=217&rev=1.1\|\|alt="image-20250303105945-3.jpeg"]]
	138
	139	(% style="color:red" %)2.How to exit burn mode
	140
	141	After the firmware update is complete, remove any wiring, then reinstall the battery, and the PB05 will exit burn mode and restart.
	142
	143
15.1	144	= 3. UART for Firmware Upgrade =
9.1	145
28.1	146	== 3.1 Check Your device already have bootloader ==
13.1	147
28.1	148	=== 3.1.1 What is Dragino Bootloader? ===
24.1	149
26.24	150
24.1	151	Dragino Bootloader is a customizer made bootloader which support below features:
	152
36.1	153	* OTA Update via LoRa
	154	* OTA Batch update configure via LoRa
24.1	155
31.1	156	All Dragino End Devices base on LoRa ST v4 supports Dragino Bootloader.
24.1	157
	158
28.1	159	=== 3.1.2 How can i know if my device already have bootloader? ===
26.26	160
47.6	161
28.1	162	If a device has a bootloader. it will output bootloader info to UART when boot. As below:
15.3	163
75.1	164	[[image:image-20241022115811-1.png]]
22.1	165
23.1	166
28.1	167	=== 3.1.3 How to upload bootloader to device? ===
23.1	168
47.6	169
32.1	170	If your is LoRa ST v4 base hardware and doesn't have bootloader. You can upload a bootloader to it.
23.1	171
36.1	172	[[Downlink Link for OTA bootloader>>https://www.dropbox.com/sh/g4cp2lm85ovr8hu/AADX-4aEE-7SuKQAKTWrgKHIa?dl=0]].
23.1	173
36.1	174
47.6	175	(% style="color:blue" %)Update a firmware via TremoProgrammer:
36.1	176
	177	LoRaSTv4 Base hardware support UART update firmware. the UART connection is the same as AT Command connection, with the need for two extra action. See below for the steps:
	178
	179	(% style="color:blue" %)Step1(%%): Set BOOT Switch to (% style="color:blue" %)PROG(%%) mode. PROG mode is for update firmware specially.
	180
	181	(% style="color:blue" %)Step2(%%): Press (% style="color:blue" %)Reset(%%) button, the module will then boot into program mode.
	182
	183	(% style="color:blue" %)Step3(%%): Use (% style="color:blue" %)TremoProgrammer(%%) to update the firmware to LoRaST v4.
	184
	185	(% style="color:blue" %)Step4(%%): Set BOOT Switch to (% style="color:blue" %)FLASH(%%) position. Press Reset button again and module will run the new software.
	186
	187
	188	Below is the method for how to update via (% style="color:blue" %)TremoProgrammer:
	189
	190	1. TremoProgrammer download link: [[https:~~/~~/www.dropbox.com/sh/j0qyc7a9ejit7jk/AACtx2tK4gEv6YFXMIVUM4dLa?dl=0>>url:https://www.dropbox.com/sh/j0qyc7a9ejit7jk/AACtx2tK4gEv6YFXMIVUM4dLa?dl=0]]
	191
	192	2. Run (% style="color:blue" %)TremoProgrammer.(%%)
	193
	194	3. Choose software and set the address to (% style="color:blue" %)0x08000000(%%).
	195
	196	4. Rember to set BOOT Switch to (% style="color:blue" %)FLASH(%%) after update finish. And you should be about to see Bootloader info in output after update
	197
	198	[[image:image-20230515171651-1.png]]
	199
	200
28.1	201	== 3.2 Update Firmware (Assume the device already have a bootloader) ==
	202
48.1	203
	204	Video Instruction: [[https:~~/~~/youtu.be/G_xEZnNjJmM >>https://youtu.be/G_xEZnNjJmM]]
	205
	206
42.1	207	=== 3.2.1 Update a firmware via Dragino Sensor Manager Utility.exe ===
28.1	208
47.6	209
65.1	210	~1. Download [[OTA Tool>>https://www.dropbox.com/scl/fo/9kqeqf6wmet10o9hgxuwa/h?rlkey=4ikrg6kg5v0yjxwhp0i37wrv7&dl=0]]
28.1	211
69.1	212	2. Set the switch to Flash
28.1	213
69.1	214	3. Use below schedule to update:
	215
47.1	216	[[image:image-20230526105151-1.png]]
28.1	217
47.1	218	[[image:image-20230526105910-2.png]]
28.1	219
42.1	220	[[image:image-20230520100541-5.png\|\|height="535" width="799"]]
	221
	222
	223	= 4. FAQ =
	224
	225	== 4.1 How to recover if upgrade wrong file to bootloader? ==
	226
47.6	227
42.1	228	You can just upload the bootloader again.
	229
	230
	231	== 4.2 How to recover if upgrade wrong firmware via Dragino Sensor Manager Utility.exe? ==
	232
47.6	233
42.1	234	The UART upgrade via Dragino Sensor Manager Utility.exe is base on Dragino Bootloader. So if you are able to upgrade some file via this tool. It means the device has bootloder.
	235
	236
	237	The upgrade via Dragino Sensor Manager Utility is base on firmware level and won't effect the bootloader. If you upgrade a wrong firmware file, you can try below:
	238
	239	~1. UART upgrade via Dragino Sensor Manager Utility again to the correct version. The password should use the AT PIN for the wrong firmware. (This method is not 100% work, depends which wrong firmware you have upgraded)
	240
43.1	241	2. Use TremoProgrammer to update firmware. [[Insturction>>\|\|anchor="H4.3HowtouseTremoProgrammertoupdatefirmwareifthereisbootloaderinthedevice3F"]]
42.1	242
	243	3. Use [[OTA update>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]], this is base on Bootloader so it will work. Make you choose the correct frequency band (base on the firmware version in the sensor or use EU868 which is the default setting.)
	244
	245
	246	== 4.3 How to use TremoProgrammer to update firmware if there is bootloader in the device? ==
	247
47.6	248
42.1	249	Make sure your device already bootloader while use this update. Otherwise device won't be able to boot ( can be solve by upload a bootloader to the device).
	250
13.1	251	LoRaSTv4 Base hardware support UART update firmware. the UART connection is the same as AT Command connection, with the need for two extra action. See below for the steps:
	252
47.6	253	(% style="color:blue" %)Step1(%%): Set BOOT Switch to (% style="color:blue" %)PROG(%%) mode. PROG mode is for update firmware specially.
13.1	254
47.6	255	(% style="color:blue" %) Step2(%%): Press (% style="color:blue" %)Reset(%%) button, the module will then boot into program mode.
13.1	256
47.6	257	(% style="color:blue" %)Step3(%%): Use (% style="color:blue" %)TremoProgrammer(%%) to update the firmware to LoRaST v4.
13.1	258
47.6	259	(% style="color:blue" %)Step4(%%): Set BOOT Switch to (% style="color:blue" %)FLASH(%%) position. Press Reset button again and module will run the new software.
13.1	260
	261
47.6	262	Below is the method for how to update via (% style="color:blue" %)TremoProgrammer:
	263
13.1	264	1. Software download link: [[https:~~/~~/www.dropbox.com/sh/j0qyc7a9ejit7jk/AACtx2tK4gEv6YFXMIVUM4dLa?dl=0>>url:https://www.dropbox.com/sh/j0qyc7a9ejit7jk/AACtx2tK4gEv6YFXMIVUM4dLa?dl=0]]
	265
47.6	266	2. Run(% style="color:blue" %) TremoProgrammer.
13.1	267
47.6	268	3. Choose software and set the address to (% style="color:blue" %)0x0800D000. (% style="color:red" %)VERY IMPORTANT for this address.
13.1	269
47.6	270	4. Rember to set BOOT Switch to (% style="color:blue" %)FLASH(%%) after update
13.1	271
42.1	272	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/WebHome/image-20221224174341-4.png?width=374&height=471&rev=1.1\|\|alt="image-20221224174341-4.png" height="471" width="374"]]
47.6	273
70.1	274
67.1	275	== 4.4 How to troubleshoot incorrect password ==
	276
70.1	277
67.1	278	~1. Please use lowercase letters.
	279	2. You need to add line breaks when entering commands.
	280	3. Upgrade the firmware to display password firmware
	281
	282	Upgrade steps:
	283
	284	~ [[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART_Access_for_NB_ST_BC660K-GL/#H4.2UpdateFirmware28Assumethedevicealreadyhaveabootloader29]]
	285	Firmware location:
	286
	287	~ [[NB-IoT - Dropbox>>url:https://www.dropbox.com/sh/u0uzvvnn58yrie4/AACREHllkTe0rATD4ZOqddyga/NB-IoT?dl=0&preview=SET_NB_PWD.hex&subfolder_nav_tracking=1]]
	288
	289	After updating the firmware, run the firmware.
	290	Press the restart button and the password will be printed in the serial port output.
	291	Save the password and re-upgrade the firmware to the original firmware.
	292
	293	(% style="color:red" %)Note: When upgrading to the original firmware, you need to add the Bootloader firmware.
	294
	295	Bootloader Firmware location(Please use V1.3):
	296
	297	[[Bootloader - Dropbox>>url:https://www.dropbox.com/sh/u0uzvvnn58yrie4/AADUXfZ5jye4I5l1JH8HEALUa/LoRaWAN%20End%20Node/Bootloader/LoRa_Bootloader?dl=0&subfolder_nav_tracking=1]]
82.1	298
	299
	300
83.1	301	== 4.5 Why does the serial Assistant print ERROR: 104/ERROR~=104 when using the AT command? ==
82.1	302
	303
83.1	304	ERROR: 104/ERROR=104 usually indicates that there is a problem when communicating with a sensor via a USB-TTL device. This error can be due to a variety of reasons, such as communication parameter setting errors, hardware connection problems, etc.
82.1	305
	306	[[image:image-20241111093445-1.png\|\|height="468" width="699"]]
	307
	308	Refer to [[Section 2>>\|\|anchor="H2.UARTforATCommands"]] of this manual to correctly connect the USB-TTL to the device motherboard and set the communication parameters correctly.
	309
	310	[[image:image-20241111095114-2.png\|\|height="515" width="656"]]
	311
	312
	313

Wiki source code of UART Access for LoRa ST v4 base model

Applications

Navigation