Plugin file
Plugin configuration file
{
"name": "dragino_sw3l",
"version": "1.0.0",
"description": "The Dragino SW3L is an outdoor LoRaWAN Liquid Level Transmitter designed to measure the depth of liquids in tanks, wells, or reservoirs using hydrostatic pressure.",
"author": "Thinger.io",
"license": "MIT",
"repository": {
"type": "git",
"url": "https://github.com/thinger-io/plugins.git",
"directory": "dragino-sw3l"
},
"metadata": {
"name": "Dragino SW3L",
"description": "The Dragino SW3L is an outdoor LoRaWAN Liquid Level Transmitter designed to measure the depth of liquids in tanks, wells, or reservoirs using hydrostatic pressure.",
"image": "assets/sw3l.png",
"category": "devices",
"vendor": "dragino"
},
"resources": {
"products": [
{
"description": "The Dragino SW3L is an outdoor LoRaWAN Liquid Level Transmitter designed to measure the depth of liquids in tanks, wells, or reservoirs using hydrostatic pressure.",
"enabled": true,
"name": "Dragino SW3L",
"product": "dragino_sw3l",
"profile": {
"api": {
"downlink": {
"enabled": true,
"handle_connectivity": false,
"request": {
"data": {
"path": "/downlink",
"payload": "{\r\n \"data\" : \"{{payload.data=\"\"}}\",\r\n \"port\" : {{payload.port=2}},\r\n \"priority\": {{payload.priority=3}},\r\n \"confirmed\" : {{payload.confirmed=false}},\r\n \"uplink\" : {{property.uplink}} \r\n}",
"payload_function": "",
"payload_type": "",
"plugin": "{{property.uplink.source}}",
"target": "plugin_endpoint"
}
},
"response": {
"data": {
"source": "request_response"
}
}
},
"uplink": {
"enabled": true,
"handle_connectivity": true,
"request": {
"data": {
"payload": "{{payload}}",
"payload_function": "",
"payload_type": "source_payload",
"resource_stream": "uplink",
"target": "resource_stream"
}
},
"response": {
"data": {
"source": "request_response"
}
}
}
},
"autoprovisions": {
"device_autoprovisioning": {
"config": {
"mode": "pattern",
"pattern": "sw3l_.*"
},
"enabled": true
}
},
"buckets": {
"dragino_sw3l_data": {
"backend": "mongodb",
"data": {
"payload": "{{payload}}",
"payload_function": "",
"payload_type": "source_payload",
"resource": "uplink_decoded",
"source": "resource",
"update": "events"
},
"enabled": true,
"retention": {
"period": 3,
"unit": "months"
},
"tags": []
}
},
"code": {
"code": "function decodeThingerUplink(thingerData) {\n // 0. If data has already been decoded, we will return it\n if (thingerData.decodedPayload) return thingerData.decodedPayload;\n \n // 1. Extract and Validate Input\n // We need 'payload' (hex string) and 'fPort' (integer)\n const hexPayload = thingerData.payload || \"\";\n const port = thingerData.fPort || 1;\n\n // 2. Convert Hex String to Byte Array\n const bytes = [];\n for (let i = 0; i < hexPayload.length; i += 2) {\n bytes.push(parseInt(hexPayload.substr(i, 2), 16));\n }\n\n // 3. Dynamic Function Detection and Execution\n \n // CASE A: (The Things Stack v3)\n if (typeof decodeUplink === 'function') {\n try {\n const input = {\n bytes: bytes,\n fPort: port\n };\n var result = decodeUplink(input);\n \n if (result.data) return result.data;\n\n return result; \n } catch (e) {\n console.error(\"Error inside decodeUplink:\", e);\n throw e;\n }\n }\n\n // CASE B: Legacy TTN (v2)\n else if (typeof Decoder === 'function') {\n try {\n return Decoder(bytes, port);\n } catch (e) {\n console.error(\"Error inside Decoder:\", e);\n throw e;\n }\n }\n\n // CASE C: No decoder found\n else {\n throw new Error(\"No compatible TTN decoder function (decodeUplink or Decoder) found in scope.\");\n }\n}\n\n\n// TTN decoder\nfunction datalog(i, bytes) {\n var aa = bytes[0 + i] & 0x02 ? 'TRUE' : 'FALSE';\n var bb = (bytes[0 + i] & 0xfc) >> 2;\n var cc = bytes[1 + i];\n var dd = ((bytes[3 + i] << 24) | (bytes[4 + i] << 16) | (bytes[5 + i] << 8) | bytes[6 + i]) >>> 0;\n var ee;\n if (bb == 0x02) ee = (dd / 60).toFixed(1);\n else if (bb == 0x01) ee = (dd / 360).toFixed(1);\n else ee = (dd / 450).toFixed(1);\n\n var ff = getMyDate(((bytes[7 + i] << 24) | (bytes[8 + i] << 16) | (bytes[9 + i] << 8) | bytes[10 + i]).toString(10));\n var string = '[' + aa + ',' + bb + ',' + cc + ',' + dd + ',' + ee + ',' + ff + ']' + ',';\n\n return string;\n}\n\nfunction getzf(c_num) {\n if (parseInt(c_num) < 10) c_num = '0' + c_num;\n\n return c_num;\n}\n\nfunction getMyDate(str) {\n var c_Date;\n if (str > 9999999999) c_Date = new Date(parseInt(str));\n else c_Date = new Date(parseInt(str) * 1000);\n\n var c_Year = c_Date.getFullYear(),\n c_Month = c_Date.getMonth() + 1,\n c_Day = c_Date.getDate(),\n c_Hour = c_Date.getHours(),\n c_Min = c_Date.getMinutes(),\n c_Sen = c_Date.getSeconds();\n var c_Time = c_Year + '-' + getzf(c_Month) + '-' + getzf(c_Day) + ' ' + getzf(c_Hour) + ':' + getzf(c_Min) + ':' + getzf(c_Sen);\n\n return c_Time;\n}\n\nfunction decodeUplink(input) {\n var port = input.fPort;\n var bytes = input.bytes;\n var data = {};\n switch (input.fPort) {\n case 2:\n {\n var flag = (bytes[0] & 0xfc) >> 2;\n data.MOD = bytes[5];\n data.Calculate_flag = flag;\n data.Alarm = bytes[0] & 0x02 ? 'TRUE' : 'FALSE';\n\n if (flag == 2) data.Water_flow_value = parseFloat(((((bytes[1] << 24) | (bytes[2] << 16) | (bytes[3] << 8) | bytes[4]) >>> 0) / 60).toFixed(1));\n else if (flag == 1) data.Water_flow_value = parseFloat(((((bytes[1] << 24) | (bytes[2] << 16) | (bytes[3] << 8) | bytes[4]) >>> 0) / 360).toFixed(1));\n else data.Water_flow_value = parseFloat(((((bytes[1] << 24) | (bytes[2] << 16) | (bytes[3] << 8) | bytes[4]) >>> 0) / 450).toFixed(1));\n\n if (bytes[5] == 0x01) data.Last_pulse = ((bytes[1] << 24) | (bytes[2] << 16) | (bytes[3] << 8) | bytes[4]) >>> 0;\n else data.Total_pulse = ((bytes[1] << 24) | (bytes[2] << 16) | (bytes[3] << 8) | bytes[4]) >>> 0;\n\n data.Data_time = getMyDate(((bytes[7] << 24) | (bytes[8] << 16) | (bytes[9] << 8) | bytes[10]).toString(10));\n }\n return {\n data: data,\n };\n break;\n\n case 3:\n {\n for (var i = 0; i < bytes.length; i = i + 11) {\n var da = datalog(i, bytes);\n if (i == '0') data.DATALOG = da;\n else data.DATALOG += da;\n }\n }\n return {\n data: data,\n };\n break;\n\n case 4:\n {\n data.TDC = (bytes[0] << 16) | (bytes[1] << 8) | bytes[2];\n data.Stop_Timer = bytes[4];\n data.Alarm_Timer = (bytes[5] << 8) | bytes[6];\n }\n return {\n data: data,\n };\n break;\n\n case 5:\n {\n if (bytes[0] == 0x11) data.SENSOR_MODEL = 'SW3L';\n\n if (bytes[4] == 0xff) data.SUB_BAND = 'NULL';\n else data.SUB_BAND = bytes[4];\n\n if (bytes[3] == 0x01) data.FREQUENCY_BAND = 'EU868';\n else if (bytes[3] == 0x02) data.FREQUENCY_BAND = 'US915';\n else if (bytes[3] == 0x03) data.FREQUENCY_BAND = 'IN865';\n else if (bytes[3] == 0x04) data.FREQUENCY_BAND = 'AU915';\n else if (bytes[3] == 0x05) data.FREQUENCY_BAND = 'KZ865';\n else if (bytes[3] == 0x06) data.FREQUENCY_BAND = 'RU864';\n else if (bytes[3] == 0x07) data.FREQUENCY_BAND = 'AS923';\n else if (bytes[3] == 0x08) data.FREQUENCY_BAND = 'AS923_1';\n else if (bytes[3] == 0x09) data.FREQUENCY_BAND = 'AS923_2';\n else if (bytes[3] == 0x0a) data.FREQUENCY_BAND = 'AS923_3';\n else if (bytes[3] == 0x0b) data.FREQUENCY_BAND = 'CN470';\n else if (bytes[3] == 0x0c) data.FREQUENCY_BAND = 'EU433';\n else if (bytes[3] == 0x0d) data.FREQUENCY_BAND = 'KR920';\n else if (bytes[3] == 0x0e) data.FREQUENCY_BAND = 'MA869';\n\n data.FIRMWARE_VERSION = (bytes[1] & 0x0f) + '.' + ((bytes[2] >> 4) & 0x0f) + '.' + (bytes[2] & 0x0f);\n data.BAT = ((bytes[5] << 8) | bytes[6]) / 1000;\n }\n return {\n data: data,\n };\n break;\n\n default:\n return {\n errors: ['unknown FPort'],\n };\n }\n}\n",
"environment": "javascript",
"storage": "",
"version": "1.0"
},
"flows": {
"dragino_sw3l_decoder": {
"data": {
"payload": "{{payload}}",
"payload_function": "decodeThingerUplink",
"payload_type": "source_payload",
"resource": "uplink",
"source": "resource",
"update": "events"
},
"enabled": true,
"sink": {
"payload": "{{payload}}",
"payload_function": "",
"payload_type": "source_payload",
"resource_stream": "uplink_decoded",
"target": "resource_stream"
},
"split_data": false
}
},
"properties": {
"uplink": {
"data": {
"payload": "{{payload}}",
"payload_function": "",
"payload_type": "source_payload",
"resource": "uplink",
"source": "resource",
"update": "events"
},
"default": {
"source": "value"
},
"enabled": true
}
}
},
"_resources": {
"properties": [
{
"property": "dashboard",
"value": {
"tabs": [
{
"name": "SW3L Flow Monitor",
"widgets": [
{
"layout": {
"col": 0,
"row": 0,
"sizeX": 2,
"sizeY": 6
},
"panel": {
"color": "#ffffff",
"currentColor": "#ffffff",
"showOffline": {
"type": "none"
},
"title": "Water Flow"
},
"properties": {
"color": "#3498db",
"gradient": true,
"icon": "fas fa-tint",
"iconColor": "#3498db",
"iconSize": "",
"majorTicks": 10,
"max": 1000,
"min": 0,
"plateColor": "#ffffff",
"showValue": true,
"textColor": "#1E313E",
"tickColor": "#000000",
"unit": "L"
},
"sources": [
{
"bucket": {
"backend": "mongodb",
"id": "dragino_sw3l_data",
"mapping": "Water_flow_value",
"tags": {
"device": [],
"group": []
}
},
"color": "#3498db",
"name": "Water Flow",
"source": "bucket",
"timespan": {
"mode": "latest"
}
}
],
"type": "gauge"
},
{
"layout": {
"col": 2,
"row": 0,
"sizeX": 2,
"sizeY": 6
},
"panel": {
"color": "#ffffff",
"currentColor": "#ffffff",
"showOffline": {
"type": "none"
},
"title": "Total Pulse Count"
},
"properties": {
"color": "#9b59b6",
"max": 1000000,
"min": 0,
"unit": "pulses"
},
"sources": [
{
"bucket": {
"backend": "mongodb",
"id": "dragino_sw3l_data",
"mapping": "Total_pulse",
"tags": {
"device": [],
"group": []
}
},
"color": "#9b59b6",
"name": "Total Pulse",
"source": "bucket",
"timespan": {
"mode": "latest"
}
}
],
"type": "donutchart"
},
{
"layout": {
"col": 4,
"row": 0,
"sizeX": 2,
"sizeY": 6
},
"panel": {
"color": "#ffffff",
"currentColor": "#ffffff",
"showOffline": {
"type": "none"
},
"title": "Alarm Status"
},
"properties": {
"color": "#95a5a6",
"colorCondition": {
"conditions": [
{
"color": "#e74c3c",
"operator": "eq",
"value": "TRUE"
},
{
"color": "#27ae60",
"operator": "eq",
"value": "FALSE"
}
],
"enabled": true
},
"size": "75px"
},
"sources": [
{
"bucket": {
"backend": "mongodb",
"id": "dragino_sw3l_data",
"mapping": "Alarm",
"tags": {
"device": [],
"group": []
}
},
"color": "#e74c3c",
"name": "Alarm",
"source": "bucket",
"timespan": {
"mode": "latest"
}
}
],
"type": "led"
},
{
"layout": {
"col": 0,
"row": 6,
"sizeX": 6,
"sizeY": 8
},
"panel": {
"color": "#ffffff",
"currentColor": "#ffffff",
"showOffline": {
"type": "none"
},
"title": "Water Flow History (24h)"
},
"properties": {
"alignTimeSeries": false,
"axis": true,
"fill": true,
"legend": true,
"multiple_axes": false,
"options": "var options = {\n chart: {\n type: 'area',\n zoom: {\n type: 'x',\n enabled: true,\n autoScaleYaxis: true\n },\n toolbar: {\n autoSelected: 'zoom'\n }\n },\n dataLabels: {\n enabled: false\n },\n stroke: {\n curve: 'smooth',\n width: 3\n },\n fill: {\n type: 'gradient',\n gradient: {\n shadeIntensity: 1,\n opacityFrom: 0.7,\n opacityTo: 0.3,\n stops: [0, 90, 100]\n }\n },\n xaxis: {\n type: 'datetime',\n labels: {\n datetimeUTC: false\n },\n tooltip: {\n enabled: false\n }\n },\n yaxis: {\n title: {\n text: 'Flow (L)'\n },\n labels: {\n formatter: function (val) {\n if (val !== null && typeof val !== 'undefined')\n return val.toFixed(2);\n }\n }\n },\n tooltip: {\n x: {\n format: 'dd/MM/yyyy HH:mm:ss'\n }\n }\n};\n"
},
"sources": [
{
"bucket": {
"backend": "mongodb",
"id": "dragino_sw3l_data",
"mapping": "Water_flow_value",
"tags": {
"device": [],
"group": []
}
},
"color": "#3498db",
"name": "Water Flow (L)",
"source": "bucket",
"timespan": {
"magnitude": "hour",
"mode": "relative",
"period": "latest",
"value": 24
}
}
],
"type": "apex_charts"
},
{
"layout": {
"col": 0,
"row": 14,
"sizeX": 6,
"sizeY": 7
},
"panel": {
"color": "#ffffff",
"currentColor": "#ffffff",
"showOffline": {
"type": "none"
},
"title": "Pulse Count History (24h)"
},
"properties": {
"alignTimeSeries": false,
"axis": true,
"fill": false,
"legend": true,
"multiple_axes": false,
"options": "var options = {\n chart: {\n type: 'line',\n zoom: {\n type: 'x',\n enabled: true,\n autoScaleYaxis: true\n },\n toolbar: {\n autoSelected: 'zoom'\n }\n },\n stroke: {\n curve: 'stepline',\n width: 3\n },\n markers: {\n size: 4,\n hover: {\n sizeOffset: 2\n }\n },\n xaxis: {\n type: 'datetime',\n labels: {\n datetimeUTC: false\n },\n tooltip: {\n enabled: false\n }\n },\n yaxis: {\n title: {\n text: 'Pulse Count'\n },\n labels: {\n formatter: function (val) {\n if (val !== null && typeof val !== 'undefined')\n return val.toFixed(0);\n }\n }\n },\n tooltip: {\n x: {\n format: 'dd/MM/yyyy HH:mm:ss'\n }\n }\n};\n"
},
"sources": [
{
"bucket": {
"backend": "mongodb",
"id": "dragino_sw3l_data",
"mapping": "Total_pulse",
"tags": {
"device": [],
"group": []
}
},
"color": "#9b59b6",
"name": "Total Pulse",
"source": "bucket",
"timespan": {
"magnitude": "hour",
"mode": "relative",
"period": "latest",
"value": 24
}
}
],
"type": "apex_charts"
},
{
"layout": {
"col": 0,
"row": 21,
"sizeX": 2,
"sizeY": 4
},
"panel": {
"color": "#ffffff",
"currentColor": "#ffffff",
"showOffline": {
"type": "none"
},
"title": "Last Pulse"
},
"properties": {
"decimalPlaces": 0,
"enableExtraTextColor": false,
"enableIconColor": false,
"enableIconSize": false,
"extraText": "",
"extraTextColor": "#1E313E",
"extraTextColorConditions": [],
"extraTextConditions": [],
"extraTextPosition": "above-value",
"extraTextSize": "20px",
"extraTextWeight": "font-light",
"icon": "",
"iconColor": "#1E313E",
"iconColorConditions": [],
"iconConditions": [],
"iconGap": "8px",
"iconPosition": "before-value",
"iconSize": "75px",
"iconVerticalOffset": "0px",
"link": "",
"textAlign": "center",
"textColor": "#1E313E",
"textColorConditions": [],
"textSize": "40px",
"textWeight": "font-light",
"unit": "",
"unitSize": "20px"
},
"sources": [
{
"bucket": {
"backend": "mongodb",
"id": "dragino_sw3l_data",
"mapping": "Last_pulse",
"tags": {
"device": [],
"group": []
}
},
"color": "#16a085",
"name": "Last Pulse",
"source": "bucket",
"timespan": {
"mode": "latest"
}
}
],
"type": "text"
},
{
"layout": {
"col": 2,
"row": 21,
"sizeX": 2,
"sizeY": 4
},
"panel": {
"color": "#ffffff",
"currentColor": "#ffffff",
"showOffline": {
"type": "none"
},
"title": "Calculate Flag"
},
"properties": {
"decimalPlaces": 0,
"enableExtraTextColor": false,
"enableIconColor": false,
"enableIconSize": false,
"extraText": "",
"extraTextColor": "#1E313E",
"extraTextColorConditions": [],
"extraTextConditions": [],
"extraTextPosition": "above-value",
"extraTextSize": "20px",
"extraTextWeight": "font-light",
"icon": "",
"iconColor": "#1E313E",
"iconColorConditions": [],
"iconConditions": [],
"iconGap": "8px",
"iconPosition": "before-value",
"iconSize": "75px",
"iconVerticalOffset": "0px",
"link": "",
"textAlign": "center",
"textColor": "#1E313E",
"textColorConditions": [],
"textSize": "40px",
"textWeight": "font-light",
"unit": "",
"unitSize": "20px"
},
"sources": [
{
"bucket": {
"backend": "mongodb",
"id": "dragino_sw3l_data",
"mapping": "Calculate_flag",
"tags": {
"device": [],
"group": []
}
},
"color": "#34495e",
"name": "Calculate Flag",
"source": "bucket",
"timespan": {
"mode": "latest"
}
}
],
"type": "text"
},
{
"layout": {
"col": 4,
"row": 21,
"sizeX": 2,
"sizeY": 4
},
"panel": {
"color": "#ffffff",
"currentColor": "#ffffff",
"showOffline": {
"type": "none"
},
"title": "Sensor Model"
},
"properties": {
"decimalPlaces": 2,
"enableExtraTextColor": false,
"enableIconColor": false,
"enableIconSize": false,
"extraText": "",
"extraTextColor": "#1E313E",
"extraTextColorConditions": [],
"extraTextConditions": [],
"extraTextPosition": "above-value",
"extraTextSize": "20px",
"extraTextWeight": "font-light",
"icon": "",
"iconColor": "#1E313E",
"iconColorConditions": [],
"iconConditions": [],
"iconGap": "8px",
"iconPosition": "before-value",
"iconSize": "75px",
"iconVerticalOffset": "0px",
"link": "",
"textAlign": "center",
"textColor": "#1E313E",
"textColorConditions": [],
"textSize": "40px",
"textWeight": "font-light",
"unit": "",
"unitSize": "20px"
},
"sources": [
{
"bucket": {
"backend": "mongodb",
"id": "dragino_sw3l_data",
"mapping": "SENSOR_MODEL",
"tags": {
"device": [],
"group": []
}
},
"color": "#7f8c8d",
"name": "Sensor Model",
"source": "bucket",
"timespan": {
"mode": "latest"
}
}
],
"type": "text"
},
{
"layout": {
"col": 0,
"row": 25,
"sizeX": 2,
"sizeY": 5
},
"panel": {
"color": "#ffffff",
"currentColor": "#ffffff",
"showOffline": {
"type": "none"
},
"title": "Battery Voltage"
},
"properties": {
"color": "#27ae60",
"gradient": false,
"icon": "fas fa-battery-three-quarters",
"iconColor": "#27ae60",
"iconSize": "",
"majorTicks": 10,
"max": 3.6,
"min": 2.5,
"plateColor": "#ffffff",
"showValue": true,
"textColor": "#1E313E",
"tickColor": "#000000",
"unit": "V"
},
"sources": [
{
"bucket": {
"backend": "mongodb",
"id": "dragino_sw3l_data",
"mapping": "BAT",
"tags": {
"device": [],
"group": []
}
},
"color": "#27ae60",
"name": "Battery",
"source": "bucket",
"timespan": {
"mode": "latest"
}
}
],
"type": "gauge"
},
{
"layout": {
"col": 2,
"row": 25,
"sizeX": 2,
"sizeY": 5
},
"panel": {
"color": "#ffffff",
"currentColor": "#ffffff",
"showOffline": {
"type": "none"
},
"title": "Firmware Version"
},
"properties": {
"decimalPlaces": 2,
"enableExtraTextColor": false,
"enableIconColor": false,
"enableIconSize": true,
"extraText": "",
"extraTextColor": "#1E313E",
"extraTextColorConditions": [],
"extraTextConditions": [],
"extraTextPosition": "above-value",
"extraTextSize": "20px",
"extraTextWeight": "font-light",
"icon": "fas fa-code-branch",
"iconColor": "#34495e",
"iconColorConditions": [],
"iconConditions": [],
"iconGap": "8px",
"iconPosition": "above-value",
"iconSize": "40px",
"iconVerticalOffset": "0px",
"link": "",
"textAlign": "center",
"textColor": "#1E313E",
"textColorConditions": [],
"textSize": "40px",
"textWeight": "font-light",
"unit": "",
"unitSize": "20px"
},
"sources": [
{
"bucket": {
"backend": "mongodb",
"id": "dragino_sw3l_data",
"mapping": "FIRMWARE_VERSION",
"tags": {
"device": [],
"group": []
}
},
"color": "#34495e",
"name": "Firmware",
"source": "bucket",
"timespan": {
"mode": "latest"
}
}
],
"type": "text"
},
{
"layout": {
"col": 4,
"row": 25,
"sizeX": 2,
"sizeY": 5
},
"panel": {
"color": "#ffffff",
"currentColor": "#ffffff",
"showOffline": {
"type": "none"
},
"title": "Frequency Band"
},
"properties": {
"decimalPlaces": 2,
"enableExtraTextColor": false,
"enableIconColor": false,
"enableIconSize": true,
"extraText": "",
"extraTextColor": "#1E313E",
"extraTextColorConditions": [],
"extraTextConditions": [],
"extraTextPosition": "above-value",
"extraTextSize": "20px",
"extraTextWeight": "font-light",
"icon": "fas fa-broadcast-tower",
"iconColor": "#e67e22",
"iconColorConditions": [],
"iconConditions": [],
"iconGap": "8px",
"iconPosition": "above-value",
"iconSize": "40px",
"iconVerticalOffset": "0px",
"link": "",
"textAlign": "center",
"textColor": "#1E313E",
"textColorConditions": [],
"textSize": "40px",
"textWeight": "font-light",
"unit": "",
"unitSize": "20px"
},
"sources": [
{
"bucket": {
"backend": "mongodb",
"id": "dragino_sw3l_data",
"mapping": "FREQUENCY_BAND",
"tags": {
"device": [],
"group": []
}
},
"color": "#e67e22",
"name": "Frequency",
"source": "bucket",
"timespan": {
"mode": "latest"
}
}
],
"type": "text"
}
]
}
]
}
}
]
}
}
]
}
}