Amazon Voice Service product registration.
In order to work with avs-device-sdk you need to compile one variant of amazon-voice-servce firmware. While doing this you need to register on main Amazon Developer portal in order to add device in their system. After firmware is flashed on board you’ll need to initiate SampleAPP or your application with proper configuration and proceed with standard steps of Authorization.
By default this firmware provides SampleAPP and all necessary libraries from avs-device-sdk. Configuration in firmware is stored in /etc/alexa/ directory.
All of this is described in next chapters.
Register device and profile.
This is part of official documentation from Amazon Developer site – Prototyping – Register a product.
- Create an Amazon developer account
Create a free developer account at developer.amazon.com. If you already have an account, you can skip this step.
- Create a product.
After you’ve created an Amazon developer account, you create a product and security profile. This authenticates your software client so it can connect to AVS.
To create a product:
- Log in to the AVS dashboard.
ADD NEW PRODUCT.
Fill in product information
You now must fill in your product information. This information identifies your device with AVS.
To fill in your product information:
- Choose a
Product Name. For example,
AVS Tutorials Project.
- Choose a
Product ID. For example,
Don’t use any spaces in your product name.
- In the
Please Select Your Product Typedropdown, select
Device with Alexa built-in.
Will your device use a companion app?, choose
- In the
Product Categorydropdown, select
Other (please specify).
- Write a meaningful description in the
Brief product description box. For example,
How will users interact with your product?, select
- Skip the
Upload an image step. This isn’t required for prototyping.
Do you intend to distribute this product commercially?, select
Will your device be used for Alexa for Business?, select
Is this device associated with one or more AWS IoT Core Accounts?, select
Is this a children’s product or is it otherwise directed to children younger than 13 years old?, Select
Set up your AVS security profile.
A login with Amazon (LWA) security profile associates your security credentials with your product.
To set up your security profile:
CREATE NEW PROFILE.
Security Profile Name, enter a relevant name. For example,
AVS Tutorials Project.
Security Profile Description, enter a relevant description. For example,
Security Profile IDgenerates.
- Select the
Other devices and platformstab.
Client ID name, enter a relevant name. For example,
Download. This downloads your config.json file that contains your AVS credentials. Save the file to your home directory directory. This file will be needed in next chapter.
- Read the Amazon terms and conditions. If you agree, check the
I agree to the AVS agreement and the AVS Program Requirementsbox.
FINISH. Congratulations! You now have access to AVS.
- A pop-up appears. Click
OK. You can now view your device on your AVS dashboard.
The following screenshots highlight the important steps described in the previous section.
Configuration of Amazon Voice Service in Firmware.
When firmware is compiled and flashed on board you’ll need
productID from previously downloaded from AVS dashboard
config.json file. You need to copy them into
/etc/alexa/AlexaClientSDKConfig.json file in section
deviceInfo. Also you’ll need to fill
description with your information in that file.
Be aware, that ‘clientID
andproductID` is generated by AVS and used for authorization.
For example, section of
AlexaClientSDKConfig.json will be:
First run and test.
On first run
SampleApp will ask you to enter PIN on AVS website. To run
SampleApp in firmware type in console:
On first run you’ll see message like this:
You’ll need to login to AVS and input XXXX code. After this
SampleApp will automatically switch to Authorized state and you can test AVS.
SampleApp does not support keyword/hotword activation, so you’ll need to activate service manually. To do this just type
t and Enter, after that Alexa will switch to Listening state and you can say “Tell me a joke” or “Pick a number between zero and ten” in microphone. In first case Alexa will tell you joke, in second it’ll say random number between 0 and 10. To exit application use
Coming soon at CrowdSupply!