King Pigeon BL280, User Manual

Page 1: ...Preface BL280 User Manual Version V1 0 Issue Date 2021 06 15 King Pigeon Communication Co Ltd Website www iot solution com LoRa Gateway BL280 Wireless Data Collection RS485 Transparent Transmission ...

Page 2: ...y 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 BL280 is under continuous improvement this manual may be updated or revised from time to time without prior notice Please follow the instructions in ...

Page 3: ...on 12 2 4 Ethernet Port 13 2 5 SIM Card Slot 13 2 6 Power Switch Upgrading Switch 13 2 7 External Antenna 14 2 8 USB Port 14 3 Gateway Mounting 15 3 1 Wall Mounting 15 3 2 DIN Rail Mounting 15 4 Parameter Configuration 16 4 1 Preparation for Configuring the Gateway 16 4 1 1 Install USB Driver 16 4 1 2 Search for Port Number 16 4 1 3 Login to Configuration Software 17 4 2 Basic Settings 18 4 3 Ethe...

Page 4: ...dix D LoRa Node Introduction 43 WT100 RS485 Transparent Transmission Node 43 WT101 4 Digital Input Data Collection Node 44 WT102 2 Relay Output Control Node 45 WT103 AM2301 Temperature Humidity Data Collection Node 46 WT104 AM2401 Temperature Humidity Data Collection Node 46 WT105 DS18B20 Temperature Data Collection Node 47 WT106 PT100 Temperature Data Collection Node 48 WT107 Multiple environment...

Page 5: ...emperature humidity light intensity CO2 wind direction speed and soil conditions LoRa communication range is up to 2KM Built in LoRa chip SX1278 and GSM GPRS 3G 4G RJ45 module work together to achieve remote monitoring and control by sending sensor PLC smart meter and other device data to cloud or mobile phone via SMS 2G 3G 4G Ethernet Huge field wiring cost will be saved This wireless data acquis...

Page 6: ...tem LoRa Gateway BL280 1 2 Typical Application Smart greenhouse data collection and monitoring Smart orchard data collection and monitoring Smart crop land data collection and monitoring Smart Breeding Temp Humi data collection and monitoring Smart factory temp humi data collection and monitoring ...

Page 7: ...onitoring Agriculture Aquaculture and coal mine site data transmission Smart agriculture smart fire protection smart city smart building etc Other distributed site data collection and monitoring 1 3 Safety Introduction Safety Notice Please don t use this device in the place where mobile phone is prohibited Wireless Interference Please avoid wireless interference to impact GSM GPRS 3G 4G network 1 ...

Page 8: ... Communication Co Ltd www iot solution com Wireless Data Acquisition System LoRa Gateway BL280 1x mini_USB cable 1x LoRa Antenna 1x 2G 3G 4G SMA Cellular Network Antenna AT 25 1x Power Adaptor 12VDC 2A 1x User Manual Soft Copy ...

Page 9: ...Modbus TCP Modbus RTU transparent transmission and custom handshake protocol to actively connect server automatically re connect server if network disconnected Support Alibaba Cloud HUAWEI Cloud King Pigeon Cloud and other clouds with standard Modbus MQTT protocols Ethernet port has transformer isolator with 2KV electromagnetic isolation Support long range wireless data transmission with data coll...

Page 10: ...850 900 1800MHz WCDMA B1 B2 B5 B8 FDD B1 B2 B3 B4 B5 B7 B8 B28 TDD B40 4G A version WCDMA B2 B4 B5 FDD B2 B4 B12 4G V version FDD B4 B13 4G J version WCDMA B1 B3 B8 B18 B19 B26 FDD B2 B4 B12 TDD B41 4G CE version GSM EDGE 900 1800MHz WCDMA B1 B8 TD SCDMA B34 B39 FDD B1 B3 B8 TDD B38 B39 B40 B41 Protocol Modbus RTU Modbus TCP MQTT SIM UIM Card slot Standard flip cover support 1 8V 3V SIM UIM card b...

