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

Applications

Navigation

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