Version 2.1 by Edwin Chen on 2023/04/09 00:08

Show last authors
1 (% style="text-align:center" %)
2 [[image:image-20221206143242-2.png||height="602" width="551"]]
3
4
5
6
7
8
9
10
11
12 **Table of Contents:**
13
14 {{toc/}}
15
16
17
18
19
20
21
22
23
24 = 1. Introduction =
25
26 == 1.1 What is LHT65N-PIR Temperature,Humidity & PIR Sensor ==
27
28 The Dragino (% style="color:blue" %)**LHT65N-PIR Temperature, Humidity & PIR sensor**(%%) is a Long Range LoRaWAN Sensor.It includes a (% style="color:blue" %)**built-in Temperature & Humidity sensor**(%%) and has an (% style="color:blue" %)**external PIR Probe**(%%)**.** LHT65N-PIR can detect environment Temperature & Humdity, it also detects (% style="color:blue" %)**People Activity**(%%) via PIR probe and them send these info to LoRaWAN IoT Server.
29
30 The LHT65N-PIR allows users to send data and reach extremely long ranges. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption. It targets professional wireless sensor network applications such as irrigation systems, smart metering, smart cities, building automation, and so on.
31
32 LHT65N-PIR has a (% style="color:blue" %)**built-in 2400mAh non-chargeable battery**(%%) which can be used for more than 5 years*.
33
34 LHT65N-PIR supports (% style="color:blue" %)**wireless configure & OTA update**(%%) which make user easy to use.
35
36 LHT65N-PIR is fully compatible with (% style="color:blue" %)**LoRaWAN v1.0.3 Class A protocol**(%%), it can work with a standard LoRaWAN gateway.
37
38 **The actual battery life depends on how often to send data, please see battery analyzer chapter.
39
40
41
42 == 1.2 Features ==
43
44
45 * LoRaWAN v1.0.3 Class A protocol
46 * Frequency Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915
47 * AT Commands to change parameters
48 * Remote configure parameters via LoRaWAN Downlink
49 * Firmware upgradeable via program port
50 * Built-in 2400mAh battery for up to 10 years of use.
51 * Built-in Temperature & Humidity sensor
52 * External Illuminance Sensor
53 * Tri-color LED to indicate working status
54 * Datalog feature to save sensor data when no LoRaWAN network
55
56 (% style="display:none" %)
57
58
59
60 == 1.3 Specification ==
61
62
63 (% style="color:#037691" %)**Built-in Temperature Sensor:**
64
65 * Resolution: 0.01 °C
66 * Accuracy Tolerance : Typ ±0.3 °C
67 * Long Term Drift: < 0.02 °C/yr
68 * Operating Range: -40 ~~ 85 °C
69
70 (% style="color:#037691" %)**Built-in Humidity Sensor:**
71
72 * Resolution: 0.04 %RH
73 * Accuracy Tolerance : Typ ±3 %RH
74 * Long Term Drift: < 0.02 °C/yr
75 * Operating Range: 0 ~~ 96 %RH
76
77 (% style="color:#037691" %)**External IIIuminace Sensor:**
78
79 * Base on BH1750 Illumination Sensor
80 * Cable Length : 50cm
81 * Resolution: 1 lx
82 * Range: 0-65535 lx
83 * Operating Range: -40 °C ~~ 85 °C
84
85 = 2. Connect LHT65N-E5 to IoT Server =
86
87 == 2.1 How does LHT65N-E5 work? ==
88
89
90 (((
91 LHT65N-E5 is configured as LoRaWAN OTAA Class A sensor by default. Each LHT65N-E5 is shipped with a worldwide unique set of OTAA keys. To use LHT65N-E5 in a LoRaWAN network, first, we need to put the OTAA keys in LoRaWAN Network Server and then activate LHT65N-E5.
92 )))
93
94 (((
95 If LHT65N-E5 is within the coverage of this LoRaWAN network. LHT65N-E5 can join the LoRaWAN network automatically. After successfully joining, LHT65N-E5 will start to measure environment temperature, humidity & illumination, and start to transmit sensor data to the LoRaWAN server. The default period for each uplink is 20 minutes.
96 )))
97
98
99 == 2.2 How to Activate LHT65N-E5? ==
100
101
102 (((
103 The LHT65N-E5 has two working modes:
104 )))
105
106 * (((
107 (% style="color:blue" %)**Deep Sleep Mode**(%%): LHT65N-E5 doesn't have any LoRaWAN activation. This mode is used for storage and shipping to save battery life.
108 )))
109 * (((
110 (% style="color:blue" %)**Working Mode**(%%):  In this mode, LHT65N-E5 works as LoRaWAN Sensor mode to Join LoRaWAN network and send out the sensor data to the server. Between each sampling/tx/rx periodically, LHT65N-E5 will be in STOP mode (IDLE mode), in STOP mode, LHT65N-E5 has the same power consumption as Deep Sleep mode. 
111 )))
112
113 (((
114 The LHT65N-E5 is set in deep sleep mode by default; The ACT button on the front is to switch to different modes:
115 )))
116
117
118 [[image:image-20220515123819-1.png||_mstalt="430742" height="379" width="317"]]
119
120 [[image:image-20220525110604-2.png||_mstalt="427531"]]
121
122
123 == 2.3 Example to join LoRaWAN network ==
124
125
126 (% class="wikigeneratedid" %)
127 This section shows an example of how to join the TTN V3 LoRaWAN IoT server. Use with other LoRaWAN IoT servers is of a similar procedure.
128
129
130 (% class="wikigeneratedid" %)
131 [[image:image-20221224101636-1.png||height="435" width="715"]]
132
133
134 (((
135 Assume the LPS8v2 is already set to connect to [[TTN V3 network>>url:https://eu1.cloud.thethings.network||_mstvisible="2"]], So it provides network coverage for LHT65N-E5. Next we need to add the LHT65N-E5 device in TTN V3:
136 )))
137
138
139 === 2.3.1 Step 1: Create Device n TTN ===
140
141
142 (((
143 Create a device in TTN V3 with the OTAA keys from LHT65N-E5.
144 )))
145
146 (((
147 Each LHT65N-E5 is shipped with a sticker with its device EUI, APP Key and APP EUI as below:
148 )))
149
150 [[image:image-20220617150003-1.jpeg||_mstalt="5426434"]]
151
152 User can enter these keys in the LoRaWAN Server portal. Below is TTN V3 screenshot:
153
154 Add APP EUI in the application.
155
156
157 [[image:image-20220522232916-3.png||_mstalt="430495"]]
158
159
160 [[image:image-20220522232932-4.png||_mstalt="430157"]]
161
162
163 [[image:image-20220522232954-5.png||_mstalt="431847"]]
164
165
166
167 (% style="color:red" %)**Note: LHT65N-E5 use same payload decoder as LHT65.**
168
169
170 [[image:image-20220522233026-6.png||_mstalt="429403"]]
171
172
173 Input APP EUI,  APP KEY and DEV EUI:
174
175
176 [[image:image-20220522233118-7.png||_mstalt="430430"]]
177
178
179 === 2.3.2 Step 2: Activate LHT65N-E5 by pressing the ACT button for more than 5 seconds. ===
180
181
182 (((
183 Use ACT button to activate LHT65N-E5 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.
184 )))
185
186 [[image:image-20220522233300-8.png||_mstalt="428389" height="219" width="722"]]
187
188
189 == 2.4 Uplink Payload   ( Fport~=2) ==
190
191
192 (((
193 The uplink payload includes totally 11 bytes. Uplink packets use FPORT=2 and (% style="color:#4f81bd" %)**every 20 minutes**(%%) send one uplink by default.
194 )))
195
196 (((
197 After each uplink, the (% style="color:blue" %)**BLUE LED**(%%) will blink once.
198 )))
199
200 (% border="1" cellspacing="4" style="background-color:#ffffcc; color:green; width:390px" %)
201 |=(% style="width: 60px;" %)(((
202 **Size(bytes)**
203 )))|=(% style="width: 30px;" %)(((
204 **2**
205 )))|=(% style="width: 100px;" %)(((
206 **2**
207 )))|=(% style="width: 100px;" %)(((
208 **2**
209 )))|=(% style="width: 50px;" %)(((
210 **1**
211 )))|=(% style="width: 50px;" %)(((
212 **4**
213 )))
214 |(% style="width:97px" %)(((
215 **Value**
216 )))|(% style="width:39px" %)(((
217 [[BAT>>||anchor="H2.4.2BAT-BatteryInfo"]]
218 )))|(% style="width:100px" %)(((
219 (((
220 [[Built-In Temperature>>||anchor="H2.4.3Built-inTemperature"]]
221 )))
222 )))|(% style="width:77px" %)(((
223 (((
224 [[Built-in Humidity>>||anchor="H2.4.4Built-inHumidity"]]
225 )))
226 )))|(% style="width:47px" %)(((
227 [[Ext>>||anchor="H2.4.5Ext23"]] #
228 )))|(% style="width:51px" %)(((
229 [[Ext value>>||anchor="H2.4.6Extvalue"]]
230 )))
231
232 * The First 6 bytes: has fix meanings for every LHT65N-E5.
233 * The 7th byte (EXT #): defines the external sensor model. It can be 0x05 or 0x09 for LHT65N-E5
234 * The 8^^th^^ ~~ 9^^th^^ byte: Illuminance. Range: 0-65535 lx.
235 * The 10th ~~ 11th byte: Reserve, always 0xFFFF
236
237 === 2.4.1 Decoder in TTN V3 ===
238
239
240 When the uplink payload arrives TTNv3, it shows HEX format and not friendly to read. We can add LHT65N-E5 decoder in TTNv3 for friendly reading.
241
242 Below is the position to put the decoder and LHT65N-E5 decoder can be download from here: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
243
244
245 [[image:image-20220522234118-10.png||_mstalt="451464" height="353" width="729"]]
246
247
248 === 2.4.2 BAT-Battery Info ===
249
250
251 These two bytes of BAT include the battery state and the actually voltage
252
253 [[image:image-20220523152839-18.png||_mstalt="457613"]]
254
255
256 [[image:image-20220522235639-1.png||_mstalt="431392" height="139" width="727"]]
257
258
259 Check the battery voltage for LHT65N-E5.
260
261 * BAT status=(0Xcba4>>14)&0xFF=11(B),very good
262 * Battery Voltage =0xCBF6&0x3FFF=0x0BA4=2980mV
263
264 === 2.4.3 Built-in Temperature ===
265
266
267 [[image:image-20220522235639-2.png||_mstalt="431756" height="138" width="722"]]
268
269 * Temperature:  0x0ABB/100=27.47℃
270
271 [[image:image-20220522235639-3.png||_mstalt="432120"]]
272
273 * Temperature:  (0xF5C6-65536)/100=-26.18℃
274
275 === 2.4.4 Built-in Humidity ===
276
277
278 [[image:image-20220522235639-4.png||_mstalt="432484" height="138" width="722"]]
279
280 * Humidity:    0x025C/10=60.4%
281
282 === 2.4.5 Ext value ===
283
284 ==== 2.4.5.1 Ext~=0x05, Illuminance Sensor ====
285
286
287 [[image:image-20221224161634-2.png||height="138" width="851"]]
288
289
290 * Illumination=0x005E=94 lux
291
292 The last 2 bytes of data are meaningless
293
294 [[image:image-20221224161725-3.png]]
295
296 * When the sensor is not connected or not connected properly, will show "NULL"
297
298 The last 2 bytes of data are meaningless
299
300
301
302 ==== 2.4.5.2 Ext~=0x85, E5 sensor with Unix Timestamp ====
303
304
305 (((
306 Timestamp mode is designed for LHT65N-E5 with E3 probe, it will send the uplink payload with Unix timestamp. With the limitation of 11 bytes (max distance of AU915/US915/AS923 band), the time stamp mode will be lack of BAT voltage field, instead, it shows the battery status. The payload is as below:
307 )))
308
309 (((
310
311 )))
312
313 (% border="1" cellspacing="4" style="background-color:#ffffcc; color:green; width:535px" %)
314 |=(% style="width: 88px;" %)(((
315 **Size(bytes)**
316 )))|=(% style="width: 93px;" %)(((
317 **2**
318 )))|=(% style="width: 94px;" %)(((
319 **2**
320 )))|=(% style="width: 117px;" %)(((
321 **2**
322 )))|=(% style="width: 54px;" %)(((
323 **1**
324 )))|=(% style="width: 79px;" %)(((
325 **4**
326 )))
327 |(% style="width:88px" %)(((
328 **Value**
329 )))|(% style="width:93px" %)(((
330 [[External temperature>>||anchor="H4.2SetExternalSensorMode"]]
331 )))|(% style="width:94px" %)(((
332 [[Built-In Temperature>>||anchor="H2.4.3Built-inTemperature"]]
333 )))|(% style="width:117px" %)(((
334 BAT Status &
335 Illumination
336 )))|(% style="width:54px" %)(((
337 Status & Ext
338 )))|(% style="width:79px" %)(((
339 [[Unix Time Stamp>>||anchor="H2.6.2UnixTimeStamp"]]
340 )))
341
342 * **Battery status & Built-in Humidity**
343
344 (% border="1" cellspacing="4" style="background-color:#ffffcc; color:green; width:461px" %)
345 |=(% style="width: 67px;" %)Bit(bit)|=(% style="width: 256px;" %)[15:14]|=(% style="width: 132px;" %)[11:0]
346 |(% style="width:67px" %)Value|(% style="width:256px" %)(((
347 BAT Status
348 00(b): Ultra Low ( BAT <= 2.50v)
349 01(b): Low  (2.50v <=BAT <= 2.55v)
350 10(b): OK   (2.55v <= BAT <=2.65v)
351 11(b): Good   (BAT >= 2.65v)
352 )))|(% style="width:132px" %)(((
353 Illumination
354 )))
355
356 * **Status & Ext Byte**
357
358 (% border="1" cellspacing="4" style="background-color:#ffffcc; color:green; width:500px" %)
359 |=(% scope="row" style="width: 60px;" %)**Bits**|(% style="width:90px" %)**7**|(% style="width:100px" %)**6**|(% style="width:90px" %)**5**|(% style="width:100px" %)**4**|(% style="width:60px" %)**[3:0]**
360 |=(% style="width: 96px;" %)**Status&Ext**|(% style="width:124px" %)None-ACK Flag|(% style="width:146px" %)Poll Message FLAG|(% style="width:109px" %)Sync time OK|(% style="width:143px" %)Unix Time Request|(% style="width:106px" %)Ext: 0b(1001)
361
362 * (% style="color:blue" %)**Poll Message Flag**:(%%)  1: This message is a poll message reply, 0: means this is a normal uplink.
363 * (% style="color:blue" %)**Sync time OK**: (%%) 1: Set time ok,0: N/A. After time SYNC request is sent, LHT65N-E5 will set this bit to 0 until got the time stamp from the application server.
364 * (% style="color:blue" %)**Unix Time Request**:(%%)  1: Request server downlink Unix time, 0 : N/A. In this mode, LHT65N-E5 will set this bit to 1 every 10 days to request a time SYNC. (AT+SYNCMOD to set this)
365
366 == 2.5 Show data on Datacake ==
367
368
369 (((
370 Datacake IoT platform provides a human-friendly interface to show the sensor data, 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:
371 )))
372
373 (((
374
375 )))
376
377 (((
378 (% style="color:blue" %)**Step 1**(%%): Be sure that your device is programmed and properly connected to the LoRaWAN network.
379 )))
380
381 (((
382 (% 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.
383 )))
384
385
386
387 (((
388 Add Datacake:
389 )))
390
391
392 [[image:image-20220523000825-7.png||_mstalt="429884" height="262" width="583"]]
393
394
395
396 Select default key as Access Key:
397
398
399 [[image:image-20220523000825-8.png||_mstalt="430248" height="453" width="406"]]
400
401
402 In Datacake console ([[https:~~/~~/datacake.co/>>url:https://datacake.co/]]) , add LHT65 device.
403
404
405 [[image:image-20221224161935-5.png||height="523" width="409"]]
406
407
408 [[image:image-20221224161957-6.png||height="306" width="852"]]
409
410
411 == 2.6 Datalog Feature ==
412
413
414 (((
415 Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, LHT65N-E5 will store the reading for future retrieving purposes. There are two ways for IoT servers to get datalog from LHT65N-E5.
416 )))
417
418
419 === 2.6.1 Ways to get datalog via LoRaWAN ===
420
421
422 There are two methods:
423
424 (% style="color:blue" %)**Method 1:** (%%)IoT Server sends a downlink LoRaWAN command to [[poll the value>>||anchor="H2.6.4Pollsensorvalue"]] for specified time range.
425
426
427 (% style="color:blue" %)**Method 2: **(%%)Set [[PNACKMD=1>>||anchor="H4.13AutoSendNone-ACKmessages"]], LHT65N-E5 will wait for ACK for every uplink, when there is no LoRaWAN network, LHT65N-E5 will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
428
429
430 (% style="color:red" %)**Note for method 2:**
431
432 * a) LHT65N-E5 will do an ACK check for data records sending to make sure every data arrive server.
433 * b) LHT65N-E5 will send data in **CONFIRMED Mode** when PNACKMD=1, but LHT65N-E5 won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if LHT65N-E5 gets a ACK, LHT65N-E5 will consider there is a network connection and resend all NONE-ACK Message.
434
435 Below is the typical case for the auto-update datalog feature (Set PNACKMD=1)
436
437
438 [[image:image-20220703111700-2.png||_mstalt="426244" height="381" width="1119"]]
439
440
441 === 2.6.2 Unix TimeStamp ===
442
443
444 LHT65N-E5 uses Unix TimeStamp format based on
445
446
447 [[image:image-20220523001219-11.png||_mstalt="450450" height="97" width="627"]]
448
449
450
451 User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
452
453 Below is the converter example
454
455 [[image:image-20220523001219-12.png||_mstalt="450827" height="298" width="720"]]
456
457
458 So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
459
460
461 === 2.6.3 Set Device Time ===
462
463
464 (((
465 (% style="color:blue" %)**There are two ways to set device's time:**
466 )))
467
468 (((
469 **1.  Through LoRaWAN MAC Command (Default settings)**
470 )))
471
472 (((
473 User need to set SYNCMOD=1 to enable sync time via MAC command.
474 )))
475
476 (((
477 Once LHT65N-E5 Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to LHT65N-E5. If LHT65N-E5 fails to get the time from the server, LHT65N-E5 will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
478 )))
479
480 (((
481 (% style="color:red" %)**Note: LoRaWAN Server need to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature, Chirpstack,TTN V3 v3 and loriot support but TTN V3 v2 doesn't support. If server doesn't support this command, it will through away uplink packet with this command, so user will lose the packet with time request for TTN V3 v2 if SYNCMOD=1.**
482 )))
483
484
485 (((
486 **2. Manually Set Time**
487 )))
488
489 (((
490 User needs to set SYNCMOD=0 to manual time, otherwise, the user set time will be overwritten by the time set by the server.
491 )))
492
493
494 === 2.6.4 Poll sensor value ===
495
496
497 User can poll sensor value based on timestamps from the server. Below is the downlink command.
498
499 [[image:image-20220523152302-15.png||_mstalt="451581"]]
500
501
502 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.
503
504 For example, downlink command (% _mstmutation="1" %)**31 5FC5F350 5FC6 0160 05**(%%)
505
506 Is to check 2020/12/1 07:40:00 to 2020/12/1 08:40:00’s data
507
508 Uplink Internal =5s,means LHT65N-E5 will send one packet every 5s. range 5~~255s.
509
510
511 === 2.6.5 Datalog Uplink payload ===
512
513
514 The Datalog poll reply uplink will use below payload format.
515
516 **Retrieval data payload:**
517
518 (% border="1" cellspacing="4" style="background-color:#ffffcc; color:green; width:480px" %)
519 |=(% style="width: 60px;" %)(((
520 **Size(bytes)**
521 )))|=(% style="width: 90px;" %)**2**|=(% style="width: 90px;" %)**2**|=(% style="width: 70px;" %)**2**|=(% style="width: 100px;" %)**1**|=(% style="width: 70px;" %)**4**
522 |(% style="width:97px" %)**Value**|(% style="width:123px" %)[[External sensor data>>||anchor="H2.4.6Extvalue"]]|(% style="width:108px" %)[[Built In Temperature>>||anchor="H2.4.3Built-inTemperature"]]|(% style="width:133px" %)[[Built-in Humidity>>||anchor="H2.4.4Built-inHumidity"]]|(% style="width:159px" %)Poll message flag & Ext|(% style="width:80px" %)[[Unix Time Stamp>>||anchor="H2.6.2UnixTimeStamp"]]
523
524 **Poll message flag & Ext:**
525
526 [[image:image-20221006192726-1.png||_mstalt="430508" height="112" width="754"]]
527
528 (% style="color:blue" %)**No ACK Message**(%%):  1: This message means this payload is fromn Uplink Message which doesn't get ACK from the server before ( for [[PNACKMD=1>>||anchor="H4.13AutoSendNone-ACKmessages"]] feature)
529
530 (% style="color:blue" %)**Poll Message Flag**(%%): 1: This message is a poll message reply.
531
532 * Poll Message Flag is set to 1.
533
534 * Each data entry is 11 bytes, to save airtime and battery, devices will send max bytes according to the current DR and Frequency bands.
535
536 For example, in US915 band, the max payload for different DR is:
537
538 (% style="color:blue" %)**a) DR0:** (%%)max is 11 bytes so one entry of data
539
540 (% style="color:blue" %)**b) DR1:**(%%) max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
541
542 (% style="color:blue" %)**c) DR2:**(%%) total payload includes 11 entries of data
543
544 (% style="color:blue" %)**d) DR3: **(%%)total payload includes 22 entries of data.
545
546 If devise doesn't have any data in the polling time. Device will uplink 11 bytes of 0   
547
548
549 **Example:**
550
551 If LHT65N-E5 has below data inside Flash:
552
553 [[image:image-20220523144455-1.png||_mstalt="430040" height="335" width="735"]]
554
555
556 If user sends below downlink command: (% style="background-color:yellow" %)3160065F9760066DA705
557
558 Where : Start time: 60065F97 = time 21/1/19 04:27:03
559
560 Stop time: 60066DA7= time 21/1/19 05:27:03
561
562
563 **LHT65N-E5 will uplink this payload.**
564
565 [[image:image-20220523001219-13.png||_mstalt="451204" height="421" style="text-align:left" width="727"]]
566
567
568 __**7FFF089801464160065F97**__ **__7FFF__ __088E__ __014B__ __41__ __60066009__** 7FFF0885014E41600660667FFF0875015141600662BE7FFF086B015541600665167FFF08660155416006676E7FFF085F015A41600669C67FFF0857015D4160066C1E
569
570 Where the first 11 bytes is for the first entry:
571
572 7FFF089801464160065F97
573
574 Ext sensor data=0x7FFF/100=327.67
575
576 Temp=0x088E/100=22.00
577
578 Hum=0x014B/10=32.6
579
580 poll message flag & Ext=0x41,means reply data,Ext=1
581
582 Unix time is 0x60066009=1611030423s=21/1/19 04:27:03
583
584
585 == 2.7 Alarm Mode ==
586
587 (((
588
589
590 when the device is in alarm mode, it checks the built-in sensor temperature for a short time. if the temperature exceeds the preconfigured range, it sends an uplink immediately.
591 )))
592
593 (((
594 (% style="color:red" %)**Note: alarm mode adds a little power consumption, and we recommend extending the normal read time when this feature is enabled.**
595
596
597 )))
598
599 === 2.7.1 ALARM MODE ===
600
601
602 (% class="box infomessage" %)
603 (((
604 (((
605 **AT+WMOD=1**:  Enable/disable alarm mode. (0: Disabled, 1: Enabled Temperature Alarm for onboard temperature sensor)
606 )))
607
608 (((
609 **AT+CITEMP=1**:  The interval between checking the alarm temperature. (In minutes)
610 )))
611
612 (((
613 **AT+ARTEMP**:  Gets or sets the alarm range of the internal temperature sensor
614 )))
615
616 (((
617 (% _mstmutation="1" %)**AT+ARTEMP=? **(%%):  Gets the alarm range of the internal temperature sensor(% style="display:none" %)
618 )))
619
620 (((
621 **AT+ARTEMP=45,105**:  Set the internal temperature sensor alarm range from 45 to 105.
622 )))
623 )))
624
625 (% style="color:#4f81bd" %)**Downlink Command: AAXXXXXXXXXXXXXX**
626
627 Total bytes: 8 bytes
628
629 **Example:**AA0100010001003C
630
631 WMOD=01
632
633 CITEMP=0001
634
635 TEMPlow=0001
636
637 TEMPhigh=003C
638
639
640 == 2.8 LED Indicator ==
641
642
643 The LHT65 has a triple color LED which for easy showing different stage .
644
645 While user press ACT button, the LED will work as per LED status with ACT button.
646
647 In a normal working state:
648
649 * For each uplink, the BLUE LED or RED LED will blink once.
650 BLUE LED when external sensor is connected.
651 * RED LED when external sensor is not connected
652 * For each success downlink, the PURPLE LED will blink once
653
654 == 2.9 installation ==
655
656
657 [[image:image-20220516231650-1.png||_mstalt="428597" height="436" width="428"]]
658
659
660 = 3. Sensors and Accessories =
661
662 == 3.1 E2 Extension Cable ==
663
664
665 [[image:image-20220619092222-1.png||_mstalt="429533" height="182" width="188"]][[image:image-20220619092313-2.png||_mstalt="430222" height="182" width="173"]]
666
667
668 **1m long breakout cable for LHT65N-E5. Features:**
669
670 * (((
671 Use for AT Command
672 )))
673 * (((
674 Update firmware for LHT65N-E5
675 )))
676 * (((
677 Exposed All pins from the LHT65N Type-C connector.
678
679
680
681 )))
682
683 [[image:image-20220619092421-3.png||_mstalt="430547" height="371" width="529"]]
684
685
686 = 4. Configure LHT65N-E5 via AT command or LoRaWAN downlink =
687
688
689 (((
690 Use can configure LHT65N-E5 via AT Command or LoRaWAN Downlink.
691 )))
692
693 * (((
694 AT Command Connection: See [[FAQ>>||anchor="H6.FAQ"]].
695 )))
696
697 * (((
698 LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>doc:Main.WebHome]]
699 )))
700
701 (((
702 There are two kinds of commands to configure LHT65N-E5, they are:
703 )))
704
705 * (((
706 (% style="color:#4f81bd" %)**General Commands**.
707 )))
708
709 (((
710 These commands are to configure:
711 )))
712
713 1. (((
714 General system settings like: uplink interval.
715 )))
716 1. (((
717 LoRaWAN protocol & radio-related commands.
718 )))
719
720 (((
721 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]]
722 )))
723
724 * (((
725 (% style="color:#4f81bd" %)**Commands special design for LHT65N-E5**
726 )))
727
728 (((
729 These commands are only valid for LHT65N-E5, as below:
730 )))
731
732
733 == 4.1 Set Transmit Interval Time ==
734
735
736 Feature: Change LoRaWAN End Node Transmit Interval.
737
738
739 (% style="color:#4f81bd" %)**AT Command: AT+TDC**
740
741 [[image:image-20220523150701-2.png||_mstalt="427453"]]
742
743
744 (% style="color:#4f81bd" %)**Downlink Command: 0x01**
745
746 Format: Command Code (0x01) followed by 3 bytes time value.
747
748 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
749
750 * **Example 1**: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
751
752 * **Example 2**: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
753
754 == 4.2 Currently only supports E5 ==
755
756
757 Feature: Set device password, max 9 digits
758
759
760 (% style="color:#4f81bd" %)**AT Command: AT+EXT**
761
762 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
763 |Command Example|Function|Response
764 |AT+EXT=?|Get or Set external sensor model|(((
765 5
766
767 OK
768 )))
769 |AT+EXT=5|(% colspan="2" %)Set external sensor mode to 5
770
771 (% style="color:#4f81bd" %)**Downlink Command:0xA2**
772
773
774 Total bytes: 2 bytes
775
776 **Example:**
777
778 * 0xA205: Set external sensor type to E5
779
780 == 4.3 Set to sleep mode ==
781
782
783 Feature: Set device to sleep mode
784
785 * **AT+Sleep=0**  : Normal working mode, device will sleep and use lower power when there is no LoRa message
786 * **AT+Sleep=1** :  Device is in deep sleep mode, no LoRa activation happen, used for storage or shipping.
787
788 (% style="color:#4f81bd" %)**AT Command: AT+SLEEP**
789
790 [[image:image-20220523151218-7.png||_mstalt="430703"]]
791
792
793 (% style="color:#4f81bd" %)**Downlink Command:**
794
795 * There is no downlink command to set to Sleep mode.
796
797 == 4.4 Set system time ==
798
799
800 Feature: Set system time, unix format. [[See here for format detail.>>||anchor="H2.6.2UnixTimeStamp"]]
801
802
803 (% style="color:#4f81bd" %)**AT Command:**
804
805 [[image:image-20220523151253-8.png||_mstalt="430677"]]
806
807
808 (% style="color:#4f81bd" %)**Downlink Command:**
809
810 0x306007806000  ~/~/  Set timestamp to 0x(6007806000),Same as AT+TIMESTAMP=1611104352
811
812
813 == 4.5 Set Time Sync Mode ==
814
815
816 (((
817 Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply this command.
818 )))
819
820 (((
821 SYNCMOD is set to 1 by default. If user want to set a different time from LoRaWAN server, user need to set this to 0.
822
823
824 )))
825
826 (% style="color:#4f81bd" %)**AT Command:**
827
828 [[image:image-20220523151336-9.png||_mstalt="431717"]]
829
830
831 (% style="color:#4f81bd" %)**Downlink Command:**
832
833 0x28 01  ~/~/  Same As AT+SYNCMOD=1
834 0x28 00  ~/~/  Same As AT+SYNCMOD=0
835
836
837 == 4.6 Set Time Sync Interval ==
838
839
840 Feature: Define System time sync interval. SYNCTDC default value: 10 days.
841
842
843 (% style="color:#4f81bd" %)**AT Command:**
844
845 [[image:image-20220523151411-10.png||_mstalt="449696"]]
846
847
848 (% style="color:#4f81bd" %)**Downlink Command:**
849
850 **0x29 0A**  ~/~/ Same as AT+SYNCTDC=0x0A
851
852
853 == 4.7 Print data entries base on page. ==
854
855
856 Feature: Print the sector data from start page to stop page (max is 416 pages).
857
858
859 (% style="color:#4f81bd" %)**AT Command: AT+PDTA**
860
861 [[image:image-20220523151450-11.png||_mstalt="451035"]]
862
863
864 (% style="color:#4f81bd" %)**Downlink Command:**
865
866 No downlink commands for feature
867
868
869 == 4.8 Print last few data entries. ==
870
871
872 Feature: Print the last few data entries
873
874
875 (% style="color:#4f81bd" %)**AT Command: AT+PLDTA**
876
877 [[image:image-20220523151524-12.png||_mstalt="452101"]]
878
879
880 (% style="color:#4f81bd" %)**Downlink Command:**
881
882 No downlink commands for feature
883
884
885 == 4.9 Clear Flash Record ==
886
887
888 Feature: Clear flash storage for data log feature.
889
890
891 (% style="color:#4f81bd" %)**AT Command: AT+CLRDTA**
892
893 [[image:image-20220523151556-13.png||_mstalt="454129"]]
894
895
896 (% style="color:#4f81bd" %)**Downlink Command: 0xA3**
897
898 * Example: 0xA301  ~/~/  Same as AT+CLRDTA
899
900 == 4.10 Auto Send None-ACK messages ==
901
902
903 Feature: LHT65N-E5 will wait for ACK for each uplink, If LHT65N-E5 doesn't get ACK from the IoT server, it will consider the message doesn't arrive server and store it. LHT65N-E5 keeps sending messages in normal periodically. Once LHT65N-E5 gets ACK from a server, it will consider the network is ok and start to send the not-arrive message.
904
905
906 (% style="color:#4f81bd" %)**AT Command: AT+PNACKMD**
907
908 The default factory setting is 0
909
910 (% border="1" cellspacing="4" style="background-color:#ffffcc; color:green; width:367px" %)
911 |=(% style="width: 158px;" %)**Command Example**|=(% style="width: 118px;" %)**Function**|=(% style="width: 87px;" %)**Response**
912 |(% style="width:158px" %)AT+PNACKMD=1|(% style="width:118px" %)Poll None-ACK message|(% style="width:87px" %)OK
913
914 (% style="color:#4f81bd" %)**Downlink Command: 0x34**
915
916 * Example: 0x3401  ~/~/  Same as AT+PNACKMD=1
917
918 = 5. Battery & How to replace =
919
920 == 5.1 Battery Type ==
921
922
923 (((
924 LHT65N-E5 is equipped with a 2400mAH Li-MnO2 (CR17505) battery . The battery is an un-rechargeable battery with low discharge rate targeting for up to 8~~10 years use. This type of battery is commonly used in IoT devices for long-term running, such as water meters.
925 )))
926
927 (((
928 The discharge curve is not linear so can't simply use percentage to show the battery level. Below is the battery performance.
929
930
931 [[image:image-20220515075034-1.png||_mstalt="428961" height="208" width="644"]]
932 )))
933
934 The minimum Working Voltage for the LHT65N-E5 is ~~ 2.5v. When battery is lower than 2.6v, it is time to change the battery.
935
936
937 == 5.2 Replace Battery ==
938
939
940 LHT65N-E5 has two screws on the back, Unscrew them, and changing the battery inside is ok. The battery is a general CR17450 battery (3.0v). Any brand should be ok.
941
942 [[image:image-20220515075440-2.png||_mstalt="429546" height="338" width="272"]][[image:image-20220515075625-3.png||_mstalt="431574" height="193" width="257"]]
943
944
945 == 5.3 Battery Life Analyze ==
946
947
948 (((
949 Dragino battery-powered products are all run in Low Power mode. User can check the guideline from this link to calculate the estimated battery life:
950 [[https:~~/~~/www.dragino.com/downloads/downloads/LoRa_End_Node/Battery_Analyze/DRAGINO_Battery_Life_Guide.pdf>>https://www.dragino.com/downloads/downloads/LoRa_End_Node/Battery_Analyze/DRAGINO_Battery_Life_Guide.pdf]]
951 )))
952
953
954 (((
955 A full detail test report for LHT65N-E5 on different frequency can be found at : [[https:~~/~~/www.dropbox.com/sh/r2i3zlhsyrpavla/AAB1sZw3mdT0K7XjpHCITt13a?dl=0>>https://www.dropbox.com/sh/r2i3zlhsyrpavla/AAB1sZw3mdT0K7XjpHCITt13a?dl=0]]
956 )))
957
958
959 = 6. FAQ =
960
961 == 6.1 How to use AT Command? ==
962
963
964 LHT65N-E5 supports AT Command set.User can use a USB to TTL adapter plus the Program Cable to connect to LHT65 for using AT command, as below.
965
966
967 [[image:image-20220615153355-1.png||_mstalt="430222"]]
968
969
970
971 [[image:1655802313617-381.png||_mstalt="293917"]]
972
973
974
975 (((
976 In PC, User needs to set serial tool(such as [[**putty**>>https://www.chiark.greenend.org.uk/~~sgtatham/putty/latest.html]], SecureCRT) baud rate to (% style="color:green" %)**9600** (%%)to access to access serial console for LHT65N-E5. The AT commands are disable by default and need to enter password (default:(% style="color:green" %)**123456**(% style="color:red" %))(%%) to active it. Timeout to input AT Command is 5 min, after 5-minute, user need to input password again. User can use AT+DISAT command to disable AT command before timeout.
977 )))
978
979 [[image:image-20220615154519-3.png||_mstalt="431925" height="672" width="807"]]
980
981 AT Command List is as below:
982
983 AT+<CMD>? :  Help on <CMD>
984
985 AT+<CMD> :  Run <CMD>
986
987 AT+<CMD>=<value> :  Set the value
988
989 AT+<CMD>=? :  Get the value
990
991 AT+DEBUG:  Set more info output
992
993 ATZ:  Trig a reset of the MCU
994
995 AT+FDR:  Reset Parameters to Factory Default, Keys Reserve
996
997 AT+DEUI:  Get or Set the Device EUI
998
999 AT+DADDR:  Get or Set the Device Address
1000
1001 AT+APPKEY:  Get or Set the Application Key
1002
1003 AT+NWKSKEY:  Get or Set the Network Session Key
1004
1005 AT+APPSKEY:  Get or Set the Application Session Key
1006
1007 AT+APPEUI:  Get or Set the Application EUI
1008
1009 AT+ADR:  Get or Set the Adaptive Data Rate setting. (0: off, 1: on)
1010
1011 AT+TXP:  Get or Set the Transmit Power (0-5, MAX:0, MIN:5, according to LoRaWAN Spec)
1012
1013 AT+DR:  Get or Set the Data Rate. (0-7 corresponding to DR_X)
1014
1015 AT+DCS:  Get or Set the ETSI Duty Cycle setting - 0=disable, 1=enable - Only for testing
1016
1017 AT+PNM:  Get or Set the public network mode. (0: off, 1: on)
1018
1019 AT+RX2FQ:  Get or Set the Rx2 window frequency
1020
1021 AT+RX2DR:  Get or Set the Rx2 window data rate (0-7 corresponding to DR_X)
1022
1023 AT+RX1DL:  Get or Set the delay between the end of the Tx and the Rx Window 1 in ms
1024
1025 AT+RX2DL:  Get or Set the delay between the end of the Tx and the Rx Window 2 in ms
1026
1027 AT+JN1DL:  Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 1 in ms
1028
1029 AT+JN2DL:  Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 2 in ms
1030
1031 AT+NJM:  Get or Set the Network Join Mode. (0: ABP, 1: OTAA)
1032
1033 AT+NWKID:  Get or Set the Network ID
1034
1035 AT+FCU:  Get or Set the Frame Counter Uplink
1036
1037 AT+FCD:  Get or Set the Frame Counter Downlink
1038
1039 AT+CLASS:  Get or Set the Device Class
1040
1041 AT+JOIN:  Join network
1042
1043 AT+NJS:  Get the join status
1044
1045 AT+SENDB:  Send hexadecimal data along with the application port
1046
1047 AT+SEND:  Send text data along with the application port
1048
1049 AT+RECVB:  Print last received data in binary format (with hexadecimal values)
1050
1051 AT+RECV:  Print last received data in raw format
1052
1053 AT+VER:  Get current image version and Frequency Band
1054
1055 AT+CFM:  Get or Set the confirmation mode (0-1)
1056
1057 AT+CFS:  Get confirmation status of the last AT+SEND (0-1)
1058
1059 AT+SNR:  Get the SNR of the last received packet
1060
1061 AT+RSSI:  Get the RSSI of the last received packet
1062
1063 AT+TDC:  Get or set the application data transmission interval in ms
1064
1065 AT+PORT:  Get or set the application port
1066
1067 AT+DISAT:  Disable AT commands
1068
1069 AT+PWORD: Set password, max 9 digits
1070
1071 AT+CHS:  Get or Set Frequency (Unit: Hz) for Single Channel Mode
1072
1073 AT+CHE:  Get or Set eight channels mode,Only for US915,AU915,CN470
1074
1075 AT+PDTA:  Print the sector data from start page to stop page
1076
1077 AT+PLDTA:  Print the last few sets of data
1078
1079 AT+CLRDTA:  Clear the storage, record position back to 1st
1080
1081 AT+SLEEP:  Set sleep mode
1082
1083 AT+EXT:  Get or Set external sensor model
1084
1085 AT+BAT:  Get the current battery voltage in mV
1086
1087 AT+CFG:  Print all configurations
1088
1089 AT+WMOD:  Get or Set Work Mode
1090
1091 AT+ARTEMP:  Get or set the internal Temperature sensor alarm range
1092
1093 AT+CITEMP:  Get or set the internal Temperature sensor collection interval in min
1094
1095 AT+SETCNT:  Set the count at present
1096
1097 AT+RJTDC:  Get or set the ReJoin data transmission interval in min
1098
1099 AT+RPL:  Get or set response level
1100
1101 AT+TIMESTAMP:  Get or Set UNIX timestamp in second
1102
1103 AT+LEAPSEC:  Get or Set Leap Second
1104
1105 AT+SYNCMOD:  Get or Set time synchronization method
1106
1107 AT+SYNCTDC:  Get or set time synchronization interval in day
1108
1109 AT+PID:  Get or set the PID
1110
1111
1112 == 6.2 Where to use AT commands and Downlink commands ==
1113
1114
1115 **AT commands:**
1116
1117 [[image:image-20220620153708-1.png||_mstalt="429806" height="603" width="723"]]
1118
1119
1120 **Downlink commands:**
1121
1122
1123
1124 (% style="color:blue" %)**TTN:**
1125
1126 [[image:image-20220615092124-2.png||_mstalt="429221" height="649" width="688"]]
1127
1128
1129
1130 (% style="color:blue" %)**Helium:**
1131
1132 [[image:image-20220615092551-3.png||_mstalt="430794" height="423" width="835"]]
1133
1134
1135
1136 (% style="color:blue" %)**Chirpstack: The downlink window will not be displayed until the network is accessed**
1137
1138
1139 [[image:image-20220615094850-6.png||_mstalt="433082"]]
1140
1141
1142 [[image:image-20220615094904-7.png||_mstalt="433485" height="281" width="911"]]
1143
1144
1145
1146 (% style="color:blue" %)**Aws:**
1147
1148 [[image:image-20220615092939-4.png||_mstalt="434460" height="448" width="894"]]
1149
1150
1151 == 6.3 How to change the uplink interval? ==
1152
1153
1154 Please see this link: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/How%20to%20set%20the%20transmit%20time%20interval/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20set%20the%20transmit%20time%20interval/||_mstmutation="1" style="background-color: rgb(255, 255, 255);"]]
1155
1156
1157
1158 [[image:image-20220615154519-3.png||_mstalt="431925" height="672" width="807"]]
1159
1160
1161 == 6.4 How to use TTL-USB to connect PC to upgrade firmware? ==
1162
1163
1164 [[image:image-20220615153355-1.png||_mstalt="430222"]]
1165
1166
1167 (% style="color:blue" %)**Step1**(%%): Install TremoProgrammer  first.
1168
1169 [[image:image-20220615170542-5.png||_mstalt="430638"]]
1170
1171
1172
1173 (% _mstmutation="1" style="color:blue" %)**Step2**(%%):wiring method.(% style="display:none" %)
1174
1175 First connect the four lines;(% style="display:none" %)
1176
1177 [[image:image-20220621170938-1.png||_mstalt="431340" height="413" width="419"]],(% style="display:none" %)
1178
1179
1180 Then use DuPont cable to short circuit port3 and port1, and then release them, so that the device enters bootlaod mode.
1181
1182 [[image:image-20220621170938-2.png||_mstalt="431704"]]
1183
1184
1185
1186 (% style="color:blue" %)**Step3:**(%%)Select the device port to be connected, baud rate and bin file to be downloaded.
1187
1188 [[image:image-20220615171334-6.png||_mstalt="431028"]]
1189
1190
1191 Click the (% style="color:blue" %)**start**(%%) button to start the firmware upgrade.
1192
1193
1194 When this interface appears, it indicates that the download has been completed.
1195
1196 [[image:image-20220620160723-8.png||_mstalt="430703"]]
1197
1198
1199 Finally, unplug the DuPont cable on port4, and then use the DuPont cable to short circuit port3 and port1 to reset the device.
1200
1201
1202
1203 [[image:image-20220615154519-3.png||_mstalt="431925" height="672" width="807"]]
1204
1205
1206 = 7. Order Info =
1207
1208
1209 Part Number: (% style="color:#4f81bd" %)** LHT65N-PIR-XX**
1210
1211 (% style="color:#4f81bd" %)**XX **(%%): The default frequency band
1212
1213 * (% style="color:#4f81bd" %)** **(% _mstmutation="1" style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
1214 * (% style="color:#4f81bd" %)** **(% _mstmutation="1" style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
1215 * (% style="color:#4f81bd" %)** **(% _mstmutation="1" style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
1216 * (% style="color:#4f81bd" %)** **(% _mstmutation="1" style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
1217 * (% style="color:#4f81bd" %)** **(% _mstmutation="1" style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
1218 * (% style="color:#4f81bd" %)** **(% _mstmutation="1" style="color:red" %)**US915**(%%): LoRaWAN US915 band
1219 * (% style="color:#4f81bd" %)** **(% _mstmutation="1" style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
1220 * (% style="color:#4f81bd" %)** **(% _mstmutation="1" style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1221
1222 = 8. Packing Info =
1223
1224
1225 **Package Includes**:
1226
1227 * LHT65N-PIR Temperature/Humidity/PIR Sensor x 1
1228
1229 **Dimension and weight**:
1230
1231 * Device Size:  10 x 10 x 3.5 mm
1232 * Device Weight: 120.5g
1233
1234 = 9. Reference material =
1235
1236
1237 * [[Datasheet, photos, decoder, firmware>>https://www.dropbox.com/sh/una19zsni308dme/AACOKp6J2RF5TMlKWT5zU3RTa?dl=0]]
1238
1239 = 10. FCC Warning =
1240
1241
1242 This device complies with part 15 of the FCC Rules.Operation is subject to the following two conditions:
1243
1244 (1) This device may not cause harmful interference;
1245
1246 (2) this device must accept any interference received, including interference that may cause undesired operation.