Page 11: ...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 IEC 61000 4 6 CS Level 4 IEC 61000 4 8 M S Level 4 Others CE FCC ROHS 3C Environment Working Environment 45 85 5 95 RH Storage Environment 45 105 5 95 RH Others Case Material Metal Size 88mm 75mm 30mm L W H Protection Grade IP30 Net Weight 235g Mounting Wall Mounting DIN Rail Mounting 2 Hardware In...

Page 12: ...G Normal 2s off 0 2s on 3G 4G Normal 0 2s off 1s on Off Device fault 2 Status Red Stead On External Power Supply is normal Off External power supply is lost 3 Ethernet Red Flickering Ethernet port has data transmission Off Ethernet port has no data transmission 4 RF Red Flickering LoRa RF has data transmission Off LoRa RF has no data transmission 2 3 Interface Definition Power Supply Power Supply ...

Page 13: ...en direction to push SIM card slot and then place the card into it Ethernet Port Introduction No Color Item Description 1 Orange white TX Positive of Transmitting 2 Orange TX Negative of Transmitting 3 Green white RX Positive of Receiving 4 Blue Data Positive of two way data communication 5 Blue white Data Negative of two way data communication 6 Green RX Negative of Receiving 7 Brown white Data P...

Page 14: ...n System LoRa Gateway BL280 2 7 External Antenna BL280 has 1 LoRa antenna and 1 GSM 3G 4G cellular network antenna 2 8 USB Port mini USB port is used to connect BL280 to PC for configuring parameters and upgrading firmware Power Switch Upgrading Switch GSM 3G 4G Antenna Port LoRa Antenna Port ...

Page 15: ...olution com Wireless Data Acquisition System LoRa Gateway BL280 3 Gateway Mounting This gateway supports horizontal placement on the table wall mounting and DIN Rail mounting 3 1 Wall Mounting 3 2 DIN Rail Mounting Assembling clip buckle Mounting on DIN Rail ...

Page 16: ... and upgrade firmware 4 1 Preparation for Configuring the Gateway 4 1 1 Install USB Driver Skip this process if USB driver is installed already Download BL280 configuration software and USB driver from King Pigeon website www iot solution com If any downloading issue please contact King Pigeon sales team 4 1 2 Search for Port Number Right click My Computer then click Property Device Manager Port i...

Page 17: ...oRa Gateway BL280 4 1 3 Login to Configuration Software Click to execute it and enter below page Select connected serial port input password default is 1234 and it s filled automatically click login to enter below main page If login is not successful please check USB connection password and port number ...

Page 18: ...gateway Change Password Click it to change password Original Password Original device password Null New Password Input new password Null Confirm Password Confirm new password Null Gateway Device Version Click it to read device model version IMEI cellular network signal strength Model No Device Model Version Firmware version IMEI Unique IMEI number of the communication module Battery Voltage Backup...

Page 19: ... necessary in China Null IP Mode Set static dynamic IP Static Device IP Gateway BL280 IP Address Null Local Listening Port Device port number as TCP UDP server can be custom range 0 65536 Null Subnet Mask Current Subnet Mask Null Router IP Current Router IP Address Null DNS server 1 Current DNS server 1 IP address Null DNS server 2 Current DNS server 2 IP address Null Note this gateway can be used...

Page 20: ... two way communication between gateway and host computer The advantage of MQTT is data will be saved in cache if network is lost and re transmitted once network recovers For example input cloud platform WWW MY M2M COM Domain name mqtt dtuip com port 1883 Communication Protocol Cloud Platform Item Description Default Priority Set network priority include Ethernet first Cellular network first and bo...

Page 21: ...ine Null Heartbeat Message If it s set device will send heartbeat message frequentlyaccording to the set interval Null Heartbeat ACK Message If it s set server will send Heartbeat Acknowledge Message within 6s Otherwise it will be timeout and device will send heartbeat message for reconnecting Once the re connecting times reach limit device will go offline and reconnect immediately After device go...

