自定义配网

配网是 Wi-Fi 产品特有的一个能力，主要目的是通过具有配网能力的设备，对未配网的 Wi-Fi 设备进行网络连接配置。本文介绍如何通过 TuyaOS 开发框架打造自定义配网流程。

配网流程

• 标准流程：

  在配网过程中，具有配网能力的设备，通过交互，把指定的 Wi-Fi 路由器的 SSID、密码、以及在 涂鸦 IoT 开发平台 上申请创建出来的配网 Token 信息，发送给未配网设备。未配网设备获取到这些信息后，连接 Wi-Fi 路由器，并通过涂鸦 IoT 开发平台提供的 IoT-DNS 服务获取对应区域的服务器接入地址，再通过 Atop 服务进行激活，最终连接到涂鸦 IoT 开发平台，开始进行业务交互。

• 自定义流程：

  TuyaOS 支持您基于开发框架开发自定义配网方案。待配网设备在自定义的数据通路中获取到路由器 SSID、密码和配网 Token 信息后，您可调用接口完成后续联网激活绑定流程，即设备连接路由器并连接涂鸦 IoT 开发平台，进行激活绑定。如下图所示：

开发指导

关联头文件

• tuya_iot_wifi_api.h

使用方法

在设备处于待配网状态时，获取到路由器 SSID、密码、配网 Token 等相关配网参数后，您可调用接口将参数设置到框架中。

API 说明

设置用户自定义配网参数

此接口用于设置用户自定义的配网参数的路由器 SSID、密码、配网 Token。

/**
 * @brief tuya_iot_gw_wf_user_cfg
 *
 * @param[in] ssid: user config router ap ssid
 * @param[in] passwd: user config router ap passwd
 * @param[in] token: the token of tuya cloud
 *
 * @return OPRT_OK on success. Others on error, please refer to tuya_error_code.h
 *
 * @note device will scan and connect to the router ap, and try to active on tuya cloud use the token
 */
OPERATE_RET tuya_iot_gw_wf_user_cfg(IN CONST CHAR_T *ssid, IN CONST CHAR_T *passwd, IN CONST CHAR_T *token);