How to connect 3rd party sensor to Dragino Wireless End Node

== 1.RS485-LB connects to third-party sensors ==

== How to connect RS485-LB node to UART distance sensor? ==

Take the A16-15 as an example, but the same setup can support different distance sensors, compare specifications see this [[link>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS04-LB_LoRaWAN_4-Channels_Distance_Detection_Sensor_User_Manual/#H1.4ProbeOptions]] to DDS04-LB.

12

13

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/RS485-LB_Waterproof_RS485UART_to_LoRaWAN_Converter/WebHome/image-20240703151202-1.png?rev=1.1||alt="image-20240703151202-1.png"]]

* (((

**Connection：**

)))

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/RS485-LB_Waterproof_RS485UART_to_LoRaWAN_Converter/WebHome/image-20240703153033-2.jpeg?width=687&height=364&rev=1.1||alt="image-20240703153033-2.jpeg" height="364" width="687"]]

20

21

* **AT command configuration: **

**AT+MOD=2 **

**AT+COMMAND1=01 02 03 04 05 ,0 AT+SEARCH1=1,ff AT+DATACUT1=4,2,2~~3 AT+CMDDL1=1000**

26

27

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/RS485-LB_Waterproof_RS485UART_to_LoRaWAN_Converter/WebHome/image-20240703153540-3.png?rev=1.1||alt="image-20240703153540-3.png"]]

28

29

* **Decoder: Decoding refer to this [[link>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/RS485-LB_A16-15]].**

30

* **Example in TTN:**

31

32

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/RS485-LB_Waterproof_RS485UART_to_LoRaWAN_Converter/WebHome/image-20240703161941-4.png?width=1357&height=619&rev=1.1||alt="image-20240703161941-4.png" height="619" width="1357"]]

33

34

== 2.SN50v3-LB connects to third-party sensors ==

=== 2.3.2 Working Modes & Sensor Data. Uplink via FPORT~=2 ===

39

40

SN50v3-LB/LS has different working mode for the connections of different type of sensors. This section describes these modes. Use can use the AT Command (% style="color:blue" %)**AT+MOD**(%%) to set SN50v3-LB/LS to different working modes.

For example:

(% style="color:blue" %)**AT+MOD=2 ** (%%) ~/~/ will set the SN50v3 to work in MOD=2 distance mode which target to measure distance via Ultrasonic Sensor.

45

46

47

(% style="color:red" %) **Important Notice:**

48

49

~1. Some working modes has payload more than 12 bytes, The US915/AU915/AS923 frequency bands' definition has maximum 11 bytes in (% style="color:blue" %)**DR0**(%%). Server sides will see NULL payload while SN50v3-LB/LS transmit in DR0 with 12 bytes payload.

50

51

2. All modes share the same Payload Explanation from HERE.

52

53

3. By default, the device will send an uplink message every 20 minutes.

54

55

==== 2.3.2.1 MOD~=1 (Default Mode) ====

56

57

In this mode, uplink payload includes in total 11 bytes. Uplink packets use FPORT=2.

58

59

