PB01 -- LoRaWAN Button User Manual

PB01 LoRaWAN Button is a LoRaWAN wireless device with one (% style="color:blue" %)**push button**(%%). Once user push the button, PB01 will transfer the signal to IoT server via Long Range LoRaWAN wireless protocol. PB01 also senses the (% style="color:blue" %)**environment temperature & humidity**(%%) and will also uplink these data to IoT Server.

30

31

PB01 supports (% style="color:blue" %)** 2 x AAA batteries**(%%) and works for a long time up to several years*. User can replace the batteries easily after they are finished.

32

33

PB01 has a built-in speaker, it can pronouns different sound when press button and get reply from server. The speaker can by disable if user want it.

34

35

PB01 is fully compatible with LoRaWAN v1.0.3 protocol, it can work with standard LoRaWAN gateway.

36

37

*Battery life depends how often to send data, please see [[battery analyzer>>||anchor="H4.2A0PowerConsumptionAnalyze"]].

== 1.2 Features ==

* Wall Attachable.

* LoRaWAN v1.0.3 Class A protocol.

46

* 1 x push button. Different Color available.

47

* Built-in Temperature & Humidity sensor

48

* Built-in speaker

49

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

50

* AT Commands to change parameters

51

* Remote configure parameters via LoRaWAN Downlink

52

* Firmware upgradable via program port

53

* Support 2 x AAA LR03 batteries.

54

* IP Rating: IP52

55

56

== 1.3 Specification ==

57

58

59

**Built-in Temperature Sensor:**

60

61

* Resolution: 0.01 °C

62

* Accuracy Tolerance: Typ ±0.2 °C

63

* Long Term Drift: < 0.03 °C/yr

64

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

65

66

**Built-in Humidity Sensor:**

67

68

* Resolution: 0.01 %RH

69

* Accuracy Tolerance: Typ ±1.8 %RH

70

* Long Term Drift: < 0.2% RH/yr

71

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

72

73

== 1.4 Power Consumption ==

74

75

76

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

77

78

79

== 1.5 Storage & Operation Temperature ==

80

81

82

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

83

84

85

== 1.6 Applications ==

86

87

88

* Smart Buildings & Home Automation

89

* Logistics and Supply Chain Management

* Smart Metering

* Smart Agriculture

* Smart Cities

* Smart Factory

= 2. Operation Mode =

96

97

== 2.1 How it work? ==

98

99

100

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

101

102

103

== 2.2 How to Activate PB01? ==

104

105

106

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

107

108

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

109

110

111

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

112

113

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

114

115

116

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

117

118

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

119

120

121

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

122

123

124

== 2.3 Example to join LoRaWAN network ==

125

126

127

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.

128

129

130

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

131

Assume the DLOS8 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.

132

133

134

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

135

136

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

137

138

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

139

140

141

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

Create application.

choose to create the device manually.

146

147

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

148

149

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

150

151

152

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

153

154

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

155

156

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

157

158

**Default mode OTAA**

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

163

164

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

165

166

167

== 2.4 Uplink Payload ==

168

169

170

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

171

172

* Valid Sensor Value: Use FPORT=2

173

* Other control command: Use FPORT other than 2.

174

175

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

176

177

178

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

179

180

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

181

182

Uplink the device configures with FPORT=5.

183

184

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

185

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

186

187

188

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

189

190

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

191

192

193

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

194

195

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

196

197

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

221

222

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

223

224

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

225

226

227

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

228

229

230

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

231

232

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

233

234

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

235

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

236

**Size(bytes)**

237

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

238

**1**

239

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

240

**1**

241

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

242

**2**

243

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

244

**2**

245

)))

246

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

247

Value

248

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

267

268

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

269

270

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

271

272

Check the battery voltage.

273

274

* Ex1: 0x0CEA = 3306mV

275

* Ex2: 0x0D08 = 3336mV

276

277

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

278

279

Key sound and ACK sound are enabled by default.

* Example1: 0x03

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

284

285

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

* Example2: 0x01

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

290

291

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

292

293

294

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

Key alarm.

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

299

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

300

301

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

302

303

* Example1: 0x0111/10=27.3℃

304

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

305

306

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

307

308

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

309

310

311

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

312

313

* Humidity: 0x02A8/10=68.0%

314

315

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

316

317

318

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

319

320

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

321

322

323

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

324

325

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

326

327

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

328

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

329

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

330

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

331

332

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

333

334

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

=== 2.4.4 Decoder in TTN V3 ===

340

341

342

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.

343

344

In TTN , add formatter as below:

345

346

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

347

348

(((

349

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.

389

)))

390

391

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

392

393

394

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

395

396

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

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

401

402

403

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

404

405

406

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

407

408

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

409

410

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

411

412

413

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

414

415

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

416

417

418

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

419

420

421

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

422

423

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

424

425

426

Visual widgets please read the DATACAKE documentation.

== 2.6 Datalog Feature ==

431

432

433

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

434

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.

435

436

437

=== 2.6.1 Unix TimeStamp ===

438

439

440

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

441

442

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

443

444

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

445

446

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)

447

448

449

[[image:1655782409139-256.png]]

