Last modified by Bei Jinggeng on 2025/01/10 15:51
<
From version < 11.2 >
edited by Edwin Chen
on 2023/05/11 23:01
To version < 43.8 >
edited by Xiaoling
on 2023/05/16 13:49
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -SN50v3-LB User Manual
1 +SN50v3-LB LoRaWAN Sensor Node User Manual
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Edwin
1 +XWiki.Xiaoling
Content
... ... @@ -1,4 +1,5 @@
1 -[[image:image-20230511201248-1.png||height="403" width="489"]]
1 +(% style="text-align:center" %)
2 +[[image:image-20230515135611-1.jpeg||height="589" width="589"]]
2 2  
3 3  
4 4  
... ... @@ -15,18 +15,15 @@
15 15  
16 16  == 1.1 What is SN50v3-LB LoRaWAN Generic Node ==
17 17  
19 +
18 18  (% style="color:blue" %)**SN50V3-LB **(%%)LoRaWAN Sensor Node is a Long Range LoRa Sensor Node. It is designed for outdoor use and powered by (% style="color:blue" %)** 8500mA Li/SOCl2 battery**(%%) for long term use.SN50V3-LB is designed to facilitate developers to quickly deploy industrial level LoRa and IoT solutions. It help users to turn the idea into a practical application and make the Internet of Things a reality. It is easy to program, create and connect your things everywhere.
19 19  
20 -
21 21  (% style="color:blue" %)**SN50V3-LB wireless part**(%%) is based on SX1262 allows the user to send data and reach extremely long ranges at low data-rates.It provides ultra-long range spread spectrum communication and high interference immunity whilst minimising current consumption.It targets professional wireless sensor network applications such as irrigation systems, smart metering, smart cities, smartphone detection, building automation, and so on.
22 22  
23 -
24 24  (% style="color:blue" %)**SN50V3-LB **(%%)has a powerful 48Mhz ARM microcontroller with 256KB flash and 64KB RAM. It has multiplex I/O pins to connect to different sensors.
25 25  
26 -
27 27  (% style="color:blue" %)**SN50V3-LB**(%%) has a built-in BLE module, user can configure the sensor remotely via Mobile Phone. It also support OTA upgrade via private LoRa protocol for easy maintaining.
28 28  
29 -
30 30  SN50V3-LB is the 3^^rd^^ generation of LSN50 series generic sensor node from Dragino. It is an (% style="color:blue" %)**open source project**(%%) and has a mature LoRaWAN stack and application software. User can use the pre-load software for their IoT projects or easily customize the software for different requirements.
31 31  
32 32  
... ... @@ -44,6 +44,7 @@
44 44  
45 45  == 1.3 Specification ==
46 46  
45 +
47 47  (% style="color:#037691" %)**Common DC Characteristics:**
48 48  
49 49  * Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
... ... @@ -80,6 +80,7 @@
80 80  
81 81  == 1.4 Sleep mode and working mode ==
82 82  
82 +
83 83  (% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
84 84  
85 85  (% style="color:blue" %)**Working Mode:** (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
... ... @@ -122,7 +122,7 @@
122 122  == 1.7 Pin Definitions ==
123 123  
124 124  
125 -[[image:image-20230511203450-2.png||height="443" width="785"]]
125 +[[image:image-20230513102034-2.png]]
126 126  
127 127  
128 128  == 1.8 Mechanical ==
... ... @@ -137,6 +137,7 @@
137 137  
138 138  == Hole Option ==
139 139  
140 +
140 140  SN50v3-LB has different hole size options for different size sensor cable. The options provided are M12, M16 and M20. The definition is as below:
141 141  
142 142  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/image-20220627104757-1.png?rev=1.1||alt="image-20220627104757-1.png"]]
... ... @@ -272,39 +272,357 @@
272 272  Ex2: 0x0B49 = 2889mV
273 273  
274 274  
275 -=== 2.3.2  Sensor Data. FPORT~=2 ===
276 +=== 2.3.2 Working Modes & Sensor Data. Uplink via FPORT~=2 ===
276 276  
277 277  
278 -Sensor Data is uplink via FPORT=2
279 +SN50v3 has different working mode for the connections of different type of sensors. This section describes these modes. Use can use the AT Command AT+MOD to set SN50v3 to different working modes.
279 279  
280 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
281 -|=(% style="width: 90px;background-color:#D9E2F3" %)(((
281 +For example:
282 +
283 + **AT+MOD=2  ** ~/~/ will set the SN50v3 to work in MOD=2 distance mode which target to measure distance via Ultrasonic Sensor.
284 +
285 +
286 +(% style="color:red" %) **Important Notice:**
287 +
288 +1. Some working modes has payload more than 12 bytes, The US915/AU915/AS923 frequency bands' definition has maximum 11 bytes in **DR0**. Server sides will see NULL payload while SN50v3 transmit in DR0 with 12 bytes payload.
289 +1. All modes share the same Payload Explanation from HERE.
290 +1. By default, the device will send an uplink message every 20 minutes.
291 +
292 +==== 2.3.2.1  MOD~=1 (Default Mode) ====
293 +
294 +
295 +In this mode, uplink payload includes in total 11 bytes. Uplink packets use FPORT=2.
296 +
297 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
298 +|(% style="background-color:#D9E2F3;color:#0070C0" %)**Size(bytes)**|(% style="background-color:#D9E2F3;color:#0070C0" %)**2**|(% style="width:191px;background-color:#D9E2F3;color:#0070C0" %)**2**|(% style="width:78px;background-color:#D9E2F3;color:#0070C0" %)**2**|(% style="width:216px;background-color:#D9E2F3;color:#0070C0" %)**1**|(% style="width:308px;background-color:#D9E2F3;color:#0070C0" %)**2**|(% style="width:154px;background-color:#D9E2F3;color:#0070C0" %)**2**
299 +|**Value**|Bat|(% style="width:191px" %)(((
300 +Temperature(DS18B20)
301 +(PC13)
302 +)))|(% style="width:78px" %)(((
303 +ADC
304 +(PA4)
305 +)))|(% style="width:216px" %)(((
306 +Digital in(PB15) &
307 +Digital Interrupt(PA8)
308 +)))|(% style="width:308px" %)(((
309 +Temperature
310 +(SHT20 or SHT31 or BH1750 Illumination Sensor)
311 +)))|(% style="width:154px" %)(((
312 +Humidity
313 +(SHT20 or SHT31)
314 +)))
315 +
316 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/image-20220627150949-6.png?rev=1.1||alt="image-20220627150949-6.png"]]
317 +
318 +
319 +==== 2.3.2.2  MOD~=2 (Distance Mode) ====
320 +
321 +This mode is target to measure the distance. The payload of this mode is totally 11 bytes. The 8^^th^^ and 9^^th^^ bytes is for the distance.
322 +
323 +(% style="width:1011px" %)
324 +|**Size(bytes)**|**2**|(% style="width:196px" %)**2**|(% style="width:87px" %)**2**|(% style="width:189px" %)**1**|(% style="width:208px" %)**2**|(% style="width:117px" %)**2**
325 +|**Value**|BAT|(% style="width:196px" %)(((
326 +Temperature(DS18B20)
327 +(PC13)
328 +)))|(% style="width:87px" %)(((
329 +ADC
330 +(PA4)
331 +)))|(% style="width:189px" %)(((
332 +Digital in(PB15) &
333 +Digital Interrupt(PA8)
334 +)))|(% style="width:208px" %)(((
335 +Distance measure by:
336 +1) LIDAR-Lite V3HP
337 +Or
338 +2) Ultrasonic Sensor
339 +)))|(% style="width:117px" %)Reserved
340 +
341 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/1656324539647-568.png?rev=1.1||alt="1656324539647-568.png"]]
342 +
343 +**Connection of LIDAR-Lite V3HP:**
344 +
345 +[[image:image-20230512173758-5.png||height="563" width="712"]]
346 +
347 +**Connection to Ultrasonic Sensor:**
348 +
349 +Need to remove R1 and R2 resistors to get low power,otherwise there will be 240uA standby current.
350 +
351 +[[image:image-20230512173903-6.png||height="596" width="715"]]
352 +
353 +For the connection to TF-Mini or TF-Luna , MOD2 payload is as below:
354 +
355 +(% style="width:1113px" %)
356 +|**Size(bytes)**|**2**|(% style="width:183px" %)**2**|(% style="width:173px" %)**1**|(% style="width:84px" %)**2**|(% style="width:323px" %)**2**|(% style="width:188px" %)**2**
357 +|**Value**|BAT|(% style="width:183px" %)(((
358 +Temperature(DS18B20)
359 +(PC13)
360 +)))|(% style="width:173px" %)(((
361 +Digital in(PB15) &
362 +Digital Interrupt(PA8)
363 +)))|(% style="width:84px" %)(((
364 +ADC
365 +(PA4)
366 +)))|(% style="width:323px" %)(((
367 +Distance measure by:1)TF-Mini plus LiDAR
368 +Or 
369 +2) TF-Luna LiDAR
370 +)))|(% style="width:188px" %)Distance signal  strength
371 +
372 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/1656376779088-686.png?rev=1.1||alt="1656376779088-686.png"]]
373 +
374 +**Connection to [[TF-Mini plus>>url:http://en.benewake.com/product/detail/5c345cd0e5b3a844c472329b.html]] LiDAR(UART version):**
375 +
376 +Need to remove R3 and R4 resistors to get low power,otherwise there will be 400uA standby current.
377 +
378 +[[image:image-20230512180609-7.png||height="555" width="802"]]
379 +
380 +**Connection to [[TF-Luna>>url:http://en.benewake.com/product/detail/5e1c1fd04d839408076b6255.html]] LiDAR (UART version):**
381 +
382 +Need to remove R3 and R4 resistors to get low power,otherwise there will be 400uA standby current.
383 +
384 +[[image:image-20230513105207-4.png||height="469" width="802"]]
385 +
386 +
387 +==== 2.3.2.3  MOD~=3 (3 ADC + I2C) ====
388 +
389 +This mode has total 12 bytes. Include 3 x ADC + 1x I2C
390 +
391 +(% style="width:1031px" %)
392 +|=(((
282 282  **Size(bytes)**
283 -)))|=(% style="width: 80px;background-color:#D9E2F3" %)2|=(% style="width: 90px;background-color:#D9E2F3" %)4|=(% style="width:80px;background-color:#D9E2F3" %)1|=(% style="width: 80px;background-color:#D9E2F3" %)**2**|=(% style="width: 80px;background-color:#D9E2F3" %)2
284 -|(% style="width:99px" %)**Value**|(% style="width:69px" %)(((
285 -[[Battery>>||anchor="HBattery:"]]
286 -)))|(% style="width:130px" %)(((
287 -[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
288 -)))|(% style="width:91px" %)(((
289 -[[Alarm Flag>>||anchor="HAlarmFlag26MOD:"]]
290 -)))|(% style="width:103px" %)(((
291 -[[Temperature>>||anchor="HTemperature:"]]
292 -)))|(% style="width:80px" %)(((
293 -[[Humidity>>||anchor="HHumidity:"]]
394 +)))|=(% style="width: 68px;" %)**2**|=(% style="width: 75px;" %)**2**|=**2**|=**1**|=(% style="width: 304px;" %)2|=(% style="width: 163px;" %)2|=(% style="width: 53px;" %)1
395 +|**Value**|(% style="width:68px" %)(((
396 +ADC1
397 +(PA4)
398 +)))|(% style="width:75px" %)(((
399 +ADC2
400 +(PA5)
401 +)))|(((
402 +ADC3
403 +(PA8)
404 +)))|(((
405 +Digital Interrupt(PB15)
406 +)))|(% style="width:304px" %)(((
407 +Temperature
408 +(SHT20 or SHT31 or BH1750 Illumination Sensor)
409 +)))|(% style="width:163px" %)(((
410 +Humidity
411 +(SHT20 or SHT31)
412 +)))|(% style="width:53px" %)Bat
413 +
414 +[[image:image-20230513110214-6.png]]
415 +
416 +
417 +==== 2.3.2.4 MOD~=4 (3 x DS18B20) ====
418 +
419 +
420 +This mode has total 11 bytes. As shown below:
421 +
422 +(% style="width:1017px" %)
423 +|**Size(bytes)**|**2**|(% style="width:186px" %)**2**|(% style="width:82px" %)**2**|(% style="width:210px" %)**1**|(% style="width:191px" %)**2**|(% style="width:183px" %)**2**
424 +|**Value**|BAT|(% style="width:186px" %)(((
425 +Temperature1(DS18B20)
426 +(PC13)
427 +)))|(% style="width:82px" %)(((
428 +ADC
429 +(PA4)
430 +)))|(% style="width:210px" %)(((
431 +Digital in(PB15) &
432 +Digital Interrupt(PA8) 
433 +)))|(% style="width:191px" %)Temperature2(DS18B20)
434 +(PB9)|(% style="width:183px" %)Temperature3(DS18B20)
435 +(PB8)
436 +
437 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/1656377606181-607.png?rev=1.1||alt="1656377606181-607.png"]]
438 +
439 +[[image:image-20230513134006-1.png||height="559" width="736"]]
440 +
441 +
442 +==== 2.3.2.5  MOD~=5(Weight Measurement by HX711) ====
443 +
444 +[[image:image-20230512164658-2.png||height="532" width="729"]]
445 +
446 +Each HX711 need to be calibrated before used. User need to do below two steps:
447 +
448 +1. Zero calibration. Don't put anything on load cell and run **AT+WEIGRE** to calibrate to Zero gram.
449 +1. Adjust calibration factor (default value 400): Put a known weight thing on load cell and run **AT+WEIGAP** to adjust the Calibration Factor.
450 +1. (((
451 +Weight has 4 bytes, the unit is g.
294 294  )))
295 295  
296 -==== (% style="color:#4472c4" %)**Battery**(%%) ====
454 +For example:
297 297  
298 -Sensor Battery Level.
456 +**AT+GETSENSORVALUE =0**
299 299  
458 +Response:  Weight is 401 g
459 +
460 +Check the response of this command and adjust the value to match the real value for thing.
461 +
462 +(% style="width:767px" %)
463 +|=(((
464 +**Size(bytes)**
465 +)))|=**2**|=(% style="width: 193px;" %)**2**|=(% style="width: 85px;" %)**2**|=(% style="width: 186px;" %)**1**|=(% style="width: 100px;" %)**4**
466 +|**Value**|BAT|(% style="width:193px" %)(((
467 +Temperature(DS18B20)
468 +(PC13)
469 +)))|(% style="width:85px" %)(((
470 +ADC
471 +(PA4)
472 +)))|(% style="width:186px" %)(((
473 +Digital in(PB15) &
474 +Digital Interrupt(PA8)
475 +)))|(% style="width:100px" %)Weight
476 +
477 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/image-20220820120036-2.png?width=1003&height=469&rev=1.1||alt="image-20220820120036-2.png" height="469" width="1003"]]
478 +
479 +
480 +==== 2.3.2.6  MOD~=6 (Counting Mode) ====
481 +
482 +In this mode, the device will work in counting mode. It counts the interrupt on the interrupt pins and sends the count on TDC time.
483 +
484 +Connection is as below. The PIR sensor is a count sensor, it will generate interrupt when people come close or go away. User can replace the PIR sensor with other counting sensors.
485 +
486 +[[image:image-20230512181814-9.png||height="543" width="697"]]
487 +
488 +**Note:** LoRaWAN wireless transmission will infect the PIR sensor. Which cause the counting value increase +1 for every uplink. User can change PIR sensor or put sensor away of the SN50_v3 to avoid this happen.
489 +
490 +(% style="width:961px" %)
491 +|=**Size(bytes)**|=**2**|=(% style="width: 256px;" %)**2**|=(% style="width: 108px;" %)**2**|=(% style="width: 126px;" %)**1**|=(% style="width: 145px;" %)**4**
492 +|**Value**|BAT|(% style="width:256px" %)(((
493 +Temperature(DS18B20)
494 +
495 +(PC13)
496 +)))|(% style="width:108px" %)(((
497 +ADC
498 +(PA4)
499 +)))|(% style="width:126px" %)(((
500 +Digital in
501 +(PB15)
502 +)))|(% style="width:145px" %)(((
503 +Count
504 +(PA8)
505 +)))
506 +
507 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/1656378441509-171.png?rev=1.1||alt="1656378441509-171.png"]]
508 +
509 +
510 +==== 2.3.2.7  MOD~=7 (Three interrupt contact modes) ====
511 +
512 +(% style="width:1108px" %)
513 +|=(((
514 +**Size(bytes)**
515 +)))|=**2**|=(% style="width: 188px;" %)**2**|=(% style="width: 83px;" %)**2**|=(% style="width: 184px;" %)**1**|=(% style="width: 186px;" %)**1**|=(% style="width: 197px;" %)1|=(% style="width: 100px;" %)2
516 +|**Value**|BAT|(% style="width:188px" %)(((
517 +Temperature(DS18B20)
518 +(PC13)
519 +)))|(% style="width:83px" %)(((
520 +ADC
521 +(PA5)
522 +)))|(% style="width:184px" %)(((
523 +Digital Interrupt1(PA8)
524 +)))|(% style="width:186px" %)Digital Interrupt2(PA4)|(% style="width:197px" %)Digital Interrupt3(PB15)|(% style="width:100px" %)Reserved
525 +
526 +[[image:image-20230513111203-7.png||height="324" width="975"]]
527 +
528 +==== 2.3.2.8  MOD~=8 （3ADC+1DS18B20） ====
529 +
530 +(% style="width:922px" %)
531 +|=(((
532 +**Size(bytes)**
533 +)))|=**2**|=(% style="width: 207px;" %)**2**|=(% style="width: 94px;" %)**2**|=(% style="width: 198px;" %)**1**|=(% style="width: 84px;" %)**2**|=(% style="width: 82px;" %)2
534 +|**Value**|BAT|(% style="width:207px" %)(((
535 +Temperature(DS18B20)
536 +(PC13)
537 +)))|(% style="width:94px" %)(((
538 +ADC1
539 +(PA4)
540 +)))|(% style="width:198px" %)(((
541 +Digital Interrupt(PB15)
542 +)))|(% style="width:84px" %)(((
543 +ADC2
544 +(PA5)
545 +)))|(% style="width:82px" %)(((
546 +ADC3
547 +(PA8)
548 +)))
549 +
550 +[[image:image-20230513111231-8.png||height="335" width="900"]]
551 +
552 +
553 +==== 2.3.2.9  MOD~=9 (3DS18B20+ two Interrupt count mode) ====
554 +
555 +(% style="width:1010px" %)
556 +|=(((
557 +**Size(bytes)**
558 +)))|=**2**|=**2**|=**2**|=**1**|=(% style="width: 193px;" %)**2**|=(% style="width: 78px;" %)4|=(% style="width: 78px;" %)4
559 +|**Value**|BAT|(((
560 +Temperature1(DS18B20)
561 +(PC13)
562 +)))|(((
563 +Temperature2(DS18B20)
564 +(PB9)
565 +)))|(((
566 +Digital Interrupt
567 +(PB15)
568 +)))|(% style="width:193px" %)(((
569 +Temperature3(DS18B20)
570 +(PB8)
571 +)))|(% style="width:78px" %)(((
572 +Count1
573 +(PA8)
574 +)))|(% style="width:78px" %)(((
575 +Count2
576 +(PA4)
577 +)))
578 +
579 +[[image:image-20230513111255-9.png||height="341" width="899"]]
580 +
581 +**The newly added AT command is issued correspondingly:**
582 +
583 +**~ AT+INTMOD1** ** PA8**  pin：  Corresponding downlink:  **06 00 00 xx**
584 +
585 +**~ AT+INTMOD2**  **PA4**  pin：  Corresponding downlink:**  06 00 01 xx**
586 +
587 +**~ AT+INTMOD3**  **PB15**  pin：  Corresponding downlink:  ** 06 00 02 xx**
588 +
589 +**AT+SETCNT=aa,bb** 
590 +
591 +When AA is 1, set the count of PA8 pin to BB Corresponding downlink：09 01 bb bb bb bb
592 +
593 +When AA is 2, set the count of PA4 pin to BB Corresponding downlink：09 02 bb bb bb bb
594 +
595 +
596 +
597 +=== 2.3.3  ​Decode payload ===
598 +
599 +While using TTN V3 network, you can add the payload format to decode the payload.
600 +
601 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/1656378466788-734.png?rev=1.1||alt="1656378466788-734.png"]]
602 +
603 +The payload decoder function for TTN V3 are here:
604 +
605 +SN50v3 TTN V3 Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]]
606 +
607 +
608 +==== 2.3.3.1 Battery Info ====
609 +
610 +Check the battery voltage for SN50v3.
611 +
300 300  Ex1: 0x0B45 = 2885mV
301 301  
302 302  Ex2: 0x0B49 = 2889mV
303 303  
304 304  
617 +==== 2.3.3.2  Temperature (DS18B20) ====
305 305  
306 -==== (% style="color:#4472c4" %)**Temperature**(%%) ====
619 +If there is a DS18B20 connected to PC13 pin. The temperature will be uploaded in the payload.
307 307  
621 +More DS18B20 can check the [[3 DS18B20 mode>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/#2.3.4MOD3D4283xDS18B2029]]
622 +
623 +**Connection:**
624 +
625 +[[image:image-20230512180718-8.png||height="538" width="647"]]
626 +
308 308  **Example**:
309 309  
310 310  If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
... ... @@ -314,195 +314,211 @@
314 314  （FF3F & 8000：Judge whether the highest bit is 1, when the highest bit is 1, it is negative）
315 315  
316 316  
317 -==== (% style="color:#4472c4" %)**Humidity**(%%) ====
636 +==== 2.3.3.3 Digital Input ====
318 318  
638 +The digital input for pin PB15,
319 319  
320 -Read:0x(0197)=412    Value:  412 / 10=41.2, So 41.2%
640 +* When PB15 is high, the bit 1 of payload byte 6 is 1.
641 +* When PB15 is low, the bit 1 of payload byte 6 is 0.
321 321  
643 +(% class="wikigeneratedid" id="H2.3.3.4A0AnalogueDigitalConverter28ADC29" %)
644 +(((
645 +When the digital interrupt pin is set to AT+INTMODx=0, this pin is used as a digital input pin.
322 322  
323 -==== (% style="color:#4472c4" %)**Alarm Flag& MOD**(%%) ====
647 +(% style="color:red" %)**Note:**The maximum voltage input supports 3.6V.
648 +)))
324 324  
650 +==== 2.3.3.4  Analogue Digital Converter (ADC) ====
325 325  
326 -**Example:**
652 +The measuring range of the ADC is only about 0V to 1.1V The voltage resolution is about 0.24mv.
327 327  
328 -If payload & 0x01 = 0x01  **~-~->** This is an Alarm Message
654 +When the measured output voltage of the sensor is not within the range of 0V and 1.1V, the output voltage terminal of the sensor shall be divided The example in the following figure is to reduce the output voltage of the sensor by three times If it is necessary to reduce more times, calculate according to the formula in the figure and connect the corresponding resistance in series.
329 329  
330 -If payload & 0x01 = 0x00  **~-~->** This is a normal uplink message, no alarm
656 +[[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-20220628150112-1.png?width=285&height=241&rev=1.1||alt="image-20220628150112-1.png" height="241" width="285"]]
331 331  
332 -If payload >> 2 = 0x00  **~-~->**  means MOD=1, This is a sampling uplink message
658 +(% style="color:red" %)**Note:**If the ADC type sensor needs to be powered by SN50_v3, it is recommended to use +5V to control its switch.Only sensors with low power consumption can be powered with VDD.
333 333  
334 -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. 
335 335  
661 +==== 2.3.3.5 Digital Interrupt ====
336 336  
337 -== 2.4 Payload Decoder file ==
663 +Digital Interrupt refers to pin PA8, and there are different trigger methods. When there is a trigger, the SN50v3 will send a packet to the server.
338 338  
665 +(% style="color:blue" %)**~ Interrupt connection method:**
339 339  
340 -In TTN, use can add a custom payload so it shows friendly reading
667 +[[image:image-20230513105351-5.png||height="147" width="485"]]
341 341  
342 -In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**(%%) to add the decoder from:
669 +(% style="color:blue" %)**Example to use with door sensor :**
343 343  
344 -[[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]]
671 +The door sensor is shown at right. It is a two wire magnetic contact switch used for detecting the open/close status of doors or windows.
345 345  
673 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/1656379210849-860.png?rev=1.1||alt="1656379210849-860.png"]]
346 346  
347 -== 2.5 Datalog Feature ==
675 +When the two pieces are close to each other, the 2 wire output will be short or open (depending on the type), while if the two pieces are away from each other, the 2 wire output will be the opposite status. So we can use SN50_v3 interrupt interface to detect the status for the door or window.
348 348  
677 +(% style="color:blue" %)**~ Below is the installation example:**
349 349  
350 -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.
679 +Fix one piece of the magnetic sensor to the door and connect the two pins to SN50_v3 as follows:
351 351  
681 +* (((
682 +One pin to SN50_v3's PA8 pin
683 +)))
684 +* (((
685 +The other pin to SN50_v3's VDD pin
686 +)))
352 352  
353 -=== 2.5.1 Ways to get datalog via LoRaWAN ===
688 +Install the other piece to the door. Find a place where the two pieces will be close to each other when the door is closed. For this particular magnetic sensor, when the door is closed, the output will be short, and PA8 will be at the VCC voltage.
354 354  
690 +Door sensors have two types: ** NC (Normal close)** and **NO (normal open)**. The connection for both type sensors are the same. But the decoding for payload are reverse, user need to modify this in the IoT Server decoder.
355 355  
356 -Set [[PNACKMD=1>>||anchor="H2.5.4DatalogUplinkpayloadA028FPORT3D329"]], 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.
692 +When door sensor is shorted, there will extra power consumption in the circuit, the extra current is 3v3/R14 = 3v3/1Mohm = 3uA which can be ignored.
357 357  
358 -* a) S31x-LB will do an ACK check for data records sending to make sure every data arrive server.
359 -* 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.
694 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/1656379283019-229.png?rev=1.1||alt="1656379283019-229.png"]]
360 360  
361 -Below is the typical case for the auto-update datalog feature (Set PNACKMD=1)
696 +The above photos shows the two parts of the magnetic switch fitted to a door.
362 362  
363 -[[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-20220703111700-2.png?width=1119&height=381&rev=1.1||alt="图片-20220703111700-2.png" height="381" width="1119"]]
698 +The software by default uses the falling edge on the signal line as an interrupt. We need to modify it to accept both the rising edge (0v ~-~-> VCC , door close) and the falling edge (VCC ~-~-> 0v , door open) as the interrupt.
364 364  
365 -=== 2.5.2 Unix TimeStamp ===
700 +The command is:
366 366  
702 +(% style="color:blue" %)**AT+INTMOD1=1   ** (%%) ~/~/(more info about INMOD please refer** **[[**AT Command Manual**>>url:http://www.dragino.com/downloads/index.php?dir=LSN50-LoRaST/&file=DRAGINO_LSN50_AT_Commands_v1.5.1.pdf]]**. **)
367 367  
368 -S31x-LB uses Unix TimeStamp format based on
704 +Below shows some screen captures in TTN V3:
369 369  
370 -[[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="图片-20220523001219-11.png" height="97" width="627"]]
706 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/1656379339508-835.png?rev=1.1||alt="1656379339508-835.png"]]
371 371  
372 -User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
708 +In MOD=1, user can use byte 6 to see the status for door open or close. TTN V3 decoder is as below:
373 373  
374 -Below is the converter example
710 +door= (bytes[6] & 0x80)? "CLOSE":"OPEN";
375 375  
376 -[[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-12.png?width=720&height=298&rev=1.1||alt="图片-20220523001219-12.png" height="298" width="720"]]
377 377  
378 -So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
713 +==== 2.3.3.6 I2C Interface (SHT20 & SHT31) ====
379 379  
715 +The SDA and SCK are I2C interface lines. You can use these to connect to an I2C device and get the sensor data.
380 380  
381 -=== 2.5.3 Set Device Time ===
717 +We have made an example to show how to use the I2C interface to connect to the SHT20/ SHT31 Temperature and Humidity Sensor.
382 382  
719 +Notice: Different I2C sensors have different I2C commands set and initiate process, if user want to use other I2C sensors, User need to re-write the source code to support those sensors. SHT20/ SHT31 code in SN50_v3 will be a good reference.
383 383  
384 -User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
721 +Below is the connection to SHT20/ SHT31. The connection is as below:
385 385  
386 -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).
387 387  
388 -(% 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.**
724 +[[image:image-20230513103633-3.png||height="448" width="716"]]
389 389  
726 +The device will be able to get the I2C sensor data now and upload to IoT Server.
390 390  
391 -=== 2.5.4 Datalog Uplink payload (FPORT~=3) ===
728 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/1656379664142-345.png?rev=1.1||alt="1656379664142-345.png"]]
392 392  
730 +Convert the read byte to decimal and divide it by ten.
393 393  
394 -The Datalog uplinks will use below payload format.
732 +**Example:**
395 395  
396 -**Retrieval data payload:**
734 +Temperature:  Read:0116(H) = 278(D)  Value:  278 /10=27.8℃;
397 397  
398 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
399 -|=(% style="width: 80px;background-color:#D9E2F3" %)(((
400 -**Size(bytes)**
401 -)))|=(% style="width: 60px; background-color: rgb(217, 226, 243);" %)**2**|=(% style="width: 60px; background-color: rgb(217, 226, 243);" %)**2**|=(% style="width: 120px; background-color: rgb(217, 226, 243);" %)**2**|=(% style="width: 103px; background-color: rgb(217, 226, 243);" %)**1**|=(% style="width: 85px; background-color: rgb(217, 226, 243);" %)**4**
402 -|(% style="width:103px" %)**Value**|(% style="width:54px" %)(((
403 -[[Temp_Black>>||anchor="HTemperatureBlack:"]]
404 -)))|(% style="width:51px" %)[[Temp_White>>||anchor="HTemperatureWhite:"]]|(% style="width:89px" %)[[Temp_ Red or Temp _White>>||anchor="HTemperatureREDorTemperatureWhite:"]]|(% style="width:103px" %)Poll message flag & Ext|(% style="width:54px" %)[[Unix Time Stamp>>||anchor="H2.5.2UnixTimeStamp"]]
736 +Humidity:    Read:0248(H)=584(D)  Value:  584 / 10=58.4, So 58.4%
405 405  
406 -**Poll message flag & Ext:**
738 +If you want to use other I2C device, please refer the SHT20 part source code as reference.
407 407  
408 -[[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-20221006192726-1.png?width=754&height=112&rev=1.1||alt="图片-20221006192726-1.png" height="112" width="754"]]
409 409  
410 -**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** feature)
741 +==== 2.3.3.7  ​Distance Reading ====
411 411  
412 -**Poll Message Flag**: 1: This message is a poll message reply.
743 +Refer [[Ultrasonic Sensor section>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/#H2.4.8UltrasonicSensor]].
413 413  
414 -* Poll Message Flag is set to 1.
415 415  
416 -* Each data entry is 11 bytes, to save airtime and battery, devices will send max bytes according to the current DR and Frequency bands.
746 +==== 2.3.3.8 Ultrasonic Sensor ====
417 417  
418 -For example, in US915 band, the max payload for different DR is:
748 +This Fundamental Principles of this sensor can be found at this link: [[https:~~/~~/wiki.dfrobot.com/Weather_-_proof_Ultrasonic_Sensor_with_Separate_Probe_SKU~~_~~__SEN0208>>url:https://wiki.dfrobot.com/Weather_-_proof_Ultrasonic_Sensor_with_Separate_Probe_SKU___SEN0208]]
419 419  
420 -**a) DR0:** max is 11 bytes so one entry of data
750 +The SN50_v3 detects the pulse width of the sensor and converts it to mm output. The accuracy will be within 1 centimeter. The usable range (the distance between the ultrasonic probe and the measured object) is between 24cm and 600cm.
421 421  
422 -**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
752 +The working principle of this sensor is similar to the **HC-SR04** ultrasonic sensor.
423 423  
424 -**c) DR2:** total payload includes 11 entries of data
754 +The picture below shows the connection:
425 425  
426 -**d) DR3: **total payload includes 22 entries of data.
756 +[[image:image-20230512173903-6.png||height="596" width="715"]]
427 427  
428 -If devise doesn't have any data in the polling time. Device will uplink 11 bytes of 0   
758 +Connect to the SN50_v3 and run **AT+MOD=2** to switch to ultrasonic mode (ULT).
429 429  
760 +The ultrasonic sensor uses the 8^^th^^ and 9^^th^^ byte for the measurement value.
430 430  
431 431  **Example:**
432 432  
433 -If S31x-LB has below data inside Flash:
764 +Distance:  Read: 0C2D(Hex) = 3117(D)  Value:  3117 mm=311.7 cm
434 434  
435 -[[image:1682646494051-944.png]]
436 436  
437 -If user sends below downlink command: 3160065F9760066DA705
438 438  
439 -Where : Start time: 60065F97 = time 21/1/19 04:27:03
768 +==== 2.3.3.9  Battery Output - BAT pin ====
440 440  
441 - Stop time: 60066DA7= time 21/1/19 05:27:03
770 +The BAT pin of SN50v3 is connected to the Battery directly. If users want to use BAT pin to power an external sensor. User need to make sure the external sensor is of low power consumption. Because the BAT pin is always open. If the external sensor is of high power consumption. the battery of SN50v3-LB will run out very soon.
442 442  
443 443  
444 -**S31x-LB will uplink this payload.**
773 +==== 2.3.3.10  +5V Output ====
445 445  
446 -[[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="图片-20220523001219-13.png" height="421" width="727"]]
775 +SN50v3 will enable +5V output before all sampling and disable the +5v after all sampling. 
447 447  
448 -(((
449 -__**7FFF089801464160065F97**__ **__7FFF__ __088E__ __014B__ __41__ __60066009__** 7FFF0885014E41600660667FFF0875015141600662BE7FFF086B015541600665167FFF08660155416006676E7FFF085F015A41600669C67FFF0857015D4160066C1E
450 -)))
777 +The 5V output time can be controlled by AT Command.
451 451  
452 -(((
453 -Where the first 11 bytes is for the first entry:
454 -)))
779 +**AT+5VT=1000**
455 455  
456 -(((
457 -7FFF089801464160065F97
458 -)))
781 +Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.
459 459  
460 -(((
461 -**Ext sensor data**=0x7FFF/100=327.67
462 -)))
783 +By default the AT+5VT=500. If the external sensor which require 5v and require more time to get stable state, user can use this command to increase the power ON duration for this sensor.
463 463  
464 -(((
465 -**Temp**=0x088E/100=22.00
466 -)))
467 467  
468 -(((
469 -**Hum**=0x014B/10=32.6
470 -)))
471 471  
472 -(((
473 -**poll message flag & Ext**=0x41,means reply data,Ext=1
474 -)))
787 +==== 2.3.3.11  BH1750 Illumination Sensor ====
475 475  
476 -(((
477 -**Unix time** is 0x60066009=1611030423s=21/1/19 04:27:03
478 -)))
789 +MOD=1 support this sensor. The sensor value is in the 8^^th^^ and 9^^th^^ bytes.
479 479  
791 +[[image:image-20230512172447-4.png||height="416" width="712"]]
480 480  
481 -(% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" data-widget="image" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220, 220, 220, 0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" title="单击并拖动以调整大小" %)的(% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" data-widget="image" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220, 220, 220, 0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" title="单击并拖动以调整大小" %)的
793 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/image-20220628110012-12.png?rev=1.1||alt="image-20220628110012-12.png" height="361" width="953"]]
482 482  
483 -== 2.6 Temperature Alarm Feature ==
484 484  
796 +==== 2.3.3.12  Working MOD ====
485 485  
486 -S31x-LB work flow with Alarm feature.
798 +The working MOD info is contained in the Digital in & Digital Interrupt byte (7^^th^^ Byte).
487 487  
800 +User can use the 3^^rd^^ ~~ 7^^th^^  bit of this byte to see the working mod:
488 488  
489 -[[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="图片-20220623090437-1.png"]]
802 +Case 7^^th^^ Byte >> 2 & 0x1f:
490 490  
804 +* 0: MOD1
805 +* 1: MOD2
806 +* 2: MOD3
807 +* 3: MOD4
808 +* 4: MOD5
809 +* 5: MOD6
810 +* 6: MOD7
811 +* 7: MOD8
812 +* 8: MOD9
491 491  
492 -== 2.7 Frequency Plans ==
814 +== ==
493 493  
816 +== 2.4 Payload Decoder file ==
494 494  
495 -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.
496 496  
819 +In TTN, use can add a custom payload so it shows friendly reading
820 +
821 +In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**(%%) to add the decoder from:
822 +
823 +[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/SN50_v3-LB>>https://github.com/dragino/dragino-end-node-decoder/tree/main/SN50_v3-LB]]
824 +
825 +
826 +
827 +== 2.5 Frequency Plans ==
828 +
829 +
830 +The SN50v3-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.
831 +
497 497  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
498 498  
499 499  
500 -= 3. Configure S31x-LB =
835 += 3. Configure SN50v3-LB =
501 501  
502 502  == 3.1 Configure Methods ==
503 503  
504 504  
505 -S31x-LB supports below configure method:
840 +SN50v3-LB supports below configure method:
506 506  
507 507  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
508 508  * 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]].
... ... @@ -521,7 +521,7 @@
521 521  [[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/]]
522 522  
523 523  
524 -== 3.3 Commands special design for S31x-LB ==
859 +== 3.3 Commands special design for SN50v3-LB ==
525 525  
526 526  
527 527  These commands only valid for S31x-LB, as below:
... ... @@ -529,7 +529,6 @@
529 529  
530 530  === 3.3.1 Set Transmit Interval Time ===
531 531  
532 -
533 533  Feature: Change LoRaWAN End Node Transmit Interval.
534 534  
535 535  (% style="color:blue" %)**AT Command: AT+TDC**
... ... @@ -555,118 +555,167 @@
555 555  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
556 556  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
557 557  
892 +=== ===
893 +
558 558  === 3.3.2 Get Device Status ===
559 559  
896 +Send a LoRaWAN downlink to ask the device to send its status.
560 560  
561 -Send a LoRaWAN downlink to ask device send Alarm settings.
562 -
563 563  (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
564 564  
565 565  Sensor will upload Device Status via FPORT=5. See payload section for detail.
566 566  
567 567  
568 -=== 3.3.3 Set Temperature Alarm Threshold ===
903 +=== 3.3.3 Set Interrupt Mode ===
569 569  
570 -* (% style="color:blue" %)**AT Command:**
905 +Feature, Set Interrupt mode for GPIO_EXIT.
571 571  
572 -(% style="color:#037691" %)**AT+SHTEMP=min,max**
907 +(% style="color:blue" %)**AT Command: AT+INTMOD1，AT+INTMOD2，AT+INTMOD3**
573 573  
574 -* When min=0, and max≠0, Alarm higher than max
575 -* When min≠0, and max=0, Alarm lower than min
576 -* When min≠0 and max≠0, Alarm higher than max or lower than min
909 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
910 +|=(% style="width: 154px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3" %)**Function**|=(% style="width: 157px;background-color:#D9E2F3" %)**Response**
911 +|(% style="width:154px" %)AT+INTMOD1=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
912 +0
913 +OK
914 +the mode is 0 =Disable Interrupt
915 +)))
916 +|(% style="width:154px" %)AT+INTMOD1=2|(% style="width:196px" %)(((
917 +Set Transmit Interval
918 +0. (Disable Interrupt),
919 +~1. (Trigger by rising and falling edge)
920 +2. (Trigger by falling edge)
921 +3. (Trigger by rising edge)
922 +)))|(% style="width:157px" %)OK
923 +|(% style="width:154px" %)AT+INTMOD2=3|(% style="width:196px" %)(((
924 +Set Transmit Interval
577 577  
578 -Example:
926 +trigger by rising edge.
927 +)))|(% style="width:157px" %)OK
928 +|(% style="width:154px" %)AT+INTMOD3=0|(% style="width:196px" %)Disable Interrupt|(% style="width:157px" %)OK
579 579  
580 - AT+SHTEMP=0,30   ~/~/ Alarm when temperature higher than 30.
930 +(% style="color:blue" %)**Downlink Command: 0x06**
581 581  
582 -* (% style="color:blue" %)**Downlink Payload:**
932 +Format: Command Code (0x06) followed by 3 bytes.
583 583  
584 -(% style="color:#037691" %)**0x(0C 01 00 1E)**  (%%) ~/~/ Set AT+SHTEMP=0,30
934 +This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
585 585  
586 -(% style="color:red" %)**(note: 3^^rd^^ byte= 0x00 for low limit(not set), 4^^th^^ byte = 0x1E for high limit: 30)**
936 +* Example 1: Downlink Payload: 06000000  **~-~-->**  AT+INTMOD1=0
937 +* Example 2: Downlink Payload: 06000003  **~-~-->**  AT+INTMOD1=3
938 +* Example 3: Downlink Payload: 06000102  **~-~-->**  AT+INTMOD2=2
939 +* Example 4: Downlink Payload: 06000201  **~-~-->**  AT+INTMOD3=1
587 587  
941 +=== ===
588 588  
589 -=== 3.3.4 Set Humidity Alarm Threshold ===
943 +=== 3.3.4 Set Power Output Duration ===
590 590  
591 -* (% style="color:blue" %)**AT Command:**
945 +Control the output duration 5V . Before each sampling, device will
592 592  
593 -(% style="color:#037691" %)**AT+SHHUM=min,max**
947 +~1. first enable the power output to external sensor,
594 594  
595 -* When min=0, and max≠0, Alarm higher than max
596 -* When min≠0, and max=0, Alarm lower than min
597 -* When min≠0 and max≠0, Alarm higher than max or lower than min
949 +2. keep it on as per duration, read sensor value and construct uplink payload
598 598  
599 -Example:
951 +3. final, close the power output.
600 600  
601 - AT+SHHUM=70,0  ~/~/ Alarm when humidity lower than 70%.
953 +(% style="color:blue" %)**AT Command: AT+5VT**
602 602  
603 -* (% style="color:blue" %)**Downlink Payload:**
955 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
956 +|=(% style="width: 154px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3" %)**Function**|=(% style="width: 157px;background-color:#D9E2F3" %)**Response**
957 +|(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)(((
958 +500(default)
604 604  
605 -(% style="color:#037691" %)**0x(0C 02 46 00)**(%%)  ~/~/ Set AT+SHTHUM=70,0
960 +OK
961 +)))
962 +|(% style="width:154px" %)AT+5VT=1000|(% style="width:196px" %)(((
963 +Close after a delay of 1000 milliseconds.
964 +)))|(% style="width:157px" %)OK
606 606  
607 -(% style="color:red" %)**(note: 3^^rd^^ byte= 0x46 for low limit (70%), 4^^th^^ byte = 0x00 for high limit (not set))**
966 +(% style="color:blue" %)**Downlink Command: 0x07**
608 608  
968 +Format: Command Code (0x07) followed by 2 bytes.
609 609  
610 -=== 3.3.5 Set Alarm Interval ===
970 +The first and second bytes are the time to turn on.
611 611  
612 -The shortest time of two Alarm packet. (unit: min)
972 +* Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
973 +* Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
613 613  
614 -* (% style="color:blue" %)**AT Command:**
975 +=== ===
615 615  
616 -(% style="color:#037691" %)**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.
977 +=== 3.3.5 Set Weighing parameters ===
617 617  
618 -* (% style="color:blue" %)**Downlink Payload:**
979 +Feature: Working mode 5 is effective, weight initialization and weight factor setting of HX711.
619 619  
620 -(% style="color:#037691" %)**0x(0D 00 1E)**(%%)     **~-~--> ** Set AT+ATDC=0x 00 1E = 30 minutes
981 +(% style="color:blue" %)**AT Command: AT+WEIGRE,AT+WEIGAP**
621 621  
983 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
984 +|=(% style="width: 154px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3" %)**Function**|=(% style="width: 157px;background-color:#D9E2F3" %)**Response**
985 +|(% style="width:154px" %)AT+WEIGRE|(% style="width:196px" %)Weight is initialized to 0.|(% style="width:157px" %)OK
986 +|(% style="width:154px" %)AT+WEIGAP=？|(% style="width:196px" %)400.0|(% style="width:157px" %)OK(default)
987 +|(% style="width:154px" %)AT+WEIGAP=400.3|(% style="width:196px" %)Set the factor to 400.3.|(% style="width:157px" %)OK
622 622  
623 -=== 3.3.6 Get Alarm settings ===
989 +(% style="color:blue" %)**Downlink Command: 0x08**
624 624  
991 +Format: Command Code (0x08) followed by 2 bytes or 4 bytes.
625 625  
626 -Send a LoRaWAN downlink to ask device send Alarm settings.
993 +Use AT+WEIGRE when the first byte is 1, only 1 byte. When it is 2, use AT+WEIGAP, there are 3 bytes.
627 627  
628 -* (% style="color:#037691" %)**Downlink Payload:  **(%%)0x0E 01
995 +The second and third bytes are multiplied by 10 times to be the AT+WEIGAP value.
629 629  
630 -**Example:**
997 +* Example 1: Downlink Payload: 0801  **~-~-->**  AT+WEIGRE
998 +* Example 2: Downlink Payload: 08020FA3  **~-~-->**  AT+WEIGAP=400.3
999 +* Example 3: Downlink Payload: 08020FA0  **~-~-->**  AT+WEIGAP=400.0
631 631  
632 -[[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/1655948182791-225.png?rev=1.1||alt="1655948182791-225.png"]]
1001 +=== ===
633 633  
1003 +=== 3.3.6 Set Digital pulse count value ===
634 634  
635 -**Explain:**
1005 +Feature: Set the pulse count value.
636 636  
637 -* Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message.
1007 +Count 1 is PA8 pin of mode 6 and mode 9. Count 2 is PA4 pin of mode 9.
638 638  
639 -=== 3.3.7 Set Interrupt Mode ===
1009 +(% style="color:blue" %)**AT Command: AT+SETCNT**
640 640  
1011 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1012 +|=(% style="width: 154px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3" %)**Function**|=(% style="width: 157px;background-color:#D9E2F3" %)**Response**
1013 +|(% style="width:154px" %)AT+SETCNT=1,100|(% style="width:196px" %)Initialize the count value 1 to 100.|(% style="width:157px" %)OK
1014 +|(% style="width:154px" %)AT+SETCNT=2,0|(% style="width:196px" %)Initialize the count value 2 to 0.|(% style="width:157px" %)OK
641 641  
642 -Feature, Set Interrupt mode for GPIO_EXIT.
1016 +(% style="color:blue" %)**Downlink Command: 0x09**
643 643  
644 -(% style="color:blue" %)**AT Command: AT+INTMOD**
1018 +Format: Command Code (0x09) followed by 5 bytes.
645 645  
1020 +The first byte is to select which count value to initialize, and the next four bytes are the count value to be initialized.
1021 +
1022 +* Example 1: Downlink Payload: 090100000000  **~-~-->**  AT+SETCNT=1,0
1023 +* Example 2: Downlink Payload: 0902000003E8  **~-~-->**  AT+SETCNT=2,1000
1024 +
1025 +=== ===
1026 +
1027 +=== 3.3.7 Set Workmode ===
1028 +
1029 +Feature: Switch working mode.
1030 +
1031 +(% style="color:blue" %)**AT Command: AT+MOD**
1032 +
646 646  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
647 647  |=(% style="width: 154px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3" %)**Function**|=(% style="width: 157px;background-color:#D9E2F3" %)**Response**
648 -|(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
649 -0
1035 +|(% style="width:154px" %)AT+MOD=?|(% style="width:196px" %)Get the current working mode.|(% style="width:157px" %)(((
650 650  OK
651 -the mode is 0 =Disable Interrupt
652 652  )))
653 -|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
654 -Set Transmit Interval
655 -0. (Disable Interrupt),
656 -~1. (Trigger by rising and falling edge)
657 -2. (Trigger by falling edge)
658 -3. (Trigger by rising edge)
659 -)))|(% style="width:157px" %)OK
1038 +|(% style="width:154px" %)AT+MOD=4|(% style="width:196px" %)Set the working mode to 3DS18B20s.|(% style="width:157px" %)(((
1039 +OK
660 660  
661 -(% style="color:blue" %)**Downlink Command: 0x06**
1041 +Attention:Take effect after ATZ
1042 +)))
662 662  
663 -Format: Command Code (0x06) followed by 3 bytes.
1044 +(% style="color:blue" %)**Downlink Command: 0x0A**
664 664  
665 -This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
1046 +Format: Command Code (0x0A) followed by 1 bytes.
666 666  
667 -* Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
668 -* Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
1048 +* Example 1: Downlink Payload: 0A01  **~-~-->**  AT+MOD=1
1049 +* Example 2: Downlink Payload: 0A04  **~-~-->**  AT+MOD=4
669 669  
1051 += =
1052 +
670 670  = 4. Battery & Power Consumption =
671 671  
672 672  
... ... @@ -695,7 +695,10 @@
695 695  
696 696  = 6. FAQ =
697 697  
1081 +== 6.1 Where can i find source code of SN50v3-LB? ==
698 698  
1083 +* **[[Hardware Source Files>>https://github.com/dragino/Lora/tree/master/LSN50/v3.0]].**
1084 +* **[[Software Source Code & Compile instruction>>https://github.com/dragino/SN50v3]].**
699 699  
700 700  = 7. Order Info =
701 701  
... ... @@ -737,4 +737,4 @@
737 737  
738 738  
739 739  * 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.
740 -* 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:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]
1126 +* 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.cc>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.cc]]
image-20230512163509-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +1.5 MB
Content
image-20230512164658-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +2.0 MB
Content
image-20230512170701-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +2.5 MB
Content
image-20230512172447-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +2.0 MB
Content
image-20230512173758-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +2.1 MB
Content
image-20230512173903-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +2.3 MB
Content
image-20230512180609-7.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +2.3 MB
Content
image-20230512180718-8.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +2.3 MB
Content
image-20230512181814-9.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +2.2 MB
Content
image-20230513084523-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +611.3 KB
Content
image-20230513102034-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +607.1 KB
Content
image-20230513103633-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +595.5 KB
Content
image-20230513105207-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +384.7 KB
Content
image-20230513105351-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +37.6 KB
Content
image-20230513110214-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +172.7 KB
Content
image-20230513111203-7.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +79.9 KB
Content
image-20230513111231-8.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +64.9 KB
Content
image-20230513111255-9.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +70.4 KB
Content
image-20230513134006-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +1.9 MB
Content
image-20230515135611-1.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +948.0 KB
Content

Applications

Navigation

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