本文主要介绍网关及网关子设备如何通过生态设备接入(TuyaLink)方式进行设备接入。
术语
网关设备:指可以挂载子设备的普通设备。网关具有子设备管理模块,可以维持子设备的拓扑关系,将与子设备的拓扑关系同步到云端。
网关子设备:指自身不直接连接物联网平台,而是通过网关设备接入物联网平台的设备。
主要流程
操作说明
步骤 1. 创建网关产品
登录 涂鸦 IoT 开发平台,创建产品,选择网关品类,智能化方式选择 生态设备接入。
设备类型字段,选择 网关设备。若未正确选择,无法具备子设备管理功能。具体信息,可参考 创建产品。
根据网关需求进行相关功能定义,具体操作见 功能定义。
步骤 2. 创建子设备产品
登录 涂鸦 IoT 开发平台,创建产品,选择网关品类,智能化方式选择 生态设备接入。设备类型字段,选择 网关子设备。
根据子设备需求进行相关功能定义,具体操作见 功能定义。
步骤 3. 激活网关设备
开发者按需求选择采用 Tuya MQTT 标准协议 或 Tuya IoT Core SDK 进行网关应用集成。激活前,需购买授权码或免费领取授权码,并分配至网关产品。通过设备注册,获得设备凭证(ProductID、DeviceID、DeviceSecret),并烧录到设备中,联网即可完成上线。
具体操作,可参考 设备管理。
步骤 4. 网关激活子设备(动态注册/手动注册)
开发者选择已完成开发的网关设备进行子设备接入。激活子设备前,需购买授权码或免费领取授权码,并分配至子设备产品。具体操作,可参考 授权码管理。
网关管理子设备提供两个方式,网关代理子设备动态注册和网关子设备手动注册。
方式 1:网关代理子设备动态注册
子设备无须烧录,不需要在平台进行设备手动注册,由网关代理激活绑定,完成拓扑管理和设备绑定。
网关激活子设备时,通过调用 网关动态注册绑定子设备 Topic 传递相关参数完成激活注册。注册成功会消耗一个授权码,同时会自动建立网关设备与子设备的拓扑关系。若注册前网关处于已绑定状态,则子设备会默认绑定到网关绑定资产或家庭。具体见 步骤 5 场景应用。
参数 参数说明
clientid (必填)注册 ID,需保证产品下唯一,用于平台设备拓扑管理,可在设备详情 > 注册 ID 查看。
方式 2:网关子设备手动注册
在子设备产品开发流程的 设备管理 步骤,进行设备注册,获取子设备凭证(ProductID、DeviceID、DeviceSecret),手动注册会对应消耗一个授权码,由网关侧导入(子设备的 deviceid 信息)。当子设备连接网关后,由网关通过调用子设备拓扑添加 Topic,实现网关绑定子设备的操作。添加拓扑时需要考虑,若网关已绑定状态,子设备也默认绑定到网关所在的对象下。
完成子设备注册和拓扑关系建设后,可在网关设备列表下查看子设备清单。
网关若需要废弃已注册的子设备,则需要网关重置子设备或在设备管理中删除对应子设备数据。删除前,请解除子设备与网关的绑定关系。删除成功后,子设备授权码会重新恢复。
步骤 5. 场景应用
前提条件:网关设备激活完成后,可在 设备管理列表 > 绑定二维码 中获取 Bind code 和二维码。
完成网关和子设备开发接入后,可根据实际情况进行相关项目应用,一共分两种场景。
场景 1:设备用于云开发项目
开发者可将网关设备绑定到云开发项目中使用,用于进行 SaaS 应用开发和系统集成。
绑定成功后,网关代理子设备注册激活时,子设备无需单独绑定,子设备会默认绑定到网关所属的资产 ID 下。您可在智慧行业 App 或项目资产下查看已激活的子设备。
具体应用开发及绑定操作,可参考 应用开发。
场景 2:设备用于智能生活 App
通过智能生活 App 绑定网关至家庭,若网关下有子设备,拓扑关系会默认到对应家庭下,无需额外绑定操作。
绑定成功后,可使用网关和子设备相关面板进行功能控制,完成场景应用。