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

Applications

Navigation

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