status.tpms

Payload JSON

{
   "eventSubscriptionId":"517db07f-6e95-475e-8cc0-a371f9deed2b",
   "eventType":"status.tpms",
   "eventVersion":1,
   "eventId":"c37f8ac9-8206-4f95-afd1-74e442d09c07",
   "assetId":"2412ba2f-4499-4933-a9ce-69f6a38f44ee",
   "unitId":"traxee:358014094033866",
   "registeredOn":"2021-03-26T22:20:59Z",
   "eventData":{
      "tpms":[
         {
            "location":17,
            "pressure":10.2,
            "pressureStatus":"overPressure",
            "temperature":32,
            "compensatedPressure":6.7,
            "rfHealth": {
               "batteryMonthsRemaining":145,
               "lastCommunicationOn": "2023-02-01T14:39:23.077288Z",
               "rssi":123
            }
         }
      ]
   }
}

Field level Description

Field	Type	Optional/Required	Description
eventSubscriptionId	String (UUID)	Required	A unique identifier representing the subscription through which this event was delivered. It ensures traceability between the event and the organization's registered RMS subscription.
eventType	String	Required	Indicates the category of event generated by the system. For this payload, status.tpms identifies the event as a Tire Pressure Monitoring System status update.
eventVersion	Number	Required	eventVersion indicates the schema version of the event, allowing producers and consumers to interpret the event consistently as the schema evolves.
eventId	String (UUID)	Required	A globally unique identifier assigned to this specific event instance. Useful for event deduplication, tracking, and audit logging.
assetId	String (UUID)	Required	Identifies the physical asset (e.g., vehicle, trailer, equipment) associated with this event. Used to correlate telemetry with a specific asset in fleet management systems.
unitId	String	Required	A unique identifier of the telematics device generating the event. It often includes a namespace (e.g., traxee:) followed by the device's serial or IMEI-like identifier.
registeredOn	DateTime (ISO 8601 timestamp, UTC)	Required	The timestamp representing when the event was detected and recorded by the device.
eventData	Object	Required	The eventData section contains sensor readings and associated metadata captured at the time of the TPMS event.
tpms	Array	Required	A collection of TPMS sensor readings. Each element provides detailed status information for a single wheel or sensor location on the asset.
location	Integer	Required	Numeric value representing the TPMS sensor's physical mounting position on the asset. This numeric identifier corresponds to a specific tire location following standardized positioning conventions. The numeric values are converted from hexadecimal position codes. Examples: 22 (hex 16) = FirstFrontAxle OuterLeftTire, 26 (hex 1A) = FirstFrontAxle OuterRightTire, 42 (hex 2A) = FirstRearAxle OuterRightTire. The mapping covers various axle and tire position combinations to support multi-axle vehicles and trailers.
pressure	Number (Decimal)	Optional	The measured tire pressure at the time the event was generated. This value enables monitoring of inflation levels for safety and efficiency.
pressureStatus	String	Optional	Indicates the interpreted status of the tire pressure relative to defined thresholds. Examples include: extremeOverPressure - Pressure is extremely high compare to recommended limits overPressure — Pressure exceeds recommended limits normal — Pressure is within optimal range underPressure — Pressure is below acceptable limits extremeUnderPressure - Pressure is extremely low compare to acceptable limits
temperature	Number (°C)	Optional	The temperature reading from the tire's TPMS sensor. Monitoring tire temperature helps detect anomalies such as overheating or possible structural issues.
compensatedPressure	Number (Decimal)	Optional	The compensated pressure (in bar) is the pressure calculated based on the measured pressure and tire temperature.
rfHealth	Object	Optional	Health data from a TPMS sensor. Only available from specific RF sensors if explicitly configured to send it.
batteryMonthsRemaining	Number	Optional	A property indicating the estimated number of months remaining before the TPMS sensor battery is fully depleted under current usage conditions.
lastCommunicationOn	String (Date Time)	Optional	Timestamp when the communication unit received the last message from the sensor.
rssi	Number	Optional	Received Signal Strength Indicator (RSSI) of the sensor. It is an internal value defined for TP and other Transics devices. It does not have any direct correlation with dBm or similar standard signal metrics. RSSI should not be compared between different brands of sensors and/or communication units. Currently, in Trailerpulse devices, RSSI values can be observed around 70, which indicates that the device is receiving a relatively weak signal from the sensor, though it is still sufficient to maintain RF communication. On the other hand, values above 200 can be also observed (indicating a stronger signal).