OBD Datos del vehículo

OBD se utiliza para leer datos proporcionados por el controlador del vehículo. El controlador del vehículo, también llamado ECU, es responsable del motor, la transmisión y otros sistemas; CapDrive envía solicitudes a estos controladores a través del adaptador y convierte los datos recibidos en lecturas.

Un "parámetro" en la aplicación es un dato que se lee y muestra, como la velocidad del motor (RPM), la temperatura del refrigerante o un estado. Contiene solicitudes de lectura, fórmulas de conversión y unidades. Los parámetros numéricos se pueden utilizar para números, progreso o curvas; Los parámetros de estado se pueden mostrar como D, P, etc. mediante mapeo de texto.

Por ejemplo, el parámetro de temperatura del refrigerante se puede obtener utilizando la solicitud 0105 para obtener un byte de datos A y convertirlo de acuerdo con A - 40. Si el valor decimal del byte devuelto es 123, el resultado es 83 °C. El método de conexión, la definición de la solicitud y las reglas de conversión deben ser correctos para obtener lecturas utilizables.

Los parámetros que admite el vehículo dependen del modelo, año, sistema de energía y estado del controlador. Sólo se pueden leer los valores realmente proporcionados por el vehículo, y modificar el nombre o las unidades no aumenta las capacidades de datos del propio vehículo.

La conexión del vehículo OBD requiere CapDrive Plus, Adaptador Bluetooth de bajo consumo (BLE) que admita instrucciones ELM327 y permisos de Bluetooth en el iPhone. Actualmente no se admiten los adaptadores Bluetooth clásicos y Wi-Fi.

Solo después de que el adaptador esté enchufado a la interfaz OBD del vehículo y encendido según lo requiera el vehículo, la aplicación podrá comunicarse con el vehículo. Ciertos parámetros requieren que el vehículo se encuentre en un estado específico, como que el controlador esté encendido, el motor en marcha o el sistema correspondiente esté operativo. La inclusión de "Bluetooth" en el nombre de un adaptador no prueba por sí sola que cumple con BLE y la directiva.

La lectura de OBD, No es necesario comenzar un viaje primero, se puede ver y probar en la lista de parámetros o en el editor de parámetros. El hecho de que el viaje con el teléfono móvil haya comenzado no determina si el vehículo regresará a la temperatura del refrigerante, la velocidad (RPM) y otros parámetros.

CapDrive admite la configuración de solicitudes de lectura para servicios hexadecimales 01, 21, 22. Para uso normal, se puede utilizar el preajuste que coincida con el vehículo; La dirección de solicitud específica y la fórmula están sujetas a la definición de parámetros preestablecidos o del vehículo.

Entrada: Más (…) → Conexión OBD del vehículo. La página del dispositivo muestra los adaptadores cercanos y los dispositivos guardados, y la configuración de parámetros del adaptador se guarda en la configuración del dispositivo.

Conexión y reconexión por primera vez.

Al conectarse por primera vez, la aplicación establecerá comunicación Bluetooth, inicializará el adaptador, identificará el protocolo del vehículo y consultará al vehículo para informar los parámetros estándar admitidos. Después del éxito, los parámetros estándar inicializables se agregarán a la lista de dispositivos. Si los parámetros estándar tienen valores en el estado actual depende de los resultados de la lectura real.

Cuando un dispositivo existente se vuelve a conectar, continuará usando la configuración original, incluidos los parámetros modificados y las listas borradas activamente. Después de eliminar un parámetro, al volver a conectarse no se volverá a agregar. Cuando se necesitan lecturas suplementarias, se pueden importar parámetros preestablecidos o nuevos.

Fuente de datos actual

El "dispositivo actual" se refiere al adaptador que proporciona datos del vehículo a CapDrive. Solo se puede utilizar un dispositivo como fuente de datos actual a la vez. Los parámetros y configuraciones de cada dispositivo se guardan de forma independiente; al cambiar a otro dispositivo, las referencias de parámetros del dispositivo anterior no se utilizarán automáticamente.

