Elabora gli ultimi dati noti sui veicoli statali utilizzando la messaggistica MQTT

Per ricevere aggiornamenti dal veicolo ed elaborarne i dati, iscriviti al seguente argomento MQTT. Per ulteriori informazioni, consultate gli argomenti relativi a MQTT nella Guida per gli AWS IoT Core sviluppatori.

$aws/iotfleetwise/vehicles/$vehicle_name/last_known_state/$state_template_name/data

Gli ultimi messaggi noti di aggiornamento del segnale di stato potrebbero essere ricevuti fuori servizio, poiché MQTT non garantisce l'ordine. Tutti i client che utilizzano MQTT per ricevere ed elaborare i dati del veicolo devono occuparsene. Gli ultimi messaggi noti di aggiornamento del segnale di stato seguono il protocollo di messaggistica MQTT 5.

L'intestazione del messaggio per ogni messaggio MQTT ha le seguenti proprietà utente:

Inoltre, è possibile specificare gli attributi del veicolo da includere nell'intestazione del messaggio MQTT specificando il parametro di metadataExtraDimensions richiesta durante l'aggiornamento o la creazione di un modello di stato. (Vedi Modelli di stato.)

Le proprietà utente nell'intestazione del messaggio MQTT sono utili per instradare i messaggi verso destinazioni diverse senza controllare il payload.

Il payload dei messaggi MQTT contiene i dati raccolti dai veicoli. È possibile specificare gli attributi del veicolo da includere nel payload dei messaggi MQTT specificando il parametro di extraDimensions richiesta durante la creazione o l'aggiornamento di un modello di stato (vedere). Crea un modello di FleetWise stato AWS IoT Le dimensioni aggiuntive arricchiscono i dati raccolti dai veicoli associando loro dimensioni aggiuntive.

Il payload dei messaggi MQTT è codificato con buffer di protocollo (Protobuf) e l'intestazione del messaggio MQTT contiene un indicatore del tipo di contenuto definito come application/octet-stream. Lo schema di codifica Protobuf è il seguente:

// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0

syntax = "proto3";

option java_package = "com.amazonaws.iot.autobahn.schemas.lastknownstate";
package Aws.IoTFleetWise.Schemas.CustomerMessage;

message LastKnownState {

  /*
   * The absolute timestamp in milliseconds since Unix Epoch of when the event was triggered in vehicle.
   */
  uint64 time_ms = 1;

  /*
   * This field is deprecated, use signals instead
   */
  repeated Signal signal = 2 [ deprecated = true ];

  repeated Signal signals = 3;

  repeated ExtraDimension extra_dimensions = 4;
}

message Signal {

  /*
   * The Fully Qualified Name of the signal is the path to the signal plus the signal's name.
   * For example, Vehicle.Chassis.SteeringWheel.HandsOff.HandsOffSteeringState
   * The fully qualified name can have up to 150 characters. Valid characters: a-z, A-Z, 0-9, : (colon), and _ (underscore).
   */
  string name = 1;

  /*
   * The FWE reported signal value can be one of the following data types.
   */
  oneof SignalValue {
    double double_value = 2;

    bool boolean_value = 3;

    sint32 int8_value = 4;

    uint32 uint8_value = 5;

    sint32 int16_value = 6;

    uint32 uint16_value = 7;

    sint32 int32_value = 8;

    uint32 uint32_value = 9;

    sint64 int64_value = 10;

    uint64 uint64_value = 11;

    float float_value = 12;
    /*
     * An UTF-8 encoded or 7-bit ASCII string
     */
    string string_value = 13;
  }
}

message ExtraDimension {
  /*
   * The Fully Qualified Name of the attribute is the path to the attribute plus the attribute's name.
   * For example, Vehicle.Model.Color
   * The fully qualified name can have up to 150 characters. Valid characters: a-z, A-Z, 0-9, : (colon), and _ (underscore).
   */
  string name = 1;

  oneof ExtraDimensionValue {
    /*
     * An UTF-8 encoded or 7-bit ASCII string
     */
    string string_value = 2;
  }
} 

Dove: