config.tpms

Payload JSON

RF Source

{
   "eventSubscriptionId":"517db07f-6e95-475e-8cc0-a371f9deed2b",
   "eventType":"config.tpms",
   "eventVersion":2,
   "eventId":"c37f8ac9-8206-4f95-afd1-74e442d09c07",
   "assetId":"2412ba2f-4499-4933-a9ce-69f6a38f44ee",
   "unitId":"traxee:358014094033866",
   "registeredOn":"2021-03-26T22:20:59Z",
   "eventData":{
      "rfSensorDiscoveryMode":"BMS",
      "sensorMapping":[
         {
            "location":17,
            "referencePressure":90000,
            "sensorId":"123456AB",
            "sensorModel":"WIS"
         }
      ],
      "source":"rf",
      "unmappedSensors":[
         "FEDCBA12"
      ]
   }
}

TBS Source

{
   "eventSubscriptionId":"517db07f-6e95-475e-8cc0-a371f9deed2b",
   "eventType":"config.tpms",
   "eventVersion":2,
   "eventId":"c37f8ac9-8206-4f95-afd1-74e442d09c07",
   "assetId":"2412ba2f-4499-4933-a9ce-69f6a38f44ee",
   "unitId":"traxee:358014094033866",
   "registeredOn":"2021-03-26T22:20:59Z",
   "eventData":{
      "source":"tbs"
   }
}

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	Specifies the type of event. config.tpms indicates that the payload contains configuration data for the TPMS system.
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	This object contains TPMS‑specific configuration settings.
rfSensorDiscoveryMode	String	Required	Indicates the RF (Radio Frequency) discovery mode used to detect TPMS sensors. Example: WIS, SMS, GY — Battery‑powered Monitoring System detection mode.
sensorMapping	Array	Required	A list of mapped TPMS sensors, each representing a wheel position and its associated configuration parameters. Each element in the array contains the following:
location	Integer	Required	Specifies the mounting location of the TPMS sensor on the asset. The value maps to a wheel position based on the asset's predefined tire layout.
referencePressure	Number (Pascals or millibars depending on system configuration)	Required	The target or baseline pressure defined for this sensor's location. Used for evaluating under‑ or over‑pressure conditions.
sensorId	String	Required	Unique identifier of the TPMS sensor. Helps systems recognize and track the sensor across events.
sensorModel	String	Required	Manufacturer or model name of the TPMS sensor (e.g., WIS, SMS, GY). Enables compatibility checks and maintenance documentation.
source	String	Required	Indicates the origin of TPMS sensor data. Example: rf, none, tbs, ext — Data originates from RF‑based TPMS sensors.
unmappedSensors	Array of Strings	Required	Lists TPMS sensors detected by the system but not associated with any wheel position or mapping entry. These may indicate: Newly installed sensors Sensors awaiting configuration Faulty or misconfigured sensors broadcasting RF signals