S31/S31B-LB/LS -- LoRaWAN Outdoor Temperature & Humidity Sensor User Manual

The Dragino S31x-LB/LS is a (% style="color:blue" %)**LoRaWAN Temperature and Humidity Sensor**(%%) for Internet of Things solution. It is used to measure the (% style="color:blue" %)**surrounding environment temperature and relative air humidity precisely**(%%), and then upload to IoT server via LoRaWAN wireless protocol.

26

27

The temperature & humidity sensor used in S31x-LB/LS is SHT31, which is fully calibrated, linearized, and temperature compensated digital output from Sensirion, it provides a strong reliability and long-term stability. The SHT31 is fixed in a (% style="color:blue" %)**waterproof anti-condensation casing**(%%) for long term use.

28

29

The LoRa wireless technology used in S31x-LB/LS allows device 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 minimizing current consumption.

30

31

S31x-LB/LS supports (% style="color:blue" %)**Temperature & Humdity alarm feature**(%%), user can set temperature alarm for instant notice. S31x-LB/LS supports Datalog feature, it can save the data when there is no LoRaWAN network and uplink when network recover.

32

33

S31x-LB/LS (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.

34

35

S31x-LB/LS is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%) or (% style="color:blue" %)**solar powered + Li-ion battery**(%%) it is designed for long term use up to 5 years.

36

37

Each S31x-LB/LS is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.

== 1.2 Features ==

* LoRaWAN 1.0.3 Class A

44

* Ultra-low power consumption

45

* External 3 meters SHT31 probe (For S31-LB)

46

* Measure range -40°C ~~ 80°C

47

* Temperature & Humidity alarm

48

* Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865

49

* Support Bluetooth v5.1 and LoRaWAN remote configure

50

* Support wireless OTA update firmware

51

* Uplink on periodically

52

* Downlink to change configure

53

* 8500mAh Li/SOCl2 Battery (S31/S31B-LB)

54

* Solar panel + 3000mAh Li-ion battery (S31/S31B-LS)

55

56

== 1.3 Specification ==

57

58

59

(% style="color:#037691" %)**Common DC Characteristics:**

60

61

* Supply Voltage: Built-in Battery , 2.5v ~~ 3.6v

62

* Operating Temperature: -40 ~~ 85°C

63

64

(% style="color:#037691" %)**Temperature Sensor:**

65

66

* Range: -40 to + 80°C

67

* Accuracy: ±0.2 @ 0-90 °C

68

* Resolution: 0.1°C

69

* Long Term Shift: <0.03 °C/yr

70

71

(% style="color:#037691" %)**Humidity Sensor: **

72

73

* Range: 0 ~~ 99.9% RH

74

* Accuracy: ± 2%RH ( 0 ~~ 100%RH)

75

* Resolution: 0.01% RH

76

* Long Term Shift: <0.25 %RH/yr

77

78

(% style="color:#037691" %)**LoRa Spec:**

79

80

* Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz

81

* Max +22 dBm constant RF output vs.

82

* RX sensitivity: down to -139 dBm.

83

* Excellent blocking immunity

84

85

(% style="color:#037691" %)**Battery:**

86

87

* Li/SOCI2 un-chargeable battery

88

* Capacity: 8500mAh

89

* Self-Discharge: <1% / Year @ 25°C

90

* Max continuously current: 130mA

91

* Max boost current: 2A, 1 second

92

93

(% style="color:#037691" %)**Power Consumption**

94

95

* Sleep Mode: 5uA @ 3.3v

96

* LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm

97

98

== 1.4 Sleep mode and working mode ==

99

100

101

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

102

103

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

104

105

106

== 1.5 Button & LEDs ==

107

108

109

[[image:image-20250416143859-1.jpeg]]

110

111

112

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

113

|=(% style="width: 167px;background-color:#4F81BD;color:white" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 226px;background-color:#4F81BD;color:white" %)**Action**

114

|[[image:1749523489553-702.png]] 1~~3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((

115

If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.

116

Meanwhile, BLE module will be active and user can connect via BLE to configure device.

117

)))

118

