OneNet平台2024版MQTT协议完整开发案例教程【MQTT数据流模式】

已于 2024-12-31 13:38:31 修改
阅读量7.4k 收藏 142
点赞数 27
分类专栏： 智能家居与物联网项目实战 文章标签： stm32 onenet
于 2024-12-29 16:44:00 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/xiaolong1126626497/article/details/144806792
版权

一、前言

此篇文章是以智慧路灯项目为例，完整的演示介绍 OneNet平台的开发。

OneNet平台 是2024年的新版本，采用数据流模版为例。

方便大家，腾讯云IOT 转 OneNet平台。 因为目前腾讯云IOT平台无法白嫖了，新用户已经无法免费使用了。

二、OneNet平台开发

2.1 OneNet平台介绍

OneNET-中国移动物联网开放平台是由中国移动打造的PaaS物联网开放平台。平台能够帮助开发者轻松实现设备接入与设备连接，提供综合性的物联网解决方案，实现物联网设备的数据获取，数据存储，数据展现。

OneNET资源模型如下图：

资源模型

  • 产品(product)
    用户的最大资源集为产品，产品下资源包括设备、设备数据、设备权限、数据触发服务以及基于设备数据的应用等多种资源，用户可以创建多个产品。
  • 设备(device)
    设备为真实终端在平台的映射，真实终端连接平台时，需要与平台设备建立一一对应关系，终端上传的数据被存储在数据流中，设备可以拥有一个或者多个数据流。
  • 数据流与数据点
    数据流用于存储设备的某一类属性数据，例如温度，湿度，坐标等信息；平台要求设备上传并存储数据时，必须以key-value的格式上传数据，其中key即为数据流名称，value为实际存储的数据点，value格式可以，int、float、string、json等多种自定义格式。
  • APIkey
    APIkey为用户进行API调用时的密钥，用户访问产品资源时，必须使用该产品目录下对应的APIkey。
  • 触发器(trigger)
    触发器为产品目录下的消息服务，可以进行基于数据流的简单逻辑判断并触发HTTP请求或者邮件。
  • 应用(application)
    应用编辑服务，支持用户以拖拽控件并关联设备数据流的方式，生成简易网页展示应用。

OneNET常用的术语解释如下：

术语解释别名&曾用名
产品OneNET平台资源（包括设备，APIKey，触发器，应用等）的集合，一个产品对应唯一的masterkey、产品ID，设备注册码，一个产品下包含多个具备同一特征的设备，多个设备之间的唯一性由SN来区分项目
产品IDpid，鉴权信息组之一，创建产品时由平台分配的唯一产品识别码，用于标识唯一个产品，作为设备登录鉴权参数之一项目ID
APIKey用于API调用时的鉴权参数 Master-APIkey：产品下唯一的管理员权限的APIKey，具有管理产品下所有设备的权限，在产品页面获取 Device-APIkey：设备级APIkey，具备与之关联的所有设备的访问权限，在设备详情获取
accessKey安全性更高的访问密钥，用于访问平台时的隐性鉴权参数（非直接传输），通过参与计算并传输token的方式进行访问鉴权
token安全性更高的鉴权参数，由多个参数组成，在通道中直接传输
注册码产品下唯一，可用于真实设备调用注册设备时，作为API的鉴权参数之一
设备归属于某一个产品下，是真实设备在平台的映射，用于和真实设备通过连接报文建立连接关系，平台资源分配的最小单位
鉴权信息组由设备ID，产品ID，设备SN组成的平台内设备唯一的参数组合，真实设备进行设备连接时需要携带有这些参数进行鉴权（参数要求根据设备接入协议不同有一定差异）
设备ID鉴权信息组之一，由平台分配的，在平台范围内设备唯一的识别号
SN鉴权信息组之一，由硬件厂家自定义的设备唯一出厂序列号，创建/注册设备时作为设备参数，在产品内唯一，作为设备连接时的鉴权参数之一auth_info 设备编号
数据流设备属性，可为设备单项数据属性，例如温度=10；也可为设备数据属性的组合，例如坐标=x:10 y:20
数据流模板产品下所有设备均具备的采集数据属性，例如空气质量检测仪均可以上报“PH2.5”“甲醛浓度”等数据
数据点设备每次上传到数据流中的数据
脚本平台支持用户自定义数据解析规则，解析二进制/字符串格式的数据（仅适用于TCP+脚本接入方式）