Page 22: ...anghai Null Uploading Interval Set interval of uploading device data to cloud minimum 10s 60s Note Alibaba cloud IOT model is under development Thus datapoint must be added one by one When adding datapoint make sure the identification mark is the same as the MQTT mark in configuration software For example if MQTT identification mark of node WT107 ID 1 temperature value is TEMP1 set the same datapo...

Page 23: ... its own unique MAC address Node can be found by its MAC address There are 12 types of nodes WT100 WT111 WT100 is transparent transmission node and the rest are data collection nodes Below is the example of configuring WT107 and WT100 Steps to add multiple data node WT107 1 Start node WT107 LED indicator will flicker once and be off Once it has paired with gateway LED indicator will be steady on 2...

Page 24: ...rigger alarm and save alarm record 0 Minimum If current value reaches lowest limit system will trigger alarm and save alarm record 0 Slave Setting Click it to save node configuration Note This is the example of node WT107 configuration For other nodes refer to Appendix B Register Address Steps to add node WT100 RS485 Transparent Transmission 1 After WT100 is started LED indicator will flicker once...

Page 25: ... Select 8 Bit 9 Bit 8 Parity Bit Select None Even Odd None Stop Bit Select 1 Bit 2 Bit 1 Salve WT100 Click Slave WT100 to save configuration setting 4 6 Wireless Node Management User can view all node setting and register information Below page is the information of nodes already paired with gateway Wireless Node Management Item Description Default Read All Nodes Device Setting Click to read all c...

Page 26: ...he table Export Record Export historical records to XML format file Delete Device Record Delete all historical records and alarm events Start to save data from the first new record Note The temperature and other data in above table is only the data collected by WT107 If it s not WT107 the data will be different For example if it s WT108 then the value is soil PH For other data type please refer to...

Page 27: ... not WT107 WT101 and WT102 have no alarm records the data will be different For example if it s WT108 then the value is soil PH For other data type please refer to Appendix B Register Address 5 SMS Command This device supports remote configuration inquiry and control with SMS For details please refer to Appendix A SMS Command List Below are the tips 1 Gateway default password is 1234 and can be ch...

Page 28: ...geon Cloud SCADA an other host computers through cellular and Ethernet network It has various nodes for collecting different data Below is the diagram of node and register mapping relationship For node collecting sequence please refer to Appendix B Register Address 6 1 Modbus RTU Protocol 1 Function code 04H 0x04 read input register read node WT107 data is air temperature humidity light intensity ...

Page 29: ... register parameter 0131H 305 temperature 30 5 C 0244H 580 humidity 58 0 RH 00C8H 200 light intensity 200 ILL 019AH 410 Co2 concentration 410 ppm 0006H 6 TVOC concentration 6 ppb 01C2H 450 soil temperature 45 0 C 01F4H 580 soil humidity 50 0 RH CRC Check 2 B3 B6H Check according to actual requirement low byte is in front 2 Function code 01H 0x01 read coil status read WT102 2 DO for control output ...

Page 30: ...eck according to actual requirement low byte is in front Remark Max 200 registers of digital input status can be read If more than that it s invalid Each WT101 has 4 digital inputs The corresponding Modbus address is ID 1 4 for example if the starting address of node WT101 with ID 1 is 0 then the starting address of ID 2 is 4 Return Message Format Content Byte Qty Data Sent Remark Device Address 1...

Page 31: ...0H Same as data sent Command Counter 1 Fixed character 1 00H Fixed format fixed character Fixed character 1 00H Fixed format fixed character Following message size 1 00 11H Same as following message byte size Following message size 1 01H Device 01 same as data sent Device Address 1 Function Code 1 04H Read input register Return Byte Size 1 0EH Data N 8 N 8 N is the qty of register to be inquired R...

Page 32: ...vice Address 1 Function Code 1 01H Read coil register Return Byte Size 1 02H Data 2N N is the qty of register to be inquired Return Data 2 01 00H Every 8 bits form 1 byte Low byte is in front 3 Function code 02H 0x02 read discrete input status read node WT101 with 4 digital inputs Message Format Sent from server master station Content Byte Qty Data Sent Remark Command Counter 1 00 00H Every time a...

