King Pigeon BL101 User manual

Modbus IoT Gateway
BL101
BL101
User Manual
Revision: V1.0
Issue Date: 2021-6-1
King Pigeon Communication Co., Ltd
Website: www.iot-solution.com

Page 2 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
Preface
Thanks for choosing King Pigeon Modbus IOT Gateway BL101. Reading this manual
with full attention will help you quickly learn device functions and operation methods.
Copyright
This user manual is owned by King Pigeon Communication Co., Ltd. No one is
authorized to copy, distribute or forward any part of this document without written
approval of King Pigeon. Any violation will be subject to legal liability.
Disclaimer
This document is designed for assisting user to better understand the device. As the
described device BL101 is under continuous improvement, this manual may be
updated or revised from time to time without prior notice. This Modbus Gateway is
mainly used for industrial data transmission over Ethernet or 4G network. Please
follow the instructions in the manual. Any damages caused by wrong operation will be
beyond warranty.
Revision History
Revision Date
Version
Description
Owner
June 1, 2021
V1.0
Initial Release
HYQ

Page 3 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
1 Brief Introduction to Device...........................................................................................6
1.1 General Description.................................................................................................6
1.2 Application Scenario................................................................................................7
1.3 Packing List.............................................................................................................. 7
1.4 Features.................................................................................................................. 10
1.5 Technical Parameters............................................................................................11
1.6 Model Selection......................................................................................................13
2 Hardware Introduction................................................................................................. 13
2.1 Outline Dimension................................................................................................. 13
2.2 Power Source Input............................................................................................... 14
2.3 SIM Card and SD Card Slots............................................................................... 15
2.4 Program Debugging & Upgrading Interface...................................................... 15
2.5 Device Grounding.................................................................................................. 15
2.6 4G Antenna............................................................................................................. 16
2.7 LED Indicator..........................................................................................................16
2.8 RESET Button........................................................................................................ 17
2.9 COM & Power Output Port................................................................................... 17
2.10 WAN & LAN Port..................................................................................................18
3 Device Mounting........................................................................................................... 18
3.1 Wall-Mounting.........................................................................................................18
3.2 DIN Rail Mounting..................................................................................................19
4 Configurator Operation................................................................................................ 19
4.1 Login to Configuration Software.......................................................................... 19
4.1.1 Open Configuration Software...................................................................... 19
4.1.2 Search for Device.......................................................................................... 20
4.1.3 Connect Gateway Device............................................................................. 21
4.2 Configuration Software Introduction................................................................... 22
4.2.1 System Function............................................................................................ 22
4.2.2 COM Port Introduction.................................................................................. 24
4.2.2.1 COM Port Configuration........................................................................ 24

Page 4 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
4.2.2.2 Add COM Port Devices..........................................................................25
4.2.2.3 Add COM Port Device Datapoints....................................................... 26
4.2.3 LAN Port Introduction....................................................................................28
4.2.3.1 LAN Port Attributes Configuration........................................................28
4.2.3.2 Add LAN Port Device............................................................................. 29
4.2.3.3 Add LAN Port Device Datapoints.........................................................31
4.2.4 WAN Port Introduction.................................................................................. 31
4.2.4.1 WAN Port Attributes Configuration...................................................... 31
4.2.4.2 Add WAN Port Device............................................................................32
4.2.4.3 Add WAN Port Device Datapoints....................................................... 33
4.2.5 4G Cellular Network Introduction................................................................ 33
4.2.6 Alarms and Events Configuration................................................................34
4.2.6.1 Alarm Points Configuration................................................................... 34
4.2.6.2 Alarm Event Configuration.................................................................... 35
4.2.7 Task Plan Configuration................................................................................ 37
4.2.8 Data Service................................................................................................... 38
4.2.8.1 Transparent Transmission.....................................................................38
4.2.8.2 Modbus RTU to Modbus TCP.............................................................. 39
4.2.8.3 Modbus TCP Server...............................................................................41
4.2.8.4 OPC UA................................................................................................... 41
4.2.9 Cloud Platform Connection.......................................................................... 42
4.2.9.1 MQTT Client One................................................................................... 42
4.2.9.2 MQTT Client Two....................................................................................44
4.2.9.3 Alibaba Cloud.......................................................................................... 45
4.2.9.4 HUAWEI Cloud....................................................................................... 46
4.2.9.5 AWS (Amazon Web Service)................................................................48
4.2.9.6 King Pigeon Cloud via MQTT............................................................... 51
4.2.9.7 King Pigeon Cloud via Modbus............................................................ 52
5 BL101 Gateway Application Example....................................................................... 53
5.1 Device Connecting Diagram................................................................................ 53

