LTS5 LoRa HMI Touch Screen

LTS5 is a (% style="color:blue" %)LoRa / LoRaWAN HMI Touch Screen(%%) designed for display purpose of IoT project. It have a 5.0" HMI touch screen, and support WiFi, Bluetooch, LoRa wireless protocol.

22

23

LTS5 is an Open Source software project. The MCU is ESP32 and Dragino LA66 LoRa module. There are lots of development source for ESP32 which can greatly reduce the development time.

24

25

The HMI touch screen of LTS5 supports drap & drop design. Developer can use SquareLine to easily customize the UI.

== 1.2 Features ==

* Wall Attachable.

* LoRaWAN v1.0.3 Class A protocol.

33

* 1 x push button. Different Color available.

34

* Built-in Temperature & Humidity sensor

35

* Built-in speaker

36

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

37

* AT Commands to change parameters

38

* Remote configure parameters via LoRaWAN Downlink

39

* Firmware upgradable via program port

40

* Support 2 x AAA LR03 batteries.

41

* IP Rating: IP52

42

43

== 1.3 Specification ==

44

45

46

**Built-in Temperature Sensor:**

47

48

* Resolution: 0.01 °C

49

* Accuracy Tolerance: Typ ±0.2 °C

50

* Long Term Drift: < 0.03 °C/yr

51

* Operating Range: -10 ~~ 50 °C or -40 ~~ 60 °C (depends on battery type, see [[FAQ>>||anchor="H6.5Whyiseedifferentworkingtemperatureforthedevice3F"]])

52

53

**Built-in Humidity Sensor:**

54

55

* Resolution: 0.01 %RH

56

* Accuracy Tolerance: Typ ±1.8 %RH

57

* Long Term Drift: < 0.2% RH/yr

58

* Operating Range: 0 ~~ 99.0 %RH(no Dew)

59

60

== 1.4 Power Consumption ==

61

62

63

PB01 : Idle: 5uA, Transmit: max 110mA

64

65

66

== 1.5 Storage & Operation Temperature ==

67

68

69

-10 ~~ 50 °C or -40 ~~ 60 °C (depends on battery type, see [[FAQ>>||anchor="H6.5Whyiseedifferentworkingtemperatureforthedevice3F"]])

70

71

72

== 1.6 Applications ==

73

74

75

* Smart Buildings & Home Automation

76

* Logistics and Supply Chain Management

* Smart Metering

* Smart Agriculture

* Smart Cities

* Smart Factory

= 2. Operation Mode =

83

84

== 2.1 How it work? ==

85

86

87

Each PB01 is shipped with a worldwide unique set of LoRaWAN OTAA keys. To use PB01 in a LoRaWAN network, user needs to input the OTAA keys in LoRaWAN network server. After this, if PB01 is under this LoRaWAN network coverage, PB01 can join the LoRaWAN network and start to transmit sensor data. The default period for each uplink is** 20 minutes**.

88

89

90

== 2.2 How to Activate PB01? ==

91

92

93

(% style="color:red" %)** 1. Open enclosure from below position.**

94

95

[[image:image-20220621093835-1.png]]

96

97

98

(% style="color:red" %)** 2. Insert 2 x AAA LR03 batteries and the node is activated.**

99

100

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

101

102

103

(% style="color:red" %)** 3. Under the above conditions, users can also reactivate the node by long pressing the ACT button.**

104

105

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

106

107

108

User can check [[LED Status>>||anchor="H2.8LEDIndicator"]] to know the working state of PB01.

109

110

111

== 2.3 Example to join LoRaWAN network ==

112

113

114

