Globalstar

As used by Globalstar simplex devices (e.g. SmartOne, GSatSolar).

Structure

As found in LingoMO.

• globalstarMessage - decoded option in LingoMO
  • status - boolean indicating success of decoding
  • error[] - array of decoding errors (if any)
  • message - Globalstar Message
    • one of the following:
      • mo - Mobile Originated message
        • type - message type
        • at - DateTime
        • one of the following:
          • standard
          • speedHeading
          • truncated
          • raw
          • diagnostic
          • accumulatedCount
          • healthCheck
          • gSatSolarGseFirmware
          • gSatSolarStandardAltitude
          • gSatSolarAnimalTracking

LingoMo Example

{
  "id": "bceed7ae-7355-456a-ac9a-4df11c6bb1d4",
  "receivedAt": {
    "year": 2026,
    "month": 12,
    "day": 25,
    "hour": 13,
    "minute": 30,
    "second": 43
  },
  "identity": {
    "accountId": "ejoGRxQrXpzkPJngbjBydaYZbqmDagQQ",
    "subscriber": {
      "id": "RoDmGzOePxrJZKWAvMagyQXlpAkvMwjY",
      "type": "SUBSCRIBER_TYPE_GLOBALSTAR"
    },
    "hardware": {
      "id": "ONAKwlzdYZQrbnLJmptEjaoLkJqpmvRy",
      "type": "HARDWARE_TYPE_GLOBALSTAR",
      "esn": "0-9991111",
      "firmwareVersion": 0
    },
    "identifier": "0-9991111",
    "thingId": "oDmGzOePxrJZKBZZvaBazzQXlpAkvMwj"
  },
  "globalstar": {
    "esn": "0-9991111",
    "messageId": "b6142eb0860b1006839fda0b71770c0e",
    "payloadLength": 9
  },
  "message": "<raw payload>",
  "globalstarMessage": {
    "status": true,
    "message": {
      "mo": {
        "type": "GLOBALSTAR_MESSAGE_TYPE_LOCATION",
        "at": {
          "date": {
            "Day": 25,
            "Month": 12,
            "Year": 2026
          },
          "time": {
            "Hour": 13,
            "Minute": 28,
            "Second": 43
          }
        },
        "standard": {
          "batteryState": "BATTERY_STATE_GOOD",
          "gpsStatus": "GPS_STATUS_VALID",
          "gpsFails": 0,
          "position": {
            "lat": 31.54858705456543,
            "lon": -2.17200469956324125,
            "heading": "HEADING_UNKNOWN",
            "moving": false,
            "fix2D": false,
            "lowConfidence": true
          },
          "input1": {
            "missedStateChange": false,
            "triggered": false,
            "open": true
          },
          "input2": {
            "missedStateChange": false,
            "triggered": false,
            "open": true
          },
          "vibrationChange": false,
          "vibration": false
        }
      }
    }
  }
}

MO Message

{
  "mo": {
    "type": "GLOBALSTAR_MESSAGE_TYPE_LOCATION",
    "at": {},
    "standard": {}
  }
}

The at parameter is a DateTime JSON object. Exactly one of the message bodies below will be populated.

Message Types

Type options:

• GLOBALSTAR_MESSAGE_TYPE_LOCATION
• GLOBALSTAR_MESSAGE_TYPE_TURNED_ON
• GLOBALSTAR_MESSAGE_TYPE_LOCATION_CHANGE
• GLOBALSTAR_MESSAGE_TYPE_INPUT_STATUS_CHANGE
• GLOBALSTAR_MESSAGE_TYPE_UNDESIRED_INPUT_STATE
• GLOBALSTAR_MESSAGE_TYPE_RECENTER
• GLOBALSTAR_MESSAGE_TYPE_SPEED_HEADING
• GLOBALSTAR_MESSAGE_TYPE_DIAGNOSTIC
• GLOBALSTAR_MESSAGE_TYPE_REPLACE_BATTERY
• GLOBALSTAR_MESSAGE_TYPE_CONTACT_SERVICE_PROVIDER
• GLOBALSTAR_MESSAGE_TYPE_ACCUMULATE_COUNT
• GLOBALSTAR_MESSAGE_TYPE_TRUNCATED
• GLOBALSTAR_MESSAGE_TYPE_RAW
• GLOBALSTAR_MESSAGE_TYPE_HEALTH
• GLOBALSTAR_MESSAGE_TYPE_GSAT_SOLAR_GSE_FIRMWARE
• GLOBALSTAR_MESSAGE_TYPE_GSAT_SOLAR_ALTITUDE
• GLOBALSTAR_MESSAGE_TYPE_GSAT_SOLAR_ANIMAL_TRACKING