|[[image:1749523491487-577.png]] >3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((

119

(% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network.

120

(% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.

121

Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network.

122

)))

123

|[[image:1749523524280-815.png]] x5|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode.

== 1.6 BLE connection ==

128

129

130

S31x-LB/LS support BLE remote configure.

131

132

BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:

133

134

* Press button to send an uplink

135

* Press button to active device.

136

* Device Power on or reset.

137

138

If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.

139

140

141

== 1.7 Pin Definitions ==

142

143

144

[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/image-20240926134323-1.png?rev=1.1||alt="image-20240926134323-1.png"]]

145

146

== 1.8 Wiring of DS18B20 temperature sensor ==

147

148

The S31x-LB supports connection to the external temperature sensor DS18B20. The wiring method is as follows:

149

150

[[image:1749779850163-145.jpg||height="408" width="651"]]

151

152

153

== 1.9 Hardware Variant ==

154

155

156

(% border="1" cellspacing="3" style="width:460px" %)

157

|=(% style="width: 102px;background-color:#4F81BD;color:white" %)Model|=(% style="width: 182px; background-color:#4F81BD;color:white" %)Photo|=(% style="width: 176px; background-color:#4F81BD;color:white" %)Probe Info

158

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

159

S31-LB/LS

160

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

161

[[image:image-20240104165223-7.png||data-xwiki-image-style-alignment="center"]]

162

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

163

1 x SHT31 Probe

164

165

Cable Length : 2 meters

)))

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

170

S31B-LB/LS

171

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

172

[[image:image-20240104165338-9.png||data-xwiki-image-style-alignment="center"]]

173

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

1 x SHT31 Probe

Installed in device.

)))

(% style="display:none" %)

180

181

182

== 1.10 Mechanical ==

183

184

=== 1.10.1 for LB version ===

185

186

[[image:image-20250409174350-1.jpeg]]

187

188

=== 1.10.2 for LS version ===

189

190

191

[[image:image-20250409174410-2.jpeg]]

192

193

194

= 2. Configure S31x-LB/LS to connect to LoRaWAN network =

195

196

== 2.1 How it works ==

197

198

199

The S31x-LB/LS is configured as (% style="color:#037691" %)**LoRaWAN OTAA Class A**(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the S31x-LB/LS. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.

200

201

202

== 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==

203

204

205

Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.

206

207

The LPS8V2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.

208

209

[[image:image-20250409175256-3.png]]

210

211

(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from S31x-LB/LS.

212

213

Each S31x-LB/LS is shipped with a sticker with the default device EUI as below:

214

215

[[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]

216

217

218

You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:

219

220

**Create the application.**

221

222

[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SAC01L_LoRaWAN_Temperature%26Humidity_Sensor_User_Manual/WebHome/image-20250423093843-1.png?width=756&height=264&rev=1.1||alt="image-20250423093843-1.png"]]

223

224

[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111305-2.png?width=1000&height=572&rev=1.1||alt="image-20240907111305-2.png"]]

225

226

227

**Add devices to the created Application.**

228

229

[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111659-3.png?width=977&height=185&rev=1.1||alt="image-20240907111659-3.png"]]

230

231

[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111820-5.png?width=975&height=377&rev=1.1||alt="image-20240907111820-5.png"]]

232

233

234

**Enter end device specifics manually.**

235

236

[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907112136-6.png?width=697&height=687&rev=1.1||alt="image-20240907112136-6.png"]]

237

238

239

**Add DevEUI and AppKey.**

240

241

**Customize a platform ID for the device.**

242

243

[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907112427-7.png?rev=1.1||alt="image-20240907112427-7.png"]]

244

245

246

(% style="color:blue" %)**Step 2:**(%%) Add decoder.

247

248

In TTN, user can add a custom payload so it shows friendly reading.

249

250

Click this link to get the decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/]]

251

252

Below is TTN screen shot:

253

254

[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS25-LBLDS25-LS--LoRaWAN_LiDAR_Distance_Auto-Clean_Sensor_User_Manual/WebHome/image-20241009140556-1.png?width=1184&height=488&rev=1.1||alt="image-20241009140556-1.png" height="488" width="1184"]]

255

256

[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS25-LBLDS25-LS--LoRaWAN_LiDAR_Distance_Auto-Clean_Sensor_User_Manual/WebHome/image-20241009140603-2.png?width=1168&height=562&rev=1.1||alt="image-20241009140603-2.png" height="562" width="1168"]]

