2
Contents
UC1152 User Guide
1. Preface
2. Introduction
3. Installation
4. Configuration
5. Application Examples
.............................................................................................................................................
....................................................................................................................................
2.1 Features
2.2 Parameters
2.3 LED Indicator Description
3.1 Environment
3.2 Power Supply
3.3 Micro USB Port
3.4 Terminal Description
3.5 Digital Input
3.6 Relay Output
4.1 Configuration via PC
4.1.1 Serial Port Settings
4.2 Status
4.3 General
4.3.1 Basic
4.3.2 RS485
4.2.3 RS232
4.4 LoRaWAN
4.4.1 Basic
4.4.2 Channel
4.4.3 Advanced
4.5 Channel
4.6 Command
4.6.1 Read Command from Device
4.6.2 Open a Command File
4.6.3 Save the Command to Device
4.6.4 Save the Command as File
4.7 IF-THEN Behaviour Command
4.7.1 Supported IF Condition
4.7.2 Supported THEN Actions
4.8 Upgrade
5.1 Periodic Status Report
5.2 Control Appliances
5.2.1 Send an Alert When Channel Value Exceeds a Certain Threshold
.................................................................................................................................
............................................................................................................................
......................................................................................................................................
..........................................................................................................................
.........................................................................................................................
......................................................................................................................
...........................................................................................................................
..........................................................................................................................
..................................................................................................................................
...................................................................................................................................
................................................................................................................................
..........................................................................................................................
........................................................................................................................
........................................................................................................................
.............................................................................................................................
..........................................................................................................................
.....................................................................................................................
..................................................................................................................
................................................................................................................................
............................................................................................................................
...............................................................................................................................
...................................................................................................................
......................................................................................................
.............................................................................................................
..............................................................................................................
.....................................................................................................
...................................................................................
..............................................................................................
..................................................................................
.......................................................................................
.............................................................................................
............................................................................................
..........................................................................................
.........................................................................................................
..............................................................................................................
..........................
3
3
3
4
4
5
5
5
6
6
7
7
8
8
9
10
11
11
12
13
14
14
16
17
19
20
21
21
21
21
21
21
24
26
26
26
27
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
4
2.2 Parameters
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
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
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
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 -
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
UC1152 User Guide
7
Maximum Current
3 Amp
Maximum Voltage
250VAC, 30VDC
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
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.
UC1152 User Guide
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.
9
4.1.1 Serial Port Settings
UC1152 User Guide
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
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
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:
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
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
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.
4.4.1 Basic
UC1152 User Guide
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
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
UC1152 User Guide
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.
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
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
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
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
On this page, you can add the channels to poll the remote Modbus Slave.
UC1152 User Guide
UC1152 User Guide
20
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
You can click to add a channel or click to delete a channel.
4.6 Command
UC1152 User Guide
21
4.6.1 Read Command from Device
Click "Command" to go to the configuration page. Ursalink ToolBox will read command from the
connected device automatically. The whole process takes about 5 seconds.
4.6.2 Open a Command File
You can import the existing command file from your PC with following steps.
Step 1: Click "Open a Command File".
Step 2: Select the command file.
4.6.3 Save the Command to Device
You can click "Save the Command to Device" to save the command having been configured on
the Ursalink ToolBox.
4.6.4 Save the Command as File
You can click "Save the Command as File" to save the command having been configured on the
Ursalink ToolBox as a file and save it on your computer.
4.7 IF-THEN Behaviour Command
The Ursalink UC1152 is running with a number of defined behaviour commands. Each command
takes the form of an IF-THEN statement pair. You are thus able to select certain trigger conditions
to cause desired actions. The Ursalink UC1152 allows up to 8 separate behaviour commands with
some models.
Users can select time or input constraints for any IF-THEN statement pairs, so that an action will
only be triggered during certain period within a day, or only if certain input/output conditions are
met.
The user can enter the edit page by clicking , or delete the command by clicking .
4.7.1 Supported IF Condition
4.7.1.1 IF the Time Is ...
A command containing this IF condition will be triggered at a specific time every day within a
22
specified range of dates, or on every selected day of the week.
The user can choose the day of the week from:
The user can also set the time from 00:00 to 23:59 on a certain day.
4.7.1.2 IF Received a Specific Message
UC1152 User Guide
A command containing this IF condition will be triggered by certain message defined by users.
4.7.1.3 IF Digital Input
A command containing this IF condition will be triggered if the selected digital input changed
according to the specified option.
The user can setup multiple combinations; however, digital input 1 be activated before action is
taken.
Then the user can choose from the following options.
• Goes active (rising edge-triggered)
• Goes inactive (falling edge-triggered)
• Changes state (triggered on rising or falling edge)
• Is active (high level triggered)
• Is inactive (low level triggered)
UC1152 User Guide
23
Thus, if the user chooses "Goes Active", then as soon as the specified input changes from inactive
to active, the command will be triggered. Also, it applies to the remaining options when the
preset conditions are met.
The user is also able to specify a "Continued time" for this command, which will not be triggered
until it remains Active or Inactive longer than the time specified. Moreover, the user can specify a
"Lockout time" for this command. After the command has been triggered, it will not be allowed
to be triggered again until the time specified has elapsed.
When you set the time, you can choose the time unit:
Msec: 0-86400000
sec: 0-86400
min: 0-1440
Only integers are allowed. You can't use the decimal point.
Note: There are 3 single actions at most to be executed for a single trigger condition.
4.7.1.4 IF Channel Input
A statement containing this IF condition will be triggered if the value of the channel meets the
specified requirements.
Then the user can choose from the following options (Type: Holding Register (INT16), Input
Register (INT16), Holding Register (INT32) and Holding Register (Float):
•
above
•
below
•
within
Thus, if the user chooses , then as soon as the value of this
channel input goes above the specified threshold, the statement will be triggered.
Thus, if the user chooses , then as soon as the value of this
channel input goes below the specified threshold, the statement will be triggered.
Thus, if the user chooses , then as soon
as the value of this channel input goes within the specified threshold, the statement will be
UC1152 User Guide
24
triggered.
If you select a "Lockout Time" of 10s, a "Continue Time" of 5s, and choose
, the statement will be triggered as soon as the value of the
selected channel input goes above 10, and remains above 10 for 5s. It will then start checking the
value of the selected channel input again after 10s and be triggered once more if the value of the
selected analog input is above 10 for 5s.
If the "Lockout Time" is 0, the statement will only be triggered once (will be triggered again when
the trigger condition has changed and becomes true again).
Then the user can choose from the following options (Type: Coil, Discrete).
• True
• False
Thus, if the user chooses , then as soon as the value of this channel input is 1, the
statement will be triggered.
Thus, if the user chooses , then as soon as the value of this channel input is 0,
the statement will be triggered.
4.7.1.5 IF the Device Restarts
A command containing this IF condition will be triggered once the device has finished restarting.
4.7.2 Supported THEN Actions
4.7.2.1 THEN Change Output
A command containing this Action will change the selected output according to specified actions.
The user can choose from the following actions:
•
Will be activated
UC1152 User Guide
25
• Will be deactivated
• Will follow the input: When the triggering condition is the Input changes state, you can then
select change state as the action.
If the user has configured:
➢ "Delay Time", the selected output will be activated after the specified time.
➢ "Duration", the output will remain current status for a certain period of time.
4.7.2.2 THEN Send A Custom Message
A command containing this action will send a custom text message via LoRaWAN if the condition
is met. Only letter, number, comma, period, separator, space and exclamation mark are allowed
in the message, and the maximum character length is 60.
4.7.2.3 THEN Restart the Device
A command containing this Action will restart the Ursalink UC1152 if the condition is met.
26
4.8 Upgrade
UC1152 User Guide
Step 1: Connect Ursalink UC1152 to PC via USB port.
Step 2: Power on the Ursalink UC1152.
Step 3: Run the Ursalink ToolBox and go to "Upgrade".
Step 4: Click "Browse" and select the correct firmware file from the PC.
Step 5: Click "Upgrade" and the device will check if the firmware file is correct. If it's correct, the
firmware will be imported to the device, and the device will restart after upgrading is completed.
Note: Any operation on Ursalink ToolBox is not allowed during upgrading, otherwise the
upgrading will be interrupted, or even the device will break down.
Click "Reset", and the device will restore to the factory default settings.
5. Application Examples
5.1 Periodic Status Report
Configuration:
Using the ToolBox, we create a behaviour statement that displays as follows:
UC1152 User Guide
27
The Ursalink UC1152 will send a custom message at 8 a.m. every Monday.
5.2 Control Appliances
5.2.1 Send an Alert When Channel Value Exceeds a Certain
Threshold
Configuration:
Hardware:
Software:
-END-
Loading...