找回密码
 立即注册

QQ登录

只需一步,快速开始

搜索
查看: 2016|回复: 0
打印 上一主题 下一主题
收起左侧

MQTT协议中文带注释版本下载

[复制链接]
跳转到指定楼层
楼主
来自Xiaoke的翻译的非常好的作品,共享给大家学习,他的Github还有更多项目

MQTT是一个客户端服务端架构的发布/订阅模式的消息传输协议。它的设计思想是轻巧、开放、简单、规范,易于实现。这些特点使得它对很多场景来说都是很好的选择,特别是对于受限的环境如机器与机器的通信(M2M)以及物联网环境(IoT)。
说明
MQTT英文原版协议提供了Word格式和HTML格式,我翻译的时候用的Word文档,之前一直提供的是Word文档转换的HTML和PDF供浏览和下载,最近花时间整理了Markdown版本,可以更方便的分章节在线浏览了,转换为Markdown后部分表格的格式不太对,会逐步用图片代替。
目录
发现任何翻译问题或格式问题欢迎提PR帮忙完善。

说明
前言
目录
第一章    -    MQTT介绍
第二章    –    MQTT控制报文格式
第三章    –    MQTT控制报文
3.1    CONNECT    –    连接服务端
3.2    CONNACK    –    确认连接请求
3.3    PUBLISH    –    发布消息
3.4    PUBACK    –发布确认
3.5    PUBREC    –    发布收到(QoS    2,第一步)
3.6    PUBREL    –    发布释放(QoS    2,第二步)
3.7    PUBCOMP    –    发布完成(QoS    2,第三步)
3.8    SUBSCRIBE    -    订阅主题
3.9    SUBACK    –    订阅确认
3.10    UNSUBSCRIBE    –取消订阅
3.11    UNSUBACK    –    取消订阅确认
3.12    PINGREQ    –    心跳请求
3.13    PINGRESP    –    心跳响应
3.14    DISCONNECT    –断开连接
第四章    –    操作行为
第五章    –    安全
第六章    –    使用WebSocket
第七章    –    一致性目标
附录B    -    强制性规范声明
Github:    https://github.com/mcxiaoke

第一章    概述    Introduction
1.1    MQTT协议的组织结构    Organization    of    MQTT
本规范分为七个章节:
第一章    –    介绍
第二章    –    MQTT控制报文格式
第三章    –    MQTT控制报文
第四章    –    操作行为
第五章    –    安全
第六章    –    使用WebSocket
第七章    –    一致性目标
附录B    –    强制性规范声明
1.2    术语    Terminology
本规范中用到的关键字    必须    MUST,不能    MUST    NOT,要求    REQUIRED,将会    SHALL,不会    SHALL    NOT,应该    SHOULD,不应该    SHOULD    NOT,推荐    RECOMMENDED,可以MAY,可选    OPTIONAL    都是按照    IETF    RFC    2119    [RFC2119]    中的描述解释。
网络连接    Network    Connection
MQTT使用的底层传输协议基础设施。
客户端使用它连接服务端。
它提供有序的、可靠的、双向字节流传输。
例子见4.2节。
应用消息    Application    Message    MQTT协议通过网络传输应用数据。应用消息通过MQTT传
输时,它们有关联的服务质量(QoS)和主题(Topic)。

客户端    Client
使用MQTT的程序或设备。客户端总是通过网络连接到服务端。它可以
发布应用消息给其它相关的客户端。
订阅以请求接受相关的应用消息。
取消订阅以移除接受应用消息的请求。
从服务端断开连接。

服务端    Server
一个程序或设备,作为发送消息的客户端和请求订阅的客户端之间的中介。服务端接受来自客户端的网络连接。
接受客户端发布的应用消息。
处理客户端的订阅和取消订阅请求。
转发应用消息给符合条件的已订阅客户端。

订阅    Subscription
订阅包含一个主题过滤器(Topic    Filter)和一个最大的服务质量(QoS)等级。订阅与单个会话(Session)关联。会话可以包含多于一个的订阅。会话的每个订阅都有一个不同的主题过滤器。
主题名    Topic    Name
附加在应用消息上的一个标签,服务端已知且与订阅匹配。服务端发送应用消息的一个副本给每一个匹配的客户端订阅。
主题过滤器    Topic    Filter
订阅中包含的一个表达式,用于表示相关的一个或多个主题。主题过滤器可以使用通配符。
会话    Session
客户端和服务端之间的状态交互。一些会话持续时长与网络连接一样,另一些可以在客户端和服务端的多个连续网络连接间扩展。
控制报文    MQTT    Control    Packet
通过网络连接发送的信息数据包。MQTT规范定义了十四种不同类型的控制报文,其中一个(PUBLISH报文)用于传输应用消息。

1.5    数据表示    Data    representations
1.5.1    二进制位    Bits
字节中的位从0到7。第7位是最高有效位,第0位是最低有效位。
1.5.2    整数数值    Integer    data    values
整数数值是16位,使用大端序(big-endian,高位字节在低位字节前面)。这意味着一个16位
的字在网络上表示为最高有效字节(MSB),后面跟着最低有效字节(LSB)。
1.5.3    UTF-8编码字符串    UTF-8    encoded    strings
后面会描述的控制报文中的文本字段编码为UTF-8格式的字符串。UTF-8    [RFC3629]    是一个
高效的Unicode字符编码格式,为了支持基于文本的通信,它对ASCII字符的编码做了优化。

UTF-8编码字符串中的字符数据必须是按照Unicode规范    [Unicode]    定义的和在RFC3629
[RFC3629]    中重申的有效的UTF-8格式。特别需要指出的是,这些数据不能包含字符码在U+D800和U+DFFF之间的数据。如果服务端或客户端收到了一个包含无效UTF-8字符的控制报文,它必须关闭网络连接    [MQTT-1.5.3-1]。
UTF-8编码的字符串不能包含空字符U+0000。如果客户端或服务端收到了一个包含U+0000的控制报文,它必须关闭网络连接    [MQTT-1.5.3-2]。
数据中不应该包含下面这些Unicode代码点的编码。如果一个接收者(服务端或客户端)收到了包含下列任意字符的控制报文,它可以关闭网络连接:
U+0001和U+001F之间的控制字符
U+007F和U+009F之间的控制字符
Unicode规范定义的非字符代码点(例如U+0FFFF)
Unicode规范定义的保留字符(例如U+0FFFF)
UTF-8编码序列0XEF    0xBB    0xBF总是被解释为U+FEFF(零宽度非换行空白字符),无论它出现在字符串的什么位置,报文接收者都不能跳过或者剥离它    [MQTT-1.5.3-3]。

完整的pdf格式文档51黑下载地址:
Xiaoke作品: MQTT协议_CN_注释.pdf (3.87 MB, 下载次数: 44)


评分

参与人数 1黑币 +50 收起 理由
admin + 50 共享资料的黑币奖励!

查看全部评分

分享到:  QQ好友和群QQ好友和群 QQ空间QQ空间 腾讯微博腾讯微博 腾讯朋友腾讯朋友
收藏收藏2 分享淘帖 顶 踩
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

小黑屋|51黑电子论坛 |51黑电子论坛6群 QQ 管理员QQ:125739409;技术交流QQ群281945664

Powered by 单片机教程网

快速回复 返回顶部 返回列表