Seeed SenseCAP Adaption Manual

Sensor node, how to work with 3rd-party lorawan gateways & servers
Hide thumbs Also See for SenseCAP:

Advertisement

【Technical Document】
SenseCAP Sensor Node Adaption Guide
How to Work with 3
-party LoRaWAN Gateways & Servers
rd
Version: V1.0
1 / 38
© 2008-2019 Seeed Technology Co., Ltd. All rights reserved.
www.seeed.cc

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SenseCAP and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Seeed SenseCAP

  • Page 1 【Technical Document】 SenseCAP Sensor Node Adaption Guide How to Work with 3 -party LoRaWAN Gateways & Servers Version: V1.0 1 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 2: Table Of Contents

    4.2.3 Channel Settings ..........................15 Please refer to the items in the following image for channel settings............15 LoRaWAN Device Registration ....................... 17 Packet Parsing ..............................21 Appendix-Code ................................25 2 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 3: Overview

    SenseCAP LoRaWAN Gateway, please kindly refer to https://sensecap.seeed.cc. SenseCAP Sensor Nodes uses OTAA (Over The Air Activation), so theoretically three credentials (EUI, App EUI, App Key) are needed to configure and adapt the SenseCAP Sensor Nodes to your LoRaWAN network.
  • Page 4: Retrieve Sensecap Credentials

    【Technical Document】 2. Retrieve SenseCAP Credentials Device EUI is on the SenseCAP product label. Mark down the Device EUI and Device Code (as shown in the image above) for future uses. Use HTTP API to retrieve App EUI and App Key. You can use any HTTP tools or browser to issue an HTTP GET request.
  • Page 5: Power On The Device

    (3) Stay OFF to save power consumption after joining the network. (4) After it’s on for 15s, if the LED doesn’t flash quickly, press RESET to rejoin the network. 5 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 6 When the device is working in the ultra-low-power consumption mode, it can keep working for a while after being shut down, which will lead to reboot failure if it’s powered on and off within a short interval. 6 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 7: The Things Network Configuration

    OTAA. There are various plans and regulations for LoRaWAN frequencies in different regions. SenseCAP Sensor Nodes comply with The Things Network Frequency Plans. To speed up the connection, we reduced SenseCAP Sensor Nodes’ channels in US902-908 and CN470-510.
  • Page 8: Gateway Network Settings & Registration On Ttn

    2) Enter the Web back end. Access http://10.130.1.1/ on a browser of your PC, and you will be directed to the log-in page. Username: root Password: dragino 8 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 9 If it’s successful in network access, you can see the network status by the following path:“Network”=> “WAN” => “Interfaces - WAN”. Check network validity by this path: “Network”=>“Diagnostics”=>“Ping”. If it shows info as in the image below, the network is working. 9 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 10: Gateway Registration On Ttn

    1) Follow the instruction to create your account, and access “Console”. 2) Get gateway id Go back to the web back end, follow this path:“Service”=>“LoRawan Gateway”=>“Gateway ID” 10 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 11 “Europe 868MHz”, and “United States 915MHz” etc. Since the gateway we use here is 915MHz, we choose “United States 915MHz”. In Router, it will automatically choose “ttn-router-us-west”. 11 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 12 【Technical Document】 12 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 13: Configure Lps8 And Connect To Ttn

    For other items, please choose according to actual needs or choose default settings. 4.2.2 Frequency Settings For specific parameters, please refer to Appendix at the end of this document. 13 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 14 【Technical Document】 radio 0 enable√ Radio_0 frequency: 904300000 Radio_0 for tx√ Radio_0 tx min frequency: 923000000 Radio_0 tx max frequency: 928000000 radio 1 enable√ Radio_1 frequency: 905000000 14 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 15: Channel Settings

    Please refer to the items in the following image for channel settings. Check “Save & Apply”. When return to TTN, you will see the Gateway’s status is updated to “connected”. 15 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 16 【Technical Document】 16 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 17: Lorawan Device Registration

    For the Sensor Node we use here, Device EUI, App EUI and App Key are shown as in the image below. 3) Add App EUI In the afore-created Application, enter “Setting”. 17 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 18 App EUI: fill in your “app_eui” Click “Add Device” to save. 5) Power on the Sensor Node. Sensor Node’s power switch is inside the device, please turn clockwise to open the device. 18 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 19 Please note the labels on both sides should be aligned as the image below, or it will not be put back in the right way. When the Sensor Probe is connected to the Sensor Node Controller correctly, the device can upload data. 19 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 20 【Technical Document】 6) Add more sensors Please repeat steps 2) ~ 5) to add more sensors. 20 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 21: Packet Parsing

    5. Packet Parsing 1) Packet Initialization After being powered on or reboot, SenseCAP Sensor Nodes will be connected to the network using OTAA activation method. Each Sensor Node will send data packets to the server, including the following data: (1) Two all-zero payload packets, to drain pending downlink messages from the server.
  • Page 22 The rest frame types above 0x1001 are similar to 0x1001. They are measurement IDs, containing actual measure values of respective sensor. 0x1003 Light Intensity Please refer to the following documents for Measurement IDs: https://sensecap- 0x1004 22 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 23 05 00 is actually 0x0005, which is sensor power on time counter, whose equivalent decimal value is 5, indicating the sensor power consumption is reported once every 5 minutes. 23 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 24 3. The following 2 bytes show the frame type. Lookup extract the frame length. 4. Based on the frame type, you can extract and lookup the definition of each subfield content. 5. Repeat Step 2~4 to parse other sensors. 24 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 25: Appendix-Code

    /* Lora MAC channel, 125kHz, all SF, 868.1 MHz */ "enable": true, "radio": 1, "if": -400000 "chan_multiSF_1": { /* Lora MAC channel, 125kHz, all SF, 868.3 MHz */ "enable": true, 25 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 26 /* Lora MAC channel, 125kHz, all SF, 867.9 MHz */ "enable": true, "radio": 0, "if": 400000 "chan_Lora_std": { /* Lora standard channel, 250kHz, SF7, 868.3 MHz */ "enable": true, "radio": 1, "if": -200000, 26 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 27 /* TX gain table, index 3 */ "pa_gain": 1, "mix_gain": 8, "rf_power": 3, "dig_gain": 0 "tx_lut_4": { /* TX gain table, index 4 */ "pa_gain": 1, "mix_gain": 10, 27 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 28 /* TX gain table, index 9 */ "pa_gain": 2, "mix_gain": 10, "rf_power": 14, "dig_gain": 0 "tx_lut_10": { /* TX gain table, index 10 */ "pa_gain": 2, "mix_gain": 11, "rf_power": 16, "dig_gain": 0 28 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 29 "dig_gain": 0 US915 "SX1301_conf": { "lorawan_public": true, "clksrc": 1, "clksrc_desc": "radio_1 provides clock to concentrator for most devices except MultiTech. For MultiTech set to 0.", "antenna_gain": 0, 29 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 30 "chan_multiSF_3": { "desc": "Lora MAC, 125kHz, all SF, 904.5 MHz", "enable": true, "radio": 0, "if": 200000 "chan_multiSF_4": { "desc": "Lora MAC, 125kHz, all SF, 904.7 MHz", "enable": true, 30 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 31 "desc": "FSK 100kbps channel, 903.0 MHz", "enable": false, "radio": 0, "if": 300000, "bandwidth": 250000, "datarate": 100000 "tx_lut_0": { "desc": "TX gain table, index 0", "pa_gain": 0, "mix_gain": 8, "rf_power": -6, "dig_gain": 0 31 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 32 "rf_power": 10, "dig_gain": 0 "tx_lut_6": { "desc": "TX gain table, index 6", "pa_gain": 1, "mix_gain": 13, "rf_power": 11, "dig_gain": 0 "tx_lut_7": { "desc": "TX gain table, index 7", 32 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 33 "tx_lut_12": { "desc": "TX gain table, index 12", "pa_gain": 3, "mix_gain": 10, "rf_power": 23, "dig_gain": 0 "tx_lut_13": { "desc": "TX gain table, index 13", "pa_gain": 3, "mix_gain": 11, 33 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 34 "tx_freq_max": 510000000 "radio_1": { "enable": true, "type": "SX1255", "freq": 487400000, "rssi_offset": -176.0, "tx_enable": false "chan_multiSF_0": { "desc": "Lora MAC, 125kHz, all SF, 487.1 MHz", "enable": true, "radio": 1, 34 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 35 "desc": "Lora MAC, 125kHz, all SF, 486.7 MHz", "enable": true, "radio": 0, "if": 100000 "chan_multiSF_7": { "desc": "Lora MAC, 125kHz, all SF, 486.9 MHz", "enable": true, "radio": 0, "if": 300000 35 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 36 "desc": "TX gain table, index 2", "pa_gain": 0, "mix_gain": 12, "rf_power": 0, "dig_gain": 0 "tx_lut_3": { "desc": "TX gain table, index 3", "pa_gain": 1, "mix_gain": 8, "rf_power": 3, "dig_gain": 0 36 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 37 "rf_power": 13, "dig_gain": 0 "tx_lut_9": { "desc": "TX gain table, index 9", "pa_gain": 2, "mix_gain": 10, "rf_power": 14, "dig_gain": 0 "tx_lut_10": { "desc": "TX gain table, index 10", 37 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...
  • Page 38 "desc": "TX gain table, index 14", "pa_gain": 3, "mix_gain": 12, "rf_power": 26, "dig_gain": 0 "tx_lut_15": { "desc": "TX gain table, index 15", "pa_gain": 3, "mix_gain": 14, "rf_power": 27, "dig_gain": 0 38 / 38 © 2008-2019 Seeed Technology Co., Ltd. All rights reserved. www.seeed.cc...

Table of Contents