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

Applications

Navigation

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