View a markdown version of this page

Raccogliere AWS FleetWise Dati IoT con campagne - AWS IoT FleetWise

AWS L'IoT non FleetWise è più aperto a nuovi clienti. FleetWise I clienti AWS IoT esistenti possono continuare a utilizzare il servizio. La Guidance for Connected Mobility on AWS fornisce indicazioni su come sviluppare e implementare servizi modulari per soluzioni di mobilità connessa che possono essere utilizzate per ottenere funzionalità equivalenti a quelle dell' AWS IoT FleetWise.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Raccogliere AWS FleetWise Dati IoT con campagne

Importante

L'accesso a determinate FleetWise funzionalità AWS dell'IoT è attualmente limitato. Per ulteriori informazioni, consulta AWS Disponibilità di aree e funzionalità nell' AWS IoT FleetWise.

Una campagna è un'orchestrazione di regole per la raccolta dei dati. Le campagne forniscono al FleetWise software Edge Agent for AWS IoT istruzioni su come selezionare, raccogliere e trasferire i dati nel cloud.

Crei campagne nel cloud. Dopo che tu o il tuo team avete approvato una campagna, l' AWS IoT FleetWise imposta la campagna come pronta per l'implementazione e verrà implementata al successivo check-in del veicolo. Puoi scegliere di distribuire una campagna su un veicolo o su una flotta di veicoli. Il software Edge Agent non inizia a raccogliere dati finché non viene distribuita una campagna in corso sul veicolo.

Importante

Le campagne non funzioneranno finché non avrai quanto segue.

  • Il software Edge Agent è in esecuzione nel tuo veicolo. Per ulteriori informazioni su come sviluppare, installare e utilizzare il software Edge Agent, procedi come segue.

    1. Apri la FleetWise console AWS IoT.

    2. Nella home page del servizio, nella FleetWise sezione Guida introduttiva all' AWS IoT, scegli Explore Edge Agent.

  • Hai impostato AWS IoT Core il provisioning del tuo veicolo. Per ulteriori informazioni, consulta Fornitura AWS FleetWise Veicoli IoT.

Nota

Puoi farlo anche in tempo quasi reale Monitora l’ultimo stato noto dei tuoi veicoli (non per le flotte) utilizzando modelli di stato che ti consentono di trasmettere in streaming i dati di telemetria con una strategia di aggiornamento «In caso di modifica» o «periodica». La funzionalità fornisce anche funzionalità «On Demand» per attivare o disattivare i modelli implementati in precedenza o richiedere una sola volta (recupero) lo stato attuale del veicolo.

L'accesso all'ultimo stato noto è attualmente bloccato. Per ulteriori informazioni, consulta AWS Disponibilità di aree e funzionalità nell' AWS IoT FleetWise.

Ogni campagna contiene le seguenti informazioni.

signalCatalogArn

L'Amazon Resource Name (ARN) del catalogo dei segnali associato alla campagna.

(Facoltativo) tags

I tag sono metadati che possono essere utilizzati per gestire la campagna. È possibile assegnare lo stesso tag a risorse di diversi servizi per indicare che queste sono correlate.

TargetArn

L'ARN di un veicolo o di una flotta su cui viene implementata la campagna.

name

Un nome univoco che aiuta a identificare la campagna.

collectionScheme

