MOKO LW004-PB User manual

Datasheet
LW004-PB
MOKO TECHNOLOGY LTD.
Version 1.2 www.mokosmart.com
User Manual
LW004-PB User Manual

CONTENT
1 About this Manual.......................................................................................................3
2 Product Introduction.................................................................................................3
2.1 Overview ....................................................................................................................................................... 3
2.2 Application ................................................................................................................................................... 3
2.2.1 Working Principle.......................................................................................................................... 3
2.2.2 Track people’s movements ........................................................................................................ 3
2.2.3 Emergency button ......................................................................................................................... 4
2.2.4 Motion Detect.................................................................................................................................. 4
2.2.5 NFID Function................................................................................................................................. 4
2.3 Product Specifications.............................................................................................................................. 4
2.3.1 Appearance ...................................................................................................................................... 4
2.3.2 LED Indicators and Button......................................................................................................... 5
2.3.3 Product Datasheet ......................................................................................................................... 6
3 Set up Instruction........................................................................................................7
3.1 Turn on /off.................................................................................................................................................. 7
3.2 Join Into Lora Network ............................................................................................................................ 7
3.3 Gateway Setup............................................................................................................................................. 7
3.4 Parameters Configuration ...................................................................................................................... 8
4 Standby mode...............................................................................................................8
5 Alarm Mode ...................................................................................................................8
6 Advertising Packet......................................................................................................8
7 Uplink Payload .............................................................................................................9
8 Downlink Command...............................................................................................11
8.1 Get Device Information..........................................................................................................................11
8.1.1 Format..............................................................................................................................................11
8.1.2 Get Device Information Command Code List....................................................................12
8.2 Configure Device Information.............................................................................................................15
8.2.1 Format..............................................................................................................................................15
8.2.2 Configure Device Information Command Code List.......................................................15
9 MOKO LoRa APP.......................................................................................................17
9.1 Install MokoLora APP.............................................................................................................................17
9.2 Scan and Connect LW004-PB ..............................................................................................................18
9.3 Main Page....................................................................................................................................................19
9.4 Get and Configure LoRaWAN Data....................................................................................................20
9.5 Get and Configure Alarm Parameters ..............................................................................................21
9.6 Get and Configure GPS Parameters...................................................................................................22
9.7 Get and Configure Scan Parameters .................................................................................................22
9.8 Uplink Data Test .......................................................................................................................................23
9.9 Device Info ..................................................................................................................................................24
9.10 OTA .............................................................................................................................................................24
9.11 Log...............................................................................................................................................................25
10 Revision History ....................................................................................................25

LW004-PB
www.mokosmart.com
1 About this Manual
The purpose of this manual is to outline how to apply LW004-PB in suitable scenarios, as well as
how to configure and join into LoRa network.
2 Product Introduction
2.1 Overview
The LW00-PB is a long-range panic button device for Class A type devices based on the LoRaWAN
open protocol and is compatible with the LoRaWAN protocol. It is small, compact, and easy to use.
The LW004-PB has Bluetooth and GPS for positioning and can be used for both indoor and
outdoor tracker objects.
LW004-PB also has built in RFID and 3-axis accelerometer sensor. It can be used to employee
attendance, access control, identity identification and motion detection.
2.2 Application
2.2.1 Working Principle
2.2.2 Track people's movements
LW004-PB can be used with BLE Beacons and GPS system. In general, the beacons position is fixed.
No matter what mode the device is, the device will scan the beacons for at least 10 seconds(up to
600s) and turn on GPS for 3minutes at the end of each reporting interval .Then device will select

LW004-PB
4www.mokosmart.com
the closest MAC beacon(up to four closest MAC beacon) which is based on your filter conditions
before sending the data to the server. Finally, the beacon’s information and gps data will be
uploaded to server at the reporting timing.
Through the beacon information and GPS data, we can roughly know the position and moving
trajectory of the people who wear the device.
Note: GPS data is only available outdoors.
2.2.3 Emergency button
There is a red button on the front of the device. When people who wear the lw004-pb are in
emergency, they can press the red button for alert, the device will come into alarm mode. In alarm
mode, the yellow led of device will keep on blinking and the device motor will vibrate unless the
device exit alarm.
Meanwhile, the device will report the GPS data and surrounding beacon’s information. Through
the beacon information and GPS data, we can roughly know the position and moving trajectory of
the people who are in emergency and find and help the people faster.
Note: GPS data is only available outdoors.
2.2.4 Motion Detect
LW004-PB built in 3-axis. There is 3-Axis sensor data in every uplink payload. It includes the
acceleration value of X,Y,Z axis and the angle of relative to the X-axis and the Y-axis . Based on the
value, user can judge the motion status and relative direction of device.
2.2.5 RFID Function
LW004-PB built in RFID, it can be applied to access control, attendance applications, such as office
buildings, residential areas, etc.
2.3 Product Specifications
2.3.1 Appearance

