MCP/API/CmdTelemetry

De uTech Tecnologia
Edição feita às 17h37min de 20 de setembro de 2021 por Utechnet (disc | contribs)

(dif) ← Versão anterior | ver versão atual (dif) | Versão posterior → (dif)
Ir para: navegação, pesquisa

Tabela de conteúdo


O comando Telemetria é enviado pela aplicação para solicitar o estado e níveis de telemetria do MCP (Leitor MLI conectado ao MCP), como temperatura, umidade, fumaça e gás, detecção e movimento e de nível e volume. (Os dados apresentados dependem do modelo e versão do equipamento, os quais podem conter ou não 1 ou mais sensores).

Comando

Parâmetros enviados para o MCP
request telemetry
interface Defina qual leitor externo será utilizado para leitura dos dados de telemetria.
  • 5 a 32: Interface externa (Ver Leitores)
Parâmetros enviados pelo MCP
request telemetry
description Descrição do equipamento/sensor (Configurável no equipamento).
interface Interface que foi realizada a leitura.
temperature Temperatura atual em graus Celsius. (-40º a +80ºC)
temperaturestatus Status dos parâmetros de temperatura
humidity Umidade atual em porcentagem (0 a 100%).
humiditystatus Status dos parâmetros de umidade
gas Nível de leitura de gás e fumaça em PPM - Partes por milhão. Valores variam de 300 a 10.000 ppm. Cada tipo de gás possui sua tolerância aceitável de partes por milhão.
gasstatus Status de leitura de gás e fumaça.
  • normal: Parâmetros de gás e fumaça dentro dos níveis aceitos (Configurado em Fumaça e Gás)
  • alarm: Parâmetros de fumaça e gás fora dos níveis aceitos (Configurado em Fumaça e Gás)

Nota: Cada tipo de gás possui sua tolerância aceitável de partes por milhão. Tabela de exemploo de referência: https://www.cdc.gov/niosh/idlh/intridl4.html

pirstatus Status de leitura de detecção de movimento.
  • normal: Movimento não detectado.
  • alarm: Movimento detectado.
levelstatus Status do sensor de nível (Sensor externo).
  • normal: Sensor de nível normal, não alarmado.
  • alarm: Sensor de nível detectado.
volume Indicação do volume medido no sensor de volume.
volumestatus Status do Sensor externo de volume.
  • normal: Volume abaixo do valor máximo configurado .
  • alarm: Volume extrapolou o valor máximo configurado.

(Configurado em Nível e Volume)

luminosity Nível de luminosidade, em Lux. 0 a 1000 lx.
luminositystatus Status do Sensor de luminosidade.
  • normal: Luminosidade dentro da faixa configurada.
  • alarm: Luminosidade fora da faixa configurada.

(Configurado em Luminosidade).

loop Sensor de loop de corrente. Valores em centímetros / cm.
loopstatus Status do Sensor de loop/corrente.
  • normal: Sem alarme. Dentro da faixa configurada.
  • alarm: Fora da faixa configurada.

(Configurado em Configurações / Loop de Corrente).

voltage Tensão medida atual.
voltagestatus Estado da tensão medida atual em V - Volts.
  • normal: Tensão medida dentro dos níveis aceitos.
  • alarm: Tensão medida fora dos níveis aceitos.

⇒ Valores configurado em Configurações - Limite Superior de Tensão e Limite Inferior de Tensão)
⇒ Se configurado com o valor zero, será desabilitado e sempre mostrado o status normal.
⇒ Valor padrão para ambos os limites (inferior e superior) é zero / desabilitado.

current Corrente medida atual em mA - Miliampère.
currentstatus Estado da corrente medida atual.
  • normal: Corrente medida dentro dos níveis aceitos.
  • alarm: Corrente medida fora dos níveis aceitos.

⇒ Valores configurado em Configurações - Limite Superior de Corrente e Limite Inferior de Corrente)
⇒ Se configurado com o valor zero, será desabilitado e sempre mostrado o status normal.
⇒ Valor padrão para ambos os limites (inferior e superior) é zero / desabilitado.

power Potência medida atual em W - Watt.
powerstatus Estado da potência medida atual.
  • normal: Potencia medida dentro dos níveis aceitos.
  • alarm: Potencia medida fora dos níveis aceitos.

⇒ Valores configurado em Configurações - Limite Superior de Potência e Limite Inferior de Potência)
⇒ Se configurado com o valor zero, será desabilitado e sempre mostrado o status normal.
⇒ Valor padrão para ambos os limites (inferior e superior) é zero / desabilitado.

powerfactor Fator de potência.
energydaily Potencia consumida no dia corrente, em kWh (QUILOWATT-HORA).
energydailylast Potencia consumida no dia anterior, em kWh (QUILOWATT-HORA).
energymonthly Potencia consumida no mês corrente, em kWh (QUILOWATT-HORA).
energymonthlylast Potencia consumida no mês anterior, em kWh (QUILOWATT-HORA).
energytotal Potencia total consumida/acumulada, em kWh (QUILOWATT-HORA). Este contador é zerado periodicamente (Dia do mês configurado em Configurações - Limite de Consumo Diário, Limite de Consumo Mensal e Limite de Consumo Total)
energystatus Estado da potência consumida.
  • normal: Potência consumida dentro dos valores configurados.
  • alarm: Potência consumida fora dos valores configurados.

⇒ Valores configurado em Configurações - Limite de Consumo Diário, Limite de Consumo Mensal e Limite de Consumo Total)
⇒ Se configurado com o valores igual a zero, será desabilitado e sempre mostrado o status normal.
⇒ Valor padrão para ambos os limites (inferior e superior) é zero / desabilitado. ⇒ Valores em kWh (QUILOWATT-HORA).

energymonth Lista com a potência consumida em cada mês do ano. Sendo 0 para janeiro e 11 para dezembro.

Exemplo 

http://ip:porta/?request=telemetry&interfce=5

Resposta:

  • 400 => Parâmetros incorretos
  • 401 => Erro de autenticação da API
  • 200 => OK 
 
Content-Type: application/json
 
{
  "interface":"6",
  "description":"MLI Sensor gas/luminosidade/movimento",
  "temperature":"",
  "temperaturestatus":
  "normal",
  "humidity":"",
  "humiditystatus":"normal",
  "gas":"0",
  "gasstatus":"normal",
  "pirstatus":"normal",
  "levelstatus":"","volume":"",
  "volumestatus":"",
  "luminosity":"14",
  "luminositystatus":"normal",
  "voltage":"",
  "voltagestatus":"normal",
  "current":"",
  "currentstatus":"normal",
  "power":"",
  "powerstatus":"normal",
  "energydaily":"",
  "energydailylast":"",
  "energymonthly":"",
  "energymonthlylast":"",
  "energytotal":"",
  "energystatus":"normal"
}



PHP 

<?php
 
$user = "utech";
$pass = "1234";
$port = "8080";
$ipaddr = "10.0.0.1";
 
$url = "";
$url = "$ipaddr:$port?request=telemetry&interface=5";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$user:$pass");
$result = curl_exec($ch);
if(!$result) {
    echo "error!\n";
    return 2;
}
print_r(json_decode($result, true));
 
?>




Voltar

Obtida de "https://wiki.utech.com.br/wiki/index.php?title=MCP/API/CmdTelemetry&oldid=8796"
Ferramentas pessoais
Espaços nominais

Variantes
Visualizações
Ações
Navegação
Ferramentas