2.2 创建产品

（1）登录账户

官网：https://open.iot.10086.cn/

进来先登录账号。

image-20240402000239430

（2）选择物联网开放平台

image-20240402000349407

（3）添加产品

image-20240402000427233

根据自己产品信息填写：

image-20240414205253934

image-20240414205321795

创建之后点击确定。

image-20240414205451513

创建完成。

image-20240414205515838

（4）产品ID

产品ID： 98uHEEv82D

2.3 创建设备

产品是属性抽象模型，产品下面的设备就表示具体的硬件设备，需要与具体的硬件关联。产品下可以创建很多的设。

（1）添加设备

image-20240414205553976

（2）填写设备信息

image-20240414205617817

创建完成。

image-20240414205636755

创建完成。

image-20240414205700691

（3）查看设备详情

添加完成之后，点击查看详情，查看设备的详细信息。

image-20240414205711245

image-20240414205731335

这里的产品ID、设备ID、设备密匙非常有用。后续MQTT登录参数需要使用。这里记录一下。

产品ID:  98uHEEv82D
设备ID:  2160589715
设备密匙：NThVNm9pQ3lYbmRvMTVhU0QyM0hXOFhmMXExRlE5T0g=
设备名称：dev1

2.4 添加数据流模板

（1）添加数据流模板

image-20240414205840406

添加数据流模板。

image-20240414205901410

（2）根据设备需求添加

当前设备里，与云端交互的状态有以下几个：

上传到物联网平台的数据属性。

DHT11_T     	环境温度  
DHT11_H     	环境湿度    		
HumanBody_Flag  人体感应    		
BH1750      	环境光强    		  
LED_SW      	路灯开关           
MQ135       	空气质量            
LED_SW_Flag     路灯的状态  0故障  1正常
SOS_Info        SOS紧急求助    
gps             地图定位信息

开始创建：

image-20240414211328445

image-20240414211408744

下面依次创建即可。

（3）添加完毕

image-20240414211549661

添加完成：

DHT11_T环境温度℃
DHT11_H环境湿度%
HumanBody_Flag人体感应
BH1750环境光强Lux
LED_SW路灯开关
MQ135空气质量
LED_SW_Flag路灯的状态
SOS_InfoSOS紧急求助
gps地图定位信息

2.5 MQTT协议接入地址

当前智能鱼缸设备是采用MQTT协议与OneNet服务器进行通信。

MQTT物联网套件产品架构如下图所示：

image

接入地址说明：https://open.iot.10086.cn/doc/v5/develop/detail/248

在帮助文档页面，介绍了MQTT接入的地址和端口号。 当前设备是单片机，端口采用1883非加密端口。

image-20221205160655279

地址与端口总结如下：

上面的域名转为IP之后信息如下：（如果设备不支持域名解析，可以直接填IP地址）
IP地址: 183.230.40.96
端口号: 1883

2.6 MQTT主题订阅与发布

MQTT协议是一种消息列队传输协议，采用订阅、发布机制，订阅者只接收自己已经订阅的数据，非订阅数据则不接收，既保证了必要的数据的交换，又避免了无效数据造成的储存与处理。因此在工业物联网中得到广泛的应用。

（1）主题订阅

主题订阅是设备订阅平台的消息，如果设备想知道平台下发的消息，就需要订阅主题。

