增强型扫码配网

增强型扫码配网面向 Wi-Fi 类设备：App 扫描设备二维码获取短链，向云端换取 Pin、UUID 等配网信息后，连接设备热点完成本地配网交互，设备再通过 Token 轮询云端完成激活绑定。

名词解释

• 二维码：用某种特定的几何图形按一定规律在平面（二维方向上）分布的、黑白相间的、记录数据符号信息的图形。

• 短链接：通过程序计算等方式，将长的 URL 网址转换为简短的网址字符串。短链接具有长度短、易记录、易转发等优点，同时又可以隐藏真实地址。

扫码绑定

扫码绑定的大致流程如下：

1. 设备上电，进入热点配网模式，等待 App 连接。
2. App 扫描设备二维码，获取短链信息。
3. App 请求云端接口，云端返回设备信息。
4. App 连接设备，携带 Pin 码、UUID 向设备发起配网。
5. 设备与 App 建立本地交互，完成设备查询与配网信息下发。
6. 设备通过 Token 轮询云端，完成激活绑定；App 收到配网成功结果。

设备二维码来源

• 设备生产时可获得二维码信息，此时可打印二维码标签贴上，或者丝印在产品表面。详细请参考 标签打印。
• 带屏类设备可在设备初始化时，通过注册 active_shorturl 回调函数获取短链信息，此时生成二维码图片显示在设备屏幕上。

Pin 码获取

Pin 码目前 只能通过 涂鸦生产凭证授权后获取，详细请参考 生产授权。

流程图

开发指导

使用方法

如需启用此功能，请先前往 涂鸦开发者平台 创建产品，进入产品开发界面。在 功能定义 > 高级功能 处为产品开启 扫码配网 的高级能力。开启后，需要用该 PID 购买授权码对设备进行授权。

例程说明

#include "tuya_iot_com_api.h"
#include "tuya_iot_config.h"
#include "tuya_iot_wifi_api.h"
#include "tuya_wifi_netcfg.h"
#define UUID                        "f2*************b0"
#define AUTHKEY                     "6P**************************MX"
#define PID                         "U0**************Zy"  
#define PIN                         "1******2"  

int sample_main(int argc, char *argv[])
{
    int rt = OPRT_OK;
   /**必要的 SDK 初始化接口**/
    //扫码配网功能除了传统的 UUID 和 AUTHKEY 之外，新增了 Pin 码的输入。
    WF_GW_PROD_INFO_S prod_info = {UUID, AUTHKEY, NULL,NULL,PIN};
    TUYA_CALL_ERR_RETURN(tuya_iot_set_wf_gw_prod_info(&prod_info));
    /**必要的 SDK 回调接口**/
    while (1)
    {
        sleep(10);        
    }

    return 0;
}