LV02-01-天猫精灵IOT-01-WiFi智能灯-01-物联网平台产品创建

发表于 分类于 ， ， 本文字数： 6.6k 阅读时长 ≈ 24 分钟

本文主要是WiFi智能灯——物联网平台产品创建的相关笔记，若笔记中有错误或者不合适的地方，欢迎批评指正😃。

点击查看使用工具及版本
Windows版本 windows11
Ubuntu版本 Ubuntu22.04的64位版本
VMware® Workstation 16 Pro 16.2.3 build-19376536
终端软件 MobaXterm(Professional Edition v23.0 Build 5042 (license))
点击查看本文参考资料
分类 网址 说明
官方网站 阿里云 阿里云官网主页
阿里生活物联平台 生活物联网平台(飞燕平台)主页
AliGenie 天猫精灵开放平台AliGenie主页
阿里物联网平台 阿里物联网平台主页
Bluetooth 技术网站 蓝牙协议规范什么的可以来这里找
Telink Telink | Chips for a Smarter IoT (telink-semi.com)
Telink中文官网
开发手册 AliOS Things开发指南 AliOS Things开发指南，这里是最新版本，可以直接从官网找到
AliOS Things开发指南 AliOS Things应用开发指南，这里应该是3.3版本的完整开发文档
AliOS Things开发指南(3.0) AliOS Things应用开发指南，这里应该是3.0版本的完整开发文档
生活物联网平台开发文档 生活物联网平台（飞燕平台）开发文档
《设备端开发指南》
Wi-Fi IoT品类定义与功能开发 天猫精灵IoT开放平台——Wi-Fi IoT品类定义与功能开发
硬件平台 mk3080 WiFi开发板 WiFi开发板使用指南-阿里云开发者社区
esp8266开发板 一个教程：ESP8266-NodeMCU开发板详解-太极创客 (taichi-maker.com)
TLSR8258 Datasheet Datasheet for Telink BLE + IEEE802.15.4 MultiStandard Wireless SoC TLSR8258
参考资料 AliOS Things 3.0 应用开发指南 这个只是一篇参考文章，里面是一些环境搭建相关的，可以参考
IP知识百科 - 华为 (huawei.com) IP的一些相关知识点
点击查看相关文件下载
分类 网址 说明
蓝牙规范相关文档 Core Specification 5.2 核心规格 5.2，该规范定义了创建可互操作的Bluetooth 设备所需的技术。
《Core_v5.2.pdf》
Mesh Model(v1.1) 本Bluetooth 规范定义了模型（以及它们所需的状态和消息），这些模型用于在mesh 网络中的节点上执行基本功能，超出了Bluetooth Mesh 配置文件 规范中定义的基础模型。
本规范包括定义跨设备类型标准功能的通用模型，以及支持关键mesh 场景的模型，如照明控制、传感器、时间和场景。
《MshMDL_v1.1.pdf》
Mesh Profile(v1.0.1) 该Bluetooth 规范定义了基本要求，以实现可互操作的mesh 网络解决方案，用于Bluetooth 低能量无线技术。
《MshPRFv1.0.1.pdf》
Mesh Device Properties 本规范包含Bluetooth Mesh 配置文件 和Bluetooth Mesh 模型规范所要求的设备属性的定义。
但是跟之前的有些区别，我主要看的之前的版本：《MMeshDeviceProperties_v1.2.pdf》
GATT Specification Supplement GATT Specification Supplement | Bluetooth® Technology Website。
好像可以在线看：《GATT Specification Supplement》
Assigned Numbers GATT的一些类型定义可以在这里找。
AliOS Things alios-things/AliOS-Things Gitee上的AliOSThings SDK源码仓库
alibaba/AliOS-Things GitHub上的AliOSThings SDK源码仓库
天猫精灵蓝牙Mesh协议栈 alibaba-archive/genie-bt-mesh-stack GitHub上的天猫精灵蓝牙Mesh协议栈源码仓库。
之前是在alibaba/genie-bt-mesh-stack这个仓库。
写笔记的时候最新提交为faf523618a6a2560090fc423222b9db80984bb7a
蓝牙Mesh设备开发指南 阿里云生活服务平台开发手册——蓝牙设备开发一节中的内容