Page 5 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
5.2 Configuration Software Setting............................................................................54
5.2.1 Add Devices and Datapoints........................................................................54
5.2.1.1 COM Port Configuration........................................................................ 54
5.2.1.2 Add M140T to COM Port....................................................................... 55
5.2.1.3 Add M140T Datapoints.......................................................................... 56
5.2.1.4 LAN Port Configuration..........................................................................57
5.2.1.5 Add LAN Port Device S475...................................................................58
5.2.1.6 Add S475 Datapoint............................................................................... 59
5.2.2 M140T & S475 Data Uploading to Clouds.................................................60
5.2.2.1 Modbus TCP Server Configuration......................................................60
5.2.2.2 View Dat with KEPServerEX 6............................................................. 60
5.2.2.3 OPC UA Configuration...........................................................................61
5.2.2.4 View Data with KEPServerEX 6...........................................................62
5.2.2.5 Alibaba Cloud Configuration................................................................. 63
5.2.2.6 View Data from Alibaba Cloud..............................................................64
5.2.2.7 HUAWEI Cloud Configuration.............................................................. 65
5.2.2.8 View Data from HUAWEI Cloud...........................................................67
5.2.2.9 AWS Configuration................................................................................. 68
5.2.2.10 View Data from AWS........................................................................... 69
5.2.2.11 King Pigeon Cloud via Modbus Configuration................................. 70
5.2.2.12 View Data from King Pigeon Cloud via Modbus............................. 71
5.2.2.13 King Pigeon Cloud via MQTT Configuration....................................72
5.2.2.14 View Data from King Pigeon Cloud via MQTT................................ 73
5.2.2.15 King Pigeon Cloud MQTT Message Format....................................73
6 Firmware Upgrading.................................................................................................... 76
7 Warranty Term........................................................................................................... 76
8 Technical Support........................................................................................................ 76

Page 6 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
1 Brief Introduction to Device
1.1 General Description
Developed on embedded Linux operation system for robust stability, BL101 is an
innovative gateway that converts Modbus to OPC UA / MQTT protocol.
It’s equipped with 1RS232/RS485(default RS485) serial port, 2 power source inputs, 1
power output, 2 Ethernet ports and 2 USB ports. Both SIM and SD card slots are
available. Network can be connected either through 4G cellular or Ethernet for high
transfer speed and low latency.
On downstream it supports Modbus RTU Master and Modbus TCP Master. on
upstream, it supports Modbus TCP, MQTT, OPC UA, HUAWEI Cloud, Alibaba Cloud,
AWS, King Pigeon Cloud, etc. Users can connect various devices to cloud, SCADA,
OPC UA and MES system with this gateway. Mutiple platforms and host computers
can be online simultaneously.
This gateway supports TSL\SSLencryption for data security as well as router function
with switch for more industrial equipment data acquistion.
With complete functions and superior quality, it can be used in many industrial
applications for remote monitoring and control.

Page 7 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
1.2 Application Scenario
1.3 Packing List
Before operating the device, please make sure all below parts are in the package

Page 8 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
1XBL101 Gateway
1x 4PIN 3.5mm terminal for power input
1x RS485/232 5PIN 3.5mm terminal for power output
1 x 4G SMA Cellular Network Antenna
2 x Wall-mounting Clip Kit

Page 9 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
1 x DIN Rail Clip Kit
1 x User Manual (Softcopy in PDF format)
(Note: Please scan QR code to download)
1 x Data Card Picking PIN
1 x Product Qualification Certificate
1 x Warranty Card
Note: If any of the above items are missing, please contact King Pigeon Sales team.

