Ursalink UC1152 User manual

UC1152 User Guide
2
Contents
1. Preface.............................................................................................................................................3
2. Introduction.................................................................................................................................... 3
2.1 Features................................................................................................................................. 3
2.2 Parameters............................................................................................................................ 4
2.3 LED Indicator Description......................................................................................................4
3. Installation...................................................................................................................................... 5
3.1 Environment.......................................................................................................................... 5
3.2 Power Supply.........................................................................................................................5
3.3 Micro USB Port...................................................................................................................... 6
3.4 Terminal Description............................................................................................................. 6
3.5 Digital Input........................................................................................................................... 7
3.6 Relay Output..........................................................................................................................7
4. Configuration.................................................................................................................................. 8
4.1 Configuration via PC.............................................................................................................. 8
4.1.1 Serial Port Settings..................................................................................................... 9
4.2 Status...................................................................................................................................10
4.3 General................................................................................................................................ 11
4.3.1 Basic..........................................................................................................................11
4.3.2 RS485........................................................................................................................12
4.2.3 RS232........................................................................................................................13
4.4 LoRaWAN.............................................................................................................................14
4.4.1 Basic..........................................................................................................................14
4.4.2 Channel.....................................................................................................................16
4.4.3 Advanced..................................................................................................................17
4.5 Channel................................................................................................................................19
4.6 Command............................................................................................................................ 20
4.6.1 Read Command from Device................................................................................... 21
4.6.2 Open a Command File..............................................................................................21
4.6.3 Save the Command to Device..................................................................................21
4.6.4 Save the Command as File....................................................................................... 21
4.7 IF-THEN Behaviour Command.............................................................................................21
4.7.1 Supported IF Condition............................................................................................ 21
4.7.2 Supported THEN Actions..........................................................................................24
4.8 Upgrade............................................................................................................................... 26
5. Application Examples................................................................................................................... 26
5.1 Periodic Status Report.........................................................................................................26
5.2 Control Appliances.............................................................................................................. 27
5.2.1 Send an Alert When Channel Value Exceeds a Certain Threshold.......................... 27

UC1152 User Guide
3
1. Preface
Thank you for choosing Ursalink UC1152 LoRa Remote I/O. This user guide will present in detail
all the functions and features of the product. Ursalink UC1152 is designed for both industrial and
commercial applications. The product should be used under the guidance of this user guide,
referring to parameters and technical specifications. The UC1152 is a compact, high-performance
device that offers LoRaWAN connectivity for remote access and easy management of machines
and equipment over the cellular network.
We bear no liability for property loss or physically injury arising from abnormal or incorrect usage
of this product.
2. Introduction
Ursalink UC1152 is designed as a cost-effective industrial machine monitoring device that
monitors and controls up to 1 RS485, 1 RS232, 1 DC signal and 1 drivable relay output.
With the aid of Ursalink UC1152, the alarm condition brings attention to engineering personnel
immediately. The output can be connected with an alarm indication device, such as a light or
horn.
The module can give immediate response to the status of both the input and output conditions.
A LoRa module is embedded in the Ursalink UC1152 .
This user guide is intended to provide detailed technical specifications and explanations to the
basic user as well as the technically-minded groups. It is a live document, and will be updated
from time to time. Please ensure that you have the latest version, by checking our website at:
https://www.ursalink.com/en/documents-download/
2.1 Features
1 relay drivable output
1 digital input connected with 1 DC signal
Offer serial interface with 1 RS232 and 1 RS485
Collects data from Modbus slave device
Integrate legacy serial and I/O devices into cloud
Customizable conditions & programmable actions
Send uplink alert messages according to user-defined conditions
Automatic switching of field devices at set times
Comply with the LoRaWAN Class C protocol
Support star network and mesh network
High Rx sensitivity and adjustable Tx power

UC1152 User Guide
4
2.2 Parameters
2.3 LED Indicator Description
System:
Solid On: System booting
On for 500ms, off for 500ms: Working properly
On for 100ms, off for 100ms: Failed to send data
ACT:
Off: Failed to join network
On for 75ms, off for 3000ms: Joined the network successfully
On for 500ms, off for 500ms: Sending/Receiveing data
Parameter Item
Reference Scope
Antenna
50 Ω SMA Antenna Interface
Frequency Band
EU 433, CN 470-510, EU 863-870, US 902-928, AU
915-928, KR 920-923
Sensitivity
-147 dBm @300bps
Output Power
20dBm
Protocol
LoRaWAN Class C
RS485
Baud rate: 2400-115200bps
Data bits: 7/8
Parity bits: N/E/O
Stop bits: 1/2
RS232
Baud rate: 4800-115200bps
Data bits: 7/8
Parity bits: N/E/O
Stop bits: 1/2
Digital Input
Opto-isolated depending on voltage
Can accept any DC signals of any type,including:
➢Dry Contacts ➢DC Voltage (3 - 20V)
High Voltage: +3V ~ +24V
Low Voltage: +1V max
Digital Output
1 x SPDT Relay Contact Rating:
Maximum Load Current: 250VAC/30VDC@3A
Connector type
Screw Terminals
DC Power Supply
5-24 VDC
Operating
Temperature
-40°C to +70°C (-40°F to +158°F)
Relative Humidity
0% to 95% (non- condensing)
Dimensions
79 x 60 x 24 mm

