Activer les appels téléphoniques sur Arduino UNO avec Twilio et Yaler – Projet "Appelle mon Arduino"

Composants et fournitures

• Arduino UNO × 1
• Shield Ethernet Arduino × 1
• Capteur de température analogique (ex: TMP36) × 1

À propos de ce projet

(Source : Instructables)

Comment activer les appels téléphoniques vers votre Arduino, en utilisant Twilio et Yaler.net.

Twilio est un service Web qui transforme tout en téléphone. C'est une API REST pour la téléphonie, hébergée dans le cloud. Ici, Twilio demande à l'Arduino un nouveau fichier voice.xml chaque fois que quelqu'un appelle le numéro de téléphone prédéfini de l'Arduino. Le contenu de la réponse est lu à l'appelant par Alice, une voix du moteur de synthèse vocale de Twilio.

Yaler.net permet l'accès Web aux dispositifs embarqués derrière un pare-feu, NAT ou routeur de réseau mobile. Ici, il permet à Twilio d'accéder au fichier voice.xml sur l'Arduino, qui se trouve dans un réseau local et n'a donc pas sa propre adresse IP publique (divulgation : je suis fondateur de Yaler).

Cette démo utilise un capteur de température, mais tout autre capteur conviendrait. Un exemple de produit réel serait le détecteur de fumée Canary (maintenant Birdi) qui permet aux propriétaires inquiets de l'appeler pour savoir si la batterie va bien.

À un niveau plus abstrait, cet Instructable montre comment, dans un Internet des Objets ouvert, des services cloud modulaires peuvent être librement combinés pour construire des solutions novatrices, simples et fiables. HTTP et Webhooks FTW ! Mais commençons…

(Voici une vidéo expliquant ce projet depuis IoTLive, partie de IoTDay 2014)

Matériel

• Arduino Uno (ex: https://www.adafruit.com/products/50)
• Câble USB Standard A-B (ex: https://www.adafruit.com/products/62)
• Shield Ethernet Arduino (ex: https://www.adafruit.com/products/201)
• Câble Ethernet (ex: https://www.adafruit.com/products/995)
• Capteur de température analogique (ex: https://www.adafruit.com/products/165)
• Fils pour breadboard (ex: https://www.adafruit.com/products/153)
• Breadboard (ex: https://www.adafruit.com/products/64)

Étape 1 : Câblage du capteur

Ajoutez le shield Ethernet sur l'Arduino et connectez le capteur de température comme indiqué. Pour plus de détails sur la détection de température avec le capteur TMP36, voir par ex. Adafruit Learn.

Si vous voulez ajouter d'autres capteurs (numériques), gardez à l'esprit que certaines broches sont utilisées par le shield Ethernet.

Étape 2 : Installation de la bibliothèque Yaler

Suivez les trois étapes pour Installing the library sur yaler.net/arduino. Si ce n'est pas déjà fait, inscrivez-vous sur yaler.net pour un compte d'essai gratuit et notez le domaine de relais (la clé secrète n'est pas nécessaire).

Étape 3 : Programmation de l'Arduino

Téléchargez le code source Arduino TwilioYalerWebService

Lien Bitbucket

Ouvrez le code Arduino

Le programme implémente un serveur Web très simple qui écoute les requêtes HTTP entrantes. Une fois une requête reçue, le programme répond avec un document XML. Le serveur ne se soucie pas si le chemin d'URL est / ou /voice.xml.

Modifiez l'adresse MAC

Assurez-vous que l'adresse MAC dans le code Arduino est unique. C'est particulièrement important s'il y a plusieurs Arduinos dans le même réseau local. Une méthode simple pour obtenir une adresse (espérons-le) unique est de regarder l'adresse MAC de votre ordinateur et d'ajouter 1 au dernier chiffre.

Entrez votre domaine de relais

Au lieu de créer un serveur local avec EthernetServer server(80);, nous en créons un accessible via le relais Yaler try.yaler.net, dans la ligne suivante :

YalerEthernetServer server("try.yaler.net", 80, "RELAY_DOMAIN");

Remplacez RELAY_DOMAIN par votre domaine de relais, par exemple pour gsiot-ffmq-ttd5 tapez :

YalerEthernetServer server("try.yaler.net", 80, "gsiot-ffmq-ttd5");

Notez que vous pouvez aussi utiliser le serveur local, si vous savez comment configurer le port forwarding pour ouvrir un trou pour les requêtes HTTP entrantes dans votre pare-feu local. L'important est que Twilio puisse accéder à l'Arduino depuis le cloud.

Sauvegardez et téléversez

Sauvegardez toutes les modifications et téléversez le programme sur votre Arduino. Gardez le câble USB connecté à votre ordinateur de développement pour l'instant, et ouvrez la console série pour voir la sortie de débogage.

Étape 4 : Accéder à l'Arduino

Accédez à votre Arduino depuis n'importe quel navigateur

La bibliothèque Yaler rend votre Arduino (et avec lui le document XML) accessible depuis l'Internet public à https://RELAY_DOMAIN.try.yaler.net/, par exemple pour le domaine de relais gsiot-ffmq-ttd5 l'URL est https://gsiot-ffmq-ttd5.try.yaler.net/ Ou, pour faire plus joli pour Twilio : https://gsiot-ffmq-ttd5.try.yaler.net/voice.xml

Vérifiez le document XML

Le contenu du document XML dit à Twilio quoi répondre à un appel téléphonique entrant. Vous pouvez même choisir la voix de synthèse vocale. Ici c'est Alice. Le format XML de Twilio s'appelle TwiML. Voir Twilio Docs pour plus de détails. Notez que le texte de réponse contient la température réelle. Chauffez votre capteur et rafraîchissez le document dans votre navigateur Web avec F5 pour le voir changer.

Dépannage

Si vous obtenez une page vide ou une erreur, assurez-vous que votre câble Ethernet est branché et consultez yaler.net/browser pour le débogage spécifique au navigateur.

Étape 5 : Configuration d'un numéro Twilio

Inscrivez-vous

D'abord, pour obtenir un compte Twilio, vous devrez vous inscrire sur twilio.com.

Achetez un numéro de téléphone

Pour recevoir des appels, vous aurez besoin d'un numéro, qui a un (petit) coût. Connectez-vous, allez dans Numbers puis sous-menu Twilio Numbers, pour voir l'onglet Manage Numbers.

Cliquez sur Buy a number, cochez Voice et cliquez Search, puis choisissez un numéro et cliquez Buy.

Configurez l'URL du Webhook voice.xml

Dans l'onglet Manage Numbers, cliquez sur le numéro que vous venez d'acheter. Définissez l'Response URL sur https://RELAY_DOMAIN.try.yaler.net/voice.xml et assurez-vous que POST est sélectionné, par exemple pour le domaine de relais Yaler gsiot-ffmq-ttd5 définissez l'URL de réponse sur https://gsiot-ffmq-ttd5.try.yaler.net/voice.xml

Étape 6 : Passer un appel de test

Une fois l'Arduino configuré, vous pouvez l'appeler depuis n'importe quel téléphone - même celui de votre grand-père.

C'est tout, merci de votre lecture. @tamberg

Code

Le code source est disponible sur Bitbucket : TwilioYalerWebService.ino

Schéma