Gli schemi di raccolta dati forniscono al software Edge Agent istruzioni su quali dati raccogliere o quando raccoglierli. AWS L'IoT FleetWise attualmente supporta lo schema di raccolta basato sulle condizioni e lo schema di raccolta basato sul tempo.

  • conditionBasedCollectionScheme— lo schema di raccolta basato sulle condizioni utilizza un'espressione logica per riconoscere quali dati raccogliere. Il software Edge Agent raccoglie i dati quando viene soddisfatta la condizione.

    • expression— l'espressione logica utilizzata per riconoscere quali dati raccogliere. Ad esempio, se viene specificata l'$variable.`myVehicle.InVehicleTemperature` > 50.0espressione, il software Edge Agent raccoglie valori di temperatura superiori a 50,0. Per istruzioni su come scrivere espressioni, vedere. Espressioni logiche per AWS FleetWise Campagne IoT

    • (Facoltativo)conditionLanguageVersion: la versione del linguaggio delle espressioni condizionali.

    • (Facoltativo)minimumTriggerIntervalMs: la durata minima tra due eventi di raccolta dati, in millisecondi. Se un segnale cambia spesso, è possibile raccogliere dati a una velocità inferiore.

    • (Facoltativo)triggerMode: può essere uno dei seguenti valori:

      • RISING_EDGE— il software Edge Agent raccoglie i dati solo quando la condizione viene soddisfatta per la prima volta. Ad esempio, $variable.`myVehicle.AirBagDeployed` == true.

      • ALWAYS— Il software Edge Agent raccoglie i dati ogni volta che la condizione viene soddisfatta.

  • timeBasedCollectionScheme— quando si definisce uno schema di raccolta basato sul tempo, specificare un periodo di tempo in millisecondi. Il software Edge Agent utilizza il periodo di tempo per decidere con che frequenza raccogliere i dati. Ad esempio, se il periodo di tempo è di 120.000 millisecondi, il software Edge Agent raccoglie i dati una volta ogni due minuti.

    • periodMs— il periodo di tempo (in millisecondi) per decidere con quale frequenza raccogliere i dati.

(Facoltativo) compression

Per risparmiare larghezza di banda wireless e ridurre il traffico di rete, puoi specificare SNAPPY per comprimere i dati nei veicoli.

Per impostazione predefinita (OFF), il software Edge Agent non comprime i dati.

dataDestinationConfigs

Scegli l'unica destinazione in cui la campagna trasferirà i dati del veicolo. Puoi inviare i dati a un argomento https://docs.aws.amazon.com/iot/latest/developerguide/topics.html MQTT o archiviarli in Amazon S3 o Amazon Timestream.

MQTT (Message Queuing Telemetry Transport) è un protocollo di messaggistica leggero e ampiamente adottato. È possibile pubblicare dati su un argomento MQTT per creare le proprie architetture basate sugli eventi utilizzando regole. AWS IoT AWS IoT il supporto per MQTT si basa sulle specifiche MQTT v3.1.1 e MQTT v5.0, con alcune differenze. http://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html Per ulteriori informazioni, vedere Differenze MQTT.

S3 può essere un meccanismo di archiviazione dei dati conveniente che offre funzionalità di gestione dei dati durevoli e servizi dati a valle. È possibile utilizzare S3 per i dati relativi ai comportamenti di guida o all'analisi della manutenzione a lungo termine.

Timestream è un meccanismo di persistenza dei dati che può aiutarti a identificare tendenze e modelli quasi in tempo reale. Puoi utilizzare Timestream per dati di serie temporali, ad esempio per analizzare le tendenze storiche della velocità o della frenata del veicolo.

Nota

Amazon Timestream non è disponibile nella regione Asia Pacifico (Mumbai).

(Facoltativo) dataExtraDimensions

Puoi aggiungere uno o più attributi per fornire informazioni aggiuntive per un segnale.

(Facoltativo) dataPartitions

Crea una partizione dati per archiviare temporaneamente i dati del segnale su un veicolo. Puoi configurare quando e come inoltrare i dati al cloud.

  • Specifica in che modo l' AWS IoT FleetWise archivia i dati su un veicolo o una flotta definendo la dimensione massima di archiviazione, il tempo minimo di vita e la posizione di archiviazione.

  • La campagna spoolingMode deve essereTO_DISK.

  • Il caricamento delle configurazioni include la definizione della versione del linguaggio delle condizioni e dell'espressione logica.

(Facoltativo) description

Aggiungi una descrizione per identificare lo scopo della campagna.

(Facoltativo) diagnosticsMode

Quando la modalità diagnostica è configurataSEND_ACTIVE_DTCS, la campagna invia codici di errore diagnostici standard (DTC) memorizzati che aiutano a identificare il problema del veicolo. Ad esempio, P0097 indica che il modulo di controllo del motore (ECM) ha rilevato che l'ingresso del sensore di temperatura dell'aria di aspirazione 2 (IAT2) è inferiore al normale intervallo del sensore.

Per impostazione predefinita (OFF), il software Edge Agent non invia codici diagnostici.

(Facoltativo) expiryTime

