Changes for page SN50v3-LB/LS -- LoRaWAN Sensor Node User Manual

Last modified by Bei Jinggeng on 2025/01/10 15:51

From version < 13.1 >

edited by Edwin Chen
on 2023/05/11 23:11

To version < 14.1 >

edited by Edwin Chen
on 2023/05/11 23:21

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -288,7 +288,6 @@
 . All modes share the same Payload Explanation from HERE.
 . By default, the device will send an uplink message every 20 minutes.
--
  ==== 2.3.2.1  MOD~=1 (Default Mode) ====
  In this mode, uplink payload includes in total 11 bytes. Uplink packets use FPORT=2.
@@ -395,8 +395,6 @@
  [[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"]]
--(% class="wikigeneratedid" %)
--===   ===
  ==== 2.3.2.5  MOD~=5(Weight Measurement by HX711) ====
@@ -428,8 +428,6 @@
  [[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"]]
--(% class="wikigeneratedid" %)
--===   ===
  ==== 2.3.2.6  MOD~=6 (Counting Mode) ====
@@ -460,7 +460,6 @@
  Digital in(PA12)&Digital Interrupt1(PB14)
  )))|Digital Interrupt2(PB15)|Digital Interrupt3(PA4)|Reserved
--
  ==== 2.3.2.8  MOD~=8 （3ADC+1DS18B20） ====
  |=(((
@@ -479,8 +479,6 @@
  [[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-20220823164903-2.png?rev=1.1||alt="image-20220823164903-2.png"]]
--(% class="wikigeneratedid" %)
--===   ===
  ==== 2.3.2.9  MOD~=9 (3DS18B20+ two Interrupt count mode) ====
@@ -518,8 +518,10 @@
  When AA is 2, set the count of PB15 pin to BB    Corresponding downlink：09 02 bb bb bb bb
--=== 2.3.10  Decode payload in The Things Network ===
++
++=== 2.3.3  Decode payload ===
++
  While using TTN V3 network, you can add the payload format to decode the payload.
  [[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"]]
@@ -526,39 +526,28 @@
  The payload decoder function for TTN V3 are here:
--LSN50 TTN V3 Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]]
++SN50v3 TTN V3 Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]]
--Sensor Data is uplink via FPORT=2
++==== 2.3.3.1  Battery Info ====
--(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
--|=(% style="width: 90px;background-color:#D9E2F3" %)(((
--**Size(bytes)**
--)))|=(% 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
--|(% style="width:99px" %)**Value**|(% style="width:69px" %)(((
--[[Battery>>||anchor="HBattery:"]]
--)))|(% style="width:130px" %)(((
--[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
--)))|(% style="width:91px" %)(((
--[[Alarm Flag>>||anchor="HAlarmFlag26MOD:"]]
--)))|(% style="width:103px" %)(((
--[[Temperature>>||anchor="HTemperature:"]]
--)))|(% style="width:80px" %)(((
--[[Humidity>>||anchor="HHumidity:"]]
--)))
++Check the battery voltage for SN50v3.
--==== (% style="color:#4472c4" %)**Battery**(%%) ====
--
--Sensor Battery Level.
--
  Ex1: 0x0B45 = 2885mV
  Ex2: 0x0B49 = 2889mV
++==== 2.3.3.2  Temperature (DS18B20) ====
--==== (% style="color:#4472c4" %)**Temperature**(%%) ====
++If there is a DS18B20 connected to PB3 pin. The temperature will be uploaded in the payload.
++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]]
++
++**Connection:**
++
++[[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/1656378573379-646.png?rev=1.1||alt="1656378573379-646.png"]]
++
  **Example**:
  If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
@@ -568,26 +568,224 @@
  （FF3F & 8000：Judge whether the highest bit is 1, when the highest bit is 1, it is negative）
--==== (% style="color:#4472c4" %)**Humidity**(%%) ====
++==== 2.3.3.3  Digital Input ====
++The digital input for pin PA12,
--Read:0x(0197)=412    Value:  412 / 10=41.2, So 41.2%
++* When PA12 is high, the bit 1 of payload byte 6 is 1.
++* When PA12 is low, the bit 1 of payload byte 6 is 0.
--==== (% style="color:#4472c4" %)**Alarm Flag& MOD**(%%) ====
++==== 2.3.3.4  Analogue Digital Converter (ADC) ====
++The ADC pins in LSN50 can measure range from 0~~Vbat, it use reference voltage from . If user need to measure a voltage > VBat, please use resistors to divide this voltage to lower than VBat, otherwise, it may destroy the ADC pin.
++Note: minimum VBat is 2.5v, when batrrey lower than this value. Device won't be able to send LoRa Uplink.
++
++The ADC monitors the voltage on the PA0 line, in mV.
++
++Ex: 0x021F = 543mv,
++
++**~ Example1:**  Reading an Oil Sensor (Read a resistance value):
++
++
++[[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-20220627172409-28.png?rev=1.1||alt="image-20220627172409-28.png"]]
++
++In the LSN50, we can use PB4 and PA0 pin to calculate the resistance for the oil sensor.
++
++
++**Steps:**
++
++1. Solder a 10K resistor between PA0 and VCC.
++1. Screw oil sensor's two pins to PA0 and PB4.
++
++The equipment circuit is as below:
++
++[[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-20220627172500-29.png?rev=1.1||alt="image-20220627172500-29.png"]]
++
++According to above diagram:
++
++[[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-20220628091043-4.png?rev=1.1||alt="image-20220628091043-4.png"]]
++
++So
++
++[[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-20220628091344-6.png?rev=1.1||alt="image-20220628091344-6.png"]]
++
++[[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-20220628091621-8.png?rev=1.1||alt="image-20220628091621-8.png"]]  is the reading of ADC. So if ADC=0x05DC=0.9 v and VCC (BAT) is 2.9v
++
++The [[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-20220628091702-9.png?rev=1.1||alt="image-20220628091702-9.png"]]  4.5K ohm
++
++Since the Bouy is linear resistance from 10 ~~ 70cm.
++
++The position of Bouy is  [[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-20220628091824-10.png?rev=1.1||alt="image-20220628091824-10.png"]]  , from the bottom of Bouy.
++
++
++==== 2.3.3.5  Digital Interrupt ====
++
++Digital Interrupt refers to pin PB14, and there are different trigger methods. When there is a trigger, the SN50v3 will send a packet to the server.
++
++**~ Interrupt connection method:**
++
++[[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/1656379178634-321.png?rev=1.1||alt="1656379178634-321.png"]]
++
++**Example to use with door sensor :**
++
++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.
++
++[[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"]]
++
++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 LSN50 interrupt interface to detect the status for the door or window.
++
++**~ Below is the installation example:**
++
++Fix one piece of the magnetic sensor to the door and connect the two pins to LSN50 as follows:
++
++* (((
++One pin to LSN50's PB14 pin
++)))
++* (((
++The other pin to LSN50's VCC pin
++)))
++
++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 PB14 will be at the VCC voltage.
++
++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.
++
++When door sensor is shorted, there will extra power consumption in the circuit, the extra current is 3v3/R14 = 3v2/1Mohm = 0.3uA which can be ignored.
++
++[[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"]]
++
++The above photos shows the two parts of the magnetic switch fitted to a door.
++
++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.
++
++The command is:
++
++**AT+INTMOD=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]]**. **)
++
++Below shows some screen captures in TTN V3:
++
++[[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"]]
++
++In MOD=1, user can use byte 6 to see the status for door open or close. TTN V3 decoder is as below:
++
++door= (bytes[6] & 0x80)? "CLOSE":"OPEN";
++
++**Notice for hardware version LSN50 v1 < v1.3** (produced before 2018-Nov).
++
++In this hardware version, there is no R14 resistance solder. When use the latest firmware, it should set AT+INTMOD=0 to close the interrupt. If user need to use Interrupt in this hardware version, user need to solder R14 with 10M resistor and C1 (0.1uF) on board.
++
++[[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/1656379563303-771.png?rev=1.1||alt="1656379563303-771.png"]]
++
++
++==== 2.3.3.6  I2C Interface (SHT20) ====
++
++The PB6(SDA) and PB7(SCK) are I2C interface lines. You can use these to connect to an I2C device and get the sensor data.
++
++We have made an example to show how to use the I2C interface to connect to the SHT20 Temperature and Humidity Sensor. This is supported in the stock firmware since v1.5 with **AT+MOD=1 (default value).**
++
++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 code in LSN50 will be a good reference.
++
++Below is the connection to SHT20/ SHT31. The connection is as below:
++
++[[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-20220902163605-2.png?rev=1.1||alt="image-20220902163605-2.png"]]
++
++The device will be able to get the I2C sensor data now and upload to IoT Server.
++
++[[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"]]
++
++Convert the read byte to decimal and divide it by ten.
++
  **Example:**
--If payload & 0x01 = 0x01  **~-~->** This is an Alarm Message
++Temperature:  Read:0116(H) = 278(D)  Value:  278 /10=27.8℃;
--If payload & 0x01 = 0x00  **~-~->** This is a normal uplink message, no alarm
++Humidity:    Read:0248(H)=584(D)       Value:  584 / 10=58.4, So 58.4%
--If payload >> 2 = 0x00     **~-~->**  means MOD=1, This is a sampling uplink message
++If you want to use other I2C device, please refer the SHT20 part source code as reference.
--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.
++==== 2.3.3.7  Distance Reading ====
++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]].
++
++
++==== 2.3.3.8  Ultrasonic Sensor ====
++
++The LSN50 v1.5 firmware supports ultrasonic sensor (with AT+MOD=2) such as SEN0208 from DF-Robot. 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]]
++
++The LSN50 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.
++
++The picture below shows the connection:
++
++[[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/1656380061365-178.png?rev=1.1||alt="1656380061365-178.png"]]
++
++Connect to the LSN50 and run **AT+MOD=2** to switch to ultrasonic mode (ULT).
++
++The ultrasonic sensor uses the 8^^th^^ and 9^^th^^ byte for the measurement value.
++
++**Example:**
++
++Distance:  Read: 0C2D(Hex) = 3117(D)  Value:  3117 mm=311.7 cm
++
++[[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/1656384895430-327.png?rev=1.1||alt="1656384895430-327.png"]]
++
++[[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/1656384913616-455.png?rev=1.1||alt="1656384913616-455.png"]]
++
++You can see the serial output in ULT mode as below:
++
++[[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/1656384939855-223.png?rev=1.1||alt="1656384939855-223.png"]]
++
++**In TTN V3 server:**
++
++[[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/1656384961830-307.png?rev=1.1||alt="1656384961830-307.png"]]
++
++[[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/1656384973646-598.png?rev=1.1||alt="1656384973646-598.png"]]
++
++==== 2.3.3.9  Battery Output - BAT pin ====
++
++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.
++
++
++==== 2.3.3.10  +5V Output ====
++
++SN50v3 will enable +5V output before all sampling and disable the +5v after all sampling.
++
++The 5V output time can be controlled by AT Command.
++
++**AT+5VT=1000**
++
++Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.
++
++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.
++
++
++
++==== 2.3.3.11  BH1750 Illumination Sensor ====
++
++MOD=1 support this sensor. The sensor value is in the 8^^th^^ and 9^^th^^ bytes.
++
++[[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-11.jpeg?rev=1.1||alt="image-20220628110012-11.jpeg"]]
++
++[[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"]]
++
++
++==== 2.3.3.12  Working MOD ====
++
++The working MOD info is contained in the Digital in & Digital Interrupt byte (7^^th^^ Byte).
++
++User can use the 3^^rd^^ ~~ 7^^th^^   bit of this byte to see the working mod:
++
++Case 7^^th^^ Byte >> 2 & 0x1f:
++
++* 0: MOD1
++* 1: MOD2
++* 2: MOD3
++* 3: MOD4
++* 4: MOD5
++* 5: MOD6
++
++
  == 2.4 Payload Decoder file ==

Changes for page SN50v3-LB/LS -- LoRaWAN Sensor Node User Manual

Summary

Details

Applications

Navigation