Page 10 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
1.4 Features
Downlink: support Modbus RTU Master、Modbus TCP Master
Uplink: support Modbus TCP, MQTT, OPC UA, HUAWEI Cloud, Alibaba Cloud.
Support 9-36V DC power supply with terminal connection. 2 channels of power
input redundancy design with inverse connection protection. Either channel can
be selected for power input.
1 power output channel. Output voltage is the same as power input voltage
1 RS485 (can be RS232 if required)
Baud rate 2400bps-115200bps, stop bit supports 1, 2 bits, data bit supports 7, 8
bits. Parity supports None, Odd, Even.
Support 2 RJ45 Ethernet connection, 1WAN and 1LAN. Data of equipment
connected to LAN, WAN or cascade switch can be acquisted. Both network link
and rate indicators are available. Built-in isolation transformer for up to 2KV
electromagnetic insulation.
Support POE PD( Powered Device) for saving wiring cost (Optional function)
Support TSL\SSL encryption for data security
Support router function to provide network for other devices
Support 4G network with APN setting. Ethernet network will be used first if it’s
available. If Ethernet is disconnected, it will shift to 4G cellular network
automatically.
Support Modbus to Modbus TCP, transparent transmission
Support returning to factory setting (Long pressing RESET until RUN indicator is
off) to avoid parameter setting error
Support hardware and software watchdog for high reliability
Metal case with IP30 protection grade. Safety isolation between metal case and
system , especially suitable for industrial site applications
Compact size: 30mm*83mm*110mm; Support wall-mounting and DIN rail
mounting

Page 11 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
1.5 Technical Parameters
Item
Parameter
Description
Power
Source
Input Voltage
DC 9～36V
Consumption
Normal 85mA@12V, Max 117mA@12V
Wiring
Support inverse connection protection
Network
Interface
Interface Spec
2 x RJ45, 10/100Mbps, Adaptive MDI/MDIX。
Port Protection
ESD ±16kV(Contact); ±18kV(Air)
EFT 40A (5/50ns)
Lightening 6A（8/20µs）
Serial Port
Serial Port
1 x RS232/RS485 (Default is RS485, Optional RS232)
Baud Rate
2400bps-115200bps
Data Bit
7,8
Parity Bit
None, Even, Odd
Stop Bit
1, 2
Port Protection
ESD ±8kV (Contact); ±15kV(Air);
EFT 2KV, 40A （5/50ns）。
Power Output
Output Voltage
1 channel 9～36 V DC (Equal to input power voltage)
SIM Card Slot
Qty
1
Spec
Drawer design, Support 1.8V/3V SIM/UIM card (NANO)
Protection
Inbuilt 15KV ESD protection
SD Card Slot
(Reserved
function)
Reserved for future development
USB Port
Qty
1* program downloading+1*program debugging
Spec
Micro USB OTG
Protection
Over Current Protection
4G
(Optional)
Antenna Qty
1
Antenna Type
SMA
L-E version
GSM/EDGE:900,1800MHz
WCDMA:B1,B5,B8
FDD-LTE:B1,B3,B5,B7,B8,B20
TDD-LTE:B38,B40,B41
L-CE version
GSM/EDGE:900,1800MHz
WCDMA:B1,B8
TD-SCDMA:B34,B39
FDD-LTE:B1,B3,B8

Page 12 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
TDD-LTE:B38,B39,B40,B41
L-A version
WCDMA:B2,B4,B5
FDD-LTE:B2,B4,B12
L-AU version
GSM/EDGE:850,900,1800MHz
WCDMA:B1,B2,B5,B8
FDD-LTE:B1,B3,B4,B5,B7,B8,B28
TDD-LTE:B40
L-AF version
WCDMA:B2,B4,B5
FDD-LTE:B2,B4,B5,B12,B13,B14,B66,B71
CAT-1 version
GSM:900,1800
FDD-LTE:B1,B3,B5,B8
TDD-LTE:B34,B38,B39,B40,B41
Indicator
RUN
Steady light if device is powered on
Flickering if device is running
Off if device is not running
NET
Flickering if communication is over Ethernet network
Steady light if communication is over 4G network
Off if no data communication
TXD
Flickering if device is transmitting data
Off if there’s no data transmitting
RXD
Flickering if device is receiving data
Off if there is no data receiving
Software
Parameter
Network
Protocol
IPV4, TCP/UDP, DHCP, DNS
IP Retrieving
Static IP/DHCP
Transmission
Support Transparent Data Transmission
DNS
Support Domain Name Resolution
Configuration
PC configuration, support WIN XP/WIN 7/WIN 8/WIN 10
Cache Size
Transmit: 8Kbyte, Receive: 8Kbyte。
Register Pack
Support custom registration package
Heartbeat PCK
Support custom heartbeat package
Safety
Certification
MTBF
≥100,000 hours
EMC
EN 55022: 2006/A1: 2007 (CE &RE) Class B
IEC 61000-4-2 (ESD) Level 4
IEC 61000-4-3 (RS) Level 4
IEC 61000-4-4 (EFT) Level 4
IEC 61000-4-5 (Surge)Level 3