257

258

259

(% style="color:blue" %)**Step 3:**(%%) Activate on S31x-LB/LS

260

261

Press the button for 5 seconds to activate the S31x-LB/LS.

262

263

(% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:blue" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.

264

265

After join success, it will start to upload messages to TTN and you can see the messages in the panel.

266

267

268

== 2.3 Uplink Payload ==

269

270

=== 2.3.1 Device Status, FPORT~=5 ===

271

272

273

Users can use the downlink command(**0x26 01**) to ask S31x-LB/LS to send device configure detail, include device configure status. S31x-LB/LS will uplink a payload via FPort=5 to server.

274

275

The Payload format is as below.

276

277

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

278

|(% colspan="6" style="background-color:#4f81bd; color:white" %)**Device Status (FPORT=5)**

Example parse in TTNv3

283

284

[[image:image-20230524144422-1.png||height="174" width="1080"]]

285

286

287

(% style="color:#037691" %)**Sensor Model**(%%): For S31x-LB/LS, this value is 0x0A

288

289

(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version

290

291

(% style="color:#037691" %)**Frequency Band**:

0x01: EU868

0x02: US915

0x03: IN865

0x04: AU915

0x05: KZ865

0x06: RU864

0x07: AS923

0x08: AS923-1

0x09: AS923-2

0x0a: AS923-3

0x0b: CN470

0x0c: EU433

0x0d: KR920

0x0e: MA869

(% style="color:#037691" %)**Sub-Band**:

323

324

AU915 and US915:value 0x00 ~~ 0x08

325

326

CN470: value 0x0B ~~ 0x0C

327

328

Other Bands: Always 0x00

329

330

331

(% style="color:#037691" %)**Battery Info**:

332

333

Check the battery voltage.

Ex1: 0x0B45 = 2885mV

Ex2: 0x0B49 = 2889mV

=== 2.3.2 Sensor Data. FPORT~=2 ===

341

342

343

Sensor Data is uplink via FPORT=2

344

345

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

346

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

347

**Size(bytes)**

348

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

349

|(% style="width:99px" %)Value|(% style="width:69px" %)(((

350

Battery

351

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

352

Unix TimeStamp

353

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

354

Alarm Flag & MOD& Level of PA8

355

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

356

Temperature

357

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

Humidity

)))

[[image:image-20230524144456-2.png||height="180" width="1142"]]

362

363

364

==== (% style="color:#4472c4" %)**Battery**(%%) ====

365

366

Sensor Battery Level.

Ex1: 0x0B45 = 2885mV

Ex2: 0x0B49 = 2889mV

==== (% style="color:#4472c4" %)**Temperature**(%%) ====

**Example**:

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

378

379

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

380

381

(FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)

382

383

384

==== (% style="color:#4472c4" %)**Humidity**(%%) ====

385

386

Read:0x(0197)=412 Value: 407 / 10=40.7, So 40.7%

387

388

389

==== (% style="color:#4472c4" %)**Alarm Flag & MOD & Level of PA8**(%%) ====

**Example:**

If payload & 0x01 = 0x01 **~-~->** This is an Alarm Message.It means that the temperature and humidity exceed the alarm value or trigger an interrupt.

394

395

If payload & 0x01 = 0x00 **~-~->** This is a normal uplink message, no alarm.

396

397

If payload & 0x80>>7 = 0x01 **~-~->** The PA8 is low level.

398

399

If payload & 0x80>>7 =0x00 **~-~->** The PA8 is high level.

400

401

If payload >> 2 = 0x00 **~-~->** means MOD=1, This is a sampling uplink message.

402

403

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.

404

405

406

== 2.4 Payload Decoder file ==

407

408

409

In TTN, use can add a custom payload so it shows friendly reading

410

411

In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**(%%) to add the decoder from:

412

413

[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/S31-LB%26S31B-LB>>https://github.com/dragino/dragino-end-node-decoder/tree/main/S31-LB%26S31B-LB]]

414

415

416

== 2.5 Datalog Feature ==

417

418

419

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/LS will store the reading for future retrieving purposes.

420

421

422

=== 2.5.1 How datalog works ===

423

424

425

S31x-LB/LS will wait for ACK for every uplink, when there is no LoRaWAN network,S31x-LB/LS 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.

426

427

* (((

428

a) S31x-LB/LS will do an ACK check for data records sending to make sure every data arrive server.

429

)))

430

* (((

431

b) S31x-LB/LS will send data in **CONFIRMED Mode**, but S31x-LB/LS 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/LS gets a ACK, S31x-LB/LS will consider there is a network connection and resend all NONE-ACK messages.

)))

=== 2.5.2 Enable Datalog ===

437

438

439

User need to make sure below two settings are enable to use datalog;

440

441

* (% style="color:blue" %)**SYNCMOD=1(Default)**(%%) to enable sync time via LoRaWAN MAC command, click here ([[AT+SYNCMOD>>https://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.6Settimesynchronizationmethod28ThenetworkservermustsupportLoRaWANv1.0.329]]) for detailed instructions.

442

* (% style="color:blue" %)**PNACKMD=1**(%%)** **to enable datalog feature, click here ([[AT+PNACKMD>>https://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H7.26RequesttheservertosendanACK]]) for detailed instructions.

Once S31x-LB/LS 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/LS. If S31x-LB/LS fails to get the time from the server, S31x-LB/LS will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).

447

448

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

449

450

451

=== 2.5.3 Unix TimeStamp ===

452

453

454

S31x-LB/LS uses Unix TimeStamp format based on

455

456

[[image:image-20250328173339-5.jpeg]]

457

458

User can get this time from link: [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :

459

460

Below is the converter example

461

462

[[image:image-20250328173355-6.jpeg]]

463

464

465

=== 2.5.4 Datalog Uplink payload (FPORT~=3) ===

466

467

468

The Datalog uplinks will use below payload format.

469

470

**Retrieval data payload:**

471

472

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

473

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

474

**Size(bytes)**

475

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

476

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

477

ignore

478

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

(((

Humidity

)))

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

483

Temperature

484

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

485

Poll message flag & Alarm Flag& Level of PA8

486

)))|(% style="width:137px" %)Unix Time Stamp

487

488

**Poll message flag & Alarm Flag & Level of PA8:**

489

490

[[image:image-20230524114302-1.png||height="115" width="736"]]

491

492

493

**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)

494

495

**Poll Message Flag**: 1: This message is a poll message reply.

496

497

* Poll Message Flag is set to 1.

498

499

* Each data entry is 11 bytes, to save airtime and battery, devices will send max bytes according to the current DR and Frequency bands.

500

501

For example, in US915 band, the max payload for different DR is:

502

503

**a) DR0:** max is 11 bytes so one entry of data

504

505

**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)

506

507

**c) DR2:** total payload includes 11 entries of data

