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

Comandohttp://miniserver/dev/sps/io/
LichtWohnzimmer/state
FunciónDevuelve els estado de una Entrada
Respuesta<LL control=“dev/sps/io/
LichtWohnzimmer“ value=“0“ Code=“200“/>
Comandohttp://miniserver/dev/sps/io/
LichtWohnzimmer/astate
FunciónDevuelve 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“/>
Comandohttp://miniserver/dev/sps/io/LichtWohnzimmer/all
FunciónDevuelve 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″/>
Comandohttp://miniserver/data/status
FunciónLista 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

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

 

Consultar los cambios de las salidas

Comandohttp://miniserver/dev/sps/changes
FunciónEnvía todas las salidas que se han modificado desde la última llamada.
Respuesta<LL control=”dev/sps/changes” value=”5″ Code=”200″ n1=”Aktor (Relais) Q1″ u1=”68347a0e-3bfc-11df-8604ea34eeb9b08a” v1=”0″ n2=”Aktor (Relais) Q2″ u2=”68347a0e-3bfc-11df-8605ea34eeb9b08a” v2=”0″ n3=”Aktor (Relais) Q3″ u3=”68347a0e-3bfc-11df-8606ea34eeb9b08a” v3=”0″ n4=”Aktor (Relais) Q4″ u4=”68347a0e-3bfc-11df-8607ea34eeb9b08a” v4=”0″ n5=”Aktor (Relais) Q5″ u5=”68347a0e-3bfc-11df-8608ea34eeb9b08a” v5=”1″/>
Comandohttp://miniserver/dev/sps/event
FunciónGenera un servidor de eventos en el Webserver. Se debe programar un controlador de eventos en el cliente Web (por ejemplo: new EventSource (http://miniserver/dev/sps/event).
RespuestaEnvía todos las salidas que han cambiado sin nueva petición para enviar.
http://www.w3.org/TR/eventsource/
Event: changed
data: Name
data: uuid
data: Wert
Comandohttp://miniserver/dev/sps/enablestatusupdate
FunciónPermite el envío automático de los cambios de estado en el WebSocket.
RespuestaEnvía el estado actual a través de Websocket.

 

Configuración y estadísticas

Comandos SPS

ComandoFunción
 http://miniserver/dev/sps/statusConsulta 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/restartReinicio del SPS
 http://miniserver/dev/sps/stopDetiene el SPS
 http://miniserver/dev/sps/runContinua el SPS
 http://miniserver/dev/sps/logPermite registro global del SPS
 http://miniserver/dev/sps/nologDetiene el registro global del SPS
 http://miniserver/dev/sps/enumdevLista de todos los dispositivos SPS (Minisever, Extensiones,…)
 http://miniserver/dev/sps/enuminLista de todas las entradas del SPS
 http://miniserver/dev/sps/enumoutLista de todas las salidas del SPS
 http://miniserver/dev/sps/identifyIdentificar 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

ComandoFunción
http://miniserver/dev/cfg/macObtiene la dirección MAC
http://miniserver/dev/cfg/versionObtiene la versión del firmware
http://miniserver/dev/cfg/versiondateObtiene la fecha de creación del firmware
http://miniserver/dev/cfg/dhcpObtiene la configuración DHCP
http://miniserver/dev/cfg/ipObtiene la dirección IP
http://miniserver/dev/cfg/maskObtiene la máscara IP
http://miniserver/dev/cfg/gatewayObtiene la dirección de la puerta de enlace
http://miniserver/dev/cfg/deviceObtiene el nombre del Miniserver
http://miniserver/dev/cfg/dns1Obtiene la dirección 1 de las DNS
http://miniserver/dev/cfg/dns2Obtiene la dirección 2 de als DNS
http://miniserver/dev/cfg/ntpConsigue la dirección NTP
http://miniserver/dev/cfg/timezoneoffsetObtiene la zona horaria
http://miniserver/dev/cfg/httpObtiene el puerto HTTP
http://miniserver/dev/cfg/ftpObtiene el puerto FTP
http://miniserver/dev/cfg/LoxPLANObtiene el puerto de configuración del software
http://miniserver/dev/cfg/ftllocalonlyObtiene (FTP, Telnet, solo acceso de software local)

 

Comandos de sistema

ComandoFunción
http://miniserver/dev/lan/txpRecupera el número de paquetes LAN enviados
http://miniserver/dev/lan/txeRecupera el número de paquetes LAN enviados con errores
http://miniserver/dev/lan/txcRecupera el número de paquetes LAN enviados con colisiones
http://miniserver/dev/lan/exhRecupera el número de errores del buffer LAN
http://miniserver/dev/lan/txuRecupera el número de errores LAN under-run
http://miniserver/dev/lan/rxpRecupera el número de paquetes LAN recibidos
http://miniserver/dev/lan/eofRecupera el número de errores LAN EOF
http://miniserver/dev/lan/rxoRecupera el número de errores de desbordamiento de la LAN recibidos
http://miniserver/dev/lan/nobRecupera el número de errores LAN de “No buffer de recepción”
http://miniserver/dev/bus/packetssentRecupera el número de paquetes enviados al bus-CAN
http://miniserver/dev/bus/packetsreceivedRecupera el número de paquetes recibidos en el bus-CAN
http://miniserver/dev/bus/receiveerrorsRecupera el número de errores recibidos en el bus-CAN
http://miniserver/dev/bus/frameerrorsRecupera el número de errores de trama en el bus-CAN
http://miniserver/dev/bus/overrunsRecupera el número de errores de desbordamiento del bus-CAN
http://miniserver/dev/bus/parityerrorsRecupera el número de errores de paridad en el bus-CAN
http://miniserver/dev/sys/numtasksRecupera el número de tareas
http://miniserver/dev/sys/cpuRecupera la carga de CPU
http://miniserver/dev/sys/contextswitchesRecupera el número de cambios entre tareas
http://miniserver/dev/sys/contextswitchesiRecupera el número de cambios entre tareas que provocaron interrupciones
http://miniserver/dev/sys/heapRecupera el tamaño de la memoria
http://miniserver/dev/sys/intsRecupera el número de interrupciones del sistema
http://miniserver/dev/sys/comintsRecupera el número de interrupciones en la comunicación
http://miniserver/dev/sys/lanintsEl número de interrupciones que trae la LAN
http://miniserver/dev/sys/watchdogRecupera los bits de watchdog
http://miniserver/dev/sys/dateDevuelve la fecha local
http://miniserver/dev/sys/timeDevuelve la hora local
http://miniserver/dev/sys/setdatetimeEstablece 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/spscycleRecuperar el número de ciclos del SPS
http://miniserver/dev/sys/ntpFuerza la solicitud del NTP
http://miniserver/dev/task0/nameRecupera el nombre de la tarea 0
(0- http://nubuserver/dev/sys/numtasks – 1)
http://miniserver/dev/task0/priorityRecupera la prioridad de la tarea 0
http://miniserver/dev/task0/stackRecupera el stack de la tarea 0
http://miniserver/dev/task0/contextswitchesRecupera el número cambios de la tarea 0
http://miniserver/dev/task0/waittimeoutRecuperar el tiempo de espera en ms de la tarea 0
http://miniserver/dev/task0/stateRecuperar el estado de la tarea 0
http://miniserver/dev/sys/rebootArrancar el Miniserver
http://miniserver/dev/sys/checkMuestra las conexiones activas en Loxone Config
http://miniserver/dev/sys/logoffSepara las conexiones existentes en Loxone Config
http://miniserver/dev/sys/sdtestComprueba la tarjeta SD
http://miniserver/dev/sys/lastcpuSe muestra el último valorde la CPU y el número de ciclos dePLC
http://miniserver/dev/sys/searchRealiza una búsqueda de las extensiones conectadas
http://miniserver/dev/sys/searchdataEnumera 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/statusMuestra el estado del Miniserver y las Extensiones
http://miniserver/statsMuestra las estadísticas
http://miniserver/stats/index.htmlMuestra las estadísticas
http://miniserver/data/weatheru.xmlMuestra los datos meteorológicos
http://miniserver/data/LoxAPP2.xmlArchivo de estructura para visualización
http://miniserver/dev/fsget/log/def.logRecuperar 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/updateextIniciar la actualización de las extensiones