OBD Dati del veicolo

OBD viene utilizzato per leggere i dati forniti dal controller del veicolo. Il controller del veicolo, chiamato anche ECU, è responsabile del motore, della trasmissione e di altri sistemi; CapDrive invia richieste a questi controller tramite l'adattatore e converte i dati ricevuti in letture.

Un "parametro" nell'app è un dato da leggere e visualizzare, come il regime del motore (RPM), la temperatura del liquido di raffreddamento o uno stato. Contiene richieste di lettura, formule di conversione e unità. I parametri numerici possono essere utilizzati per numeri, progresso o curve; i parametri di stato possono essere visualizzati come D, P, ecc. tramite la mappatura del testo.

Ad esempio, il parametro della temperatura del liquido di raffreddamento può essere ottenuto utilizzando la richiesta 0105 per ottenere un byte di dati A e convertito secondo A - 40. Se il valore decimale del byte restituito è 123, il risultato è 83 °C. Il metodo di connessione, la definizione della richiesta e le regole di conversione devono essere corrette per ottenere letture utilizzabili.

I parametri supportati dal veicolo dipendono dal modello, dall'anno, dal sistema di alimentazione e dallo stato del controller. Possono essere letti solo i valori effettivamente forniti dal veicolo, e la modifica del nome o delle unità non aumenta la capacità dati del veicolo stesso.

La connessione al OBD del veicolo richiede CapDrive Plus, Adattatore Bluetooth a basso consumo energetico (BLE). che supporti le istruzioni ELM327 e le autorizzazioni Bluetooth sull'iPhone. Gli adattatori Bluetooth classici e Wi-Fi non sono attualmente supportati.

Solo dopo che l'adattatore è collegato all'interfaccia OBD del veicolo e acceso come richiesto dal veicolo, l'App può comunicare con il veicolo. Alcuni parametri richiedono che il veicolo si trovi in ​​uno stato specifico, ad esempio il controller acceso, il motore acceso o il sistema corrispondente operativo. L'inclusione di "Bluetooth" nel nome di un adattatore non dimostra da sola la sua conformità con BLE e con la direttiva.

La lettura OBD, Non è necessario iniziare prima un viaggio, può essere visualizzata e testata nell'elenco dei parametri o nell'editor dei parametri. L'inizio del viaggio con il cellulare non determina se il veicolo restituirà la temperatura del liquido di raffreddamento, la velocità (RPM) e altri parametri.

CapDrive supporta la configurazione delle richieste di lettura per i servizi esadecimali 01, 21, 22. Per l'uso normale è possibile utilizzare la preimpostazione adatta al veicolo; l'indirizzo e la formula specifica della richiesta sono soggetti alla definizione dei parametri preimpostati o del veicolo.

Voce: Altro (…) → Connessione OBD del veicolo. La pagina del dispositivo visualizza gli adattatori vicini e i dispositivi salvati e la configurazione dei parametri dell'adattatore viene salvata nelle impostazioni del dispositivo.

Prima connessione e riconnessione

Quando si connette per la prima volta, l'App stabilirà la comunicazione Bluetooth, inizializzerà l'adattatore, identificherà il protocollo del veicolo e interrogherà il veicolo per segnalare i parametri standard supportati. Al termine dell'operazione, i parametri standard inizializzabili verranno aggiunti all'elenco dei dispositivi. Il fatto che i parametri standard abbiano valori nello stato corrente dipende dai risultati effettivi della lettura.

Quando un dispositivo esistente si riconnette, continuerà a utilizzare la configurazione originale, inclusi i parametri modificati e gli elenchi attivamente cancellati. Dopo aver eliminato un parametro, la riconnessione non lo aggiungerà nuovamente. Quando sono necessarie letture supplementari, è possibile importare parametri nuovi o preimpostati.

Origine dati corrente

Il "dispositivo corrente" si riferisce all'adattatore che fornisce i dati del veicolo a CapDrive. È possibile utilizzare un solo dispositivo alla volta come origine dati corrente. I parametri e le impostazioni di ciascun dispositivo vengono salvati in modo indipendente; nel passaggio ad un altro dispositivo i riferimenti ai parametri del dispositivo precedente non verranno utilizzati automaticamente.