508

509

**d) DR3: **total payload includes 22 entries of data.

510

511

If devise doesn't have any data in the polling time. Device will uplink 11 bytes of 0

**Example:**

If S31x-LB/LS has below data inside Flash:

516

517

[[image:image-20230524114654-2.png]]

518

519

520

If user sends below downlink command: 31646D84E1646D856C05

521

522

Where : Start time: 646D84E1 = time 23/5/24 03:30:41

523

524

Stop time: 646D856C= time 23/5/24 03:33:00

525

526

527

**S31x-LB/LS will uplink this payload.**

528

529

[[image:image-20230524114826-3.png||height="448" width="1244"]]

530

531

(((

532

00 00 02 36 01 10 40 64 6D 84 E1 00 00 02 37 01 10 40 64 6D 84 F8 00 00 02 37 01 0F 40 64 6D 85 04 00 00 02 3A 01 0F 40 64 6D 85 18 00 00 02 3C 01 0F 40 64 6D 85 36 00 00 02 3D 01 0E 40 64 6D 85 3F 00 00 02 3F 01 0E 40 64 6D 85 60 00 00 02 40 01 0E 40 64 6D 85 6A

)))

(((

Where the first 11 bytes is for the first entry:

)))

(((

00 00 02 36 01 10 40 64 6D 84 E1

)))

(((

**Hum**=0x0236/10=56.6

)))

(((

**Temp**=0x0110/10=27.2

)))

