LDS12-LB/LS -- LoRaWAN LiDAR ToF Distance Sensor User Manual

The Dragino LDS12-LB/LS is a (% style="color:blue" %)**LoRaWAN LiDAR ToF (Time of Flight) Distance Sensor**(%%) for Internet of Things solution. It is capable to measure the distance to an object as close as 10 centimeters (+/- 5cm up to 6m) and as far as 12 meters (+/-1% starting at 6m)!. The LiDAR probe uses laser induction technology for distance measurement.

28

29

The LDS12-LB/LS can be applied to scenarios such as horizontal distance measurement, parking management system, object proximity and presence detection, intelligent trash can management system, robot obstacle avoidance, automatic control, sewer, etc.

30

31

It detects the distance between the measured object and the sensor, and uploads the value via wireless to LoRaWAN IoT Server.

32

33

The LoRa wireless technology used in LDS12-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.

34

35

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

36

37

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

38

39

Each LDS12-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

46

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

47

* Ultra-low power consumption

48

* Laser technology for distance detection

49

* Measure Distance: 0.1m~~12m

50

* Accuracy : ±5cm@(0.1-5m), ±1%@(5m-12m)

51

* Monitor Battery Level

52

* Support Bluetooth v5.1 and LoRaWAN remote configure

53

* Support wireless OTA update firmware

54

* AT Commands to change parameters

55

* Downlink to change configure

56

* 8500mAh Li/SOCl2 Battery (LDS12-LB)

57

* Solar panel + 3000mAh Li-ion battery (LDS12-LS)

58

59

== 1.3 Specification ==

60

61

62

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

63

64

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

65

* Operating Temperature: -40 ~~ 85°C

66

67

(% style="color:#037691" %)**Probe Specification:**

68

69

* Storage temperature: -20℃~~75℃

70

* Operating temperature : -20℃~~60℃

71

* Measure Distance:

72

** 0.1m ~~ 12m @ 90% Reflectivity

73

** 0.1m ~~ 4m @ 10% Reflectivity

74

* Accuracy : ±5cm@(0.1-5m), ±1%@(5m-12m)

75

* Distance resolution : 1cm

76

* Ambient light immunity : 70klux

77

* Enclosure rating : IP65

78

* Light source : LED

79

* Central wavelength : 850nm

80

* FOV : 3.6°

81

* Material of enclosure : ABS+PC

82

* Wire length : 25cm

83

84

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

85

86

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

87

* Max +22 dBm constant RF output vs.

88

* RX sensitivity: down to -139 dBm.

89

* Excellent blocking immunity

90

91

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

92

93

* Li/SOCI2 un-chargeable battery

94

* Capacity: 8500mAh

95

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

96

* Max continuously current: 130mA

97

* Max boost current: 2A, 1 second

98

99

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

100

101

* Sleep Mode: 5uA @ 3.3v

102

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

103

104

== 1.4 Applications ==

105

106

107

* Horizontal distance measurement

108

* Parking management system

109

* Object proximity and presence detection

110

* Intelligent trash can management system

111

* Robot obstacle avoidance

* Automatic control

* Sewer

(% style="display:none" %)

116

117

== 1.5 Sleep mode and working mode ==

118

119

120

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

121

122

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

123

124

125

== 1.6 Button & LEDs ==

126

127

128

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

129

130

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

131

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

132

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

133

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

134

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

135

)))

136

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

137

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

138

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

139

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.

140

)))

141