帮助文档: https://open.iot.10086.cn/doc/mqtt/book/device-develop/protocol.html

需要订阅什么数据，设备端按照下面的主题格式填写订阅即可。

image-20221205161140648

如果想知道设备所有相关信息，直接订阅$sys/{产品ID}/{device-name}/#即可。 (其中的PID就是产品ID)

$sys/98uHEEv82D/dev1/#

（2）主题发布

主题发布： 就是设备向平台上传数据。

帮助文档地址：https://open.iot.10086.cn/doc/mqtt/book/example/datapoints.html

文档里介绍了数据点上传的格式：

image-20221104113829775

根据当前设备，总结的格式如下：

发布主题: $sys/98uHEEv82D/dev1/dp/post/json

发布消息:
{"id":123,"dp":{"DHT11_T":[{"v":20}],"DHT11_H":[{"v":10}],"BH1750":[{"v":30}],"MQ135":[{"v":10}],"LED_SW":[{"v":1}],"HumanBody_Flag":[{"v":0}],"LED_SW_Flag":[{"v":0}],"SOS_Info":[{"v":0}],"gps":[{"v":{"lon":108.89921,"lat":34.268685}}]}}

dp对象里面就是需要上传的数据点字段。 这个数据点的名字就是自己创建数据流模板的时候创建的。

数据点是标准的JSON结构：

{
  "id": 123,
  "dp": {
    "DHT11_T": [
      {
        "v": 20
      }
    ],
    "DHT11_H": [
      {
        "v": 10
      }
    ],
    "BH1750": [
      {
        "v": 30
      }
    ],
    "MQ135": [
      {
        "v": 10
      }
    ],
    "LED_SW": [
      {
        "v": 1
      }
    ],
    "HumanBody_Flag": [
      {
        "v": 0
      }
    ],
    "LED_SW_Flag": [
      {
        "v": 0
      }
    ],
    "SOS_Info": [
      {
        "v": 0
      }
    ],
    "gps": [
      {
        "v": {
          "lon": 108.89921,
          "lat": 34.268685
        }
      }
    ]
  }
}

2.7 MQTT三元组生成

设备登录OneNet采用的是MQTT协议，MQTT协议登录需要填写 登录信息：简称 MQTT三元组。

（1）生成密码需要的参数

生成密码的软件里需要填写的参数如下：

image-20240414213932354

（2）密匙生成需要的参数

产品ID： 98uHEEv82D
设备key：NThVNm9pQ3lYbmRvMTVhU0QyM0hXOFhmMXExRlE5T0g=

（3）使用Python代码生成MQTT密匙

下面提供了一份Python代码，实现此密码生成的算法。
建议大家，用我提供的代码，使用Python生成密码，不要使用OneNet自带的工具生成。

这样更加简单，不用考虑过期时间问题。非常的方便。你只需要安装好Python环境就可以了。

Python环境搭建: https://blog.csdn.net/xiaolong1126626497/article/details/118497618

