Ursalink EM500-SWL User manual

EM500-SWL Payload Structure
V1.0
Contents
1. Uplink Payload Structure.........................................................................................................2
Uplink Packet Example........................................................................................................ 2
2. Downlink Payload Structure....................................................................................................3
Downlink Packet Example................................................................................................... 3
3. Data Types............................................................................................................................... 4
3.1 IPSO Standard Definition...............................................................................................4
3.2 Ursalink Custom Format................................................................................................4
3.3 LoRaWAN Parameter.....................................................................................................5

1. Uplink Payload Structure
An uplink message can be sent from EM500-SWL to gateway. Also, the EM500-SWL sends
different sensor data in different frames. In order to do that, all data must be prefixed with two
bytes:
Data Channel: Uniquely identifies each sensor in the EM500-SWL across frames, e.g. "Water
Lever Sensor".
Data Type: Identifies the data type in the frame, e.g. "Battery Level".
The device can send multiple data at one time by using following payload structure:
1 Byte
1 Byte
N Bytes
1 Byte
1 Byte
M Bytes
1 Byte
...
Channel1
Type1
Data1
Channel2
Type2
Data2
Channel 3
...
Uplink Packet Example
Frame N: Regular uplink (Water Level)
Frame N+1: Battery level changes uplink.
Frame N+2:
Content will be reported each time when device reboots: Ursalink Custom Format Version + SN +
Hardware Version + Software Version + Class Type
Channel ID
Description
1
Battery
2
Reserved
3
Water Level Sensor
03 77 02 00
Channel
Type
Value
03
(Water Level Sensor)
77
(Water Level)
02 00 => 00 02 = 02 (2 cm)
01 75 64
Channel
Type
Value
01
(Battery)
75
(Battery Level)
64 =100 means 100%

2. Downlink Payload Structure
A downlink message can be sent from gateway to sensor in order to perform some actions on
that device.
Note: the application port of EM500-SWL is 85.
Downlink Packet Example
Frame N: Set the data reporting interval as 20mins (1200s).
ff 0b ff ff 01 01
Channel
Type
Value
Channel
Type
Value
ff=255
0b = 11
(Device Restart
Notification)
ff
(reserved)
ff=255
01 = 1
(Custom Format
Version)
01 = 1
(Version 1)
ff 16 61 26 a1 08 75 05 00 35
Channel
Type
Value
ff=255
16 = 22 (Device SN)
61 26 a1 08 75 05 00 35
ff 09 01 00 ff 0a 01 01
Channel
Type
value
Channel
Type
Value
ff = 255
09
(Hardware version)
0100
(V1.0)
ff = 255
0a
(Software Version)
0101
(V1.1)
ff 0f 00
Channel
Type
value
ff = 255
0f (Class Type)
00 (Class A)
1 Byte
2 Bytes
1 Byte
1 Byte
2 Bytes
1 Byte
Channel1
Data1
0xff (Reserved)
Channel2
Data2
0xff (Reserved)
ff 03 b0 04
Channel
Type
Value
ff = 255
03 (Set Reporting Interval)
b0 04 => 04 b0 = 1200 (second)

3. Data Types
3.1 IPSO Standard Definition
Data Types conform to the IPSO Alliance Smart Objects Guidelines, which identifies each data
type with an "Object ID". However, as shown below, a conversion is made to fit the Object ID into
a single byte.
DATA_TYPE = IPSO_OBJECT_ID - 3200
Example:
Frame N
Frame N+1
3.2 Ursalink Custom Format
Type
IPSO
Hex
Data Size
Data Resolution per Bit
Water Level Sensor
3319
77
2
1
Battery
3317
75
1%
1%
01 75 5a
Channel
Type
Value
01
75 means battery level
5a = 90 means 90%
03 77 6b 00
Channel
Type
Value
03
77 means water level
6b 00 => 00 6b = 107 means 107 cm
Type
Type ID
Data Size
Data Resolution (per bit)
Ursalink Custom Format
Version
1
1
0x01
Data Collection Interval
2
2
1s
Data Reporting Interval
3
2
1s
LoRa Channel Mask
5
3
ID (1B) + Value (2B)
ID: 1~6
Debug Level
7
1
Bit0: info Bit1: debug
Bit2: warn Bit3: err
Hardware Version
9
2
0110 => 0x01 0x10

