MGE/API/CmdTelemetry

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. 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 A - Ampere.
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

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));   ?>

Voltar

---