Vision Kit help
Voice Kit help
If you don’t see your issue here, try these other resources:
Or contact us at firstname.lastname@example.org.
Unboxing and getting started
I don’t have a power supply
To power your device, the kit includes a USB cable to connect to any 5V 2.1A USB source with the cable to provide power to the Raspberry Pi board.
My kit is missing parts
Send an email to email@example.com and our customer support team will help you with replacement parts.
I would like to return my kit
Please check the return policy of the retailer where you purchased the kit for a replacement or refund.
Booting and configuring
I want to connect to my AIY kit
Voice Kit v1 - using Raspberry Pi 3B
- Provide power to Raspberry Pi by connecting an external power adapter to the micro-USB port. Make sure the USB power adapter is rated 2.1A or higher. Attach a keyboard and mouse to the USB-A connectors next to the Ethernet (RJ45) connector.
- Plug your monitor’s HDMI cable into the connector on the Raspberry Pi board between the audio jack and the micro-USB power connector.
- If you don’t have a monitor, there are cheaper, portable options available.
Vision Kit, Voice Kit v2 - using Raspberry Pi Zero WH
- Power: plug in the power supply to the micro-USB connector marked “PWR” (it’s the one closest to the camera connector and the board).
- Peripherals: Attach a USB hub with a micro-USB adapter to the micro-USB connector marked “USB” (next to the power micro-USB connector). Then connect your USB keyboard and mouse to the hub.
- Monitor: The kits use a mini-HDMI connector, so if your monitor has a HDMI cable you’ll need to get a mini-HDMI adapter.
I don’t have an Android device for the AIY Projects app
At this time, only Android phones are supported for the AIY Projects app.
The app can’t find my AIY kit to pair with
There are a few reasons why this might happen. First, make sure your Voice Kit is still connected to a power supply and that the green LED on your Bonnet is still flashing. If it’s not flashing, it may have timed out. Press and hold the Bonnet button for 5 seconds, and try again.
If that doesn’t work, first try restarting the app. Then if that doesn’t work, your phone could be experiencing issues with Bluetooth, so try restarting your phone and starting the app pairing flow again.
I want to SSH into my AIY kit
The AIY Projects software image has SSH enabled by default. See the Raspberry Pi documentation for details on changing passwords after you connect the first time.
If you are running on standard Raspbian, you can enable SSH access by:
- Connect a keyboard, mouse and monitor to your Raspberry Pi.
- Open the terminal (by pressing Ctrl+Alt+T) on the Raspberry Pi
raspi-configto bring up the configuration tool and enable SSH access
I’ve tried everything and my kit still won’t boot
If you’ve tried all of the other suggested troubleshooting steps and still can’t get your kit to boot, your SD card might be corrupted. To fix this, you’ll need to reflash your SD card so that you can start fresh.
Note: reflashing your SD card will delete any files you’ve created or changes you’ve made, such as your Voice Kit credentials, so you might have to repeat some setup steps.
Updating your SD card
I would like to update the SD card image
Enter the following command into your terminal application to update the SD card image to the latest version (April 2018):
sudo apt-get update; sudo apt-get upgrade; sudo reboot
Run the following command for a listing of all AIY packages and their version codes.
dpkg -l aiy*
I want to reflash my SD card
You’ll need to download the SD image and write it to the SD card. Downloading the image can take a few minutes.
Click here to download the SD card image.
After it’s downloaded, write the image to your SD card using a card writing utility (Etcher.io is a popular tool for this).
I want to learn more about using the terminal and Linux commands
I want to learn more about working with Raspberry Pi
Check out the Gettting started with Raspberry Pi guide for an introduction and tour.
Vision Kit help
Assembling the Vision Kit
The flex cable is too large to fit into the Raspberry Pi connector
There are two flex cables in the kit: one is long and one is short. The long cable connects connects the Vision Bonnet to the Raspberry Pi Camera, while the short cable connects the Raspberry Pi to the Vision Bonnet. See
I need to replace the camera flex cable
You'll need the Raspberry Pi Zero camera cable.
Using the Vision Kit
I get a syntax error when running the Joy Detector demo
Your Raspberry Pi board may not be running the AIY software image (this error happens when using Python 2.7 instead of 3.4). You’ll need to update to the latest SD card image and try again.
My computer doesn’t detect the Vision Kit when using a USB cable
Double-check that you’ve connected the USB cable to the left-side USB port on your kit (the one labeled “Data”). Also, be sure that your kit is connected to a power supply via the other USB port — it will need more power than what your laptop can provide on its own.
Note: it’s not recommended that you use the USB connector cable to another computer as the sole source of power for your AIY kit. This may cause a brown-out or other issues. Learn how to connect to your Vision Kit
I get an error when I try to run a demo
First, check that you’ve typed the command correctly. Capitalization matters! If that doesn’t solve the problem, you might be in a different file directory, which means the command tried to find the demo in the current folder but it wasn’t there. Try typing the following command and pressing enter to navigate to the right directory:
Then try to run the demo again. If that still doesn’t work, you may have another demo that’s currently running, which will prevent you from starting a new demo. First check that you’ve stopped the Joy Detector. You’ll need to do this each time you reboot your kit.
If you are running another demo, try these steps to stop it: Open the terminal that has the demo running by clicking with your left mouse button on it, and once your terminal is in focus, press Ctrl-C.
My kit crashes on startup
Make sure you’re using a USB power supply that’s 5V 2.1A or higher. The Vision Bonnet requires additional current from the Raspberry Pi and using a power supply with less than 2.1A can cause instability.
After initially starting, the demos stop working
If the demos crash and none of the other solutions above solve your problem, open a terminal on the Raspberry Pi and type
dmesg | grep 'Internal error'. If this prints any line at all, then your kit might be suffering from a hardware power problem (issue 346). Try running the following command:
echo "over_voltage=4" | sudo tee -a /boot/config.txt
Then reboot the kit.
The camera is blocking my terminal window
If you are connected directly to your Raspberry Pi via mouse, monitor, and keyboard, the camera window might block your terminal. That’s okay, as your terminal is still there in the background. Press Ctrl-C after pointing your camera at a few objects to stop the demo and close the camera window. Then you can scroll up in your terminal window to see what the camera identified. If you want to see the terminal and camera preview at the same time, you can connect your Raspberry Pi to WiFi and then connect to it from another computer via SSH. See steps 48-63 of the Voice Kit guide for more information.
Check the MCU firmware version and status
pi@raspberrypi:~ $ cat /sys/bus/i2c/devices/1-0051/status_message OK-V0.5 0.5 is the newest and OK means its happy :D
Check the MCU Error code
pi@raspberrypi:~ $ cat /sys/bus/i2c/devices/1-0051/error_code 0xdeadbeef
0xdeadbeef means operation is normal (no pins in a state they do not support, i2c bus has no errors the mcu knows about)
Check product name from overlay
pi@raspberrypi:~ $ cat /sys/firmware/devicetree/base/hat/product AIY Vision Bonnet
Check product version
pi@raspberrypi:~ $ cat /sys/firmware/devicetree/base/hat/product_ver 0x0002
If you have version 1.0 of the Vision Kit (check here), this command will output
Check serial number for you board
pi@raspberrypi:~ $ cat /sys/firmware/devicetree/base/hat/uuid d2a4088a-514e-464e-4d20-2020ff170a44
Check who built it
pi@raspberrypi:~ $ cat /sys/firmware/devicetree/base/hat/vendor Google, LLC
Voice Kit help
Assembling the Voice Kit
My kit doesn’t match the assembly guide instructions
There are several versions of the Voice Kit and Vision Kit, each with different assembly instructions. Check which kit version you have by going here:
Booting the Voice Kit
My kit won’t turn on even though it’s plugged in and the green LED is lit
Your kit might be running a file system check, which happens after your kit shuts down abruptly. It takes around 5 minutes to complete, so try plugging in your kit and waiting.
If it still doesn’t boot, your SD card image may be corrupt, so try installing a new image.
My mouse and keyboard are connected, but they don’t seem to work
- Check step 49 of the Voice Kit assembly and make sure your mouse and keyboard are plugged into the connector labeled “Data”
- If you're using a USB hub, make sure it’s powered.
- Make sure you are using a 2.1A USB power supply for your kit.
- Finally, try rebooting the device while the keyboard and mouse are plugged in. To do that, unplug your power supply, wait a few seconds, then plug it back in. It may take a few minutes to boot up.
I want to configure my Voice Kit to activate with a button press
You can do this with the Voice Kit version 1.0 (and Raspberry Pi 3). Learn how
I want my Voice Kit to active using hotword detection (“OK Google…”)
You can do this with the Voice Kit version 1.0 (and Raspberry Pi 3). Learn how
The audio checkpoint script doesn’t work (“Failed to find the VoiceHAT soundcard…”)
There could be one or more issues that is causing the audio check to not find the sound card. Try the steps below:
- Check if the driver loaded by entering the following in your terminal window:
lsmod | grep googlevoicehat
If it’s not, trying using the terminal to manually load the driver:
sudo dtoverlay googlevoicehat-soundcard
- Check the list of detected audio devices:
- Verify proper connections of the hardware (soldered pins, bent 40 pin headers, etc.)
If none of the steps above solve the issue, then open a terminal window and enter the command “dmesg”. Email us the output at firstname.lastname@example.org.
Using the Voice Kit
I want to use my Voice Kit with other Google devices (Home, Chromecast, etc)
At this time the AIY Voice Kit is not compatible with other Google devices.
When I try to start my demo the terminal responds “src/assistant_library_demo.py bash:src/assistant_library_demo.py: No such file or directory”
The demo files have moved to
src/examples/voice/. Try running it from that path.
Extending the Voice Kit
I want to use the Assistant Library/gRPC Service/Cloud Speech API in different languages
- For the Assistant Library (
assistant_library_demo.py), you need to use the Google Assistant app on Android or iOS. After you run the demo, your Voice Kit appears in the list of devices (in the app settings) where you can set your language preference.
- For the Assistant gRPC service, you can also set the language
preference in the Android or iOS app (see the previous item), or you can specify the language
programatically—for an example, see the
- For the Cloud Speech API, you can set the language programatically—for an example, see the
For details using the Google Assistant SDK, see the SDK documentation.
I want to make my own hotwords
Custom hotwords is not currently available with the Google Assistant SDK. However, you can try other voice recognition services like the Google Cloud Speech API.