HomeKit 配网问题

本文档主要针对苹果智能家居平台 Homekit 配网的一些常见问题，梳理出对应的问题排查指引，帮助您解决一些日常问题。

设备上的二维码标签破损或者脱落丢失了，如何进行配网？

用iOS手机先使用涂鸦智能App进行配网，配网完成后进入设备详情界面，可以看到8位的Homekit设置代码。然后就可以使用Home手动输入8位的数字代码，配网即可。

使用Home配网出现”未认证的配件“？

出现以上提示可能存在如下原因：

• 生产写入的 MFI Token 为无效 Token。
• 使用已进行过 Homekit 配对的工单，工单重复授权(生产系统写入的为初始token，设备配对后则失效)。
• 工单未生效，由于atoken（Apple Token）被授权工具使用后，会在每天的固定时间发送到苹果服务器激活，因此涂鸦生产测试平台授权好的模块，只有在工单申请后第二天才能真正使用，立即使用会无法在Homekit App成功配网。

涂鸦智能App与Home App有什么关系？

• Tuya和Hap的账号体系互不干涉，使用Android Tuya App配网后的设备可以再被同一局域网下的iOS手机进行hap绑定。
• 在Tuya app或Home App中移除设备，只会移除各自的绑定状态。
• 手动重置（一般为插座按键长按或连续开灯3次）会移除两端的绑定状态并移除设备的配网状态。

使用涂鸦智能App与Home App进行配网可能出现的交互情况？

• iOS手机配对Hap，手机移除Hap，设备仍处于连接局域网状态，可以直接进行Hap绑定，不经过配网过程。
• iOS手机配对Hap，再绑定Tuya，可以共同控制，移除Tuya，重启，仍然保留原来的Hap配对状态，可以重新绑定Tuya。
• iOS手机配对Hap，再绑定Tuya，可以共同控制，再移除Hap，不重启，仍然保留原来的Tuya配对状态，可以重新绑定Hap。
• Android手机配对Tuya，Tuya App移除，设备直接进入配网状态。
• Android手机配对Tuya，再用另一台iOS手机绑定，Tuya App移除，iOS手机仍能正常控制设备。

Homekit只能进行AP配网？

Homekit的配网方式和涂鸦的AP配网类似，所以AP配网被Homekit占用了，涂鸦配网时不能使用AP配网，目前只能进行蓝牙配网。
在tuya_device.c文件夹中device_init接口中对SOC初始化接口设置的配网模式为：WF_START_AP_ONLY（AP配网）。

/***********************************************************
* Function: tuya_iot_wf_soc_init->The devcie consists of wifi soc
* Input: cfg
*     cbs->tuya wifi sdk user callbacks,note cbs->dev_ug_cb is useless
*     product_key->product key/proudct id,get from tuya open platform
*     wf_sw_ver->wifi module software version format:xx.xx.xx (0<=x<=9)
* Output: none
* Return: OPERATE_RET
***********************************************************/
OPERATE_RET tuya_iot_wf_soc_dev_init_param(IN CONST GW_WF_CFG_MTHD_SEL cfg,\
										  IN CONST GW_WF_START_MODE start_mode,\
​                   								  IN CONST TY_IOT_CBS_S *cbs,\
										  IN CONST CHAR_T *firmware_key,\
​                   								  IN CONST CHAR_T *product_key,\
										  IN CONST CHAR_T *wf_sw_ver);

同一台设备，部分手机配不上或找不到设备？

Homekit功能受iOS版本影响，建议使用iOS12及以上版本。还有的手机，其性能不是太好，连接热点时比较慢或容易失败，也会导致配不上设备。

扫配网码之后，Homekit配网在点仍然添加之前失败？

• 情景描述：设备配网时，手机先连接Wi-Fi，然后启动配网，手机会切换连接到设备模块热点进行一些信息交互，之后会切回开始的Wi-Fi热点连接，然后往下进行，弹出一个窗口，点击仍然添加继续配网流程。
• 实例分析：如果网络环境复杂，在这个两次切换热点没有连接对，就会导致配网失败。比如扫其中一个配网码之后，手机连到了另一台设备，或者手机连接模块热点切回Wi-Fi热点连接时，没有切回或连到了另一台Wi-Fi。
• 建议：配网时，把手机所有Wi-Fi配置都关掉或者关掉自动加入，只保留配网用的那个Wi-Fi。

Homekit配网在点仍然添加之后失败？

根据日志分析，模块收到手机发送的要连接的热点名称和密码后，没有收到手机发送的连接绑定的网络包，导致配网失败。此现象为偶现，是手机没有发包或者发错了设备。建议在网络条件比较好的地方测试。