Acceso
Acceso vía peticiones HTTP
En este punto vamos a indicar únicamente los requerimientos básicos para trabajar con las peticiones HTTP. Encontrará una descripción más detallada de HTTP o HTTPS en el libro de TCP/IP-Ethernet, que puede descargar aquí gratuitamente.
En general, los creadores de aplicaciones que utilizan HTTP no tienen que ocuparse ellos mismos del desarrollo a nivel de protocolo. En el caso de las aplicaciones en navegador, es el navegador mismo o bibliotecas de funciones enlazadas los que se encargan de ello. También los modernos lenguajes de alto nivel ofrecen la activación de funciones a las que solo se transmite la petición HTTP respectiva.
Introduciendo la dirección https://wut.de/webio en la barra de direcciones del navegador, el servidor web de W&T suministra, por ejemplo, una página con una sinopsis de los modelos Web-IO de 230 V.
Un sencillo ejemplo para una petición HTTP técnica es el acceso a https://klima.wut.de/single, que simplemente suministra la temperatura exterior actual en el edificio de la empresa W&T.
Estructura de una petición HTTP
Una petición HTTP comienza siempre con la palabra clave http:// o bien https://, cuando se requiere una transmisión codificada. Le sigue la dirección IP o el nombre del host del servidor web con el que debe comunicarse.
HTTP se ejecuta a través del puerto TCP 80 y HTTPS por el puerto TCP 443. Si el servidor está accesible por otro puerto diferente, se puede agregar este por separado con :. Solo ahora le sigue la petición propiamente dicha, separada por / (por ejemplo el nombre de un sitio web como index.html). Dado el caso, pueden seguir ahora los parámetros requeridos detrás de un ?. Cuando sean varios los parámetros se utilizará & como separador.
http[s]://<server-ip>[:<port>]/<request>[?parameter¶meter&.......]
Comunicación vía peticiones HTTP
El intercambio de datos mediante peticiones HTTP equivale siempre a un escenario de pregunta-respuesta. Un cliente en HTTP envía una petición a un servidor web y este contesta con una respuesta HTTP. Por lo tanto, la parte activa de una comunicación HTTP es siempre el cliente HTTP. El servidor web nunca puede enviar datos al cliente por iniciativa propia a través de una solución exclusivamente HTTP.
Configuración
Configurar Web-API
Seleccione en la estructura de menús el entorno web Vías de comunicación >> Web-API y active Permitir peticiones HTTP.
El puerto HTTP puede ser ajustado en Ajustes básicos >> Red, si fuese necesario.
Las salidas que deban ser conmutadas por Web API tienen que estar habilitadas.
Sobre el punto anteponer dirección IP y nombres del sistema hablaremos más adelante.
Estructura de las peticiones
Formato y estructura de las peticiones HTTP
Como ya se ha mostrado más arriba, cada petición HTTP comienza con http:// o bien https:// seguido del comando de petición propiamente dicho. Es imprescindible respetar las mayúsculas y minúsculas indicadas aquí. Separados por ? pueden seguir otros parámetros. En todo caso, para Web-IO Digital la contraseña siempre con la sintaxis PW=password&. Cada grupo de parámetros debe estar cerrado con &, de modo que dos grupos de parámetros también queden separados por &.
Ejemplo: solicitud de entrada
Como ejemplo aquí el comando para acceder a los estados de conmutación de entradas. Web-IO está protegido por la contraseña azul.
http://192.168.0.25/input?PW=blau&
La respuesta de Web-IO difiere según el modelo, pudiendo ser, por ejemplo, así:
input;1 (Web-IO Digital 2xIn, 2xOut)
input;0001 (Web-IO Digital 12xIn, 12xOut o 12xIn, 6xRelais)
La estructura consta de la palabra clave de la consulta, seguida de uno o varios valores separados por punto y coma.
Por lo tanto, la respuesta comienza aquí con la palabra clave input seguida del valor 1 o bien de 0001, que describe el estado de conmutación de todas las entradas en formato hexadecimal. Aquí concretamente Entrada 0 = ON, todas las demás entradas = OFF.
Para una mejor comprensión del código hexadecimal de entradas he aquí otro ejemplo de un Web-IO con 12 entradas:
En ON se encuentran las entradas 0,1,5,7,10,11. Las otras entradas están en OFF. A partir de ese patrón de bit resulta un número dual en el que los bits ON equivalen a 1 y los bits OFF a 0.
En nuestro caso 1100 1010 0011.
En escritura hexadecimal equivale a CA3 o en una representación de cuatro dígitos 0CA3.
Encontrará más información acerca de la numeración hexadecimal aquí.
Ejemplo: aplicar salidas
El comando para aplicar salidas tiene una estructura similar al comando input, pero tiene más parámetros:
http://192.168.0.25/outputaccess0?PW=blau&State=ON&
La cifra detrás de la palabra clave outputaccess indica qué salida debe ser conmutada - aquí la salida 0. Con State se transmite el estado al que se conmuta. Son valores posibles ON, OFF y TOGGLE (cambio de estado).
La respuesta de Web-IO difiere según el modelo, pudiendo ser, por ejemplo, así:
output;1 (Web-IO Digital 2xIn, 2xOut)
output;0001 (Web-IO Digital 12xIn, 12xOut o 12xIn, 6xRelais)
Igual que en la consulta de la entrada, se envía como respuesta la palabra clave respectiva seguida del patrón de bit relativo a los estados de la salida. Independientemente de la salida aplicada, el patrón de bit describe siempre el estado de todas las salidas.
Encontrará una descripción detallada sobre los usos de las peticiones HTTP para los modelos de Web-IO Digital en la sinopsis de comandos de peticiones o en manual de programación para Web-IO.