完整的代码如下。`

import base64
import hmac
from urllib.parse import quote
import time

# 中国移动官方文档给出的核心秘钥计算算法
def token(id,access_key):  
    version = '2018-10-31'
    res = 'products/%s' % id  # 通过产品ID访问产品API
    # 用户自定义token过期时间
    et = str(int(time.time()) + 63072000) # 设置为2年有效时间
    # 签名方法，支持md5、sha1、sha256
    method = 'sha1'
    # 对access_key进行decode
    key = base64.b64decode(access_key)
    # 计算sign
    org = et + '\n' + method + '\n' + res + '\n' + version
    sign_b = hmac.new(key=key, msg=org.encode(), digestmod=method)
    sign = base64.b64encode(sign_b.digest()).decode()
    # value 部分进行url编码，method/res/version值较为简单无需编码
    sign = quote(sign, safe='')
    res = quote(res, safe='')
    # token参数拼接
    token = 'version=%s&res=%s&et=%s&method=%s&sign=%s' % (version, res, et, method, sign)
    return token

username    = "DGvoS8UR1Q"                                           # 产品ID
accesskey   = "aTF1a2JDc2s0QlNEMFZHU0l6QnJFbDd1Z1oxMUlZOGI="         # accessKey
password = token(username, accesskey)
print(password)

（4）生成MQTT登录密匙

第一步： 填好参数

在这里插入图片描述

第二步：生成密匙

在这里插入图片描述

第三步，复制密匙，待用

version=2018-10-31&res=products%2F98uHEEv82D%2Fdevices%2Fdev1&et=99986799814791288&method=md5&sign=F39nUo4xXMeXxPfSerTfIQ%3D%3D

（5）MQTT登录参数总结

MQTT协议登录时，需要输入3个参数： MQTT-设备ID，MQTT-设备名称，MQTT-密码。

对应OneNet的参数：

MQTT- 设备ID  -----> 就是OneNet的设备名称

MQTT-设备名称-----> 就是OneNet的产品ID

MQTT-密码------------> 就是OneNet的密匙工具生成的密码

下面是对本次的设备做总结：

IP地址: 183.230.40.96
端口号: 1883
clientId: dev1
username: 98uHEEv82D
password: version=2018-10-31&res=products%2F98uHEEv82D%2Fdevices%2Fdev1&et=99986799814791288&method=md5&sign=F39nUo4xXMeXxPfSerTfIQ%3D%3D


订阅主题:  $sys/98uHEEv82D/dev1/#


发布主题: $sys/98uHEEv82D/dev1/dp/post/json

发布消息:
{"id":123,"dp":{"DHT11_T":[{"v":20}],"DHT11_H":[{"v":10}],"BH1750":[{"v":30}],"MQ135":[{"v":10}],"LED_SW":[{"v":1}],"HumanBody_Flag":[{"v":0}],"LED_SW_Flag":[{"v":0}],"SOS_Info":[{"v":0}],"gps":[{"v":{"lon":108.89921,"lat":34.268685}}]}}

2.8 MQTT工具登录测试

前面已经介绍了MQTT协议登录需要用到的参数，以及订阅主题、发布主题的格式，接下来我们通过MQTT工具模拟设备登录OneNet平台，完成数据交互测试。

简单来说： 就是用软件来模拟实际的硬件，登录onenet平台，上传数据，走一下这个流程。

（1）模拟设备登录

接下来根据软件的输入框提示，输入对应的参数，然后登录设备，订阅主题，发布主题即可完成一个流程的测试。

image-20240414214103237

（2）登录OneNet控制台查看设备

在设备列表页面，可以看到设备已经在线了。

image-20240414214130962

在设备详情页面可以看到设备模拟器刚才上传的数据：

image-20240414214207398

地图也可以查看。

image-20240414214229985

到此，设备的云平台已经配置完毕。

三、OneNet可视化界面设计

关于中国移动的OneNet物联网开发平台 的可视化界面使用可以看视频教程：https://www.bilibili.com/video/BV12m421u7A5

四、腾讯云如何替换OneNet

（1）看这个文章：https://blog.csdn.net/xiaolong1126626497/article/details/144806792
在这里插入图片描述
这里就对应了，腾讯云平台文章，一样的内容。 如何得到 订阅、发布主题，以及MQTT登陆参数。

然后得到这些之后，如何替换到你的腾讯云工程之后。

看这个文章
https://blog.csdn.net/xiaolong1126626497/article/details/134781708
在这里插入图片描述
看这里就完成了。

ESP8266 OneNet云服务器 MQTT协议
07-28
ESP8266 OneNet云服务器 MQTT协议
MQTT OneNET实现 V2.8
05-30
中国移动 的 MQTT协议详细内容请参见MQTT version 3.1.1官方文档，本文档对此不做详细说明，仅指明OneNet的要求、默认参数、以及当前实现与MQTT官方文档的差异。 该版本支持的功能:  鉴权;  数据点上报(平台指定topic);  创建topic;  获取项目的topic列表;  订阅/取消平台的topic;  设备间topic订阅;  平台命令下发;  Qos0(cS) ,Qos1(C->S);  连接保活  离线topic  数据点订阅
OneNet云平台搭建（保姆级教程）
2503_90578101的博客
03-01 1140
OneNet云平台搭建（保姆级教程）
ESP32通过MQTT协议连接ONENET(新版)上报信息
u011574457的博客
08-13 2484
ESP32连接ONENET
【嵌入式裸机开发】智能家居入门7：最新ONENET，MQTT协议接入，最全最新（微信小程序、MQTT协议、ONENET云平台、STM32）
海风的博客
08-19 2630
本篇文章介绍最新ONENET云平台的MQTT协议接入方法，在STM32上实现数据上云与服务器下发数据解析，以及微信小程序接入服务器。对于智能家居而言，最重要的就是通信，通信是否稳定是否响应快，这是最重要的，外设的连接与控制这些都是很简单的，网上的一搜直接就有现成的代码，所以本篇博客不会介绍关于外设的使用与控制，主要介绍最新ONENET的接入与消息解析，这个框架搭好以后，其它外设连接那都不是事儿。OLED液晶显示屏或串口调试模块（USB转TTL）DHT11（可有可无，自己虚构上传数据也可以）
onenet数据流模板_OneNet平台实践
weixin_34510298的博客
12-24 2786
原文链接：https://blog.csdn.net/w_xiaote/article/details/80109634#commentsW5500通过DHT11采集环境温湿度并上传到onNET平台，登录账号可查看到温湿度数据的变化图。1、注册oneNET平台账号；登录https://open.iot.10086.cn/，根据个人情况选择个人注册或者企业注册，注册以后登录。2、创建产品登录以后点击...
MQTT协议接入OneNET （一）
热门推荐
江南雨
10-25 3万+
    MQTT协议是一个面向物联网应用的即时通信协议，使用TCP/IP提供网络连接，能够对负载内容实现消息屏蔽传输，开销小，可以有效降低网络流量。MQTT协议适用于设备和平台需要保持长连接的使用场景，MQTT特点在于可以实现设备间的消息单播以及组播，可以不依赖于其他服务（下发命令服务，推送服务等）实现让设备以应用服务器的方式对真实设备进行管理和控制。 正因为MQTT协议拥有这些特点，现在成...
玩转OneNET物联网平台之MQTT服务① —— OneNetMqtt全方位调试
单片机菜鸟哥的博客
06-20 2万+
文章目录1.MQTT简介2.MQTT接入说明2.1 Step1 —— 创建产品，选择接入协议2.2 Step2 —— 创建设备，记录设备ID等信息2.3 Step3 —— 建立设备与平台间的协议连接2.4 Step4 —— 数据流创建，数据点上传2.5 Step5 —— 数据流展示，查看数据点3. MQTT API3.1 新增设备3.2 注册设备3.3 更新设备信息3.4 查询设备详情3.5 批量...
使用MQTT连接onenet云平台（一 connect）
werqrrwq的博客
04-09 8845
使用网络调试助手连接onenet云平台
基于MQTT协议谈谈物联网开发
weixin_33912638的博客
06-07 273
1.MQTT协议: MQTT(Message Queuing Telemetry Transport,消息队列遥测传输协议),是一种基于TCP/IP实现发布/订阅模式的应用层协议,其主要特点有: (1)基于发布/订阅模式,应用程序解耦; (2)基于TCP/IP建立网络连接; (3)协议交换最小化,降低网络流量; 2.基于MQTT协议应用: (1)简单的发布订阅应用: ...
MQTT&OneNet;
08-02
MQTT&OneNet;，更清楚的了解MQTT协议，助你腾飞在物联网之路
MQTT接入ONENET控制继电器
02-01
本项目基于ardiuno接入onenet，请事先搭建好ardiuno开发环境。 修改代码中的设备id，产品id，apikey，wifi的id和密码。 根据个人情况修改以上内容 ==================================== 接入了siri通过声控控制开关 通过以下地址添加捷径。 https://www.icloud.com/shortcuts/c83d5df4dbd045edb560186a84174e68
阿里云IoT物联网平台 MQTT 2路开关+2路数据_MQTT协议_mqtt_物联网开关_阿里云iot实例_物联网云平台
09-11
- **并行数据流**：2路数据意味着设备可以同时传输两组不同的信息，比如除了温湿度，还可以包括光照强度或空气质量等其他环境参数。 - **多主题订阅**：设备可以订阅多个主题，从而接收来自云端的多路数据，比如...
【物联网平台篇9】使用MQTT上传图片到OneNET
01-20
在物联网领域，OneNET是一个广泛使用的云...如果你对MQTT协议不熟悉，可以先阅读相关的接入教程，如《OneNET物联网MQTT协议接入(下)——上传数据点》。同时，加入相关的技术交流群也是获取帮助和解决问题的有效途径。
[190]-EC200u-cn-4G模块连接OneNet通过MQTT协议上传GPS数据.pdf
10-09
为了完成地图数据的显示，所采集的GPS数据通过内置的MQTT协议指令上传至OneNet平台，并最终与百度地图集成以展示位置信息。 二、OneNet平台产品与设备的创建 1. 创建产品：用户需要通过MQTT物联网套件创建一个产品...
2023年最新的OneNet版本使用介绍(MQTT协议)
05-04 1万+
OneNet在2023年4月23日，对NB-IoT套件、MQTT套件、和物生活平台进行融合升级，升级后的新版OneNET物联网开放平台将通过统一的入口。 之前写的教程里都是以原旧版本的MQTT套件为主，现在升级新版本之后，之前的教程截图就不适用了。很多小伙伴不知道新版本的OneNet如何使用，当前文章就以汽车行驶数据采集项目为例，介绍新版本的OneNet平台如何使用。
基于Arduino的ESP8266连接OneNET云平台（MQTT协议 物模型）（一）ESP8266固件烧录
最新发布
qq_35540725的博客
04-07 1151
本系列将以0基础新手视角，完整演示Arduino+ESP8266连接OneNET云平台的全流程，涵盖ESP8266固件烧录、物模型的模型设计、MQTT协议配置及代码实现。建议搭配Arduino IDE 2.0+和Arduino开发板使用。（一）本文为ESP8266固件烧录本文搭建了 基于Arduino的ESP8266连接OneNET云平台（MQTT协议 物模型）的基础环境，下篇文章将讲解对应的Arduino代码。
OneNET添加触发器如何测试
qq_29072049的博客
07-19 3138
你要先搭建一个收消息的服务器 那个url就是你搭的服务器的地址 或者你可以用邮箱测试 把那个url换成你的邮箱 你要先创建数据流模板 第二步创建触发器 第三步测试   这样就完成了     ...
esp01s连接最新版onenet
01-09
根据提供的引用内容，以下是连接ESP01S到最新版OneNet的步骤： 1. 打开OneNet的网址：https://open.iot.10086.cn/，注册一个账号。 2. 点击控制台，然后点击切换到旧版。 3. 在左侧菜单中找到并点击"多协议接入"。 4. 在多协议接入页面中，选择HTTP协议。 5. 点击添加产品，选择一个产品名和产品行业，然后点击确定。 6. 在设备列表中添加ESP01S设备，填写相关信息，然后点击确定。 请注意，以上步骤是根据提供的引用内容进行的推测，具体步骤可能会有所不同。建议参考OneNet的官方文档或教程以获取更准确的步骤和详细说明。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

DS小龙哥

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值