MCP/API/CmdTelemetry
(Criou página com ' __TOC__ 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, umidad...') |
(→Comando) |
||
(9 edições intermediárias de um usuário não apresentadas) | |||
Linha 20: | Linha 20: | ||
| align="left"| '''request''' || '''telemetry''' | | align="left"| '''request''' || '''telemetry''' | ||
|- | |- | ||
− | | align="left"| ''' | + | | align="left"| '''description''' || Descrição do equipamento/sensor (Configurável no equipamento). |
+ | |- | ||
+ | | align="left"| '''interface''' || Interface que foi realizada a leitura. | ||
+ | |- | ||
+ | | align="left"| '''temperature''' || Temperatura atual em graus Celsius. (-40º a +80ºC) | ||
|- | |- | ||
| align="left"| '''temperaturestatus''' || Status dos parâmetros de temperatura | | align="left"| '''temperaturestatus''' || Status dos parâmetros de temperatura | ||
Linha 26: | Linha 30: | ||
* '''alarm''': Parâmetros de temperatura fora dos níveis aceitos (Configurado em [[MLI/ConfiguracaoWEB#Configura.C3.A7.C3.B5es_.28Controle_de_Acesso.29 |'''Temperatura e Umidade''']]) | * '''alarm''': Parâmetros de temperatura fora dos níveis aceitos (Configurado em [[MLI/ConfiguracaoWEB#Configura.C3.A7.C3.B5es_.28Controle_de_Acesso.29 |'''Temperatura e Umidade''']]) | ||
|- | |- | ||
− | | align="left"| '''humidity''' || Umidade atual em porcentagem | + | | align="left"| '''humidity''' || Umidade atual em porcentagem (0 a 100%). |
|- | |- | ||
| align="left"| '''humiditystatus''' || Status dos parâmetros de umidade | | align="left"| '''humiditystatus''' || Status dos parâmetros de umidade | ||
Linha 32: | Linha 36: | ||
* '''alarm''': Parâmetros de umidade fora dos níveis aceitos (Configurado em [[MLI/ConfiguracaoWEB#Configura.C3.A7.C3.B5es_.28Controle_de_Acesso.29 |'''Temperatura e Umidade''']]) | * '''alarm''': Parâmetros de umidade fora dos níveis aceitos (Configurado em [[MLI/ConfiguracaoWEB#Configura.C3.A7.C3.B5es_.28Controle_de_Acesso.29 |'''Temperatura e Umidade''']]) | ||
|- | |- | ||
− | | align="left"| '''gas''' || Nível de leitura de gás e fumaça. | + | | align="left"| '''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. |
|- | |- | ||
| align="left"| '''gasstatus''' || Status de leitura de gás e fumaça. | | align="left"| '''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 [[MLI/ConfiguracaoWEB#Configura.C3.A7.C3.B5es_.28Controle_de_Acesso.29 |'''Fumaça e Gás''']]) | * '''normal''': Parâmetros de gás e fumaça dentro dos níveis aceitos (Configurado em [[MLI/ConfiguracaoWEB#Configura.C3.A7.C3.B5es_.28Controle_de_Acesso.29 |'''Fumaça e Gás''']]) | ||
* '''alarm''': Parâmetros de fumaça e gás fora dos níveis aceitos (Configurado em [[MLI/ConfiguracaoWEB#Configura.C3.A7.C3.B5es_.28Controle_de_Acesso.29 |'''Fumaça e Gás''']]) | * '''alarm''': Parâmetros de fumaça e gás fora dos níveis aceitos (Configurado em [[MLI/ConfiguracaoWEB#Configura.C3.A7.C3.B5es_.28Controle_de_Acesso.29 |'''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 | ||
|- | |- | ||
| align="left"| '''pirstatus''' || Status de leitura de detecção de movimento. | | align="left"| '''pirstatus''' || Status de leitura de detecção de movimento. | ||
Linha 48: | Linha 53: | ||
| 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"| '''luminosity''' || Nível de luminosidade, em Lux. 0 a 1000 lx. | ||
+ | |- | ||
+ | | align="left"| '''luminositystatus''' || Status do Sensor de luminosidade. | ||
+ | * '''normal''': Luminosidade dentro da faixa configurada. | ||
+ | * '''alarm''': Luminosidade fora da faixa configurada. | ||
+ | (Configurado em [[MLI/ConfiguracaoWEB#Configura.C3.A7.C3.B5es_.28Controle_de_Acesso.29 |'''Luminosidade''']]). | ||
+ | |- | ||
+ | | align="left"| '''loop''' || Sensor de loop de corrente. Valores em centímetros / cm. | ||
+ | |- | ||
+ | | align="left"| '''loopstatus''' || Status do Sensor de loop/corrente. | ||
+ | * '''normal''': Sem alarme. Dentro da faixa configurada. | ||
+ | * '''alarm''': Fora da faixa configurada. | ||
+ | (Configurado em [[MLI/ConfiguracaoWEB#Configura.C3.A7.C3.B5es_.28Controle_de_Acesso.29 |'''Configurações / Loop de Corrente''']]). | ||
+ | |- | ||
+ | | 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. | ||
|} | |} | ||
Linha 58: | Linha 126: | ||
{| class="wikitable" | {| class="wikitable" | ||
− | ! style="text-align: left; font-weight: bold;" | <pre>http://ip:porta/?request=telemetry</pre> | + | ! style="text-align: left; font-weight: bold;" | <pre>http://ip:porta/?request=telemetry&interfce=5</pre> |
|} | |} | ||
Linha 73: | Linha 141: | ||
{ | { | ||
− | + | "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" | ||
} | } | ||
− | |||
</source> | </source> | ||
|} | |} | ||
Linha 102: | Linha 185: | ||
$url = ""; | $url = ""; | ||
− | $url = "$ipaddr:$port?request=telemetry"; | + | $url = "$ipaddr:$port?request=telemetry&interface=5"; |
$ch = curl_init($url); | $ch = curl_init($url); | ||
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); | curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); |
Edição atual tal como 17h37min de 20 de setembro 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).
[editar] 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. |
[editar] 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" } |
---|
[editar] 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)); ?> |