第1章:云平台账号注册与基础配置

各位同学,咱们正式开始。做物联网项目,第一步不是写代码,而是先把“根据地”建好。这个根据地,就是云平台。

我见过不少新手,上来就急着调AT指令、连模组,结果折腾半天发现设备死活上不了线。一查,原来是云平台上的产品没创建,设备没注册。嗯,这种坑我踩过不止一次。

所以今天这一章,咱们就老老实实把云平台的“地基”打牢。说白了,就是四步走:实名认证、创建项目/产品、创建设备、获取接入凭证。

1.1 实名认证——别嫌麻烦,这是必经之路

国内主流的物联网云平台,比如阿里云IoT、华为云IoT、腾讯云IoT,注册账号后第一件事就是实名认证。为什么?因为平台要确保你是真实用户,防止有人拿平台干坏事。

我个人习惯用企业账号认证,因为后面涉及到设备量大了,个人账号的配额往往不够用。如果你只是个人学习,用个人实名认证也行,流程简单些。

小提示: 实名认证一般需要提供身份证信息,或者企业营业执照。认证通过后,平台会给你一个“开发者认证”标识。这个标识,后面申请某些高级功能时会用到。

认证过程其实不复杂。上传证件照片,填个手机验证码,等个几分钟到几小时不等。我遇到过最快的一次,阿里云5分钟就通过了。慢的时候,华为云等了大半天。别急,耐心等就行。

1.2 创建项目与产品——给设备“安个家”

认证通过后,进入云平台控制台。你会看到“创建项目”或“创建产品”的入口。这里我解释一下这两个概念:

  • 项目:可以理解为一个“文件夹”,用来管理多个产品。比如你做一个智慧农业项目,里面可以包含“温湿度传感器”、“土壤湿度传感器”、“光照传感器”等多个产品。
  • 产品:对应一种具体的设备类型。比如“温湿度传感器”就是一个产品。同一个产品下的设备,功能、数据格式都是一样的。

我建议你按实际业务来划分。别把所有设备都塞到一个产品里,那样后面维护起来会非常痛苦。我曾经接手过一个项目,前任把所有传感器都定义成同一个产品,结果数据解析时乱成一锅粥。嗯,那滋味不好受。

创建产品时,需要填写几个关键信息:

字段 说明 我的建议
产品名称 给你的产品起个名字 用英文或拼音,方便后面代码调用
节点类型 直连设备、网关设备、子设备 NB-IoT终端一般选“直连设备”
联网方式 WiFi、蜂窝(2G/3G/4G/5G)、NB-IoT 选“蜂窝”或“NB-IoT”
数据格式 Alink JSON、自定义透传等 新手建议用Alink JSON,调试方便
注意: 产品创建后,有些平台不允许修改“节点类型”和“联网方式”。所以创建前一定想清楚。我见过有人把NB-IoT设备选成了WiFi,后面只能删掉重建。

1.3 创建设备——给每个终端一个“身份证”

产品创建好了,接下来就是在这个产品下创建设备。每个设备在云平台上都有一个唯一的身份标识,通常叫 DeviceName设备名称

创建设备时,平台会生成三个关键信息:

  • ProductKey:产品唯一标识。同一个产品下的设备,这个值是一样的。
  • DeviceName:设备唯一标识。你可以自己起名,比如 sensor_001,或者让平台自动生成。
  • DeviceSecret:设备密钥。这个很重要,相当于设备的“密码”。

我个人习惯用有意义的设备名,比如 nb_iot_temp_01,这样一看就知道是哪个设备。自动生成的那串乱码,调试时根本分不清谁是谁。

创建设备的方式有两种:

  1. 手动创建:在控制台页面一个个添加。适合设备数量少的情况(比如10个以内)。
  2. 批量创建:通过API或导入CSV文件。适合设备数量多的情况。我做过一个项目,一次性创建了5000个设备,手动点的话手都得废掉。
核心要点: 设备创建后,DeviceSecret 只会显示一次。一定要保存好!如果丢了,只能重置密钥。重置后,设备端也要同步更新,否则连不上平台。

1.4 获取接入凭证——设备上云的“通行证”

设备要连上云平台,光有ProductKey和DeviceName还不够。还需要知道“往哪里连”和“怎么连”。

这个“往哪里连”就是接入地址,通常是一个MQTT Broker的域名或IP地址。比如阿里云的是 iot-as-mqtt.cn-shanghai.aliyuncs.com。不同地域、不同平台,地址不一样。

“怎么连”就是认证方式。NB-IoT设备最常用的是 一机一密 认证。也就是每个设备用自己独有的 ProductKeyDeviceNameDeviceSecret 进行连接。

获取接入凭证的步骤:

  1. 在云平台控制台找到“设备接入”或“MQTT接入”页面。
  2. 复制接入地址(域名和端口)。
  3. 准备好设备的ProductKey、DeviceName、DeviceSecret。
  4. 用MQTT客户端(比如MQTTX)测试一下能否连上。

这里我分享一个调试技巧:先用MQTTX这样的桌面工具模拟设备连接。如果连不上,先别怀疑硬件,大概率是凭证填错了。我曾经花了一下午排查设备,最后发现是DeviceSecret里多了一个空格。嗯,这种低级错误,谁都会犯。

避坑指南: 我曾经在华为云上遇到过一个问题——设备一直显示“未激活”。后来发现,NB-IoT设备需要先上报一次数据,平台才会把状态从“未激活”变成“在线”。所以别看到“未激活”就慌,先发条数据试试。

1.5 本章小结

好了,这一章的内容就这些。总结一下:

  • 实名认证是前提,别跳过。
  • 项目/产品是逻辑分组,创建时选对参数。
  • 设备是实际终端,每个设备有唯一凭证。
  • 接入凭证是连接的关键,保存好、测试通。

下一章,咱们开始真正动手——在NB-IoT模组上配置这些凭证,让设备连上云平台。到时候你会发现,今天这些准备工作,每一步都省不了。

公众号:蓝海资料掘金营,微信deep3321