La disconnessione mantiene la configurazione. Ignora dispositivo rimuoverà la configurazione e la cache del dispositivo. Quando è necessario migrare i parametri, è possibile esportare la configurazione e quindi importarla nel dispositivo di destinazione; per gli strumenti personalizzati, è necessario selezionare nuovamente i parametri sotto il dispositivo di destinazione.

Il default è un insieme di configurazioni di lettura dei parametri già scritte, eliminando la necessità di compilare richieste e formule articolo per articolo. La preimpostazione standard OBD-II fornisce parametri standard e la preimpostazione del modello di veicolo fornisce le definizioni dei parametri per il modello di veicolo corrispondente. Quando si seleziona un modello preimpostato, è necessario controllare l'anno del modello e la versione di potenza.

Importa nel dispositivo specificato

Aprire la libreria di configurazione dalla parte inferiore dell'elenco dei parametri del dispositivo. Il download nell'App consentirà l'accesso all'interfaccia di importazione del dispositivo; scaricando il file JSON tramite il browser è possibile selezionare Importa configurazione nel menu delle impostazioni del dispositivo.

Per impostazione predefinita, l'elenco di importazione è deselezionato e vengono salvati solo i parametri esplicitamente selezionati. Puoi prima controllare il nome e la lettura corrente, quindi controllare la configurazione tramite l'ingranaggio a destra. La chiusura dell'interfaccia di importazione non salverà le bozze non confermate.

Duplicati e aggiornamenti di configurazione

I parametri che hanno già lo stesso metodo di lettura, regola di decodifica e unità di output verranno contrassegnati come duplicati e continueranno a utilizzare l'identificatore del parametro originale. La sola modifica del nome visualizzato non rende lo stesso parametro un nuovo elemento letto.

Una richiesta può fornire più parametri, come due temperature nella stessa risposta; lo stesso nome può provenire anche da controllori diversi o formule diverse, quindi i duplicati non possono essere giudicati solo dal nome. Gli elementi con richieste modificate o regole di decodifica vengono importati come nuovi parametri e non sovrascrivono i vecchi elementi solo per nome.

Quando viene importato in un altro adattatore, viene stabilito il riferimento al parametro del dispositivo di destinazione. La strumentazione personalizzata dovrebbe riselezionare i parametri corrispondenti del dispositivo di destinazione nell'associazione di input; mantenere invariato l'identificatore di input e non è necessario modificare il codice.

Vincoli dei file

La configurazione utilizza JSON, l'identificatore del formato è capdrive.obd e appVersion è la versione dell'app richiesta; il numero di versione corrente dell'app viene scritto durante l'esportazione. Quando la versione non è sufficiente, ti verrà richiesto di eseguire l'aggiornamento. Un singolo file può contenere fino a 5 MiB e contenere fino a 3.000 parametri. Il file salva la configurazione di lettura e non contiene la connessione Bluetooth del dispositivo, né garantisce che tutti gli elementi saranno leggibili sul veicolo di destinazione.

Apri l'editor tramite l'ingranaggio a destra dei parametri. Di seguito vengono descritti i campi nell'ordine “cosa leggere dal veicolo → come convertire → come determinare la validità”. Prova lettura utilizza la configurazione corrente nell'editor per verificare i risultati; dopo aver cliccato su Salva, le modifiche diventano la configurazione salvata del dispositivo.

Nome e frequenza di aggiornamento

Il nome viene utilizzato per identificare i parametri del veicolo. Gli identificatori interni sono gestiti automaticamente dall'app e non vengono compilati nell'editor dei parametri, né vengono richiesti PID; le preimpostazioni esportate non contengono identificatori nativi del dispositivo. Lo script dello strumento utilizza il proprio identificatore di input definito e seleziona i parametri del veicolo tramite l'associazione dell'input.