This section shows an example for how to join the [[TheThingsNetwork>>url:https://www.thethingsnetwork.org/]] LoRaWAN IoT server. Usages with other LoRaWAN IoT servers are of similar procedure.

115

116

(% _mstvisible="1" class="wikigeneratedid" %)

117

Assume the LPS8v2 is already set to connect to [[TTN V3 network >>url:https://eu1.cloud.thethings.network/]]. We need to add the PB01 device in TTN V3 portal.

118

119

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

120

121

(% style="color:blue" %)**Step 1**(%%): Create a device in TTN V3 with the OTAA keys from PB01.

122

123

Each PB01 is shipped with a sticker with the default DEV EUI as below:

124

125

[[image:image-20230426083617-1.png||height="294" width="633"]]

126

127

128

Enter these keys in the LoRaWAN Server portal. Below is TTN V3 screen shot:

Create application.

choose to create the device manually.

133

134

Add JoinEUI(AppEUI), DevEUI, AppKey.(% style="display:none" %)

135

136

[[image:image-20240507142116-1.png||height="410" width="1138"]](% style="display:none" %) (%%)

137

138

139

[[image:image-20240507142157-2.png||height="559" width="1147"]]

140

141

[[image:image-20240507142401-3.png||height="693" width="1202"]]

142

143

[[image:image-20240507142651-4.png||height="760" width="1190"]]

144

145

**Default mode OTAA**(% style="display:none" %)

146

147

148

(% style="color:blue" %)**Step 2**(%%): Use ACT button to activate PB01 and it will auto join to the TTN V3 network. After join success, it will start to upload sensor data to TTN V3 and user can see in the panel.

149

150

[[image:image-20240507143104-5.png||height="434" width="1398"]]

151

152

153

== 2.4 Uplink Payload ==

154

155

156

Uplink payloads include two types: Valid Sensor Value and other status / control command.

157

158

* Valid Sensor Value: Use FPORT=2

159

* Other control command: Use FPORT other than 2.

160

161

=== 2.4.1 Uplink FPORT~=5, Device Status ===

162

163

164

Users can get the Device Status uplink through the downlink command:

165

166

(% style="color:#4472c4" %)**Downlink: **(%%)**0x2601**

167

168

Uplink the device configures with FPORT=5.

169

170

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

171

|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**Size(bytes)(% style="display:none" %) (%%)**|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 30px;background-color:#4F81BD;color:white" %)**2**

172

173

174

[[image:image-20240507152130-12.png||height="469" width="1366"]](% style="display:none" %)

175

176

Example Payload (FPort=5): [[image:image-20240507152254-13.png||height="26" width="130"]]

177

178

179

(% style="color:#4472c4" %)**Sensor Model**(%%): For PB01, this value is 0x35.

180

181

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

182

183

(% style="color:#4472c4" %)**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

(% style="color:#4472c4" %)**Sub-Band**(%%): value 0x00 ~~ 0x08(only for CN470, AU915,US915. Others are0x00)

207

208

(% style="color:#4472c4" %)**BAT**(%%): shows the battery voltage for PB01.

209

210

(% style="color:#4472c4" %)**Ex1**(%%): 0x0C DE = 3294mV

211

212

213

=== 2.4.2 Uplink FPORT~=2, Real time sensor value ===

214

215

216

PB01 will send this uplink after Device Status uplink once join LoRaWAN network successfully. And it will periodically send this uplink. Default interval is 20 minutes and [[can be changed>>||anchor="H3.1A0DownlinkCommandSet"]].

217

218

Uplink uses FPORT=2 and every 20 minutes send one uplink by default.

219

220

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

221

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

222

**Size(bytes)**

223

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

224

**1**

225

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

226

**1**

227

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

228

**2**

229

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

230

**2**

231

)))

232

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

233

Value

234

)))|(% style="width:39px" %)Battery|(% style="width:39px" %)(((

Sound_ACK

&Sound_key

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

(((

Alarm

)))

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

(((

Temperature

)))

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

Humidity

)))

Example in TTN.

[[image:image-20240507150155-11.png||height="549" width="1261"]]

253

254

Example Payload (FPort=2): (% style="background-color:yellow" %)**0C EA 03 01 01 11 02 A8**

255

256

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

257

258

Check the battery voltage.

259

260

* Ex1: 0x0CEA = 3306mV

261

* Ex2: 0x0D08 = 3336mV

262

263

==== (% style="color:blue" %)**Sound_ACK & Sound_key:**(%%) ====

264

265

Key sound and ACK sound are enabled by default.

* Example1: 0x03

Sound_ACK: (03>>1) & 0x01=1, OPEN.

270

271

**~ ** Sound_key: 03 & 0x01=1, OPEN.

* Example2: 0x01

Sound_ACK: (01>>1) & 0x01=0, CLOSE.

276

277

**~ ** Sound_key: 01 & 0x01=1, OPEN.

278

279

280

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

Key alarm.

* Ex1: 0x01 & 0x01=1, TRUE.

285

* Ex2: 0x00 & 0x01=0, FALSE.

286

287

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

288

289

* Example1: 0x0111/10=27.3℃

290

* Example2: (0xFF0D-65536)/10=-24.3℃

291

292

If payload is: FF0D : (FF0D & 8000 == 1) , temp = (FF0D - 65536)/100 =-24.3℃

293

294

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

295

296

297

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

298

299

* Humidity: 0x02A8/10=68.0%

300

301

=== 2.4.3 Uplink FPORT~=3, Datalog sensor value ===

302

303

304

PB01 stores sensor value and user can retrieve these history value via downlink command. The Datalog sensor value are sent via FPORT=3.