La desconexión conserva la configuración. Ignorar dispositivo eliminará la configuración y el caché del dispositivo. Cuando necesite migrar parámetros, puede exportar la configuración y luego importarla al dispositivo de destino; Para instrumentos personalizados, debe volver a seleccionar los parámetros en el dispositivo de destino.

El valor predeterminado es un conjunto de configuraciones de lectura de parámetros ya escritas, lo que elimina la necesidad de completar solicitudes y fórmulas elemento por elemento. El valor preestablecido estándar OBD-II proporciona parámetros estándar y el valor preestablecido del modelo de vehículo proporciona definiciones de parámetros para el modelo de vehículo correspondiente. Al seleccionar un modelo preestablecido, debe verificar el año del modelo y la versión de potencia.

Importar al dispositivo especificado

Abra la biblioteca de configuración desde la parte inferior de la lista de parámetros del dispositivo. La descarga en la aplicación ingresará a la interfaz de importación del dispositivo; Al descargar el archivo JSON a través del navegador, puede seleccionar Importar configuración en el menú de configuración del dispositivo.

La lista de importación no está marcada de forma predeterminada y solo se guardan los parámetros seleccionados explícitamente. Primero puede verificar el nombre y la lectura actual, y luego verificar la configuración a través del engranaje de la derecha. Cerrar la interfaz de importación no guardará los borradores no confirmados.

Duplicados y actualizaciones de configuración.

Los parámetros que ya tienen el mismo método de lectura, regla de decodificación y unidad de salida se marcarán como duplicados y continuarán usando el identificador de parámetro original. Sólo modificar el nombre para mostrar no convierte el mismo parámetro en un nuevo elemento de lectura.

Una solicitud puede proporcionar múltiples parámetros, como dos temperaturas en la misma respuesta; el mismo nombre también puede provenir de diferentes controladores o fórmulas diferentes, por lo que los duplicados no pueden juzgarse solo por el nombre. Los elementos con solicitudes modificadas o reglas de decodificación se importan como parámetros nuevos y no sobrescriben los elementos antiguos únicamente por su nombre.

Cuando se importa a otro adaptador, se establece la referencia de parámetros propia del dispositivo de destino. La instrumentación personalizada debe volver a seleccionar los parámetros correspondientes del dispositivo de destino en el enlace de entrada; mantenga el identificador de entrada sin cambios y no sea necesario modificar el código.

Restricciones de archivos

La configuración usa JSON, el identificador de formato es capdrive.obd y appVersion es la versión requerida de la aplicación; el número de versión actual de la aplicación se escribe al exportar. Cuando la versión sea insuficiente, se le pedirá que actualice. Un solo archivo puede tener hasta 5 MiB y contener hasta 3000 parámetros. El archivo guarda la configuración de lectura y no contiene la conexión Bluetooth del dispositivo, ni garantiza que todos los elementos serán legibles en el vehículo de destino.

Abra el editor a través del engranaje a la derecha de los parámetros. A continuación se describen los campos en el orden "qué leer del vehículo → cómo convertir → cómo determinar la validez". Probar lectura usa la configuración actual en el editor para verificar los resultados; después de hacer clic en Guardar, las modificaciones se convierten en la configuración guardada del dispositivo.

Nombre y frecuencia de actualización

El nombre se utiliza para identificar los parámetros del vehículo. Los identificadores internos son administrados automáticamente por la aplicación y no se completan en el editor de parámetros ni se solicitan PID; Los ajustes preestablecidos exportados no llevan identificadores nativos del dispositivo. El script del instrumento utiliza su propio identificador de entrada definido y selecciona los parámetros del vehículo mediante el enlace de entrada.