|[[image:1749541742731-371.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.

142

143

== 1.7 BLE connection ==

144

145

146

LDS12-LB/LS support BLE remote configure.

147

148

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:

149

150

* Press button to send an uplink

151

* Press button to active device.

152

* Device Power on or reset.

153

154

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

155

156

157

== 1.8 Pin Definitions ==

158

159

160

[[image:image-20250218143358-1.jpeg||height="365" width="796"]]

== 1.9 Mechanical ==

=== 1.9.1 for LB version ===

165

166

167

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

168

169

170

(% id="cke_bm_173180S" style="color:blue; display:none" %)** **(% style="color:blue" %)**Probe Mechanical:**

171

172

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

173

174

175

=== 1.9.2 for LS version ===

176

177

178

[[image:image-20250403151438-3.jpeg]]

179

180

181

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

182

183

== 2.1 How it works ==

184

185

186

The LDS12-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 LDS12-LB/LS. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.

187

188

(% style="display:none" %) (%%)

189

190

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

191

192

193

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.

194

195

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.

196

197

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

198

199

200

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

201

202

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

203

204

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

205

206

207

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

208

209

**Create the application.**

210

211

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

212

213

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

214

215

216

**Add devices to the created Application.**

217

218

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

219

220

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

221

222

223

**Enter end device specifics manually.**

224

225

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

226

227

228

**Add DevEUI and AppKey. Customize a platform ID for the device.**

229

230

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

231

232

233

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

234

235

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

236

237

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

238

239

Below is TTN screen shot:

240

241

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

242

243

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

244

245

246

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

247

248

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

249

250

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

251

252

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

253

254

255

== 2.3 Uplink Payload ==

256

257

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

258

259

260

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

261

262

The Payload format is as below.

263

264

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

265

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

266

**Size(bytes)**

267

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

268

269

270

Example parse in TTNv3

271

272

[[image:image-20230805103904-1.png||height="131" width="711"]]

273

274

(% style="color:blue" %)**Sensor Model**(%%): For LDS12-LB/LS, this value is 0x24

275

276

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

277

278

(% style="color:blue" %)**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:blue" %)**Sub-Band**:

309

310

AU915 and US915:value 0x00 ~~ 0x08

311

312

CN470: value 0x0B ~~ 0x0C

313

314

Other Bands: Always 0x00

315

316

(% style="color:blue" %)**Battery Info**:

317

318

Check the battery voltage.

Ex1: 0x0B45 = 2885mV

Ex2: 0x0B49 = 2889mV

=== 2.3.2 Uplink Payload, FPORT~=2 ===

(((

LDS12-LB/LS will send this uplink **after** Device Status once join the LoRaWAN network successfully. And LDS12-LB/LS will:

330

331

periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].

332

333

Uplink Payload totals 11 bytes.

334

)))

335

336

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

337

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

338

**Size(bytes)**

339

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

340

|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="HBatteryInfo"]]|(% style="width:62.5px" %)(((

341

[[Temperature DS18B20>>||anchor="HDS18B20Temperaturesensor"]]

342

)))|[[Distance>>||anchor="HDistance"]]|[[Distance signal strength>>||anchor="HDistancesignalstrength"]]|(% style="width:122px" %)(((

343

[[Interrupt flag & Interrupt_level>>||anchor="HInterruptPin26A0InterruptLevel"]]

344

)))|(% style="width:54px" %)[[LiDAR temp>>||anchor="HLiDARtemp"]]|(% style="width:96px" %)(((

345

[[Message Type>>||anchor="HMessageType"]]

346

)))

347

348

[[image:image-20230805104104-2.png||height="136" width="754"]]

349

350

351

==== (% style="color:blue" %)**Battery Info**(%%) ====

352

353

354

Check the battery voltage for LDS12-LB/LS.

Ex1: 0x0B45 = 2885mV

Ex2: 0x0B49 = 2889mV

==== (% style="color:blue" %)**DS18B20 Temperature sensor**(%%) ====

362

363

364

This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.

**Example**:

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

370

371

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

372

373

374

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

375

376

377

Represents the distance value of the measurement output, the default unit is cm, and the value range parsed as a decimal number is 0-1200. In actual use, when the signal strength value Strength.

**Example**:

If the data you get from the register is 0x0B 0xEA, the distance between the sensor and the measured object is 0BEA(H) = 3050 (D)/10 = 305cm.

383

384

385

==== (% style="color:blue" %)**Distance signal strength**(%%) ====

386

387

388

Refers to the signal strength, the default output value will be between 0-65535. When the distance measurement gear is fixed, the farther the distance measurement is, the lower the signal strength; the lower the target reflectivity, the lower the signal strength. When Strength is greater than 100 and not equal to 65535, the measured value of Dist is considered credible.

**Example**:

If payload is: 01D7(H)=471(D), distance signal strength=471, 471>100,471≠65535, the measured value of Dist is considered credible.

394

395

Customers can judge whether they need to adjust the environment based on the signal strength.

396

397

398

**1) When the sensor detects valid data:**

399

400

[[image:image-20230805155335-1.png||height="145" width="724"]]