305

306

[[image:image-20240510144912-1.png||height="471" width="1178"]](% style="display:none" %)

307

308

309

* Each data entry is 11 bytes, to save airtime and battery, PB01 will send max bytes according to the current DR and Frequency bands.(% style="display:none" %)

310

311

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

312

313

1. **DR0**: max is 11 bytes so one entry of data

314

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

315

1. **DR2**: total payload includes 11 entries of data

316

1. **DR3**: total payload includes 22 entries of data.

317

318

(% style="color:red" %)**Notice: PB01 will save 178 set of history data, If device doesn't have any data in the polling time. Device will uplink 11 bytes of 0.**

319

320

See more info about the [[Datalog feature>>||anchor="H2.6A0DatalogFeature"]].

321

322

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

323

324

=== 2.4.4 Decoder in TTN V3 ===

325

326

327

In LoRaWAN protocol, the uplink payload is HEX format, user need to add a payload formatter/decoder in LoRaWAN Server to get human friendly string.

328

329

In TTN , add formatter as below:

330

331

[[image:image-20240507162814-16.png||height="778" width="1135"]]

332

333

(((

334

Please check the decoder from this link: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]

)))

(((

)))

== 2.5 Show data on Datacake ==

(((

Datacake IoT platform provides a human friendly interface to show the sensor data in charts, once we have sensor data in TTN V3, we can use Datacake to connect to TTN V3 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 LoRaWAN network.

)))

(((

(% style="color:blue" %)**Step 2**(%%): Configure your Application to forward data to Datacake you will need to add integration. Go to TTN V3 Console ~-~-> Applications ~-~-> Integrations ~-~-> Add Integrations.

)))

(((

~1. Add Datacake:

)))

(((

2. Select default key as Access Key:

)))