Intervallo di lettura (secondi) viene riempito in secondi e l'intervallo è 0.3–99999. Ad esempio, 1 secondo significa che l'intervallo della query di destinazione è 1 secondo. L'aggiornamento effettivo è influenzato anche dalla risposta del veicolo, da altre richieste e dai requisiti di lettura attuali. Gli elementi visibili nell'elenco dei parametri, nella selezione dello strumento e nell'utilizzo dei dati di viaggio creano requisiti di lettura; la semplice importazione dei parametri non fa sì che l'intero elenco venga sempre interrogato con una frequenza fissa. I parametri che condividono la stessa richiesta possono essere riutilizzati in una risposta.

richiedere le impostazioni

Formule di conversione, ordine dei byte e unità

La risposta del veicolo è solitamente costituita da byte di dati. A rappresenta il primo byte di dati, B rappresenta il secondo e così via, esclusa l'intestazione del protocollo. Una formula supporta operazioni aritmetiche, bit a bit, confronti, operazioni logiche ed espressioni condizionali; non è uno script che può chiamare funzioni JavaScript arbitrarie.

Ad esempio, la temperatura del liquido di raffreddamento utilizza A - 40; il regime motore standard (RPM) utilizza (A * 256 + B) / 4. Se A = 26, B = 248, quest'ultimo ottiene 1726 rpm. La formula di un parametro dovrebbe essere coerente con il significato dei byte restituiti dalla richiesta.

L'endianness determina il modo in cui vengono interpretati i campi multibyte: big-endian mette per primo il byte di ordine superiore, little-endian mette per primo il byte di ordine inferiore. L'App esegue la formula numerica dopo l'ordine di elaborazione configurato e la formula non deve scambiare nuovamente byte ripetutamente.

L'unità del risultato della formula deve essere distinta dall'unità di visualizzazione. La modifica del nome dell'unità personalizzata modifica solo l'etichetta e non modifica il valore della formula; quando si seleziona un'unità di visualizzazione compatibile per una quantità fisica standard esistente, l'App può eseguire la conversione corrispondente. Si prega di controllare le unità originali utilizzate nella formula per evitare conversioni ripetute.

Condizioni di lettura e range valido

La risposta supera i controlli di lunghezza e condizione di lettura prima di essere decodificata. Il risultato digitale viene prima limitato, quindi vengono controllati i limiti superiore e inferiore effettivi; non viene emessa alcuna lettura quando non è possibile ottenere un valore finito. La condizione di lettura utilizza la risposta grezza prima della conversione dell'ordine dei byte.

mappatura del testo

La mappatura del testo visualizza un valore ottenuto da una formula come testo, ad esempio 1 → D. La chiave supporta decimali e numeri negativi e deve essere un valore finito univoco. 1.5 e 1.50 rappresentano lo stesso elemento. Il valore letterale può essere una stringa vuota.

Quando viene raggiunta la mappatura, viene restituita la stringa corrispondente; quando non viene premuto, viene restituito un numero quando Restituisci il numero originale senza corrispondenza è acceso e viene restituito null quando è spento. Questa impostazione senza corrispondenza si applica quando esiste una mappatura. Il testo colpito non continuerà a eseguire il ritaglio digitale.

Pertanto, lo stesso parametro può restituire un numero, un testo o un valore null e il codice di strumentazione deve gestire il tipo effettivo del parametro. Quando si verifica la situazione "alcuni valori possono essere visualizzati e altri valori scompaiono", è necessario verificare se la mappatura corrisponde e se le impostazioni non corrispondono.

Salvataggio e messaggio di errore

Le configurazioni non valide indicheranno i campi e i motivi, quindi verranno salvate o testate dopo la correzione. PID dei servizi 01 e 21 è un numero esadecimale a due cifre, 22 è di quattro cifre; CAN ID è composto da 3 o 8 cifre e l'indirizzo esteso e i parametri di timeout sono due cifre. L'intervallo di lettura è 0.3–99999 secondi, il numero minimo di byte di risposta è un numero intero di 0–4096 e la formula e le condizioni di lettura sono ciascuna fino a 1.024 UTF-8 byte. Il valore deve essere limitato, il valore minimo non può essere maggiore del valore massimo e il limite inferiore valido deve essere inferiore al limite superiore valido; la chiave di mappatura del testo non può essere ripetuta.