401

402

403

**2) When the sensor detects invalid data:**

404

405

[[image:image-20230805155428-2.png||height="139" width="726"]]

406

407

408

**3) When the sensor is not connected:**

409

410

[[image:image-20230805155515-3.png||height="143" width="725"]]

411

412

413

==== (% style="color:blue" %)**Interrupt Pin & Interrupt Level**(%%) ====

414

415

416

This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H3.3.2SetInterruptMode"]] for the hardware and software set up.

417

418

Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.8PinDefinitions"]] of GPIO_EXTI .

**Example:**

If byte[0]&0x01=0x00 : Normal uplink packet.

423

424

If byte[0]&0x01=0x01 : Interrupt Uplink Packet.

425

426

427

==== (% style="color:blue" %)**LiDAR temp**(%%) ====

428

429

430

Characterize the internal temperature value of the sensor.

431

432

**Example: **

433

If payload is: 1C(H) <<24>>24=28(D),LiDAR temp=28℃.

434

If payload is: F2(H) <<24>>24=-14(D),LiDAR temp=-14℃.

435

436

437

==== (% style="color:blue" %)**Message Type**(%%) ====

(((

For a normal uplink payload, the message type is always 0x01.

)))

(((

Valid Message Type:

)))

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

449

|=(% style="width: 161px;background-color:#4F81BD;color:white" %)**Message Type Code**|=(% style="width: 164px;background-color:#4F81BD;color:white" %)**Description**|=(% style="width: 174px;background-color:#4F81BD;color:white" %)**Payload**

450

|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)Normal Uplink Payload

451

|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)Configure Info Payload

452

453

[[image:image-20230805150315-4.png||height="233" width="723"]]

454

455

456

=== 2.3.3 Historical measuring distance, FPORT~=3 ===

457

458

459

LDS12-LB/LS stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].

460

461

The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.

462

463

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

464

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

465

**Size(bytes)**

466

)))|=(% style="width: 80px;background-color:#4F81BD;color:white" %)1|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 70px;background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD; color: white; width: 85px;" %)**1**|=(% style="background-color: #4F81BD; color: white; width: 85px;" %)4

467

|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)(((

468

Reserve(0xFF)

469

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

470

LiDAR temp

471

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

472

473

**Interrupt flag & Interrupt level:**

474

475

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

476

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

477

**Size(bit)**

478

)))|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**bit7**|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**bit6**|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**[bit5:bit2]**|=(% style="width: 90px; background-color: #4F81BD; color: white;" %)**bit1**|=(% style="background-color: #4F81BD; color: white; width: 90px;" %)**bit0**

Interrupt flag

)))

* (((

Each data entry is 11 bytes and has the same structure as [[Uplink Payload>>||anchor="H2.3.2UplinkPayload2CFPORT3D2"]], to save airtime and battery, LDS12-LB/LS will send max bytes according to the current DR and Frequency bands.

485

)))

486

487

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

488

489

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

490

491

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

492

493

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

494

495

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

496

497

If LDS12-LB/LS doesn't have any data in the polling time. It will uplink 11 bytes of 0

**Downlink:**

0x31 64 CC 68 0C 64 CC 69 74 05

503

504

[[image:image-20230805144936-2.png||height="113" width="746"]]

**Uplink:**

43 FF 0E 10 00 B0 1E 64 CC 68 0C 40 FF 0D DE 00 A8 1E 64 CC 68 29 40 FF 09 92 00 D3 1E 64 CC 68 65 40 FF 02 3A 02 BC 1E 64 CC 68 A1 41 FF 0E 1A 00 A4 1E 64 CC 68 C0 40 FF 0D 2A 00 B8 1E 64 CC 68 E8 40 FF 00 C8 11 6A 1E 64 CC 69 24 40 FF 0E 24 00 AD 1E 64 CC 69 6D

**Parsed Value:**

[DISTANCE , DISTANCE_SIGNAL_STRENGTH，LIDAR_TEMP，EXTI_STATUS , EXTI_FLAG , TIME]

514

515

516

[360,176,30,High,True,2023-08-04 02:53:00],

517

518

[355,168,30,Low,False,2023-08-04 02:53:29],

519

520

[245,211,30,Low,False,2023-08-04 02:54:29],

521

522