(((

3. In Datacake console ([[https:~~/~~/datacake.co/>>url:https://datacake.co/]]) , add PB01:

)))

(((

Please refer to the figure below.

374

)))

375

376

[[image:image-20240510150924-2.png||height="612" width="1186"]]

377

378

379

Log in to DATACAKE, copy the API under the account.

380

381

[[image:image-20240510151944-3.png||height="581" width="1191"]]

[[image:image-20240510152150-4.png||height="697" width="1188"]]

386

387

388

[[image:image-20240510152300-5.png||height="298" width="1191"]]

389

390

391

[[image:image-20240510152355-6.png||height="782" width="1193"]]

392

393

[[image:image-20240510152542-8.png||height="545" width="739"]]

394

395

[[image:image-20240510152634-9.png||height="748" width="740"]]

396

397

398

[[image:image-20240510152809-10.png||height="607" width="732"]]

399

400

[[image:image-20240510153934-14.png||height="460" width="1199"]]

401

402

403

[[image:image-20240510153435-12.png||height="428" width="1197"]]

404

405

406

Copy and paste the [[TTN decoder>>https://github.com/dragino/dragino-end-node-decoder]] here and save.

407

408

[[image:image-20240510153624-13.png||height="468" width="1195"]]

409

410

411

Visual widgets please read the DATACAKE documentation.

412

413

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

414

415

== 2.6 Datalog Feature ==

416

417

418

(% _msthash="315262" _msttexthash="32283004" _mstvisible="1" %)

419

When user want to retrieve sensor value, he can send a poll command from the IoT platform to ask sensor to send value in the required time slot.

420

421

422

=== 2.6.1 Unix TimeStamp ===

423

424

425

Unix TimeStamp shows the sampling time of uplink payload. format base on

426

427

[[image:image-20220523001219-11.png||_mstalt="450450" _mstvisible="3" height="97" width="627"]]

428

429

User can get this time from link: [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/||_mstvisible="3"]] :

430

431

For example: if the Unix Timestamp we got is hex 0x60137afd, we can convert it to Decimal: 1611889405. and then convert to the time: 2021 – Jan ~-~- 29 Friday 03:03:25 (GMT)

432

433

434

[[image:1655782409139-256.png]]

435

436

437

=== 2.6.2 Poll sensor value ===

(((

User can poll sensor value based on timestamps from the server. Below is the downlink command.

)))

(((

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

)))

(((

For example, downlink command [[image:image-20220621113526-13.png]] (% _mstvisible="3" style="display:none" %)

)))

(((

Is to check 2020/12/1 07:40:00 to 2020/12/1 08:40:00's data

)))

(((

Uplink Internal =5s，means PB01 will send one packet every 5s. range 5~~255s.

)))

=== 2.6.3 Datalog Uplink payload ===

462

463

464

See [[Uplink FPORT=3, Datalog sensor value>>||anchor="H2.4.3A0UplinkFPORT3D32CDatalogsensorvalue"]]

465

466

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

== 2.7 Button ==

* ACT button

Long press this button PB01 will reset and join network again.

474

475

[[image:image-20240510161626-17.png||height="192" width="224"]]

* Alarm button

Press the button PB01 will immediately uplink data, and alarm is "TRUE".

480

481

[[image:image-20240705095149-5.png||height="164" width="162"]](% style="display:none" %)

482

483

484

== 2.8 LED Indicator ==

(((

The PB01 has a triple color LED which for easy showing different stage.

489

)))

490

491

Hold the ACT green light to rest, then the green flashing node restarts, the blue flashing once upon request for network access, and the green constant light for 5 seconds after successful network access

492

493

(((

494

(% style="color:#037691" %)**In a normal working state**:

495

)))

496

497

* When the node is restarted, hold the ACT (% style="color:green" %)**GREEN**(%%) lights up , then the (% style="color:green" %)**GREEN**(%%) flashing node restarts.The (% style="color:blue" %)**BLUE**(%%) flashing once upon request for network access, and the (% style="color:green" %)**GREEN**(%%) constant light for 5 seconds after successful network access(% style="color:#0000ff" %)**.**

498

* During OTAA Join:

499

** **For each Join Request uplink:** the (% style="color:green" %)**GREEN LED** (%%)will blink once.

500

** **Once Join Successful:** the (% style="color:green" %)**GREEN LED**(%%) will be solid on for 5 seconds.

501

* After joined, for each uplink, the (% style="color:blue" %)**BLUE LED**(%%) or (% style="color:green" %)**GREEN LED** (%%)will blink once.

502

* Press the alarm button，The (% style="color:red" %)**RED**(%%) flashes until the node receives the ACK from the platform and the (% style="color:blue" %)**BLUE**(%%) light stays 5s.

(((

)))

== 2.9 Buzzer ==

The PB01 has** button sound** and** ACK sound** and users can turn on or off both sounds by using [[AT+SOUND>>||anchor="H3.3A0Setbuttonsoundandbuttonalarm"]].

512

513

* (% style="color:#4f81bd" %)**Button sound**(%%)** **is the music produced by the node after the alarm button is pressed.

514

515

Users can use[[ AT+OPTION>>||anchor="H3.4A0Setbuzzermusic2807E429"]] to set different button sounds.

516

517

* (% style="color:#4f81bd" %)**ACK sound **(%%)is the notification tone that the node receives ACK.

518

519

= 3. Configure PB01 via AT command or LoRaWAN downlink =

520

521

522

Users can configure PB01 via AT Command or LoRaWAN Downlink.

523

524

* AT Command Connection: See [[FAQ>>||anchor="H6.FAQ"]].

525

526

* LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>doc:Main.WebHome]]

527

528

There are two kinds of commands to configure PB01, they are:

529

530

* (% style="color:#4f81bd" %)**General Commands:**

531

532

These commands are to configure:

533

534

* General system settings like: uplink interval.

535

536

* LoRaWAN protocol & radio-related commands.

537

538

They are the same for all Dragino Devices which supports DLWS-005 LoRaWAN Stack(Note~*~*). These commands can be found on the wiki: [[End Device Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]

539

540

541

* (% style="color:#4f81bd" %)**Commands special design for PB01**

542

543

These commands are only valid for PB01, as below:

544

545

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

546

547

== 3.1 Downlink Command Set ==

548

549

550

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

551

|=(% style="width: 130px; background-color: rgb(79, 129, 189); color: white;" %)**Command Example**|=(% style="width: 151px; background-color: rgb(79, 129, 189); color: white;" %)**Function**|=(% style="width: 92px; background-color: rgb(79, 129, 189); color: white;" %)**Response**|=(% style="width: 206px; background-color: rgb(79, 129, 189); color: white;" %)**Downlink**

552

|(% style="width:130px" %)AT+TDC=?|(% style="width:151px" %)(((

553

554

555

View current TDC time

556

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

557

1200000

558

OK

559

)))|(% style="width:206px" %)Default 1200000(ms)

560

|(% style="width:130px" %)AT+TDC=300000|(% style="width:151px" %)Set TDC time|(% style="width:92px" %)OK|(% style="width:206px" %)(((

(((

0X0100012C:

01: fixed command

00012C: 0X00012C=

300(seconds)

)))

(((

)))

)))

|(% style="width:130px" %)ATZ|(% style="width:151px" %)Reset node|(% style="width:92px" %) |(% style="width:206px" %)0x04FF

574

|(% style="width:130px" %)AT+FDR|(% style="width:151px" %)Restore factory settings|(% style="width:92px" %) |(% style="width:206px" %)0X04FE

575

|(% style="width:130px" %)AT+CFM=?|(% style="width:151px" %)View the current confirmation mode status|(% style="width:92px" %)(((

0,7,0

OK

)))|(% style="width:206px" %)Default 0,7,0

580

|(% style="width:130px" %)AT+CFM=1,7,1|(% style="width:151px" %)(((

581

Confirmed uplink mode, the maximum number of retries is seven, and uplink fcnt increase by 1 for each retry

582

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

583

OK

584

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

05010701

05: fixed command

01:confirmed uplink

07: retry 7 times

01: fcnt count plus 1

594

)))

595

|(% style="width:130px" %)AT+NJM=?|(% style="width:151px" %)(((

596

Check the current network connection method

597

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

598

1

599

OK

600

)))|(% style="width:206px" %)Default 1

601

|(% style="width:130px" %)AT+NJM=0|(% style="width:151px" %)Change the network connection method to ABP|(% style="width:92px" %)(((

602

Attention:Take effect after ATZ

603

OK

604

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

0X2000: ABP

0x2001: OTAA

20: fixed command

)))

|(% style="width:130px" %)AT+RPL=?|(% style="width:151px" %)View current RPL settings|(% style="width:92px" %)(((

610

0

611

OK

612

)))|(% style="width:206px" %)Default 0

613

|(% style="width:130px" %)AT+RPL=1|(% style="width:151px" %)set RPL=1 |(% style="width:92px" %)OK|(% style="width:206px" %)(((

614

0x2101:

615

21: fixed command

616

01: for details, check wiki

617

)))

618

|(% style="width:130px" %)AT+ADR=?|(% style="width:151px" %)View current ADR status|(% style="width:92px" %)(((

619

1

620

OK

621

)))|(% style="width:206px" %)Default 0

622

|(% style="width:130px" %)AT+ADR=0|(% style="width:151px" %)Set the ADR state to off|(% style="width:92px" %)OK|(% style="width:206px" %)(((

0x2200: close

0x2201: open

22: fixed command

)))

|(% style="width:130px" %)AT+DR=?|(% style="width:151px" %)View the current DR settings|(% style="width:92px" %)OK|(% style="width:206px" %)

628

|(% style="width:130px" %)AT+DR=1|(% style="width:151px" %)(((

629

set DR to 1

630

It takes effect only when ADR=0

631

)))|(% style="width:92px" %)OK|(% style="width:206px" %)(((

0X22000101:

00: ADR=0

01: DR=1

01: TXP=1

22: fixed command

)))

|(% style="width:130px" %)AT+TXP=?|(% style="width:151px" %)View the current TXP|(% style="width:92px" %)OK|(% style="width:206px" %)

639

|(% style="width:130px" %)AT+TXP=1|(% style="width:151px" %)(((

640

set TXP to 1

641

It takes effect only when ADR=0

642

)))|(% style="width:92px" %)OK|(% style="width:206px" %)(((

0X22000101:

00: ADR=0

01: DR=1

01: TXP=1

22: fixed command

)))

|(% style="width:130px" %)AT+RJTDC=10|(% style="width:151px" %)Set RJTDC time interval|(% style="width:92px" %)OK|(% style="width:206px" %)(((

0X26000A:

26: fixed command

000A: 0X000A=10(min)

for details, check wiki

654

)))

655

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

656

(((

657

~_~_~_~_~_~_~_~_~_~_~_~_~_~_~_~_~_~_~_~_~_~_~_~_~_~_~_~_

658

659

Retrieve stored data for a specified period of time

)))

(((

)))

)))|(% style="width:92px" %) |(% style="width:206px" %)(((

666

0X3161DE7C7061DE8A800A:

667

31: fixed command

668

61DE7C70:0X61DE7C70=2022/1/12 15:00:00

669

61DE8A80:0X61DE8A80=2022/1/12 16:00:00

0A: 0X0A=10(second)

View details 2.6.2

)))