Intervalo de lectura (segundos) se completa en segundos y el rango es 0.3–99999. Por ejemplo, 1 segundo significa que el intervalo de consulta de destino es 1 segundo. La actualización real también se ve afectada por la respuesta del vehículo, otras solicitudes y los requisitos de lectura actuales. Los elementos visibles en la lista de parámetros, la selección de instrumentos y el uso de datos de viaje crean requisitos de lectura; La simple importación de parámetros no hace que toda la lista se sondee siempre con una frecuencia fija. Los parámetros que comparten la misma solicitud se pueden reutilizar en una respuesta.

configuración de solicitud

Fórmulas de conversión, orden de bytes y unidades.

La respuesta del vehículo suele ser bytes de datos. A representa el primer byte de datos, B representa el segundo, y así sucesivamente, excluyendo el encabezado del protocolo. Una fórmula admite operaciones aritméticas, bit a bit, comparaciones, operaciones lógicas y expresiones condicionales; no es un script que pueda llamar a funciones JavaScript arbitrarias.

Por ejemplo, la temperatura del refrigerante usa A - 40; La velocidad estándar del motor (RPM) utiliza (A * 256 + B) / 4. Si A = 26, B = 248, este último obtiene 1726 rpm. La fórmula de un parámetro debe ser coherente con el significado de los bytes devueltos por la solicitud.

La endianidad dicta cómo se interpretan los campos multibyte: big-endian coloca el byte de orden superior primero, little-endian coloca primero el byte de orden inferior. La aplicación ejecuta la fórmula numérica después del orden de procesamiento configurado y la fórmula no debe volver a intercambiar bytes repetidamente.

La unidad del resultado de la fórmula debe distinguirse de la unidad de visualización. Modificar el nombre de la unidad personalizada solo cambia la etiqueta y no modifica el valor de la fórmula; al seleccionar una unidad de visualización compatible para una cantidad física estándar existente, la aplicación puede realizar la conversión correspondiente. Verifique las unidades originales utilizadas en la fórmula para evitar conversiones repetidas.

Condiciones de lectura y rango válido.

La respuesta pasa verificaciones de longitud y condición de lectura antes de ser decodificada. Primero se limita el resultado digital y luego se verifican los límites superior e inferior efectivos; no se emite ninguna lectura cuando no se puede obtener un valor finito. La condición de lectura utiliza la respuesta sin formato antes de la conversión del orden de bytes.

mapeo de texto

La asignación de texto muestra un valor obtenido mediante una fórmula como texto, como 1 → D. La clave admite decimales y números negativos y debe ser un valor finito único. 1.5 y 1.50 representan el mismo artículo. Se permite que literal sea una cadena vacía.

Cuando se alcanza el mapeo, se devuelve la cadena correspondiente; cuando no se acierta, se devuelve un número cuando se activa Devolver el número original si no hay coincidencia y se devuelve null cuando se desactiva. Esta configuración inigualable se aplica cuando existe una asignación. El texto marcado no seguirá realizando recortes digitales.

Por lo tanto, el mismo parámetro puede devolver un número, texto o valor nulo, y el código de instrumentación debe manejar el tipo real del parámetro. Cuando ocurre la situación "algunos valores se pueden mostrar y otros valores desaparecen", debe verificar si la asignación coincide y si la configuración no coincide.

Guardar y mensaje de error

Las configuraciones no válidas indicarán los campos y los motivos, y luego las guardarán o probarán después de la corrección. PID de servicios 01 y 21 es un número hexadecimal de dos dígitos, 22 es de cuatro dígitos; CAN ID tiene 3 u 8 dígitos y los parámetros de dirección extendida y tiempo de espera son de dos dígitos. El intervalo de lectura es 0.3–99999 segundos, el número mínimo de bytes de respuesta es un número entero de 0–4096 y la fórmula y las condiciones de lectura son cada una de hasta 1024 UTF-8 bytes. El valor debe ser limitado, el valor mínimo no puede ser mayor que el valor máximo y el límite inferior válido debe ser menor que el límite superior válido; la clave de asignación de texto no se puede repetir.

