Docs
For MakersFor PartnersReference docsClient SDKs

In this article

Custom payload conversion examples

Common conversions

Below you will find a few examples of off-the-shelf devices and how to use the Payload converter to connect them with AllThingsTalk Maker. For each of them, the needed assets in Maker and Payload definition are supplied.

Always make sure the assets names you use in Maker match the corresponding asset names in your Payload definition.

Smove

“SMOVE is a ready to use LoRaWAN accelerometer for remote sensing of motions, vibrations and tilt. The compact enclosure holds all electronics including batteries and embedded antenna. The design has been optimized for Long range, Long battery life, and reliability. The device can be used in harsh indoor and outdoor environments since it has an extended temperature range and furthermore is dust and water proof. Pre-programmed user requested Lora-keys, and sensitivity settings make this device Plug and Play.”

Assets

NameProfile
force{"type": "integer"}
battery{"type": "integer"}

Payload definition

1
2
3
4
5
6
{
  "sense": [
    {"asset": "force", "value": {"byte": 0, "type": "integer"}},
    {"asset": "battery", "value": {"byte": 1, "type": "integer"}}
  ]
}

Example payload

1B 5D
ByteHex
01BSet force to 27
15DSet battery to 93

MCS1608

“The MCS1608 Full ITalks end sensor node designed to start quickly with (Private) Lora applications. This complete Lora modem in an IP67 enclosure, so it can also be used outside, already has numerous sensors, so it can be rapidly deployed to test the desired IoT application. On the basis of the successful testing can after that the appropriate sensor can be chosen for u. The nodes are programmed by us at cost or you can do this yourself if you MCS1608 programming cable ordering it. The device is supplied as standard ABP.”

The MCS1608 has a large set of operating states. Below we have implemented the payload definition for the General Sensing setting. The state the device is operating in, is provided by the first byte of the payload, hence the switch/case on byte 0 in our payload definition.

Assets

NameProfile
msgid{"type": "string"}
BaromBar{"type": "number", "unit": " mBar"}
Temperature{"type": "number", "unit": " °C"}
Humidity{"type": "integer", "unit": " %"}
Angle{"type": "object", "properties": {"x": {"type": "integer"}, "y": {"type": "integer"}, "z": {"type": "integer"}}}
Vibration{"type": "object", "properties": {"amplitude": {"type": "integer"}, "frequency": {"type": "integer"}}}

Payload definition

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
{
  "sense": [{
    "switch": {"byte": 0},
    "on": [
      {"case": 0, "do": [ {"asset": "msgid", "value": "Alive"} ] },
      {"case": 1, "do": [ {"asset": "msgid", "value": "Tracking"} ] },
      {"case": 2, "do": [
        {"asset": "msgid", "value": "GenSens"},
        {"asset": "BaromBar", "value": {"byte": 2, "bytelength": 2, "type": "integer", "calculation": "(val + 100000) / 100"}},
        {"asset": "Temperature", "value": {"byte": 4, "bytelength": 2, "type": "integer", "calculation": "val / 100"}},
        {"asset": "Humidity", "value": {"byte": 6, "type": "integer"}},
        {"asset": "Angle",
          "comment" : "approximate calculation from [-128,127] to [-90,90]",
          "value": {
            "x": {"byte": 7,"type": "integer", "signed": true, "calculation": "val/255*180"},
            "y": {"byte": 8,"type": "integer", "signed": true, "calculation": "val/255*180"},
            "z": {"byte": 9,"type": "integer", "signed": true, "calculation": "val/255*180"}
          }
        },
        {"asset": "Vibration",
          "value": {
            "amplitude": {"byte": 10, "type": "integer"},
            "frequency": {"byte": 11, "type": "integer"}
          }
        }
      ]},
      {"case": 3, "do": [ {"asset": "msgid", "value": "Rot"} ] },
      {"case": 4, "do": [ {"asset": "msgid", "value": "Alarm"} ] },
      {"case": 6, "do": [ {"asset": "msgid", "value": "1WireT"} ] },
      {"case": 7, "do": [ {"asset": "msgid", "value": "Running"} ] },
      {"case": 8, "do": [ {"asset": "msgid", "value": "Vibrate"} ] },
      {"case": 9, "do": [ {"asset": "msgid", "value": "Analog"} ] },
      {"case": 10, "do": [ {"asset": "msgid", "value": "GenSensGravMsg"} ] },
      {"case": 11, "do": [ {"asset": "msgid", "value": "DailyReport"} ] },
      {"case": 14, "do": [ {"asset": "msgid", "value": "Reboot"} ] }
    ]}
  ]
}

Example payload

02 00 02 37 07 FF 2B 00 00 FC 00 00 00 00 00 00
ByteHex
002Enter the corresponding switch/case. Case 02 is fully implemented and sets the String value for the msgid asset. The other cases only update the message id asset showing the current device setting
2-302 37Given the calculation (val+100000)/100, the BaromBar asset gets set to 1005.67
4-507 FFGiven the calculation val/100, the Temperature asset gets set to 22.37
62BSet the Humidity asset to 43
7, 8, 900, 00, FCSet the x, y and z fields of the Angle asset to 0, 0 and -4 respectively. Since we want our values between [-128, 127] rather than [0, 255], we add the selector "signed": true
10, 1100, 00Set the amplitude and frequency fields of the Vibration asset to 0 and 0 respectively

No timestamp is sent in the message so the _at_ field is always empty. The timestamp will be set in the cloud when the message arrives.

1
2
3
4
5
6
'msgid': {'value': 'GenSens', 'at': None}
'BaromBar': {'value': 1005.67, 'at': None}
'Temperature': {'value': 20.47, 'at': None}
'Humidity': {'value': 43, 'at': None}
'Angle': {'value': {'x': 0, 'y': 0, 'z': -4}, 'at': None}
'Vibration': {'value': {'amplitude': 0, 'frequency': 0}, 'at': None}

Allora Push button

“Push, a low-power, long range, wireless push sensor is the ideal product to let customers interact with you. With a simple push on the button you know when the coffee machine needs a refilling, the copier is out paper or support is required at a certain location inside your store.”

Assets

NameProfile
push{"type": "string"}
count{"type": "integer"}
length{"type": "integer"}

Payload definition

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "sense": [{
    "switch": {"byte": 2},
    "on": [
      {"case": 10, "comment": "case 0A one short push", "do": [
        {"asset": "push", "value": "Short"},
        {"asset": "count", "value": {"byte": 3, "bytelength":2, "type": "integer"}}
      ]},
      {"case": 11, "comment": "case 0B one long push", "do": [
        {"asset": "push", "value": "Long"},
        {"asset": "count", "value": {"byte": 3, "bytelength":2, "type": "integer"}}
      ]}
    ]},
    {"asset": "length", "value": {"byte": 0, "type": "integer"}}
  ]
}

Example payload

04 02 0A 00 08
ByteHex
004Message length. We set the length asset to 4
20AWe enter switch/case 10 (0A in Hex)
We set the push asset to "Short"
3-400 08Set the count asset to 8