|(% style="width:130px" %)AT+DDETECT=?|(% style="width:151px" %)View the current DDETECT setting status and time|(% style="width:92px" %)(((

674

1,1440,2880

675

OK

676

)))|(% style="width:206px" %)Default 1,1440,2880(min)

677

|(% style="width:130px" %)AT+DDETECT=(((

678

1,1440,2880

679

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

680

Set DDETECT setting status and time

681

((% style="color:red" %)When the node does not receive the downlink packet within the set time, it will re-enter the network(%%))

682

)))|(% style="width:92px" %)OK|(% style="width:206px" %)(((

0X320005A0: close

0X320105A0: open

32: fixed command

05A0: 0X05A0=1440(min)

687

)))

688

689

== 3.2 Set Password ==

690

691

692

Feature: Set device password, max 9 digits.

693

694

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

695

696

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

697

|(% style="background-color:#4f81bd; color:white; width:155px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:128px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:89px" %)**Response**

698

|(% style="width:155px" %)AT+PWORD=?|(% style="width:124px" %)Show password|(% style="width:86px" %)(((

123456

OK

)))

|(% style="width:155px" %)AT+PWORD=999999|(% style="width:124px" %)Set password|(% style="width:86px" %)OK

703

704

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

705

706

No downlink command for this feature.

