Frustration-Free Setup (FFS)

Last Updated on : 2023-12-19 08:36:57download

Frustration-Free Setup (FFS) simplifies the process of pairing Wi-Fi, Bluetooth, or Zigbee devices and setting up smart speakers. FFS enables a Wi-Fi device to automatically complete the pairing process, connect to Amazon Alexa, and link with the user’s Amazon Alexa account.

Pairing process

The user’s Amazon Alexa account must have enabled Tuya Smart Skill and linked with the account of the Tuya-based mobile app.
The device must have been linked with the user’s Amazon Alexa account.

  • After the device is powered on, it generates a random SSID and sends probe frames.

  • The Amazon Echo speaker creates a hidden access point (AP) using the SSID in the received probe frame.

  • The device requests the credentials for the user’s Wi-Fi network from the WSS cloud.

  • The device connects to the user’s Wi-Fi network and then completes the activation process.

    DeviceEchoWSS CloudCloudEnter pairing mode after power on.Scan for the hidden AP.Create a hidden AP.Connect to the hidden AP.The AP is connected.Request the user's Wi-Fi network credentials.Return the Wi-Fi network credentials.Connect to the user's Wi-Fi network.Request activation.DeviceEchoWSS CloudCloud

Development guide

Runtime environment

Open tuya_iot_config.h and check if the following macro is defined.

#define ENABLE_WIFI_FFS 1

How to

To enable FFS, set the pairing startup mode to universal pairing.

FAQs

Why does the device fail to connect to Amazon Echo’s AP?

The device certificate is invalid or is not linked with the user’s Amazon Alexa account.

What does the Amazon message canProceed: false mean?

The user’s Amazon Alexa account has no Wi-Fi network credentials stored or has no Amazon Echo speaker associated.