Page 13 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
IEC 61000-4-6 (CS)Level 4
IEC 61000-4-8 (M/S) Level 4
Other
CE, FCC
Environment
Condition
Working
-40～80℃, 5～95% RH
Storage
-40～85℃，5～95% RH
Others
Case Material
Metal
Size
30mm×83mm×110mm(L*W*H)
Protection
IP30
Net Weight
291.2g
Mounting
Wall-mounting, DIN Rail mounting
1.6 Model Selection
Model
NO.
WAN
LAN
COM (Default RS485)
(RS485/RS232 optional)
OPC-UA
4G
POE PD
BL101
√
√
√
X
√
Optional
BL101E
√
√
√
X
X
Optional
BL101UA
√
√
√
√
X
Optional
2 Hardware Introduction
2.1 Outline Dimension
Unit: mm

Page 14 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
2.2 Power Source Input
2 optional power source input channels, support 9-36VDC voltage input, support

Page 15 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
inverse connection protection.
2.3 SIM Card and SD Card Slots
Before inserting or removing SIM card, please make sure device is turned off. Insert
SIM card picking PIN to the small hole of card slot and eject the card slot with tiny
force.
Note: Place the device like above picture to insert/remove SIM card
2.4 Program Debugging & Upgrading Interface
DEBUG USB port is for program debugging. DOWNLOAD USB port is for program
upgrading.
2.5 Device Grounding
Before connecting the device, please do equipment grounding with grounding screw
to prevent electromagnetic interference

Page 16 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
2.6 4G Antenna
2.7 LED Indicator
LED Indicator Introduction
Item Name
Status
Description
RUN
Device Running
Flickering
Device is running
Off
Device faulty
NET
Ethernet/4G
Network
Flickering
Ethernet network
On
4G network
Off
No communication
TX
Data Transmitting
Flickering
Serial port is transmitting data
Off
No data transfer from serial port
RX
Data Receiving
Flickering
Serial port is receiving data
Off
No data is received in serial port
Note: RUN indicator will be on if device is powered. If it’s not on, please
check whether there’s reverse wiring or power source problem.
4G Antenna Interface

Page 17 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
2.8 RESET Button
Once gateway has run for some time, use a tiny stick to press Reset button for
about 10 seconds until RUN indicator is off. Then Gateway will restart and return to
factory setting.
2.9 COM & Power Output Port
RS485/RS232 & Power Output Terminal
Item
Description
VOUT+
Power Output Positive Terminal
VOUT-
Power Output Negative Terminal
B/RX
RS485 Data-(B)/Receiving Data
A/TX
RS485 Data+(A)/Transmitting Data
GND
Grounding
Note:
Power output voltage is equal to power input voltage: 9~36VDC.

Page 18 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
2.10 WAN & LAN Port
3 Device Mounting
BL101 Gateway can be placed on desk, mounted on the wall and DIN Rail
3.1 Wall-Mounting
Wall-Mounting
Ethernet Port
Indicator
Color
Status
Description
Rate
Green
On
100Mbps mode
Off
10Mbps mode
Link
Yellow
On
Connected
Flickering
Transferring data
Off
Disconnected

Page 19 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
3.2 DIN Rail Mounting
4 Configurator Operation
4.1 Login to Configuration Software
Connect BL101 to router or switch through WAN port with standard direct network
cable or cross network cable. Make sure BL101 and PC are in the same local area
network. If it’s necessary to connect the gateway to PC directly, use standard cross
network cable to connect through BL101 LAN port. (If BL101 is connected to PC
directly, PC IP must be specified to 192.168.3.1 as default LAN IP of gateway is
192.168.3.1 from factory setting)
Note: WAN port IP is retrieved automatically, LAN port IP is 192.168.3.1 from factory
setting
4.1.1 Open Configuration Software
Double click on PC to run BL101 configuration software
and enter below page
Clip Assembling
DIN Rail Mounting

Page 20 of 76 King Pigeon Communication Co., Ltd. V1.0
www.iot-solution.com
Modbus to MQTT IoT Gateway
-BL101
4.1.2 Search for Device
Click Device Search to get all devices which are in the same local area network with
PC. If no device is found, please follow the procedure on the right notice box to
check the root cause. Below is the example of connecting Gateway BL101 with
switch through WAN. A device with IP 192.168.1.165 is searched out.