Link Search Menu Expand Document

Seedstudio - SenseCap-S2103

The SenseCap S2103 is a LoRaWAN indoor/outdoor sensor to measure temperature, humidity and CO2


Table of contents

  1. Specifications
  2. Documents/Links
  3. Ordering Info
  4. Device specific Information
    1. LED States
  5. Adding the Device to TTN
  6. Payload formatter

Specifications

  • indoor/outdoor device
  • Price ca. CHF 145.- (09.08.2023)
  • Sensors
    • Temperature, -40 … +85 [°C], ± 0.2 °C, Resolution 0.01 °C, Long term drift < 0.03 °C/year
    • relative Humidity, 0 … 100[%rH], ± 1.8, Resolution 0.01 %rH, Long term drift < 0.25 %RH/year
    • CO2, 400 … 10’000 [ppm], ±(30 ppm +3% of reading) , extended range ±10% of reading, Resolution 1 ppm
  • Power Supply: 1 Li-SOCl2, ER34615, 3.6V, 19’000 mAh
    • Expected life time: depending on usage, 5 … 10 years
  • LoRaWAN version: 1.0.3
  • LoRaWAN device class: A
  • Protection: IP66
  • Operating Temperature: 0 … +50 °C ( Effective measurement range of CO2)
  • Size: 184.2 × 63 × 63.7 mm
  • Weight: 452 g


Ordering Info


Device specific Information

LED States

2-in-1 Configuration Button and LED

ActionDescriptionGreen LED Status
First power up, press and hold for 3sPower on and activate the BluetoothLED flashes at 1s frequency, waiting for Bluetooth connection. If Bluetooth not connected within 1 minute, the device will shut downagain
Press onceReboot device and join LoRa network1. The LEDw ill be onfor 5 seconds for initialization
2. Waiting to joinLoRa network: breathing light flashing
3. Join LoRa network success: LED flashes fast for 2s
4. LoRa network joinfailure: LEDsuddenlystop.
Press and hold for 3sActivate Bluetooth again1. Waiting for Bluetooth connection: LEDflashes at 1s frequency
2. Enter configurationmode 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 9sPower offIn the 3rd seconds will start flashing at 1s frequency, until the light is steady on, release the button, the light will go out.

Note
After power off, you need to reconfigure the frequency band. Power off is recommended when not deployed.


Adding the Device to TTN

  • Configure the device via Bluetooth with the SenseCAP Mate App. See User Guide chapter 5.2 for details
  • Copy the JoinEUI, App EUI and the DevEUI and send it from the smartphone via E-Mail to your computer.
  • Before a device can communicate via “The Things Network” we have to add it to an application.
  1. Create a new application
  2. Under Overview click (+) Register device
  3. Under Input method select Select the end device in the LoRaWAN Device Repository
  4. Enter the following device information
    • End device brand select SenseCAP
    • Model select SenseCAP S2103...
    • Hardware Ver. select 1.0 or whatever is possible or on the sticker
    • Firmware select 1.0 or whatever is possible or on the sticker
      • Profile (Region) select EU_863_870
  5. Under Frequency plan select Europe 863-870 Mhz (SF9 for RX2 - recommended)
  6. Under JoinEUI enter the App EUI from the App
  7. Enter as well the DevEUI and the AppKey from the sticker
  8. Set an end-device name
  9. Press Register end device
  10. Switch on the device
  • After Configuration, the device restarts automatically and tries to join the network
  • Now the device should join the network and you can see the incoming telegrams in the Live data section
  • The payload formatter should already be preset. If not, you can copy/paste it from below

Payload formatter

function decodeUplink (input) {
  var bytes = input['bytes'];
  // // init
  var bytesString = bytes2HexString(bytes)
      .toLocaleUpperCase();
  // var bytesString = input
  var decoded = {
    // valid
    valid: true, err: 0, // bytes
    payload: bytesString, // messages array
    messages: []
  }

  // CRC check
  if (!crc16Check(bytesString)) {
    decoded['valid'] = false
    decoded['err'] = -1 // "crc check fail."
    return { data: decoded }
  }

  // Length Check
  if ((((bytesString.length / 2) - 2) % 7) !== 0) {
    decoded['valid'] = false
    decoded['err'] = -2 // "length check fail."
    return { data: decoded }
  }

  // Cache sensor id
  var sensorEuiLowBytes
  var sensorEuiHighBytes

  // Handle each frame
  var frameArray = divideBy7Bytes(bytesString)
  for (var forFrame = 0; forFrame < frameArray.length; forFrame++) {
    var frame = frameArray[forFrame]
    // Extract key parameters
    var channel = strTo10SysNub(frame.substring(0, 2))
    var dataID = strTo10SysNub(frame.substring(2, 6))
    var dataValue = frame.substring(6, 14)
    var realDataValue = isSpecialDataId(dataID) ? ttnDataSpecialFormat(dataID, dataValue) : ttnDataFormat(dataValue)

    if (checkDataIdIsMeasureUpload(dataID)) {
      // if telemetry.
      decoded.messages.push({
        type: 'report_telemetry', measurementId: dataID, measurementValue: realDataValue
      })
    } else if (isSpecialDataId(dataID) || (dataID === 5) || (dataID === 6)) {
      // if special order, except "report_sensor_id".
      switch (dataID) {
        case 0x00:
          // node version
          var versionData = sensorAttrForVersion(realDataValue)
          decoded.messages.push({
            type: 'upload_version', hardwareVersion: versionData.ver_hardware, softwareVersion: versionData.ver_software
          })
          break
        case 1:
          // sensor version
          break
        case 2:
          // sensor eui, low bytes
          sensorEuiLowBytes = realDataValue
          break
        case 3:
          // sensor eui, high bytes
          sensorEuiHighBytes = realDataValue
          break
        case 7:
          // battery power && interval
          decoded.messages.push({
            type: 'upload_battery', battery: realDataValue.power
          }, {
            type: 'upload_interval', interval: parseInt(realDataValue.interval) * 60
          })
          break
        case 9:
          decoded.messages.push({
            type: 'model_info',
            detectionType: realDataValue.detectionType,
            modelId: realDataValue.modelId,
            modelVer: realDataValue.modelVer
          })
          break
        case 0x120:
          // remove sensor
          decoded.messages.push({
            type: 'report_remove_sensor', channel: 1
          })
          break
        default:
          break
      }
    } else {
      decoded.messages.push({
        type: 'unknown_message', dataID: dataID, dataValue: dataValue
      })
    }

  }

  // if the complete id received, as "upload_sensor_id"
  if (sensorEuiHighBytes && sensorEuiLowBytes) {
    decoded.messages.unshift({
      type: 'upload_sensor_id', channel: 1, sensorId: (sensorEuiHighBytes + sensorEuiLowBytes).toUpperCase()
    })
  }
  // return
  return { data: decoded }
}

