Comando CXAIN - Configuración de Entradas Analógicas

Configura la interpretación de las magnitudes leídas por las entradas AD del dispositivo, permitiendo transformar y escalar los valores según la aplicación.

¿Para qué sirve?

Caso de uso	Descripción
📊 Sensores de combustible	Convertir voltaje a litros o porcentaje
🌡️ Sensores de temperatura	Transformar señal analógica a °C
⚡ Medición de tensión	Escalar lecturas de voltaje
📈 Calibración personalizada	Ajustar lecturas a unidades específicas

Comandos Relacionados

Se recomienda recalibrar la constante de lectura analógica a través del Comando AR
La lectura del valor AD de cada entrada se puede obtener a través del Comando AIN
Si se desea consultar todas las lecturas obtenidas por la totalidad de entradas AD del dispositivo o bien generar un reporte con dichos valores, utilizar el Reporte AD

Comandos

Configurar


SCXAINaabccccdeeeefgggghiiiijkkkklmmmm

Consultar


QCXAINaa

Respuesta


RCXAINaabccccdeeeefgggghiiiijkkkklmmmm

Parámetros

Campo	Descripción	Rango
aa	Índice de la entrada analógica	`00`, `01`, `02`, `07`
b	Signo del límite inferior de salida (BOTTOM)	`+` / `-`
cccc	Magnitud del límite inferior de salida (BOTTOM)	`0000`–`9999`
d	Signo del límite superior de salida (TOP)	`+` / `-`
eeee	Magnitud del límite superior de salida (TOP)	`0000`–`9999`
f	Signo del voltaje del primer punto de calibración (XA)	`+` / `-`
gggg	Voltaje del primer punto XA en centésimas de volt (`0500` = 5,00 V)	`0000`–`9999`
h	Signo del voltaje del segundo punto de calibración (XB)	`+` / `-`
iiii	Voltaje del segundo punto XB en centésimas de volt (`0500` = 5,00 V)	`0000`–`9999`
j	Signo del valor de salida del primer punto (YA)	`+` / `-`
kkkk	Valor de salida correspondiente a XA (YA) — unidad libre	`0000`–`9999`
l	Signo del valor de salida del segundo punto (YB)	`+` / `-`
mmmm	Valor de salida correspondiente a XB (YB) — unidad libre	`0000`–`9999`

Cómo se calcula el valor reportado

El dispositivo aplica una interpolación lineal entre los dos puntos (XA, YA) y (XB, YB) sobre el voltaje leído, y luego recorta la salida al rango [BOTTOM, TOP]:


Y = YA + (Vin − XA) · (YB − YA) / (XB − XA)
salida = clamp(Y, BOTTOM, TOP)

Vin se expresa en centésimas de volt (igual que XA y XB).
YA, YB, BOTTOM y TOP están en la unidad de salida que vos elijas (litros, %, °C, mV, etc.).
El clamp garantiza que un voltaje fuera del rango calibrado nunca produzca valores absurdos.

XA y XB no son décimas, son centésimas de volt. Por ejemplo:

0500 = 5,00 V
1230 = 12,30 V
3300 = 33,00 V

Equivocarse de escala (poner 0050 pensando en “5 V”) es el error más común al configurar este comando.

Ejemplos

Sensor de combustible resistivo 0–5 V → 0–100 %

Sensor lineal cuya salida varía de 0 V (tanque vacío) a 5 V (tanque lleno).


>SCXAIN01+0000+0100+0000+0500+0000+0100<
// aa   = 01     → entrada AD1
// BOT  = +0000  → recorte inferior de salida = 0 %
// TOP  = +0100  → recorte superior de salida = 100 %
// XA   = +0000  → 0,00 V  (tanque vacío)
// XB   = +0500  → 5,00 V  (tanque lleno)
// YA   = +0000  → 0 %
// YB   = +0100  → 100 %

Sensor de combustible capacitivo 0–33 V → 0–200 L

Sensor de mayor rango (frecuente en camiones) que entrega hasta 33 V para un tanque de 200 litros.


>SCXAIN01+0000+0200+0000+3300+0000+0200<
// XA = 0,00 V  → 0 L
// XB = 33,00 V → 200 L
// Salida acotada al rango [0, 200] litros

Sensor de temperatura 0–5 V → −40 °C a +150 °C

Salida con offset negativo: a 0 V el sensor reporta −40 °C; a 5 V reporta +150 °C.


>SCXAIN01-0040+0150+0000+0500-0040+0150<
// BOT  = -0040  → mínimo reportado = −40 °C
// TOP  = +0150  → máximo reportado = +150 °C
// XA   = +0000  → 0,00 V → YA = -0040 (−40 °C)
// XB   = +0500  → 5,00 V → YB = +0150 (+150 °C)

Lectura directa de batería 0–36 V

Mapeo identidad en centésimas de volt: la salida coincide con el voltaje (1245 → 12,45 V).


>SCXAIN01+0000+3600+0000+3600+0000+3600<
// XA = 0,00 V   → YA = 0
// XB = 36,00 V  → YB = 3600
// Salida acotada a [0, 3600] (centésimas de volt)

Passthrough — sin transformación (valor crudo del ADC)

Útil cuando se quiere obtener la lectura cruda del conversor sin escalado. Es el valor de fábrica.


>SCXAIN01-9999+9999-0000+0001-0000+0001<
// Pendiente unitaria con clamp a [-9999, +9999]
// Equivale a no aplicar ninguna conversión

Consultar la configuración actual de cualquier entrada se hace con QCXAINaa. El dispositivo responde con un RCXAIN que tiene exactamente el mismo formato que el SCXAIN enviado:


>QCXAIN01<
>RCXAIN01+0000+0100+0000+0500+0000+0100<

Compatibilidad

💾Firmware:v1.00.00

SPLegacy

ULLegacy

MTLegacy

C3Legacy

C5Legacy

SP-IOT

SM-IOT

ZE-IOT

Ver También

Comando AIN - Consulta entradas analógicas
Comando AR - Rangos analógicos
Reporte AD - Reporte de valores analógicos