[57,700,30,Low,False,2023-08-04 02:55:29],

523

524

[361,164,30,Low,True,2023-08-04 02:56:00],

525

526

[337,184,30,Low,False,2023-08-04 02:56:40],

527

528

[20,4458,30,Low,False,2023-08-04 02:57:40],

529

530

[362,173,30,Low,False,2023-08-04 02:58:53],

531

532

533

**History read from serial port：**

534

535

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

536

537

538

=== 2.3.5 Decode payload in The Things Network ===

539

540

541

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

542

543

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654592762713-715.png?rev=1.1||alt="1654592762713-715.png"]]

(((

The payload decoder function for TTN is here:

)))

(((

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

)))

== 2.4 Show Data in DataCake IoT Server ==

(((

[[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, once we have data in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps:

)))

(((

(% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**

)))

(((

(% style="color:blue" %)**Step 2**(%%)**: To configure the Application to forward data to DATACAKE you will need to add integration. To add the DATACAKE integration, perform the following steps:**

)))

[[image:image-20250403153432-8.jpeg]]

573

574

575

[[image:image-20250403153459-9.jpeg]]

576

577

578

(% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**

579

580

(% style="color:blue" %)**Step 4**(%%)**: Search the LDS12-LB/LS and add DevEUI.**

581

582

[[image:image-20250403154805-10.jpeg]]

583

584

585

After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.

586

587

[[image:image-20250403154825-11.jpeg]]

588

589

590

== 2.5 Datalog Feature ==

591

592

593

Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, LDS12-LB/LS will store the reading for future retrieving purposes.

594

595

596

=== 2.5.1 How datalog works ===

597

598

599

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

600

601

* (((

602

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

603

)))

604

* (((

605

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

)))

=== 2.5.2 Enable Datalog ===

611

612

613

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

614

615

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

616

* (% 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 LDS12-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 LDS12-LB/LS. If LDS12-LB/LS fails to get the time from the server, LDS12-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).

621

622

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

623

624

625

=== 2.5.3 Unix TimeStamp ===

626

627

628

LDS12-LB/LS uses Unix TimeStamp format based on

629

630

[[image:image-20250403154901-12.jpeg]]

631

632

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

633

634

Below is the converter example

635

636

[[image:image-20250403154925-13.jpeg]]

637

638

639

So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25

640

641

642

=== 2.5.4 Poll sensor value ===

643

644

645

Users can poll sensor values based on timestamps. Below is the downlink command.

646

647

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

648

|(% colspan="4" style="background-color:#4f81bd; color:white; width:423px" %)**Downlink Command to poll Open/Close status (0x31)**

649

|(% style="width:58px" %)**1byte**|(% style="width:127px" %)**4bytes**|(% style="width:124px" %)**4bytes**|(% style="width:114px" %)**1byte**

650

|(% style="width:58px" %)31|(% style="width:127px" %)Timestamp start|(% style="width:124px" %)Timestamp end|(% style="width:114px" %)Uplink Interval

651

652

(((

653

Timestamp start and Timestamp end-use Unix TimeStamp format as mentioned above. Devices will reply with all data logs during this period, using the uplink interval.

)))

(((

For example, downlink command [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/image-20220518162852-1.png?rev=1.1||alt="image-20220518162852-1.png"]]

)))

(((

Is to check 2021/11/12 12:00:00 to 2021/11/12 15:00:00's data

)))

(((

Uplink Internal =5s，means LDS12-LB/LS will send one packet every 5s. range 5~~255s.

)))

== 2.6 Frequency Plans ==

671

672

673

The LDS12-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.

674

675

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

676

677

678

== 2.7 LiDAR ToF Measurement ==

679

680

=== 2.7.1 Principle of Distance Measurement ===

681

682

683

The LiDAR probe is based on TOF, namely, Time of Flight principle. To be specific, the product emits modulation wave of near infrared ray on a periodic basis, which will be reflected after contacting object. The product obtains the time of flight by measuring round-trip phase difference and then calculates relative range between the product and the detection object, as shown below.

684

685

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654831757579-263.png?rev=1.1||alt="1654831757579-263.png"]]

686

687

688

=== 2.7.2 Distance Measurement Characteristics ===

689

690

691

With optimization of light path and algorithm, The LiDAR probe has minimized influence from external environment on distance measurement performance. Despite that, the range of distance measurement may still be affected by the environment illumination intensity and the reflectivity of detection object. As shown in below:

692

693

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654831774373-275.png?rev=1.1||alt="1654831774373-275.png"]]

