Setting Up AlexaPi

The first step towards robot world domination and build our Amazon Alexa controlled robot is to set up AlexaPi.

There are a few tutorials on how to turn your Raspberry Pi into an Amazon Echo using Amazon Alexa.  However, AlexaPi is the easiest way to get Amazon Alexa on your Raspberry Pi.  The project has prepared everything you can possibly do to make setting up Alexa Voice Services on your Raspberry Pi streamlined and easy.  The hardest part is setting up your Amazon Developer account and gathering your credentials (and really, that’s not that bad!).

Before you begin, you will want to connect your GoPiGo to your local wifi network, and establish a static IP address for it.  The Raspberry Pi will need a static IP address to set up the security credentials for Amazon.  Here’s a quick reminder of how to set a static IP address from your PC or how to set a static IP address with your Mac.

We followed the step-by-step instructions for setting up an account on your Raspberry Pi here.  First, you’ll need to Register for an Amazon developer account.  Setting up a developer account is free, and easy.  You need to create a device and security profile.

Installing AlexaPi on your Raspberry Pi is also quick!  You’ll need to punch in a few Git commands outline here.  Before you begin, gather up the credentials you created, such as your Client ID, your Client Secret, and your Security Profile ID.  In the command line:

cd /opt
sudo git clone https://github.com/alexa-pi/AlexaPi.git
sudo ./AlexaPi/src/scripts/setup.sh

At this point you should be able to run Alexa on your GoPiGo, just as you would an Amazon Echo. Ask it for a news update: “Alexa What’s the News?”

Setting Up IFTTT

If This Then That is a service that lets us connect different parts of the web together.  In our case, IFTTT helps us couple together Alexa with the Raspberry Pi. We need to use IFTTT because Alexa can’t return text strings to the Pi.  But it can alert IFTT.  IFTTT helps us bridge the AlexaPi responses back to the Raspberry Pi.  First, you’ll need to set up an IFTTT account here.  Again, this is free.

Next, you’ll need to add the IFTTT service to your AlexaPi.  You can do this by first installing the Alexa App on your mobile phone (it’s available for the iPhone and Android, and it’s free).  With your phone on the same network as your Pi, connect to your AlexaPi and add the IFTTT service.

Next in IFTTT, you will want to set up your applets.  We will need an applet for each command we want to send to the GoPiGo.

First, connect Amazon Alexa to your IFTTT Account.   Then we’ll do the following to create an applet that will handle a single command:

1. Create an IFTTT applet for our first command.  We will create an Alexa applet.

 

2.  Select “Say a Specific Phrase”.

 

3.  Specify the command. Say “Backward”

4.  Next, select “That”.

5.  We’ll use the action service “Maker”.

 

6.  Click “Make a web request” and specify the information.

7.  The URL is either your provided ngrok url, or your custom domain.  We will find this in our next step, but for now we can enter in “ngrok.io”.

 

8.  Our applet will be doing a “GET” method, the content will be text, and don’t put anything in the body.

9.  Click “Create Action” and then “Finish”.

We will need to do this for all the moves you want your Amazon Alexa controlled robot to make!  In our project we made seven: one for “Forward”, “Backward”, “Left”, “Stop”, “Right”, “Dance” and “Coffee”.

Connect to ngrok

We will have IFTTT contact a server on the Pi, but the tricky part will be setting up a server on the Pi that’s visible to the world outside our local WiFi network.    ngrok is a service that allows you to connect to your Raspberry Pi through any network.  With ngrok, you don’t need to be on the same local network as your Pi to SSH in or to access a web server.  ngrok will help us pipe information back from IFTTT to the Pi. IFTTT needs an internet-based URL to contact, so we’ll use ngrok to make our server accessible to the outside world.

We have a full tutorial on how to use ngrok with the Raspberry Pi here.

First, set up an account with ngrok here.  You can get away with a free account, but it will be much easier to set up Alexabot with a paid account.  A paid account will allow you to set up named servers, rather than ngrok’s randomly assigned server.

Next install ngrok on your Raspberry Pi.  On your Pi, in the command line, type:

 mkdir ~/ngrok
 cd ~/ngrok
 sudo wget https://bin.equinox.io/c/4VmDzA7iaHb/ngrok-stable-linux-arm.zip
 unzip ngrok-stable-linux-arm.zip

This should install all the software.  You will next need to get your token; this will authorize your Raspberry Pi to ngrok.  If you login to your account here, you will see step 2, with your token already populated.  It should start with “./ngrok authtoken”.  Copy the command, and paste it into your command line.

Test out ngrok.  You can type the following into the command line:

./ngrok http 80

And you should see a server start up.

When an IP address appears, try typing this into your browser.  You should see your default server on Port 80 come up.  With Raspbian for Robots, you should see the Raspbian for Robots entrance page show up.

We will start our server with the following command:

 ./ngrok http -subdomain=dexterindustries 5000

Where “dexterindustries” is a reserved domain set up with our basic account on ngrok.  If you go with the free account, you’ll now need to go back and re-enter the domain name that ngrok gave your Pi above into each of your IFTTT commands.

Set Up the Flask Server

The final step in setting up our Amazon Alexa controlled robot is setting up the Flask server on the Raspberry Pi.

We’ll set up a Flask server in Python to listen to IFTT.  We assume you’re running Raspbian for Robots, which has the Python package manager Pip already installed.  To install Flask on the Raspberry Pi, you’ll simply need to bang the following into your command line:

sudo pip install flask

That’s pretty much it.  Flask should be installed.  You can try running the flask server we’ve provided in our github code and see what happens.

You can find the file by either updating your GoPiGo directory, or by simply running:

sudo wget https://raw.githubusercontent.com/DexterInd/GoPiGo/master/Projects/Alexabot/alexabot-flask-app.py

And then run the server:

python alexabot-flask-app.py

You should see something like this:

To get a general idea of how the code works on the Flask server, we’ve set up each command to listen to a specific Flask URL.  For example, if you were to call, in your web browser, “http://alexabot.ngrok.io/forward” we get the response in our browser back “Alexabot moved forward!”.  Looking at the code for the directory “forward”:

print("Forward!")
gopigo.fwd() # Send the GoPiGo Forward
time.sleep(1) # for 1 second.
gopigo.stop() # the stop the GoPiGo
return 'Alexabot moved forward!'

The first think we’ll do is send some text to the command line.  Then we’ll send the GoPiGo forward (easy with a single line of code!), then wait 1 second, and then stop the GoPiGo.

This illustrates how the “Forward” command works; each command will also work this way with its own directory and custom code for moving the GoPiGo.

sudo python /opt/AlexaPi/src/main.py

sudo ~/ngrok/ngrok http -subdomain=dexterindustries -log=stdout 5000 > log.txt &

sudo python alexabot-flask-app.py