Eedomus toolbox

De eedomus - Documentación

Contenido


eedomus toolbox es una herramienta experimental disponible en el servidor web de su controlador eedomus.

Su uso está reservado a los usuarios experimentados ;)

Incluye actualmente 4 herramientas distintas:

  • El PING, que le permite conocer el estado de un dispositivo de su red (PC, smartphone, ...) o de un servidor (también permite conocer el estado de su conexión a Internet).
  • El Wake On LAN (WOL), que le permite despertar cualquier periférico de red que responda a este tipo de paquetes (MediaCenter, PC, ...).
  • El descubrimiento UPnP, que le ayuda a identificar periféricos UPnP controlables en su red.
  • El reinicio, que debe usarse de forma moderada y que no es necesario por norma general.

La URL que debe usar, en general, para llamar a eedomus toolbox es la siguiente: 

http:// ip_de_su_eedomus/tools/?action=XXXX&parameter1=...&...

Puede sustituir http:// ip_de_su_eedomus por localhost (http://localhost).

Las llamadas a eedomus toolbox son especialmente interesantes cuando se combinan con sensores HTTP (para el ping, entre otras cosas) y actuadores HTTP (WOL). En ese caso, puede sustituir / ip_de_su_eedomus por localhost para simplificar. El sensor/actuador HTTP, situado en el controlador, llama a la herramienta, la cual se encuentra también en el controlador.

Truco:

Para que el equipo de destino (del PING o WOL) tenga siempre la misma dirección IP, puede usar una dirección fija o -todavía mejor-, puede configurar su router ADSL para que le asigne siempre la misma dirección mediante DHCP (asignación de IP fija por DHCP).

De esta forma, su equipo IP siempre tendrá la misma dirección IP

PING

Argumento obligatorio: url (dirección IP o nombre de dominio del equipo).

Argumento opcional: count (número de intentos antes de considerar el fracaso. 3 por defecto).

Ejemplo: 

http://localhost/tools/?action=ping&url=eedomus.com

El resultado de la llamada se obtiene en formato XML.

Ejemplo de resultado: 

Archivo:eedomus_ping_ok_esp.png

Ejemplo de uso con un sensor HTTP (el resultado se filtra con el XPath /eedomus/result):

En los valores del sensor HTTP, puede personalizar el nombre que aparecerá en caso de que la dirección IP sea detectada (en el ejemplo de la siguiente imagen, detectado y no detectado).

Archivo:eedomus_ping02_esp.png 

Ejemplo de uso presentado por Domotique34 (en francés).

WOL

Debe usar un actuador HTTP (pero no un sensor HTTP ya que éste ejecutaría la llamada de forma cíclica).

Argumento obligatorio: mac (dirección MAC del equipo que quiera despertar, con el siguiente formato: XX:XX:XX:XX:XX:XX).

Ejemplo: 

http://localhost/tools/?action=wol&mac=00:25:22:7C:81:37

Ejemplo de resultado: 

Archivo:eedomus_wol_ok_esp.png

Ejemplo de uso con un actuador HTTP: 

Archivo:eedomus_wol01_esp.png

Nota:

Algunos periféricos de red pueden necesitar el envío de paquetes alternativos para despertar.

Puede probar con la variante wol2 indicando la dirección IP correspondiente a la MAC. 

http://192.168.0.30/tools/?action=wol2&mac=00:25:22:7C:81:37&ip=192.168.0.11

UPnP

Esta funcionalidad le permite obtener la lista de periféricos UPnP controlables de su LAN.

Argumento opcional: format (añada &format=xml si quiere obtener un resultado XML en vez de JSON).

Ejemplo: 

http://localhost/tools/?action=upnp

Si el sistema no descubre ningún periférico, devuelve []. El descubrimiento de los periféricos UPnP puede tardar hasta 30 segundos, por lo que el resultado puede tardar en aparecer. No dude en repetir el proceso si los resultados no aparecen la primera vez.

Ejemplo de resultado: 

[{"ip":"192.168.0.24","descripcion":"Despacho (DESPACHO: Windows Media Player)","devnum":1}]

Reboot

Le permite reiniciar su controlador eedomus. El reinicio del controlador eedomus no es necesario en el marco de un uso normal. Esta acción sólo debe usarse en caso de necesidades concretas y cuando sea estrictamente necesario.

Ejemplo: 

http://localhost/tools/?action=reboot

Síntesis de voz

Puede hacer que su controlador eedomus+ pronuncie locuciones bajo demanda (a través de un script externo, por ejemplo).

Ejemplo, suponiendo que la dirección IP de su controlador eedomus sea 192.168.0.30: 

http://192.168.0.30/tools/?action=tts&text=Hola,%20hablo%20

Puede usar %20 o espacios para separar las palabras.

Nota: Puede cambiar el idioma de pronunciación con toolbox añadiendo el argumento &lng=en-GB (los idiomas disponibles actualmente son los siguientes: fr-FR, en-GB, en-US, es-ES, de-DE, it-IT).

Nota 2: También puede difundir la síntesis de voz a través de un receptor UPnP, indicando su dirección IP, como en el siguiente ejemplo: &upnp_broadcast=192.168.0.34

Obtener una dirección IP

Puede obtener la dirección IP de un dispositivo conectado a su red local si conoce su dirección MAC.

Esta función es útil para conocer la dirección IP de un dispositivo con IP variable y que, por tanto, pueda cambiar. 

http://192.168.0.30/tools/?action=getip&mac=00:11:32:89:74:8D

Importante:

  • El parámetro mac no discrimina entre mayúsculas y minúsculas.
  • El controlador eedomus actualiza las direcciones IP cada 30 minutos (de los dispositivos accesibles).
  • Puede consultar la lista de direcciones de sus dispositivos de red (o forzar la actualización de las direcciones IP) en la página http://192.168.0.30/config/netscan.php