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.5.9-20260827-140125-85
Copyright © 2026 WLTE