UC1152 User Guide
5
3. Installation
3.1 Environment
Due to the product properties of Ursalink UC1152,we STRONGLY advise that it should not be
installed in proximity to a variable speed drive or with any other electrically noisy equipment. DO
NOT install the Ursalink UC1152 into a metal enclosure unless an antenna is mounted on the
outside of the enclosure.
3.2 Power Supply
The Ursalink UC1152 features a 2 pin 3.5mm terminal block where a power supply can be
connected. The power supply should have the following specifications:
Output Voltage: 12V nominal
Output Current: 0.5A
Installation:
A suitable power supply comes with the retail product.
For industrial applications, it is advised that the Ursalink UC1152 should be installed into its own
metal housing and be powered from a separate power supply (as opposed to sharing one with
other equipment).
Please Note: While the Ursalink UC1152 has fairly rugged internal power supply circuitry, no
special provision for lightning protection is well in place. If the Ursalink UC1152 is used in an area
where thunderstorm is about to occur, it is advisable to use a commercially available lightning
suppressor (the same applies to inputs or outputs that are connected to wires longer than 2 or 3
meters). The guarantee does not cover damage resulting from lightning strikes! The Ursalink
UC1152 can operate reliably from voltages in the range of 5 to 24 VDC.

UC1152 User Guide
6
3.3 Micro USB Port
The Ursalink UC1152 provides a micro USB port to connect to a PC via USB cable, which allows
the PC to configure the unit.
3.4 Terminal Description
1[DC 5-24V]
2[RS232]
3[RS485]
4[Digital Input]
Opto-isolated depending on voltage DC Voltage (3-24V)
5[Digital Output]
Driving relay to connect NC or NO
Terminal
Description
VIN
Positive terminal of the DC power supply (+)
GND
Negative terminal of the DC power supply (-)
Terminal
Description
RXD
Receive Data
TXD
Transmit Data
GND
Ground
Terminal
Description
A
Data +
B
Data -

UC1152 User Guide
7
3.5 Digital Input
When the input is triggered either as high or low, the Ursalink UC1152 will take action if you
have pre-configured related command.
Terminal "IN" is internally pulled high. Leaving the connection open or connecting it to "0 -1
V"will indicate an "Input-De-activate" state.
When terminal "IN" is connected to "3-24 V", it will indicate an "Input-Activate" state.
Trigger voltage: Minimum = 3 VDC, Maximum = 24 VDC.
3.6 Relay Output
The output is used for switch circuits ON & OFF and can be controlled by command message
The output terminals are internally connected to a 3 Amp SPDT relay
OUT_NC = Normally Closed
OUT_COM = Common
OUT_NO = Normally Open
Maximum Current
3 Amp
Maximum Voltage
250VAC, 30VDC

UC1152 User Guide
8
4. Configuration
4.1 Configuration via PC
Follow these steps:
Step 1:
Connect the Ursalink UC1152 to PC via micro USB port.
Step 2:
Power on the Ursalink UC1152.
Step 3:
Run the Ursalink ToolBox.
The software will display this interface when getting started. Here you can create a new setup,
import an existing setup from your PC, or retrieve the current setup from the Ursalink UC1152.

UC1152 User Guide
9
4.1.1 Serial Port Settings
When the Ursalink ToolBox displays: Connecting to device, please wait...
You can click Serial Port Settings to set the correct serial port parameters.

UC1152 User Guide
10
If both the serial port parameters and the login password are correct, it will display: Serial port is
connected.
4.2 Status
Click "Status" to see the basic status information of this device:
Serial Port Settings
Item
Description
Default
Serial Port
Select the serial port for data
transmission.
Null
Login Password
Enter the login password.
123456
Baud Rate
Select from "9600", "57600", "115200".
115200
Data Bits
Select from "5", "7", "8".
8
Parity Bits
Select from "Even", "Odd", "None".
None
Stop Bits
Select from "1", "2".
1

