Self-test your FFS implementation


Self-test your Frustration-Free Setup (FFS) implementation on your device before submitting your device for certification by Amazon. The self-testing options vary slightly for each of the three FFS registration options:

  • Zero-Touch Setup (ZTS) – The user plugs in the AVS-enabled device into an outlet, and an already-registered Echo device recognizes the device automatically and finishes the setup process.
  • Auto discovery – The Alexa app on a mobile device uses Bluetooth to detect the new AVS-enabled device and the Alexa app completes Wi-Fi setup and registration for the device.
  • User-guided setup (UGS) – The Alexa app on a mobile device guides a user through a series of screens and prompts to perform the setup for the AVS-enabled device.

Download the FFS self-test checklists

To download the specific FFS self-test requirements, download the self-test checklist from the Amazon developer portal Resources tab: AVS Functional Self-test Checklist

Each of the following sections describes the process and options for self-testing FFS on your device before submitting to certification.

Best practices for testing

After provisioning your device, you can download a CSV template file to submit test devices for Zero-Touch Setup (ZTS) testing:

Follow these best practices for testing your devices:

  • Soft DAK – Requirements vary depending on whether you're using DEV or PROD Soft DAK:
    • DEV Soft DAK – Include the 2D barcode string for the association.
    • PROD Soft DAK – Include a control log, and submit a 1D serial number string for the association.
  • Test account – Because user guided setup (UGS) invalidates device associations, maintain separate test accounts for UGS and ZTS testing. For more details, see Self-test your FFS implementation

Onboard your device for testing with the Alexa app

To test UGS or auto discovery with the Alexa app, you must onboard your device with Amazon to be able to access your device through the app.

To onboard your device for testing with the Alexa app

  1. Sign-in to the AVS developer console.
  2. From the Products box, click Manage Your Products.
  3. Select your product or create a new one.
  4. Click the Device Setup tab.
  5. Submit your device to be onboarded to the Alexa app:
    1. On the Frustration-Free Setup page, go to the Alexa Mobile App Out-Of-Box Experience section, and click on the arrow on the right.
    2. Fill out the form with the appropriate information for your device, and click Submit.

      To view your device onboarding status, return to the Frustration-Free Setup page, and check the Alexa Mobile App Out-Of-Box Experience section for updates. When Amazon completes the onboarding process for your device, the status is set to Onboarded for Testing.

    3. After your device completes onboarding, contact your Amazon representative with your Amazon Customer ID to obtain access through the Alexa app.

      To obtain your Customer ID, also called a "CID", sign-in to the AVS developer console and then click the following link:

      https://developer.amazon.com/mycid.html

Test user-guided setup (UGS)

Use the Alexa app to self-test UGS on your FFS device.

To test UGS for your FFS device with the Alexa app

  1. Follow the instructions in Onboard your device for testing with the Alexa app to onboard your device.
  2. After receiving onboarding confirmation and sending your CID to Amazon, log in to the Alexa app, and navigate to Devices > + Add a Device to start the setup process.
  3. Follow the onscreen prompts to complete the setup process.

Test auto discovery

To test auto discovery for your FFS device with the Alexa app

  1. Follow the instructions in Onboard your device for testing with the Alexa app to onboard your device.
  2. After receiving onboarding confirmation and sending your CID to Amazon, perform a factory reset of your device, and power the device on.
  3. Open the Alexa app, and follow the onscreen prompts to complete the setup process.

Test Zero-Touch Setup (ZTS)

Use one of the following Amazon Echo devices as an Alexa provisioner to test ZTS on your device:

For specific testing instructions, see the AVS Functional Self-test Checklist for FFS.


Was this page helpful?

Last updated: Nov 27, 2023