Control remoto - Webservices

Control remoto – Webservices

Fácil comunicación

Se puede recuperar información, realizar y cambiar ajustes a través de la web con simples comandos HTTP.
La comunicación se hace a través del Miniserver de Loxone.

Los webservices se construyen de la siguiente manera:

(Utiliza la tecnología Restful-Webservice).

http://Usuario:Contraseña@IP-Miniserver/command/control/value

“control”: puede ser cualquier entrada o salida analógica o virtual. De las salidas sólo puede obtenerse su estado.
“value”: valor a enviar. Si no se especifica el comando devolverá el valor actual del control. Los valores permitidos son los siguientes: On, Off, Pulse, valor decimal con punto.
Para entradas virtuales con 2 salidas se permiten los siguientes valores:

ImpulsPlus ImpulsMinus	PulseUp PulseDown	ImpulsAuf ImpulsAb	PulseOpen PulseClose
PlusEin PlusAus	UpOn UpOff	AufEin AufAus	OpenOn OpenOff
MinusEin MinusAus	DownOn DownOff	AbEin AbAus	CloseOff CloseOff

Para las entradas y salidas digitales un ‘1’ es ‘On’ y un ‘0’ es ‘Off’.
Para las entradas analógicas (0-10V) el rango de trabajo es de 0 a 10.00. No hay límites (por ejemplo las temperaturas EIB pueden ser 21.5 o 5.2).
Se utiliza el punto como salida decimal.

Status y control

Comprobación del estado de un controlador

Comando	http://miniserver/dev/sps/io/ LichtWohnzimmer/state
Función	Devuelve els estado de una Entrada
Respuesta	<LL control=“dev/sps/io/ LichtWohnzimmer“ value=“0“ Code=“200“/>
Comando	http://miniserver/dev/sps/io/ LichtWohnzimmer/astate
Función	Devuelve el valor de las salidas solicitadas (ya sea un valor único para todos o con valores diferentes)
Respuesta	<LL control=“dev/sps/io/LichtWohnzimmer“ value=“1“ Code=“200“/>
Comando	http://miniserver/dev/sps/io/LichtWohnzimmer/all
Función	Devuelve el número de salidas solicitadas y una lista de los valores de todas las salidas
Respuesta	<LL control=»dev/sps/io/ LichtWohnzimmer /all» value=»8″ Code=»200″ n1=»Aktor (Relais) Q1″ u1=»68347a0e-3bfc-11df-85f6ea34eeb9b08a» v1=»0″ n2=»Aktor (Relais) Q2″ u2=»68347a0e-3bfc-11df-85f6ea34eeb9b08a» v2=»0″ n3=»Aktor (Relais) Q3″ u3=»68347a0e-3bfc-11df-85f6ea34eeb9b08a» v3=»0″ n4=»Aktor (Relais) Q4″ u4=»68347a0e-3bfc-11df-85f6ea34eeb9b08a» v4=»0″ n5=»Aktor (Relais) Q5″ u5=»68347a0e-3bfc-11df-85f6ea34eeb9b08a» v5=»0″ n6=»Aktor (Relais) Q6″ u6=»68347a0e-3bfc-11df-85f6ea34eeb9b08a» v6=»1″ n7=»Aktor (Relais) Q7″ u7=»68347a0e-3bfc-11df-85f6ea34eeb9b08a» v7=»0″ n8=»Aktor (Relais) Q8″ u8=»68347a0e-3bfc-11df-85f6ea34eeb9b08a» v8=»0″/>
Comando	http://miniserver/data/status
Función	Lista de todos los todos los dispositivos que estén conectados al Miniserver, junto con sus estados.
Respuesta	<Status Modified=»»> <Miniserver Name=»Miniserver Büro» Internalname=»» IP=»» Mask=»» Gateway=»» DHCP=»» DNS1=»» DNS2=»» MAC=»» Device=»» Version=»»> <Extension Name=»» Internalname=»» Serial=»» Version=»» Online=»»/> </Miniserver> </Status>

info_small

La solicitud de estado está disponible con las entradas y salidas pero no con los bloques de funciones.

Pulsador