(((

**poll message flag & Alarm Flag & Level of PA8**=0x40,means reply data,sampling uplink message,the PA8 is low level.

)))

(((

**Unix time** is 0x646D84E1=1684899041s=23/5/24 03:30:41

)))

(% 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" %)[[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 图片" 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="单击并拖动以调整大小" %)的

561

562

== 2.6 Temperature Alarm Feature ==

563

564

565

S31x-LB/LS work flow with Alarm feature.

566

567

568

[[image:image-20230524110125-3.png||height="768" width="1115"]]

== 2.7 Frequency Plans ==

573

574

575

The S31x-LB/LS uses OTAA mode and below frequency plans by default. Each frequency band use different firmware, user update the firmware to the corresponding band for their country.

576

577

[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]

578

579

580

== 2.8 Firmware Change Log ==

581

582

583

**Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/fis3g6nmhv0eokg/AAC6BcCZaX4BdqZkduUvZ3jIa?dl=0>>https://www.dropbox.com/sh/fis3g6nmhv0eokg/AAC6BcCZaX4BdqZkduUvZ3jIa?dl=0]]

584

585

586

= 3. Configure S31x-LB/LS =

587

588

== 3.1 Configure Methods ==

589

590

591

S31x-LB/LS supports below configure method:

592

593

* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].

594

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

595

* LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.

596

597

== 3.2 General Commands ==

598

599

600

These commands are to configure:

601

602

* General system settings like: uplink interval.

603

* LoRaWAN protocol & radio related command.

604

605

They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:

606

607

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

608

609

610

== 3.3 Commands special design for S31x-LB/LS ==

611

612

613

These commands only valid for S31x-LB/LS, as below:

614

615

616

=== 3.3.1 Set Transmit Interval Time ===

617

618

619

Feature: Change LoRaWAN End Node Transmit Interval.

620

621

(% style="color:blue" %)**AT Command: AT+TDC**

622

623

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

624

|=(% style="width: 156px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 137px;background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response**

625

|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((

626

30000

627

OK

628

the interval is 30000ms = 30s

629

)))

630

|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((

631

OK

632

Set transmit interval to 60000ms = 60 seconds

633

)))

634

635

(% style="color:blue" %)**Downlink Command: 0x01**

636

637

Format: Command Code (0x01) followed by 3 bytes time value.

638

639

If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.

640

641

* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds

642

* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds

643

644

=== 3.3.2 Get Device Status ===

645

646

647

Send a LoRaWAN downlink to ask device send Alarm settings.

648

649

(% style="color:blue" %)**Downlink Payload: **(%%)0x26 01

650

651

Sensor will upload Device Status via FPORT=5. See payload section for detail.

652

653

654

=== 3.3.3 Set Temperature Alarm Threshold ===

655

656

657

* (% style="color:blue" %)**AT Command:**

658

659

(% style="color:#037691" %)**AT+SHTEMP=min,max**

660

661

* When min=0, and max≠0, Alarm higher than max

662

* When min≠0, and max=0, Alarm lower than min

663

* When min≠0 and max≠0, Alarm higher than max or lower than min

Example:

AT+SHTEMP=0,30 ~/~/ Alarm when temperature higher than 30.

668

669

* (% style="color:blue" %)**Downlink Payload:**

670

671

(% style="color:#037691" %)**0x(0C 01 00 1E)** (%%) ~/~/ Set AT+SHTEMP=0,30

672

673

(% style="color:red" %)**(note: 3^^rd^^ byte= 0x00 for low limit(not set), 4^^th^^ byte = 0x1E for high limit: 30)**

674

675

676

=== 3.3.4 Set Humidity Alarm Threshold ===

677

678

679

* (% style="color:blue" %)**AT Command:**

680

681

(% style="color:#037691" %)**AT+SHHUM=min,max**

682

683

* When min=0, and max≠0, Alarm higher than max

684

* When min≠0, and max=0, Alarm lower than min

685

* When min≠0 and max≠0, Alarm higher than max or lower than min

Example:

AT+SHHUM=70,0 ~/~/ Alarm when humidity lower than 70%.

690

691

* (% style="color:blue" %)**Downlink Payload:**

692

693