(((

(% style="color:blue" %)**① **(%%)Represents the detection blind zone of The LiDAR probe, 0-10cm, within which the output data is unreliable.

)))

(((

(% style="color:blue" %)**② **(%%)Represents the operating range of The LiDAR probe detecting black target with 10% reflectivity, 0.1-5m.

)))

(((

(% style="color:blue" %)**③ **(%%)Represents the operating range of The LiDAR probe detecting white target with 90% reflectivity, 0.1-12m.

)))

(((

Vertical Coordinates: Represents the radius of light spot for The LiDAR probe at different distances. The diameter of light spot depends on the FOV of The LiDAR probe (the term of FOV generally refers to the smaller value between the receiving angle and the transmitting angle), which is calculated as follows:

711

)))

712

713

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654831797521-720.png?rev=1.1||alt="1654831797521-720.png"]]

714

715

(((

716

In the formula above, d is the diameter of light spot; D is detecting range; β is the value of the receiving angle of The LiDAR probe, 3.6°. Correspondence between the diameter of light spot and detecting range is given in Table below.

717

)))

718

719

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654831810009-716.png?rev=1.1||alt="1654831810009-716.png"]]

720

721

(((

722

If the light spot reaches two objects with different distances, as shown in Figure 3, the output distance value will be a value between the actual distance values of the two objects. For a high accuracy requirement in practice, the above situation should be noticed to avoid the measurement error.

)))

=== 2.7.3 Notice of usage ===

727

728

729

Possible invalid /wrong reading for LiDAR ToF tech:

730

731

* Measure high reflectivity object such as: Mirror, Smooth ceramic tile, static milk surface, will have possible wrong readings.

732

* While there is transparent object such as glass, water drop between the measured object and the LiDAR sensor, the reading might be wrong.

733

* The LiDAR probe is cover by dirty things; the reading might be wrong. In this case, need to clean the probe.

734

* The sensor window is made by Acrylic. Don't touch it with alcohol material. This will destroy the sensor window.

735

736

=== 2.7.4 Reflectivity of different objects ===

737

738

739

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

740

|=(% style="width: 54px;background-color:#4F81BD;color:white" %)Item|=(% style="width: 231px;background-color:#4F81BD;color:white" %)Material|=(% style="width: 94px;background-color:#4F81BD;color:white" %)Relectivity

741

|(% style="width:53px" %)1|(% style="width:229px" %)Black foam rubber|(% style="width:93px" %)2.4%

742

|(% style="width:53px" %)2|(% style="width:229px" %)Black fabric|(% style="width:93px" %)3%

743

|(% style="width:53px" %)3|(% style="width:229px" %)Black rubber|(% style="width:93px" %)4%

744

|(% style="width:53px" %)4|(% style="width:229px" %)Coal (different types of coal)|(% style="width:93px" %)4~~8%

745

|(% style="width:53px" %)5|(% style="width:229px" %)Black car paint|(% style="width:93px" %)5%

746

|(% style="width:53px" %)6|(% style="width:229px" %)Black Jam|(% style="width:93px" %)10%

747

|(% style="width:53px" %)7|(% style="width:229px" %)Opaque black plastic|(% style="width:93px" %)14%

748

|(% style="width:53px" %)8|(% style="width:229px" %)Clean rough board|(% style="width:93px" %)20%

749

|(% style="width:53px" %)9|(% style="width:229px" %)Translucent plastic bottle|(% style="width:93px" %)62%

750

|(% style="width:53px" %)10|(% style="width:229px" %)Carton cardboard|(% style="width:93px" %)68%

751

|(% style="width:53px" %)11|(% style="width:229px" %)Clean pine|(% style="width:93px" %)70%

752

|(% style="width:53px" %)12|(% style="width:229px" %)Opaque white plastic|(% style="width:93px" %)87%

753

|(% style="width:53px" %)13|(% style="width:229px" %)White Jam|(% style="width:93px" %)90%

754

|(% style="width:53px" %)14|(% style="width:229px" %)Kodak Standard Whiteboard|(% style="width:93px" %)100%

