Application Karotz
Documentation eedomus
Sommaire |
Présentation
L'application eedomus pour Karotz propose différentes interactions entre votre système eedomus et votre lapin:
- Lecture à haute voix de la valeur de vos périphérique (sur passage de tag, reconnaissance vocale ou planification)
- Action sur un périphérique eedomus (sur passage de tag, reconnaissance vocale ou planification)
- Lecture de message à haute voix à la demande (déclenchement depuis l'interface eedomus, les règles)
Installation de l'app sur le Karotz
L'application est disponible gratuitement sur la boutique des applications Karotz avec le lien suivant:
http://www.karotz.com/appz/app?id=2368
Cliquez alors sur le bouton 
afin d'installer l'application sur votre Karotz.
Si vous n'êtes pas authentifié sous votre compte Karotz il vous sera demandé de le faire.
L'application eedomus pour Karotz peut alors être configurée selon le ou les modes de fonctionnement souhaités:
Modes de fonctionnement
Lecture de la valeur d'un périphérique
Exemple de configuration pour la lecture d'un capteur de température:
- Saisissez un nom de profil, cela vous aidera à vous y retrouver dans la configuration de l'application Karotz et pourra être utilisé pour un déclenchement par commande vocale
- Choisir la fonction de profil Lire la valeur d'un périphérique
- Saisissez votre API User (Si vous ne l'avez pas déjà, rendez-vous sur https://secure.eedomus.com, puis dans Configuration / Mon compte et cliquez sur Envoyer les identifiants pour l'API)
- Saisissez votre API Secret (qui vous a été communiqué avec votre identifiant API)
- Saisissez le code API du périphérique dont vous souhaitez lire la valeur (Connaitre le code API d'un périphérique)
- Complétez la phrase que vous souhaitez faire dire à votre lapin, le texte %val% sera remplacé par la valeur de votre périphérique.
- Configurez 1 ou plusieurs modes de déclenchement parmi ceux proposés (Manuel, permanent, planifié, ...)
- Cliquez sur Valider, c'est terminé !
Action sur un périphérique
Exemple de configuration pour allumer une lampe:
- Saisissez un nom de profil, cela vous aidera à vous y retrouver dans la configuration de l'application Karotz et pourra être utilisé pour un déclenchement par commande vocale
- Choisir la fonction de profil Exécuter une action sur un périphérique
- Saisissez votre API User (Si vous ne l'avez pas déjà, rendez-vous sur https://secure.eedomus.com, puis dans Configuration / Mon compte et cliquez sur Envoyer les identifiants pour l'API)
- Saisissez votre API Secret (qui vous a été communiqué avec votre identifiant API)
- Saisissez le code API du périphérique dont vous souhaitez lire la valeur (Connaitre le code API d'un périphérique)
- Saisissez l'ID de l'action à exécuter (Visible dans l'onglet Valeurs de la configuration de votre périphérique, ex. 0=Off, 100=On).
- Configurez 1 ou plusieurs modes de déclenchement parmi ceux proposés (Manuel, permanent, planifié, ...)
- Cliquez sur Valider, c'est terminé !
Lecture de messages
Pour ce mode de fonctionnement, il faut qu'au moins un profil soit créé sur votre application Karotz, si vous n'en avez pas encore vous pouvez en créer un du type Lecture TTS, sans vous soucier des paramètres, il ne servira qu'à donner la parole à votre lapin.
Vous aurez besoin par la suite de l'install id de votre application Karotz qui est disponible dans sa configuration:
La mise en place se fait ensuite sur le portail eedomus
Cliquez sur Configuration -> Ajouter ou supprimer un périphérique -> Ajouter un autre type de périphérique puis choisissez:
Saisissez la pièce à laquelle vous souhaitez associer votre Karotz, votre Install id Karotz puis cliquez sur Sauver
Vous pouvez maintenir définir les phrases de votre choix:
Et les utiliser depuis le widget ou dans vos règles.
Support
Si vous utilisez une lecture en retour d'une action sur le Karotz (par un tag RFID par exemple), utiliser une temporisation par une macro sur eedomus. Karotz est monotâche et n'acceptera pas la lecture si l'application eedomus sur le Karotz est toujours en cours.
Si vous recevez une erreur HTTP 500 dans une notification eedomus, la cause de l'erreur sera indiquée dans le résultat par l'API Karotz, par exemple NOT_CONNECTED si le Karotz est temporairement injoignable.
Partenariat
L'application eedomus pour Karotz a été développée en collaboration avec Planète-Domotique.com