(% style="color:#037691" %)**0x(0C 02 46 00)**(%%) ~/~/ Set AT+SHTHUM=70,0

694

695

(% style="color:red" %)**(note: 3^^rd^^ byte= 0x46 for low limit (70%), 4^^th^^ byte = 0x00 for high limit (not set))**

696

697

698

=== 3.3.5 Set Alarm Interval ===

699

700

701

The shortest time of two Alarm packet. (unit: min)

702

703

* (% style="color:blue" %)**AT Command:**

704

705

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

706

707

* (% style="color:blue" %)**Downlink Payload:**

708

709

(% style="color:#037691" %)**0x(0D 00 1E)**(%%) **~-~--> ** Set AT+ATDC=0x 00 1E = 30 minutes

710

711

712

=== 3.3.6 Get Alarm settings ===

713

714

715

Send a LoRaWAN downlink to ask device send Alarm settings.

716

717

* (% style="color:#037691" %)**Downlink Payload: **(%%)0x0E 01

**Example:**

[[image:image-20230524110211-4.png]]

**Explain:**

* Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message.

726

727

=== 3.3.7 Set Interrupt Mode ===

728

729

730

Feature, Set Interrupt mode for PA8 of pin.

731

732

When AT+INTMOD=0 is set, PA8 is used as a digital input port.

733

734

(% style="color:blue" %)**AT Command: AT+INTMOD**

735

736

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

737

|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 192px; background-color: rgb(79, 129, 189); color: white;" %)**Function**|=(% style="width: 161px; background-color: rgb(79, 129, 189); color: white;" %)**Response**

738

|(% style="width:154px" %)AT+INTMOD=?|(% style="width:192px" %)Show current interrupt mode|(% style="width:161px" %)(((

739

0

740

OK

741

the mode is 0 =Disable Interrupt

742

)))

743

|(% style="width:154px" %)AT+INTMOD=2|(% style="width:192px" %)(((

744

0: Disable Interrupt

745

1: Trigger by rising and falling edge

746

2: Trigger by falling edge

747

3: Trigger by rising edge

748

)))|(% style="width:161px" %)OK

749

750

(% style="color:blue" %)**Downlink Command: 0x06**

751

752

Format: Command Code (0x06) followed by 3 bytes.

753

754

This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.

755

756

* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode

757

* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger

758

759

=== 3.3.8 Set Power Output Duration ===

760

761

762

Control the output duration 5V . Before each sampling, device will

763

764

~1. first enable the power output to external sensor,

765

766

2. keep it on as per duration, read sensor value and construct uplink payload

767

768

3. final, close the power output.

769

770

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

771

772

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

773

|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 197px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Response**

774

|(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)0 (default)

775

OK

776

|(% style="width:154px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK

777

778

(% style="color:blue" %)**Downlink Command: 0x07**

779

780

Format: Command Code (0x07) followed by 2 bytes.

781

782

The first and second bytes are the time to turn on.

783

784

* Example 1: Downlink Payload: 070000 **~-~-->** AT+5VT=0

785

* Example 2: Downlink Payload: 0701F4 **~-~-->** AT+5VT=500

786

787

=== 3.3.9 Print data entries base on page ===

788

789

790

Feature: Print the sector data from start page to stop page (max is 416 pages).

791

792

(% style="color:#4f81bd" %)**AT Command: AT+PDTA**

793

794

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

795

|(% style="background-color:#4f81bd; color:white; width:158px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:352px" %)**Function**

796

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

797

AT+PDTA=1,3

798

Print page 1 to 3

799

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

800

8019500 19/6/26 16:48 1 2992 sht temp=28.21 sht hum=71.5 ds temp=27.31

801

8019510 19/6/26 16:53 1 2994 sht temp=27.64 sht hum=69.3 ds temp=26.93

802

8019520 19/6/26 16:58 1 2996 sht temp=28.39 sht hum=72.0 ds temp=27.06

803

8019530 19/6/26 17:03 1 2996 sht temp=27.97 sht hum=70.4 ds temp=27.12

804

8019540 19/6/26 17:08 1 2996 sht temp=27.80 sht hum=72.9 ds temp=27.06

805

8019550 19/6/26 17:13 1 2998 sht temp=27.30 sht hum=72.4 ds temp=26.68

806

8019560 19/6/26 17:22 1 2992 sht temp=26.27 sht hum=62.3 ds temp=26.56

8019570

8019580

8019590

80195A0

80195B0

80195C0

80195D0

80195E0

80195F0

OK

)))

