Comando CXAIN - Configuração de Entradas Analógicas

Configura a interpretação das magnitudes lidas pelas entradas AD do dispositivo, permitindo transformar e escalar os valores segundo a aplicação.

Para que serve?

Caso de uso	Descrição
📊 Sensores de combustível	Converter voltagem para litros ou porcentagem
🌡️ Sensores de temperatura	Transformar sinal analógico para °C
⚡ Medição de tensão	Escalar leituras de voltagem
📈 Calibração personalizada	Ajustar leituras para unidades específicas

Comandos Relacionados

Recomenda-se recalibrar a constante de leitura analógica através do Comando AR
A leitura do valor AD de cada entrada pode ser obtida através do Comando AIN
Se desejar consultar todas as leituras obtidas pela totalidade de entradas AD do dispositivo ou gerar um relatório com esses valores, utilizar o Reporte AD

Comandos

Configurar


SCXAINaabccccdeeeefgggghiiiijkkkklmmmm

Consultar


QCXAINaa

Resposta


RCXAINaabccccdeeeefgggghiiiijkkkklmmmm

Parâmetros

Campo	Descrição	Faixa
aa	Índice da entrada analógica	`00`, `01`, `02`, `07`
b	Sinal do limite inferior de saída (BOTTOM)	`+` / `-`
cccc	Magnitude do limite inferior de saída (BOTTOM)	`0000`–`9999`
d	Sinal do limite superior de saída (TOP)	`+` / `-`
eeee	Magnitude do limite superior de saída (TOP)	`0000`–`9999`
f	Sinal da voltagem do primeiro ponto de calibração (XA)	`+` / `-`
gggg	Voltagem do primeiro ponto XA em centésimos de volt (`0500` = 5,00 V)	`0000`–`9999`
h	Sinal da voltagem do segundo ponto de calibração (XB)	`+` / `-`
iiii	Voltagem do segundo ponto XB em centésimos de volt (`0500` = 5,00 V)	`0000`–`9999`
j	Sinal do valor de saída do primeiro ponto (YA)	`+` / `-`
kkkk	Valor de saída correspondente a XA (YA) — unidade livre	`0000`–`9999`
l	Sinal do valor de saída do segundo ponto (YB)	`+` / `-`
mmmm	Valor de saída correspondente a XB (YB) — unidade livre	`0000`–`9999`

Como o valor reportado é calculado

O dispositivo aplica uma interpolação linear entre os dois pontos (XA, YA) e (XB, YB) sobre a voltagem lida e, em seguida, recorta a saída ao intervalo [BOTTOM, TOP]:


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

Vin é expresso em centésimos de volt (igual que XA e XB).
YA, YB, BOTTOM e TOP estão na unidade de saída que você escolher (litros, %, °C, mV, etc.).
O clamp garante que uma voltagem fora do intervalo calibrado nunca produza valores absurdos.

XA e XB não são décimos, são centésimos de volt. Por exemplo:

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

Errar a escala (escrever 0050 pensando em “5 V”) é o erro mais comum ao configurar este comando.

Exemplos

Sensor de combustível resistivo 0–5 V → 0–100 %

Sensor linear cuja saída varia de 0 V (tanque vazio) a 5 V (tanque cheio).


>SCXAIN01+0000+0100+0000+0500+0000+0100<
// aa   = 01     → entrada AD1
// BOT  = +0000  → corte inferior de saída = 0 %
// TOP  = +0100  → corte superior de saída = 100 %
// XA   = +0000  → 0,00 V  (tanque vazio)
// XB   = +0500  → 5,00 V  (tanque cheio)
// YA   = +0000  → 0 %
// YB   = +0100  → 100 %

Sensor de combustível capacitivo 0–33 V → 0–200 L

Sensor de maior alcance (frequente em caminhões) que entrega até 33 V para um tanque de 200 litros.


>SCXAIN01+0000+0200+0000+3300+0000+0200<
// XA = 0,00 V   → 0 L
// XB = 33,00 V  → 200 L
// Saída limitada ao intervalo [0, 200] litros

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

Saída com offset negativo: a 0 V o 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)

Leitura direta de bateria 0–36 V

Mapeamento identidade em centésimos de volt: a saída coincide com a voltagem (1245 → 12,45 V).


>SCXAIN01+0000+3600+0000+3600+0000+3600<
// XA = 0,00 V   → YA = 0
// XB = 36,00 V  → YB = 3600
// Saída limitada a [0, 3600] (centésimos de volt)

Passthrough — sem transformação (valor cru do ADC)

Útil quando você quer obter a leitura crua do conversor sem escalonamento. É o valor de fábrica.


>SCXAIN01-9999+9999-0000+0001-0000+0001<
// Inclinação unitária com clamp em [-9999, +9999]
// Equivale a não aplicar nenhuma conversão

Para consultar a configuração atual de qualquer entrada use QCXAINaa. O dispositivo responde com um RCXAIN que tem exatamente o mesmo formato do SCXAIN enviado:


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

Compatibilidade

💾Firmware:v1.00.00

SPLegacy

ULLegacy

MTLegacy

C3Legacy

C5Legacy

SP-IOT

SM-IOT

ZE-IOT

Ver Também

Comando AIN - Consulta entradas analógicas
Comando AR - Faixas analógicas
Reporte AD - Relatório de valores analógicos