(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:517px" %)

60

|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:20px" %)**2**|(% style="background-color:#4f81bd; color:white; width:100px" %)**2**|(% style="background-color:#4f81bd; color:white; width:50px" %)**2**|(% style="background-color:#4f81bd; color:white; width:90px" %)**1**|(% style="background-color:#4f81bd; color:white; width:128px" %)**2**|(% style="background-color:#4f81bd; color:white; width:79px" %)**2**

61

|Value|Bat|(% style="width:191px" %)(((

62

Temperature(DS18B20)(PC13)

63

)))|(% style="width:78px" %)(((

64

ADC(PA4)

65

)))|(% style="width:216px" %)(((

66

Digital in(PB15)&Digital Interrupt(PA8)

67

)))|(% style="width:308px" %)(((

68

Temperature(SHT20 or SHT31 or BH1750 Illumination Sensor)

69

)))|(% style="width:154px" %)(((

70

Humidity(SHT20 or SHT31)

71

)))

72

73

[[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"]]

74

75

==== 2.3.2.2 MOD~=2 (Distance Mode) ====

76

77

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.

78

79

(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:517px" %)

80

|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:29px" %)**2**|(% style="background-color:#4f81bd; color:white; width:108px" %)**2**|(% style="background-color:#4f81bd; color:white; width:40px" %)**2**|(% style="background-color:#4f81bd; color:white; width:110px" %)**1**|(% style="background-color:#4f81bd; color:white; width:140px" %)**2**|(% style="background-color:#4f81bd; color:white; width:40px" %)**2**

81

|Value|BAT|(% style="width:196px" %)(((

82

Temperature(DS18B20)(PC13)

83

)))|(% style="width:87px" %)(((

84

ADC(PA4)

85

)))|(% style="width:189px" %)(((

86

Digital in(PB15) & Digital Interrupt(PA8)

87

)))|(% style="width:208px" %)(((

88

Distance measure by: 1) LIDAR-Lite V3HP

89

Or 2) Ultrasonic Sensor

90

)))|(% style="width:117px" %)Reserved

91

92

[[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"]]

93

94

(% style="color:blue" %)**Connection of LIDAR-Lite V3HP:**

95

96

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230512173758-5.png?width=712&height=563&rev=1.1||alt="image-20230512173758-5.png"]]

97

98

(% style="color:blue" %)**Connection to Ultrasonic Sensor:**

99

100

(% style="color:red" %)**Need to remove R1 and R2 resistors to get low power,otherwise there will be 240uA standby current.**

101

102

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230512173903-6.png?width=715&height=596&rev=1.1||alt="image-20230512173903-6.png"]]

103

104

For the connection to TF-Mini or TF-Luna , MOD2 payload is as below:

105

106

(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:517px" %)

107

|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:20px" %)**2**|(% style="background-color:#4f81bd; color:white; width:100px" %)**2**|(% style="background-color:#4f81bd; color:white; width:100px" %)**1**|(% style="background-color:#4f81bd; color:white; width:50px" %)**2**|(% style="background-color:#4f81bd; color:white; width:120px" %)**2**|(% style="background-color:#4f81bd; color:white; width:77px" %)**2**

108

|Value|BAT|(% style="width:183px" %)(((

109

Temperature(DS18B20)(PC13)

110

)))|(% style="width:173px" %)(((

111

Digital in(PB15) & Digital Interrupt(PA8)

112

)))|(% style="width:84px" %)(((

113

ADC(PA4)

114

)))|(% style="width:323px" %)(((

115

Distance measure by:1)TF-Mini plus LiDAR

116

Or 2) TF-Luna LiDAR

117

)))|(% style="width:188px" %)Distance signal strength

118

119