Comando	http://miniserver/dev/sps/io/ TasterLichtWohnzimmer/Ein
Función	Controla la entrada digital o analógica.
Respuesta	<LL control=“dev/sps/io/TasterLichtWohnzimmer“ value=“1“ Code=“200“/>

Consultar los cambios de las salidas

Comando	http://miniserver/dev/sps/enablestatusupdate
Función	Permite el envío automático de los cambios de estado en el WebSocket.
Respuesta	Envía el estado actual a través de Websocket.

Configuración y estadísticas

Comandos SPS

Comando	Función
http://miniserver/dev/sps/status	Consulta el Estado del SPS 0 – No estado 1 – SPS reiniciandose 2 – SPS cargando programa 3 – Iniciando SPS 4 – Iniciando BUS 5 – SPS en marcha 6 – SPS cambio 7 – SPS error 8 – Introduciendo actualización
http://miniserver/dev/sps/restart	Reinicio del SPS
http://miniserver/dev/sps/stop	Detiene el SPS
http://miniserver/dev/sps/run	Continua el SPS
http://miniserver/dev/sps/log	Permite registro global del SPS
http://miniserver/dev/sps/nolog	Detiene el registro global del SPS
http://miniserver/dev/sps/enumdev	Lista de todos los dispositivos SPS (Minisever, Extensiones,…)
http://miniserver/dev/sps/enumin	Lista de todas las entradas del SPS
http://miniserver/dev/sps/enumout	Lista de todas las salidas del SPS
http://miniserver/dev/sps/identify	Identificar Miniserver (versión 1.5.6.7 y posteriores) El número de serie debe de entrarse como parámetro en las extensiones.

Comandos de configuración

Comando	Función
http://miniserver/dev/cfg/mac	Obtiene la dirección MAC
http://miniserver/dev/cfg/version	Obtiene la versión del firmware
http://miniserver/dev/cfg/versiondate	Obtiene la fecha de creación del firmware
http://miniserver/dev/cfg/dhcp	Obtiene la configuración DHCP
http://miniserver/dev/cfg/ip	Obtiene la dirección IP
http://miniserver/dev/cfg/mask	Obtiene la máscara IP
http://miniserver/dev/cfg/gateway	Obtiene la dirección de la puerta de enlace
http://miniserver/dev/cfg/device	Obtiene el nombre del Miniserver
http://miniserver/dev/cfg/dns1	Obtiene la dirección 1 de las DNS
http://miniserver/dev/cfg/dns2	Obtiene la dirección 2 de als DNS
http://miniserver/dev/cfg/ntp	Consigue la dirección NTP
http://miniserver/dev/cfg/timezoneoffset	Obtiene la zona horaria
http://miniserver/dev/cfg/http	Obtiene el puerto HTTP
http://miniserver/dev/cfg/ftp	Obtiene el puerto FTP
http://miniserver/dev/cfg/LoxPLAN	Obtiene el puerto de configuración del software
http://miniserver/dev/cfg/ftllocalonly	Obtiene (FTP, Telnet, solo acceso de software local)

Comandos de sistema