707

708

709

== 3.3 Set button sound and ACK sound ==

710

711

712

Feature: Turn on/off button sound and ACK alarm.

713

714

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

715

716

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

717

|(% style="background-color:#4f81bd; color:white; width:155px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:128px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:89px" %)**Response**

718

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

719

AT+SOUND=?

720

)))|(% style="width:124px" %)Get the current status of button sound and ACK sound|(% style="width:86px" %)(((

1,1

OK

)))

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

725

AT+SOUND=0,1

726

)))|(% style="width:124px" %)Turn off the button sound and turn on ACK sound|(% style="width:86px" %)OK

727

728

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

729

730

Format: Command Code (0xA1) followed by 2 bytes mode value.

731

732

The first byte after 0XA1 sets the button sound, and the second byte after 0XA1 sets the ACK sound.** (0: off, 1: on)**

733

734

* **Example: **Downlink Payload: A10001 ~/~/ Set AT+SOUND=0,1 Turn off the button sound and turn on ACK sound.

735

736

== 3.4 Set buzzer music type(0~~4) ==

737

738

739

Feature: Set different alarm key response sounds.There are five different types of button music.

740

741

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

742

743

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

744

|(% style="background-color:#4f81bd; color:white; width:155px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:128px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:89px" %)**Response**

745

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

746

AT+OPTION=?

747

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

748

Get the buzzer music type

749

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

3

OK

)))

|(% style="width:155px" %)AT+OPTION=1|(% style="width:124px" %)Set the buzzer music to type 1|(% style="width:86px" %)OK

755

756

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

757

758

Format: Command Code (0xA3) followed by 1 byte mode value.

759

760

* **Example: **Downlink Payload: A300 ~/~/ Set AT+OPTION=0 Set the buzzer music to type 0.

761

762

== 3.5 Set Valid Push Time ==

763

764

765

Feature: Set the holding time for pressing the alarm button to avoid miscontact. Values range from** 0 ~~1000ms**.

766

767

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

768

769

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

770

|(% style="background-color:#4f81bd; color:white; width:155px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:128px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:89px" %)**Response**

771

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

772

AT+STIME=?

773

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

774

Get the button sound time

775

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

0

OK

)))

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

780

AT+STIME=1000

781

)))|(% style="width:124px" %)Set the button sound time to 1000**ms**|(% style="width:86px" %)OK

782

783

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

784

785

Format: Command Code (0xA2) followed by 2 bytes mode value.

786

787

* **Example: **Downlink Payload: A203E8 ~/~/ Set AT+STIME=1000

788

789

**~ Explain: **Hold the alarm button for 10 seconds before the node will send the alarm packet.

= 4. Battery & How to replace =

794

795

== 4.1 Battery Type and replace ==

796

797

798

PB01 uses 2 x AAA LR03(1.5v) batteries. If the batteries running low (shows 2.1v in the platform). Users can buy generic AAA battery and replace it.

799

800

(% style="color:red" %)**Note: **

801

802

1. The PB01 doesn't have any screw, users can use nail to open it by the middle.

803

804

[[image:image-20220621143535-5.png]]

805

806

807

2. Make sure the direction is correct when install the AAA batteries.

808

809

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

810

811

812

== 4.2 Power Consumption Analyze ==

813

814

815

Dragino battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval.

816

817

Instruction to use as below:

818

819

(% style="color:blue" %)**Step 1**(%%): Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from:

820

821