[[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"]]

120

121

**Connection to [[TF-Mini plus>>url:http://en.benewake.com/product/detail/5c345cd0e5b3a844c472329b.html]] LiDAR(UART version):**

122

123

(% style="color:red" %)**Need to remove R3 and R4 resistors to get low power,otherwise there will be 400uA standby current**[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230512180609-7.png?width=802&height=555&rev=1.1||alt="image-20230512180609-7.png"]]

124

125

**Connection to [[TF-Luna>>url:http://en.benewake.com/product/detail/5e1c1fd04d839408076b6255.html]] LiDAR (UART version):**

126

127

(% style="color:red" %)**Need to remove R3 and R4 resistors to get low power,otherwise there will be 400uA standby current**

128

129

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230610170047-1.png?width=799&height=452&rev=1.1||alt="image-20230610170047-1.png"]]

130

131

==== 2.3.2.3 MOD~=3 (3 ADC + I2C) ====

132

133

134

This mode has total 12 bytes. Include 3 x ADC + 1x I2C

135

136

(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:517px" %)

137

|=(% style="width: 50px;background-color:#4F81BD;color:white" %)(((

138

**Size(bytes)**

139

)))|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 110px;background-color:#4F81BD;color:white" %)2|=(% style="width: 97px;background-color:#4F81BD;color:white" %)2|=(% style="width: 20px;background-color:#4F81BD;color:white" %)1

140

|Value|(% style="width:68px" %)(((

141

ADC1(PA4)

142

)))|(% style="width:75px" %)(((

ADC2(PA5)

)))|(((

ADC3(PA8)

)))|(((

Digital Interrupt(PB15)

148

)))|(% style="width:304px" %)(((

149

Temperature(SHT20 or SHT31 or BH1750 Illumination Sensor)

150

)))|(% style="width:163px" %)(((

151

Humidity(SHT20 or SHT31)

152

)))|(% style="width:53px" %)Bat

153

[[image:image-20230513110214-6.png]]

154

155

==== 2.3.2.4 MOD~=4 (3 x DS18B20) ====

156

157

This mode has total 11 bytes. As shown below:

158

159

(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:517px" %)

160

|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:20px" %)**2**|(% style="background-color:#4f81bd; color:white; width:100px" %)**2**|(% style="background-color:#4f81bd; color:white; width:50px" %)**2**|(% style="background-color:#4f81bd; color:white; width:99px" %)**1**|(% style="background-color:#4f81bd; color:white; width:99px" %)**2**|(% style="background-color:#4f81bd; color:white; width:99px" %)**2**

161

|Value|BAT|(% style="width:186px" %)(((

162

Temperature1(DS18B20)(PC13)

163

)))|(% style="width:82px" %)(((

164

ADC(PA4)

165

)))|(% style="width:210px" %)(((

166

Digital in(PB15) & Digital Interrupt(PA8)

167

)))|(% style="width:191px" %)Temperature2(DS18B20)

168

(PB9)|(% style="width:183px" %)Temperature3(DS18B20)(PB8)

169

170

[[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"]]

171

172

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230513134006-1.png?width=736&height=559&rev=1.1||alt="image-20230513134006-1.png"]]

173

174

==== 2.3.2.5 MOD~=5(Weight Measurement by HX711) ====

175

176

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230512164658-2.png?width=729&height=532&rev=1.1||alt="image-20230512164658-2.png"]]

177

178

Each HX711 need to be calibrated before used. User need to do below two steps:

179

180

1. Zero calibration. Don't put anything on load cell and run (% style="color:blue" %)**AT+WEIGRE**(%%) to calibrate to Zero gram.

181

1. Adjust calibration factor (default value 400): Put a known weight thing on load cell and run (% style="color:blue" %)**AT+WEIGAP**(%%) to adjust the Calibration Factor.

182

1. (((

183

Weight has 4 bytes, the unit is g.

)))

For example:

(% style="color:blue" %)**AT+GETSENSORVALUE =0**

192

193

Response: Weight is 401 g

194

195

Check the response of this command and adjust the value to match the real value for thing.

196

197

(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:517px" %)

198

|=(% style="width: 50px;background-color:#4F81BD;color:white" %)(((

199

**Size(bytes)**

200

)))|=(% style="width: 20px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 150px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 198px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 49px;background-color:#4F81BD;color:white" %)**4**

201

|Value|BAT|(% style="width:193px" %)(((

202

Temperature(DS18B20)(PC13)

203

)))|(% style="width:85px" %)(((

204

ADC(PA4)

205

)))|(% style="width:186px" %)(((

206

Digital in(PB15) & Digital Interrupt(PA8)

207

)))|(% style="width:100px" %)Weight

208

209

[[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"]]

210

211

==== 2.3.2.6 MOD~=6 (Counting Mode) ====

212

213

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.

214

215

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.

216

217

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230512181814-9.png?width=697&height=543&rev=1.1||alt="image-20230512181814-9.png"]]

218

219

(% style="color:red" %)**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.**

220

221

(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:517px" %)

222

|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**Size(bytes)**|=(% style="width: 40px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 180px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 100px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 77px;background-color:#4F81BD;color:white" %)**4**

223

|Value|BAT|(% style="width:256px" %)(((

224

Temperature(DS18B20)(PC13)

225

)))|(% style="width:108px" %)(((

226

ADC(PA4)

227

)))|(% style="width:126px" %)(((

228

Digital in(PB15)

229

)))|(% style="width:145px" %)(((

Count(PA8)

)))

[[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"]]

234

235

==== 2.3.2.7 MOD~=7 (Three interrupt contact modes) ====

236

237

(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:517px" %)

238

|=(% style="width: 50px;background-color:#4F81BD;color:white" %)(((

239

**Size(bytes)**

240

)))|=(% style="width: 20px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 89px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 89px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 89px;background-color:#4F81BD;color:white" %)1|=(% style="width: 40px;background-color:#4F81BD;color:white" %)2

241

|Value|BAT|(% style="width:188px" %)(((

242

Temperature(DS18B20)

243

(PC13)

244

)))|(% style="width:83px" %)(((

245

ADC(PA5)

246

)))|(% style="width:184px" %)(((

247

Digital Interrupt1(PA8)

248

)))|(% style="width:186px" %)Digital Interrupt2(PA4)|(% style="width:197px" %)Digital Interrupt3(PB15)|(% style="width:100px" %)Reserved

249

250

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230513111203-7.png?width=975&height=324&rev=1.1||alt="image-20230513111203-7.png"]]

251

252

==== 2.3.2.8 MOD~=8 （3ADC+1DS18B20） ====

253

254

(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:517px" %)

255

|=(% style="width: 50px;background-color:#4F81BD;color:white" %)(((

256

**Size(bytes)**

257

)))|=(% style="width: 30px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 110px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 70px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 119px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 69px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 69px;background-color:#4F81BD;color:white" %)2

258

|Value|BAT|(% style="width:207px" %)(((

259

Temperature(DS18B20)

260

(PC13)

261

)))|(% style="width:94px" %)(((

262

ADC1(PA4)

263

)))|(% style="width:198px" %)(((

264

Digital Interrupt(PB15)

265

)))|(% style="width:84px" %)(((

266

ADC2(PA5)

267

)))|(% style="width:82px" %)(((

ADC3(PA8)

)))

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230513111231-8.png?width=900&height=335&rev=1.1||alt="image-20230513111231-8.png"]]

272

273

==== 2.3.2.9 MOD~=9 (3DS18B20+ two Interrupt count mode) ====

274

275

(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:517px" %)

276

|=(% style="width: 50px;background-color:#4F81BD;color:white" %)(((

277

**Size(bytes)**

278

)))|=(% style="width: 20px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 89px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 59px;background-color:#4F81BD;color:white" %)4|=(% style="width: 59px;background-color:#4F81BD;color:white" %)4

|Value|BAT|(((

Temperature

(DS18B20)(PC13)

)))|(((

Temperature2

(DS18B20)(PB9)

)))|(((

Digital Interrupt

(PB15)

)))|(% style="width:193px" %)(((

289

Temperature3

290

(DS18B20)(PB8)

291

)))|(% style="width:78px" %)(((

292

Count1(PA8)

293

)))|(% style="width:78px" %)(((

Count2(PA4)

)))

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230513111255-9.png?width=899&height=341&rev=1.1||alt="image-20230513111255-9.png"]]

298

299

(% style="color:blue" %)**The newly added AT command is issued correspondingly:**

300

301

(% style="color:#037691" %)** AT+INTMOD1 PA8**(%%) pin： Corresponding downlink: (% style="color:#037691" %)**06 00 00 xx**

302

303

(% style="color:#037691" %)** AT+INTMOD2 PA4**(%%) pin： Corresponding downlink: (% style="color:#037691" %)**06 00 01 xx**

304

305

(% style="color:#037691" %)** AT+INTMOD3 PB15**(%%) pin： Corresponding downlink: (% style="color:#037691" %)** 06 00 02 xx**

306

307

308

(% style="color:blue" %)**AT+SETCNT=aa,bb**

309

310

When AA is 1, set the count of PA8 pin to BB Corresponding downlink：09 01 bb bb bb bb

311

312

When AA is 2, set the count of PA4 pin to BB Corresponding downlink：09 02 bb bb bb bb

313

314

315

==== 2.3.2.10 MOD~=10 (PWM input capture and output mode，Since firmware v1.2) ====

316

317

(% style="color:red" %)**Note: Firmware not release, contact Dragino for testing.**

318

319

In this mode, the uplink can perform PWM input capture, and the downlink can perform PWM output.

320

321

[[It should be noted when using PWM mode.>>||anchor="H2.3.3.12A0PWMMOD"]]

322

323

324

===== 2.3.2.10.a Uplink, PWM input capture =====

325

326

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230817172209-2.png?width=683&height=439&rev=1.1||alt="image-20230817172209-2.png"]]

327

328

(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:515px" %)

329

|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:20px" %)**2**|(% style="background-color:#4f81bd; color:white; width:100px" %)**2**|(% style="background-color:#4f81bd; color:white; width:50px" %)**2**|(% style="background-color:#4f81bd; color:white; width:135px" %)**1**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:90px" %)**2**

330

|Value|Bat|(% style="width:191px" %)(((

331

Temperature(DS18B20)(PC13)

332

)))|(% style="width:78px" %)(((

333

ADC(PA4)

334

)))|(% style="width:135px" %)(((

335

PWM_Setting

336

&Digital Interrupt(PA8)

337

)))|(% style="width:70px" %)(((

338

Pulse period

339

)))|(% style="width:89px" %)(((

340

Duration of high level

341

)))

342

343

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230817170702-1.png?width=1044&height=161&rev=1.1||alt="image-20230817170702-1.png"]]

344

345

When the device detects the following PWM signal ,decoder will converts the pulse period and high-level duration to frequency and duty cycle.

**Frequency：**

(% class="MsoNormal" %)

350

(% lang="EN-US" %)If (% style="background-attachment:initial; background-clip:initial; background-image:initial; background-origin:initial; background-position:initial; background-repeat:initial; background-size:initial; color:blue; font-family:Arial,sans-serif" %)**AT+PWMSET**(%%)**=0, **(% lang="EN-US" %)Frequency= 1000000/(%%)Pulse period（HZ）;

351

352

(% class="MsoNormal" %)

353

(% lang="EN-US" %)If (% style="background-attachment:initial; background-clip:initial; background-image:initial; background-origin:initial; background-position:initial; background-repeat:initial; background-size:initial; color:blue; font-family:Arial,sans-serif" %)**AT+PWMSET**(%%)**=1, **(% lang="EN-US" %)Frequency= 1000/(%%)Pulse period（HZ）;

354

355

356

(% class="MsoNormal" %)

357

**Duty cycle:**

358

359

Duty cycle= Duration of high level/ Pulse period*100 ~(%).

360

361

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230818092200-1.png?width=627&height=344&rev=1.1||alt="image-20230818092200-1.png"]]

