Test Pairing and Discovery

Note: Sign in to the developer console to build or publish your skill.

Note: On December 31, 2021, we paused support for third-party device makers working with Alexa Gadgets, while we work to create an even better developer and customer experience. Please stay tuned to the Amazon developer portal for updates. In the interim, please visit the landing pages for Alexa Voice Service, Alexa Connect Kit, and Alexa Skills Kit to discover ways you can provide new customer experiences with voice.

This topic contains tests that indicate whether your gadget can successfully communicate with an Echo device.

Preparation
Test pairing
Test a directive

Preparation

Before performing these tests, ensure that you have done the following:

Register your gadget – Register your gadget in the developer portal, as described in Register a Gadget. You will receive a secret key at the end.
Get an Amazon Echo device – Get an Echo device and register it to the account that you used to register the gadget in the developer portal. For a list of Echo devices that support gadgets, see Echo devices that support gadgets.
Configure communication channel settings – Set the Bluetooth pairing parameters of your gadget to the settings described in Gadget Settings for Classic Bluetooth.
Set up the gadget to receive directives – Have code in place to accept the Discover directive.
Set up the gadget to send events – Have code in place to assemble and send the Discover.Response event in response to the Discover directive.

Test pairing

Put the gadget into pairing mode.
Put the Echo device into pairing mode. If your Echo device has a screen, follow the on-screen instructions for pairing. If your device does not have a screen, do the following:
1. Go to the Amazon Alexa app (alexa.amazon.com) and sign in with your Amazon developer account.
2. On the left, select Settings.
3. From the Device list, select your Echo device.
4. Under Connected Devices, select Pair Alexa Gadget, and follow the instructions. If you can successfully pair your gadget, the gadget's Bluetooth settings are correct.

Test a directive

Continuing from the test above:

Once paired, the Echo device will send a Discover directive to your gadget with a request to respond with a Discover.Response event. If your gadget receives the Discover directive, your gadget and the Echo device have successfully established a communication channel.
Your gadget should respond with a Discover.Response event.
Say "Alexa" to the Echo device. Your gadget should receive a Alexa.Gadget.StateListener.StateUpdate directive notifying it that the wake word was detected.

Last updated: Feb 14, 2022