网关与子设备

前提条件

• 已创建网关和子设备。具体操作，请参见创建产品和创建设备。

  • 为网关创建对应的产品和设备，创建产品时，节点类型选择为网关设备。

  • 为子设备创建对应的产品和设备，创建产品时，节点类型选择为网关子设备。

• 已完成环境要求与配置和认证与连接步骤。

背景信息

• 物联网平台子设备功能的更多信息，请参见网关与子设备。

• 子设备与物联网平台之间的通信协议，请参见管理拓扑关系和子设备上下线。

版本要求

Aliyun IoT Python SDK 1.2.4及以上版本。

API说明

1. 网关添加子设备拓扑关系及其响应回调。

   #网关批量添加子设备拓扑，返回请求的request_id
   def gateway_add_subdev_topo(self, subdevList)
   
   #监听回调，用户需将其中的request_id与gateway_add_subdev_topo返回的request_id匹配
   def on_gateway_add_subdev_topo_reply(self, request_id, code, data, msg, user_data)

2. 子设备登录及其响应回调。

   #网关批量对子设备进行登录 
   def gateway_login_subdev(self, subdevList)
   
   #监听回调，用户需将其中的request_id与gateway_login_subdev返回的request_id匹配
   def on_gateway_login_subdev_reply(self, request_id, code, data, msg, user_data)
   

3. 网关删除子设备拓扑关系及其响应回调。

   #网关批量删除子设备拓扑 
   def gateway_delete_subdev_topo(self, subdevList)
   
   #监听回调,用户需将其中的request_id与gateway_delete_subdev_topo返回的request_id匹配
   def on_gateway_delete_subdev_topo_reply(self, request_id, code, data, msg, user_data)

4. 子设备退出登录及其响应回调。

   #网关批量对子设备进行退出登录
   def gateway_logout_subdev(self, subdevList)
   
   #监听回调,用户需将其中的request_id与gateway_logout_subdev返回的request_id匹配
   def on_gateway_logout_subdev_reply(self, request_id, code, data, msg, user_data)

5. 子设备动态注册及其响应回调。

   #网关批量对子设备进行动态注册（需要productSecret)
   def gateway_product_register_subdev(self, subdevList)
   
   #监听带产品的动态注册结果的回调,用户需将其中的request_id与gateway_batch_product_register返回的request_id匹配
   def on_gateway_product_register_subdev_reply(self, request_id, code, data, msg, user_data)

6. 子设备拓扑关系变化通知。

   #监听topo关系变化的回调
   def on_gateway_topo_change（self, request_id, params, userdata）

Demo说明

网关上线后，需要先添加子设备的拓扑关系并进行子设备登录操作，子设备才能收发消息。在Demo的gateway_demo.py文件中（在 环境要求与配置中可以下载Demo），需进行的操作步骤如下：

1. 在demo_get_subdev_list函数中，通过数组方式，添加子设备的设备证书（ProductKey、DeviceName、DeviceSecret）。

2. 在网关设备连接物联网云平台成功的on_connect回调中执行self.__linkkit.gateway_add_subdev_topo，对子设备添加拓扑关系。

3. 拓扑关系添加成功后，进入on_gateway_add_subdev_topo_reply回调，在这个回调中进行子设备登录操作self.__linkkit.gateway_login_subdev。

4. 子设备登录成功后，进入on_gateway_login_subdev_reply回调，即可以进行单个子设备的收发消息的操作。