3.3 LoRaWAN Parameter
DevEUI
24E124 + 2nd to 11th digits of SN
e.g. SN = 61 26 a1 01 84 96 00 41
Then Device EUI = 24E124126a101849
AppEUI
24e124+c0002a0001
Appport
0x55
NetID
0x010203
DevAddr
The 5th to 12th digits of SN
e.g. SN = 61 26 a1 01 84 96 00 41
Then DevAddr = a1018496
AppKey
5572404c696e6b4c6f52613230313823
NwkSKey
5572404c696e6b4c6f52613230313823
AppSKey
5572404c696e6b4c6f52613230313823
---End---
Software Version
10
2
0110 => 0x01 0x10
Device Restart Notification
11
1
0xff reserved
Device Power Off
Notification
12
1
0xff reserved
Class Type
15
1
00: Class A
Device SN (8 Bytes)
22
8
6410908243750001 =>
0x6410908243750001

EM500-SWL User Guide
2
Safety Precautions
Ursalink will not shoulder responsibility for any loss or damage resulting from not following
the instructions of this operating guide.
The device and transmitter must not be disassembled or remodeled in any way.
Please clarify your application environment before deployment so that the device can
function well.
The device is not intended to be used as a reference sensor, and Ursalink will not should
responsibility for any damage which may result from inaccurate readings.
Do not place the device close to hot objects or in direct sunlight.
Do not place the device where the temperature is below/above the operating range,
places that are out of measuring range and with high magnetic field.
Make sure electronic components do not drop out of the enclosure while opening.
When closing the lid, make sure the lid is fitted the right way, so that the enclosure is
properly sealed.
When installing the battery, please install it accurately, reversely or with wrong model.
The device must never be subjected to shocks or impacts.
Declaration of Conformity
Ursalink EM500-SWL is in conformity with the essential requirements and other relevant
provisions of the CE, FCC, and RoHS.
© 2017-2020 Xiamen Ursalink Technology Co., Ltd.
All rights reserved.
All information in this guide is protected by copyright law. Whereby, no organization or individual
shall copy or reproduce the whole or part of this user guide by any means without written
authorization from Xiamen Ursalink Technology Co., Ltd.
For assistance, please contact
Ursalink technical support:
Email: [e-mail]
Tel: [phone]
Fax: [phone]
Revision History
Date
Doc Version
Description
April 7, 2020
V 1.0
Initial version

EM500-SWL User Guide
3
Contents
1. Overview..........................................................................................................................................4
1.1 Description............................................................................................................................ 4
1.2 Features.................................................................................................................................4
1.3 Specifications.........................................................................................................................4
1.4 Dimensions(mm)................................................................................................................... 5
2. Hardware Introduction....................................................................................................................5
2.1 Packing List............................................................................................................................ 5
2.2 Product Overview..................................................................................................................6
3. Sensor Connection with EM500......................................................................................................6
4. Sensor Installation........................................................................................................................... 7
4.1 Liquid Level Sensor Installation.............................................................................................7
4.2 EM500 Installation................................................................................................................ 8
4.2.1 Wall Mounting............................................................................................................8
4.2.2 Pole Mounting............................................................................................................8
4.2.3 DIN Rail Mounting......................................................................................................9
5.Turn ON/OFF the Sensor...................................................................................................................9
5.1 Turn ON/OFF via Smartphone APP....................................................................................... 9
5.2 Turn ON/OFF via PC Software............................................................................................. 11
5.3 Turn ON/OFF via Button......................................................................................................12
6.Sensor configuration...................................................................................................................... 12
6.1 Configuration via Smartphone APP.....................................................................................12
6.1.1 Read Configuration.................................................................................................. 13
6.1.2 Write Configuration..................................................................................................13
6.1.3 Template Settings.....................................................................................................14
6.2 Configuration via PC............................................................................................................16
6.2.1 Read Configuration.................................................................................................. 16
6.2.2 Write Configuration..................................................................................................16
6.2.3 Upgrade....................................................................................................................17
6.2.4 Template and Reset..................................................................................................18
7.Sensor Parameters (for App and PC)..............................................................................................19
7.1 LoRa WAN Settings..............................................................................................................19
7.1.1 Basic Settings-OTAA..................................................................................................19
7.1.2 Basic Settings-ABP....................................................................................................20
7.1.3 Channel Settings.......................................................................................................22
7.2 Device Settings.................................................................................................................... 23
7.2.1 General..................................................................................................................... 23
7.2.2 Data Calibration........................................................................................................24
7.2.3 Threshold..................................................................................................................24
8.Sensor Management via Ursalink Cloud........................................................................................25
8.1 Ursalink Cloud Registration.................................................................................................25
8.2 Add a Ursalink LoRaWAN Gateway..................................................................................... 25
8.3 Add EM500-SWL to Cloud...................................................................................................26

