Changes for page SPH01-LB -- LoRaWAN Soil pH Sensor User Manual
Last modified by Xiaoling on 2024/01/15 09:36
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -115,7 +115,6 @@ 115 115 ))) 116 116 |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode. 117 117 118 - 119 119 == 1.6 BLE connection == 120 120 121 121 ... ... @@ -303,52 +303,23 @@ 303 303 === 2.3.2 Sensor Data. FPORT~=2 === 304 304 305 305 306 -D 2x-LBwilluplinkbelow payloadvia FPORT=2after Joined LoRaWAN Network.305 +Sensor Data is uplink via FPORT=2 307 307 308 -(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:500px" %) 309 -|=(% style="width: 62.5px;" %)((( 310 -**Size (bytes)** 311 -)))|=(% style="width: 60px;" %)2|=(% style="width: 120px;" %)2|=(% style="width: 60px;" %)2|=(% style="width: 65px;" %)1|=(% style="width: 65px;" %)**2**|=(% style="width: 65px;" %)2 312 -|(% style="width:65px" %)**Value**|((( 313 -[[Battery>>||anchor="HBattery:"]] 314 -)))|(% style="width:91px" %)((( 315 -[[Temp_ Red or Temp _White>>||anchor="HTemperatureREDorTemperatureWhite:"]] 316 -)))|(% style="width:61px" %)((( 317 -ignore 318 -)))|(% style="width:91px" %)((( 319 -[[Alarm Flag>>||anchor="HAlarmFlag26MOD:"]] 320 -)))|(% style="width:99px" %)((( 321 -[[Temp_White>>||anchor="HTemperatureWhite:"]] 322 -)))|(% style="width:97px" %)((( 323 -[[Temp_Black>>||anchor="HTemperatureBlack:"]] 324 - 325 - 307 +|=((( 308 +**Size(bytes)** 309 +)))|=2|=4|=1|=**2**|=2 310 +|**Value**|((( 311 +[[Battery>>path:#HBattery:]] 312 +)))|((( 313 +[[Unix TimeStamp>>path:#H2.4.1UnixTimeStamp]] 314 +)))|((( 315 +[[Alarm Flag>>path:#HAlarmFlag26MOD:]] 316 +)))|((( 317 +[[Temperature>>path:#HTemperature:]] 318 +)))|((( 319 +[[Humidity>>path:#HHumidity:]] 326 326 ))) 327 327 328 -**Payload per each model.** 329 - 330 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-D20-D22-D23%20LoRaWAN%20Temperature%20Sensor%20User%20Manual/WebHome/image-20220916152530-2.png?rev=1.1||alt="image-20220916152530-2.png" height="240" width="901"]] 331 - 332 - 333 -[[image:image-20230415154139-3.png||height="215" width="1179"]] 334 - 335 - 336 -==== (% style="color:#4472c4" %)**Decode corresponding probe color:**(%%) ==== 337 - 338 -**D20:** 339 - 340 -Red <~-~-> C1 341 - 342 -**D22:** 343 - 344 -White <~-~-> C1 Red <~-~-> C2 345 - 346 -**D23:** 347 - 348 -White <~-~->C1 Red <~-~-> C2 Black <~-~-> C3 349 - 350 - 351 - 352 352 ==== (% style="color:#4472c4" %)**Battery:**(%%) ==== 353 353 354 354 Sensor Battery Level. ... ... @@ -359,10 +359,8 @@ 359 359 360 360 361 361 362 -==== (% style="color:#4472c4" %)**Temperature RED or Temperature White:**(%%) ====332 +==== (% style="color:#4472c4" %)**Temperature:**(%%) ==== 363 363 364 -**This point to the Red probe in D20-LB or the probe of D22-LB/D23-LB White** 365 - 366 366 **Example**: 367 367 368 368 If payload is: 0105H: (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree ... ... @@ -372,39 +372,12 @@ 372 372 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative) 373 373 374 374 343 +==== (% style="color:#4472c4" %)**Humidity:**(%%) ==== 375 375 376 -==== (% style="color:#4472c4" %)**Temperature White:**(%%) ==== 377 377 346 +Read:0x(0197)=412 Value: 412 / 10=41.2, So 41.2% 378 378 379 -**This point to the Red probe in D22-LB/D23-LB** 380 380 381 - 382 -**Example**: 383 - 384 -If payload is: 0105H: (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree 385 - 386 -If payload is: FF3FH : (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 387 - 388 -(FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative) 389 - 390 - 391 - 392 -==== (% style="color:#4472c4" %)**Temperature Black:**(%%) ==== 393 - 394 - 395 -**This point to the BLACK probe in D23-LB** 396 - 397 - 398 -**Example**: 399 - 400 -If payload is: 0105H: (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree 401 - 402 -If payload is: FF3FH : (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 403 - 404 -(FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative) 405 - 406 - 407 - 408 408 ==== (% style="color:#4472c4" %)**Alarm Flag& MOD:**(%%) ==== 409 409 410 410 ... ... @@ -414,36 +414,33 @@ 414 414 415 415 If payload & 0x01 = 0x00 **~-~->** This is a normal uplink message, no alarm 416 416 358 +If payload >> 2 = 0x00 **~-~->** means MOD=1, This is a sampling uplink message 417 417 360 +If payload >> 2 = 0x31 **~-~->** means MOD=31, this message is a reply message for polling, this message contains the alarm settings. see [[this link>>path:#HPolltheAlarmsettings:]] for detail. 418 418 419 -==== ==== 420 420 421 - 422 422 == 2.4 Payload Decoder file == 423 423 365 +In TTN, use can add a custom payload so it shows friendly reading 424 424 425 -((( 426 -In TTN, use can add a custom payload so it shows friendly. 427 -))) 367 +In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**(%%) to add the decoder from: 428 428 429 -((( 430 -In the page **Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder** to add the decoder from: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]] 431 -))) 369 +[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/LSN50v2-S31%26S31B >>https://github.com/dragino/dragino-end-node-decoder/tree/main/LSN50v2-S31%26S31B]] 432 432 433 433 434 434 == 2.5 Datalog Feature == 435 435 436 436 437 -Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, D2x-LB will store the reading for future retrieving purposes.375 +Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, S31x-LB will store the reading for future retrieving purposes. 438 438 439 439 440 440 === 2.5.1 Ways to get datalog via LoRaWAN === 441 441 442 442 443 -Set [[PNACKMD=1>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/#H4.13AutoSendNone-ACKmessages]], D2x-LB will wait for ACK for every uplink, when there is no LoRaWAN network,D2x-LB 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.381 +Set [[PNACKMD=1>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/#H4.13AutoSendNone-ACKmessages]], S31x-LB will wait for ACK for every uplink, when there is no LoRaWAN network,S31x-LB 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. 444 444 445 -* a) D2x-LB will do an ACK check for data records sending to make sure every data arrive server.446 -* b) D2x-LB will send data in **CONFIRMED Mode** when PNACKMD=1, butD2x-LB 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 ifD2x-LB gets a ACK,D2x-LB will consider there is a network connection and resend all NONE-ACKMessage.383 +* a) S31x-LB will do an ACK check for data records sending to make sure every data arrive server. 384 +* b) S31x-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but S31x-LB 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 S31x-LB gets a ACK, S31x-LB will consider there is a network connection and resend all NONE-ACK messages. 447 447 448 448 Below is the typical case for the auto-update datalog feature (Set PNACKMD=1) 449 449 ... ... @@ -452,7 +452,7 @@ 452 452 === 2.5.2 Unix TimeStamp === 453 453 454 454 455 -L HT65Nuses Unix TimeStamp format based on393 +S31x-LB uses Unix TimeStamp format based on 456 456 457 457 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-11.png?width=627&height=97&rev=1.1||alt="image-20220523001219-11.png" height="97" width="627"]] 458 458 ... ... @@ -468,17 +468,17 @@ 468 468 === 2.5.3 Set Device Time === 469 469 470 470 471 -User need to set SYNCMOD=1 to enable sync time via MAC command. 409 +User need to set **SYNCMOD=1** to enable sync time via MAC command. 472 472 473 -Once D2x-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time toD2x-LB. IfD2x-LB fails to get the time from the server,D2x-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).411 +Once S31x-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to S31x-LB. If S31x-LB fails to get the time from the server, S31x-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days). 474 474 475 475 **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.** 476 476 477 477 478 -=== 2.5.4 Datalog Uplink payload (FPORT~=3)===416 +=== 2.5.4 Datalog Uplink payload (FPORT~=3) === 479 479 480 480 481 -The Datalog poll replyuplink will use below payload format.419 +The Datalog uplinks will use below payload format. 482 482 483 483 **Retrieval data payload:** 484 484 ... ... @@ -526,7 +526,7 @@ 526 526 527 527 Stop time: 60066DA7= time 21/1/19 05:27:03 528 528 529 -**L HT65Nwill uplink this payload.**467 +**S31x-LB will uplink this payload.** 530 530 531 531 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-13.png?width=727&height=421&rev=1.1||alt="image-20220523001219-13.png" height="421" width="727"]] 532 532 ... ... @@ -552,7 +552,7 @@ 552 552 == 2.6 Temperature Alarm Feature == 553 553 554 554 555 - D2x-LB work flow with Alarm feature.493 +S31x-LB work flow with Alarm feature. 556 556 557 557 558 558 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-D20-D22-D23%20LoRaWAN%20Temperature%20Sensor%20User%20Manual/WebHome/image-20220623090437-1.png?rev=1.1||alt="image-20220623090437-1.png"]] ... ... @@ -562,7 +562,7 @@ 562 562 == 2.7 Frequency Plans == 563 563 564 564 565 -The D2x-LB uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.503 +The S31x-LB uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets. 566 566 567 567 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]] 568 568 ... ... @@ -572,19 +572,18 @@ 572 572 573 573 **Firmware download link:** 574 574 575 -[[https:~~/~~/www.dropbox.com/sh/ gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]]513 +[[https:~~/~~/www.dropbox.com/sh/kwqv57tp6pejias/AAAopYMATh1GM6fZ-VRCLrpDa?dl=0>>https://www.dropbox.com/sh/kwqv57tp6pejias/AAAopYMATh1GM6fZ-VRCLrpDa?dl=0]] 576 576 577 577 516 += 3. Configure S31x-LB = 578 578 579 -= 3. Configure D2x-LB = 580 - 581 581 == 3.1 Configure Methods: == 582 582 583 583 584 - D2x-LB supports below configure method:521 +S31x-LB supports below configure method: 585 585 586 586 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 587 -* AT Command via UART Connection : See [[ FAQ>>||anchor="H7.FAQ"]].524 +* AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]]. 588 588 * LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 589 589 590 590 == 3.2 General Commands == ... ... @@ -600,10 +600,10 @@ 600 600 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]] 601 601 602 602 603 -== 3.3 Commands special design for D2x-LB ==540 +== 3.3 Commands special design for S31x-LB == 604 604 605 605 606 -These commands only valid for D2x-LB, as below:543 +These commands only valid for S31x-LB, as below: 607 607 608 608 609 609 === 3.3.1 Set Transmit Interval Time === ... ... @@ -644,69 +644,64 @@ 644 644 Sensor will upload Device Status via FPORT=5. See payload section for detail. 645 645 646 646 647 -=== 3.3.3 Set Alarm Thre dhold ===584 +=== 3.3.3 Set Temperature Alarm Threshold: === 648 648 586 +* **AT Command:** 649 649 650 - (% style="color:#4472c4" %)**1. Set forAllProbes:**588 +**AT+SHTEMP=min,max** 651 651 652 -(% style="color:#037691" %)**AT+18ALARM=min,max** 590 +* When min=0, and max≠0, Alarm higher than max 591 +* When min≠0, and max=0, Alarm lower than min 592 +* When min≠0 and max≠0, Alarm higher than max or lower than min 653 653 654 -* When min=0, and max≠0, Alarm trigger when higher than max 655 -* When min≠0, and max=0, Alarm trigger when lower than min 656 -* When min≠0 and max≠0, Alarm trigger when higher than max or lower than min 594 +Example: 657 657 658 - **Example:**596 + AT+SHTEMP=0,30 ~/~/ Alarm when temperature higher than 30. 659 659 660 - AT+18ALARM=-10,30 ~/~/ Alarmwhen< -10 or higher than30.598 +* **Downlink Payload:** 661 661 600 +**0x(0C 01 00 1E)** ~/~/Set AT+SHTEMP=0,30 662 662 663 -* % style="color:#037691"%)**DownlinkPayload:**602 +**(note: 3^^rd^^ byte= 0x00 for low limit(not set), 4^^th^^ byte = 0x1E for high limit: 30)** 664 664 665 -0x(0B F6 1E) ~/~/ Same as AT+18ALARM=-10,30 666 666 667 - (note: 0x1E= 30,0xF6means:0xF6-0x100=-10)605 +=== 3.3.4 Set Humidity Alarm Threshold: === 668 668 607 +* **AT Command:** 669 669 670 - (% style="color:#4472c4" %)**2.Set for Separate Probe:**609 +**AT+SHHUM=min,max** 671 671 672 -(% style="color:#037691" %)**AT+18ALARM=min,max,index** 611 +* When min=0, and max≠0, Alarm higher than max 612 +* When min≠0, and max=0, Alarm lower than min 613 +* When min≠0 and max≠0, Alarm higher than max or lower than min 673 673 674 - Index:615 +Example: 675 675 676 -* 1: Temperature_Red 677 -* 2: Temperature_White 678 -* 3: Temperature_Black 617 + AT+SHHUM=70,0 ~/~/ Alarm when humidity lower than 70%. 679 679 680 -** Example:**619 +* **Downlink Payload:** 681 681 682 - AT+18ALARM=-10,30,1Alarm whentemperature_red< -10or higher than 30.621 +**0x(0C 02 46 00)** ~/~/Set AT+SHTHUM=70,0 683 683 623 +**(note: 3^^rd^^ byte= 0x46 for low limit (70%), 4^^th^^ byte = 0x00 for high limit (not set))** 684 684 685 -* (% style="color:#037691" %)**Downlink Payload:** 686 686 687 - 0x(0BF61E 01) ~/~/SameasAT+18ALARM=-10,30,1626 +=== 3.3.5 Set Alarm Interval: === 688 688 689 -(note: 0x1E= 30, 0xF6 means: 0xF6-0x100 = -10) 690 - 691 - 692 -=== 3.3.4 Set Alarm Interval === 693 - 694 - 695 695 The shortest time of two Alarm packet. (unit: min) 696 696 697 -* (% style="color:#037691" %)**AT Command:**630 +* **AT Command:** 698 698 699 -AT+ATDC=30 ~/~/ The shortest interval of two Alarm packets is 30 minutes, Means is there is an alarm packet uplink, there won't be another one in the next 30 minutes. 632 +**AT+ATDC=30** ~/~/ The shortest interval of two Alarm packets is 30 minutes, Means is there is an alarm packet uplink, there won't be another one in the next 30 minutes. 700 700 634 +* **Downlink Payload:** 701 701 702 -* %style="color:#037691"%)**DownlinkPayload:**636 +**0x(0D 00 1E)** **~-~--> ** Set AT+ATDC=0x 00 1E = 30 minutes 703 703 704 -0x(0D 00 1E) **~-~-->** Set AT+ATDC=0x 00 1E = 30 minutes 705 705 639 +=== 3.3.6 Get Alarm settings (什么FPORT?) === 706 706 707 -=== 3.3.5 Get Alarm settings (什么FPORT?) === 708 708 709 - 710 710 Send a LoRaWAN downlink to ask device send Alarm settings. 711 711 712 712 * (% style="color:#037691" %)**Downlink Payload: **(%%)0x0E 01 ... ... @@ -720,9 +720,11 @@ 720 720 721 721 * Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message. 722 722 723 -=== 3.3.6 Set Interrupt Mode === 724 724 725 725 657 +=== 3.3.7 Set Interrupt Mode === 658 + 659 + 726 726 Feature, Set Interrupt mode for GPIO_EXIT. 727 727 728 728 (% style="color:blue" %)**AT Command: AT+INTMOD** ... ... @@ -751,10 +751,11 @@ 751 751 * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 752 752 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 753 753 688 + 754 754 = 4. Battery & Power Consumption = 755 755 756 756 757 - D2x-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.692 +S31x-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 758 758 759 759 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 760 760 ... ... @@ -770,7 +770,7 @@ 770 770 == 6.1 How to use AT Command via UART to access device? == 771 771 772 772 773 -See: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H 1.LoRaSTv4baseHardware>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]708 +See: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]] 774 774 775 775 776 776 == 6.2 How to update firmware via UART port? == ... ... @@ -788,7 +788,7 @@ 788 788 = 7. Order Info = 789 789 790 790 791 -Part Number: (% style="color:blue" %)** D20-LB-XX /D22-LB-XX / D23-LB-XX**726 +Part Number: (% style="color:blue" %)**S31-LB-XX / S31x-LB-XX** 792 792 793 793 (% style="color:red" %)**XX**(%%): The default frequency band 794 794 ... ... @@ -813,7 +813,7 @@ 813 813 814 814 (% style="color:#037691" %)**Package Includes**: 815 815 816 -* D2x-LB LoRaWAN Temperature Sensor751 +* S31x-LB LoRaWAN Temperature & Humidity Sensor 817 817 818 818 (% style="color:#037691" %)**Dimension and weight**: 819 819