施工部署

网关无网施工是在没有网络的环境下部署智能家居设备，适合前装市场批量交付的场景。本文介绍使用 TuyaOS 网关开发包如何开发支持无网施工的网关产品。

使用场景

您可以通过施工 SaaS 平台配置好施工模板，选择户型施工时使用的设备、场景和自动化，下发施工任务给施工人员。

施工人员使用施工 App 添加设备、验证场景和自动化，完成部署后，待终端用户入住把权限交付转交给用户。

用户只需要激活网关设备，立即能体验预先配置好的智能场景，减少繁琐的添加子设备和配置场景操作，增强用户体验。

工作原理

无网施工的工作原理是：

1. 施工 App 从施工 SaaS 平台获取房间信息、设备物模型、智能场景配置，网关设备与施工 App 建立局域网安全连接来传输数据。
2. 施工完成后，施工人员需要在施工 App 上传部署，施工 SaaS 平台会把设备的数据同步到涂鸦开发者平台。
3. 网关回到普通模式会处于未激活状态，等待终端用户激活网关设备。
4. 网关设备激活后发起无网施工恢复请求。
5. 涂鸦开发者平台收到请求把无网施工的数据迁移到该网关。
6. App 上能够看到施工添加的子设备和智能场景，并且能正常使用。

开发指导

通常网关设备需要支持切换 施工模式 和 普通模式，您可以使用命令行参数来控制程序运行在普通模式还是施工模式。建议网关重启默认工作在普通模式，通过按键切换到施工模式。

在普通模式基础上加入无网施工功能，开发步骤如下：

1. 判断是否进入无网施工模式，若进入无网施工模式则调用 tuya_set_engineer_mode 接口。
2. 通过 tuya_get_engineer_mode 接口判断当前工作模式是否为无网施工模式。
   • 如果工作在无网施工模式，则 tuya_iot_init 接口的参数为无网施工模式的存储路径（固定为 普通模式存储路径 + /engineer/）。
   • 如果工作在普通模式，则 tuya_iot_init 接口的参数为普通模式的存储路径。
3. 无论工作在无网施工模式还是普通模式，都需要调用 tuya_engineer_sdk_init 接口初始化施工 SDK。值得注意的是，product_key 参数使用普通模式的 PID。该接口有以下两种使用场景：
   • 使用涂鸦网关 Zigbee 模组，要求在该接口之前调用 tuya_engineer_set_tuya_zigbee_enable 接口，使能涂鸦 Zigbee 施工业务逻辑。
   • 不使用涂鸦网关 Zigbee 模组，您需要实现 TY_ENGR_GW_ZIG_CBS_S 相关的回调，作为该接口的参数。
4. 初始化 SDK：
   • 如果工作在无网施工模式，则使用 tuya_engineer_gw_init 接口初始化施工网关业务，product_key 参数使用无网施工模式的 PID。
   • 如果工作在普通模式，则使用 tuya_iot_wr_wf_sdk_init 接口初始化普通网关业务，product_key 参数使用普通模式的 PID。
5. 指定局域网通讯的网络接口，需要适配 tkl_wifi_get_ip 接口，返回用于局域网通信的网络接口 IP 地址。

接口描述

进入施工模式

/**
 * @brief 设置网关工作模式为施工模式接口。
 * @note 调用该接口让网关进入施工模式，该接口要在程序启动最先调用。
 */
VOID tuya_set_engineer_mode(VOID);

判断施工模式

/**
 * @brief 判断网关是否在施工模式接口。
 * @note 调用该接口区分
 *
 * @return TRUE：施工模式；FALSE：普通模式。
 */
BOOL_T tuya_get_engineer_mode(VOID);

施工 SDK 初始化

/**
 * @brief 施工 SDK 初始化接口。
 * @note 无论网关工作在普通模式，还是施工模式，都需要调用该接口。施工模式下处理施工逻辑，普通模式下处理同步施工数据逻辑。
 *
 * @param[in] product_key   普通模式的产品 ID。
 * @param[in] eng_infra_cbs 施工应用回调。
 * @param[in] eng_zig_cbs   施工 Zigbee 回调。
 */
OPERATE_RET tuya_engineer_sdk_init(IN CONST CHAR_T *product_key,
                                   IN TY_ENGR_GW_INFRA_CBS_S *eng_infra_cbs,
                                   IN TY_ENGR_GW_ZIG_CBS_S* eng_zig_cbs);

施工网关初始化

/**
 * @brief 施工网关业务初始化接口。
 * @note 施工模式使用该接口初始化网关业务，普通模式则使用 `tuya_iot_sdk_init` / `tuya_iot_wf_sdk_init` / `tuya_iot_wr_wf_sdk_init` 接口初始化网关业务。
 *
 * @param[in] net_mode    指定网络模式。
 * @param[in] product_key 施工产品 ID。
 * @param[in] sw_ver      固件版本号。
 * @param[in] attr        模组信息数组。
 * @param[in] attr_num    模组信息数组的长度。
 */
OPERATE_RET tuya_engineer_gw_init(IN CONST IOT_GW_NET_TYPE_T net_mode,
                                  IN CONST CHAR_T *product_key,
                                  IN CONST CHAR_T *sw_ver,
                                  IN CONST GW_ATTACH_ATTR_T *attr,
                                  IN CONST UINT_T attr_num);

使用涂鸦 Zigbee

/**
 * @brief 使能 Zigbee 施工服务接口。
 * @note 网关使用涂鸦 Zigbee 模组时，调用该接口使能 Zigbee 施工服务，Zigbee 施工业务逻辑由 SDK 处理。要求在 `tuya_engineer_sdk_init` 接口之前调用。
 */
OPERATE_RET tuya_engineer_set_tuya_zigbee_enable(VOID);

示例代码

详见 apps/tuyaos_demo_engr 示例。