362

363

===== 2.3.2.10.b Uplink, PWM output =====

364

365

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230817172209-2.png?width=683&height=439&rev=1.1||alt="image-20230817172209-2.png"]]

366

367

368

(% style="background-attachment:initial; background-clip:initial; background-image:initial; background-origin:initial; background-position:initial; background-repeat:initial; background-size:initial; color:blue; font-family:Arial,sans-serif" %)**AT+PWMOUT=a,b,c**

369

370

a is the time delay of the output, the unit is ms.

371

372

b is the output frequency, the unit is HZ.

373

374

c is the duty cycle of the output, the unit is %.

375

376

(% style="background-attachment:initial; background-clip:initial; background-image:initial; background-origin:initial; background-position:initial; background-repeat:initial; background-size:initial; color:blue; font-family:Arial,sans-serif" %)**Downlink**(%%): (% style="color:#037691" %)**0B 01 bb cc aa **

377

378

aa is the time delay of the output, the unit is ms.

379

380

bb is the output frequency, the unit is HZ.

381

382

cc is the duty cycle of the output, the unit is %.

383

384

385

For example, send a AT command: AT+PWMOUT=65535,1000,50 The PWM is always out, the frequency is 1000HZ, and the duty cycle is 50.

386

387

The oscilloscope displays as follows:

