2. 阿里云IoT平台基础：产品创建、设备注册、Topic定义与权限管理

好，咱们正式开始动手了。这一章我会带你走一遍阿里云IoT平台最核心的流程——从零创建一个产品，注册一台设备，再到定义Topic和设置权限。说白了，这是所有后续开发的地基。我在项目里见过不少新手，一上来就急着写代码，结果发现设备连不上云，或者数据发不上去，回头一看，原来是产品没配对。嗯，咱们先把地基打牢。

2.1 产品创建：从“物模型”开始

在阿里云IoT平台里，产品是设备的抽象模板。你想想看，同一批智能灯，它们的功能都一样——开关、亮度、色温。你不需要为每一盏灯单独定义功能，只需要定义一个“智能灯”产品，然后所有灯都继承这个模板。

创建产品的步骤很简单，但我建议你注意几个关键点：

1. 节点类型：选“设备”还是“网关”？我个人习惯，如果是直连设备（比如一个温湿度传感器），就选“设备”。如果设备下面还挂子设备（比如一个网关带一堆蓝牙传感器），那就选“网关”。
2. 连网方式：Wi-Fi、蜂窝、以太网？这个根据你的硬件来。我做过一个项目，客户选了蜂窝网络，结果流量费比设备本身还贵……所以选之前先算算成本。
3. 数据格式：强烈建议选“ICA标准数据格式（Alink JSON）”。为什么？因为阿里云后续的很多高级功能（比如规则引擎、数据解析）都原生支持这个格式。你选自定义格式的话，后面所有解析都得自己写，累死人。

2.2 设备注册：给每个设备一个“身份证”

产品创建好了，接下来就是注册设备。每个设备在平台上都有一个唯一的DeviceName，以及一组密钥（DeviceSecret）。这就像设备的身份证和密码。

注册设备有两种方式：

• 手动注册：在控制台一个个添加。适合测试阶段，设备数量少的时候用。
• 批量注册：通过API或控制台批量导入。我建议你在生产环境用这种方式。我曾经帮一个客户批量注册了5000个设备，用Excel导入，几分钟搞定。手动点的话，手都得抽筋。

注册完成后，你会得到三个关键信息：

参数	说明	示例
ProductKey	产品唯一标识	a1B2C3d4E5f
DeviceName	设备唯一名称	light_001
DeviceSecret	设备密钥（请保密！）	e8f9a0b1c2d3...

2.3 Topic定义：设备与云端的“通信管道”

Topic 是什么？说白了，就是设备与云端之间的一条消息通道。设备往某个Topic发消息，云端就能收到；云端往某个Topic发消息，设备就能收到。

阿里云IoT平台预定义了三类Topic：

• /sys/{ProductKey}/{DeviceName}/thing/event/property/post：设备上报属性。比如温度、湿度。
• /sys/{ProductKey}/{DeviceName}/thing/service/property/set：云端设置属性。比如远程开关灯。
• /sys/{ProductKey}/{DeviceName}/thing/event/{eventName}/post：设备上报事件。比如报警、故障。

你还可以自定义Topic。我个人习惯，如果业务逻辑比较复杂，比如需要设备上报日志或固件版本，我会创建自定义Topic，这样方便后续用规则引擎做数据分流。

2.4 权限管理：谁可以读写哪个Topic？

Topic 定义好了，但你不能让设备随便乱发消息。比如，设备只能上报自己的属性，不能去修改别的设备的属性。这就需要权限管理。

阿里云IoT平台提供了三种权限：

• 发布（Publish）：设备可以向该Topic发送消息。
• 订阅（Subscribe）：设备可以接收该Topic的消息。
• 发布与订阅（Publish & Subscribe）：两者都有。

我建议你遵循最小权限原则：

• 设备上报属性：只给 发布 权限。
• 设备接收设置指令：只给 订阅 权限。
• 如果设备需要同时上报和接收（比如双向通信），才给 发布与订阅。

为什么会这样？你想想看，如果给设备同时开了发布和订阅权限，万一设备被黑客控制，它就能冒充云端下发指令给其他设备。我在一个项目中就遇到过类似问题，还好发现得早，及时收紧了权限。

2.5 实战：用Python验证连接

理论讲完了，咱们来点实际的。下面是一个简单的Python脚本，用阿里云IoT SDK连接平台，并上报一个属性值。

# 安装依赖：pip install aliyun-iot-device-sdk-python

from aliyun_iot_device import IotDevice

# 设备三元组
product_key = "a1B2C3d4E5f"
device_name = "light_001"
device_secret = "e8f9a0b1c2d3..."

# 创建设备实例
device = IotDevice(product_key, device_name, device_secret)

# 连接平台
device.connect()

# 上报属性
properties = {"temperature": 25.6, "humidity": 60.2}
device.post_property(properties)

print("属性上报成功！")

# 断开连接
device.disconnect()

这段代码很简单，但有几个坑要注意：

• 三元组必须和平台上注册的一致，大小写敏感。
• 如果连接失败，检查网络是否通畅，以及设备是否被禁用。
• 属性值必须符合产品定义的物模型范围。比如温度定义的是 -10 到 50，你传个 100 就会报错。