755

|(% style="width:53px" %)15|(% style="width:229px" %)(((

756

Unpolished white metal surface

757

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

758

|(% style="width:53px" %)16|(% style="width:229px" %)Glossy light metal surface|(% style="width:93px" %)150%

759

|(% style="width:53px" %)17|(% style="width:229px" %)stainless steel|(% style="width:93px" %)200%

760

|(% style="width:53px" %)18|(% style="width:229px" %)Reflector plate, reflective tape|(% style="width:93px" %)>300%

761

762

= 3. Configure LDS12-LB/LS =

763

764

== 3.1 Configure Methods ==

765

766

767

LDS12-LB/LS supports below configure method:

768

769

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

770

771

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

772

773

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

774

775

== 3.2 General Commands ==

776

777

778

These commands are to configure:

779

780

* General system settings like: uplink interval.

781

782

* LoRaWAN protocol & radio related command.

783

784

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

785

786

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

787

788

789

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

790

791

792

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

793

794

795

=== 3.3.1 Set Transmit Interval Time ===

(((

Feature: Change LoRaWAN End Node Transmit Interval.

)))

(((

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

804

)))

805

806

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

807

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

808

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

809

30000

810

OK

811

the interval is 30000ms = 30s

812

)))

813

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

814

OK

815

Set transmit interval to 60000ms = 60 seconds

)))

(((

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

)))

(((

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

)))

(((

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

)))

* (((

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

832

)))

833

* (((

834

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

)))

=== 3.3.2 Set Interrupt Mode ===

841

842

843

Feature, Set Interrupt mode for pin of GPIO_EXTI.

844

845

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

846

847

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

848

849

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

850

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

851

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

852

0

853

OK

854

the mode is 0 =Disable Interrupt

855

)))

856

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

857

AT+INTMOD=2(default)

858

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

859

Set Transmit Interval

860

0. (Disable Interrupt),

861

~1. (Trigger by rising and falling edge)

862

2. (Trigger by falling edge)

863

3. (Trigger by rising edge)

864

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

865

866

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

867

868

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

869

870

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

871

872

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

873

874

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

875

876

=== 3.3.3 Set Power Output Duration ===

877

878

879

Control the output duration 3V3(pin of VBAT_OUT) . Before each sampling, device will

880

881

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

882

883

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

884

885

3. final, close the power output.

886

887

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

888

889

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

890

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

891

|(% style="width:154px" %)AT+3V3T=?|(% style="width:196px" %)Show 3V3 open time.|(% style="width:157px" %)0 (default)

892

OK

893

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

894

|(% style="width:154px" %)AT+3V3T=0|(% style="width:196px" %)Always turn on the power supply of 3V3 pin.|(% style="width:157px" %)OK

895

|(% style="width:154px" %)AT+3V3T=65535|(% style="width:196px" %)Always turn off the power supply of 3V3 pin.|(% style="width:157px" %)OK

896

897

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

898

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

899

900

The first byte is 01,the second and third bytes are the time to turn on.

901

902

* Example 1: Downlink Payload: 07 01 00 00 **~-~-->** AT+3V3T=0

903

* Example 2: Downlink Payload: 07 01 01 F4 **~-~-->** AT+3V3T=500

904

* Example 3: Downlink Payload: 07 01 FF FF **~-~-->** AT+3V3T=65535

905

906

= 4. Battery & Power Consumption =

907

908

909

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

910

911

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

912

913

914

= 5. OTA Firmware update =

915

916

917

(% class="wikigeneratedid" %)

918

User can change firmware LDS12-LB/LS to:

919

920

* Change Frequency band/ region.

921

922

* Update with new features.

* Fix bugs.