450

451

452

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

477

478

479

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

480

481

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

482

483

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

== 2.7 Button ==

* ACT button

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

490

491

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

* Alarm button

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

496

497

[[image:image-20240510154300-15.png]]

== 2.8 LED Indicator ==

(((

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

506

)))

507

508

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

509

510

(((

511

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

512

)))

513

514

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

515

* During OTAA Join:

516

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

517

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

518

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

519

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

529

530

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

531

532

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

533

534

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

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

540

541

542

Users can configure PB01 via AT Command or LoRaWAN Downlink.

543

544

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

545

546

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

547

548

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

549

550

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

551

552

These commands are to configure:

553

554

* General system settings like: uplink interval.

555

556

* LoRaWAN protocol & radio-related commands.

557

558

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

559

560

561

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

562

563

These commands are only valid for PB01, as below:

564

565

566

== 3.1 Downlink Command Set ==

567

568

569

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

570

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

571

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

572

573

574

View current TDC time

575

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

576

1200000

577

OK

578

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

579

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

593

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

594

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

599

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

600

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

601

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

602

OK

603

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

05010701

05: fixed command

01:confirmed uplink

07: retry 7 times

01: fcnt count plus 1

613

)))

614

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

615

Check the current network connection method

616

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

617

1

618

OK

619

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

620

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

621

Attention:Take effect after ATZ

622

OK

623

)))|(% 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" %)(((

629

0

630

OK

631

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

632

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

633

0x2101:

634

21: fixed command

635

01: for details, check wiki

636

)))

637

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

638

1

639

OK

640

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

641

|(% 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" %)

647

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

648

set DR to 1

649

It takes effect only when ADR=0

650

)))|(% 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" %)

658

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

659

set TXP to 1

660

It takes effect only when ADR=0

661

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

673

)))

674

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

675

(((

676

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

677

678

Retrieve stored data for a specified period of time

)))

(((

)))

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

685

0X3161DE7C7061DE8A800A:

686

31: fixed command

687

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

688

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" %)(((

693

1,1440,2880

694

OK

695

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

696

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

697

1,1440,2880

698

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

699

Set DDETECT setting status and time

700

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

701

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

0X320005A0: close

0X320105A0: open

32: fixed command

05A0: 0X05A0=1440(min)

706

)))

707

708

== 3.2 Set Password ==

709

710

711

Feature: Set device password, max 9 digits.

712

713

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

714

715

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

716

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

717

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

722

723

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

724

725

No downlink command for this feature.

726

727

728

== 3.3 Set button sound and ACK sound ==

729

730

731

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

732

733

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

734

735

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

736

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

737

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

738

AT+SOUND=?

739

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

1,1

OK

)))

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

744

AT+SOUND=0,1

745

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

746

747

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

748

749

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

750

751

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

752

753

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

** **

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

758

759

760

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

761

762

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

763

764

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

765

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

766

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

767

AT+OPTION=?

768

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

769

Get the buzzer music type

770

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

776

777

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

778

779

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

780

781

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

782

783

784

== 3.5 Set button sound time ==

785

786

787

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

788

789

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

790

791

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

792

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

793

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

794

AT+STIME=?

795

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

796

Get the button sound time

797

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

0

OK

)))

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

802

AT+STIME=1000

803

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

804

805

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

806

807

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

808

809

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

810

811

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

= 4. Battery & How to replace =

816

817

== 4.1 Battery Type and replace ==

818

819

820

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.

821

822

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

823

824

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

825

826

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

827

828

829

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

830

831

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

832

833

834

== 4.2 Power Consumption Analyze ==

835

836

837

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.

838

839

Instruction to use as below:

840

841

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

842

843

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

844

845

846

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

853

854

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

= 5. Accessories =

* (((

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

862

**Program Converter (AS-02)**

863

)))

864

865

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

866

867

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

868

869

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

= 6. FAQ =

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

875

876

877

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.

878

879

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

**Connection:**

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

886

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

887

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

888

889

(((

890

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:

895

)))

896

897

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

898

899

900

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

925

926

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

927

928

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

933

934

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

1013

1014

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

1036

1037

1038

== 6.3 How to upgrade the firmware? ==

1039

1040

1041

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

1042

1043

* Support new features

1044

* For bug fix

1045

* Change LoRaWAN bands.

1046

1047

(((

1048

User can check this link for the detail of operation of firmware upgrade: [[Firmware Upgrade Instruction>>doc:Main.Firmware Upgrade Instruction.WebHome||anchor="H2.3LHT52"]]

)))

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

1053

1054

1055

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

1056

1057

1058

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

1059

1060

1061

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

1062

1063

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

1064

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

1069

1070

1071

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

1072

1073

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

1074

1075

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

1076

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

1077

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

1078

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

1079

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

1080

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

1081

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

1082

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

= 7. Packing Info =

**Package Includes**:

1088

1089

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

1095

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

1096

1097

= 9. Reference material =

1098

1099

1100

* [[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:

1106

1107

(1) This device may not cause harmful interference;

1108

1109

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

1110

Wiki source code of PB01 -- LoRaWAN Button User Manual

Applications

Navigation