Standard

{
  "standard": {
    "batteryState": "BATTERY_STATE_GOOD",
    "gpsStatus": "GPS_STATUS_VALID",
    "gpsFails": 0,
    "position": {},
    "input1": {},
    "input2": {},
    "vibrationChange": false,
    "vibration": false
  }
}

Parameter position is a Globalstar Position JSON object. Parameters input1 and input2 are Globalstar Input JSON objects.

See Battery State and GPS Status for options.

Speed Heading

{
  "speedHeading": {
    "batteryState": "BATTERY_STATE_GOOD",
    "gpsStatus": "GPS_STATUS_VALID",
    "dryContact1Open": false,
    "dryContact2Open": true,
    "position": {},
    "speedKmh": 42
  }
}

Parameter position is a Globalstar Position JSON object.

Parameter units are:

• speedKmh - Speed in kilometres per hour

Truncated

{
  "truncated": {
    "position": {},
    "message": "AAECAw=="
  }
}

Parameter position is a Globalstar Position JSON object. The message parameter is the remaining payload bytes (base64 encoded in JSON).

Raw

{
  "raw": {
    "message": "AAECAwQFBgcICQo="
  }
}

The message parameter is the raw payload bytes (base64 encoded in JSON).

Diagnostic

{
  "diagnostic": {
    "transmissionsPerBurst": 3,
    "batteryState": "BATTERY_STATE_GOOD",
    "gpsFault": false,
    "transmitterFault": false,
    "schedulerFault": false,
    "transmissionMinInterval": 5,
    "transmissionMaxInterval": 10,
    "meanGpsFixTime": 30,
    "gpsFails": 0,
    "transmissions": 120
  }
}

See Battery State for options.

Accumulated Count

{
  "accumulatedCount": {
    "accumulatedUndesiredInput1Time": 120,
    "accumulatedUndesiredInput2Time": 65535,
    "accumulatedVibrationTime": 65535,
    "input1ChangeCount": 4,
    "input2ChangeCount": 255
  }
}

Special values:

• accumulatedUndesiredInput1Time, accumulatedUndesiredInput2Time, accumulatedVibrationTime - 65535 indicates accumulate is off
• input1ChangeCount, input2ChangeCount - 255 indicates accumulate is off

Health Check

{
  "healthCheck": {
    "burstsPerMessage": 3,
    "batteryState": "BATTERY_STATE_GOOD",
    "gpsFault": false,
    "transmitterFault": false,
    "firmware": "1.2.3",
    "gpsFails": 0,
    "transmissions": 120,
    "meansGpsFixTime": 30,
    "bluetoothConnectionCount": 2,
    "boardReset": false,
    "u13Fault": false
  }
}

See Battery State for options.

GSatSolar GSE Firmware

{
  "gSatSolarGseFirmware": {
    "header": 1,
    "batteryStateOfCharge": 87.5,
    "batteryChargeState": "BATTERY_CHARGE_STATE_HIGH_CHARGING",
    "temperature": 21.5,
    "orientation": "ORIENTATION_Z_PLUS",
    "veDBA": 12,
    "transmitterState": "TRANSMITTER_STATE_NORMAL",
    "fixType": "FIX_TYPE_3D",
    "gpsValid": "GPS_STATUS_VALID",
    "position": {}
  }
}

Parameter position is a Globalstar Position JSON object. Parameter gpsValid uses the GPS Status options.

Battery charge state options:

• BATTERY_CHARGE_STATE_DISCHARGING
• BATTERY_CHARGE_STATE_LOW_CHARGING
• BATTERY_CHARGE_STATE_MEDIUM_CHARGING
• BATTERY_CHARGE_STATE_HIGH_CHARGING

Orientation options:

• ORIENTATION_X_PLUS
• ORIENTATION_X_NEGATIVE
• ORIENTATION_Y_PLUS
• ORIENTATION_Y_NEGATIVE
• ORIENTATION_Z_PLUS
• ORIENTATION_Z_NEGATIVE
• ORIENTATION_NON_APPLICABLE

Transmitter state options:

• TRANSMITTER_STATE_NORMAL
• TRANSMITTER_STATE_PARTIALLY_SUSPENDED

Fix type options:

• FIX_TYPE_2D
• FIX_TYPE_3D

GSatSolar Standard Altitude

{
  "gSatSolarStandardAltitude": {
    "velocity": 12,
    "altitude": 250,
    "temperature": 18,
    "batteryStateOfCharge": 76.0,
    "position": {}
  }
}

Parameter position is a Globalstar Position JSON object.

GSatSolar Animal Tracking

{
  "gSatSolarAnimalTracking": {
    "pitch": 10,
    "roll": -5,
    "veDBA": 0.42,
    "position": {}
  }
}

Parameter position is a Globalstar Position JSON object.

Device Management

Add Device Request

{
  "id": "",
  "uid": "",
  "esn": "0-1234567",
  "addressId": "",
  "configurationId": "",
  "ratePlanId": "",
  "validTo": {},
  "additionalNote": "",
  "checkInventory": true
}

The validTo parameter is a Date JSON object.

Add Device Response

{
  "status": true,
  "id": "",
  "esn": "0-1234567"
}

Update Device Request

{
  "id": "",
  "uid": "",
  "esn": "0-1234567",
  "addressId": "",
  "configurationId": "",
  "ratePlanId": "",
  "additionalNote": ""
}

Update Device Response

{
  "status": true,
  "id": ""
}

Deactivate Device Request

{
  "id": "",
  "uid": "",
  "esn": "0-1234567",
  "validTo": {}
}

The validTo parameter is a Date JSON object.

Deactivate Device Response

{
  "status": true,
  "id": ""
}

Get Device Summary Request

{
  "id": "",
  "uid": "",
  "esn": "0-1234567"
}

Get Device Summary Response

{
  "status": true,
  "id": "",
  "device": {}
}

The device parameter is a Globalstar Device JSON object.

Remove Failed Requests Request

{
  "requestId": [1001, 1002]
}

Resend Failed Requests Request

{
  "requestId": [1001, 1002]
}

Usage (CDR)

Globalstar Usage

{
  "id": "",
  "type": "GLOBALSTAR_USAGE_TYPE_SIMPLEX",
  "at": {},
  "units": 1,
  "esn": "0-1234567"
}

The at parameter is a DateTime JSON object.

Type options:

• GLOBALSTAR_USAGE_TYPE_SIMPLEX
• GLOBALSTAR_USAGE_TYPE_DUPLEX

Shared JSON Structures

DateTime

{
  "date": {
    "Day": 1,
    "Month": 1,
    "Year": 2025
  },
  "time": {
    "Hour": 12,
    "Minute": 0,
    "Second": 10,
    "Milisecond": 100
  }
}

Date

{
  "Day": 1,
  "Month": 1,
  "Year": 2025
}

Globalstar Position

{
  "lat": 50.87767,
  "lon": -1.25208,
  "heading": "HEADING_NE",
  "moving": true,
  "fix2D": false,
  "lowConfidence": false
}

Heading options:

• HEADING_UNKNOWN
• HEADING_N
• HEADING_NE
• HEADING_E
• HEADING_SE
• HEADING_S
• HEADING_SW
• HEADING_W
• HEADING_NW

Globalstar Input

{
  "missedStateChange": false,
  "triggered": true,
  "open": false
}

Globalstar Device

{
  "customerId": "",
  "esn": "0-1234567",
  "uid": "",
  "ratePlanId": "",
  "productId": "",
  "modelId": "",
  "addressId": "",
  "validFrom": {},
  "validTo": {},
  "status": ""
}

Parameters validFrom and validTo are DateTime JSON objects.

Battery State

Battery state options:

• BATTERY_STATE_UNKNOWN
• BATTERY_STATE_GOOD
• BATTERY_STATE_REPLACE

GPS Status

GPS status options:

• GPS_STATUS_UNKNOWN
• GPS_STATUS_VALID
• GPS_STATUS_INVALID