MCP/API/CmdTelemetry
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.
|
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.
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.
|
levelstatus | Status do sensor de nível (Sensor externo).
|
volume | Indicação do volume medido no sensor de volume. |
volumestatus | Status do Sensor externo de volume.
(Configurado em Nível e Volume) |
luminosity | Nível de luminosidade, em Lux. 0 a 1000 lx. |
luminositystatus | Status do Sensor de luminosidade.
(Configurado em Luminosidade). |
loop | Sensor de loop de corrente. Valores em centímetros / cm. |
loopstatus | Status do Sensor de loop/corrente.
(Configurado em Configurações / Loop de Corrente). |
voltage | Tensão medida atual. |
voltagestatus | Estado da tensão medida atual em V - Volts.
⇒ Valores configurado em Configurações - Limite Superior de Tensão e Limite Inferior de Tensão) |
current | Corrente medida atual em mA - Miliampère. |
currentstatus | Estado da corrente medida atual.
⇒ Valores configurado em Configurações - Limite Superior de Corrente e Limite Inferior de Corrente) |
power | Potência medida atual em W - Watt. |
powerstatus | Estado da potência medida atual.
⇒ Valores configurado em Configurações - Limite Superior de Potência e Limite Inferior de Potência) |
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.
⇒ Valores configurado em Configurações - Limite de Consumo Diário, Limite de Consumo Mensal e Limite de Consumo Total) |
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)); ?> |