LW004-PB
5www.mokosmart.com
2.3.2 LED Indicators and Button
Items
Indicator
Operation
Remark
Turn ON
Solid blue and keep
3S
Press and hold the
power button for 5
seconds till the LED
indicate blue and
release. The LED will
indicate blue for 3
seconds to show the
LW004-PB is turned on.
Turn OFF
Red LED Blink 3S
Press and hold the

LW004-PB
6www.mokosmart.com
2.3.3 Product Datasheet
Please refer to the LW004-PB Datasheet for more details.
power button for 5
seconds till the red
indicator flashes quickly
and release. The
indicator will flash red
for 3 seconds to show
the LW004-PB is turned
off.
Join LoRa
Network
Solid green and keep
3S
If the device had never
Joined any network,
after turning on, the
device automatically
sends join request
It will send join request
automatic after power on
the device or send
“connect”request in
APP
Login in
Green LED Blink 1S
Connect to the device
via APP successfully
Login out
Red LED Blink 1S
APP disconnect to the
device
When the device in alarm
status the indicator may
be not visible
Trigger
Alarm
Yellow LED Blink
Double click the alarm
button
Either enters the alarm
mode or send alarm
message to server, there
will also have vibration
reminder
Exit Alarm
Alarm indicator LED
turn off
Press alarm button and
hold on 15S or send
downlink command to
exit alarm
Firmware
Upgrade
Green LED Blink
during the upgrade
Firmware upgrade via
OTA in DFU mode
Solid Blue and keep
3S after upgrade
successfully
Solid Red and keep
3S after upgrade
failed
Charging
Blue LED blink
Plug in type-c charger
Full
Charged
Solid blue
Plug in type-c charger
Low
Battery
Reminder
Red LED blink
Battery level lower than
the set value

LW004-PB
7www.mokosmart.com
3 Set up Instruction
3.1 Turn on /off
3.2 Join Into Lora Network
To join LW004-PB into LoRa network to communicate with LoRa gateway. The network
operation is as following:
1) If LW004-PB had never joined any network:
First, turn on the device.
Second, use Mokolora APP to connect the device then get required ID and Keys.
Default join ID and Keys as following:
DevEUI: BLE MAC+ FFFF,example:MAC:112233445566 DevEUI:112233FFFF445566
AppEUI: 526973696e674846
AppKey: 2b7e151628aed2a6abf7158809cf4f3c
DevAddr: The last four bytes of BLE MAC address
AppSKey: 2b7e151628aed2a6abf7158809cf4f3c
NwkSkey: 2b7e151628aed2a6abf7158809cf4f3c
Third, register the device on Lora server
Forth, click connect on Mokolora APP to send a join request to Lora server, it will search
an available LoRa network to join. The green indicator will stay on for 5 seconds to show it
joins into the network, otherwise, the indicator will be off.
(2) If LW004-PB had been joined into a LoRa network, turn off and turn on the device, the
green indicator will stay on for 5 seconds to show it joins into the network.
Note: About MokoLora APP details, please check the instructions in Chapter 9 Moke Lora APP
3.3 Gateway Setup
Before the gateway communicate with the LW004-PB Panic Button, please refer to your
Items
Operation
Turn ON
Press and hold the power button for 5 seconds till the LED indicate
blue and release. The LED will indicate blue for 3 seconds to show the
LW004-PB is turned on.
Turn OFF
Press and hold the power button for 5 seconds till the red indicator
flashes quickly and release. The indicator will flash red quickly for 3
seconds to show the LW004-PB is turned off.

