Skip to content

Plugin file

Plugin configuration file
{
    "name": "milesight-iot-em320-tilt",
    "version": "1.0.0",
    "description": "EM320-TILT is an LoRaWAN® tilt sensor mainly for angle measurementand asset movement detection",
    "author": "Thinger.io",
    "license": "MIT",
    "repository": {
        "type": "git",
        "url": "https://github.com/thinger-io/plugins.git",
        "directory": "milesight-iot-em320-tilt"
    },
    "metadata": {
        "name": "Milesight-Iot EM320-TILT",
        "description": "EM320-TILT is an LoRaWAN® tilt sensor mainly for angle measurementand asset movement detection",
        "image": "assets/em320-tilt.png",
        "category": "devices",
        "vendor": "milesight-iot"
    },
    "resources": {
        "products": [
            {
                "description": "EM320-TILT is an LoRaWAN® tilt sensor mainly for angle measurementand asset movement detection",
                "enabled": true,
                "name": "Milesight-Iot EM320-TILT",
                "product": "milesight_iot_em320_tilt",
                "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": {}
                            }
                        },
                        "uplink": {
                            "enabled": true,
                            "handle_connectivity": true,
                            "request": {
                                "data": {
                                    "payload": "{{payload}}",
                                    "payload_function": "",
                                    "payload_type": "source_payload",
                                    "resource_stream": "uplink",
                                    "target": "resource_stream"
                                }
                            },
                            "response": {
                                "data": {}
                            }
                        }
                    },
                    "autoprovisions": {
                        "device_autoprovisioning": {
                            "config": {
                                "mode": "pattern",
                                "pattern": "em320_tilt_.*"
                            },
                            "enabled": true
                        }
                    },
                    "buckets": {
                        "milesight_em320_tilt_data": {
                            "backend": "mongodb",
                            "data": {
                                "payload": "{{payload}}",
                                "payload_function": "",
                                "payload_type": "source_payload",
                                "resource_stream": "uplink_decoded",
                                "source": "resource_stream"
                            },
                            "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 decodeUplink(input) {\n    var res = Decoder(input.bytes, input.fPort);\n    if (res.error) {\n        return {\n            errors: [res.error],\n        };\n    }\n    return {\n        data: res,\n    };\n}\n/**\n * Payload Decoder for The Things Network\n *\n * Copyright 2023 Milesight IoT\n *\n * @product EM320-TILT\n */\nfunction Decoder(bytes, port) {\n    return milesight(bytes);\n}\n\nfunction milesight(bytes) {\n    var decoded = {};\n\n    for (var i = 0; i < bytes.length;) {\n        var channel_id = bytes[i++];\n        var channel_type = bytes[i++];\n\n        // BATTERY\n        if (channel_id === 0x01 && channel_type === 0x75) {\n            decoded.battery = bytes[i];\n            i += 1;\n        }\n        // ANGLE\n        else if (channel_id === 0x03 && channel_type === 0xd4) {\n            decoded.angle_x = (readInt16LE(bytes.slice(i, i + 2)) >> 1) / 100;\n            decoded.angle_y = (readInt16LE(bytes.slice(i + 2, i + 4)) >> 1) / 100;\n            decoded.angle_z = (readInt16LE(bytes.slice(i + 4, i + 6)) >> 1) / 100;\n            decoded.threshold_x = (bytes[i] & 0x01) === 0x01 ? \"trigger\" : \"normal\";\n            decoded.threshold_y = (bytes[i + 2] & 0x01) === 0x01 ? \"trigger\" : \"normal\";\n            decoded.threshold_z = (bytes[i + 4] & 0x01) === 0x01 ? \"trigger\" : \"normal\";\n            i += 6;\n        } else {\n            break;\n        }\n    }\n\n    return decoded;\n}\n\n/* ******************************************\n * bytes to number\n ********************************************/\nfunction readUInt16LE(bytes) {\n    var value = (bytes[1] << 8) + bytes[0];\n    return value & 0xffff;\n}\n\nfunction readInt16LE(bytes) {\n    var ref = readUInt16LE(bytes);\n    return ref > 0x7fff ? ref - 0x10000 : ref;\n}\n",
                        "environment": "javascript",
                        "storage": "",
                        "version": "1.0"
                    },
                    "flows": {
                        "milesight_em320_tilt_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": "EM320-TILT",
                                        "widgets": [
                                            {
                                                "layout": {
                                                    "col": 0,
                                                    "row": 0,
                                                    "sizeX": 2,
                                                    "sizeY": 5
                                                },
                                                "panel": {
                                                    "color": "#ffffff",
                                                    "currentColor": "#ffffff",
                                                    "showOffline": {
                                                        "type": "none"
                                                    },
                                                    "title": "Angle X"
                                                },
                                                "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": "60px",
                                                    "textWeight": "font-light",
                                                    "unit": "°",
                                                    "unitSize": "20px"
                                                },
                                                "sources": [
                                                    {
                                                        "bucket": {
                                                            "backend": "mongodb",
                                                            "id": "milesight_em320_tilt_data",
                                                            "mapping": "angle_x",
                                                            "tags": {
                                                                "device": [],
                                                                "group": []
                                                            }
                                                        },
                                                        "color": "#1abc9c",
                                                        "name": "Source 1",
                                                        "source": "bucket",
                                                        "timespan": {
                                                            "mode": "latest"
                                                        }
                                                    }
                                                ],
                                                "type": "text"
                                            },
                                            {
                                                "layout": {
                                                    "col": 2,
                                                    "row": 0,
                                                    "sizeX": 2,
                                                    "sizeY": 5
                                                },
                                                "panel": {
                                                    "color": "#ffffff",
                                                    "currentColor": "#ffffff",
                                                    "showOffline": {
                                                        "type": "none"
                                                    },
                                                    "title": "Angle Y"
                                                },
                                                "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": "60px",
                                                    "textWeight": "font-light",
                                                    "unit": "°",
                                                    "unitSize": "20px"
                                                },
                                                "sources": [
                                                    {
                                                        "bucket": {
                                                            "backend": "mongodb",
                                                            "id": "milesight_em320_tilt_data",
                                                            "mapping": "angle_y",
                                                            "tags": {
                                                                "device": [],
                                                                "group": []
                                                            }
                                                        },
                                                        "color": "#1abc9c",
                                                        "name": "Source 1",
                                                        "source": "bucket",
                                                        "timespan": {
                                                            "mode": "latest"
                                                        }
                                                    }
                                                ],
                                                "type": "text"
                                            },
                                            {
                                                "layout": {
                                                    "col": 4,
                                                    "row": 0,
                                                    "sizeX": 2,
                                                    "sizeY": 5
                                                },
                                                "panel": {
                                                    "color": "#ffffff",
                                                    "currentColor": "#ffffff",
                                                    "showOffline": {
                                                        "type": "none"
                                                    },
                                                    "title": "Angle Z"
                                                },
                                                "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": "60px",
                                                    "textWeight": "font-light",
                                                    "unit": "°",
                                                    "unitSize": "20px"
                                                },
                                                "sources": [
                                                    {
                                                        "bucket": {
                                                            "backend": "mongodb",
                                                            "id": "milesight_em320_tilt_data",
                                                            "mapping": "angle_z",
                                                            "tags": {
                                                                "device": [],
                                                                "group": []
                                                            }
                                                        },
                                                        "color": "#1abc9c",
                                                        "name": "Source 1",
                                                        "source": "bucket",
                                                        "timespan": {
                                                            "mode": "latest"
                                                        }
                                                    }
                                                ],
                                                "type": "text"
                                            },
                                            {
                                                "layout": {
                                                    "col": 0,
                                                    "row": 5,
                                                    "sizeX": 6,
                                                    "sizeY": 10
                                                },
                                                "panel": {
                                                    "color": "#ffffff",
                                                    "currentColor": "#ffffff",
                                                    "showOffline": {
                                                        "type": "none"
                                                    },
                                                    "title": "Tilt Angles (24h)"
                                                },
                                                "properties": {
                                                    "alignTimeSeries": false,
                                                    "dataAppend": false,
                                                    "options": "var options = {\n    chart: {\n        type: 'line',\n        stacked: false\n    },\n    dataLabels: {\n        enabled: false\n    },\n    stroke: {\n        curve: 'smooth',\n        width: 2\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: 'Angle (°)'\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",
                                                    "realTimeUpdate": true
                                                },
                                                "sources": [
                                                    {
                                                        "aggregation": {},
                                                        "bucket": {
                                                            "backend": "mongodb",
                                                            "id": "milesight_em320_tilt_data",
                                                            "mapping": "angle_x",
                                                            "tags": {
                                                                "device": [],
                                                                "group": []
                                                            }
                                                        },
                                                        "color": "#d1311f",
                                                        "name": "Angle X",
                                                        "source": "bucket",
                                                        "timespan": {
                                                            "magnitude": "hour",
                                                            "mode": "relative",
                                                            "period": "latest",
                                                            "value": 24
                                                        }
                                                    },
                                                    {
                                                        "aggregation": {},
                                                        "bucket": {
                                                            "backend": "mongodb",
                                                            "id": "milesight_em320_tilt_data",
                                                            "mapping": "angle_y",
                                                            "tags": {
                                                                "device": [],
                                                                "group": []
                                                            }
                                                        },
                                                        "color": "#2ebd59",
                                                        "name": "Angle Y",
                                                        "source": "bucket",
                                                        "timespan": {
                                                            "magnitude": "hour",
                                                            "mode": "relative",
                                                            "period": "latest",
                                                            "value": 24
                                                        }
                                                    },
                                                    {
                                                        "aggregation": {},
                                                        "bucket": {
                                                            "backend": "mongodb",
                                                            "id": "milesight_em320_tilt_data",
                                                            "mapping": "angle_z",
                                                            "tags": {
                                                                "device": [],
                                                                "group": []
                                                            }
                                                        },
                                                        "color": "#329fcd",
                                                        "name": "Angle Z",
                                                        "source": "bucket",
                                                        "timespan": {
                                                            "magnitude": "hour",
                                                            "mode": "relative",
                                                            "period": "latest",
                                                            "value": 24
                                                        }
                                                    }
                                                ],
                                                "type": "apex_charts"
                                            },
                                            {
                                                "layout": {
                                                    "col": 0,
                                                    "row": 15,
                                                    "sizeX": 2,
                                                    "sizeY": 5
                                                },
                                                "panel": {
                                                    "color": "#ffffff",
                                                    "currentColor": "#ffffff",
                                                    "showOffline": {
                                                        "type": "none"
                                                    },
                                                    "title": "Battery"
                                                },
                                                "properties": {
                                                    "color": "#2ebd59",
                                                    "gradient": false,
                                                    "max": 100,
                                                    "min": 0,
                                                    "unit": "%"
                                                },
                                                "sources": [
                                                    {
                                                        "bucket": {
                                                            "backend": "mongodb",
                                                            "id": "milesight_em320_tilt_data",
                                                            "mapping": "battery",
                                                            "tags": {
                                                                "device": [],
                                                                "group": []
                                                            }
                                                        },
                                                        "color": "#1abc9c",
                                                        "name": "Source 1",
                                                        "source": "bucket",
                                                        "timespan": {
                                                            "mode": "latest"
                                                        }
                                                    }
                                                ],
                                                "type": "gauge"
                                            },
                                            {
                                                "layout": {
                                                    "col": 2,
                                                    "row": 15,
                                                    "sizeX": 4,
                                                    "sizeY": 5
                                                },
                                                "panel": {
                                                    "color": "#ffffff",
                                                    "currentColor": "#ffffff",
                                                    "showOffline": {
                                                        "type": "none"
                                                    },
                                                    "title": "Threshold Status"
                                                },
                                                "type": "group_widget",
                                                "widgets": [
                                                    {
                                                        "layout": {
                                                            "col": 0,
                                                            "row": 0,
                                                            "sizeX": 2,
                                                            "sizeY": 5
                                                        },
                                                        "panel": {
                                                            "color": "#ffffff",
                                                            "currentColor": "#ffffff",
                                                            "showOffline": {
                                                                "type": "none"
                                                            },
                                                            "title": "Threshold X"
                                                        },
                                                        "properties": {
                                                            "color": "#2ebd59",
                                                            "colors": [
                                                                {
                                                                    "blink": false,
                                                                    "color": "#2ecc71",
                                                                    "max": 0,
                                                                    "min": 0
                                                                },
                                                                {
                                                                    "blink": true,
                                                                    "color": "#e74c3c",
                                                                    "max": 1,
                                                                    "min": 1
                                                                }
                                                            ],
                                                            "size": "50px"
                                                        },
                                                        "sources": [
                                                            {
                                                                "bucket": {
                                                                    "backend": "mongodb",
                                                                    "id": "milesight_em320_tilt_data",
                                                                    "mapping": "threshold_x",
                                                                    "tags": {
                                                                        "device": [],
                                                                        "group": []
                                                                    }
                                                                },
                                                                "color": "#1abc9c",
                                                                "name": "Source 1",
                                                                "processing": {
                                                                    "input": "thresholdToCode"
                                                                },
                                                                "source": "bucket",
                                                                "timespan": {
                                                                    "mode": "latest"
                                                                }
                                                            }
                                                        ],
                                                        "type": "led"
                                                    },
                                                    {
                                                        "layout": {
                                                            "col": 2,
                                                            "row": 0,
                                                            "sizeX": 2,
                                                            "sizeY": 5
                                                        },
                                                        "panel": {
                                                            "color": "#ffffff",
                                                            "currentColor": "#ffffff",
                                                            "showOffline": {
                                                                "type": "none"
                                                            },
                                                            "title": "Threshold Y"
                                                        },
                                                        "properties": {
                                                            "color": "#2ebd59",
                                                            "colors": [
                                                                {
                                                                    "blink": false,
                                                                    "color": "#2ecc71",
                                                                    "max": 0,
                                                                    "min": 0
                                                                },
                                                                {
                                                                    "blink": true,
                                                                    "color": "#e74c3c",
                                                                    "max": 1,
                                                                    "min": 1
                                                                }
                                                            ],
                                                            "size": "50px"
                                                        },
                                                        "sources": [
                                                            {
                                                                "bucket": {
                                                                    "backend": "mongodb",
                                                                    "id": "milesight_em320_tilt_data",
                                                                    "mapping": "threshold_y",
                                                                    "tags": {
                                                                        "device": [],
                                                                        "group": []
                                                                    }
                                                                },
                                                                "color": "#1abc9c",
                                                                "name": "Source 1",
                                                                "processing": {
                                                                    "input": "thresholdToCode"
                                                                },
                                                                "source": "bucket",
                                                                "timespan": {
                                                                    "mode": "latest"
                                                                }
                                                            }
                                                        ],
                                                        "type": "led"
                                                    },
                                                    {
                                                        "layout": {
                                                            "col": 4,
                                                            "row": 0,
                                                            "sizeX": 2,
                                                            "sizeY": 5
                                                        },
                                                        "panel": {
                                                            "color": "#ffffff",
                                                            "currentColor": "#ffffff",
                                                            "showOffline": {
                                                                "type": "none"
                                                            },
                                                            "title": "Threshold Z"
                                                        },
                                                        "properties": {
                                                            "color": "#2ebd59",
                                                            "colors": [
                                                                {
                                                                    "blink": false,
                                                                    "color": "#2ecc71",
                                                                    "max": 0,
                                                                    "min": 0
                                                                },
                                                                {
                                                                    "blink": true,
                                                                    "color": "#e74c3c",
                                                                    "max": 1,
                                                                    "min": 1
                                                                }
                                                            ],
                                                            "size": "50px"
                                                        },
                                                        "sources": [
                                                            {
                                                                "bucket": {
                                                                    "backend": "mongodb",
                                                                    "id": "milesight_em320_tilt_data",
                                                                    "mapping": "threshold_z",
                                                                    "tags": {
                                                                        "device": [],
                                                                        "group": []
                                                                    }
                                                                },
                                                                "color": "#1abc9c",
                                                                "name": "Source 1",
                                                                "processing": {
                                                                    "input": "thresholdToCode"
                                                                },
                                                                "source": "bucket",
                                                                "timespan": {
                                                                    "mode": "latest"
                                                                }
                                                            }
                                                        ],
                                                        "type": "led"
                                                    }
                                                ]
                                            }
                                        ]
                                    }
                                ]
                            }
                        }
                    ]
                }
            }
        ]
    }
}