EM500-SWL User Guide
4
1. Overview
1.1 Description
EM500-SWL is an outdoor environment monitoring sensor mainly used to measure liquid level
data through wireless LoRa network. EM500-SWL device is battery powered and designed for
multiple mounting ways. It is equipped with NFC (Near Field Communication) and can easily be
configured by a smartphone or a PC software.
Sensor data are transmitted in real-time using standard LoRaWAN protocol. LoRaWAN enables
encrypted radio transmissions over long distance while consuming very little power.
The user can obtain sensor data and view the trend of data change through Ursalink Cloud or thr
ough the user's own Network Server.
1.2 Features
Large measurement range for liquid level measurement
Up to 11km communication range
Easy configuration via NFC
Standard LoRaWAN support
Ursalink Cloud compliant
Low power consumption with 19000mAh replaceable battery
1.3 Specifications
LoRaWAN
Frequency
EU433/CN470/IN865/RU864/EU868/US915/AU915/KR920/AS923
Tx Power
20dBm
Sensitivity
-147dBm @300bps
Mode
OTAA/ABP Class A
Antenna
Embedded Ceramic Antenna
Measurement
Pressure Type
Absolute pressure
Range
EM500-SWL-W003: 3m H2O
EM500-SWL-W005: 5m H2O
EM500-SWL-W010: 10m H2O
(Customizable up to 200m and for other liquid)
Accuracy
± 0.5% FS
Physical Characteristics
Probe Length
At least should be 1-1.5m longer than measuring range

EM500-SWL User Guide
5
Power Supply
19000 mAh Li-SoCl2battery
Battery Life
4.5 year (10 min interval, SF12)
>10 year (10 min interval, SF7)
Operating Temperature
-20°C to +70°C
Relative Humidity
0% to 100% (non-condensing)
Dimension
105 × 71 × 69.5 mm
(Waterproof connector and sensor are not included)
Mounting
Pole, wall, DIN rail
1.4 Dimensions(mm)
2. Hardware Introduction
2.1 Packing List
1 × EM500-SWL
(Include cable and transmitter)
2 × Mounting
Screws
1 × Hose
Clamp
1 × Warranty
Card
1 × Quick Guide
1 × DIN Rail (Optional)
If any of the above items is missing or damaged, please contact your Ursalink sales
representative.

EM500-SWL User Guide
6
2.2 Product Overview
3. Sensor Connection with EM500
Follow below to connect transmitter cable to EM500 device if they are separated.
Front View:
①LoRa Antenna (Internal)
②NFC Area
③Water-proof Connector
Back View:
④Battery (Internal)
⑤Wall Mounting Holes
⑥Pole Mounting Holes
2. Pass the cable through the cap, rubber seal
and enclosure cover.
1. Take off the mounting bracket, remove the cap,
rubber seal and the screws on the bottom of the
device, and then take off the enclosure cover.

EM500-SWL User Guide
7
Pinouts:
4. Sensor Installation
4.1 Liquid Level Sensor Installation
Lower the transmitter via cable into the media until it is close to the bottom of tanks or ponds. Be
careful not to hit the bottom hard or touch hard objects like sand or sludge since it will damage
the transmitter. It’s recommended to fix the transmitter cable with a fixed bracket.
Note: Ensure the gas holes of transmitter do not be blocked while mounting or using it.
PIN
Color
Description
1
Red
GND
2
--
--
3
---
--
4
White
B
5
Yellow
A
6
Black
VOUT=12V
4. Put the motherboard back and restore
everything in its due position.
3. Pull out the motherboard, insert and lock
the wires accordingly (see the label on the
motherboard or following picture).

