Skip to main content

MT

Mobile Terminated Messages to the Device

To send an MT message to an Iridium Edge Solar a JSON message structure can be provided to the API. Cloudloop will then encode and send the message.

For more detail and examples on how to send MT messages to devices see Send Message.

Request Structure​

  • mt - Mobile Terminated (MT) Message
    • engineering - Send engineering request
    • sendLocation - Chained position messages
    • generalConfig - Location Appended with 6 Bytes User Data with Timestamp
    • scratchpad - Magnet Insertion Message. Entering Storage Mode

Messages​

Set Send Engineering​

[engineering]

The Iridium Edge Solar can be commanded to initiate an Engineering Message. Upon receipt of this message the Iridium Edge Solar will send the Engineering Message.

{
  "engineering": {}
}

Set Send Location​

[sendLocation]

The Iridium Edge Solar can be commanded to initiate a Location Message. Upon receipt of this message the Iridium Edge Solar will perform a GPS fix and initiate sending the MO Location Message.

{
  "sendLocation": {}
}

Set General Config​

[generalConfig]

The Iridium Edge Solar may be configured over the air using the General Config message as shown.

{
  "generalConfig": {
    "length": "30",
    "timestamp": "/////w==",
    "interval": [
      {
        "timed": true,
        "time": 30
      },
      {
        "timed": true,
        "time": 30
      },
      {
        "timed": true,
        "time": 30
      },
      {
        "timed": true,
        "time": 30
      },
      {
        "timed": true,
        "time": 30
      },
      {
        "timed": true,
        "time": 30
      },
      {
        "timed": true,
        "time": 30
      },
      {
        "timed": true,
        "time": 30
      }
    ],
    "messageInterval": 20,
    "motionConfig": {
      "motionMode": "MOTION_MODE_START_STOP",
      "motionInterval": 123
    },
    "mailboxConfig": {
      "checkOnTx": true,
      "checkInterval": 512
    },
    "powerSaveConfig": {
      "countDays": true,
      "count": 12,
      "timeBetweenReports": 45
    },
    "gpsMotion": {
      "checkInterval": 1,
      "homeRatio": 2,
      "awayRatio": 3
    },
    "advanced": {
      "vbmrStartStop": "START_STOP_5_15",
      "vgbmrEnabled": true,
      "retryCount": 12,
      "vbmrPowerSave": false
    }
  }
}

The motion mode options are:

  • MOTION_MODE_DISABLED
  • MOTION_MODE_START_STOP
  • MOTION_MODE_START_MOTION_STOP
  • MOTION_MODE_RESERVED

The gpsMotion is enabled by infering the value from the checkInterval. Set the check interval to 0 to disable, and anything else to enable.

The VBMR mode options are:

  • START_STOP_5_5
  • START_STOP_5_15
  • START_STOP_5_30
  • START_STOP_5_60
  • START_STOP_15_5
  • START_STOP_15_15
  • START_STOP_15_30
  • START_STOP_15_60

Set User Scratchpad​

[scratchpad]

The Iridium Edge Solar can be commanded to receive and store data in memory designated as scratchpad. The scratchpad size is 1 to 62 bytes in total length. The message payload is Base64 encoded.

{
  "scratchpad": {
    "userData": "AAECAwEC"
  }
}