一、阿里物联网平台

1. 平台简介

生活物联网平台是一款针对消费领域的物联网平台，主要针对家电智能化的设备连接、移动端控制、设备管理、数据统计等问题，打包阿里云多款产品，提供了一整套配置化方案，可以大幅减低“设备-云端-App”的开发成本。

2. 生活物联网平台的定位

随着物联网的发展，未来的智能家居生活已经触手可及，生活物联网平台便是一个提供可开发、易调试、更好运维及方便管理等功能的智能IoT设备开发管理平台。

生活物联网平台支持您将自主开发的产品接入到平台，也支持采用生活物联网平台提供的产品方案进行开发智能IoT设备，为构筑未来智能家居生活添砖加瓦。

生活物联网平台有以下不同的项目形式接入平台：

  • 自有品牌项目

    选择使用该项目接入平台的用户可以根据自己的产品方案使用生活物联网平台提供的SDK与云端资源进行开发属于自己品牌的智能IoT设备，并接入生活物联网平台的云端服务，使用平台的智能服务，提升品牌的形象。

  • 天猫精灵生态项目

    选择使用该项目接入平台的用户可以开发直连天猫精灵IoT生态服务的智能IoT设备，可以使用生活物联网平台中天猫精灵IoT的全套智能服务，详见下文与天猫精灵IoT的关联。

3. 与天猫精灵IoT的关联

2020年7月，天猫精灵IoT开放平台和阿里云生活物联网平台完成融合。融合后的生活物联网平台，成为阿里巴巴集团内统一的消费级智能设备IoT平台，可以支撑以下两种业务形态。

  • 面向智能生活行业赋能的云产品，为全球客户提供全球化、智能化的付费云服务。

    接入生活物联网自有品牌项目的IoT产品，可以在全球范围内售卖您的设备。同时您还可以配套拥有自有品牌的App，提升您的品牌形象。

  • 面向天猫精灵IoT生态的设备接入，与国内设备厂商共同搭建围绕天猫精灵的IoT生态。

    选择接入天猫精灵IoT生态的产品，可以被天猫精灵全系生态终端控制，包括天猫精灵各型号音箱、天猫精灵App、天猫精灵车机等，可以实现语音、触屏等多模态交互，为消费者提供控制、查询、播报、场景与主动服务。目前天猫精灵IoT生态已接入1500多个品牌，200多个类目，7000多个型号。

融合后的平台实现了物模型、设备证书、固件开发标准、应用开发标准的统一。后续平台会致力于结合IoT物联网技术（蓝牙协议、Wi-Fi协议、云服务）和天猫精灵的AI能力（ASR语音识别、NLP自然语言处理、TTS语音合成），向您提供更丰富的智能服务。

4. 与物联网平台的区别

生活物联网平台和物联网平台均为阿里云IoT提供的云服务平台，两个平台各自优势和使用场景如下。

  • 物联网平台提供原子化的设备接入能力，适用于云开发能力较强的用户，可以在各个行业领域使用。更多介绍，请参见什么是物联网平台。
  • 生活物联网平台提供了设备接入能力、移动端的SDK以及免开发的云智能App和界面，更适用于消费级的智能设备开发者，开发门槛较低，可以快速实现消费级设备的智能化，如智能家电、穿戴、家装领域等。

5. 功能特性

  • 低门槛极速化客户

    • 周期短

      1分钟可完成面板配置；5小时可完成智能化；10天可完成量产。

    • 成本低

      提供认证模组，直接连接云端；提供SDK，快速上手。

    • 免开发

      提供云智能App（旧称公版App）和免开发的App界面；提供标准运营后台，支持数据图表的统计分析。

  • 高灵活深定制客户

    • 高可用性

      一机一密，保障个人隐私安全；平台同时可支持亿级设备接入，保障连接质量。

    • 全球化

      设备可在全球服务范围内可激活，助力中国智造实现全球化。

    • 品牌自有

      提供云端API，支持自主开发业务逻辑。

3. 相关文档

官网地址为：项目管理 - 生活物联网平台 (aliyun.com)

生活物联网平台帮助文档：生活物联网平台-阿里云帮助中心 (aliyun.com)

天猫精灵IOT开放平台帮助文档：AliGenie开发者平台 (tmall.com)

