Version 225.2 by Xiaoling on 2022/08/18 10:39

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