ZLK38AVS User Guide
Microsemi AcuEdge™ Development Kit for Amazon
AVS
Page 1: ...ZLK38AVS User Guide Microsemi AcuEdge Development Kit for Amazon AVS ...
Page 2: ...embly 5 4 2 Raspberry Pi Connections 6 5 ZLK38AVS Software Installation 8 5 1 Creating Raspbian Image 8 5 2 Raspberry Pi Software Installation 8 5 2 1 Downloading ZLK38AVS Software 9 5 2 2 Installing ZLK38AVS Software 9 6 Amazon Developer Account Creation 11 7 Demonstrating the ZLK380AVS software 15 7 1 Starting AVS Software Demo 15 7 2 Installation Troubleshooting 16 7 2 1 Credential Error 16 7 2...
Page 3: ... Raspbian download page 8 Figure 10 Etcher Disk Imager example 8 Figure 11 Downloading ZLK38AVS software 9 Figure 12 Sensory License Agreement 9 Figure 13 Amazon Developer Account 9 Figure 14 Chromium on Raspberry Pi 10 Figure 15 Sample App Autoboot Option 10 Figure 16 Completed installation 10 Figure 17 Alexa Voice Service website 11 Figure 18 Amazon sign in 11 Figure 19 Apps distribution agreeme...
Page 4: ...ion page 8 Developer account creation was updated For more information see Amazon Developer Account Creation page 11 A new Alexa app was added For more information see Demonstrating the ZLK380AVS software page 15 Installation troubleshooting details were added For more information see Installation Troubleshooting page 16 Steps to reconfigure the software were added For more information see Reconfi...
Page 5: ...ou through all the steps of building an Alexa powered prototype using Microsemi s ZLK38AVS development kit and a Raspberry Pi It takes you from setting up the ZLK38AVS kit integrating it with an Alexa wake word engine and connecting to the Alexa Voice Services AVS cloud Once completed you will have an Alexa enabled application that will function like an Amazon Echo 2 1 Other References The followi...
Page 6: ...t kit is provided through GitHub 3 1 Hardware Provided The following hardware is provided in the ZLK38AVS Development Kit 1 ZLE38AVS evaluation board 2 Pillar speaker and Raspberry Pi plastic stand 3 Plastic standoffs and screws Figure 1 ZLK38AVS Development Kit Contents Figure 2 Raspberry Pi and ZLE38AVS Evaluation Board 3 2 Hardware Not Provided The following hardware is needed to run the ZLK38A...
Page 7: ...tion Note The monitor keyboard and mouse connections are optional if using VNC or similar to connect to the Raspberry Pi 3 3 Software The following software for the ZLK38AVS Development Kit is provided through GitHub 1 A make file which installs all the required software 2 The latest Timberwolf device series Voice Processing Software Development Kit SDK which is a collection of software tools code...
Page 8: ...side of the Raspberry Pi mounting ring and add the 2nd set of standoffs Figure 3 Mounted Raspberry Pi with standoffs attached 2 Add the standoffs to the ZLE38AVS evaluation board Figure 4 ZLE38AVS board with standoffs attached 3 Plug in the ZLE38AVS evaluation board and add the remaining screws Figure 5 ZLE38AVS board attached to mounted Raspberry Pi 4 Place the speaker facing downwards into the l...
Page 9: ...o USB ports of the Raspberry Pi 3 Connect the Raspberry Pi to your network with an Ethernet cable or Wi Fi 4 Flash image onto the SD card using the Wind32Diskimager application see Creating Raspbian Image page 8 5 Insert the SD card into the SD card slot of the Raspberry Pi 6 Connect a compatible 5V power supply to the Raspberry Pi s Micro USB port in order to power up the Raspberry Pi Note The mo...
Page 10: ...Hardware Assembly ZLK38AVS User Guide Revision 3 0 7 Figure 8 Raspberry Pi connections ...
Page 11: ...an Image Raspbian Stretch with Pixel is the operating system that will be installed on the SD card On a separate PC follow the steps below 1 Format the SD card to FAT32 to ensure you are starting with an empty card 2 Download and install Etcher from https etcher io 3 Download Raspbian Stretch with Desktop from https www raspberrypi org downloads raspbian Figure 9 Raspbian download page 4 Write the...
Page 12: ...ommand Note During make all the makefile will automatically download the all the necessary packages and dependencies about 250 MB expect the total installation to take 20 minutes to 30 minutes with an average connection While this step is running it may be a good time to create your Amazon account You will need information from the creation of your Amazon account later in the software installation...
Page 13: ...ple app automatically when the Raspberry Pi boots up no need to have a screen connected or VNC In headless mode the speaker plays a short alarm sound to notify the user when Alexa is ready after boot up Figure 15 Sample App Autoboot Option 7 A successfully completed installation should show the following message Figure 16 Completed installation 8 Upon the completion of the ZLK38AVS kit installatio...
Page 14: ...uctions below describe the steps required to create an account to use with the ZLK38AVS demonstration kit 1 Go to https developer amazon com alexa voice service Figure 17 Alexa Voice Service website 2 Click Sign in on the top right of the screen Figure 18 Amazon sign in 3 Either sign in with your account or create a new account if a new customer Fill out the registration forms as requested by Amaz...
Page 15: ...on ZLK38AVS User Guide Revision 3 0 12 4 When prompted for information on the Apps Distribution Agreement select No for both options Figure 19 Apps distribution agreement 5 Select Alexa on the top navigation bar Figure 20 Get Started ...
Page 16: ...it b Product ID This will be the Device ID during installation no spaces c Is your product an app or a device Device d Will your device use a companion app No e Product category wireless speakers f Brief product description Enter description g How will end users interact with your product Hands free h Do you intend to distribute this product commercially No i Is this a children s product or is it ...
Page 17: ...fers to the device created b Security Profile Description Enter description c Next 8 Update the URLs don t forget to click ADD after each entry Figure 23 Amazon Developer Account URLs a Allowed origins http localhost 3000 b Allowed return URLs http localhost 3000 authresponse c I agree d Finish You have now created the Amazon Developer account and a device ...
Page 18: ...he 180 configuration To change the configuration see Changing ZL38063 Microphone Mode page 19 7 1 Starting AVS Software Demo 1 cd into the location where the GitHub package was downloaded eg cd ZLK38AVS 2 Issue the following make command to start the AVS software make start_alexa Figure 24 Alexa Start Screen 3 Turn on the speaker using power button on the speaker bezel and set the volume to maximu...
Page 19: ... in ZLK38AVS Software Installation page 8 and displays the following error message Figure 25 Amazon URL Error a Check the URLs For more information see step 8 in Amazon Developer Account Creation page 11 b Enter the proper Allowed origins and Allowed return URLs c Restart the Raspberry Pi d Start the demo again 7 2 2 Token Error If the web page displays the following error message after you enter ...
Page 20: ...was done during the make all during the ZLK38AVS Software Installation see ZLK38AVS Software Installation page 8 To clean the ZLK38AVS installation without removing the Amazon Alexa software run make clean 8 1 Reconfiguring the ZLK38AVS Software To re make the ZLK38AVS without re compiling re installing Amazon Alexa run make host To use different Amazon identifiers or account make avs_config To en...
Page 21: ...ntly determine suitability of any products and to test and verify the same The information provided by Microsemi hereunder is provided as is where is and with all faults and the entire risk associated with such information is entirely with the Buyer Microsemi does not grant explicitly or implicitly to any party any patent rights licenses or any other IP rights whether with regard to such informati...
