Test Pairing and Discovery

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


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

  1. Put the gadget into pairing mode.
  2. 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:

  1. 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.
  2. Your gadget should respond with a Discover.Response event.
  3. Say "Alexa" to the Echo device. Your gadget should receive a Alexa.Gadget.StateListener.StateUpdate directive notifying it that the wake word was detected.

Was this page helpful?

Last updated: Feb 14, 2022