Page 33: ...is in front 6 3 MQTT Protocol Gateway BL280 supports standard MQTT protocol support Modbus RTU to MQTT and can be connected to cloud platform easily More details can be viewed from Appendix C MQTT Application 7 Firmware Upgrading This device has modular design If there s any network upgrading from telecommunication service provider it s not necessary to change the complete hardware but only commun...

Page 34: ...te xxxxxx is year month date and yyyy is hour minute Each property has 2 bits If it s 1 bit then add 0 in the front For example set device time to be 12 30 Oct 8 2016 the command is 1234D161008T1230 Inquire Device Status Action Command Return Message Inquire Password EE Time Device ID IMEI Cellular Network Signal Strength External Power Supply Normal Power Lost Model Number Version Description Set...

Page 35: ...t Note ETHIP are fixed characters Local IP Port Inquire Password ETHIP Same as above Delete Password ETHIPDEL Same as above i e value is null Set Device Restart Action Command Return Message Set Password REBOOT Device is rebooted successfully Reset to Factory Setting Action Command Return Message Set Password RESET Device is returned to factory setting successfully Inquiry Register Current Value A...

Page 36: ...40004 TVOC Concentration 16 bit int Y X 9C 45 40005 Soil Temperature 16 bit int Y X 10 9C 46 40006 Soil Humidity 16 bit int Y X 10 9C 47 40007 Node 2 Air Temperature 16 bit int Y X 10 9C 48 40008 Air Humidity 16 bit int Y X 10 9C 49 40009 Light Intensity 16 bit int Y X 9C 4A 40010 CO2 Concentration 16 bit int Y X 9C 4B 40011 TVOC Concentration 16 bit int Y X 9C 4C 40012 Soil Temperature 16 bit int...

Page 37: ...Humidity 16 bit int Y X 10 Soil PH 16 bit int Y X 100 Soil EC 16 bit int Y X Soil Nitrogen 16 bit int Y X Soil Phosphorus 16 bit int Y X Soil Potassium 16 bit int Y X WT111 Temperature 16 bit int Y X 10 Humidity 16 bit int Y X 10 Light Intensity 16 bit int Y X Wind Speed 16 bit int Y X 10 Wind Direction Value 16 bit int Y X Wind Direction 16 bit int Y X In remark column the definitions of the vari...

Page 38: ...nly for node WT102 if it s not WT102 the read value is 0 When node ID is n the corresponding mapping address is n 1 2 if it s not WT102 ID then the read value is 0 3 Node WT101 has 4 digital inputs BL280 gateway can read it with function code 02 Mapping Address Data Name Data Type Remark Hexadecimal Decimal 00 0 Node 1 1st digital input data DI 0 Bool Dry contact External open 0 External closed 1 ...

Page 39: ...me and other small size equipment MQTT runs through TCP IP or other network protocols to provide orderly lossless and bi directional connection 2 MQTT Principle There are 3 identities in MQTT protocol Publisher Broker Subscriber Both message publisher and subscriber are clients Message broker is server Message publisher can be subscriber at the same time Below is the example of connecting Gateway ...

Page 40: ...mber 7 MQTT User Name Account for device to publish topic in broker server King Pigeon Cloud 2 0 MQTT user name is MQTT 8 MQTT Password Account Password for device to publish topic in broker server King Pigeon Cloud 2 0 User Password is MQTTPW Once configuration is done client will initiate connection to server CONNECT Client sends one CONNECT request message to server CONNACK Server responds with...

Page 41: ...recovery mark this mark only appears when there s alarm and data recovery Otherwise it s not included in scheduled uploading data retransmit enable historical data mark this mark only appears when there s data re transmission It s not included in real time data Note read write mark character is flag following is read write mark of node collecting datapoints Data type value following are the data t...

Page 42: ...ad write mark down down Data mark sent from cloud platform Note Cloud platform sensor ID the character is sensorsID followed by ID number ID is automatically generated by cloud platform Data type value It has following data types 1 Digital datat the character is switcher followed by 0 or 1 0 represents open 1 represents closed 2 Numeric data the character is value followed by actual value Read wri...

