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