388

389

390

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230817172209-2.png?width=683&height=439&rev=1.1||alt="image-20230817172209-2.png"]]

391

392

===== 2.3.2.10.c Downlink, PWM output =====

393

394

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230817173800-3.png?width=685&height=412&rev=1.1||alt="image-20230817173800-3.png"]]

395

396

Downlink: (% style="color:#037691" %)**0B xx xx xx yy zz zz**

397

398

xx xx xx is the output frequency, the unit is HZ.

399

400

yy is the duty cycle of the output, the unit is %.

401

402

zz zz is the time delay of the output, the unit is ms.

403

404

405

For example, send a downlink command: 0B 00 61 A8 32 13 88, the frequency is 25KHZ, the duty cycle is 50, and the output time is 5 seconds.

406

407

The oscilloscope displays as follows:

408

409

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230817173858-5.png?width=843&height=634&rev=1.1||alt="image-20230817173858-5.png"]]

410

411

==== 2.3.2.11 MOD~=11 (TEMP117) ====

412

413

In this mode, uplink payload includes in total 11 bytes. Uplink packets use FPORT=2.

414

415

(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:517px" %)

416

|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:20px" %)**2**|(% style="background-color:#4f81bd; color:white; width:100px" %)**2**|(% style="background-color:#4f81bd; color:white; width:50px" %)**2**|(% style="background-color:#4f81bd; color:white; width:90px" %)**1**|(% style="background-color:#4f81bd; color:white; width:128px" %)**2**|(% style="background-color:#4f81bd; color:white; width:79px" %)**2**

417

|Value|Bat|(% style="width:191px" %)(((

418

Temperature(DS18B20)(PC13)

419

)))|(% style="width:78px" %)(((

420

ADC(PA4)

421

)))|(% style="width:216px" %)(((

422

Digital in(PB15)&Digital Interrupt(PA8)

423

)))|(% style="width:308px" %)(((

Temperature

(TEMP117)

)))|(% style="width:154px" %)(((

428

Reserved position, meaningless

(0x0000)

)))

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20240717113113-1.png?width=793&height=352&rev=1.1||alt="image-20240717113113-1.png"]]

