User Manual Sensor Hub - 4G Data Logger User Manual Version: V3.0 Page 1 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved. solution.seeedstudio.
User Manual Table of Contents 1. 2. 3. 4. 5. Product Introduction ........................................................................................................................................... 4 Quick Deployment Guide ..................................................................................................................................... 6 Connect Sensor Hub to SenseCAP Cloud Platform ..................................................................................
User Manual 6. 7. 5.3.1 Add a Measurement Type .......................................................................................................... 34 5.3.2 Add Sensor Type ........................................................................................................................ 35 Troubleshooting and Log Analysis ..................................................................................................................... 37 Common Abnormality Debugging .......................
User Manual 1. Product Introduction SenseCAP is an industrial-grade sensing network system that enables low-power environmental data acquisition. The system consists of reliable and easy-to-use hardware products, software and cloud services. SenseCAP currently includes a product family of Sensor Hub 4G Data Logger & Sensors; and SenseCAP LoRaWAN Gateways & Sensors, etc. The Sensor Hub series consists of Sensor Hub Data Logger and Sensors.
User Manual Key Features: ⚫ ⚫ ⚫ Support collection of various environmental data simultaneously (up to 32 sensors with four RS485 interfaces and splitters) Support using with standard Modbus-RTU RS485 sensors Strong compatibility, supporting both 5V and 12V to power the sensors The device supports offline data caching at least 10000 measurements.
User Manual 2. Quick Deployment Guide For quick deployment, here we are listing the main steps. Please refer to the following chapters for more details. Connect Sensor Hub to SenseCAP Cloud Platform 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 1) 2) Unpack, refer to the packing list and check whether there are missing parts. Bind the device using the SenseCAP APP by scan the QR code on Sensor Hub. Install the SIM card: Use the Allen Hex Key to open the cover of the device and insert the SIM card.
User Manual Connect Sensor Hub to 3rd-party Sensors and Servers 1. Unpack, refer to the packing list and check whether there are missing parts. 2. Install the SIM card: Use the Allen Hex Key to open the cover of the device and insert the SIM card. 3. Install the antenna. 4. Download Sensor Hub Configuration Tool, connect the device (via port B6) to computer with a USB-to-TTL cable. 5. Install the driver, access the above-download tool, and power on the device by pressing the switch (B5).
User Manual 3. Assemble the Device This chapter mainly describes the basic assembly process. Before installing the device, please check the packing list and make sure there are no missing parts. Device Packing List (Sensor Hub). Number Parts Number 1 Sensor Hub 1 2 Antenna 1 3 Power Adapter 1 4 USB Serial Tool 1 5 Allen Hex Key and M5 Self-drilling Screw 6 Mounts 4 7 Ferrules 2 8 Aluminum Mounts 2 1/8 Page 8 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved.
User Manual Device Interface Introduction A4: Antenna connector. 1 to 4: RS-485 channel ports for sensor (Channel Number: 1, 2, 3, 4 from left to right, up to down). B5: Power switch and status indicator. B6: two functions in one: (1) power supply port, (2) serial port. Install the SIM card ⚫ Remove the six screws from the top cover with the Allen Hex Key (included in the package) and open the lid.
User Manual Note: When installing the cover screws, be sure to lock the screws tight, or it may affect the water resistance of the device! Install the Antenna Remove the plastic cap from the antenna connector and screw the antenna clockwise. Note: Do NOT connect the power supply when installing the antenna, as this may cause damage to the antenna circuit! Connect the Sensors Unscrew the protective cover of the connector and plug the sensor into the RS-485 connector. Note: 1.
User Manual Configure APN Please refer to section 4. Connect the Power Cord Unscrew the protective cover of the power supply connector, plug one end of the power extension cord into the power connector and tighten it, plug the other end of the power extension cord directly into the power adapter. Page 11 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved. solution.seeedstudio.
User Manual 4. Configure the Device to Connect to SenseCAP Cloud Platform Before you deploy and install the devices, make sure that your device is working properly and uploading data. Bind the Device 4.1.1 Create an account Create your account at https://sensecap.seeed.cc 4.1.2 Download the App ⚫ For iPhone users: search for "SenseCAP" at the App Store to download. ⚫ Android: download the App at http://sensecap-app-download.seeed.cn Or simply scan the QR code below to download.
User Manual Prepare Tool 4.2.1 Sensor Hub Configuration Tool Download the Sensor Hub Configuration Tool from GitHub: https://github.com/Seeed-Solution/SenseCAP-Sensor-Hub-Configuration-Tool-NG/releases For MacOS, please install: SenseCAP-Sensor-Hub-Configuration-Tool-X.X.X dmg For Windows, please install: SenseCAP-Sensor-Hub-Configuration-Tool-X.X.exe Page 13 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved. solution.seeedstudio.
User Manual Note: The software may be updated, please download the latest version of the software. 4.2.2 USB-to-TTL Cable and Driver Installation USB-to-TL serial cable: The aviation connect (blue part) is connected to the power port (B6) of Sensor Hub Data Logger and the USB port is connected to the computer. Install the driver: https://github.com/Jenkinlu001/SenseCAP/tree/master/Drivers Page 14 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved. solution.seeedstudio.
User Manual Configuration Tool Introduction Access the SenseCAP Sensor Hub Configuration Tool on your computer: ① Select the serial port number. ② The device modes include: (1) Working mode and (2) Configuration Mode: Page 15 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved. solution.seeedstudio.
User Manual Unchecked: Device is in the normal working mode, the device starts normally and collects data, you can view the device real-time operation log. Checked: The configuration mode is activated, and various parameters can be configured after the device is started. ③ To connect: after selecting the serial port number and checking the configuration mode, click "Connect".
User Manual (4) Click "General Settings" and the configuration interface will pop up. 4.4.1 Device EUI and Data Upload Interval Modifications ① Device EUI: The device's unique number, corresponding to the device label, is 16 bits long. ② Card ICCID: SIM card ICCID (readable only in working mode). Signal RSSI: Cellular (readable only in working mode). Page 17 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved. solution.seeedstudio.
User Manual Data Interval: The interval between each data upload, with a minimum of 5 minutes. After modification, you need to click "Write" to take effect. Battery: The remaining power of the built-in lithium battery. (Change to upload data every 10 minutes) 4.4.2 MQTT Server Configuration When you access the General Settings, some commands are shown at the right window of the main interface. Page 18 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved. solution.seeedstudio.
User Manual (1) Select the cloud platform: Click to enter commands directly at the green cursor below the main interface. Enter the lowercase letter: b Tip Input: 1 is the SenseCAP cloud platform (default); 2 is the user's third-party MQTT server; 3 is a SenseCAP private deployment; To configure the user's own server, please enter the command 2 and press Enter. Page 19 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved. solution.seeedstudio.
User Manual As shown in the image, it has switched to the new cloud platform 2. (2) Type in server address, port number, etc. ③ Server Address, Server Port: To upload the Data to the user's own server, the IP/domain name and port number are configured. Username / Password: If there is verification code, fill it in. Note: After completing the parameters, make sure to click "Write".
User Manual 4.4.4 APN Configuration ⑤ APN, APN username, APN password: Type in your SIM Card’s APN information. 4.4.5 Read and Write button and Clear Data. ⑥ Hardware/Software version: You can view the version info of the device (readable only in working mode). ⑦ Read: After the Write configuration, click Read to check if the information is in effect. Write: After modifying any parameters, you must click "Write" to save the information.
User Manual View Data and Device Status on SenseCAP Cloud Platform Sign in to your account at https://sensecap.seeed.cc Click on the "Table" to see if the data has been uploaded normally. Instructions for SenseCAP Cloud Platform The main function of SenseCAP Cloud Platforms is managing devices and data. The cloud service is built on a secure and reliable cloud services. Users can bind devices to a designated account for convenient management. SenseCAP provides a web portal and API data interface.
User Manual API Instructions SenseCAP API is for users to manage IoT devices and data. It combines three types of API methods: HTTP protocol, MQTT protocol, and Websocket protocol. • With HTTP API, users can manage all devices, to get RAW data or historical data. • With MQTT API, users can subscribe to the sensors’ real-time measurement data through the MQTT protocol. • With Websocket API, users can get real-time measurement data of sensors through Websocket protocol.
User Manual 5. Add a Custom Sensor After exiting the General Settings, press the device switch again to enter Sensor Settings. Once you have entered the configuration interface, click Read to get the current device configuration information. Page 24 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved. solution.seeedstudio.
User Manual Sensor Categorization As shown in the image, the sensors are divided into two categories: (1)"Custom sensors” and (2) "built-in support" sensors. 5.1.
User Manual Add a Custom Sensor (Example: Soil Temperature & Moisture Sensor) 5.2.1 Preparation Prepare the sensor: Soil Temperature & Moisture sensor, 5V, Modbus address as 128. Solder the aviation connector to the sensor: follow the wire number/sequence, and soler the aviation connector to the sensor . When connecting to a custom sensor, users need to solder the aviation connector to the sensor by following the wire number/sequence below.
User Manual (2) Click on "+", to add a new sensor (3) Configure the sensor’s basic information: ① Modbus Address: you can define the sensor’s address in the range of [128, 254]. The chosen soil temperature and moisture sensor has been configured as 128, so enter 128 here. ② Power Voltage: Sensor Hub supports 12V and 5V power supply. The chosen soil temperature and moisture supports 5V power supply, so select 5V here.
User Manual resumes when it wakes up to collect data. Always-On: The sensor is in constant power supply no matter Sensor Hub is in “sleep” or “wakeup” mode. The soil temperature and moisture sensor does not require constant power supply, so choose " Periodic ". Note: 1. Usually the device is " Periodic ", except for some special sensors, such as rain gauge, evaporation and other sensors need constant power supply. 2. Sensor Hub’s each port (1~4) can support access to sensors with the same Modbus address.
User Manual (2) Configure Measurement Value: Measurement Soil Temperature Value Soil Moisture Value Register Address (decimal) 0 1 Measurement Type INT16/ read-only INT16/ read-only Modbus Function Code Measurement Range and Description 3 -4000- +8000 Divide by 100 to get the actual temperature value, 2 decimal places, unit: °C 3 0-10000 Divide by 10000 to get the actual humidity value, 2 decimal places, unit: % Page 29 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved.
User Manual ① Measurement ID: The unique ID of the sensor's custom measured value, the value is an integer, and the range is [5500, 5999] and [4097, 4099]. For example, set the ID of the measured value of soil temperature to 5500, that is, 5500 represents the value of soil temperature. ② Function Code: Modbus function code, supports 03 and 04 function code. ③ Register Address: The register address of the measured value in the sensor, which is an integer.
User Manual Note: After you have configured the parameters, be sure to click Write. 5.2.4 Sensor Test Tip: After configuring the parameters, make sure that the sensor is connected to the device port before powering on. And if not, turn off the power and connect the sensor before re-entering the Sensor Configuration Interface. Click the test button to see the test results: 5500(soil temperature value) = 26.88, 5501(soil moisture) =0.00, and check if it is correct.
User Manual (2) Click "Disconnect" and then "Connect." Turn Sensor Hub back on and the device goes into working mode. On the right side of the main interface, you can see the real-time running log. After the device is working for a while, you can see the actual data and send prompts. For an explanation of the detailed log, you can view at the 7 chapter of Log Analysis. Page 32 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved. solution.seeedstudio.
User Manual Now you can view the data on the SenseCAP cloud platform or your own server and confirm that the data is uploaded correctly. Page 33 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved. solution.seeedstudio.
User Manual Add Custom Measurement Types and Sensor Type IDs to the SenseCAP Cloud Platform The measurement value ID and the sensor type ID are defined in the Sensor Hub Configuration Tool above. The cloud platform supports adding measurement type and sensor type ID for user’s convenient management. 5.3.1 Add a Measurement Type (1) Once you're on the cloud platform, click "Custom Type" in the left function bar, and then click "Measurement".
User Manual soil moisture measurement ID is 5501 and unit: %: (3) Complete adding measurement type. 5.3.2 Add Sensor Type (1) Select the "Sensor Type". The sensor ID of soil temperature and moisture is defined as 6000, the measurement value is soil Page 35 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved. solution.seeedstudio.
User Manual temperature 5500,soil moisture 5501; Fill in sensor type ID:6000 and select the measurement (multiple options) in the list. (2) Complete adding the Type IDs. The measurement type, units, and so on are displayed for the added custom sensor. Page 36 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved. solution.seeedstudio.
User Manual 6. Troubleshooting and Log Analysis Common Abnormality Debugging 6.1.1 Abnormal Channel Status A normal or abnormal channel is used to describe whether the RS485 physical link is working. That is: (1) When communication timeouts occur for all measurements of a sensor, the channel is set to abnormal; (2) When a sensor has at least one measured value that gets transmitted (no matter if it is an error code or data returned by the sensor), the channel status is normal 6.1.2 Error: No sensor found.
User Manual Log Analysis The user can view the logs in the Sensor Hub’s working mode through the Sensor Hub Configuration Tool. When abnormal activity occurs, it can be diagnosed through the log. Enter working mode and print the hardware and software version:
User Manual # HW VER: 3.1.0 # CLOUD:1 # EUI:2CF7F16924410088 # APPKEY: 656A1B1A98EA1846037A1FA34A831572 # PERIOD:5min # SWITCH:[GPS:0, OTA:0, INFO OTA:0, LOG:1] # Unsent packet: 0 Detect net module... Detected EC25 module elsepse: 12s. register network ok,elsepse: 14s. // Successful networking [2021/03/08 17:04:07] syn time successful // Synchronization time was successful Check the list of sensor information [2021/03/08 17:04:07] Check that the sensor infor is up to date...
User Manual channel: 20, saddr: 0, sensorID: 0x0000, status: IDLE channel: 21, saddr: 0, sensorID: 0x0000, status: IDLE channel: 22, saddr: 0, sensorID: 0x0000, status: IDLE channel: 23, saddr: 0, sensorID: 0x0000, status: IDLE channel: 24, saddr: 0, sensorID: 0x0000, status: IDLE channel: 25, saddr: 0, sensorID: 0x0000, status: IDLE channel: 26, saddr: 0, sensorID: 0x0000, status: IDLE channel: 27, saddr: 0, sensorID: 0x0000, status: IDLE channel: 28, saddr: 0, sensorID: 0x0000, status: IDLE channel: 29, s
User Manual [MQTT] +QMTOPEN result: 0 [+QMTOPEN] elapse: 319 ms [MQTT] +QMTCONN result: 0 elapse: 5s >ST DOWNLINK CFG [MQTTSubscribe] elapse: 304 ms [MQTT] +QMTSUB msgid: 2, result: 0 Can't receive config message [MQTTUnSubscribe] elapse: 184 ms [MQTT] +QMTUNS msgid: 3, result: 0 elapse: 4s >ST SEND ST [MQTTPublish] elapse: 235 ms [MQTT] +QMTPUB MsgId: 4, result: 0 send status successful elapse:0s >ST SEND CH [MQTTPublish] elapse: 249 ms [MQTT] +QMTPUB MsgId: 5, result: 0 send channel info successful elapse
User Manual 7. Do’s & Don’ts Low Temperature Environment Precautions (MUST-READ for Built-in Battery Version). Battery normal discharge temperature range: -20 °C to 60 °C Battery normal charging temperature range:0 °C to 45 °C Note that if the Sensor Hub you use has a built-in lithium battery, when powered by solar energy or a DC power adapter: 1) If the ambient temperature is below zero, the battery will stop charging and resume charging only when the temperature is higher than 0℃.
User Manual Installation Guide – Sensor Hub Data Logger (1) Install the aluminum pads on the back of the data collector. (2) Install the hoops and mount the collector to the pole. (3) When connecting the aviation connectors, align the widest groove on the male head to the position of the flat head, insert and tighten. Page 43 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved. solution.seeedstudio.
User Manual flat head widest groove widest groove Note: If installing the devices outdoors for a long time, it is recommended to use a threaded tube to protect the exposed cables and increase their service life. Page 44 of 45 © 2008-2021 Seeed Technology Co., Ltd. All rights reserved. solution.seeedstudio.
User Manual Installation Guide - Solar Panels Solar panel screw bracket (1) Mount the bracket to the solar panel. (2) Install the solar panel through the U-hoop of the bracket to the pole (recommended pole diameter 76mm). Note: 1. Solar panels must face the direction which accumulates the strongest & longest duration sunlight in the day. 2. Do not have any shields around the solar panel. 3.