Firmware and changelog can be downloaded from : **[[Firmware download link>>url:https://www.dropbox.com/sh/w1p7ukjrx49e62r/AAB3uCNCt-koYUvMkZUPBRSca?dl=0]]**

927

928

Methods to Update Firmware:

929

930

* (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/]]**

931

932

* 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. Case Study =

== 6.1 Calcultate vechicel / object pass through number ==

937

938

939

(% class="wikigeneratedid" %)

940

A demo software is designed to calculate the objects pass through Area 1 and Area 2 as below figure. In this mode, The LDS12-LB/LS will continue to measure the distance and count the pass objects in Area 1, Area 2, according to the distance change. Note, in this mode, The LDS12-LB/LS need to powered by external power, the internal battery is not enough for such calculation, battery will running out very soon.

941

942

(% class="wikigeneratedid" %)

943

[[image:image-20240118001756-1.png||height="500" width="571"]]

944

945

946

To acheive this purpose, user can use the continously measure mode ( which has the uplink Fport=6)

947

948

(% style="color:red" %)**Note: Unreleased features, need to test please contact us.**

949

950

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

951

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

952

**Size(bytes)**

953

)))|=(% style="width: 30px; 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: 70px; background-color:#4F81BD; color: white;" %)**4**|=(% style="background-color:#4F81BD; color: white; width: 50px;" %)**2**|=(% style="background-color: #4F81BD; color: white; width: 50px;" %)2|=(% style="background-color:#4F81BD; color: white; width: 70px;" %)4|=(% style="background-color:#4F81BD; color: white; width: 80px;" %)1

954

955

956

[[image:image-20240118092651-1.png||height="269" width="1091"]]

957

958

(% style="color:blue" %)**Battery Info**

959

960

Check the battery voltage.

Ex1: 0x0B45 = 2885mV

Ex2: 0x0B49 = 2889mV

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

968

969

Area 1 Range Minimum distance.(Max 1200cm)

Ex: 0x0064 = 100cm

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

975

976

Area 1 Range Maximum distance.(Max 1200cm)

Ex: 0x01C2 = 450cm

(% style="color:blue" %)**Count1 times**

Area 1 Total count.

Ex: 0x000002A0~-~-~-~-> 672 times

986

987

988

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

989

990

Area 2 Range Minimum distance.(Max 1200cm)

Ex: 0x01C2 = 450cm

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

996

997

Area 2 Range Maximum distance.(Max 1200cm)

Ex: 0x0320 = 800cm

(% style="color:blue" %)**Count2 times **

Area 2 Total count.

Ex: 00000010 ~-~-~-~-> 16 times

(% style="color:blue" %)**Interrupt flag & Interrupt Level**

1011

1012

This data field shows if this packet is generated by interrupt or not.

1013

1014

Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.8PinDefinitions"]] of GPIO_EXTI .

**Example:**

If byte[0]&0x01=0x00 : Normal uplink packet.

1019

1020

If byte[0]&0x01=0x01 : Interrupt Uplink Packet.

=== 6.1.1 Set LDS12 in the counting mode ===

1025

1026

Feature, Set the distance count mode.

1027

1028

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

1029

1030

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

1031

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

1032

|(% style="width:235px" %)AT+MEACOUNT=?|(% style="width:267px" %)Gets the current measurement count mode and locale Settings|(% style="width:306px" %)1,20,100,450,450,800

1033

OK

1034

|(% style="width:235px" %)AT+MEACOUNT=0,0,0,0,0,0|(% style="width:267px" %)disable measurement count mode|(% style="width:306px" %)OK

1035

1036

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

1037

|=(% style="width: 160px; background-color:#4F81BD; color: white;" %)**Command Example**|=(% style="width:190px; background-color:#4F81BD; color: white;" %)**Function**|=(% style="width:160px; background-color:#4F81BD; color: white;" %)**Parameter**

1038

|(% colspan="1" rowspan="6" style="width:158px" %)(((

AT+MEACOUNT=

1,20,100,450,450,800

)))|(% style="width:278px" %)The first bit sets the measurement count mode|(% style="width:302px" %)00: Off mode

1051

01: Enable mode

1052

|(% style="width:278px" %)The second bit sets the acquisition distance of several times per second.|(% style="width:302px" %)(((

1053

Max: 20 times/s

1054

)))

1055

|(% style="width:278px" %)The third bit sets the minimum distance of area 1 detection range.|(% colspan="1" rowspan="2" style="width:302px" %)(((

Max: 1200cm

If both values are 0, area 1 is not set and area 1 is not detected.

1060

)))

1061

|(% style="width:278px" %)The fourth bit sets the maximum distance of area 1 detection range.

1062

|(% style="width:278px" %)The fifth bit sets the minimum distance of area 2 detection range.|(% colspan="1" rowspan="2" style="width:302px" %)(((

Max: 1200cm

If both values are 0, area 2 is not set and area 2 is not detected.

1067

)))

