ODEnergy

Transcripción

ODEnergy

Mapa de memoria del dispositivo
Guía de integración
ODEnergy
Métodos de acceso a los datos:
ŸCloud de OpenDomo
ŸCloud de terceros
ŸAcceso local
ŸModbus/TCP
Dir. dec.
Dir. hex.
N. reg.
Tip. dato
0
0000
1
UINT16
Valor
Dirección MAC bytes 0 y 1.
1
0001
1
UINT16
2
0002
1
UINT16
3
0003
1
UINT16
Versión del producto 1ª parte (major, minor).
4
0004
1
UINT16
Versión del producto 2ª parte (revision 1, 2).
5
0005
1
UINT16
Tipo de producto (ME, MW, TE, TW en ASCII).
6-7
0006-0007
2
UINT32
Tiempo de arranque del equipo (UNIX timestamp).
8-9
0008-0009
2
UINT32
Hora (UNIX timestamp).
Mapa de memoria L1
ŸWebServices JSON
ŸWebServices XML
ŸBroadcast UDP
ŸODELogger
Dirección dec. Dirección hex.
DATOS EN CLOUD
El ODEnergy de serie viene pre-configurado para que se envíen los datos directamente al Cloud de OpenDomo. Puede entrar en el menú de configuración del
equipo y cambiar el servidor de destino por otro compatible o crear su propia
versión de Cloud. En nuestra Wiki puede encontrar toda la documentación
necesaria para la implementación del servidor.
El ODEnergy se comporta como un cliente de red, envía los datos medidos cada
15 minutos al servidor indicado en la configuración. Si utiliza su propia versión de
Cloud puede elegir una frecuencia de envío de datos de cada 1, 5 y 15 minutos.
ACCESO LOCAL
Puede visualizar la mayoría de los datos medidos por el equipo en tiempo real (una
lectura cada 3 segundos) accediendo a la URL del dispositivo, por defecto
http://169.254.0.4/.
MODBUS/TCP
N. reg.
Tipo de dato Valor
Magnitud
1000-1001
03E8-03E9
2
UINT32
Voltaje L1
V x 100
1002-1003
03EA-03EB
2
UINT32
Corriente L1
A x 1000
1004-1005
03EC-03ED
2
INT32
Potencia activa L1
W
1006-1007
03EE-03EF
2
INT32
Potencia reactiva L1
var
1008-1009
03F0-03F1
2
INT32
Factor de potencia L1
% x 100
1010-1011
03F2-03F3
2
UINT32
Energía activa consumida L1
1012-1013
03F4-03F5
2
UINT32
Energía activa generada L1
kWh
1014-1015
03F6-03F7
2
UINT32
Energía reactiva Q1 L1
kvarh
1016-1017
03F8-03F9
2
UINT32
kvarh
1018-1019
03FA-03FB
2
UINT32
kvarh
1020-1021
03FC-03FD
2
UINT32
kvarh
1022
03FE
1
UINT16
E. activa consumida, parte fraccionaria
1023
03FF
1
UINT16
E. activa generada, parte fraccionaria
Wh
1024
0400
1
UINT16
E. reactiva Q1, parte fraccionaria
varh
1025
0401
1
UINT16
varh
1026
0402
1
UINT16
varh
1027
0403
1
UINT16
varh
kWh
Wh
Mapa de memoria L2
N. reg.
Tipo de dato Valor
Magnitud
2000-2001
07D0-07D1
2
UINT32
Voltaje L2
V x 100
2002-2003
07D2-07D3
2
UINT32
Corriente L2
A x 1000
El protocolo Modbus/TCP por defecto está desactivado, para activarlo diríjase al
menú de configuración del equipo y active la casilla del protocolo Modbus/TCP.
2004-2005
07D4-07D5
2
INT32
Potencia activa L2
W
2006-2007
07D6-07D7
2
INT32
var
Puerto TCP: 502
Número máximo de conexiones: 2(1)
Persistencia de la conexión (keep-alive): 30 segundos.
Código de función Modbus: 3 - Read Holding Registers (solo lectura).
Frecuencia máxima de lectura: 2 lecturas por segundo.
2008-2009
07D8-07D9
2
INT32
% x 100
2010-2011
07DA-07DB
2
UINT32
2012-2013
07DC-07DD
2
UINT32
kWh
2014-2015
07DE-07DF
2
UINT32
kvarh
2016-2017
07E0-07E1
2
UINT32
kvarh
2018-2019
07E2-07E3
2
UINT32
kvarh
2020-2021
07E4-07E5
2
UINT32
kvarh
2022
07E6
1
UINT16
2023
07E7
1
UINT16
Wh
2024
07E8
1
UINT16
varh
2025
07E9
1
UINT16
varh
2026
07EA
1
UINT16
varh
2027
07EB
1
UINT16
varh
1. En versiones de firmware inferiores a la 2.1.1 el servidor Modbus/TCP acepta una sola conexión, sin
embargo en sistemas multi-maestro puede abrir y cerrar las conexiones de red para permitir la lectura vía
Modbus/TCP desde múltiples clientes de red de forma simultánea.
El orden de los bytes es Big Endian, ejemplo:
El número entero de 32 bits 87908212, en hexadecimal 0x053D5F74 se
representa como:
0x05 0x3D 0x5F 0x74
Byte 0 Byte 1 Byte 2 Byte 3
Registro 0
Registro 1
kWh
Wh
Mapa de memoria L3
El mismo ejemplo, dentro de una trama Modbus/TCP:
N. reg.
Tipo de dato Valor
Magnitud
3000-3001
0BB8-0BB9
2
UINT32
Voltaje L3
V x 100
3002-3003
0BBA-0BBB
2
UINT32
Corriente L3
A x 1000
0x00 0x01 0x00 0x00 0x00 0x06 0xFF 0x03 0x00 0x00 0x00 0x02
3004-3005
0BBC-0BBD
2
INT32
Potencia activa L3
W
Byte 0 Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7 Byte 8 Byte 9 Byte 10 Byte 11
Transaction ID
Protocol ID
Length
Unit ID Func. Starting address Qty. of registers
3006-3007
0BBE-0BBF
2
INT32
var
% x 100
Pregunta:
3008-3009
0BC0-0BC1
2
INT32
3010-3011
0BC2-0BC3
2
UINT32
Respuesta:
3012-3013
0BC4-0BC5
2
UINT32
kWh
0x00 0x01 0x00 0x00 0x00 0x07 0xFF 0x03 0x04 0x05 0x3D 0x5F 0x74
3014-3015
0BC6-0BC7
2
UINT32
kvarh
Byte 0 Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7 Byte 8 Byte 9 Byte 10 Byte 11 Byte 12
Transaction ID
Protocol ID
Length
Unit ID Func. Byte c.
Value
3016-3017
0BC8-0BC9
2
UINT32
kvarh
3018-3019
0BCA-0BCB
2
UINT32
kvarh
3020-3021
0BCC-0BCD
2
UINT32
kvarh
3022
0BCE
1
UINT16
3023
0BCF
1
UINT16
Wh
3024
0BD0
1
UINT16
varh
Variables
Tipo
Descripción
UINT16
Entero sin signo de 16 bits.
INT16
Entero con signo de 16 bits en complemento a 2.
UINT32
Entero sin signo de 32 bits.
INT32
Entero con signo de 32 bits en complemento a 2.
Valor mínimo
Valor máximo
kWh
Wh
0
65535
3025
0BD1
1
UINT16
varh
-32768
32767
3026
0BD2
1
UINT16
varh
0
4294967296
3027
0BD3
1
UINT16
varh
-2147483648
2147483647
La energía se obtiene leyendo el registro de 32 bits correspondiente, por ejemplo la energía activa
consumida de L1 se lee mediante el registro 1010 y 1011, el valor es expresado en kWh. Para añadir más
resolución se puede leer la parte fraccionaria de la energía en el registro 1022 (Wh). Seguidamente se
realiza la siguiente operación para aumentar la resolución: kWh_medidos + Wh_medidos / 1000
1
www.opendomo.com - rev.2 2016
Mapa de memoria III (trifásico)
N. reg.
Esquema del documento XML:
Tipo de dato Valor
Magnitud
4000-4001
0FA0-0FA1
2
INT32
Potencia activa III
W
4002-4003
0FA2-0FA3
2
INT32
Potencia reactiva III
var
4004-4005
0FA4-0FA5
2
INT32
Potencia aparente III
VA
4006-4007
0FA6-0FA7
2
INT32
Factor de potencia III
% x 100
4008-4009
0FA8-0FA9
2
UINT32
Energía activa consumida III
4010-4011
0FAA-0FAB
2
UINT32
Energía activa generada III
kWh
4012-4013
0FAC-0FAD
2
UINT32
Energía reactiva Q1 III
kvarh
kWh
4014-4015
0FAE-0FAF
2
UINT32
kvarh
4016-4017
0FB0-0FB1
2
UINT32
kvarh
4018-4019
0FB2-0FB3
2
UINT32
kvarh
4020
0FB4
1
UINT16
4021
0FB5
1
UINT16
Wh
4022
0FB6
1
UINT16
varh
4023
0FB7
1
UINT16
varh
4024
0FB8
1
UINT16
varh
4025
0FB9
1
UINT16
varh
Wh
Mapa de memoria de otras variables
Dir. dec.
Dir. hex.
N. reg.
Tip. dato
Valor
5000
1388
1
UINT16
Frecuencia de la red
Hz x 10
5001-5002
1389-138A
2
UINT32
Corriente de neutro (medida del
transformador de corriente)
A x 1000
5003-5004
138B-13BC
2
UINT32
Corriente de neutro (calculada, no es
necesario un trafo.)
A x 1000
Magnitud
WEBSERVICES JSON
El ODEnergy tiene una URL con un archivo JSON pensado para integradores y
programadores informáticos. El archivo es accesible en la URL, por defecto
http://169.254.0.4/values.json
Cada vez que se accede a la URL JSON, el dispositivo genera en tiempo real la
página de respuesta. Se pueden realizar consultas aleatorias y con una frecuencia
máxima de una consulta cada 5 segundos.
Esquema del documento JSON:
El formato de la energía es el siguiente: Array: [<activa consumida>, <activa
generada>, <reactiva Q1>, <reactiva Q2>, <reactiva Q3>, <reactiva Q4>]
device: nodo raíz JSON.
uid: UID o dirección MAC del equipo.
version: versión del equipo.
boottime: fecha de arranque del equipo en formato UNIX time stamp.
timestamp: fecha actual en formato UNIX time stamp.
magnitude: nodo de las magnitudes eléctricas.
L<n>: nodo de las variables de L1, L2 y L3
voltage: voltaje de L<n> (float, V).
current: corriente de L<n> (float, A).
active: potencia activa de L<n> (long, W).
reactive: potencia reactiva de L<n> (long, var).
rective_t: tipo de reactiva de L<n>, C (capacitiva) o I (inductiva).
pf: factor de potencia de L<n> (float, %).
energy: energía de L<n> (unsigned long, Wh, varh).
III: nodo de las variables trifásicas.
active: potencia activa trifásica (long, W).
reactive: potencia reactiva trifásica (long, var).
reactive_t: tipo de reactiva trifásica, C (capacitiva) o I (inductiva).
apparent: potencia aparente trifásica (long, VA).
pf: factor de potencia trifásico (float, %).
energy: energía trifásica (unsigned long, Wh, varh).
frecuency: frecuencia de la red (float, Hz).
current_nct: corriente de neutro medida con transformador (float, A).
current_n: corriente de neutro calculada (float, A).
device: nodo raíz XML.
uid: UID o dirección MAC del equipo.
version: versión del equipo.
boottime: fecha de arranque del equipo en formato UNIX time stamp.
timestamp: fecha actual en formato UNIX time stamp.
magnitude: nodo de las magnitudes eléctricas.
L<n>: nodo de las variables de L1, L2 y L3
voltage: voltaje de L<n> (float, V).
current: corriente de L<n> (float, A).
active: potencia activa de L<n> (long, W).
reactive: potencia reactiva de L<n> (long, var).
rective_t: tipo de reactiva de L<n>, C (capacitiva) o I (inductiva).
pf: factor de potencia de L<n> (float, %).
energy: nodo de las energías.
active_in: energía activa consumida (unsigned long, Wh).
active_out: energía activa generada (unsigned long, Wh).
reactive_q1: energía reactiva Q1 (unsigned long, varh).
III: nodo de las variables trifásicas.
active: potencia activa trifásica (long, W).
reactive: potencia reactiva trifásica (long, var).
reactive_t: tipo de reactiva trifásica, C (capacitiva) o I (inductiva).
apparent: potencia aparente trifásica (long, VA).
pf: factor de potencia trifásico (float, %).
energy: nodo de las energías.
active_in: energía activa consumida (unsigned long, Wh).
active_out: energía activa generada (unsigned long, Wh).
frecuency: frecuencia de la red (float, Hz).
current_nct: corriente de neutro medida con transformador (float, A).
current_n: corriente de neutro calculada (float, A).
BROADCAST UDP
El ODEnergy tiene la opción de enviar tramas por broadcast UDP a la red a la cual
está conectado. El broadcast está desactivado por defecto, se puede activar en el
menú de configuración marcando en la casilla de “Broadcast”.
En el mismo apartado de configuración se puede elegir la frecuencia de envío de
los datos a la red que puede ser de 15, 30 o 60 segundos.
El broadcast está pensado para la comunicación con el dispositivo de
automatización ODControl para poder programar encendidos o apagados en
función del valor de la magnitud eléctrica medida por el ODEnergy.
Las tramas broadcast se envían por el puerto 1729, puede ver información más
detallada en la Wiki de OpenDomo.
ODELOGGER
El ODELogger es una aplicación para el registro de datos (datalogger) para
recopilar los datos de un ODEnergy conectado a la red. Puede descargar el
programa de forma gratuita en http://www.opendomo.com/ en el apartado de
“Comunidad”.
El ODELogger puede registrar todas las variables medidas por el ODEnergy y
guardarlas en un archivo con formato CSV que posteriormente podrá abrirlo desde
una aplicación de hoja de cálculo (por ejemplo Microsoft Excel, LibreOffice Calc,
Gnumeric, etc) o desde una aplicación de base de datos para su posterior
guardado o análisis.
WEBSERVICES XML
El ODEnergy tiene una URL con un archivo XML pensado para integradores y
programadores informáticos. El archivo es accesible en la URL, por defecto
http://169.254.0.4/values.xml
Cada vez que se accede a la URL XML, el dispositivo genera en tiempo real la
página de respuesta. Se pueden realizar consultas aleatorias y con una frecuencia
máxima de una consulta cada 5 segundos.
2
www.opendomo.com - rev.2 2016

ODEnergy

Transcripción

Documentos relacionados

Economizador de Energía Eléctrica

Pies y tobillos fuertes y reactivos Ante nada es necesario aclarar de

Descripción de los ficheros generados por Medcom Plus