二、搭建开发平台

这里以创建一个智能灯的产品为例。

1. 注册登录

这里就正常点开项目管理 - 生活物联网平台 (aliyun.com)，注册登录即可，首次登录使用的话，可能会有这些弹窗，都点确认就可以了。

image-20231211232346516

然后就会来到项目管理界面啦：

image-20231211232436501

2. 创建项目

我们点击创建新项目，然后会让输入项目名称：

image-20231212074949375

然后等待创建完成就会在项目管理界面看到我们创建的空项目啦：

image-20231212075112687

3. 创建产品

我们进入创建的项目中（产品管理 - 生活物联网平台 (aliyun.com)），然后点击创建新产品：

image-20231212075227653

可以看到，我们一个项目下面可以创建10个产品。然后根据下图创建一个智能灯的产品：

image-20231212080151202

然后我们点击确认，接着就会开始创建产品，创建完成后，等待一会，会自动跳转到开发界面：

image-20231212175811174

4. 产品开发

我们上面创建完产品后，就会自动跳转到产品开发界面，也可以在项目中找到产品，然后点击开发，接着也会跳转到开发界面。

image-20231212175916413

4.1 功能定义

首先是功能定义，我们看到的界面如下：

image-20231212180050957

我们可以点击添加功能来定制自己所需的功能，这里我们暂时先只添加一个开关的属性。

4.2 人机交互

接下来是人机交互的终端，我们这里选择天猫精灵：

image-20231212180237407

然后我们点击保存就会弹出其他配置项。

  • 首先是【产品展示】：
image-20231212180708878

按上图配置可，配置完成后点击保存即可。

  • 接下来就是【配网引导】：
image-20231212181150208

这里好像只有一种蓝牙辅助配网，但是后来我看了帮助文档，后来这里是默认支持WiFi配网的，这里我们也没法选其他的，也无法取消勾选，就暂时按这个来，并不影响后面的配网过程。然后就是就是这个配网引导文案，这里也是必须要填写的，按照提示配置就可：

image-20231212181822732

最后点击保存就可以了。最终产品做好之后，配网成功的话，就可以直接在天猫精灵看到产品，并进行控制。

  • 接下来是【绑定方式】保持默认即可。
image-20231212182114848
  • 【设备面板】：我直接选择了一个默认的面板：
image-20231212182247743
  • 【语音交互】：这里保持默认
image-20231212182324732
  • 【产品说明书】

就按照模板写一个问文档上传即可。

image-20231212182801645

一定要注意这里产品说明书的要求，下面的产品物料包装随便填一下就可以了。注意这里有一个配网二维码，后面可以通过天猫精灵app来扫码进行配网。

4.3 设备调试

设备调试这里其实之前已经选择过了，我们使用的mk3080开发板使用的cpu为rtl8710bn，所以这里选择对应的芯片模组即可：

image-20231212185408918

这里其实可以根据自己使用的开发板使用的CPU来选，然后通过阿里提供的这些SDK和帮助文档来进行开发就可以了：

image-20231212185847451

然后是这里的测试设备，我们可以添加一个测试设备，就是这里我们想要设备连接到阿里云的话，这里需要添加，添加后会生成设备ID，这样才能被阿里云所识别，正常入阿里云的网，需要注意，似乎这里添加设备后，这个产品就无法删除了。这里可以自定义设备名称，但是好像有什么限制，当然也可以不指定，这样阿里云平台会自动帮我们生成对应的内容：

image-20231212190600340

这里一些重要的内容我们要记录下来：

1
2
3
ProductKey：a1BzTBsjEp4
DeviceName：503dec2b085d
DeviceSecret：74d8630b60becfa5dcb27a68b77cca93

由设备还没有激活和接入，所以这里是未激活的状态：image-20231212190713922

到这里为止，我们的产品就算创建完成了。

5. 重要信息记录

我们在后面使用AliOSThings开发的时候可能会用到一些参数：

1
2
3
4
5
Product Secret: Cn4D0R3OMUMHx9eK
Product ID    : 21110806
Product Key   ：a1BzTBsjEp4
DeviceName    ：503dec2b085d
DeviceSecret  ：74d8630b60becfa5dcb27a68b77cca93