Definisci la data di scadenza della tua campagna. Quando la campagna scade, il software Edge Agent interrompe la raccolta dei dati come specificato in questa campagna. Se sul veicolo vengono distribuite più campagne, il software Edge Agent utilizza altre campagne per raccogliere dati.

Valore predefinito: 253402243200 (31 dicembre 9999, 00:00:00 UTC)

(Facoltativo) postTriggerCollectionDuration

È possibile definire una durata di raccolta dopo l'attivazione, in modo che il software Edge Agent continui a raccogliere dati per un periodo specificato dopo l'invocazione di uno schema. Ad esempio, se viene richiamato uno schema di raccolta basato su condizioni con la seguente espressione:$variable.`myVehicle.Engine.RPM` > 7000.0, il software Edge Agent continua a raccogliere i valori dei giri al minuto (RPM) per il motore. Anche se l'RPM supera i 7000 solo una volta, potrebbe indicare che c'è un problema meccanico. In questo caso, è possibile che il software Edge Agent continui a raccogliere dati per monitorare la condizione.

Valore predefinito: 0

(Facoltativo) priority

Specifica un numero intero per indicare il livello di priorità della campagna. Le campagne con un numero inferiore hanno priorità più elevate. Se distribuisci più campagne su un veicolo, le campagne con priorità più alta vengono avviate per prime.

Valore predefinito: 0

(Facoltativo) signalsToCollect

Un elenco di segnali da cui vengono raccolti i dati quando viene richiamato lo schema di raccolta dati.

  • name— il nome del segnale da cui vengono raccolti i dati quando viene richiamato lo schema di raccolta dati.

  • dataPartitionId— l'ID della partizione dati da utilizzare nel segnale. L'ID deve corrispondere a uno degli ID forniti indataPartitions. Se si carica un segnale come condizione nella partizione dati, è necessario includere gli stessi segnali. signalsToCollect

  • (Facoltativo)maxSampleCount: il numero massimo di campioni di dati che il software Edge Agent raccoglie e trasferisce nel cloud quando viene richiamato lo schema di raccolta dati.

  • (Facoltativo)minimumSamplingIntervalMs: la durata minima tra due eventi di raccolta dei campioni di dati, in millisecondi. Se un segnale cambia spesso, puoi utilizzare questo parametro per raccogliere dati a una velocità inferiore.

    Intervallo valido: 0‐4294967295

(Facoltativo) spoolingMode

Se spoolingMode è configurato perTO_DISK, il software Edge Agent archivia temporaneamente i dati localmente quando un veicolo non è connesso al cloud. Una volta ristabilita la connessione, i dati archiviati localmente vengono trasferiti automaticamente nel cloud.

Valore predefinito: OFF

(Facoltativo) startTime

Una campagna approvata viene attivata all'inizio.

Valore predefinito: 0

Lo stato di una campagna può essere uno dei seguenti valori.

  • CREATING— AWS L'IoT FleetWise sta elaborando la tua richiesta di creazione della campagna.

  • WAITING_FOR_APPROVAL— Una volta creata, una campagna entra nello WAITING_FOR_APPROVAL stato. Per approvare la campagna, utilizza l'operazione UpdateCampaign API. Dopo l'approvazione della campagna, l' AWS IoT la distribuisce FleetWise automaticamente sul veicolo o sulla flotta di destinazione. Per ulteriori informazioni, consulta Aggiornare un AWS FleetWise Campagna IoT.

  • RUNNING — La campagna è attiva.

  • SUSPENDED— La campagna è sospesa. Per riprendere la campagna, utilizza l'operazione UpdateCampaign API.

AWS L'IoT FleetWise fornisce le seguenti operazioni API che puoi utilizzare per creare e gestire le campagne.

  • CreateCampaign— Crea una nuova campagna.

  • UpdateCampaign— Aggiorna una campagna esistente. Dopo aver creato una campagna, è necessario utilizzare questa operazione API per approvare la campagna.

  • DeleteCampaign— Elimina una campagna esistente.

  • ListCampaigns— Recupera un elenco di riepiloghi per pagine per tutte le campagne.

  • GetCampaign— Recupera informazioni su una campagna.

Esercitazioni