Connection:

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20240717141528-2.jpeg?width=654&height=430&rev=1.1||alt="image-20240717141528-2.jpeg"]]

438

439

==== 2.3.2.12 MOD~=12 (Count+SHT31) ====

440

441

This mode has total 11 bytes. As shown below:

442

443

(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:517px" %)

444

|=(% style="width: 86px; background-color: rgb(79, 129, 189); color: white;" %)**Size(bytes)**|=(% style="width: 86px; background-color: rgb(79, 129, 189); color: white;" %)**2**|=(% style="width: 86px; background-color: rgb(79, 129, 189); color: white;" %)**2**|=(% style="width: 86px; background-color: rgb(79, 129, 189); color: white;" %)**2**|=(% style="width: 86px; background-color: rgb(79, 129, 189); color: white;" %)**1**|=(% style="width: 86px; background-color: rgb(79, 129, 189); color: white;" %)**4**

445

|Value|BAT|(% style="width:86px" %)(((

446

Temperature_SHT31

447

)))|(% style="width:86px" %)(((

448

Humidity_SHT31

449

)))|(% style="width:86px" %)(((

450

Digital in(PB15)

451

)))|(% style="width:86px" %)(((

Count(PA8)

)))

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20240717150948-5.png?width=979&height=389&rev=1.1||alt="image-20240717150948-5.png"]]

Wiring example:

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20240717152224-6.jpeg?width=680&height=359&rev=1.1||alt="image-20240717152224-6.jpeg"]]

460

461

=== 2.3.3 Decode payload ===

462

463

While using TTN V3 network, you can add the payload format to decode the payload.

464

465

[[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"]]

466

467

The payload decoder function for TTN V3 are here:

468

469

The payload decoder function for TTN V3 are here:

470

471

SN50v3-LB/LS TTN V3 Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]]

472

473

474

==== 2.3.3.1 Battery Info ====

475

476

Check the battery voltage for SN50v3-LB/LS.

Ex1: 0x0B45 = 2885mV

Ex2: 0x0B49 = 2889mV

==== 2.3.3.2 Temperature (DS18B20) ====

484

485

486

If there is a DS18B20 connected to PC13 pin. The temperature will be uploaded in the payload.

487

488

More DS18B20 can check the [[3 DS18B20 mode>>||anchor="H2.3.2.4MOD3D4283xDS18B2029"]]

489

490

(% style="color:blue" %)**Connection:**

491

492

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230512180718-8.png?width=647&height=538&rev=1.1||alt="image-20230512180718-8.png"]]

493

494

(% style="color:blue" %)**Example**:

495

496

If payload is: 0105H: (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree

497

498

If payload is: FF3FH : (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.

499

500

（FF3F & 8000：Judge whether the highest bit is 1, when the highest bit is 1, it is negative）

501

502

503

==== 2.3.3.3 Digital Input ====

504

505

506

The digital input for pin PB15,

507

508

* When PB15 is high, the bit 1 of payload byte 6 is 1.

509

* When PB15 is low, the bit 1 of payload byte 6 is 0.

510

511

(% class="wikigeneratedid" id="H2.3.3.4A0AnalogueDigitalConverter28ADC29" %)

512

(((

513

When the digital interrupt pin is set to AT+INTMODx=0, this pin is used as a digital input pin.

514

515

(% style="color:red" %)**Note: The maximum voltage input supports 3.6V.**

)))

==== 2.3.3.4 Analogue Digital Converter (ADC) ====

521

522

523

The measuring range of the ADC is only about 0.1V to 1.1V The voltage resolution is about 0.24mv.

524

525

When the measured output voltage of the sensor is not within the range of 0.1V 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.

526

527

[[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"]]

528

529

(% 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.**

530

531

532

The position of PA5 on the hardware after **LSN50 v3.3** is changed to the position shown in the figure below, and the collected voltage becomes one-sixth of the original.

533

534

535

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230811113449-1.png?width=608&height=370&rev=1.1||alt="image-20230811113449-1.png"]]

536

537

==== 2.3.3.5 Digital Interrupt ====

538

539

Digital Interrupt refers to pin PA8, and there are different trigger methods. When there is a trigger, the SN50v3-LB/LS will send a packet to the server.

540

541

(% style="color:blue" %)** Interrupt connection method:**

542

543

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230513105351-5.png?width=485&height=147&rev=1.1||alt="image-20230513105351-5.png"]]

544

545

(% style="color:blue" %)**Example to use with door sensor :**

546

547

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.

548

549

[[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"]]

550

551

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 SN50v3-LB/LS interrupt interface to detect the status for the door or window.

552

553

554

(% style="color:blue" %)**Below is the installation example:**

555

556

Fix one piece of the magnetic sensor to the door and connect the two pins to SN50v3-LB/LS as follows:

557

558

* (((

559

One pin to SN50v3-LB/LS's PA8 pin

560

)))

561

* (((

562

The other pin to SN50v3-LB/LS's VDD pin

563

)))

564

565

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.

566

567

Door sensors have two types: (% style="color:blue" %)** NC (Normal close)**(%%) and (% style="color:blue" %)**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.

568

569

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.

570

571

[[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"]]

572

573

The above photos shows the two parts of the magnetic switch fitted to a door.

574

575

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:

(% 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]]**. **)

580

581

Below shows some screen captures in TTN V3:

582

583

[[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"]]

584

585

In **MOD=1**, user can use byte 6 to see the status for door open or close. TTN V3 decoder is as below:

586

587

door= (bytes[6] & 0x80)? "CLOSE":"OPEN";

588

589

590

==== 2.3.3.6 I2C Interface (SHT20 & SHT31) ====

591

592

593

The SDA and SCK are I2C interface lines. You can use these to connect to an I2C device and get the sensor data.

594

595

We have made an example to show how to use the I2C interface to connect to the SHT20/ SHT31 Temperature and Humidity Sensor.

596

597

(% style="color:red" %)**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 SN50v3-LB/LS will be a good reference.**

598

599

600

Below is the connection to SHT20/ SHT31. The connection is as below:

601

602

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230610170152-2.png?width=846&height=501&rev=1.1||alt="image-20230610170152-2.png"]]

603

604

The device will be able to get the I2C sensor data now and upload to IoT Server.

605

606

[[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"]]

607

608

Convert the read byte to decimal and divide it by ten.

**Example:**

Temperature: Read:0116(H) = 278(D) Value: 278 /10=27.8℃;

613

614

Humidity: Read:0248(H)=584(D) Value: 584 / 10=58.4, So 58.4%

615

616

If you want to use other I2C device, please refer the SHT20 part source code as reference.

617

618

619

==== 2.3.3.7 Distance Reading ====

620

621

622

Refer [[Ultrasonic Sensor section>>||anchor="H2.3.3.8UltrasonicSensor"]].

623

624

625

==== 2.3.3.8 Ultrasonic Sensor ====

626

627

628

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]]

629

630

The SN50v3-LB/LS 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.

631

632

The working principle of this sensor is similar to the (% style="color:blue" %)**HC-SR04**(%%) ultrasonic sensor.

633

634

The picture below shows the connection:

635

636

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230512173903-6.png?width=715&height=596&rev=1.1||alt="image-20230512173903-6.png"]]

637

638

Connect to the SN50v3-LB/LS and run (% style="color:blue" %)**AT+MOD=2**(%%) to switch to ultrasonic mode (ULT).

639

640

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

645

646

647

==== 2.3.3.9 Battery Output - BAT pin ====

648

649

650

The BAT pin of SN50v3-LB/LS 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/LS will run out very soon.

651

652

653

==== 2.3.3.10 +5V Output ====

654

655

656

SN50v3-LB/LS will enable +5V output before all sampling and disable the +5v after all sampling.

657

658

The 5V output time can be controlled by AT Command.

659

660

(% style="color:blue" %)**AT+5VT=1000**

661

662

Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.

663

664

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.

665

666

667

==== 2.3.3.11 BH1750 Illumination Sensor ====

668

669

670

MOD=1 support this sensor. The sensor value is in the 8^^th^^ and 9^^th^^ bytes.

671

672

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230512172447-4.png?width=712&height=416&rev=1.1||alt="image-20230512172447-4.png"]]

