{
  "applicationID": "1",
  "applicationName": "cloud",
  "data": "A2fqAARoTwUAAA==",
  "devEUI": "24e124136b502217",
  "deviceName": "EM300-TH",
  "fCnt": 128,
  "fPort": 85,
  "rxInfo": [
    {
      "altitude": 0,
      "latitude": 0,
      "loRaSNR": 13.8,
      "longitude": 0,
      "mac": "24e124fffef54092",
      "name": "Local Gateway",
      "rssi": -51,
      "time": "2022-12-27T07:21:27.078763Z"
    }
  ],
  "time": "2022-12-27T07:21:27.078763Z",
  "txInfo": {
    "adr": true,
    "codeRate": "4/5",
    "dataRate": {
      "bandwidth": 125,
      "modulation": "LORA",
      "spreadFactor": 7
    },
    "frequency": 868100000
  },
  "metadata": {
    "mqtt_topic": "/mqtttest"
  }
}

{
  "battery": 92,
  "temperature": 30.8,
  "humidity": 50.5
}

Solution 2: Report data with device EUI and Name

Applicable: UG65/UG67(v60.0.0.44 and later), UG56 (v56.0.0.5 and later)

Enable the Metadata option under the Application page. After enabled, when a payload codec is selected to apply to a device, the gateway will add device EUI, device name and application ID to every report of this device when sending to MQTT/HTTP servers.

Note: this will take effects for all devices under this application. If you only require specific devices to report these information, please refer to solution 3 or 4.

Solution 3: Report raw data with specific attribute items.

function Decode(fPort, bytes) {
var decoded = {};
decoded.devEUI = LoRaObject.devEUI;
decoded.rssi = LoRaObject.rxInfo[0].rssi;
decoded.snr = LoRaObject.rxInfo[0].loRaSNR;
decoded.data = LoRaObject.data;
return decoded;
}

{
"devEUI": "24e1611234567890",
"rssi": -5,
"snr": 11,
"data": "AXVkA2cgAQRoeg=="
}

After adding, you can add this payload codec to a device and go to Network Server > Packets to check the uplink result on Packet Details.

Solution 4: Report decoded data with specific attribute items.

Follow the solution 1 to paste the decoder to Payload decoder function box, then add attribute items before return decoded statement. Example:

function Decode(fPort, bytes) {
    var decoded = {};
  
//Data decoder 
    for (var i = 0; i < bytes.length;) {
        var channel_id = bytes[i++];
        var channel_type = bytes[i++];

        // BATTERY
        if (channel_id === 0x01 && channel_type === 0x75) {
            decoded.battery = bytes[i];
            i += 1;
        }
        // TEMPERATURE
        else if (channel_id === 0x03 && channel_type === 0x67) {
            decoded.temperature = readInt16LE(bytes.slice(i, i + 2)) / 10;
            i += 2;
        }
        // HUMIDITY
        else if (channel_id === 0x04 && channel_type === 0x68) {
            decoded.humidity = bytes[i] / 2;
            i += 1;
        } else {
            break;
        }
    }
  
decoded.devEUI = LoRaObject.devEUI;
    return decoded;
}

/* ******************************************
 * bytes to number
 ********************************************/
function readUInt16LE(bytes) {
    var value = (bytes[1] << 8) + bytes[0];
    return value & 0xffff;
}

function readInt16LE(bytes) {
    var ref = readUInt16LE(bytes);
    return ref > 0x7fff ? ref - 0x10000 : ref;
}

{
 "battery": 92,
 "temperature": 30.8,
 "humidity": 50.5,
 "devEUI": "24e1611234567890"
}

Note: If you need to add all contents of the LoRaObject , please add decoded.obj= LoRaObject; before return decoded statement.

After adding, you can add this payload codec to a device and go to Network Server > Packets to check the uplink result on Packet Details.

Note: the time variable in LoRaObject function means the time to receive packet after packet forwarder program starts. If you need to get the correct time for the gateway to receive the packet, please add this statement:

//replace the en-US as other time zone
decoded.time = new Date().toLocaleString('en-US', { timeZone: ' ' });  

Object Mapping Function

Applicable: UG65/UG67(v60.0.0.45 and later), UG56 (v56.0.0.5 and later)

Milesight gateways support to work as BACnet server or Modbus server to achieve the conversation between LoRaWAN and BACnet/Modbus. And it is necessary to add the object mapping functions to map the uplink data or downlink control items as the objects which can be recognized by BACnet server or Modbus server. 

Here is the object mapping example:

{
    "object": [
        {
            "id": "ipso_version",
            "name": "IPSO Version",
            "value": "",
            "unit": "",
            "access_mode": "R",
            "data_type": "TEXT",
            "value_type": "STRING",
            "max_length": 6,
            "bacnet_type": "character_string_value_object",
            "bacnet_unit_type_id": 95,
            "bacnet_unit_type": "UNITS_NO_UNITS"
        },
                {
            "id": "temperature_unit",
            "name": "Temperature Unit",
            "value": "",
            "unit": "",
            "access_mode": "RW",
            "data_type": "ENUM",
            "value_type": "UINT8",
            "values": [
                { "value": 0, "name": "celsius" },
                { "value": 1, "name": "fahrenheit" }
            ],
            "bacnet_type": "multistate_value_object",
            "bacnet_unit_type_id": 95,
            "bacnet_unit_type": "UNITS_NO_UNITS",
            "reference": ["temperature_control_mode", "temperature_target"]
        }
        ]
}

After adding, you can try to add BACnet objects or Modbus objects to check if this object mapping function takes effect.

Add Payload Codec to Device

When you add any device on Network Server > Device page, you can select the decoder and the decoded data will be shown on the packet details of Network > Packets page.

---END---