Version 218.3 by Xiaoling on 2022/07/01 17:45
Show last authors
1 (% style="text-align:center" %)
2 [[image:1655774244188-589.png]]
3
4
5
6
7 (% _mstvisible="1" %)
8 (% _msthash="315238" _msttexthash="18964465" _mstvisible="3" %)**Table of Contents：**
9
10 {{toc/}}
11
12
13
14
15
16
17
18
19 = 1.  Introduction =
20
21
22 == 1.1  What is LHT52 Temperature & Humidity Sensor ==
23
24
25 (((
26 The Dragino LHT52 Temperature & Humidity sensor is a Long Range LoRaWAN Sensor. It includes a (% style="color:blue" %)**built-in Temperature & Humidity sensor** (%%)and has a USB Type-C sensor connector to connect to external sensors such as external Temperature Sensor.
27 )))
28
29 (((
30 LHT52 (% style="color:blue" %)**senses environment temperature and humidity**(%%) and send these values via long-range wireless LoRaWAN protocol. It targets professional wireless sensor network applications such as food service, smart metering, smart cities, building automation, and so on.
31 )))
32
33 (((
34 LHT52 supports(% style="color:blue" %)** 2 x AAA batteries **(%%)and works for a long time up to several years. Use can replace the batteries easily after they are finished.
35 )))
36
37 (((
38 LHT52 is fully compatible with LoRaWAN v1.0.3 protocol, it can work with standard LoRaWAN gateway.
39 )))
40
41 (((
42 LHT52 supports(% style="color:blue" %)** Datalog feature** (%%)to make sure users won't miss sensor data. It records sensor value for every uplink. These values can be retrieved by LoRaWAN server via downlink command.
43 )))
44
45 (((
46 LHT52 supports(% style="color:blue" %)** temperature alarm feature**(%%). It can uplink alarm in a short interval while temperature exceeds preset limits.
47 )))
48
49 (((
50 *Battery life depends how often to send data, please see [[battery analyzer>>||anchor="H4.2A0PowerConsumptionAnalyze"]].
51 )))
52
53 [[image:1655774519494-861.png]]
54
55
56 == 1.2  Features ==
57
58 * Wall Attachable.
59 * LoRaWAN v1.0.3 Class A protocol.
60 * Built-in Temperature & Humidity sensor
61 * Optional External Probe
62 * Frequency Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915
63 * AT Commands to change parameters
64 * Remote configure parameters via LoRaWAN Downlink
65 * Firmware upgradable via program port
66 * Support 2 x AAA LR03 batteries.
67 * Datalog feature
68 * IP Rating: IP52
69
70
71 == 1.3  Specification ==
72
73
74 **Built-in Temperature Sensor:**
75
76 * Resolution: 0.01 °C
77 * Accuracy Tolerance: Typ ±0.3 °C
78 * Long Term Drift: < 0.02 °C/yr
79 * Operating Range: -20 ~~ 50 °C
80
81 **Built-in Humidity Sensor:**
82
83 * Resolution: 0.1 %RH
84 * Accuracy Tolerance: Typ ±3 %RH
85 * Long Term Drift: < 0.02 °C/yr
86 * Operating Range: 0 ~~ 99.0 %RH(no Dew)
87
88
89 == 1.4  Power Consumption ==
90
91 LHT52 (without external sensor): Idle: 5uA, Transmit: max 110mA
92
93 LHT52 + External Temperature Probe (AS-01): Idle: 6uA, Transmit: max 110mA.
94
95
96
97 == 1.5  Storage & Operation Temperature ==
98
99 -20°C to +50°C
100
101
102
103 == 1.6  Applications ==
104
105 * Smart Buildings & Home Automation
106 * Logistics and Supply Chain Management
107 * Smart Metering
108 * Smart Agriculture
109 * Smart Cities
110 * Smart Factory
111
112
113 = 2.  Operation Mode =
114
115 == 2.1  How it work? ==
116
117 Each LHT52 is shipped with a worldwide unique set of LoRaWAN OTAA keys. To use LHT52 in a LoRaWAN network, user needs to input the OTAA keys in LoRaWAN network server. After this, if LHT52 is under this LoRaWAN network coverage, LHT52 can join the LoRaWAN network and start to transmit sensor data. The default period for each uplink is** 20 minutes**.
118
119
120 == 2.2  How to Activate LHT52? ==
121
122 (% style="color:red" %)** 1.  Open enclosure from below position.**
123
124 [[image:image-20220621093835-1.png]]
125
126
127 (% style="color:red" %)** 2.  Insert 2 x AAA LR03 batteries.**
128
129 [[image:image-20220621093835-2.png]]
130
131
132 (% style="color:red" %)** 3.  Press the reset button to activate device.**
133
134 [[image:image-20220621093835-3.png]]
135
136
137 User can check [[LED Status>>||anchor="H2.8LEDIndicator"]] to know the working state of LHT52.
138
139
140
141 == 2.3  Example to join LoRaWAN network ==
142
143 This section shows an example for how to join the [[TheThingsNetwork>>url:https://www.thethingsnetwork.org/]] LoRaWAN IoT server. Usages with other LoRaWAN IoT servers are of similar procedure.
144
145 (% _mstvisible="1" class="wikigeneratedid" %)
146 [[image:1655775912928-657.png]]
147
148 Assume the DLOS8 is already set to connect to [[TTN V3 network >>url:https://eu1.cloud.thethings.network/]]. We need to add the LHT52 device in TTN V3 portal. 
149
150
151 (% style="color:blue" %)**Step 1**(%%):  Create a device in TTN V3 with the OTAA keys from LHT52.
152
153 Each LHT52 is shipped with a sticker with the default DEV EUI as below:
154
155
156 [[image:image-20220617150003-1.jpeg]]
157
158
159 Enter these keys in the LoRaWAN Server portal. Below is TTN V3 screen shot:
160
161 Add APP EUI in the application.
162
163 choose to create the device manually.
164
165 Add APP KEY and DEV EUI
166
167
168 [[image:image-20220522232916-3.png||_mstalt="430495" _mstvisible="3"]]
169
170 [[image:1655776122894-257.png]]
171
172
173
174 **Default mode OTAA**
175
176
177 [[image:1655776241177-240.png]]
178
179
180
181 (% style="color:blue" %)**Step 2**(%%):  Use ACT button to activate LHT52 and it will auto join to the TTN V3 network. After join success, it will start to upload sensor data to TTN V3 and user can see in the panel.
182
183 [[image:image-20220621095134-4.png]]
184
185
186
187 == 2.4  Uplink Payload ==
188
189 Uplink payloads include two types: Valid Sensor Value and other status / control command.
190
191 * Valid Sensor Value: Use FPORT=2
192 * Other control command: Use FPORT other than 2.
193
194
195 === 2.4.1  Uplink FPORT~=5, Device Status ===
196
197 Uplink the device configures with FPORT=5. Once LHT52 Joined the network, it will uplink this message to the server. After first uplink, LHT52 will uplink Device Status every 12 hours.
198
199 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:462px" %)
200 |=(% style="width: 99px;" %)**Size (bytes)**|=(% style="width: 62px;" %)**1**|=(% style="width: 80px;" %)**2**|=(% style="width: 82px;" %)**1**|=(% style="width: 85px;" %)**1**|=(% style="width: 46px;" %)**2**
201 |(% style="width:99px" %)**Value**|(% style="width:62px" %)Sensor Model|(% style="width:80px" %)Firmware Version|(% style="width:82px" %)Frequency Band|(% style="width:85px" %)Sub-band|(% style="width:46px" %)BAT
202
203 [[image:image-20220621100550-5.png]]
204
205 Example Payload (FPort=5):  [[image:image-20220621105116-11.png]]
206
207
208 (% style="color:#4472c4" %)**Sensor Model**(%%): For LHT52, this value is 0x09.
209
210 (% style="color:#4472c4" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version.
211
212 (% style="color:#4472c4" %)**Frequency Band**:
213
214 *0x01: EU868
215
216 *0x02: US915
217
218 *0x03: IN865
219
220 *0x04: AU915
221
222 *0x05: KZ865
223
224 *0x06: RU864
225
226 *0x07: AS923
227
228 *0x08: AS923-1
229
230 *0x09: AS923-2
231
232 *0x0a: AS923-3
233
234
235 (% style="color:#4472c4" %)**Sub-Band**(%%): value 0x00 ~~ 0x08(only for CN470, AU915,US915. Others are0x00)
236
237 (% style="color:#4472c4" %)**BAT**(%%): shows the battery voltage for LHT52.
238
239 Ex1: 0x0B3A = 2874mV
240
241
242 Use can also get the Device Status uplink through the downlink command:
243
244 (% style="color:#4472c4" %)**Downlink:  0x2301**
245
246
247 [[image:image-20220621100550-6.png||height="504" width="1491"]]
248
249
250
251 === 2.4.2  Uplink FPORT~=2, Real time sensor value ===
252
253 LHT52 will send this uplink after Device Status uplink once join LoRaWAN network successfully. And it will periodically send this uplink. Default interval is 20 minutes and [[can be changed>>||anchor="H3.1A0DownlinkCommandSet"]].
254
255 Uplink uses FPORT=2 and every 20 minutes send one uplink by default.
256
257 (% _mstvisible="1" border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:426px" %)
258 (% _mstvisible="3" %)|=(% _mstvisible="4" style="width: 97px;" %)(% _mstvisible="5" %)
259 (((
260 (% _mstvisible="6" %)
261 (% _msthash="1817478" _msttexthash="161122" _mstvisible="8" %)**Size(bytes)**
262 )))|=(% _mstvisible="4" style="width: 39px;" %)(% _mstvisible="5" %)
263 (((
264 (% _mstvisible="6" %)
265 (% _msthash="1817479" _msttexthash="4550" _mstvisible="8" %)**2**
266 )))|=(% _mstvisible="4" style="width: 100px;" %)(% _mstvisible="5" %)
267 (((
268 (% _mstvisible="6" %)
269 (% _msthash="1817480" _msttexthash="4550" _mstvisible="8" %)**2**
270 )))|=(% _mstvisible="4" style="width: 77px;" %)(% _mstvisible="5" %)
271 (((
272 (% _mstvisible="6" %)
273 (% _msthash="1817481" _msttexthash="4550" _mstvisible="8" %)**2**
274 )))|=(% _mstvisible="4" style="width: 47px;" %)(% _mstvisible="5" %)
275 (((
276 (% _mstvisible="6" %)
277 (% _msthash="1817482" _msttexthash="4459" _mstvisible="8" %)**1**
278 )))|=(% _mstvisible="4" style="width: 51px;" %)(% _mstvisible="5" %)
279 (((
280 (% _mstvisible="6" %)
281 (% _msthash="1817483" _msttexthash="4732" _mstvisible="8" %)**4**
282 )))
283 (% _mstvisible="3" %)|(% _mstvisible="4" style="width:97px" %)(% _mstvisible="5" %)
284 (((
285 (% _mstvisible="6" %)
286 (% _msthash="1817484" _msttexthash="60203" _mstvisible="8" %)**Value**
287 )))|(% _mstvisible="4" style="width:39px" %)(% _mstvisible="5" %)
288 (((
289 (% _mstvisible="6" %)
290 [[Temperature>>||anchor="HTemperature26ExternalTemperature:" _msthash="2224742" _msttexthash="405769" _mstvisible="8"]]
291 )))|(% _mstvisible="4" style="width:100px" %)(% _mstvisible="5" %)
292 (((
293 (% _mstvisible="6" %)
294 (((
295 (% _mstvisible="7" %)
296 [[Humidity>>||anchor="HHumidity:" _msthash="2224744" _msttexthash="117429" _mstvisible="8"]]
297
298 (% _mstvisible="7" %)
299
300 )))
301 )))|(% _mstvisible="4" style="width:77px" %)(% _mstvisible="5" %)
302 (((
303 (% _mstvisible="6" %)
304 (((
305 (% _mstvisible="7" %)
306 [[External Temperature>>||anchor="HTemperature26ExternalTemperature:" _msthash="2224742" _msttexthash="405769" _mstvisible="8"]]
307 )))
308 )))|(% _mstvisible="4" style="width:47px" %)(% _mstvisible="5" %)
309 (((
310 (% _mstvisible="6" %)
311 [[Ext>>||anchor="HExtension23" _msthash="1817486" _msttexthash="32331" _mstvisible="7"]] #
312 )))|(% _mstvisible="4" style="width:51px" %)(((
313 [[Unix TimeStamp>>||anchor="H2.6.1A0UnixTimeStamp" _msthash="1817487" _msttexthash="116545" _mstvisible="7"]]
314 )))
315
316 **Temperature:**
317
318 [[image:image-20220621101526-7.png]]
319
320 Example Payload (FPort=2):  (% style="background-color:yellow" %)**08 CD 02 20 7F FF 01 61 CD 4E DD**
321
322
323 ==== (% style="color:blue" %)**Temperature & External Temperature:**(%%) ====
324
325 * Example1:  0x08CD/100=22.53℃
326 * Example2:  (0xF5C6-65536)/100=-26.18℃
327
328
329 ==== (% style="color:blue" %)**Humidity:**(%%) ====
330
331 * Humidity:    0x0220/10=54.4%
332
333
334 ==== (% style="color:blue" %)**Extension #**(%%) ====
335
336 Bytes for External Sensor:
337
338 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:310px" %)
339 |=(% style="width: 103px;" %)**EXT # Value**|=(% style="width: 203px;" %)**External Sensor Probe**
340 |(% style="width:103px" %)0x01|(% style="width:203px" %)Sensor AS-01, Temperature
341
342
343 === 2.4.3  Uplink FPORT~=3, Datalog sensor value ===
344
345 LHT52 stores sensor value and user can retrieve these history value via downlink command. The Datalog sensor value are sent via FPORT=3.
346
347 [[image:image-20220621101659-8.png||height="515" width="1381"]](% style="display:none" %)
348
349
350 * Each data entry is 11 bytes, to save airtime and battery, LHT52 will send max bytes according to the current DR and Frequency bands.(% style="display:none" %)
351
352 For example, in US915 band, the max payload for different DR is:
353
354 1. DR0: max is 11 bytes so one entry of data
355 1. DR1: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
356 1. DR2: total payload includes 11 entries of data
357 1. DR3: total payload includes 22 entries of data.
358
359 (% style="color:red" %)**Notice**: LHT52 will save 178 set of history data, If device doesn't have any data in the polling time. Device will uplink 11 bytes of 0.
360
361 See more info about the [[Datalog feature>>||anchor="H2.6A0DatalogFeature"]].
362
363
364
365 === 2.4.4  Uplink FPORT~=4, DS18B20 ID ===
366
367 User can get external DS18B20 ID through the downlink command.
368
369 Downlink:  0x2302
370
371 [[image:image-20220621101853-9.png||height="529" width="1366"]]
372
373 Example Payload (FPort=4):  (% style="color:#037691" %)**28 86 63 B2 00 00 00 9F**
374
375 The External DS18B20 ID is 0x28 86 63 B2 00 00 00 9F
376
377
378
379 === 2.4.5  Decoder in TTN V3 ===
380
381 In LoRaWAN protocol, the uplink payload is HEX format, user need to add a payload formatter/decoder in LoRaWAN Server to get human friendly string.
382
383 In TTN , add formatter as below:
384
385 [[image:image-20220621102026-10.png]]
386
387 (((
388 Please check the decoder from this link:
389 )))
390
391 (((
392 [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LHT52/Decoder/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LHT52/Decoder/]] 
393 )))
394
395 (% style="display:none" %) (%%)
396
397 (% style="display:none" %) (%%)
398
399 == 2.5 Show data on Datacake ==
400
401 (((
402 Datacake IoT platform provides a human friendly interface to show the sensor data in charts, once we have sensor data in TTN V3, we can use Datacake to connect to TTN V3 and see the data in Datacake. Below are the steps:
403 )))
404
405 (((
406
407 )))
408
409 (((
410 (% style="color:blue" %)**Step 1**(%%):  Be sure that your device is programmed and properly connected to the LoRaWAN network.
411 )))
412
413 (((
414 (% style="color:blue" %)**Step 2**(%%):  Configure your Application to forward data to Datacake you will need to add integration. Go to TTN V3 Console ~-~-> Applications ~-~-> Integrations ~-~-> Add Integrations.
415 )))
416
417 (((
418 ~1. Add Datacake:
419 )))
420
421 (((
422 2. Select default key as Access Key:
423 )))
424
425 (((
426 3. In Datacake console ([[https:~~/~~/datacake.co/>>url:https://datacake.co/]]) , add LHT52:
427 )))
428
429 (((
430 Please refer to the figure below
431 )))
432
433
434 [[image:image-20220621112422-1.png]]
435
436
437 Log in to DATACAKE, copy the API under the account
438
439 [[image:image-20220621112422-2.png]]
440
441
442 [[image:image-20220621112422-3.png]]
443
444
445
446 [[image:image-20220621112422-4.png||height="741" width="1237"]]
447
448
449 [[image:image-20220621112422-5.png||height="314" width="1226"]]
450
451
452 [[image:image-20220621112422-6.png]]
453
454
455 [[image:image-20220621112422-7.png]]
456
457 [[image:image-20220621112422-8.png]]
458
459
460 [[image:image-20220621112422-9.png||height="338" width="1211"]]
461
462
463 [[image:image-20220621112422-10.png||height="372" width="1215"]]
464
465
466 Copy and paste the [[TTN decoder>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LHT52/Decoder/]] here and save
467
468 [[image:image-20220621112422-11.png||height="575" width="1215"]]
469
470
471 Visual widgets please read the DATACAKE documentation
472
473 [[image:image-20220622154805-1.png]]
474
475
476
477 == 2.6  Datalog Feature ==
478
479 (% _msthash="315262" _msttexthash="32283004" _mstvisible="1" %)
480 When user want to retrieve sensor value, he can send a poll command from the IoT platform to ask sensor to send value in the required time slot.
481
482
483 === 2.6.1  Unix TimeStamp ===
484
485 Unix TimeStamp shows the sampling time of uplink payload. format base on
486
487 [[image:image-20220523001219-11.png||_mstalt="450450" _mstvisible="3" height="97" width="627"]]
488
489 User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/||_mstvisible="3"]] :
490
491 For example: if the Unix Timestamp we got is hex 0x60137afd, we can convert it to Decimal: 1611889405. and then convert to the time: 2021 – Jan ~-~- 29 Friday 03:03:25 (GMT)
492
493
494 [[image:1655782409139-256.png]]
495
496
497
498 === 2.6.2  Poll sensor value ===
499
500 (((
501 User can poll sensor value based on timestamps from the server. Below is the downlink command.
502 )))
503
504 (((
505 Timestamp start and Timestamp end use Unix TimeStamp format as mentioned above. Devices will reply with all data log during this time period, use the uplink interval.
506 )))
507
508 (((
509 For example, downlink command [[image:image-20220621113526-13.png]] (% _mstvisible="3" style="display:none" %)
510 )))
511
512 (((
513 Is to check 2020/12/1 07:40:00 to 2020/12/1 08:40:00's data
514 )))
515
516 (((
517 Uplink Internal =5s，means LHT52 will send one packet every 5s. range 5~~255s.
518 )))
519
520
521
522 === 2.6.3  Datalog Uplink payload ===
523
524 See [[Uplink FPORT=3, Datalog sensor value>>||anchor="H2.4.3A0UplinkFPORT3D32CDatalogsensorvalue"]]
525
526 (% style="display:none" %) (%%)
527
528 (% style="display:none" %) (%%)
529
530 == 2.7  Alarm Mode ==
531
532 (((
533 When device is in Alarm mode, it will check the built-in sensor temperature in a short interval. If the temperature exceeds the pre-configure range, it will send an uplink immediately.
534 )))
535
536 (((
537 The alarm mode can be modified by AT command or downlink, Alarm mode is disabled by default.
538 )))
539
540 (((
541 If you need to enable the Alarm mode, please refer to the following
542 )))
543
544 (((
545 (% style="color:red" %)**Note: Alarm mode will increase the power consumption, we recommend extending the normal uplink time (20 minutes default) when enable this feature.**
546 )))
547
548 (((
549
550 )))
551
552 (((
553 (% style="color:blue" %)**AT Commands for Alarm mode:**
554 )))
555
556 (((
557 (% style="color:#037691" %)**AT+WMOD=1**(%%)**: ** Enable/Disable Alarm Mode. (0:Disable, 1: Enable),need to reset the node to take effect
558 )))
559
560 (((
561 (% style="color:#037691" %)**AT+CITEMP=1**(%%)**: ** The interval to check temperature for Alarm. (Unit: minute)
562 )))
563
564 (((
565 (% style="color:#037691" %)**AT+ARTEMP=-40,125**(%%)**:   ** Set the normal temperature range from -40°C to 125°C
566 )))
567
568 (((
569 Suppose you want to set the normal temperature from 15°C to 50°C, and turn on the alarm mode, and check the temperature every 2 minutes. Please refer to the following
570 )))
571
572 [[image:image-20220621114109-14.png]]
573
574 [[image:image-20220621114109-15.png]]
575
576
577 (((
578 Modification via downlink,Take TTN_V3 as an example((% style="color:red" %)downlink commands, please refer to the downlink command set for details(%%))
579 )))
580
581 (((
582 In order to ensure that the node is indeed modified by downlink, I reset the node to factory settings first.
583 )))
584
585 [[image:image-20220621114109-16.png]]
586
587
588 [[image:image-20220621114109-17.png||height="583" width="1274"]]
589
590 [[image:image-20220621114109-18.png]]
591
592
593 Or use a downlink directly: AA010002000F0032 ([[See command info>>||anchor="H3.1A0DownlinkCommandSet"]])
594
595 [[image:image-20220621114109-19.png||height="178" width="1292"]]
596
597
598
599 == 2.8 LED Indicator ==
600
601 (((
602 The LHT52 has a triple color LED which for easy showing different stage.
603 )))
604
605
606 (((
607 (% style="color:#037691" %)**In a normal working state**:
608 )))
609
610 * When the node is restarted, (% style="color:green" %)GREEN, (% style="color:red" %)RED(%%) and (% style="color:blue" %)BLUE(%%) are sequentially lit.
611
612 * During OTAA Join:
613 ** **For each Join Request uplink:** the (% style="color:green" %)GREEN LED (%%)will blink once.
614 ** **Once Join Successful:** the (% style="color:green" %)GREEN LED(%%) will be solid on for 5 seconds.
615
616 * After joined, for each uplink, the (% style="color:blue" %)BLUE LED(%%) or (% style="color:green" %)GREEN LED (%%)will blink once.
617 ** (% style="color:blue" %)BLUE LED(%%) when external sensor is connected
618 ** (% style="color:green" %)GREEN LED(%%) when external sensor is not connected
619
620 * For each success downlink, the (% style="color:purple" %)PURPLE LED(%%) will blink once
621
622 (((
623 (% style="color:#037691" %)**In AT Command Mode:**
624 )))
625
626 (((
627 If user use console cable to send AT Command to LHT52, the (% style="color:red" %)**RED LED**(%%) will always on until:
628 )))
629
630 * Power off/on LHT52
631 * Press reset button of LHT52.
632 * Send an AT Command: AT+CLPM=1
633
634 (% style="display:none" %) (%%)
635
636
637 == 2.9 Button ==
638
639 Press the button LHT52 will reset and join network again.
640
641
642
643 = 3.  Configure LHT52 via AT command or LoRaWAN downlink =
644
645 Use can configure LHT52 via AT Command or LoRaWAN Downlink.
646
647 * AT Command Connection: See [[FAQ>>||anchor="H6.FAQ"]].
648
649 * LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>doc:Main.WebHome]]
650
651 There are two kinds of commands to configure LHT52, they are:
652
653 * (% style="color:#4f81bd" %)**General Commands:**
654
655 These commands are to configure:
656
657 * General system settings like: uplink interval.
658
659 * LoRaWAN protocol & radio-related commands.
660
661 They are the same for all Dragino Devices which supports DLWS-005 LoRaWAN Stack(Note~*~*). These commands can be found on the wiki: [[End Device Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
662
663
664 * (% style="color:#4f81bd" %)**Commands special design for LHT52**
665
666 These commands are only valid for LHT52, as below:
667
668
669 == 3.1  Downlink Command Set ==
670
671
672 (% border="1" cellpadding="0" cellspacing="10" style="background-color:#ffffcc; color:green; width:500px" %)
673 |=(% style="width: 100px;" %)**Command Example**|=(% style="width: 150px;" %)**Function**|=(% style="width: 100px;" %)**Response**|=(% style="width: 150px;" %)**Downlink**
674 |(% style="width:161px" %)AT+TDC=?|(% style="width:138px" %)View current TDC time|(% style="width:243px" %)(((
675 1200000
676
677
678 OK
679 )))|(% style="width:1001px" %)Default 1200000(ms)
680 |(% style="width:161px" %)AT+TDC=300000|(% style="width:138px" %)Set TDC time|(% style="width:243px" %)OK|(% style="width:1001px" %)(((
681 0X0100012C:
682
683 01:fixed command
684
685 00012C:0X00012C=300(seconds)
686 )))
687 |(% style="width:161px" %)ATZ|(% style="width:138px" %)Reset node|(% style="width:243px" %) |(% style="width:1001px" %)0x04FF
688 |(% style="width:161px" %)AT+FDR|(% style="width:138px" %)Restore factory settings|(% style="width:243px" %) |(% style="width:1001px" %)0X04FE
689 |(% style="width:161px" %)AT+CFM=?|(% style="width:138px" %)View the current confirmation mode status|(% style="width:243px" %)(((
690 0
691
692 OK
693 )))|(% style="width:1001px" %)Default 0
694 |(% style="width:161px" %)AT+CFM=1|(% style="width:138px" %)Turn on confirmation mode|(% style="width:243px" %)OK|(% style="width:1001px" %)(((
695 0x0500:close
696
697 0x0501:open
698
699 05:fixed command
700 )))
701 |(% style="width:161px" %)AT+CHE=?|(% style="width:138px" %)View the current sub-band select 0-7, the default is 0|(% style="width:243px" %)(((
702 0
703
704 OK
705 )))|(% style="width:1001px" %)Default 0
706 |(% style="width:161px" %)AT+CHE=2|(% style="width:138px" %)(((
707 Set subband to 2
708
709 (CN470,US915,AU915)
710 )))|(% style="width:243px" %)(((
711 Attention:Take effect after ATZ
712
713 OK
714
715
716 )))|(% style="width:1001px" %)(((
717 0X0702:
718
719 07:fixed command
720
721 02:Select subband 2
722 )))
723 |(% style="width:161px" %)AT+WMOD=?|(% style="width:138px" %)View the current alarm mode status|(% style="width:243px" %)(((
724 0
725
726 OK
727 )))|(% style="width:1001px" %)Default 0
728 |(% style="width:161px" %)AT+WMOD=1|(% style="width:138px" %)Turn on alarm mode|(% style="width:243px" %)(((
729 Attention:Take effect after ATZ
730
731 OK
732
733
734 )))|(% style="width:1001px" %)(((
735 0xA501:open
736
737 0XA500:close
738
739 A5:fixed command
740
741
742 )))
743 |(% style="width:161px" %)AT+CITEMP=?|(% style="width:138px" %)View the current temperature detection time interval|(% style="width:243px" %)(((
744 1
745
746 OK
747 )))|(% style="width:1001px" %)Default 1(min)
748 |(% style="width:161px" %)AT+CITEMP=2|(% style="width:138px" %)Set the temperature detection time interval to 2min|(% style="width:243px" %)OK|(% style="width:1001px" %)(((
749 0XA70002
750
751 A7:fixed command
752
753 0002:0X0002=2(min)
754 )))
755 |(% style="width:161px" %)AT+NJM=?|(% style="width:138px" %)Check the current network connection method|(% style="width:243px" %)(((
756 1
757
758 OK
759 )))|(% style="width:1001px" %)Default 1
760 |(% style="width:161px" %)AT+NJM=0|(% style="width:138px" %)Change the network connection method to ABP|(% style="width:243px" %)(((
761 Attention:Take effect after ATZ
762
763 OK
764
765
766 )))|(% style="width:1001px" %)(((
767 0X2000:ABP
768
769 0x2001:OTAA
770
771 20:fixed command
772
773
774 )))
775 |(% style="width:161px" %)AT+RPL=?|(% style="width:138px" %)View current RPL settings|(% style="width:243px" %)(((
776 0
777
778 OK
779 )))|(% style="width:1001px" %)Default 0
780 |(% style="width:161px" %)AT+RPL=1|(% style="width:138px" %)set RPL=1|(% style="width:243px" %)OK|(% style="width:1001px" %)(((
781 0x2101:
782
783 21:fixed command
784
785 01:for details, check wiki
786 )))
787 |(% style="width:161px" %)AT+ADR=?|(% style="width:138px" %)View current ADR status|(% style="width:243px" %)(((
788 1
789
790 OK
791 )))|(% style="width:1001px" %)Default 0
792 |(% style="width:161px" %)AT+ADR=0|(% style="width:138px" %)Set the ADR state to off|(% style="width:243px" %)OK|(% style="width:1001px" %)(((
793 0x2200:close
794
795 0x2201:open
796
797 22:fixed command
798 )))
799 |(% style="width:161px" %)AT+DR=?|(% style="width:138px" %)View the current DR settings|(% style="width:243px" %)OK|(% style="width:1001px" %)
800 |(% style="width:161px" %)AT+DR=1|(% style="width:138px" %)(((
801 set DR to 1
802
803 It takes effect only when ADR=0
804 )))|(% style="width:243px" %)OK|(% style="width:1001px" %)(((
805 0X22000101:
806
807 00:ADR=0
808
809 01:DR=1
810
811 01:TXP=1
812
813 22:fixed command
814 )))
815 |(% style="width:161px" %)AT+TXP=?|(% style="width:138px" %)View the current TXP|(% style="width:243px" %)OK|(% style="width:1001px" %)
816 |(% style="width:161px" %)AT+TXP=1|(% style="width:138px" %)(((
817 set TXP to 1
818
819 It takes effect only when ADR=0
820 )))|(% style="width:243px" %)OK|(% style="width:1001px" %)(((
821 0X22000101:
822
823 00:ADR=0
824
825 01:DR=1
826
827 01:TXP=1
828
829 22:fixed command
830 )))
831 |(% style="width:161px" %) |(% style="width:138px" %)Upload node configuration or DS18B20 ID|(% style="width:243px" %) |(% style="width:1001px" %)(((
832 0X2301:Upload node configuration
833
834 0x2302:Upload DS18B20 ID
835
836 23:fixed command
837 )))
838 |(% style="width:161px" %)AT+DWELL=?|(% style="width:138px" %)Check the high-rate upload settings|(% style="width:243px" %)(((
839 1
840
841 OK
842 )))|(% style="width:1001px" %)Default 1
843 |(% style="width:161px" %)AT+DWELL=1|(% style="width:138px" %)(((
844 Set high rate upload
845
846 (AS923,AU915)
847 )))|(% style="width:243px" %)(((
848 Attention:Take effect after ATZ
849
850 OK
851
852
853 )))|(% style="width:1001px" %)(((
854 0x2501:close
855
856 0x2500:open
857
858 25:fixed command
859
860 for details, check wiki
861 )))
862 |(% style="width:161px" %)AT+RJTDC=?|(% style="width:138px" %)View current RJTDC set time|(% style="width:243px" %)(((
863 20
864
865 OK
866 )))|(% style="width:1001px" %)Default 20(min)
867 |(% style="width:161px" %)AT+RJTDC=10|(% style="width:138px" %)Set RJTDC time interval|(% style="width:243px" %)OK|(% style="width:1001px" %)(((
868 0X26000A:
869
870 26:fixed command
871
872 000A:0X000A=10(min)
873
874 for details, check wiki
875 )))
876 |(% style="width:161px" %) |(% style="width:138px" %)Retrieve stored data for a specified period of time|(% style="width:243px" %) |(% style="width:1001px" %)(((
877 0X3161DE7C7061DE8A800A:
878
879 31:fixed command
880
881 61DE7C70:0X61DE7C70=2022/1/12 15:00:00
882
883 61DE8A80:0X61DE8A80=2022/1/12 16:00:00
884
885 0A:0X0A=10(second)
886
887 View details 2.6.2
888 )))
889 |(% style="width:161px" %)AT+DDETECT=?|(% style="width:138px" %)View the current DDETECT setting status and time|(% style="width:243px" %)(((
890 0,1440
891
892 OK
893 )))|(% style="width:1001px" %)Default 0,1440(min)
894 |(% style="width:161px" %)AT+DDETECT=1,1440|(% style="width:138px" %)(((
895 Set DDETECT setting status and time
896
897 ((% style="color:red" %)When the node does not receive the downlink packet within the set time, it will re-enter the network(%%))
898 )))|(% style="width:243px" %)OK|(% style="width:1001px" %)(((
899 0X320005A0:close
900
901 0X320105A0:open
902
903 32:fixed command
904
905 05A0:0X05A0=1440(min)
906 )))
907 |(% style="width:161px" %) |(% style="width:138px" %)(((
908 Downlink Modification Alarm Mode
909
910 (AT+WMOD,AT+CITEMP,AT+ARTEMP)
911 )))|(% style="width:243px" %) |(% style="width:1001px" %)(((
912 0XAA010002000F00032:
913
914 AA:fixed command
915
916 01:0X01=1(AT+MOD)
917
918 0002:0X0002=2(AT+CITEMP)
919
920 000F:0X000F=15(AT+ARTEMP)
921
922 0032:0X0032=50(AT+ARTEMP)
923 )))
924
925
926 == 3.2  Set Password ==
927
928 Feature: Set device password, max 9 digits.
929
930 (% style="color:#4f81bd" %)**AT Command: AT+PWORD**
931
932 [[image:image-20220523151052-5.png||_mstalt="428623" _mstvisible="3"]]
933
934
935 (% style="color:#4f81bd" %)**Downlink Command:**
936
937 No downlink command for this feature.
938
939
940
941 = 4.  Battery & How to replace =
942
943 == 4.1  Battery Type and replace ==
944
945 LHT52 uses 2 x AAA LR03(1.5v) batteries. If the batteries running low (shows 2.1v in the platform). User can buy generic AAA battery and replace it.
946
947 (% style="color:red" %)**Note: **
948
949 1.  The LHT52 doesn't have any screw, use can use nail to open it by the middle.
950
951 [[image:image-20220621143535-5.png]]
952
953
954 2.  Make sure the direction is correct when install the AAA batteries.
955
956 [[image:image-20220621143535-6.png]]
957
958
959
960 == 4.2  Power Consumption Analyze ==
961
962 Dragino battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval.
963
964 Instruction to use as below:
965
966 (% style="color:blue" %)**Step 1**(%%):  Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from:
967
968 [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]]
969
970
971 (% style="color:blue" %)**Step 2**(%%):  (% style="display:none" %) (%%)Open it and choose
972
973 * Product Model
974 * Uplink Interval
975 * Working Mode
976
977 And the Life expectation in difference case will be shown on the right.
978
979 [[image:image-20220621143643-7.png||height="429" width="1326"]]
980
981
982
983 = 5.  Sensors and Accessories =
984
985 == 5.1  Temperature Probe (AS-01) ==
986
987 External Temperature Probe base on DS18B20. (note: Default Package doesn't include AS-01)
988
989 [[image:image-20220621141939-4.png||height="315" width="279"]] [[image:image-20220621141546-2.png||height="308" width="205"]](% style="display:none" %)
990
991
992 **External Temperature Probe (AS-01):(% style="display:none" %) (%%)**
993
994 * Resolution: 0.0625 °C
995 * ±0.5°C accuracy from -10°C to +85°C
996 * ±2°C accuracy from -55°C to +125°C
997 * Operating Range: -55 °C ~~ 125 °C
998 * Cable Length: 2 meters
999
1000
1001 == 5.2  Program Converter (AS-02) ==
1002
1003 AS-02 is an optional accessory, it is USB Type-C converter. AS-02 provide below feature:
1004
1005 1. Access AT console of LHT52 when used with USB-TTL adapter. [[See this link>>||anchor="H6.1HowtouseATCommandtoconfigureLHT52"]].
1006 1. Update firmware to LHT52 when used with DAP-Link adapter.  [[See this link>>doc:Main.Firmware Upgrade Instruction.WebHome||anchor="H2.3LHT52"]].
1007
1008 [[image:image-20220621141724-3.png]]
1009
1010
1011
1012 = 6. FAQ =
1013
1014 == 6.1 How to use AT Command to configure LHT52 ==
1015
1016 LHT52 supports AT Command set. User can use a USB to TTL adapter plus the Program Cable to connect to LHT52 for using AT command, as below.
1017
1018 [[image:image-20220621144150-8.png||height="537" width="724"]]
1019
1020
1021 **Connection:**
1022
1023 * (% style="background-color:yellow" %)USB to TTL GND <~-~-> Program Converter GND pin
1024 * (% style="background-color:yellow" %)USB to TTL RXD  <~-~-> Program Converter D+ pin
1025 * (% style="background-color:yellow" %)USB to TTL TXD  <~-~-> Program Converter A11 pin
1026
1027 It is also possible to connect using DAPLink
1028
1029 [[image:image-20220621144235-9.png||height="485" width="729"]]
1030
1031 (((
1032 **Connection:**
1033 )))
1034
1035 * (((
1036 (% style="background-color:yellow" %)USB to DAP-LINK GND <~-~-> Program Converter GND pin
1037 )))
1038 * (((
1039 (% style="background-color:yellow" %)USB to DAP-LINK RXD  <~-~-> Program Converter D+ pin
1040 )))
1041 * (((
1042 (% style="background-color:yellow" %)USB to DAP-LINK TXD  <~-~-> Program Converter A11 pin
1043 )))
1044
1045 (((
1046
1047
1048 In PC, User needs to set **serial tool**(such as [[putty>>url:https://www.chiark.greenend.org.uk/~~sgtatham/putty/latest.html]], SecureCRT) baud rate to (% style="color:green" %)**115200**(%%) to access to access serial console for LHT52. The AT commands are disable by default and need to enter password (default:(% style="color:green" %)**123456**(%%)) to active it. Timeout to input AT Command is 5 min, after 5-minute, user need to input password again.
1049 )))
1050
1051 (((
1052 Input password and ATZ to activate LHT52,As shown below:
1053 )))
1054
1055
1056 [[image:image-20220621144235-10.png]]
1057
1058
1059
1060 == 6.2  AT Command and Downlink ==
1061
1062 (((
1063 Sending ATZ will reboot the node
1064 )))
1065
1066 (((
1067 Sending AT+FDR will restore the node to factory settings
1068 )))
1069
1070 (((
1071 Get the node's AT command setting by sending AT+CFG
1072 )))
1073
1074 (((
1075
1076 )))
1077
1078 (((
1079 **Example：**                                           
1080 )))
1081
1082 (((
1083 AT+VER=EU868 v1.0
1084 )))
1085
1086 (((
1087 AT+NJM=1          
1088 )))
1089
1090 (((
1091 AT+DEUI=25 32 12 45 65 26 12 35
1092 )))
1093
1094 (((
1095 AT+APPEUI=25 32 12 45 65 26 32 16
1096 )))
1097
1098 (((
1099 AT+APPKEY=25 32 12 45 65 26 32 16 89 48 85 65 45 87 89 55
1100 )))
1101
1102 (((
1103 AT+DADDR=00 00 00 00
1104 )))
1105
1106 (((
1107 AT+APPSKEY=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
1108 )))
1109
1110 (((
1111 AT+NWKSKEY=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
1112 )))
1113
1114 (((
1115 AT+NWKID=00 00 00 13
1116 )))
1117
1118 (((
1119 AT+ADR=1
1120 )))
1121
1122 (((
1123 AT+DR=5
1124 )))
1125
1126 (((
1127 AT+TXP=1
1128 )))
1129
1130 (((
1131 AT+CHS=0
1132 )))
1133
1134 (((
1135 AT+CLASS=A
1136 )))
1137
1138 (((
1139 AT+CFM=0
1140 )))
1141
1142 (((
1143 AT+JN1DL=5000
1144 )))
1145
1146 (((
1147 AT+JN2DL=6000
1148 )))
1149
1150 (((
1151 AT+RX1DL=5000
1152 )))
1153
1154 (((
1155 AT+RX2DL=6000
1156 )))
1157
1158 (((
1159 AT+RX1WTO=24
1160 )))
1161
1162 (((
1163 AT+RX2WTO=6
1164 )))
1165
1166 (((
1167 AT+RX2FQ=869525000
1168 )))
1169
1170 (((
1171 AT+RX2DR=0
1172 )))
1173
1174 (((
1175 AT+RPL=0
1176 )))
1177
1178 (((
1179 AT+FCU=6
1180 )))
1181
1182 (((
1183 AT+FCD=0
1184 )))
1185
1186 (((
1187 AT+CFS=0
1188 )))
1189
1190 (((
1191 AT+NJS=1
1192 )))
1193
1194 (((
1195 AT+DCS=0
1196 )))
1197
1198 (((
1199 AT+PNM=1
1200 )))
1201
1202 (((
1203 AT+PWORD=123456
1204 )))
1205
1206 (((
1207 AT+EXT=1
1208 )))
1209
1210 (((
1211 AT+TDC=120000
1212 )))
1213
1214 (((
1215 AT+TIMESTAMP=1640851037 2021 12 30 7 57 17
1216 )))
1217
1218 (((
1219 AT+RJTDC=20
1220 )))
1221
1222 (((
1223 AT+DDETECT=0,1440
1224 )))
1225
1226 (((
1227 AT+WMOD=0
1228 )))
1229
1230 (((
1231 AT+CITEMP=1
1232 )))
1233
1234 (((
1235 AT+ARTEMP=-40,125
1236 )))
1237
1238 (((
1239 Send AT+PDTA=? to get the stored 174 data
1240 )))
1241
1242
1243 (((
1244 **Example：**
1245 )))
1246
1247 [[image:image-20220621144804-11.png]]
1248
1249
1250
1251 == 6.3  How to upgrade the firmware? ==
1252
1253 LHT52 requires a program converter to upload images to LHT52, which is used to upload image to LHT52 for:
1254
1255 * Support new features
1256 * For bug fix
1257 * Change LoRaWAN bands.
1258
1259 (((
1260 User can check this link for the detail of operation of firmware upgrade: [[Firmware Upgrade Instruction>>doc:Main.Firmware Upgrade Instruction.WebHome||anchor="H2.3LHT52"]]
1261 )))
1262
1263
1264
1265 == 6.4  How to change the LoRa Frequency Bands/Region? ==
1266
1267 User can follow the introduction for [[how to upgrade image>>||anchor="H6.3A0Howtoupgradethefirmware3F"]]. When download the images, choose the required image file for download.
1268
1269
1270
1271 = 7. Order Info =
1272
1273 == 7.1  Main Device ==
1274
1275 (((
1276 Part Number: (% style="color:#4472c4" %)**LHT65N-XX**
1277 )))
1278
1279 (((
1280 (% style="color:#4472c4" %)**XX **(%%): The default frequency band
1281 )))
1282
1283 * (% style="color:red" %)**AS923**(%%)**: **LoRaWAN AS923 band
1284 * (% style="color:red" %)**AU915**(%%)**: **LoRaWAN AU915 band
1285 * (% style="color:red" %)**EU433**(%%)**: **LoRaWAN EU433 band
1286 * (% style="color:red" %)**EU868**(%%)**:** LoRaWAN EU868 band
1287 * (% style="color:red" %)**KR920**(%%)**: **LoRaWAN KR920 band
1288 * (% style="color:red" %)**US915**(%%)**: **LoRaWAN US915 band
1289 * (% style="color:red" %)**IN865**(%%)**:  **LoRaWAN IN865 band
1290 * (% style="color:red" %)**CN470**(%%)**: **LoRaWAN CN470 band
1291
1292
1293
1294 == 7.2  Accessories ==
1295
1296 (% style="color:red" %)Note: below accessories are not include in the main device package, need to order separately.
1297
1298 **Temperature Probe: (% style="color:red" %)AS-01(%%)**
1299
1300 **Program Converter: (% style="color:red" %)AS-02(%%)**
1301
1302
1303
1304 = 8. Packing Info =
1305
1306 **Package Includes**:
1307
1308 * LHT52 Temperature & Humidity Sensor x 1
1309
1310
1311
1312 = 9. Support =
1313
1314 * 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.
1315 * 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]].
1316
1317
1318
1319 = 10. FCC Warning =
1320
1321 This device complies with part 15 of the FCC Rules.Operation is subject to the following two conditions:
1322
1323 (1) This device may not cause harmful interference;
1324
1325 (2) this device must accept any interference received,including interference that may cause undesired operation.
1326
Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0