Eedomus toolbox

Documentation eedomus

Sommaire

L'eedomus toolbox est un utilitaire expérimental disponible sur le serveur web de votre box eedomus.

Son usage est reservé aux utilisateurs les plus avertis ;)

4 outils sont actuellement disponibles :

  • Le PING permet de connaitre l'état d'un membre de votre réseau (PC, Smartphone, ...) ou d'un serveur (permet également de connaitre l'état de votre connexion internet)
  • Le Wake On LAN (WOL) permet de réveiller un périphérique réseau qui répond à ce type de paquet (MediaCenter, PC, ...)
  • La découverte UPnP qui aide à identifier les périphériques UPnP actionnables sur son réseau.
  • Le redémarrage, à utiliser de manière parcimonieuse, et normalement non nécessaire

De manière générale l'eedomus toolbox est appelée ainsi: 

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

http://ip_de_votre_box peut être remplacé par localhost (http://localhost/).

Les appels à l'eedomus toolbox sont particulièrement intéressants combinés à des capteurs HTTP (pour le ping notamment) et à des actionneurs HTTP (WOL) dans ce cas ip_de_votre_box peut alors être remplacé par localhost pour plus de simplicité. Le capteur/actionneur HTTP, situé sur la box, appelle l'utilitaire situé lui aussi sur la box.

Pratique :

Pour que l'équipement cible (du PING ou WOL) ait toujours la même adresse IP, vous pouvez utiliser une adresse fixe,

ou mieux, demander à votre routeur ADSL de lui donner par le DHCP toujours la même adresse (bail fixe DHCP).

Votre équipement IP aura ainsi toujours la même adresse IP.

PING

REMARQUE : il est maintenant recommandé d'utiliser la méthode indiquée dans la supervision du réseau local qui est bien plus performante et moins couteuse en ressources.

Argument obligatoire : url (adresse IP ou nom de domaine de l'équipement)

Argument optionnel: count (nombre de tentatives avant de considérer l'échec. 3 par défaut.)

Exemple : 

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

Le résultat de la requête est au format XML.

Exemple de résultat : 

Fichier:eedomus_ping_ok.png

Exemple d'utilisation avec un capteur HTTP (le résultat est filtré avec le XPath /eedomus/result) : 

Fichier:eedomus_ping01.png

Dans les valeurs du capteur HTTP, vous pouvez personnaliser le nom qui s'affichera en cas de détection de l'adresse IP (ici : joignable et non joignable). 

Fichier:eedomus_ping02.png

Exemple d'utilisation par Domotique34

WOL

Utiliser un Actionneur HTTP (et non un capteur HTTP qui lancerait la requête régulièrement).

Argument obligatoire : mac (Adresse MAC de l'équipement à réveiller, au format XX:XX:XX:XX:XX:XX)

Exemple: 

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

Exemple de résultat : 

Fichier:eedomus_wol_ok.png

Exemple d'utilisation avec un actionneur HTTP 

Fichier:eedomus_wol01.png

Nota:

Certains périphériques réseaux peuvent nécessiter l'envoi de paquets alternatifs pour les réveiller.

Vous pouvez tenter la variante wol2 qui nécessite de préciser l'adresse IP correspondant à la MAC 

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

UPnP

Cette fonction liste les périphériques UPnP actionnables sur son LAN.

Argument optionnel: format (préciser &format=xml pour obtenir un résultat XML plutôt que JSON.)

Exemple : 

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

Si aucun périphérique n'est découvert [] sera renvoyé. La découverte des périphériques UPnP peut prendre jusqu'à 30 secondes, d'où le délai d'affichage du résultat. Essayez deux fois si l'affichage ne fonctionne pas la première fois.

Exemple de résultat : 

[{"ip":"192.168.0.24","description":"Bureau (BUREAU : Windows Media Player)","devnum":1}]

Reboot

Redémarre votre box eedomus. Le redémarrage de la box eedomus n'est pas nécessaire en utilisation courante, cette action ne doit être utilisée que pour des besoins précis et strictement nécessaires.

Exemple: 

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

Synthèse Vocale

Faites parler votre box eedomus+ à la demande (Depuis un script extérieur par exemple)

Voici un exemple, dans le cas ou l'adresse IP de votre box est 192.168.0.30 : 

http://192.168.0.30/tools/?action=tts&text=Salut,%20je%20parle%20!

Vous pouvez utiliser des %20 ou des espaces pour séparer vos mots.

Remarque : Vous pouvez changer la langue de prononciation avec la toolbox en rajoutant l'argument &lng=en-GB (Pour l'instant les langues disponibles sont fr-FR, en-GB, en-US, es-ES, de-DE, it-IT)

Remarque 2 : Il est également possible de diffuser la voix sur un récepteur UPnP, en précisant son adresse IP comme dans cet exemple &upnp_broadcast=192.168.0.34


Obtenir une adresse IP

Obtenez l'adresse IP d'un équipement de votre réseau à partir de son adresse MAC (eedomus+ uniquement).

Cette fonction peut être utile pour connaitre l'adresse IP d'un appareil dont l'IP serait susceptible de changer. 

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

Remarques :