Page 43: ...r voltage BATx Value Read only True Value Original Value 10 Note lower case letter x is node ID for example TEMPx means TEMP1 It s the temperature of node with ID 1 Node power voltage only exists in node WT103 WT104 WT105 and WT106 In Alibaba Cloud and HUAWEI Cloud the true value actual value Different nodes collect different data Details can be viewed from Appendix B Register Address 13 Appendix ...

Page 44: ...ud rate 9600 data bit 8 parity bit none 1 can be adjusted Work Mode Transparent Transmission Multiple WT100s can communicate with each other Serial Port Cache 200bytes Communication Frequency 402MHz 500MHz 860MHz 930MHz 860MHz 930MHz860MHz 930MHz Working Environment Temperature 10 70 humidity 95 LoRa Antenna External SMA antenna with inner pin and screw thread 433MHz 868MHz 915MHz optional Waterpr...

Page 45: ... 2 Relay Output Control Node Introduction Wireless Remote Control Node WT102 has 2 Relay outputs It works with LoRa Gateway BL280 to realize remote wireless control It s widely used in various industrial automation control systems Product Features Private LoRa communication protocol for simple safe and reliable connection Parameters can be set in BL280 configuration software Unique physical addres...

Page 46: ...ly Low power consumption scheduled automatic wake up and reporting data from sleep mode Smart transmitting mechanism to auto adjust next transmission according to node number once it s configured with Gateway Real time battery voltage can be sent to prevent data loss caused by battery shortage Parameter Specification Temperature Range 40 80 Precision 1 Humidity Range 0 100 RH Precision 4 5 Working...

Page 47: ...enna with inner pin and screw thread 433MHz 868MHz 915MHz optional Communication Range 2km open area Waterproof Grade IP65 Outline Dimension 101mmX69mmX39mm Packing List WT104Node x1 LoRa Antennax1 WT105 DS18B20 Temperature Data Collection Node Introduction Wireless LoRa Node WT105 use sensor DS18B20 to collect temperature data DS18B20 is a commonly used temperature sensor with compact size low co...

Page 48: ...cument Product Features Private LoRa communication protocol for simple safe and reliable connection Parameters can be set in BL280 configuration software Unique physical address to be identified from other nodes easily Automatic shifting from Working Mode to Low Power Consumption Mode based on power voltage Smart transmitting mechanism to auto adjust next transmission according to node number once...

Page 49: ...ion Temperature Range 40 125 Precision 0 5 Humidity Range 0 100 RH Precision 5 Light Intensity Range 1 65535lx Precision 20 CO2 Measurement Range 400 60000ppm Range 400 1479ppm Precision 1ppm Range 1479 5144ppm Precision 3ppm Range 5144 17597ppm Precision 9ppm Range 17597 60000ppm Precision 31ppm TVOC Measurement Range 0 60000ppb Range 0 2008ppb Precision 1ppb Range 2008 11110ppb Precision 6ppb Ra...

Page 50: ...Power Consumption Standby 44mA 12VData communication 106mA 12V LoRa Antenna External SMA antenna with inner pin and screw thread 433MHz 868MHz 915MHz optional Communication Range 2km open area Waterproof Grade IP65 Outline Dimension 101mmX69mmX39mm Packing List WT108Node x1 LoRa Antennax1 WT109 Soil EC Data Collection Node Introduction Wireless LoRa Node WT109 is used to collect soil EC value i e ...

Page 51: ...ed for high precision and stable output It s commonly used for soil parameters collection in scientific experiment greenhouse orchard water sewage and foodstuff storage area Product Features Private LoRa communication protocol for simple safe and reliable connection Parameters can be set in BL280 configuration software Unique physical address to be identified from other nodes easily Smart transmit...

Page 52: ...Product Features Private LoRa communication protocol for simple safe and reliable connection Parameters can be set in BL280 configuration software Unique physical address to be identified from other nodes easily Low power consumption scheduled automatic wake up and reporting data from sleep mode Smart transmitting mechanism to auto adjust next transmission according to node number once it s config...