673

674

[[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"]]

675

676

==== 2.3.3.12 PWM MOD ====

677

678

* (((

679

The maximum voltage that the SDA pin of SN50v3 can withstand is 3.6V, and it cannot exceed this voltage value, otherwise the chip may be burned.

680

)))

681

* (((

682

If the PWM pin connected to the SDA pin cannot maintain a high level when it is not working, you need to remove the resistor R2 or replace it with a resistor with a larger resistance, otherwise a sleep current of about 360uA will be generated. The position of the resistor is shown in the figure below:

683

)))

684

685

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20230817183249-3.png?width=417&height=320&rev=1.1||alt="image-20230817183249-3.png"]]

686

687

* (((

688

The signal captured by the input should preferably be processed by hardware filtering and then connected in. The software processing method is to capture four values, discard the first captured value, and then take the middle value of the second, third, and fourth captured values.

689

)))

690

* (((

691

Since the device can only detect a pulse period of 50ms when [[AT+PWMSET=0>>||anchor="H3.3.8PWMsetting"]] (counting in microseconds), it is necessary to change the value of PWMSET according to the frequency of input capture.

692

)))

693

* (((

694

PWM Input allows low power consumption. PWM Output to achieve real-time control, you need to go to class C. Power consumption will not be low.

695

696

For PWM Output Feature, there are two consideration to see if the device can be powered by battery or have to be powered by external DC.

697

698

a) If real-time control output is required, the SN50v3-LB/LS is already operating in class C and an external power supply must be used.