Comandos CANxx
Familia de comandos para lectura de parámetros CAN desde la ECU del vehículo.
¿Para qué sirve?
| Caso de uso | Descripción |
|---|---|
| 🚛 Vehículos pesados | CAN00/CAN03 para camiones y buses con protocolo J1939 |
| 🚗 Vehículos livianos | CAN01 para autos con protocolo OBD-II/J1850 |
| 🚚 Trailers y remolques | CAN02 existe pero está deprecado: la rama no devuelve datos |
| ⛽ Consumo de combustible | CAN05 para lectura de FuelRate y sensor MAF |
| 🪪 Identificación del vehículo | CAN04 para leer el VIN |
| 🩺 Diagnóstico del bus | CAN06 para ver el estado del controlador CAN y sus contadores de error |
| 📋 Integración con reportes | CAN03 en formato ancho fijo para reportes Ux |
Descripción General
Los comandos CANxx permiten obtener información del vehículo a través del bus CAN. Cada variante está optimizada para diferentes protocolos y formatos de datos:
| Comando | Protocolo | Uso Principal |
|---|---|---|
| CAN00 | J1939 | Vehículos comerciales/pesados |
| CAN01 | J1850/OBD-II | Vehículos livianos |
| CAN02 | — (deprecado) | No devuelve datos: rama vacía en el firmware |
| CAN03 | J1939 (ancho fijo) | Integración con reportes Ux |
| CAN04 | OBD-II / J1939 | VIN del vehículo |
| CAN05 | Genérico | FuelRate y consumo |
| CAN06 | — | Diagnóstico del controlador CAN (desde v1.09.28) |
Antes de usar estos comandos, configure el bus CAN mediante CXCAN.
CAN00 - Parámetros J1939
Lectura de parámetros estándar usando protocolo J1939 para vehículos comerciales y pesados.
Consulta
QCAN00Respuesta
RCAN00 2010=value,5000=value,1030=value,4201=value,1020=value,1010=value,2012=value,2013=value,2020=value,3010=valueParámetros
| ID | Parámetro | Formato |
|---|---|---|
2010 | RPM | Decimal, 2 decimales (%.2f) |
5000 | Posición acelerador (%) | Decimal, 2 decimales (%.2f) |
1030 | Odolitro (L) | Decimal, 2 decimales (%.2f) |
4201 | Nivel combustible (%) | Decimal, 2 decimales (%.2f) |
1020 | Odómetro (Km) | Decimal, 2 decimales (%.2f) |
1010 | Velocidad rueda (Km/h) | Decimal, 2 decimales (%.2f) |
2012 | Temp. refrigerante (ºC) | Decimal, 2 decimales (%.2f) |
2013 | Presión aceite (kPa) | Decimal, 2 decimales (%.2f) |
2020 | Tiempo motor ON (h) | Decimal, 2 decimales (%.2f) |
3010 | Combustible trip (L) | Decimal, 2 decimales (%.2f) |
Ejemplo
>RCAN00 2010=1000.00,5000=0.00,1030=10000.00,4201=50.00,1020=20000.00,1010=60.00,2012=15.00,2013=100.00,2020=13.00,3010=0.13<CAN01 - Parámetros OBD-II
Lectura usando protocolo J1850/OBD-II para vehículos livianos.
Consulta
QCAN01Respuesta
RCAN01 1=value,2=value,3=value,B=value,14=value,15=value,2A=value,2C=valueParámetros
| ID | Parámetro | Formato |
|---|---|---|
1 | VIN | 17 caracteres; vacío si todavía no se leyó (ver CAN04) |
2 | RPM | Entero, sin decimales (%.0f) |
3 | Velocidad rueda (Km/h) | Entero, sin decimales (%.0f) |
B | Odómetro (Km) | Entero, sin decimales (%.0f) |
14 | Odolitro (L) | Entero, sin decimales (%.0f) |
15 | Nivel combustible (%) | Entero, sin decimales (%.0f) |
2A | Temp. refrigerante (ºC) | Entero, sin decimales (%.0f) |
2C | Presión aceite (kPa) | Entero, sin decimales (%.0f) |
Ejemplo
>RCAN01 1=2SA23000L2,2=1000,3=60,B=20000,14=100000,15=50,2A=15,2C=100<CAN02 - Reservado para Trailer ABS/EBS (deprecado)
El comando existe y responde CMDOK, pero engineGetAscii(type==2) es una rama vacía marcada // EBS DEPRECATED en el firmware: no arma ningún campo. RCAN02 no trae ningún dato — los campos red, amber, axle_load, whell_speed, vehicle_speed, dtc_0 y dtc_1 no existen en la respuesta real.
Consulta
QCAN02Respuesta
RCAN02No uses CAN02 para leer datos de trailer ABS/EBS: la rama está deprecada y no devuelve campos. Si necesitás esos parámetros, consultá con soporte técnico qué banco los reemplaza en tu versión de firmware.
CAN03 - Formato Ancho Fijo
Lectura en formato de ancho fijo, ideal para integración con reportes de usuario Ux.
Consulta
QCAN03Respuesta
RCAN03 aaaabbbcccddddddddeeefffggghhhhhhhiiiiiiiijjjjjjjjkkParámetros
| Campo | Largo | Parámetro | Formato | Unidad |
|---|---|---|---|---|
aaaa | 4 | Engine Speed | Decimal | RPM |
bbb | 3 | Accel PCT | Decimal | % |
ccc | 3 | Fuel PCT | Decimal | % |
dddddddd | 8 | Odometer Total | Hex | metros |
eee | 3 | Speed | Decimal | Km/h |
fff | 3 | Engine Temp | Decimal | °C |
ggg | 3 | Oil Press | Decimal | kPa |
hhhhhhh | 7 | Time Engine On | Hex | horas |
iiiiiiii | 8 | Fuel Trip | Hex | litros |
jjjjjjjj | 8 | Odoliter Total | Hex | litros |
kk | 2 | Age | Hex | segundos |
Los campos hexadecimales deben convertirse a decimal. Por ejemplo, si dddddddd = 0001E240, el odómetro es 123456 metros.
Ejemplo
>RCAN03 15000350500001E240060015100000012300012345006780010A<CAN04 - VIN
Lectura del VIN (número de identificación del vehículo) tal como lo informa la ECU.
Consulta
QCAN04Respuesta
RCAN04 <VIN>| Campo | Descripción |
|---|---|
VIN | 17 caracteres. Vacío (nada después del espacio) si todavía no se leyó |
Cómo obtiene el VIN el equipo
| Protocolo (en CXCAN) | Lectura del VIN |
|---|---|
OBDII | El equipo se lo pide a la ECU (servicio 09, PID 02) cada 10 s hasta obtenerlo |
J1939 | Lo toma del mensaje de VIN (PGN 65260) cuando el vehículo lo transmite por su cuenta |
J1939.TX | Además lo pide al bus, con hasta 8 intentos cada vez más espaciados (hasta ~5 min entre uno y otro). Si no contesta, deja de pedirlo hasta el próximo reinicio o cambio de configuración |
| Otros | No se lee: queda vacío |
El VIN se borra y se vuelve a leer cada vez que se reinicia el controlador CAN: al arrancar el equipo, al salir del modo de bajo consumo o al cambiar la configuración con CXCAN. En esos momentos RCAN04 puede venir vacío durante unos segundos.
Ejemplo
>QCAN04<
>RCAN04 9BWZZZ377VT004251<VIN todavía no leído:
>QCAN04<
>RCAN04 <CAN05 - FuelRate
Lectura de tasa de consumo de combustible (FuelRate).
Consulta
QCAN05Respuesta
RCAN05 FR_HW=value,FR_SW=value,MAF=valueParámetros
| Campo | Parámetro | Descripción | Unidad |
|---|---|---|---|
FR_HW | FuelRate Hardware | Lectura directa del sensor | L/h |
FR_SW | FuelRate Software | Cálculo basado en MAF | L/h |
MAF | Mass Air Flow | Sensor de flujo de aire | g/s |
Ejemplo
>RCAN05 FR_HW!3,FR_SW=89.60,MAF=300.00;ID=869084063093789;*5A<El FR_SW se calcula a partir del sensor MAF cuando no está disponible el valor directo por hardware.
CAN06 - Salud del Controlador CAN
Estado del controlador CAN del equipo y contadores de error desde el arranque. Sirve para diagnosticar problemas del bus (cableado, terminación, velocidad) y para confirmar que el controlador está funcionando bien.
Consulta
QCAN06Respuesta
RCAN06 <estado>,<resets>,<desbordes>,<perdidas>,<errores_bus>Como en el resto de la familia, la respuesta lleva un espacio después de RCAN06. Disponible desde la v1.09.28.
Estado
| Estado | Significado |
|---|---|
RUN | Controlador funcionando normalmente |
STOP | Controlador detenido (estado transitorio) |
BOFF | Bus-off: el controlador se desconectó del bus por exceso de errores |
RECV | Recuperándose de un bus-off |
OFF | Controlador apagado: CAN no configurado o deshabilitado, o el equipo en modo de bajo consumo (KO++) |
Contadores
| Campo | Qué cuenta |
|---|---|
resets | Veces que el firmware reinició el controlador por un error conocido del chip (protección contra una trama corrupta o un buffer de recepción trabado). Lo normal es 0. Dos reinicios muy seguidos pueden contarse como uno |
desbordes | Mensajes perdidos porque se llenó el buffer de recepción del chip |
perdidas | Mensajes que el firmware no alcanzó a leer (cola de recepción llena) o que se descartaron en un reinicio del controlador |
errores_bus | Errores eléctricos o de protocolo detectados en el bus |
Los contadores se conservan aunque el controlador CAN se apague y se vuelva a prender (modo de bajo consumo, cambio de configuración, recuperación de un bus-off). Sólo vuelven a 0 cuando se reinicia el equipo.
Cómo leerlo en campo
| Lo que se ve | Interpretación | Qué hacer |
|---|---|---|
RUN con todos los contadores en 0 o casi quietos | Bus sano | Nada |
errores_bus sube miles por segundo | El equipo transmite y nadie le contesta. Es lo que pasa con el CAN habilitado en OBDII y sin ECU conectada | Revisar que el equipo esté conectado al bus, el cableado (CAN-H / CAN-L cortados o invertidos), la terminación y la velocidad configurada en CXCAN |
errores_bus sube de a poco pero en forma sostenida | Ruido o una conexión floja | Revisar conexiones, masa y terminación |
BOFF o RECV | El controlador se desconectó por exceso de errores | Igual que arriba |
desbordes o perdidas suben | Mucho tráfico en el bus: se pierden algunos mensajes | Enviar la respuesta a Rinho |
resets mayor a 0 | Actuó la protección contra errores del chip | Enviar la respuesta a Rinho (no requiere acción en el vehículo) |
OFF | CAN apagado o equipo en bajo consumo | Verificar la configuración con CXCAN y el estado de la ignición |
En un vehículo funcionando normalmente los contadores quedan casi quietos. En modo LISTEN el equipo no transmite, así que sin ECU errores_bus no sube. Para medir, hacé dos consultas separadas por un tiempo conocido y compará. Si el equipo tuvo un reinicio INT_WDT (ver QRST), enviá también la respuesta de QCAN06 a Rinho.
Ejemplos
Bus sano:
>QCAN06<
>RCAN06 RUN,0,0,0,0<CAN habilitado en OBD-II, sin ECU conectada (los errores de bus suben sin parar):
>QCAN06<
>RCAN06 RUN,0,0,0,125874<Códigos de Error
Comunes a todos los comandos CANxx:
| Código | Descripción |
|---|---|
=value | Valor válido |
= (vacío tras el igual) | Parámetro no leído, sólo en CAN01 (ej. 15=) |
!3 | Sin información disponible (dato vencido), en CAN00 y CAN05 |
El firmware sólo genera el código !3; generalmente indica que el vehículo no soporta el parámetro o que hay un problema de conexión física con el bus CAN. Los códigos !1 y !2 no existen en ninguna versión actual del firmware.
Compatibilidad
Rinho Zero IoT no tiene transceptor CAN: en ese modelo estos comandos responden
RCANS NA. Para leer el bus del vehículo se debe usar Spider IoT o Smart IoT.
Ver También
- Comando CXCAN - Configuración del bus CAN
- Comando QRST - Caja negra de reinicios
- Comando ECU - Lectura flexible de variables CAN
- Comando CXECU - Configuración ECU
- Comando Ux - Reportes de usuario personalizados