[[battery calculator>>https://www.dropbox.com/sh/sxrgszkac4ips0q/AAA4XjBI3HAHNpdbU3ALN1j0a/Battery%20Document/Battery_Analyze?dl=0&subfolder_nav_tracking=1]]

822

823

824

(% style="color:blue" %)**Step 2**(%%): (% style="display:none" %) (%%)Open it and choose

* Product Model

* Uplink Interval

* Working Mode

And the Life expectation in difference case will be shown on the right.

831

832

[[image:image-20220621143643-7.png||height="429" width="1326"]]

= 5. Accessories =

* (((

(% class="wikigeneratedid" id="H5.2A0ProgramConverter28AS-0229" %)

840

**Program Converter (AS-02)**

841

)))

842

843

AS-02 is an optional accessory, it is USB Type-C converter. AS-02 provide below feature:

844

845

1. Access AT console of PB01 when used with USB-TTL adapter. [[See this link>>||anchor="H6.1HowtouseATCommandtoconfigurePB01"]].

846

847

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

= 6. FAQ =

== 6.1 How to use AT Command to configure PB01 ==

853

854

855

PB01 supports AT Command set. Users can use a USB to TTL adapter plus the Program Cable to connect to PB01 for using AT command, as below.

856

857

[[image:image-20240511085914-1.png||height="570" width="602"]]

**Connection:**

* (% style="background-color:yellow" %)USB to TTL GND <~-~-> Program Converter GND pin

863

* (% style="background-color:yellow" %)USB to TTL RXD <~-~-> Program Converter D+ pin

864

* (% style="background-color:yellow" %)USB to TTL TXD <~-~-> Program Converter A11 pin

865

866

(((

867

In PC, User needs to set **serial tool**(such as [[putty>>url:https://www.chiark.greenend.org.uk/~~sgtatham/putty/latest.html]], SecureCRT) baud rate to (% style="color:green" %)**9600**(%%) to access to access serial console for PB01. The AT commands are disable by default and need to enter password (default:(% style="color:green" %)**123456**(%%)) to active it. Timeout to input AT Command is 5 min, after 5-minute, user need to input password again.

)))

(((

Input password and ATZ to activate PB01, as shown below:

872

)))

873

874

[[image:image-20240510174509-18.png||height="572" width="791"]]

875

876

877

== 6.2 AT Command and Downlink ==

(((

Sending ATZ will reboot the node

)))

(((

Sending AT+FDR will restore the node to factory settings

)))

(((

Get the node's AT command setting by sending AT+CFG

)))

(((

)))

(((

**Example：**

)))

(((

AT+DEUI=FA 23 45 55 55 55 55 51

902

903

AT+APPEUI=FF AA 23 45 42 42 41 11

904

905

AT+APPKEY=AC D7 35 81 63 3C B6 05 F5 69 44 99 C1 12 BA 95

AT+DADDR=FFFFFFFF

AT+APPSKEY=FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF

910

911

AT+NWKSKEY=FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF

AT+ADR=1

AT+TXP=7

AT+DR=5

AT+DCS=0

AT+PNM=1

AT+RX2FQ=869525000

AT+RX2DR=0

AT+RX1DL=5000

AT+RX2DL=6000

AT+JN1DL=5000

AT+JN2DL=6000

AT+NJM=1

AT+NWKID=00 00 00 13

AT+FCU=61

AT+FCD=11

AT+CLASS=A

AT+NJS=1

AT+RECVB=0:

AT+RECV=

AT+VER=EU868 v1.0.0

AT+CFM=0,7,0

AT+SNR=0

AT+RSSI=0

AT+TDC=1200000

AT+PORT=2

AT+PWORD=123456

AT+CHS=0

AT+RX1WTO=24

AT+RX2WTO=6

AT+DECRYPT=0

AT+RJTDC=20

AT+RPL=0

AT+TIMESTAMP=systime= 2024/5/11 01:10:58 (1715389858)

AT+LEAPSEC=18

AT+SYNCMOD=1

AT+SYNCTDC=10

AT+SLEEP=0

AT+ATDC=1

AT+UUID=003C0C53013259E0

990

991

AT+DDETECT=1,1440,2880

AT+SETMAXNBTRANS=1,0

AT+DISFCNTCHECK=0

AT+DISMACANS=0

AT+PNACKMD=0

AT+SOUND=0,0

AT+STIME=0

AT+OPTION=3

)))

(((

**Example：**

)))

[[image:image-20240511091518-2.png||height="601" width="836"]]

1013

1014

1015

== 6.3 How to upgrade the firmware? ==

1016

1017

1018

PB01 requires a program converter to upload images to PB01, which is used to upload image to PB01 for:

1019

1020

* Support new features

1021

* For bug fix

1022

* Change LoRaWAN bands.

1023

1024

PB01 internal program is divided into bootloader and work program, shipping is included bootloader, the user can choose to directly update the work program.

1025

1026

If the bootloader is erased for some reason, users will need to download the boot program and the work program.

1027

1028

1029

=== 6.3.1 Update firmware (Assume device have bootloader) ===

1030

1031

1032

(% style="color:blue" %)**Step 1**(%%):** Connect UART as per FAQ 6.1**

1033

1034

(% style="color:blue" %)**Step 2**(%%):** Update follow [[Instruction for update via DraginoSensorManagerUtility.exe>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H3.2.1UpdateafirmwareviaDraginoSensorManagerUtility.exe]]. **

1035

1036

1037

=== 6.3.2 Update firmware (Assume device doesn't have bootloader) ===

1038

1039

1040

Download both the boot program and the worker program** . **After update , device will have bootloader so can use above 6.3.1 method to update woke program.

1041

1042

(% style="color:blue" %)**Step 1**(%%):** **Install [[TremoProgrammer>>url:https://www.dropbox.com/scl/fo/gk1rb5pnnjw4kv5m5cs0z/h?rlkey=906ouvgbvif721f9bj795vfrh&dl=0]] first.

1043

1044

[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220615170542-5.png?rev=1.1||alt="image-20220615170542-5.png"]]

1045

1046

(% style="color:blue" %)**Step 2**(%%): Hardware Connection

1047

1048

Connect PC and PB01 via USB-TTL adapter .

1049

1050

(% style="color:red" %)**Note: To download firmware in this way, you need to pull the boot pin(Program Converter D- pin) high to enter the burn mode. After burning, disconnect the boot pin of the node and the 3V3 pin of the USB-TTL adapter, and reset the node to exit the burning mode.**

**Connection:**

* (% style="background-color:yellow" %)USB-TTL GND <~-~-> Program Converter GND pin

1055

* (% style="background-color:yellow" %)USB-TTL RXD <~-~-> Program Converter D+ pin

1056

* (% style="background-color:yellow" %)USB-TTL TXD <~-~-> Program Converter A11 pin

1057

* (% style="background-color:yellow" %)USB-TTL 3V3 <~-~-> Program Converter D- pin

1058

1059

(% style="color:blue" %)**Step 3**(%%):** **Select the device port to be connected, baud rate and bin file to be downloaded.

1060

1061

[[image:image-20240701160913-1.png]]

1062

1063

Users need to reset the node to start downloading the program.

1064

~1. Reinstall the battery to reset the node

1065

2. Hold down the ACT button to reset the node (see [[2.7>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/PB01--LoRaWAN_Button_User_Manual/#H2.7Button]] ).

1066

1067

When this interface appears, it indicates that the download has been completed.

1068

1069

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

1070

1071

Finally, Disconnect Program Converter D- pin, reset the node again , and the node exits burning mode.

1072

1073

1074

== 6.4 How to change the LoRa Frequency Bands/Region? ==

1075

1076

1077

User can follow the introduction for [[how to upgrade image>>||anchor="H6.3A0Howtoupgradethefirmware3F"]]. When download the images, choose the required image file for download.

1078

1079

1080

== 6.5 Why i see different working temperature for the device? ==

1081

1082

1083

The working temperature range of device depends on the battery user choose.

1084

1085

* Normal AAA Battery can support -10 ~~ 50°C working range.

1086

* Special AAA battery can support -40 ~~ 60 °C working range. For example: [[Energizer L92>>https://data.energizer.com/pdfs/l92.pdf]]

= 7. Order Info =

== 7.1 Main Device ==

1091

1092

1093

Part Number: (% style="color:#4472c4" %)PB01-LW-XX(%%) (white button) / (% style="color:#4472c4" %)PB01-LR-XX(%%)(Red Button)

1094

1095

(% style="color:#4472c4" %)**XX **(%%): The default frequency band

1096

1097

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

1098

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

1099

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

1100

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

1101

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

1102

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

1103

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

1104

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

= 7. Packing Info =

**Package Includes**:

1110

1111

* PB01 LoRaWAN Push Button x 1

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

1117

* Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]].

1118

1119

= 9. Reference material =

1120

1121

1122

* [[Datasheet, photos, decoder, firmware>>https://www.dropbox.com/scl/fo/y7pvm58wcr8319d5o4ujr/APZtqlbzRCNbHoPWTmmMMWs?rlkey=wfh93x2dhcev3ydn0846rinf0&st=kdp6lg7t&dl=0]]

= 10. FCC Warning =

This device complies with part 15 of the FCC Rules.Operation is subject to the following two conditions:

1128

1129

(1) This device may not cause harmful interference;

1130

1131

(2) this device must accept any interference received,including interference that may cause undesired operation.

1132

Wiki source code of LTS5 LoRa HMI Touch Screen

Applications

Navigation