Aviso de desuso
- La API XML de eGauge ha sido reemplazada por la nueva y más potente WebAPI basada en JSON. La WebAPI JSON es más rápida, más flexible y ofrece funciones de configuración y estado que la API XML no ofrece.
- La API XML seguirá funcionando, pero no recibirá nuevas funciones ni mejoras. Se recomienda utilizar la WebAPI basada en JSON en lugar de la interfaz XML. Puede encontrar más información sobre la WebAPI JSON aquí .
eGauge Systems ofrece acceso a una API gratuita y sin restricciones para el desarrollo de aplicaciones que extraen datos del medidor eGauge. Esta API cubre las mismas funciones que la interfaz predeterminada de eGauge. La API también incluye la funcionalidad del servicio push de eGauge.
El soporte técnico de eGauge puede ofrecer asistencia para la interpretación de datos XML. No se ofrece revisión de código ni asistencia similar. Descargue el documento PDF completo en el siguiente enlace:
Interpretación de datos XML y ejemplos
Información general
Los datos XML se envían con valores de registro acumulativos . En el caso de los registros de potencia, los valores acumulativos se expresan en vatios-segundo. Para convertir vatios-segundo a kWh, divida los vatios-segundo entre 3.600.000. Los valores acumulativos pueden considerarse como las lecturas del contador en ese momento, donde el consumo aumenta continuamente. Para obtener el consumo de kWh entre dos fechas, reste el valor más reciente del anterior y divida entre 3.600.000.
Nota: Los medidores EG4xxx admiten TLSv1.2, mientras que EG30xx solo admite TLSv1.0
En la parte inferior de la página se encuentra la salida de una exportación granular de minutos que muestra los últimos diez minutos de datos acumulados (obtenidos con la URL http://DEVNAME.egaug.es/cgi-bin/egauge-show?m&n=10). time_stamp representa la hora de la exportación (marca de tiempo Unix en hexadecimal); time_delta indica el tiempo en segundos entre exportaciones; epoch representa la fecha y hora en que comenzó la grabación en ese dispositivo (marca de tiempo Unix en hexadecimal).
Cada etiqueta <cname> contiene datos en un encabezado de columna; en este caso, esto se traduce a un registro físico en el dispositivo. t indica el tipo de registro (P para potencia, V para voltaje, etc.) y el texto dentro de la etiqueta representa el nombre del registro tal como está registrado en el dispositivo. Los registros virtuales también pueden mostrarse en el parámetro correspondiente que se pasa en la solicitud inicial.
Cada fila (etiqueta <r>) contiene una serie de columnas (etiqueta <c>) que muestran el valor acumulado de cada registro. Para determinar el valor promedio de un registro en un tiempo determinado, simplemente encuentre la diferencia entre los dos valores acumulados y divídala entre el delta de tiempo correspondiente. Los valores resultantes se expresan en unidades según el tipo de registro (consulte la tabla en la sección 2.2.1 del documento de la API XML para el tipo de unidad). Cabe destacar que, antes del firmware 3.01, los valores acumulados no necesariamente se contabilizan desde cero. En el firmware 3.01 y posteriores, al pasar la opción E al solicitar datos, se devuelven valores relativos a la época del dispositivo (es decir, los valores empiezan en cero). Usar el parámetro época en una transferencia de datos tiene el mismo efecto. Esto supone que la opción de fecha y hora de inicio de la grabación está configurada correctamente en el eGauge.
Algunos ejemplos (basados en el ejemplo de salida a continuación):
Uso promedio de la red durante el último minuto 55357226851 - 55357243343 = −16492 / 60 = -274,86 vatios (recuerde, los registros de potencia son bidireccionales)
https://kb.egauge.net/link/137#bkmrk-voltaje-promedio-l2-o
Voltaje promedio L2 durante diez minutos 4511385868513 - 4511319123106 = 66745407 / 600 = 111242.345 mV / 1000 = 111.24 Voltios
<group serial="0x4e842294">
<data columns="12" time_stamp="0x564cb0e8" time_delta="60" epoch="0x55973268">
<cname t="P">Grid</cname>
<cname t="S">Grid*</cname>
<cname t="V">VL2</cname>
<cname t="V">VL1</cname>
<cname t="F">Frequency</cname>
<r>
<c>55357226851</c>
<c>7375247726</c>
<c>4511385868513</c>
<c>4528987513211</c>
<c>2217532746128</c>
</r>
<r>
<c>55357243343</c>
<c>7375223338</c>
<c>4511378482617</c>
<c>4528980146863</c>
<c>2217529147760</c>
</r>
<r>
<c>55357259861</c>
<c>7375198952</c>
<c>4511371100578</c>
<c>4528972784417</c>
<c>2217525549473</c>
</r>
<r>
<c>55357276431</c>
<c>7375174516</c>
<c>4511363715094</c>
<c>4528965418400</c>
<c>2217521950920</c>
</r>
<r>
<c>55357293137</c>
<c>7375149735</c>
<c>4511356276347</c>
<c>4528957999802</c>
<c>2217518352640</c>
</r>
<r>
<c>55357309872</c>
<c>7375124940</c>
<c>4511348838707</c>
<c>4528950580365</c>
<c>2217514754150</c>
</r>
<r>
<c>55357326630</c>
<c>7375100152</c>
<c>4511341406162</c>
<c>4528943162279</c>
<c>2217511155334</c>
</r>
<r>
<c>55357343410</c>
<c>7375075359</c>
<c>4511333976595</c>
<c>4528935743683</c>
<c>2217507556120</c>
</r>
<r>
<c>55357360207</c>
<c>7375050569</c>
<c>4511326550844</c>
<c>4528928327670</c>
<c>2217503956798</c>
</r>
<r>
<c>55357377048</c>
<c>7375025739</c>
<c>4511319123106</c>
<c>4528920909766</c>
<c>2217500357151</c>
</r>
</data>
</group>Ejemplo: Energía y potencia para fechas específicas
Puede realizar llamadas CGI a http://DEV-URL/cgi-bin/egauge-show donde DEV-URL es la URL de su eGauge (por ejemplo, http://egaugehq.d.egauge.net/).
El parámetro T permite solicitar datos de puntos específicos en el tiempo. Espera una lista de marcas de tiempo Unix separadas por comas.
El parámetro E solicita que los valores se relacionen con la fecha y hora de inicio de la grabación. Esto debe configurarse correctamente en Ajustes ->
Esto hace que la lectura comience desde cero cuando se configura la fecha y hora de inicio de la grabación; de lo contrario, el valor bruto de la base de datos podría ser arbitrario. Requiere el firmware v3.02 o superior.
El parámetro a solicita registros totales y virtuales, como "Uso" y "Generación". Esto es opcional.
https://kb.egauge.net/link/137#bkmrk-http%3A%2F%2Fegaugehq.d.eg
http://egaugehq.d.egauge.net/cgi-bin/egauge-show?a&E&T=1514764800,1483228800 devuelve datos del 1 de enero de 2018 a las 00:00:00 UTC y del 1 de enero de 2017 a las 00:00:00 UTC, respectivamente, utilizando valores relativos a la época y solicitando registros totales y virtuales. La salida a continuación elimina todos los demás registros, excepto los de Uso y Generación, para facilitar la lectura.
<group serial="0x3b2d1cb7">
<data columns="27" time_stamp="0x5a497a00" time_delta="60" epoch="0x52a0f760">
<cname t="P">use</cname>
<cname t="P">gen</cname>
<r>
<c>241517238757</c>
<c>0</c>
</r>
</data>
<data time_stamp="0x58684680" time_delta="900">
<r>
<c>171138633823</c>
<c>0</c>
</r>
</data>
</group>La generación es cero porque no hay ninguna registrada en este dispositivo.
El uso para la marca de tiempo 0x5a497a00 (1 de enero de 2018) es 241517238757 julios (241517238757/3600000 = 67088 kWh).
El uso para la marca de tiempo 0x58684680 (1 de enero de 2017) es 171138633823 julios (171138633823/3600000 = 47538 kWh).
Si desea potencia en lugar de energía, reste los valores y divida por la cantidad de tiempo entre ellos:
https://kb.egauge.net/link/137#bkmrk-67088-kwh--%C2%A047538-kw
Entre 2017 y 2018 se consumieron 67088 kWh - 47538 kWh = 19550 kWh. Un año tiene 8760 horas, por lo que 19550 kWh / 8760 h = 2,23 kW de promedio anual. Esto se puede calcular utilizando dos puntos temporales cualesquiera.