UC1152 User Guide
11
Status
Item
Description
Local Time
Show the time of the device.
Join Status
Show if the device joined the network successfully.
The "Activate" means the device has joined the network.
RSSI/SNR
Show the RSSI/SNR of received packet.
Channel
Show the the channel currently used by the device to send
packets.
Rx2DR
Show the RX2 datarate which used for the RX2 receive-window.
Channel
Show the name of the channel that users have created.
Input
Show the status of Digital Input.
Output
Show the status of Digital Output.
Uplink Frame-counter
The number of data frames sent uplink from UC1152 to the
network server.
Downlink
Frame-counter
The number of data frames sent downlink from the network
server to UC1152.
4.3 General
Click "General" to set the general settings of the device
4.3.1 Basic

UC1152 User Guide
12
4.3.2 RS485
Basic Setting
Item
Description
Default
Reporting Interval
Set the regular report interval.
The device will send the I/O status/value and signal
strength to the user-built server regularly.
The interval range is 1-3600 seconds.
1800
Data Polling Interval
The interval of reading data from analog input.
1
Change Password
Click to change password.
Null
Old Password
Enter the old password.
Null
New Password
Enter the new password.
Null
Confirm Password
Enter the new password again.
Null
485 Settings
Item
Description
Default
Enable
Enable/disable RS485.
Enable
Baud Rate
Select from "2400", "4800", "9600",
"19200", "38400", "57600", "115200".
9600
Data Bits
Select from "5", "7", "8".
8
Stop Bits
Select from "1", "2".
1
Parity Bits
Select from "Even", "Odd", "None".
None
Modbus RS485
Enable this mode to collect data from
Disable

UC1152 User Guide
13
4.2.3 RS232
bridge LoRaWAN
slave devices and then send it to
Network Server via LoRaWAN.
This mode also has the capability to
change the behaviour of the ModBus
device by writing into its registers.
Port
Eenter the LoRaWAN frame port for
transparent transmission between
UC11-N1 and Network Server.
Range: 2-84,86-223.
Null
232 Settings_TCP
Item
Description
Default
Enable
Enable/disable RS232.
Disabled
Baud Rate
Select from "4800", "9600", "19200", "38400", "57600",
"115200".
115200
Data Bits
Select from "7", "8".
7
Stop Bits
Select from "1", "2".
1
Parity Bits
Select from "Even", "Odd", "None".
None
Packet
Length(Bytes)
Set the length of the serial data frame. Packet will be sent out
when preset frame length is reached. The range is 1-1024, the
unit is byte.
256
Serial Frame
Interval(ms)
The interval that the device sends out real serial data stored in
the buffer area to public network. The range is 10-65535
milliseconds.
100

UC1152 User Guide
14
4.4 LoRaWAN
4.4.1 Basic
Basic Settings
Item
Description
Default
Device EUI
Enter the identifier of the gateway.
Model + SN
App EUI
An AppEUI that will be attached to received packets
and a Join EUI.
5572404c696
e6b4c6f5261
3230313823
Application Port
The port used by the device to send and receive data.
55
Join Type
Select from: "OTAA" and "ABP".
OTAA: Over-the-Air Activation.
For over-the-air activation, end-devices must follow a
join procedure prior to participating in data
exchanges with the network server.
An end-device has to go through a new join
OTAA
Note: data will be sent out to public network when real serial
data size reaches the preset packet size, even though it's
within the serial frame interval.

UC1152 User Guide
15
procedure every time it has lost the session context
information.
ABP: Activation by Personalization.
Under certain circumstances, end-devices can be
activated by personalization. Activation by
personalization directly ties an end-device to a specific
network by-passing the join request - join accept
procedure.
Datarate
The datarate is used to transmit packet.
2-SF10
Regular Report
Interval
The interval of sending data to the gateway.
720min
OTAA Settings
Item
Description
Default
Application Key
Enter the application key. Whenever an
end-device joins a network via over-the-air
activation, the application key is used for derive
the Application Session key.
5572404c696e6b4c
6f52613230313823
ABP Settings
Item
Description
Default
Network ID
Network identifier (NwkID) is used to separate
addresses of territorially overlapping networks of
different network operators and to remedy roaming
issues.
0x010203