Reemplazar datos del viaje hace que la lectura base utilice el parámetro OBD especificado. Por ejemplo, al especificar un parámetro de velocidad del vehículo como "Velocidad", el campo de velocidad base, los medidores integrados asociados y los registros de viaje pueden usar esta lectura del vehículo.

Los objetivos alternativos incluyen velocidad, G longitudinal, G lateral, cabeceo y balanceo. Acepta km/h o mph para velocidad, go m/s² para aceleración y grados o radianes para ángulo. La aplicación convertirá las unidades según sea necesario para el objetivo.

El reemplazo requiere que los parámetros se suministren con números, unidades y rangos apropiados. Los parámetros con asignación de texto no se pueden utilizar para reemplazar trazos; Los resultados originales fuera del rango de configuración también se rechazarán y los valores límite después de la limitación no se considerarán mediciones de carrera válidas.

Utilice esta fuente cuando haya lecturas de OBD válidas; recurra a los datos móviles cuando falten lecturas, hayan caducado o no sean válidas. Es posible que esta lectura base aún esté vacía cuando la fuente móvil tampoco esté disponible. La importación de parámetros ordinaria no especifica automáticamente objetivos de reemplazo.

Los parámetros como la temperatura del refrigerante, la velocidad de rotación (RPM), etc. se pueden mostrar por separado en el instrumento personalizado, y sus referencias OBD se pueden usar directamente sin configurar el reemplazo de carrera.

Haga clic en el engranaje al lado de Ajustes del instrumento → Vinculaciones de entrada para ingresar Configuración de parámetros y agregue una entrada Datos OBD, por ejemplo el identificador coolant. Regrese al enlace de entrada y seleccione el parámetro Temperatura del refrigerante en Dispositivos. El guión lee hasta $data.current.coolant; No es necesario escribir el UUID de los parámetros del vehículo en el código.

Las lecturas incluyen value y unit, por ejemplo { value: 83, unit: '°C' }. Las asignaciones de valores a texto también pueden devolver cadenas; se debe verificar el tipo antes de formatear el número. Cuando no está vinculado, toda la entrada es null; cuando está vinculado pero no hay lectura temporal, value es null y unit todavía toma la unidad de configuración.

Después de importar trabajos de otras personas o cambiar el adaptador, vuelva a vincular la entrada existente para continuar usando el código. El tipo esperado se utiliza para sugerencias, el valor de retorno del vehículo no se convierte. La vista previa utiliza entrada analógica y se deben verificar el dispositivo actual y Probar lectura al confirmar los datos reales del vehículo.

Estado de lectura

La conexión es válida, la respuesta es recibida y la lectura es válida son tres condiciones diferentes. Es posible que la respuesta no produzca un valor utilizable debido a una longitud insuficiente, condiciones de lectura insatisfechas, una fórmula no válida o un error en la asignación de texto.

Las lecturas en tiempo de ejecución tienen una fecha de vencimiento. Después de la desconexión, falla de lectura o vencimiento de los datos, el reemplazo del instrumento y del disparo no debe continuar usando el valor anterior como datos válidos actuales. La lista de parámetros puede conservar la última lectura exitosa con fines de demostración que no equivale a una salida en vivo válida; el resultado de la solicitud actual se puede verificar usando Probar lectura.

Cero es un valor válido y un valor nulo significa que actualmente no hay lecturas disponibles. La cadena vacía en el mapa de texto es el resultado del texto coincidente, que también es diferente de la prueba que falta.

Localizar por nivel de falla

Los comentarios sobre problemas pueden incluir la siguiente información para diferenciar entre problemas de conectividad, problemas de configuración y problemas de visualización:

• Modelo, año, versión de potencia y modelo de adaptador.
• Nombres de dispositivos, ajustes preestablecidos y parámetros actuales.
• Resultados de lectura de prueba o errores específicos.
• ¿Afecta a todos los parámetros o a parámetros individuales, y si el problema ocurre en la lista de parámetros, reemplazo de disparo o instrumento personalizado?