THE NEW GENERATION LORAWAN SENSORS OF SENSECAP S210X Sensors User Guide Version: v1.0.
Table of Contents 1. Product Introduction ................................................................................... 4 2. Part List ........................................................................................................ 5 3. Key Parameters of the Sensor .................................................................... 6 4. LED of Sensor Working Status ................................................................... 7 5. SenseCAP Mate App .............................
6.3.3 Bind Sensor to SenseCAP Portal .............................................................................. 30 6.3.4 Setup the Sensor ....................................................................................................... 30 6.3.5 Set Frequency of Sensor via SenseCAP Mate App .................................................. 30 6.3.6 Check Data on SenseCAP Portal ............................................................................. 31 7. Connect to Helium Network ..
12.2 Why is the new sensor’s battery not 100%? ..................................................... 53 12.3 Support............................................................................................................. 53 12.4 Document Version ............................................................................................
IoT into the Wild 1. Product Introduction Among the first launch of Seeed Industrial IoT product series, SenseCAP is focusing on wireless environmental sensing applications: smart agriculture, precision farming, smart city and so on. It consists of hardware products (sensors, data-loggers & gateways, etc.), software services (SenseCAP portal, mobile App, open dashboard), and API for device & data management.
IoT into the Wild 2. Part List Before installing, please check the part list to ensure nothing is missing.
IoT into the Wild 3. Key Parameters of the Sensor Using the LoRaWAN protocol generally involves the following parameters. Parameters Description LoRaWAN MAC Version v1.0.3 OTAA (Default) Join Type ABP (It can be modified via App) Device EUI Unique identification of device, one of the join network parameters on OTAA mode. (It can be got via App) Device Code (KEY) On the device label, for device binding and API call.
IoT into the Wild 4. LED of Sensor Working Status You can refer to the LED indicator for the Sensor Node for its working status. Please see the status explanations in the chart below: Actions Description Green LED Status LED flashes at 1s frequency, waiting for Bluetooth connection. First power up, press and hold for 3s Power on and activate the Bluetooth If Bluetooth not connected within 1 minute, the machine would shut down again. 1. The LED will be on for 5 seconds for initialization 2.
IoT into the Wild 1. Waiting for Bluetooth connection: LED flashes at 1s frequency Press and hold for 3s Activate Bluetooth again 2. Enter configuration mode after Bluetooth connection is successful: LED flashes at 2s frequency If Bluetooth is not connected within 1 minute, the device will reboot and join LoRa network. Press and hold for 9s Power off In the 3rd seconds will start flashing at 1s frequency, until the light is steady on, release the button, the light will go out. Note: 1.
IoT into the Wild 5. SenseCAP Mate App 5.1 Download App As a tool, SenseCAP Mate App is used to config LoRa parameters, set interval, bind devices to your account and check device basic information. (1) For iOS, please search for “SenseCAP Mate” in the App Store and download it. (2) For Android, please search for “SenseCAP Mate” in the Google Store and download it. You can also download App from https://www.pgyer.
IoT into the Wild 5.2 How to connect sensor to App 5.2.1 Create a New Account SenseCAP Mate supports device configuration and remote management. To use the SenseCAP Portal platform and other functions, please register an account. SenseCAP Mate supports offline functionality, and you can opt out of an account if you only use the configuration sensor. Just click Skip. Please select Global of Server Location. You can also create an account via the SenseCAP Portal: http://sensecap.seeed.
IoT into the Wild 5.2.2 Connect to Sensor to App 1) Press button and hold for 3 seconds, the LED will flash at 1s frequency. Please use the App to connect the sensor within 1 minute; otherwise, the device will power off or reboot. 2) Please select “S210X Sensor”, it includes S210X series products. Please click the “Setup” button to turn on Bluetooth and click “Scan” to start scanning the sensor's Bluetooth. 3) Select the Sensor by S/N (S/N is on the front label of the sensor).
IoT into the Wild 4) Enter configuration mode after Bluetooth connection is successful: LED flashes at 2s frequency.
IoT into the Wild 5.3 Configure parameters through App 5.3.1 Select the Platform and Frequency S210x Sensors are manufactured to support universal frequency plan from 863MHz ~928MHz in one SKU. That is to say, every single device can support 7 frequency plans. Platform Description Default platform. SenseCAP for The Things Network It must be used with SenseCAP Outdoor Gateway (https://www.seeedstudio.com/LoRaWAN-Gateway-EU868-p4305.html ).
IoT into the Wild 1) SenseCAP for Helium: We provide the SenseCAP Portal to manage devices and data: sensecap.seeed.cc We built a private Helium Console with an embedded SenseCAP Portal. When users get the SenseCAP sensors, you can use it by scanning the code and binding it to the Portal. “SenseCAP for Helium” is selected by default. The device runs in a fixed main frequency and sub-band, refer to Helium Frequency Plan (https://docs.helium.com/lorawan-onhelium/frequency-plans/ ).
IoT into the Wild AU915 Need to contact sales to purchase. AS923-1 Need to contact sales to purchase. AS923-2 Need to contact sales to purchase. 3) Helium Users can choose sensors to use on the public helium console: https://console.helium.com/ 4) The Things Network Users can choose sensors to use on the public The Things Network server: https://console.cloud.thethings.network/ 5) Other Platform: When you use other LoRaWAN network server, please select Other Platform.
IoT into the Wild Name EU863-870 EU868 -------- US902-928 US915 Sub band from 1 to 8 (default sub-band 2) AU915-928 AU915 Sub band from 1 to 8 (default sub-band 2) KR920-923 KR920 -------- IN865-867 IN865 -------- AS923-1 AS923-2 AS923 Frequency plan for Helium AS923-3 AS923-4 RU864-867 RU864 -------- Note1: Different countries and LoRaWAN network servers use different frequency plans. For Helium network, please refer to: https://docs.helium.
IoT into the Wild 5.3.2 Set the Interval The working mode of device: wake up the device every interval and collect measurement values and upload them through LoRa. For example, the device collects and uploads data every 60 minutes by default. Parameter Type Uplink Interval Unit: minutes, number from 1 to 1440. Note: The SenseCAP portal has a limit on uplink interval: minimum interval is 5 minutes. The interval using the other platforms ranges from 1 to 1440 minutes. 5.3.
IoT into the Wild 5.3.4 Set the Packet Policy The sensor uplink packet strategy has three modes. Parameter Description 2C+1N (default) 2C+1N (2 confirm packets and 1 none-confirm) is the best strategy, the mode can minimize the packet loss rate, however the device will consume the most data packet in TTN, or date credits in Helium network. 1C 1C (1 confirm) the device will sleep after get 1 received confirm packet from server.
IoT into the Wild Note: The factory defaults to a fixed value. 5.3.6 Restore Factory Setting When selecting the SenseCAP platform, you must use the fixed EUI/App EUI/App Key. Therefore, you need to restore the factory Settings before switching back to the SenseCAP platform from other platforms. When we make a mistake or want to reset everything, we can click the button. The device will be restored to the factory's default configuration.
IoT into the Wild 6. Connect to the SenseCAP Portal 6.1 SenseCAP Portal The main function of the SenseCAP Portal is to manage SenseCAP devices and to store data. It is built on Azure, a secure and reliable cloud service from Microsoft. You can apply for an account and bind all devices to this account. SenseCAP provides the web portal and API. The web portal includes Dashboard, Device Management, Data Management, and Access Key Management, while API is open to users for further development. 6.1.
IoT into the Wild 6.1.2 Other Functions Dashboard: Including Device Overview, Announcement, Scene Data, and Data Chart, etc. Device Management: Manage SenseCAP devices. Data Management: Manage data, including Data Table and Graph section, providing methods to search for data. Subaccount System: Register subaccounts with different permissions. Access Key Management: Manage Access Key (to access API service), including Key Create, Key Update, and Key Check.
IoT into the Wild 6.2 Connect to SenseCAP with Helium Network 6.2.1 Quick Start Follow this process to quickly use the sensor, see the following section for details. 6.2.2 Preparation 1) SenseCAP Mate App Download the App, please refer to section 5 for using. 2) Coverage of Helium network Option 1: Use the Helium network that already exists nearby. Please refer to the map, search your location to see if there's any helium network around: https://explorer.helium.
IoT into the Wild Option 2: Deploy a new Helium gateway. You can purchase M1, M2 gateways to cover your surroundings with the Helium network: https://www.sensecapmx.com/ 6.2.3 Bind Sensor to SenseCAP Portal Please open SenseCAP Mate App. (1) Scan QR Code 1) Click “Add device” on the upper-right corner of device page to enter the device binding page. 2) Scan the QR code on the device to bind the device to your account.
IoT into the Wild (2) Manually fill in the EUI If the QR code sticker is damaged, you can manually fill in the EUI of the device to bind the device to your account. Please make sure you put in the EUI in the format suggested by the system and then click “confirm”.
IoT into the Wild 6.2.4 Setup the Sensor 1) Open the SenseCAP Mate App 2) Press button and hold for 3 seconds, the LED will flash at 1s frequency. 3) Please click the “Setup” button to turn on Bluetooth and click “Scan” to start scanning the sensor's Bluetooth. 4) Select the Sensor by S/N (label). Then, the basic information of the sensor will be displayed after entering.
IoT into the Wild 6.2.5 Set Frequency of Sensor via SenseCAP Mate App Set the corresponding frequency band based on the frequency band of the gateway. Please refer to section 5 for detail. 1) Click the “Setting” and select the platform is “SenseCAP for Helium”.
IoT into the Wild 2) Select the Frequency Plan, if the gateway is US915, set the sensor to US915. 3) Click the “Send” button, send the setting to the sensor for it to take effect. 4) Click the “Home” button, the App will disconnect the Bluetooth connection. Then, the sensor will reboot. 5) When the device is disconnected from Bluetooth, the LED lights up for 5 seconds and then flashes as a breathing light. 6) After joining the network successfully, LED flashes fast for 2s. 6.2.
IoT into the Wild 28
IoT into the Wild 6.3 Connect to SenseCAP with private TTN 6.3.1 Quick Start Follow this process to quickly use the sensor, see the following section for details. 6.3.2 Preparation 1) SenseCAP Mate App Download the App, please refer to section 5 for using. 2) SenseCAP Outdoor Gateway Now, the sensor needs to be used with the SenseCAP Outdoor Gateway (https://www.seeedstudio.com/LoRaWAN-Gateway-EU868-p-4305.html) to transmit data to the SenseCAP Portal.
IoT into the Wild b) Bind the gateway to SenseCAP Portal. c) Ensure the gateway indicator is steady on. d) Ensure the gateway is displayed online on the portal. 6.3.3 Bind Sensor to SenseCAP Portal Please refer to the section 6.2.3 6.3.4 Setup the Sensor Please refer to the section 6.2.4 6.3.5 Set Frequency of Sensor via SenseCAP Mate App Set the corresponding frequency band based on the frequency band of the gateway. Please refer to section 5 for detail.
IoT into the Wild 2) Select the Frequency Plan, if the gateway is US915, set the sensor to US915. 3) Click the “Send” button, send the setting to the sensor for it to take effect. 4) Click the “Home” button, the App will disconnect the Bluetooth connection. Then, the sensor will reboot. 5) When the device is disconnected from Bluetooth, the LED lights up for 5 seconds and then flashes as a breathing light. 6) After joining the network successfully, LED flashes fast for 2s. 6.3.
IoT into the Wild 7. Connect to Helium Network Please refer to the manual to connect sensors to Helium public console: https://files.seeedstudio.com/products/SenseCAP/S210X/How%20to%20Connect%20Sense CAP%20S210X%20to%20Helium%20Network.pdf 8. Connect to The Things Network Please refer to this manual: https://files.seeedstudio.com/products/SenseCAP/S210X/How%20to%20Connect%20Sense CAP%20S210X%20to%20The%20Things%20Network.
IoT into the Wild 9. Payload Decoder 9.1 Decoder Code TTN payload decoding script for SenseCAP LoRaWAN: https://github.com/Seeed-Solution/TTN-Payload-Decoder/blob/master/decoder_new-v3.
IoT into the Wild 9.2 Packet Parsing 9.2.1 Packet Initialization After being powered on or reboot, SenseCAP Sensors will be connected to the network using the OTAA activation method.
IoT into the Wild 9.3 Data Parsing Example 9.3.1 Measurements List Measurements Measurement ID(HEX/DEC) Resolution Unit Air Temperature 0x1001 4097 0.01 ℃ Air Humidity 0x1002 4098 0.01 %RH Light Intensity 0x1003 4099 1 Lux CO2 0x1004 4100 1 ppm Soil Temperature 0x1006 4102 0.1 ℃ Soil Moisture 0x1007 4103 0.1 % Soil EC (Electrical Conductivity) 0x100C 4108 0.01 dS/m For the complete list, see: https://sensecap-docs.seeed.cc/measurement_list.
IoT into the Wild 9.3.2 Example – S2101 Air Temperature and Humidity Sensor Air Temperature and Humidity Sensor measurement packet: 01 0110 B0680000 01 0210 88F40000 8CFF Part Value Raw Data Description 01 is the channel number. 1 Air 01 0110 B0680000 Temperature 0110 is 0x1001(little-endian byte order), which is the measurement ID for air temperature. B0680000 is actually 0x000068B0, whose equivalent decimal value is 26800.
IoT into the Wild 9.3.1 Example – S2102 Light Intensity Sensor Light Intensity Sensor measurement packet: 01 0310 A8550200 E3E9 Part Value Raw Data Description 01 is the channel number. 01 0310 A8550200 1 3 Light Intensity CRC 0310 is 0x1003(little-endian byte order), which is the measurement ID for Light Intensity. A8550200 is actually 0x000255A8, whose equivalent decimal value is 153000. Divide it by 1000, and you’ll get the actual measurement value for Light Intensity as 153 Lux.
IoT into the Wild 9.3.2 Example – S2103 CO2, Temperature and Humidity Sensor CO2, Temperature and Humidity Sensor measurement packet: 01 0410 80140700 01 0110 F4650000 01 0210 7C7D0100 3C4D Part Value Raw Data Description 01 is the channel number. 0410 is 0x1004(little-endian byte order), which is the measurement ID for CO2. 1 CO2 01 0410 80140700 80140700 is actually 0x00071480, whose equivalent decimal value is 464000.
IoT into the Wild 9.3.3 Example – S2104 Soil Moisture and Temperature Sensor Soil Moisture and Temperature Sensor measurement packet: 01 0610 245E0000 01 0710 BCB10000 A3D9 Part Value Raw Data Description 01 is the channel number. 1 Soil 01 0610 245E0000 Temperature 0610 is 0x1006(little-endian byte order), which is the measurement ID for soil temperature. 245E0000 is actually 0x00005E24, whose equivalent decimal value is 24100.
IoT into the Wild 9.3.4 Example – S2105 Soil Moisture, Temperature and EC Sensor Soil Moisture, Temperature and EC Sensor measurement packet: 01 0610 5C5D0000 01 0710 48A30000 01 0C10 B4000000 DD0A Part Value Raw Data Description 01 is the channel number. 1 Soil 01 0610 5C5D0000 Temperature 0610 is 0x1006(little-endian byte order), which is the measurement ID for soil temperature. 5C5D0000 is actually 0x00005D5C, whose equivalent decimal value is 23900.
IoT into the Wild 9.4 Battery Information Please note the counter number. After 20 packets, it will follow one special packet with battery info. You can either ignore this packet or get rid of the battery info in your code. Original Info: 00070064000500010610B45F0000010710A41F00003259 Battery Package: 00070064000500 Example: Battery & Soil Moisture and Temperature Sensor(S2104) measurement packet: 00070064000500010610B45F0000010710A41F00003259 Part Value Raw Data Description 00 is the channel number.
IoT into the Wild measurement value for soil temperature as 24.5℃. 01 is the channel number. 3 4 0710 is 0x1007 (little-endian byte order), which is the measurement ID for soil moisture. Soil Moisture 01 0710 A41F0000 CRC 3259 A41F0000 is actually 0x00001FA4, whose equivalent decimal value is 8100. Divide it by 1000, and you will get the actual measurement value for soil moisture as 8.1% RH. The CRC verification part.
IoT into the Wild 10. LoRaWAN Downlink Command 10.1 Set the Data Uplink Interval (1) Using the Network Server’s portal or API to send downlink command, then the Node will respond to the ack. The downlink command takes effect and responds the next time the node uploads data.
IoT into the Wild Example: Set the Node’s data interval is 10 minutes.
IoT into the Wild 10.
IoT into the Wild 11. Device Installation 11.1 The Do's and Don'ts 1. Do not remove the sensor probe. Otherwise, it will cause leaks and wire fracture. If accidentally unscrewed, it needs to be tightened to ensure waterproof performance. ( like the ①②) 2. Do not open the inside of the sensor unless the battery needs to be replaced. This may result in abnormal waterproofing. If it is opened, make sure the waterproofing gasket is properly installed and tighten the screws.
IoT into the Wild 11.2 Installing Sensor 11.2.1 Installing the Sensor Bracket Specially designed for installing SenseCAP Sensors, the bracket is a sliding cap. With designated screw-holes, the bracket helps fasten the Sensor Node firmly onto a pole or a wall. 1) With the sensor in one hand and a bracket in the other, find an unobstructed direction along the back of the sensor. 2) One hand holds the clasp while the other holds the device. Pull outward with opposite force.
IoT into the Wild 11.2.
IoT into the Wild 49
IoT into the Wild 11.3 Replace the Battery 11.3.1 How to Buy the Battery We suggest buying it from Amazon. 1) EEMB ER34615: Click here 2) Search the key word: LiSOCI2 ER34615 battery. Compare the batteries that meet the following parameters. The most important thing is to match the voltage. Battery Specification Nominal capacity 19000mAh Model Li-SOCl2, ER34615 Nominal voltage 3.6V Max. continuous current 230mA Max. pulse current capability 400mA ∅ 34.0*61.
IoT into the Wild 11.3.2 How to Replace a New Battery 1) Remove three screws. Note: The sensor and PCBA are connected by wire, please disassemble carefully. 2) Install a new battery. Note: Pay attention to the positive and negative terminals of the battery.
IoT into the Wild 3) Install screws. Note: During the installation, ensure that the waterproof washer is properly installed and the screws are locked; otherwise, water will flow into the device.
IoT into the Wild 12. Trouble Shooting 12.1 Sensors can’t join LoRa network, how to do? 1) Check the gateway frequency configuration. Make sure the gateway and Sensor Node have the same uplink and downlink frequency. 2) Check the real-time log and RESET the sensor to see if there are any sensor data packets. If there are packets, check whether the gateway is sending downlink packets.