MCP/API/CmdTelemetry
(→Exemplo) |
(→Comando) |
||
Linha 19: | Linha 19: | ||
|- | |- | ||
| align="left"| '''request''' || '''telemetry''' | | align="left"| '''request''' || '''telemetry''' | ||
+ | |- | ||
+ | | align="left"| '''interface''' || Interface que foi realizada a leitura. | ||
|- | |- | ||
| align="left"| '''temperaturestatus''' || Temperatura atual (Graus Celsius) | | align="left"| '''temperaturestatus''' || Temperatura atual (Graus Celsius) | ||
Linha 48: | Linha 50: | ||
| align="left"| '''volume''' || Indicação do volume medido no sensor de volume. | | align="left"| '''volume''' || Indicação do volume medido no sensor de volume. | ||
|- | |- | ||
− | | align="left"| ''' | + | | align="left"| '''volumestatus''' || Status do Sensor externo de volume. |
* '''normal''': Volume abaixo do valor máximo configurado . | * '''normal''': Volume abaixo do valor máximo configurado . | ||
* '''alarm''': Volume extrapolou o valor máximo configurado. | * '''alarm''': Volume extrapolou o valor máximo configurado. | ||
(Configurado em [[MLI/ConfiguracaoWEB#Configura.C3.A7.C3.B5es_.28Controle_de_Acesso.29 |'''Nível e Volume''']]) | (Configurado em [[MLI/ConfiguracaoWEB#Configura.C3.A7.C3.B5es_.28Controle_de_Acesso.29 |'''Nível e Volume''']]) | ||
+ | |- | ||
+ | | align="left"| '''request''' || '''telemetry''' | ||
+ | |} | ||
+ | |||
+ | {| class="wikitable" width="75%" | ||
+ | ! align="center" colspan="2" | Parâmetros enviados pelo medidor | ||
+ | |- | ||
+ | | align="left"| '''request''' || '''telemetry''' | ||
+ | |- | ||
+ | | align="left"| '''voltage''' || Tensão medida atual. | ||
+ | |- | ||
+ | | align="left"| '''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.<BR> | ||
+ | ⇒ Valores configurado em [[MGE/ConfiguracaoWEB#Configura.C3.A7.C3.B5es |'''Configurações - Limite Superior de Tensão e Limite Inferior de Tensão''']])<BR> | ||
+ | ⇒ Se configurado com o valor zero, será desabilitado e sempre mostrado o status '''normal'''.<BR> | ||
+ | ⇒ Valor padrão para ambos os limites (inferior e superior) é zero / desabilitado. | ||
+ | |- | ||
+ | | align="left"| '''current''' || Corrente medida atual em '''mA - Miliampère'''. | ||
+ | |- | ||
+ | | align="left"| '''currentstatus''' || Estado da corrente medida atual. | ||
+ | * '''normal''': Corrente medida dentro dos níveis aceitos. | ||
+ | * '''alarm''': Corrente medida fora dos níveis aceitos.<BR> | ||
+ | ⇒ Valores configurado em [[MGE/ConfiguracaoWEB#Configura.C3.A7.C3.B5es |'''Configurações - Limite Superior de Corrente e Limite Inferior de Corrente''']])<BR> | ||
+ | ⇒ Se configurado com o valor zero, será desabilitado e sempre mostrado o status '''normal'''.<BR> | ||
+ | ⇒ Valor padrão para ambos os limites (inferior e superior) é zero / desabilitado. | ||
+ | |- | ||
+ | | align="left"| '''power''' || Potência medida atual em '''W - Watt'''. | ||
+ | |- | ||
+ | | align="left"| '''powerstatus''' || Estado da potência medida atual. | ||
+ | * '''normal''': Potencia medida dentro dos níveis aceitos. | ||
+ | * '''alarm''': Potencia medida fora dos níveis aceitos.<BR> | ||
+ | ⇒ Valores configurado em [[MGE/ConfiguracaoWEB#Configura.C3.A7.C3.B5es |'''Configurações - Limite Superior de Potência e Limite Inferior de Potência''']])<BR> | ||
+ | ⇒ Se configurado com o valor zero, será desabilitado e sempre mostrado o status '''normal'''.<BR> | ||
+ | ⇒ Valor padrão para ambos os limites (inferior e superior) é zero / desabilitado. | ||
+ | |- | ||
+ | | align="left"| '''powerfactor''' || Fator de potência. | ||
+ | |- | ||
+ | | align="left"| '''energydaily''' || Potencia consumida no dia corrente, em kWh (''QUILOWATT-HORA''). | ||
+ | |- | ||
+ | | align="left"| '''energydailylast''' || Potencia consumida no dia anterior, em kWh (''QUILOWATT-HORA''). | ||
+ | |- | ||
+ | | align="left"| '''energymonthly''' || Potencia consumida no mês corrente, em kWh (''QUILOWATT-HORA''). | ||
+ | |- | ||
+ | | align="left"| '''energymonthlylast''' || Potencia consumida no mês anterior, em kWh (''QUILOWATT-HORA''). | ||
+ | |- | ||
+ | | align="left"| '''energytotal''' || Potencia total consumida/acumulada, em kWh (''QUILOWATT-HORA''). Este contador é zerado periodicamente (Dia do mês configurado em [[MGE/ConfiguracaoWEB#Configura.C3.A7.C3.B5es |'''Configurações - Limite de Consumo Diário, Limite de Consumo Mensal e Limite de Consumo Total''']]) | ||
+ | |- | ||
+ | | align="left"| '''energystatus''' || Estado da potência consumida. | ||
+ | * '''normal''': Potência consumida dentro dos valores configurados. | ||
+ | * '''alarm''': Potência consumida fora dos valores configurados.<BR> | ||
+ | ⇒ Valores configurado em [[MGE/ConfiguracaoWEB#Configura.C3.A7.C3.B5es |'''Configurações - Limite de Consumo Diário, Limite de Consumo Mensal e Limite de Consumo Total''']])<BR> | ||
+ | ⇒ Se configurado com o valores igual a zero, será desabilitado e sempre mostrado o status '''normal'''.<BR> | ||
+ | ⇒ Valor padrão para ambos os limites (inferior e superior) é zero / desabilitado. | ||
+ | ⇒ Valores em kWh (''QUILOWATT-HORA''). | ||
+ | |- | ||
+ | | align="left"| '''energymonth''' || Lista com a potência consumida em cada mês do ano. Sendo 0 para janeiro e 11 para dezembro. | ||
|} | |} | ||
Edição de 17h48min de 14 de maio de 2021
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 |
interface | Interface que foi realizada a leitura. |
temperaturestatus | Temperatura atual (Graus Celsius) |
temperaturestatus | Status dos parâmetros de temperatura
|
humidity | Umidade atual em porcentagem |
humiditystatus | Status dos parâmetros de umidade
|
gas | Nível de leitura de gás e fumaça. |
gasstatus | Status de leitura de gás e fumaça.
|
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) |
request | telemetry |
Parâmetros enviados pelo medidor | |
---|---|
request | telemetry |
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)); ?> |