1068

|(% style="width:278px" %)The sixth bit sets the maximum distance of area 2 detection range.

1069

1070

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

1071

1072

Format: Command Code (0x08) followed by 10 bytes.

1073

1074

If the downlink payload=**08 01 14 00 64 01 C2 01 C2 03 20**, it means enable the measurement count mode(0x01), and it means set 0x14=20 collection times per second, the closest distance of the area 1 range is 0x0064=100cm, the farthest distance of the area 1 range is 0x01C2=450cm, the closest distance of the area 2 range is 0x01C2=450cm, the farthest distance of the area 2 range is 0x0320=800cm, while type code is 0x08.

1075

1076

* Example 0: Downlink Payload: 08 01 14 00 00 00 00 01 C2 03 20 **~-~-->** AT+MEACOUNT=1,20,0,0,450,800

1077

* Example 1: Downlink Payload: 08 01 14 00 64 01 C2 00 00 00 00 **~-~-->** AT+MEACOUNT=1,20,100,145,0,0

1078

1079

=== 6.1.2 Channel 1/ channel 2 count Settings ===

1080

1081

1082

Feature, Set the channel 1/ channel 2 count value.

1083

1084

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

1085

1086

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

1087

|=(% style="width: 171px; background-color: rgb(79, 129, 189); color: white;" %)**Command Example**|=(% style="width: 196px; background-color: rgb(79, 129, 189); color: white;" %)**Function**|=(% style="width: 145px; background-color: rgb(79, 129, 189); color: white;" %)**Response**

1088

|(% style="width:171px" %)AT+SETCNT=1,0|(% style="width:196px" %)Set the count of channel 1 to 0.|(% style="width:149px" %)OK

1089

|(% style="width:171px" %)AT+SETCNT=2,30|(% style="width:196px" %)Set the count of channel 2 to 30.|(% style="width:149px" %)OK

1090

1091

(% style="color:blue" %)**Downlink Command: 0x09 01/0x09 02**

1092

1093

Format: Command Code (0x09 01/0x09 02) followed by 4 bytes.

1094

1095

* Example 0: Downlink Payload: 09 01 00 00 00 00 **~-~-->** AT+SETCNT=1,0

1096

* Example 1: Downlink Payload: 09 02 00 00 00 1E **~-~-->** AT+SETCNT=2,30

= 7. FAQ =

== 7.1 What is the frequency plan for LDS12-LB/LS? ==

1101

1102

1103

LDS12-LB/LS use the same frequency as other Dragino products. User can see the detail from this link: [[Introduction>>doc:Main.End Device Frequency Band.WebHome||anchor="H1.Introduction"]]

1104

1105

1106

= 8. Trouble Shooting =

1107

1108

== 8.1 AT Command input doesn't work ==

1109

1110

1111

In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:blue" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:blue" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string.

1112

1113

1114

== 8.2 Significant error between the output distant value of LiDAR and actual distance ==

(((

(% style="color:blue" %)**Cause ①**(%%)**：**Due to the physical principles of The LiDAR probe, the above phenomenon is likely to occur if the detection object is the material with high reflectivity (such as mirror, smooth floor tile, etc.) or transparent substance. (such as glass and water, etc.)

)))

(((

(% style="color:red" %)**Troubleshooting**(%%): Please avoid use of this product under such circumstance in practice.

)))

(((

(% style="color:blue" %)**Cause ②**(%%)**: **The IR-pass filters are blocked.

)))

(((

(% style="color:red" %)**Troubleshooting**(%%): please use dry dust-free cloth to gently remove the foreign matter.

)))

= 9. Order Info =

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

1139

1140

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

1141

1142

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

1143

1144

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

1145

1146

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

1147

1148

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

1149

1150

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

1151

1152

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

1153

1154

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

1155

1156

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

= 10. Packing Info =

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

1162

1163

* LDS12-LB or LDS12-LS LoRaWAN LiDAR ToF Distance Sensor x 1

1164

1165

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

* Device Size: cm

* Device Weight: g

* Package Size / pcs : cm

* Weight / pcs : g

= 11. 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.

1179

1180

* 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 LDS12-LB/LS -- LoRaWAN LiDAR ToF Distance Sensor User Manual

Applications

Navigation