LW004-PB
8www.mokosmart.com
gateway’s user manual. If you use Moko LoRaWAN gateway MKGW2-LW, please refer to the
MOKO LoRaWAN Gateway MKGW2-LW Configuration Guide.
3.4 Parameters Configuration
Before you start configuring, prepare MokoLora APP.
1. To configure parameters through MokoLora APP, follow the instructions in Chapter 9 Moke Lora
APP
2. To configure parameters through downlink command, follow the instructions in Chapter 8
Downlink Command
4 Standby mode
After joining the network, the device will upload the device location information to the server
within three minutes. The device will then be placed in standby mode or non-alarm mode, and the
device location information can be uploaded according to the configured reporting interval.
In each cycle, the device will check the network connection via LinkcheckReq Command. If the
LoRa network detects that it is disconnected, the device will first join the LoRa network and then
send the device location information.
The longest battery life is more than one month in standby mode when the reporting interval is
720min and GPS search satellite time is 1min.
LinkCheckReq: Used by an end-device to validate its connectivity to a network.It is from LoRaWAN
standard protocol stack.
5Alarm Mode
After the device is turned on and the alarm is triggered, the device motor will vibrate and Yellow
indicator LED Blink. The alarm mode will remain until the "stop alarm" command is received, or
the user presses and hold the alarm button for 15 seconds to exit the alarm mode.
In the alarm mode, the device uploads location information to the server every 10 seconds by
default., and the user can configure the alarm mode reporting interval through the APP and
downlink commands.
The shortest battery life is about 14hours in alarm mode when reporting interval is 10s, GPS and
vibration are turn on.
6 Advertising Packet

LW004-PB
9www.mokosmart.com
⚫MAC address-0XE0 80 EC C0 85 C5
⚫Battery level-0X63 (99%)
⚫Device type-0x03
⚫Device advertising name-0x4C 57 30 30 34 2D 50 42 2D 38 35 43 35(LW004-PB-85C5)
⚫server UUID-FFC3
7 Uplink Payload
The uplink data packet includes battery levels, alarm status, GPS data, and the nearest MAC
beacon, 3- axis data. 3-axis data can be used to judge the status of the device.
Byte
Index
Type
Data
Type
Value
Description
1
Battery Level
Unit
0X00-0X64
2
Alarm Status
Unit
0X00,0X01
00 ： alarm off, 01:alarm on
3-6
GPS
Latitude
Int
0X000000-
0XFFFFFF
The data format is little-endian.
After the hex data converts to
decimals, the calculation formula
is (decimal value)x90/8388607
degree. Positive Value indicates
northern latitude, Negative
Value shows southern latitude
7-10
GPS
Longitude
Int
0X000000-
0XFFFFFF
The data format is little-endian,
after the hex data converts to
decimals, the calculation formula
is (decimal value)x180/8388607
degree. Positive Value indicates
eastern longitude, Negative
Value shows western longitude

LW004-PB
10 www.mokosmart.com
11-16
1
st
MAC Beacon
Address
Unit
0X0000000000
00-
0XFFFFFFFFFFF
F
If need
17
1
st
MAC Beacon
RSSI
Unit
0X00-0XFF
If need, convert the hex data to
decimals, and then Minus 256
18-23
2
nd
MAC Beacon
Address
Unit
0X0000000000
00-
0XFFFFFFFFFFF
F
If need
24
2
nd
MAC Beacon
RSSI
Unit
0X00-0XFF
If need, convert the hex data to
decimals, and then Minus 256
25-30
3rd MAC Beacon
Address
Unit
0X0000000000
00-
0XFFFFFFFFFFF
F
If need
31
3rd MAC Beacon
RSSI
Unit
0X00-0XFF
If need, convert the hex data to
decimals, and then Minus 256
32-37
4th MAC Beacon
Address
Unit
0X0000000000
00-
0XFFFFFFFFFFF
F
If need
38
4th MAC Beacon
RSSI
Unit
0X00-0XFF
If need, convert the hex data to
decimals, and then Minus 256
39-40
X-axis
acceleration
Int
0X0000-0XFFFF
The data format is big- endian.
After the hex data converts to
decimals, the calculation formula
is (decimal value)x2/32768,unit:g
41-42
Y-axis
acceleration
Int
0X0000-0XFFFF
The data format is big- endian.
After the hex data converts to
decimals, the calculation formula
is (decimal value)x2/32768,unit:g
43-44
Z-axis
acceleration
Int
0X0000-0XFFFF
The data format is big- endian.
After the hex data converts to
decimals, the calculation formula
is (decimal value)x2/32768,unit:g
45-46
Angular
Unit
0X0000-0XFFFF
The angular is relative to the X-
axis and the Y-axis. The data
format is a big-endian unit:
degree