function crc16Check (data) {
  return true
}

// util
function bytes2HexString (arrBytes) {
  var str = ''
  for (var i = 0; i < arrBytes.length; i++) {
    var tmp
    var num = arrBytes[i]
    if (num < 0) {
      tmp = (255 + num + 1).toString(16)
    } else {
      tmp = num.toString(16)
    }
    if (tmp.length === 1) {
      tmp = '0' + tmp
    }
    str += tmp
  }
  return str
}

// util
function divideBy7Bytes (str) {
  var frameArray = []
  for (var i = 0; i < str.length - 4; i += 14) {
    var data = str.substring(i, i + 14)
    frameArray.push(data)
  }
  return frameArray
}

// util
function littleEndianTransform (data) {
  var dataArray = []
  for (var i = 0; i < data.length; i += 2) {
    dataArray.push(data.substring(i, i + 2))
  }
  dataArray.reverse()
  return dataArray
}

// util
function strTo10SysNub (str) {
  var arr = littleEndianTransform(str)
  return parseInt(arr.toString()
    .replace(/,/g, ''), 16)
}

// util
function checkDataIdIsMeasureUpload (dataId) {
  return parseInt(dataId) > 4096
}

// configurable.
function isSpecialDataId (dataID) {
  switch (dataID) {
    case 0:
    case 1:
    case 2:
    case 3:
    case 4:
    case 7:
    case 9:
    case 0x120:
      return true
    default:
      return false
  }
}

// configurable
function ttnDataSpecialFormat (dataId, str) {
  var strReverse = littleEndianTransform(str)
  if (dataId === 2 || dataId === 3) {
    return strReverse.join('')
  }

  // handle unsigned number
  var str2 = toBinary(strReverse)
  var dataArray = []
  switch (dataId) {
    case 0: // DATA_BOARD_VERSION
    case 1: // DATA_SENSOR_VERSION
      // Using point segmentation
      for (var k = 0; k < str2.length; k += 16) {
        var tmp146 = str2.substring(k, k + 16)
        tmp146 = (parseInt(tmp146.substring(0, 8), 2) || 0) + '.' + (parseInt(tmp146.substring(8, 16), 2) || 0)
        dataArray.push(tmp146)
      }
      return dataArray.join(',')
    case 4:
      for (var i = 0; i < str2.length; i += 8) {
        var item = parseInt(str2.substring(i, i + 8), 2)
        if (item < 10) {
          item = '0' + item.toString()
        } else {
          item = item.toString()
        }
        dataArray.push(item)
      }
      return dataArray.join('')
    case 7:
      // battery && interval
      return {
        interval: parseInt(str2.substr(0, 16), 2), power: parseInt(str2.substr(-16, 16), 2)
      }
    case 9:
      let dataValue = {
        detectionType: parseInt(str2.substring(0, 8), 2),
        modelId: parseInt(str2.substring(8, 16), 2),
        modelVer: parseInt(str2.substring(16, 24), 2)
      }
      // 01010000
      return dataValue
  }
}

// util
function ttnDataFormat (str) {
  var strReverse = littleEndianTransform(str)
  var str2 = toBinary(strReverse)
  if (str2.substring(0, 1) === '1') {
    var arr = str2.split('')
    var reverseArr = []
    for (var forArr = 0; forArr < arr.length; forArr++) {
      var item = arr[forArr]
      if (parseInt(item) === 1) {
        reverseArr.push(0)
      } else {
        reverseArr.push(1)
      }
    }
    str2 = parseInt(reverseArr.join(''), 2) + 1
    return parseFloat('-' + str2 / 1000)
  }
  return parseInt(str2, 2) / 1000
}

// util
function sensorAttrForVersion (dataValue) {
  var dataValueSplitArray = dataValue.split(',')
  return {
    ver_hardware: dataValueSplitArray[0], ver_software: dataValueSplitArray[1]
  }
}

// util
function toBinary (arr) {
  var binaryData = []
  for (var forArr = 0; forArr < arr.length; forArr++) {
    var item = arr[forArr]
    var data = parseInt(item, 16)
      .toString(2)
    var dataLength = data.length
    if (data.length !== 8) {
      for (var i = 0; i < 8 - dataLength; i++) {
        data = '0' + data
      }
    }
    binaryData.push(data)
  }
  return binaryData.toString()
    .replace(/,/g, '')
}