Sostituisci dati del viaggio fa sì che la lettura di base utilizzi il parametro OBD specificato. Ad esempio, specificando un parametro di velocità del veicolo come "Velocità", il campo della velocità di base, gli indicatori integrati associati e i record di viaggio possono utilizzare questa lettura del veicolo.

Obiettivi alternativi includono velocità, G longitudinale, G laterale, beccheggio e rollio. Accetta km/h o mph per la velocità, g o m/s² per l'accelerazione e gradi o radianti per l'angolo. L'app convertirà le unità secondo necessità per il target.

La sostituzione richiede che i parametri vengano forniti con numeri, unità e intervalli appropriati. I parametri con mappatura testo non possono essere utilizzati per la sostituzione del tratto; verranno rifiutati anche i risultati originali al di fuori dell'intervallo di configurazione e i valori limite dopo la limitazione non verranno considerati misurazioni della corsa valide.

Utilizzare questa sorgente quando sono presenti letture OBD valide; ricorrere ai dati mobili quando le letture mancano, sono scadute o non sono valide. Questa lettura di base potrebbe essere ancora vuota quando anche la sorgente mobile non è disponibile. L'importazione ordinaria dei parametri non specifica automaticamente le destinazioni sostitutive.

Parametri come la temperatura del liquido refrigerante, la velocità di rotazione (RPM), ecc. possono essere visualizzati separatamente nello strumento personalizzato e i relativi riferimenti OBD possono essere utilizzati direttamente senza configurare la sostituzione della corsa.

Fai clic sull'ingranaggio accanto a Impostazioni strumento → Associazioni di ingresso per inserire Configurazione dei parametri e aggiungi un input Dati OBD, ad esempio l'identificatore coolant. Ritornare all'associazione di input e selezionare il parametro Temperatura del liquido di raffreddamento in Dispositivi. Lo script legge $data.current.coolant; non è necessario scrivere l'UUID dei parametri del veicolo nel codice.

Le letture includono value e unit, ad esempio { value: 83, unit: '°C' }. Le mappature di valori a testo possono anche restituire stringhe, il tipo deve essere controllato prima della formattazione del numero. Quando non è vincolato, l'intero input è null; quando è associato ma non viene eseguita alcuna lettura temporanea, value è null e unit accetta ancora l'unità di configurazione.

Dopo aver importato i lavori di altre persone o aver cambiato l'adattatore, ricollega l'input esistente per continuare a utilizzare il codice. Il tipo previsto viene utilizzato per i suggerimenti, il valore restituito dal veicolo non viene assegnato. L'anteprima utilizza l'ingresso analogico e il dispositivo corrente e Prova lettura devono essere controllati quando si confermano i dati reali del veicolo.

Stato di lettura

La connessione è valida, la risposta è ricevuta e la lettura è valida sono tre diverse condizioni. La risposta potrebbe non produrre un valore utilizzabile a causa di lunghezza insufficiente, condizioni di lettura non soddisfatte, formula non valida o mancata mappatura del testo.

Le letture di runtime hanno una data di scadenza. Dopo la disconnessione, un errore di lettura o la scadenza dei dati, lo strumento e la sostituzione del dispositivo di protezione non dovrebbero continuare a utilizzare il vecchio valore come dati attualmente validi. L'elenco dei parametri può conservare l'ultima lettura riuscita a scopo dimostrativo che non equivale a un output live valido; il risultato della richiesta corrente può essere controllato utilizzando Prova lettura.

Zero è un valore valido e un valore nullo significa che al momento non sono disponibili letture. La stringa vuota nella mappa testo è il risultato del testo corrispondente, anch'esso diverso dal test mancante.

Localizzare per livello di guasto

Il feedback sul problema può includere le seguenti informazioni per distinguere tra problemi di connettività, problemi di configurazione e problemi di visualizzazione:

• Modello, anno, versione di alimentazione e modello dell'adattatore.
• Nomi attuali del dispositivo, delle preimpostazioni e dei parametri.
• Testare i risultati di lettura o gli errori specifici.
• Interessa tutti i parametri o parametri individuali e se il problema si verifica nell'elenco dei parametri, nella sostituzione del viaggio o nello strumento personalizzato.