Changes for page LHT52 - LoRaWAN Temperature & Humidity Sensor User Manual
Last modified by Mengting Qiu on 2024/04/30 14:27
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 5 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -195,12 +195,10 @@ 195 195 196 196 * Temperature: 0x0ABB/100=27.47℃ 197 197 198 - 199 199 [[image:image-20220522235639-3.png]] 200 200 201 201 * Temperature: (0xF5C6-65536)/100=-26.18℃ 202 202 203 - 204 204 === Built-in Humidity === 205 205 206 206 [[image:image-20220522235639-4.png]] ... ... @@ -207,7 +207,6 @@ 207 207 208 208 * Humidity: 0x025C/10=60.4% 209 209 210 - 211 211 === Ext # === 212 212 213 213 Bytes for External Sensor: ... ... @@ -217,7 +217,6 @@ 217 217 |(% style="width:139px" %)0x01|(% style="width:484px" %)Sensor E3, Temperature Sensor 218 218 |(% style="width:139px" %)0x09|(% style="width:484px" %)Sensor E3, Temperature Sensor, Datalog Mod 219 219 220 - 221 221 === Ext value === 222 222 223 223 ==== Ext~=1, E3 Temperature Sensor ==== ... ... @@ -241,7 +241,7 @@ 241 241 If the external sensor is 0x01, and there is no external temperature connected. The temperature will be set to 7FFF which is 327.67℃ 242 242 243 243 244 -==== Ext~=9, E3 sensor with Unix Time 240 +==== Ext~=9, E3 sensor with Unix Timestamp ==== 245 245 246 246 Timestamp mode is designed for LHT65N 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: 247 247 ... ... @@ -264,7 +264,7 @@ 264 264 [[Time Stamp>>path:#Unix_Time_Stamp]] 265 265 ))) 266 266 267 -* **Battery status & **[[**Built-in Humidity**>>path:#SHT20_Humidity]] 263 +* **Battery status & **[[(% class="wikiinternallink wikiinternallink" %)**Built-in Humidity**>>path:#SHT20_Humidity]] 268 268 269 269 (% style="width:587px" %) 270 270 |Bit(bit)|(% style="width:280px" %)[15:14]|(% style="width:136px" %)[11:0] ... ... @@ -284,7 +284,6 @@ 284 284 285 285 ))) 286 286 287 - 288 288 * **Status & Ext Byte** 289 289 290 290 (% style="width:732px" %) ... ... @@ -299,8 +299,214 @@ 299 299 * Sync time OK: 1: Set time ok,0: N/A. After time SYNC request is sent, LHT65N will set this bit to 0 until got the time stamp from the application server. 300 300 * Unix Time Request:1: Request server downlink Unix time, 0 : N/A. In this mode, LHT65N will set this bit to 1 every 10 days to request a time SYNC. (AT+SYNCMOD to set this) 301 301 297 +== Show data on Datacake == 302 302 299 +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: 303 303 301 + 302 +**Step 1**: Be sure that your device is programmed and properly connected to the LoRaWAN network. 303 + 304 +**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. 305 + 306 + 307 +Add Datacake: 308 + 309 +[[image:image-20220523000825-7.png||height="262" width="583"]] 310 + 311 + 312 +Select default key as Access Key: 313 + 314 +[[image:image-20220523000825-8.png||height="453" width="406"]] 315 + 316 + 317 +In Datacake console ([[https:~~/~~/datacake.co/>>url:https://datacake.co/]]) , add LHT65 device. 318 + 319 +[[image:image-20220523000825-9.png||height="366" width="392"]] 320 + 321 + 322 + 323 +[[image:image-20220523000825-10.png||height="432" width="762"]] 324 + 325 + 326 +== Datalog Feature == 327 + 328 +This feature is always enabled. When user wants to retrieve the sensor value, he can send a poll command from the IoT platform to ask LHT65N to send the value in the required time slot. 329 + 330 +=== Unix TimeStamp === 331 + 332 +LHT65N uses Unix TimeStamp format based on 333 + 334 +[[image:image-20220523001219-11.png||height="97" width="627"]] 335 + 336 + 337 +User can get this time from link: [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] : 338 + 339 +Below is the converter example 340 + 341 +[[image:image-20220523001219-12.png||height="353" width="853"]] 342 + 343 +So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25 344 + 345 + 346 +=== Set Device Time === 347 + 348 +There are two ways to set device’s time: 349 + 350 +**~1. Through LoRaWAN MAC Command (Default settings)** 351 + 352 +User need to set SYNCMOD=1 to enable sync time via MAC command. 353 + 354 +Once LHT65N Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to LHT65N. If LHT65N fails to get the time from the server, LHT65N will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days). 355 + 356 +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. 357 + 358 + 359 +**2. Manually Set Time** 360 + 361 +User needs to set SYNCMOD=0 to manual time, otherwise, the user set time will be overwritten by the time set by the server. 362 + 363 + 364 +=== Poll sensor value === 365 + 366 +User can poll sensor value based on timestamps from the server. Below is the downlink command. 367 + 368 + 369 +(% style="width:454px" %) 370 +|(% style="width:69px" %)1byte|(% style="width:129px" %)4bytes|(% style="width:134px" %)4bytes|(% style="width:119px" %)1byte 371 +|(% style="width:69px" %)31|(% style="width:129px" %)Timestamp start|(% style="width:134px" %)Timestamp end|(% style="width:119px" %)Uplink Interval 372 + 373 + 374 +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. 375 + 376 + 377 +For example, downlink command 31 5FC5F350 5FC6 0160 05 378 + 379 +Is to check 2020/12/1 07:40:00 to 2020/12/1 08:40:00’s data 380 + 381 +Uplink Internal =5s,means LHT65N will send one packet every 5s. range 5~~255s. 382 + 383 + 384 +=== Datalog Uplink payload === 385 + 386 +The Datalog poll reply uplink will use below payload format. 387 + 388 + 389 +Retrieval data payload 390 + 391 +|**Size(bytes)**|**2**|**2**|**2**|**1**|**4** 392 +|**Value**|[[External sensor data>>path:#Extension_sensor_value]]|((( 393 +[[Built-In>>path:#SHT20_Temperature]] 394 + 395 +[[Temperature>>path:#SHT20_Temperature]] 396 +)))|((( 397 +[[Built-in>>path:#SHT20_Humidity]] 398 + 399 +[[Humidity>>path:#SHT20_Humidity]] 400 +)))|[[Poll message flag & Ext>>path:#Poll_EXT]]|((( 401 +[[Unix Time Stamp>>path:#Unix_Time_Stamp]] 402 + 403 + 404 +))) 405 + 406 + 407 +Poll message flag & Ext 408 + 409 + 410 +|**Bits**|**7**|**6**|**5**|**4**|**[3:0]** 411 +|**Status & Ext**|Not Defined|Poll Message Flag|Sync time OK|Unix Time Request|((( 412 +Ext: 413 + 414 +0b(1001) 415 +))) 416 + 417 + 418 +Poll Message Flag: 1: This message is a poll message reply. 419 + 420 +* Poll Message Flag is set to 1. 421 +* Each data entry is 11 bytes, to save airtime and battery, devices will send max bytes according to the current DR and Frequency bands. 422 + 423 +For example, in US915 band, the max payload for different DR is: 424 + 425 +a) DR0: max is 11 bytes so one entry of data 426 + 427 +b) DR1: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes) 428 + 429 +c) DR2: total payload includes 11 entries of data 430 + 431 +d) DR3: total payload includes 22 entries of data. 432 + 433 +If devise doesn’t have any data in the polling time. Device will uplink 11 bytes of 0 434 + 435 + 436 +**Example:** 437 + 438 +If LHT65N has below data inside Flash: 439 + 440 +Flash Addr |Unix Time | Ext | BAT voltage| Value 441 + 442 +80196E0 21/1/19 04:27:03 1 3145 sht_temp=22.00 sht_hum=32.6 ds_temp=327.67 443 + 444 +80196F0 21/1/19 04:28:57 1 3145 sht_temp=21.90 sht_hum=33.1 ds_temp=327.67 445 + 446 +8019700 21/1/19 04:30:30 1 3145 sht_temp=21.81 sht_hum=33.4 ds_temp=327.67 447 + 448 +8019710 21/1/19 04:40:30 1 3145 sht_temp=21.65 sht_hum=33.7 ds_temp=327.67 449 + 450 +8019720 21/1/19 04:50:30 1 3147 sht_temp=21.55 sht_hum=34.1 ds_temp=327.67 451 + 452 +8019730 21/1/19 05:00:30 1 3149 sht_temp=21.50 sht_hum=34.1 ds_temp=327.67 453 + 454 +8019740 21/1/19 05:10:30 1 3149 sht_temp=21.43 sht_hum=34.6 ds_temp=327.67 455 + 456 +8019750 21/1/19 05:20:30 1 3151 sht_temp=21.35 sht_hum=34.9 ds_temp=327.67 457 + 458 + 459 +If user sends below downlink command: 460 + 461 +3160065F9760066DA705 462 + 463 + Where : Start time: 60065F97 = time 21/1/19 04:27:03 464 + 465 + Stop time 60066DA7= time 21/1/19 05:27:03 466 + 467 + 468 +LHT65N will uplink this payload. 469 + 470 +[[image:image-20220523001219-13.png]] 471 + 472 +7FFF089801464160065F977FFF088E014B41600660097FFF0885014E41600660667FFF0875015141600662BE7FFF086B015541600665167FFF08660155416006676E7FFF085F015A41600669C67FFF0857015D4160066C1E 473 + 474 +Where the first 11 bytes is for the first entry: 475 + 476 +7FFF089801464160065F97 477 + 478 +Ext sensor data=0x7FFF/100=327.67 479 + 480 +Temp=0x0898/100=22.00 481 + 482 +Hum=0x0146/10=32.6 483 + 484 +poll message flag & Ext=0x41,means reply data,Ext=1 485 + 486 +Unix time is 0x60065F97=1611030423s=21/1/19 04:27:03 487 + 488 + 489 +== Alarm Mode == 490 + 491 +Alarm mode feature is added since firmware v1.5. 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. 492 + 493 + 494 +Note: Alarm mode will increase a little big the power consumption, we recommend extending the normal reading time when enabling this feature. 495 + 496 + 497 +AT Commands for Alarm mode: 498 + 499 +**AT+WMOD=1**: Enable/Disable Alarm Mode. (0:Disable, 1: Enable) 500 + 501 +**AT+CITEMP=1**: The interval to check the temperature for Alarm. (Unit: minute) 502 + 503 + 504 + 304 304 == LED Indicator == 305 305 306 306 The LHT65N has a triple color LED which for easy shows different stage.
- image-20220523000825-10.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +59.3 KB - Content
- image-20220523000825-9.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +60.7 KB - Content
- image-20220523001219-11.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +18.8 KB - Content
- image-20220523001219-12.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +86.2 KB - Content
- image-20220523001219-13.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +35.6 KB - Content