Uc300 User Guide en
Uc300 User Guide en
UC300
User Guide
Safety Precautions
Milesight will not shoulder responsibility for any loss or damage resulting from not following the
instructions of this operating guide.
The device must not be remodeled in any way.
Do not place the device close to objects with naked flames.
Do not place the device where the temperature is below/above the operating range.
Power off the device when installing or wirings.
Make sure electronic components do not drop out of the enclosure while opening.
The device must never be subjected to shocks or impacts.
Declaration of Conformity
UC300 is in conformity with the essential requirements and other relevant provisions of the CE,
FCC, and RoHS.
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 Milesight IoT Co., Ltd.
For assistance, please contact
Milesight technical support:
Email: iot.support@milesight.com
Tel: 86-592-5085280
Fax: 86-592-5023065
Address: Building C09, Software Park III,
Xiamen 361024, China
Revision History
Date Doc Version Description
Mar. 17, 2022 V 1.0 Initial version
2
Contents
1. Product Introduction................................................................................................................................. 4
1.1 Overview........................................................................................................................................... 4
1.2 Features............................................................................................................................................4
2. Hardware Introduction..............................................................................................................................4
2.1 Packing List......................................................................................................................................4
2.2 Hardware Overview.........................................................................................................................5
2.3 Application Wiring...........................................................................................................................5
2.4 LED Indicators................................................................................................................................. 6
2.5 Reset Button.................................................................................................................................... 7
2.6 Dimensions (mm)........................................................................................................................... 7
3. Hardware Installation............................................................................................................................... 7
3.1 SIM Installation (Cellular Version Only).......................................................................................7
3.2 Antenna Installation........................................................................................................................7
3.3 Device Installation...........................................................................................................................8
3.3.1 Wall Mounting...................................................................................................................... 8
3.3.2 DIN Rail Mounting................................................................................................................8
4. Operation Guide.........................................................................................................................................9
4.1 Log in the ToolBox.......................................................................................................................... 9
4.2 Communication Settings............................................................................................................. 11
4.2.1 LoRaWAN Settings (LoRaWAN Version Only).............................................................. 11
4.2.2 Cellular & Application Settings (Cellular Version Only)............................................... 13
4.2.3 SMS Settings (Cellular Version Only)............................................................................. 17
4.3 Data Interface Settings................................................................................................................ 18
4.3.1 Basic Settings.................................................................................................................... 18
4.3.2 Digital Input/Pulse Settings............................................................................................. 19
4.3.3 Digital Output Settings......................................................................................................20
4.3.4 RS485 Settings...................................................................................................................20
4.3.5 RS232 Settings...................................................................................................................22
4.3.6 Analog/PT100 Settings.................................................................................................... 24
4.4 IF-THEN Command.......................................................................................................................25
4.5 LoRa D2D Settings (LoRaWAN Version Only).......................................................................... 28
4.6 Maintenance.................................................................................................................................. 30
4.6.1 Upgrade............................................................................................................................... 30
4.6.2 Backup.................................................................................................................................31
4.6.3 Reset to Factory Default...................................................................................................31
5. Device Payload........................................................................................................................................ 32
3
1. Product Introduction
1.1 Overview
UC300 is an IoT controller used for remote control and data acquisition from multiple sensors. It
contains different I/O interfaces such as analog inputs, digital inputs, relay outputs, serial ports
and so on, which support remote device data transmission and control via LoRaWAN®, 3G/4G
networks or SMS. Besides, UC300 supports multiple trigger conditions and actions which works
autonomously even when the network drops.
1.2 Features
Easy to connect with diverse wired sensors through DI/DO/AI/PT100/RS232/RS485
interfaces
Support LoRaWAN® or 3G/4G wireless communication
Multiple triggering conditions and actions
Embedded watchdog for work stability
Industrial metal case design with wide operating temperature range
Compliant with standard LoRaWAN® gateways and network servers
Quick and easy management with Milesight IoT Cloud solution
2. Hardware Introduction
2.1 Packing List
4
1× 1 × Warranty
Quick Start Guide Card
If any of the above items is missing or damaged, please contact your sales representative.
5
RS485 Terminal Resistor:
DIP Switch Description
1 on 2 off 3 off Add 120 Ω resistor between A and B
1 off 2 on 3 off Add pull-down resistor on B
1 off 2 off 3 on Add pull-up resistor on A
6
2.5 Reset Button
There is reset button inside the device.
Description
Function
SYS LED Action
Static Green Press and hold the reset button for more than 10 seconds.
Static Green →
Reset Release the button and wait.
Rapidly Blinking
Off → Static Green The device resets to factory default.
3. Hardware Installation
7
The external antenna should be installed vertically always on a site with a good signal.
2. Drill 4 holes on the wall according to the bracket, then fix the wall plugs into the wall.
3. Fix the device to the wall plugs with screws. When installation, it’s suggested to fix the two
screws on the top at first.
8
You can also try below installation methods:
2. Hang the device to the DIN rail. The width of DIN rail is 3.5cm.
4. Operation Guide
9
3. Open the ToolBox and select type as “General”, then click password to log in ToolBox.
(Default password: 123456)
10
4.2 Communication Settings
4.2.1 LoRaWAN Settings (LoRaWAN Version Only)
LoRaWAN settings is used for configuring the transmission parameters in LoRaWAN® network
and is only applied to UC300 LoRaWAN® version.
Parameters Description
Device EUI Unique ID of the device on the label.
App EUI Default App EUI is 24E124C0002A0001.
The port used for sending and receiving data (RS232 data excluded), default
Application Port
port is 85.
Working Mode Fixed as Class C.
Join Type OTAA and ABP modes are available.
Application Key Appkey for OTAA mode, default is 5572404C696E6B4C6F52613230313823.
Device Address DevAddr for ABP mode, default is the 5th to 12th digits of SN.
Network Session Nwkskey for ABP mode, default is 5572404C696E6B4C6F52613230313823.
11
Key
Application
Appskey for ABP mode, default is 5572404C696E6B4C6F52613230313823.
Session Key
RX2 Data Rate RX2 data rate to receive downlinks.
RX2 Frequency RX2 frequency to receive downlinks. Unit: Hz
Spread Factor If ADR is disabled, the device will send data via this spread factor.
If the device does not receive ACK packet from network server, it will resend
Confirmed Mode
data 3 times at most.
Reporting interval ≤ 30 mins: device will send specific mounts of LoRaMAC
packets to check connection status every 30 mins; If not receiving response
after specific packets, the device will re-join.
Rejoin Mode
Reporting interval > 30 mins: device will send specific mounts of LoRaMAC
packets every to check connection status every reporting interval; If not
receiving response after specific packets, the device will re-join.
ADR Mode Allow network server to adjust datarate of the device.
Tx Power Transmit power of device.
Note:
1) Please contact sales for device EUI list if there are many units.
2) Please contact sales if you need random App keys before purchasing.
3) Select OTAA mode if you use Milesight IoT Cloud to manage devices.
4) Only OTAA mode supports rejoin mode.
12
If frequency is one of CN470/AU915/US915, you can enter the index of the channel that you
want to enable in the input box, making them separated by commas.
Examples:
1, 40: Enabling Channel 1 and Channel 40
1-40: Enabling Channel 1 to Channel 40
1-40, 60: Enabling Channel 1 to Channel 40 and Channel 60
All: Enabling all channels
Null: Indicates that all channels are disabled
13
Cellular Settings:
Go to “General -> Basic” to configure basic cellular settings.
Parameters Description
Select from "Auto", "4G Only", "3G Only", and "2G Only".
Auto: connect to the network with the strongest signal automatically.
Network Type
4G Only: connect to 4G network only.
And so on.
PIN Code Enter a 4-8 characters PIN code to unlock the SIM.
Enter the username for cellular dial-up connection provided by local ISP. The
User
max length is 31 characters.
Enter the password for cellular dial-up connection provided by local ISP. The
Password
max length is 31 characters.
Enter the Access Point Name for cellular dial-up connection provided by local
APN
ISP. The max length is 31 characters.
Enter the local SMS center number for storing, forwarding, converting and
SMS Center
delivering SMS message. This is required if you need to use SMS control or
Number
reporting feature.
7 Bit: standard GSM message coding for most common letters and symbols,
SMS Data Coding
can contain up to 160 characters.
Scheme
8 Bit: suit for multimedia messages, can contain up to 140 characters.
14
UCS-2: send Unicode characters and suit for more languages like Chinese,
Korean and Arabic, can contain up to 70 characters.
Enter the NTP Server's IP address or domain name. After registered to
NTP Server network, the device will sync the device time from this server. Default:
www.ntp.org
Change Password Change the password to loggin ToolBox and SMS password validation.
Application Settings:
Go to “Application -> Application” to configure the settings to send data to corresponding
servers. About the MQTT topics, please refer to the UC300 Cellular Communication Protocol.
Parameters Description
Application Mode Select from “Milesight IoT Cloud”, “AWS”, “TCP”, “UDP”, and “MQTT”.
The interval of reporting interface data. Default: 1800s, Range: 10-64800s
Reporting Interval
Note: for Milesight IoT Cloud mode, the reporting interval should be
(s)
configured on the cloud webpage.
Milesight IoT Cloud
Keep Alive Interval After connected, the device will send heartbeat packet regularly to keep alive.
(s) Default: 200 s, Range: 1-3600 s
AWS
Server Address Fill in the AWS server domain name which the data sends to.
Keep Alive Interval After connected, the device will send heartbeat packet regularly to keep alive.
15
(s) Default: 200 s, Range: 1-3600 s
CA File Import the CA.crt file.
TCP/UDP
After TCP/UDP connection established, the device will send one package
Description including the description to identify the device. The max length is 32
characters.
Keep Alive Interval For TCP connection, the device will send heartbeat packet regularly to keep
(s) alive. Default: 60 s, Range: 60-7200 s
Custom Heartbeat
After enabled, the device will send custom heartbeat packets to TCP server.
Mode
Custom Content Customize the heartbeat packet content. The max length is 32 characters.
The device will send custom heartbeat packet regularly. Default: 30 s, Range:
Heart Interval (s)
30-3600 s
After the device send custom heartbeat packet, it needs a specific response
Require Response
from server.
Customize the server reply content after receiving custom heartbeat packets.
Response Content
The max length is 32 characters.
16
Password The password used for connecting to MQTT broker.
TLS
Enable Enable the TLS encryption in MQTT communication.
Protocol It’s fixed as TLS v1.2.
SMS Control
Parameters Description
Enable Enable to allow users to send SMS to control the device.
Control Center The number used to control this device. 2 control numbers can be added at
Number most.
Success After control success, the device will send success reply to the control center
Confirmation number.
Failure
After control failure, the device will send failure reply to control center number.
Confirmation
17
SMS Report
Parameters Description
Enable Enable to allow device to report device DI/DO status via SMS.
Any Change When any of DI/DO interfaces’ status changed, the device will send the
Report current status via SMS.
Regular Report Report the time, signal, network type and data interface status/values of
Interval device regularly via SMS. Default: 720 mins, Range: 1-1440 mins.
Select the SMS messaging protocol. It’s General by default.
SMS Messaging General: send SMS as general string format.
Protocol UCP: send SMS as hex format, you can decode it referring to UC300
Communication Protocol document.
Number Reports SMS to these phone numbers. 6 numbers can be added at most.
18
Parameters Description
Device ID Show the SN of the device.
Reporting interval of transmitting data to network server.Default: 20mins
Reporting Interval
Note: RS232 transmission will not follow the reporting interval.
LoRa D2D See details on chapter 4.5.
Cellular Version:
See cellular setting in chapter 4.2.2.
19
Parameters Description
Enable Enable digital input to detect status and upload the data.
Digital Input
Fetch Click to get the current input status.
Counter
Digital Filter It’s recommended to enable when pulse period is greater than 250 us.
Click to start/stop counting. Note that UC300 will send non-changeable
Start/Stop
counting values if you do not click “Start”.
Refresh Refresh to get latest counter values.
Clear Count the value from 0.
Note: the counting value will lose if UC300 loses the power.
Parameters Description
Enable the digital output to control the device and upload changed
Enable
status.
When Power is After the device power is restored, the DO status will return to normally
Restored, DO closed or normally open according to this parameter.
Fetch Click to get the current output status.
Switch Click to change the DO status.
20
settings should be the same as the RS485 terminal devices.
Parameters Description
Enable Allow the device to collect RS485 data and upload the data.
Stop Bit 1 bit/2 bit are available.
Execution Interval
The execution interval between each Modbus channel command.
(ms)
The maximum response time that the UC300 waits for the reply to the
Max Resp Time
command. If it does not get a response after the max response time, it is
(ms)
determined that the command has timed out.
Max Retry Time Set the maximum retry times after device fails to read data from RS485
(ms) terminal devices.
Modbus RS485 If this mode is enabled, the device will transmit Modbus RTU commands
bridge LoRaWAN from network server to RS485 terminal devices transparently and send
(LoRaWAN® Modbus reply originally back to the network server.
Version Only) Port: Select from 2-84, 86-223.
21
Parameters Description
Channel ID Select the channel ID you want to configure from 16 channels.
Name Customize the name to identify every Modbus channel.
Slave ID Set Modbus slave ID of terminal device.
Address The starting address for reading.
Set read how many digits from starting address. For LoRaWAN® version, it
Quantity
fixes to 1; for cellular version, it can be set as 1 to 4.
Type Select data type of Modbus channels.
Set the Modbus data reading order if you configure the type as Input register
or holding register.
Byte Order
INT32/Float: ABCD, CDBA, BADC, DCBA
INT16: AB, BA
Sign The tick indicates that the value has a plus or minus sign.
After click, UC300 will send Modbus read command to test if it can read
correct values.
Example: as this setting, the device will send command: 01 03 00 00 00 01
84 0A
Fetch
4. Click “Fetch” to check if UC300 can read correct data from terminal devices.
Note: Do not click “Fetch” frequently since response time to reply is differ for every terminal
device.
22
Parameters Description
Packet Length When the device receives RS232 data up to this length, it will fragment it as
(byte) a single packet and send to network server.
Serial Frame The interval that the device sends out real serial data stored in the buffer
23
Interval (ms) area to public network. The range is 10-65535 milliseconds.
Note: data will be sent out when real serial data size reaches the preset
packet size, even though it's within the serial frame interval.
LoRaWAN Version
Send or receive RS232 data from this port, this port should different from
Port the Application port.
Range: 2-84, 86-223.
Cellular Version
Keep Alive Interval For TCP connection, the device will send heartbeat packet regularly to keep
(s) alive. Default: 60s, Range: 60-7200 s
Reconnect Interval After connection failure, the device will reconnect to the TCP server after
(s) the preset interval. Default:10 s, Range: 10-60 s.
After TCP/UDP connection established, the device will send the register
Register String
string to identify the device. The max length is 32 characters.
Server Address Fill in the TCP or UDP server address (IP/domain name).
24
4.4 IF-THEN Command
UC300 supports configuring locally IF-THEN commands to do some actions automatically even
without network connection. One device can be added 16 commands at most.
1. Go to “Command” page, click “Edit” to add commands.
25
2. Set a IF condition based on the terminal device data or UC300 device status.
Condition Description
Set the time condition. The device time will be synced once after
Time joining/registering to network, you can also sync the time manually on “Status”
page.
When UC300 device detects the DI as a specific status.
Is continued for: the DI changed status should last for some time.
Digital Input
Set lockout time: after the lockout time, UC300 will detect if DI status matches
the condition. 0 means this IF condition will only be detected once.
26
When pulse counter reaches a specific value. This only works when DI works
Counter
as counter mode.
When the value reaches any threshold.
Is continued for: the analog value should last for some time.
Set lockout time: after the lockout time, UC300 device will detect if analog
Channel/4-20m
value matches the condition. 0 means this IF condition will only be detected
A/0-10V/PT100
once.
Note: for UC300 cellular version, if this Modbus channel quantity is more than
1, this condition will only judge the first value.
Received a
When UC300 device receive a specific message from server.
message
The Device
Reboot the device.
Restarts
Received a D2D
This only works with UC300 LoRaWAN® version and the LoRa D2D feature is
control
enabled. See details on chapter 4.5.
command
The signal When UC300 cellular signal is lower than 10 asu, this only works with UC300
strength is weak cellular version.
3. Set THEN action according to your request. You can add at most 3 actions in one command.
Action Description
Send a custom
Send a custom message to the server.
message
DO can be set to normally open/normally closed/change status.
Output Trigger Delay Time: this action will trigger after a specific time;
Duration: the output status will last for a specific time, 0 means permanent.
Send a D2D control This only works with UC300 LoRaWAN® version and the LoRa D2D feature is
command enabled. See details on chapter 4.5.
Send a Modbus
This only works with UC300 LoRaWAN® version and the LoRa D2D feature is
command via
enabled. See details on chapter 4.5.
RS485 interface
Send a device This only works with UC300 cellular version and the SMS Report feature is
status message enabled.
27
via SMS
2. Go to “LoRaWAN Settings -> Basic” to configure the RX2 datarate and RX2 frequency. When
UC300 works as LoRa D2D controller, it will send commands as RX2 settings.
28
the LoRa D2D agent device. The command should be a 2-byte hexadecimal number.
When UC300 receives a LoRa D2D command, it can work as a LoRa D2D agent to trigger the DO
or send Modbus command to RS485 terminal devices.
29
Note: When this feature is enabled and the command is triggered, the device will not send data
to LoRaWAN® network server.
4.6 Maintenance
4.6.1 Upgrade
UC300 supports upgrade locally via ToolBox software.
1. Download firmware from www.milesight-iot.com to your PC.
2. Go to “Maintenance -> Upgrade”, click “Browse” to import firmware and upgrade the device.
You can also click “Up to Date” to search for the latest firmware of the device and upgrade.
Note: Any operation on ToolBox is not allowed during upgrading, otherwise the upgrading will be
interrupted, or even the device will break down.
30
4.6.2 Backup
UC300 devices support configuration backup for easy and quick device configuration in bulk.
Backup is allowed only for devices with the same model and LoRa frequency band.
1. Go to “Maintenance -> Backup and Reset”, click “Export” to save current configuration as
json format backup file.
2. Click “Browse” to select backup file, then click “Import” to import the configurations.
31
5. Device Payload
For UC300 LoRaWAN® version, please refer to the UC300 LoRaWAN Communication Protocol;
For UC300 cellular version, please refer to the UC300 Cellular Communication Protocol; for
decoders of Milesight IoT products please click here.
-END-
32