Comando	Función
http://miniserver/dev/lan/txp	Recupera el número de paquetes LAN enviados
http://miniserver/dev/lan/txe	Recupera el número de paquetes LAN enviados con errores
http://miniserver/dev/lan/txc	Recupera el número de paquetes LAN enviados con colisiones
http://miniserver/dev/lan/exh	Recupera el número de errores del buffer LAN
http://miniserver/dev/lan/txu	Recupera el número de errores LAN under-run
http://miniserver/dev/lan/rxp	Recupera el número de paquetes LAN recibidos
http://miniserver/dev/lan/eof	Recupera el número de errores LAN EOF
http://miniserver/dev/lan/rxo	Recupera el número de errores de desbordamiento de la LAN recibidos
http://miniserver/dev/lan/nob	Recupera el número de errores LAN de “No buffer de recepción»
http://miniserver/dev/bus/packetssent	Recupera el número de paquetes enviados al bus-CAN
http://miniserver/dev/bus/packetsreceived	Recupera el número de paquetes recibidos en el bus-CAN
http://miniserver/dev/bus/receiveerrors	Recupera el número de errores recibidos en el bus-CAN
http://miniserver/dev/bus/frameerrors	Recupera el número de errores de trama en el bus-CAN
http://miniserver/dev/bus/overruns	Recupera el número de errores de desbordamiento del bus-CAN
http://miniserver/dev/bus/parityerrors	Recupera el número de errores de paridad en el bus-CAN
http://miniserver/dev/sys/numtasks	Recupera el número de tareas
http://miniserver/dev/sys/cpu	Recupera la carga de CPU
http://miniserver/dev/sys/contextswitches	Recupera el número de cambios entre tareas
http://miniserver/dev/sys/contextswitchesi	Recupera el número de cambios entre tareas que provocaron interrupciones
http://miniserver/dev/sys/heap	Recupera el tamaño de la memoria
http://miniserver/dev/sys/ints	Recupera el número de interrupciones del sistema
http://miniserver/dev/sys/comints	Recupera el número de interrupciones en la comunicación
http://miniserver/dev/sys/lanints	El número de interrupciones que trae la LAN
http://miniserver/dev/sys/watchdog	Recupera los bits de watchdog
http://miniserver/dev/sys/date	Devuelve la fecha local
http://miniserver/dev/sys/time	Devuelve la hora local
http://miniserver/dev/sys/setdatetime	Establece la fecha y la hora del sistema Formato: 2010-04-20 14:35:00 o 20/04/2010 14:35:00
http://miniserver/dev/sys/spscycle	Recuperar el número de ciclos del SPS
http://miniserver/dev/sys/ntp	Fuerza la solicitud del NTP
http://miniserver/dev/task0/name	Recupera el nombre de la tarea 0 (0- http://nubuserver/dev/sys/numtasks – 1)
http://miniserver/dev/task0/priority	Recupera la prioridad de la tarea 0
http://miniserver/dev/task0/stack	Recupera el stack de la tarea 0
http://miniserver/dev/task0/contextswitches	Recupera el número cambios de la tarea 0
http://miniserver/dev/task0/waittimeout	Recuperar el tiempo de espera en ms de la tarea 0
http://miniserver/dev/task0/state	Recuperar el estado de la tarea 0
http://miniserver/dev/sys/reboot	Arrancar el Miniserver
http://miniserver/dev/sys/check	Muestra las conexiones activas en Loxone Config
http://miniserver/dev/sys/logoff	Separa las conexiones existentes en Loxone Config
http://miniserver/dev/sys/sdtest	Comprueba la tarjeta SD
http://miniserver/dev/sys/lastcpu	Se muestra el último valorde la CPU y el número de ciclos dePLC
http://miniserver/dev/sys/search	Realiza una búsqueda de las extensiones conectadas
http://miniserver/dev/sys/searchdata	Enumera los resultados de la búsqueda
http://miniserver/dev/fslist/	Enumera el directorio raíz de la tarjeta SD
http://miniserver/dev/fslist/path/	Enumera el directorio «path» de la tarjeta SD
http://miniserver/dev/fsget/filepath/	Recuperar un archivo (remplaza la ruta de archivo por el nombre de archivo)
http://miniserver/dev/fsdel/filepath/	Eliminar un archivo (remplaza la ruta de archivo por el nombre de archivo)
http://miniserver/data/status	Muestra el estado del Miniserver y las Extensiones
http://miniserver/stats	Muestra las estadísticas
http://miniserver/stats/index.html	Muestra las estadísticas
http://miniserver/data/weatheru.xml	Muestra los datos meteorológicos
http://miniserver/data/LoxAPP3.json	Archivo de estructura para visualización
http://miniserver/dev/fsget/log/def.log	Recuperar inicio
http://miniserver/dev/sys/ExtStatistics/ 05000001	Recuperar las estadísticas de una 1-wire Extension (reemplazar 05000001 por el número de serie real)
http://miniserver/dev/sys/AirStatistics/ 0C000001/DeviceIndex	Recuperar las estadísticas de una Air Base Extension (reemplazar 0C000001 por el número de serie real)
http://miniserver/dev/sys/updateext	Iniciar la actualización de las extensiones