UC1152 User Guide
16
Device Address
Enter the device address. The device address
identifies the end-device within the current network.
The last 8 digits
number of SN
Network
Session Key
Enter the network session key of the device. The
network session key specific for the end-device. It is
used by the end-device to calculate the MIC or part of
the MIC (message integrity code) of all uplink data
messages to ensure data integrity.
5572404c696e
6b4c6f5261323
0313823
Application
Session Key
Enter the application session key of the device. The
AppSKey is an application session key specific for the
end-device. It is used by both the application server
and the end-device to encrypt and decrypt the
payload field of application-specific data messages.
5572404c696e
6b4c6f5261323
0313823
4.4.2 Channel
On this page, you can view all the supported LoRa frequencies and setup the channel frequency
used for receiving and sending data.
Note: Make sure that you have configured the corresponding channel on the gateway.
E.g. If you have configured a 923.2 MHz channel on UC1152, then you have to configure a 923.2
MHz channel on gateway as well.

UC1152 User Guide
17
4.4.3 Advanced
Advanced Settings
Item
Description
Default
Confirm Mode
Disabled: UC1152 will send uplink unconfirmed
packet.
Enabled: The last packet sent from UC1152 to
Network Server will be uplink confirmed packet.
Disabled
ADR Mode
ADR Mode: Adaptive Data Rate.
Enabled: The Network Server will adjust the
datarate by MAC command.
Disabled: Whatever how the signal quality is, the
Network Server will not adjust the datarate of
Disabled

UC1152 User Guide
18
UC1152.
TXPower
The TX (transmit power) setting is used to control
the transmission power of the device.
16
Join Delay1
Number of seconds before receive windows are
opened for join.
Specified in the
LoRaWAN™
Regional
Parameters
Receive Delay1
The Join Accept Delay between the end of the Tx
and the Join Rx Window 1.
Specified in the
LoRaWAN™
Regional
Parameters
Receive Delay2
The Join Accept Delay between the end of the Tx
and the Join Rx Window 2.
Specified in the
LoRaWAN™
Regional
Parameters
Join Trials
The maximum number of the device to resend the
join request when the device failed to join the
network.
0
ReTx
The maximum number of the device to resend the
data packet if no ACK is received after the specified
time.
(Must check Confirmed Mode)
3
RX2
Datarate
Datarate for second receive window, which must be
the same with Tx Datarate of gateway.
2-SF10
RX2 Channel
Frequency
The frequency for second receive window.
Specified in the
LoRaWAN™
Regional
Parameters
ACK
Timeout
Time in milliseconds to wait for ACK before retry of
confirmed downlink.
2000
Duty Cycle
Switch
Check to enable Duty Cycle.
Enable
Duty Cycle
Number of minutes in sliding windows for duty
cycle restrictions.
0.
The 0 means
using the
standard Duty
Cycle which is
specified in the
LoRaWAN™
Regional
Parameters
Uplink Frame
Counter
The number of data frames which sent uplink to the
network server .It will be incremented by the end-d
evice and received by the end-device.
0

UC1152 User Guide
19
Users can reset the a personalized end-device manu
ally, then the frame counters on the end-device and
the frame counters on the network server for that
end-device will be reset to 0.
Downlink
Frame Counter
The number of data frames which received by the e
nd-device downlink from the network server. It will
be incremented by the network server.
Users cloud reset the a personalized end-device ma
nually, then the frame counters on the end-device a
nd the frame counters on the network server for th
at end-device will be reset to 0.
0
4.5 Channel
On this page, you can add the channels to poll the remote Modbus Slave.
Channel Settings
Item
Description
Default
Execution
Interval(ms)
The execution interval between each command. Range:
10-1000. The default value is 50.
50
Max Resp Time(ms)
Set the maximum response time that the Ursalink UC1152
waits for the response to the command. If the device does
not get a response after the maximum response time, it's
determined that the command has timed out. Range:
10-1000.
500

UC1152 User Guide
20
You can click to add a channel or click to delete a channel.
4.6 Command
Max Retry Times
Set the maximum retry times after it fails to read, range: 0-5.
3
Channel ID
Assign the channel for the slave device, 8 channels
selectable.
Null
Name
Set the name to identify the remote channel. It cannot be
blank.
Null
Slave ID
Set Modbus slave ID.
Null
Address
The starting address for reading.
Null
Quantity
The device will read 1 digit from starting address.
1
Type
Read command, options are "Coil", "Discrete", "Holding
Register (INT16)", "Input Register (INT16)", "Holding Register
(INT32)" and "Holding Register (Float)".
Holding
Register
(INT16)
Sign
To identify whether this channel is signed. Default:
Unsigned.
Null
Decimal Place
Used to indicate the decimal place of the channel reading.
For example: the channel value is 1234, and a Decimal Place
is equal to 2, then the actual value is 12.34.
Null
Value
Show the data which read from this slave device.
Null
Fetch
Click to read the data from this slave device.
Null