Assembly and trouble shooting 

WiFi Setup

We need to provide the Raspberry Pi in the voice kit with the name and the password for the WiFi connection. Use the same WiFi you computer or laptop is connected to. Here are the steps

1. Find the microSD card in the small box. It is inside a bag with an ORCSGirls Sticker

2. Use the microSD card adapter and insert the microSD card

3. Insert the adapter in a USB port on your computer or laptop (you might need an adapter is you do not have a 'big' USB-A port)

4. The card should show up as a drive called Boot on you computer

5. Visit the webpage https://play.orcsgirls.org/Pi/wifi.php and enter your WiFi network name (SSID) and password. Make sure everything is spelled correct. Click Download.

6. Copy the download file wpa_supplicant.conf to the microSD card (Drive Boot)

7. Eject the microSD card drive

8. Remove the adapter and the microSD card

9. Insert the microSD card into the Raspberry Pi (similar to step 66 we skipped earlier)

Powering up

Follow these instructions to power up the voice kit and let it boot. Make sure you see the green light blinking  after a few seconds indicating activity. If it successfully starts up, you will hear a beep and the green LED in the front lights up - be patient, the first boot might take a minute or two.

Connecting to the voice kit

For those who cannot wait, the link http://orcspi-voice.local:5555 will connect you to Jupyter 😎

You can also connect to the voice kit using ssh. On Mac and Window you should have a terminal program. Open is and enter this command ssh pi@orcspi-voice.local - answer yes to the first finger print question, then enter the password (same as last class, Slack me if you need it). You should see a command prompt for your Raspberry Pi where you can enter commands.

Creating Google Assistant Credentials

Follow the setup steps below until slide 28.

Starting the assistant

You need to start the Google Assistant manually using the command below in a terminal on the Raspberry Pi (we will use a Notebook later)

./examples/assistant_grpc_demo.py

This requires you uploaded the credentials file. The first time it will show a link in the terminal. Open that link in your web browser and you see a Google login. Sign in with the same Google account you used to setup and added as test user. It will show a warning. Allow and copy the password code it shows at the end. The paste that code in the terminal window. The assistant should complete the start up. This step is only needed the first time you run the assistant.

If all went well the button on the voice box turns red. Press the button, wait a second or so (button turns brighter red) and then say for example 'Sing me a song' 🎶

Shutting down

The Raspberry Pi is a 'real' computer and just like a laptop or computer it needs to be shutdown before turning off power. Many times just turning it off will be ok, but it has the (small) danger of damaging the file system on the microSD card and not booting again. The proper way to shutdown is

1. Open a terming and connect to the Raspberry Pi (using ssh)

2. Enter the command sudo shutdown now

3. Wait for the green light on the Pi to stop blinking and turn off

4. Turn off power

WiFi connectivity

If the link above does not connect you to your voice kit, here are a few trouble shooting steps. Try them in order and check after every step if connecting starts working.

1. Make sure the Pi and your computer are on the same WiFi network.

2. Make sure you copied the file wpa_supplicant.conf with the correct WiFi credentials on the microSD card before inserting it into the Pi. If you are not sure, turn the Pi off and remove the card.  Use the adapter and insert it in to the laptop or computer. Note the file will not be on there, since the Pi removes it after booting. Create a new wpa_supplicant.conf using https://play.orcsgirls.org/Pi/wifi.php and copy it on the microSD card. Open the drive (Boot) on your computer and verify the file is there. Eject and remove the microSD card and re-insert it into the Raspberry Pi. Boot up - wait a few minutes and try to connect.

3. Some networks do not recognize '.local' internet addresses. In this case we need to find the IP address of the Raspberry Pi. Since if does not have a display, we need to look for it. Ask a parent if they have a tool to show all the computers on your home WiFi (many times logging into the WiFi router will show that) - find orcspi-voice and note the IP address (often something like 192.168.0.xxx). Alternatively you can use the Angry IP Scanner (with parents permission) to scan your home network for connected devices and look for orcspi-voice. Then try using that address e.g. 192.168.0.xxx:5555 to connect. 

4. If you have an Android phone, you can also download the AIY app and use it to connect to your WiFi (follow the instructions in the app) and it will tell you the IP address. There is no such app for the iPhone. If you cannot find you IP address, there are other methods to scan for it - contact me 🙂

5. If all else fails, you can connect a monitor and keyboard to the Raspberry Pi. You will see a login (username Pi, password like before - ask me if you do not know). A desktop will come up and you can go to settings and connect to the WiFi. Note you will need a HDMI adapter and a USB adapter - both were included in the Pi Environment box for those who participated before. More details on how to connect can be found here.