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