Skip to content

Leituras de entrada analógica ​

Esta página explica um item AnalogInputState dentro de peripherals.analogInputs.

Somente dispositivos com canais de entrada analógica retornam este array.

Esquema de AnalogInputState ​

CampoTipoObrigatórioDescrição
indexintegerSimÍndice do canal de entrada analógica, começa em 1
typestringSimCódigo de tipo. Valor atual: CURRENT
valuenumberNãoValor atual da corrente de entrada analógica
unitstringSimUnidade da corrente de entrada analógica, fixa em mA
statusstringSimStatus do canal. Valores: ONLINE, OFFLINE
measurementobjectNãoValor de medição convertido com base na configuração do dispositivo. Omitido quando a configuração está ausente ou incompleta

Notas:

  • Quando o canal está desconectado, value pode ser omitido.
  • value sempre representa a corrente real de entrada analógica em mA.
  • measurement só é retornado quando o dispositivo tem configurados o intervalo de entrada analógica, o intervalo do sensor e a unidade de exibição, e o serviço consegue calcular a leitura convertida.

Esquema de measurement ​

CampoTipoObrigatórioDescrição
valuenumberSimValor de medição convertido
unitstringSimUnidade de medição convertida, conforme a configuração do dispositivo

Valores de type de entrada analógica ​

ValorDescrição
CURRENTCorrente

Valores de status do canal ​

ValorDescrição
ONLINEA entrada analógica está conectada
OFFLINEA entrada analógica está desconectada

Exemplo ​

json
[
  {
    "index": 1,
    "type": "CURRENT",
    "value": 15.468,
    "unit": "mA",
    "status": "ONLINE",
    "measurement": {
      "value": 71.7,
      "unit": "C"
    }
  },
  {
    "index": 2,
    "type": "CURRENT",
    "value": 6.928,
    "unit": "mA",
    "status": "ONLINE"
  }
]

Canais sem configuração de conversão, ou desconectados, não retornam measurement:

json
[
  {
    "index": 1,
    "type": "CURRENT",
    "unit": "mA",
    "status": "OFFLINE"
  }
]
Docs buildVersion v1.6.3-20261020-171545-90
Copyright © 2026 WLTE