(% style="color:#4f81bd" %)**Downlink Command:**

821

822

No downlink commands for feature

823

824

825

=== 3.3.10 Print last few data entries ===

826

827

828

Feature: Print the last few data entries

829

830

(% style="color:#4f81bd" %)**AT Command: AT+PLDTA**

831

832

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

833

|(% style="background-color:#4f81bd; color:white; width:158px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:352px" %)**Function**

834

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

835

AT+PLDTA=5

836

Print last 5 entries

837

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

838

Stop Tx and RTP events when read sensor data

839

1 19/6/26 13:59 1 3005 sht temp=27.09 sht hum=79.5 ds temp=26.75

840

2 19/6/26 14:04 1 3007 sht temp=26.65 sht hum=74.8 ds temp=26.43

841

3 19/6/26 14:09 1 3007 sht temp=26.91 sht hum=77.9 ds temp=26.56

842

4 19/6/26 14:15 1 3007 sht temp=26.93 sht hum=76.7 ds temp=26.75

843

5 19/6/26 14:20 1 3007 sht temp=26.78 sht hum=76.6 ds temp=26.43

844

Start Tx and RTP events

OK

)))

(% style="color:#4f81bd" %)**Downlink Command:**

849

850

No downlink commands for feature

851

852

853

=== 3.3.11 Clear Flash Record ===

854

855

856

Feature: Clear flash storage for data log feature.

857

858

(% style="color:#4f81bd" %)**AT Command: AT+CLRDTA**

859

860

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

861

|(% style="background-color:#4f81bd; color:white; width:157px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:137px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:209px" %)**Response**

862

|(% style="width:155px" %)AT+CLRDTA |(% style="width:134px" %)Clear date record|(% style="width:209px" %)(((

863

Clear all stored sensor data…

OK

)))

(% style="color:#4f81bd" %)**Downlink Command: 0xA3**

869

870

* Example: 0xA301 ~/~/ Same as AT+CLRDTA

871

872

= 4. Battery & Power Consumption =

873

874

875

S31x-LB use ER26500 + SPC1520 battery pack and S31x-LS use 3000mAh Recharable Battery with Solar Panel. See below link for detail information about the battery info and how to replace.

876

877

[[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .

878

879

880

= 5. OTA Firmware update =

881

882

883

(% class="wikigeneratedid" %)

884

User can change firmware S31x-LB/LS to:

885

886

* Change Frequency band/ region.

887

* Update with new features.

888

* Fix bugs.

889

890

Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/fis3g6nmhv0eokg/AAC6BcCZaX4BdqZkduUvZ3jIa?dl=0]]**

891

892

893

Methods to Update Firmware:

894

895

* (Recommanded way) OTA firmware update via wireless : **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**

896

* Update through UART TTL interface : **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**.

= 6. FAQ =

= 7. Order Info =

Part Number: (% style="color:blue" %)**S31-LB-XX / S31B-LB-XX**(%%)** or (% style="color:blue" %)S31-LS-XX / S31B-LS-XX(%%)**

906

907

(% style="color:red" %)**XX**(%%): The default frequency band

908

909

* (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band

910

911

* (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band

912

913

* (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band

914

915

* (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band

916

917

* (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band

918

919

* (% style="color:red" %)**US915**(%%): LoRaWAN US915 band

920

921

* (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band

922

923

* (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band

= 8. Packing Info =

(% style="color:#037691" %)**Package Includes**:

929

930

* S31x-LB or S31x-LS LoRaWAN Temperature & Humidity Sensor

931

932

(% style="color:#037691" %)**Dimension and weight**:

* Device Size: cm

* Device Weight: g

* Package Size / pcs : cm

* Weight / pcs : g

= 9. Support =

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

946

947

* 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>>mailto:Support@dragino.cc]].

Wiki source code of S31/S31B-LB/LS -- LoRaWAN Outdoor Temperature & Humidity Sensor User Manual

Applications

Navigation