MGE/API/CmdTelemetry
(→Comando) |
|||
Linha 43: | Linha 43: | ||
⇒ Se configurado com o valor zero, será desabilitado e sempre mostrado o status '''normal'''.<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. | ⇒ 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, em kWh (''QUILOWATT-HORA''). | ||
+ | |- | ||
+ | | 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. | ||
|} | |} | ||
− | + | <BR> | |
== Exemplo == | == Exemplo == | ||
Edição de 18h12min de 7 de janeiro de 2021
Tabela de conteúdo |
O comando Telemetria é enviado pela aplicação para solicitar o estado e níveis de telemetria do medidor MGE, como corrente, tensão, consumo, entre outros mostrados abaixo.
Comando
Parâmetros enviados para o medidor | |
---|---|
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 A - Ampere. | |||
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, em kWh (QUILOWATT-HORA). | |
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 |
---|
Resposta:
- 400 => Parâmetros incorretos
- 401 => Erro de autenticação da API
- 200 => OK
Content-Type: application/json { "voltage":"215.46", "voltagestatus":"normal", "current":"0.00", "currentstatus":"normal", "power":"0.00", "powerstatus":"normal", "powerfactor":"0.000", "energydaily":"0.000", "energydailylast":"0.000", "energymonthly":"0.000", "energymonthlylast":"0.000", "energytotal":"0.000", "energystatus":"normal", "energymonth": { "0":"0.000", "1":"0.000", "2":"0.000", "3":"0.000", "4":"0.000", "5":"0.000", "6":"0.000", "7":"0.000", "8":"0.000", "9":"0.000", "10":"0.000", "11":"0.000" } } |
---|
PHP
<?php $user = "utech"; $pass = "1234"; $port = "8080"; $ipaddr = "10.0.0.1"; $url = ""; $url = "$ipaddr:$port?request=telemetry"; $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)); ?> |