EM500-SWL User Guide
8
If the transmitter is to be used in a well or other locations with turbulence or other disturbances,
it is advisable to install a pipe to protect the transmitter. Several holes should be drilled at
different heights of the pipe in order to let water flow into and remove dydrodynamic pressure.
Note: The pipe can’t be placed bend.
4.2 EM500 Installation
Ensure the location of EM500 is within the communication range of LoRaWAN gateway.
4.2.1 Wall Mounting
1. Attach the mounting bracket to the wall and drill. (Around 16mm)
Note: The connecting line of two holes must be a horizontal line.
2. Mount the device on the wall.
4.2.2 Pole Mounting
1. Loosen the hose clamp by turning the locking mechanism counter-clockwise.
2. Straighten out the hose clamp and slide it through the rectangular holes in the mounting

EM500-SWL User Guide
9
bracket, wrap the hose clamp around the pole.
3. Use a screwdriver to tighten the locking mechanism by turning it clockwise.
4.2.3 DIN Rail Mounting
Use 2 pieces of M3 × 6 flat head Phillips screws to fix the DIN rail to the device, and then hang
the DIN rail on the mounting bracket. It is necessary to choose a standard bracket.
5.Turn ON/OFF the Sensor
EM500-SWL series can be turned ON/OFF via smartphone or computer with NFC (Near Field
Communication) or button. Select one of following methods to turn on/off the device.
5.1 Turn ON/OFF via Smartphone APP
1. Download Ursalink configuration APP “Toolbox” and install it on your smartphone. The
smartphone must support NFC.
2. Enable NFC on the smartphone and open the APP.
3. Attach the smartphone with NFC area to the device.
Note: Ensure the location of your smartphone NFC area and it is recommended to take off phone
case before using NFC.

EM500-SWL User Guide
10
4. Device information will be shown on the APP.
5. Switch the button of Device Status to turn on or off the device.
6. Enter the correct password (Default password: 123456) and wait a few seconds until APP
shows “Operate Successful!”.
Note: Keep the two devices close together and do not move them in order that you can get the
best connectivity as possible when turning on or off via NFC. No response can be caused by long
distance, wrong location or rapid movement.

EM500-SWL User Guide
11
5.2 Turn ON/OFF via PC Software
1. Download Ursalink configuration software “Toolbox” and open the software.
2. Connect NFC reader to computer and attach the device to NFC reader.
3. Select type as NFC and serial port of NFC reader, then click “save”.
4. Device information will be shown on the software.
5. Click “Power On” to turn on the device or “Power Off” to turn off the device.
6. Enter password (default password:123456) and press Enter key to change device status.

EM500-SWL User Guide
12
5.3 Turn ON/OFF via Button
1. Remove screws on the bottom of EM500-SWL and take off the upper enclosure.
2. Find the button beside the battery.
3.Press the button until LED blinks to turn on or off the device. (about 3 seconds)
Press the button until LED blinks rapidly to reset the device to factory default. (Over 10 seconds)
6.Sensor configuration
Ursalink EM500-SWL series sensors can be monitored and configured via NFC technology. In
order to protect the security of sensor, password validation is required when turning on/off the
sensor or changing configuration. Select one of the following ways to configure EM500-SWL
sensors.
6.1 Configuration via Smartphone APP
Make sure Ursalink Toolbox APP is downloaded and installed on your smartphone.

EM500-SWL User Guide
13
6.1.1 Read Configuration
1. Open APP “Toolbox” and click “Read” to read current information of device.
2.Attach the smartphone with NFC area to the device until the APP shows “Read Successful!”.
Note: Failing to read can be caused by long distance, wrong location, or rapid movement.
6.1.2 Write Configuration
1. Open APP “Toolbox” and go to “Settings” page.
2. Change parameters as required and click “Write”.

EM500-SWL User Guide
14
3. Enter password (default password: 123456).
4. Attach the smartphone with NFC area to the device and wait a few seconds until APP shows
“Write Successful!”. The device will automatically re-join the network if LoRaWAN paramters are
changed.
Note: Failing to write can be caused by long distance, wrong location, or rapid movement.
6.1.3 Template Settings
Template settings are used for easy and quick device configuration in bulk.
Note: Template function is allowed only for sensors with the same model and LoRa frequency
band.
1. Go to “Template” page of APP and save current settings as a template.

EM500-SWL User Guide
15
2. Attach the smartphone with NFC area to another device.
3. Select the template file from Toolbox APP and click “Write”.
4. Enter password of this device and keep the two devices close until the APP shows “Write
successful!”.
5. Slide the template item left to edit or delete the template.