Skip to main content

Lingo

lin·go [noun]: strange or incomprehensible language or speech: such as

  • a foreign language
  • the special vocabulary of a particular field of interest
  • language characteristic of an individual
  • unified Message structure created by Ground Control to simplify integration with Cloudloop Data

Unified Message Structure​

At the heart of the platform lies the unified Message structure - Lingo.

This structure is used to represent all Messages flowing through the system irrespective of Network, Device or delivery method. In addition to containing the Message payload, it also holds transport specific meta-data (i.e. device identifiers) as well any derived information from Cloudloop.

Whilst the fields of information, their composition and the data types are defined by Ground Control - the Message is ultimately exposed in the ubiquitous JSON format; which enables it to also be used as our de-facto format for exchanging Messages with Customers.

There’s two types of Message, depending on the direction - LingoMO and LingoMT.

Example LingoMO for a RockBLOCK transmitting a message via SBD​

{
  "id": "38f132ed-73e7-4488-a743-ec00fe7d7879",
  "receivedAt": {
    "year": 2023,
    "month": 10,
    "day": 2,
    "hour": 15,
    "minute": 37,
    "second": 9
  },
  "identity": {
    "accountId": "yJGjpPobLlmOdanVkPWAKYzNMgwVZkrR",
    "subscriber": {
      "id": "XgwyNPpDmebJLWXmwgEoARqxMdZOVGva",
      "type": "SUBSCRIBER_TYPE_SBD",
      "description": "RockBLOCK 1234"
    },
    "hardware": {
      "id": "joGRxQrXpzkPJEglMOBydwYZbqmDagNA",
      "type": "HARDWARE_TYPE_ROCKBLOCK",
      "imei": "300234065366010",
      "serial": "1234"
    },
    "identifier": "300234065366010",
    "thingId": "DgXeoxwVPMyrdOBJeEGlqKRJLbajQkzZ"
  },
  "sbd": {
    "imei": "300234065366010",
    "cdrReference": "3042022693",
    "momsn": 5394,
    "mtmsn": 0,
    "sessionAt": {
      "year": 2023,
      "month": 10,
      "day": 2,
      "hour": 15,
      "minute": 37,
      "second": 8
    },
    "status": "SESSION_STATUS_OK",
    "location": {
      "latitude": 50.898133333333334,
      "longitude": -1.1946666666666665,
      "cep": 3.0
    }
  },
  "message": "JgBreyyiF+0tucxAAAQBmAQgBA=="
}