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.