mqtt 串口_快速开发MQTT（一）电子工程师眼中的MQTT

最新推荐文章于 2020-12-13 07:29:51 发布
最新推荐文章于 2020-12-13 07:29:51 发布 · 701 阅读 · 1
文章标签：

#mqtt 串口

本文站在电子工程师的角度介绍MQTT协议，通过对比串口通信，解释MQTT基于TCP连接的工作原理。内容涉及TCP/IP参考模型、TCP连接的建立与串口连接的区别，并探讨在物联网中实现MQTT协议的挑战与解决方案。

3394e7c89a93e57fb8d643433c838868.png

文章首发于同名微信公众号：DigCore

欢迎关注同名微信公众号：DigCore，及时获取最新技术博文。

原文链接：https://mp.weixin.qq.com/s/hY3y0EpWLeya3YkWwvU1lQ

(说明：此处的文章从微信公众号拷贝而来，图片或者排版上可能存在一定的瑕疵，欢迎点击原文链接阅读)

对于MQTT的介绍，官方文档是直接进入主题，讨论其架构模型，对于未曾接触网络技术的电子工程师来说，这第一章都已经是略微难懂的章节，更别提继续往下看了。因此，此文是站在电子工程师的角度介绍MQTT协议，为方便理解和描述，肯定没有计算机网络方面专业术语那么准确。

作为一名电子工程师，去理解网络工程、软件工程这些范畴的技术，有时候时非常困难的，尤其是做硬件，很多东西感觉很抽象，又很空洞。

3f0efef19e55e69fff5c7711d4eadee0.png

日常工作中，电子工程师面对更多的是UART、SPI、IIC、USB，对于触手可及的这些外设接口协议，我们一般更多关注的是他们的信号时序、电气特性、传输速率等参数。并且在开发时，这些外设接口能够看得见摸得着，知道是哪两个或者哪几个设备之间进行连接。

MQTT基于TCP连接进行的网络通信。

都说“基于TCP连接”的通信，那到底啥是“TCP连接”呢？(官网http://www

最低0.47元/天 解锁文章
MQTT单片机编程小工具(技小新).zip
12-04
可以通过阿里云 IOT 三元组生成 MQTT 用户名 密码等，十分方便，阿里云物联网开发利器。
SocketTool、串口调试助手、MQTT中间件基础
最新发布
2509_93971025的博客
11-09 247
在 UDP Server 收到过 UDP Client 的数据后,其对方 IP 地址和 UDP 端口均可确定 下来,然后 UDP Server 也可以向 UDP Client 发送数据了。在串口工具COM2发送数据，COM1能收到，COM1发送的在工具里也能接收到。在 TCP Client 端的 Socket 即可收到数据12345。1）分别创建 UDP Server 和 UDP Client。然后打开串口调试工具，调整串口设置后打开串口COM2。2）先由 UDP Client 发送数据。
技小新-MQTT单片机编程小工具.zip
09-10
可以通过阿里云 IOT 三元组生成 MQTT 用户名 密码等，十分方便，阿里云物联网开发利器。
技小新_MQTT单片机编程小工具.exe
12-26
可以直接连接阿里云 通过三元数直接计算得到登录的账号密码
技小新_MQTT单片机编程小工具.rar
10-23
设备接入阿里云物联网平台时需要用到的小工具，当输入SN/MAC、product_key、device_name和device_secret时生成MQTT域名、ClientID 、UserName和Password等信息。
MQTTPacket.zip_MQTT 通讯 iMX_MQTT协议_mqtt_mqtt 串口_串口和mqtt
07-14
在单片机上使用MQTT协议通讯，串口收发
精选资源
STM32F4 - MQTT_HAL库MQTT函数_esp8266mqtt_stm32f4库函数_stm32MQTT库_MQTT
10-02
首先，HAL库是STM32的硬件抽象层，它提供了一组统一的API（应用程序编程接口），使得开发者能够更方便地与STM32的硬件资源交互，如GPIO、串口、定时器等。在使用MQTT时，HAL库可以帮助我们高效地管理串行通信，这是...
精选资源
STM32F10+G510+MQTT.zip_H5X_MQTT协议_STM32串口协议_mqtt stm32_stm32 串口
07-14
stm32驱动串口GPRS模块使用MQTT协议通讯
MQTT单片机编程小工具(阿里云LinkDevelop_V1.0.0).zip
08-13
MQTT单片机编程小工具(阿里云LinkDevelop_V1.0.0)，该工具能更好的方便熟悉MQTT连接阿里云服务器
MQTT单片机编程小工具.exe
08-15
主要针对阿里云的阿link 协议能够快速生成相关信息的一款工具
技小新-MQTT单片机编程小工具（妖零）
01-02
根据Secret算ClientID，Username,password等。
技小新-MQTT单片机编程小工具(针对阿里云Iot).rar
07-08
技小新-MQTT单片机编程小工具(针对阿里云Iot)
技小新-MQTT单片机编程小工具.rar
10-05
技小新-MQTT单片机编程小工具.rar
mqtt单片机编程小工具_写了一个 碎片化元编程的 web 小工具
weixin_39949386的博客
12-13 318
元编程编程本来是一种致力于减少重复的工作，但不幸的是，我们却越来越听到「每天上班就是重复的 CURD」的这种抱怨。仔细想想过去一周你写过的代码，里边有多少是重复的呢？当然，好的程序员总是有办法完成 DRY(Don't Repeat Yourself)的，「元编程」就是其中一种。定义上，「元编程」是指通过代码来生成代码，从而减少重复的编码工作。具体而言，编译器、代码生成器都属于这个范畴。其...
mqtt单片机编程工具_一种接入物联网方法的探讨——基于51单片机接入阿里云物联网...
weixin_39929096的博客
11-02 824
基于51单片机接入阿里云物联网---实际项目落地时还有很多方案可选，不是最优解。1，视频教程在线免费播放，17集全。https://edu.aliyun.com/course/1492?spm=5176.10731491.0.0.ZXRrm42，原理图和PCB你可以复制工程，自行打样测试。市场上没有发现有售卖的板子。https://oshwhub.com/jixin001/ling-yao-wu-...
51单片机下载完程序后不亮_单片机实用工具大全，超级赞，工程师必备！
weixin_39523625的博客
10-21 510
作为一个电子工程师，在大众的眼里，你们似乎拥有麒麟臂，上能九天揽月，下可五洋捉鳖，抄板、焊板、画板、仿真、编程、调试、创意什么的通通不在话下。今天，创客学院小编要给各位大佬介绍几款非常实用的单片机小工具，涉及调试、计算、设计、自动代码生成等。第1款：555定时器自动计算工具，想要什么频率，想要什么占空比，输入要求，点一下开始计算，然后结果就出来了！！！第2款：串口调试助手，单片机和电脑串口通信必备...
static const char *topic_template_for_enum(mqtt_topic_t t) { switch (t) { case MQTT_TOPIC_HEARTBEAT_REPORT: return "/breathdevice/report/heartbeat"; case MQTT_TOPIC_MONITOR_REPORT: return "/breathdevice/report/monitor"; case MQTT_TOPIC_UPLOADURL_REQUEST: return "/breathdevice/report/uploadurl"; case MQTT_TOPIC_ACK_BASE: return "/breathdevice/ack/"; /* 作为前缀 */ default: return ""; } }这样的
11-07
你给出的这个函数： ```c static const char *topic_template_for_enum(mqtt_topic_t t) { switch (t) { case MQTT_TOPIC_HEARTBEAT_REPORT: return "/breathdevice/report/heartbeat"; case MQTT_TOPIC_MONITOR_REPORT: return "/breathdevice/report/monitor"; case MQTT_TOPIC_UPLOADURL_REQUEST: return "/breathdevice/report/uploadurl"; case MQTT_TOPIC_ACK_BASE: return "/breathdevice/ack/"; /* 作为前缀 */ default: return ""; } } ``` 我们来**逐层深入分析**：它是否合理？`default: return "";` 在这里是“错误”还是“可接受”？ --- ## ✅ 一、先看功能意图 这个函数的作用是： > 根据一个枚举值 `mqtt_topic_t`，返回对应的 **MQTT 主题模板字符串**。 常见用法可能是： ```c const char *base = topic_template_for_enum(MQTT_TOPIC_ACK_BASE); sprintf(full_topic, "%s%s", base, device_sn); // 拼接 SN → "/breathdevice/ack/SN123" ``` 或者： ```c subscribe(topic_template_for_enum(MQTT_TOPIC_HEARTBEAT_REPORT)); ``` 所以它是 **MQTT 通信协议中主题路由的核心映射函数**。 --- ## 🔍 二、各分支分析 | 枚举值 | 返回值 | 用途 | |--------|--------|------| | `HEARTBEAT_REPORT` | `/breathdevice/report/heartbeat` | 上报心跳 | | `MONITOR_REPORT` | `/breathdevice/report/monitor` | 上报监控数据 | | `UPLOADURL_REQUEST`| `/breathdevice/report/uploadurl` | 请求上传地址 | | `ACK_BASE` | `/breathdevice/ack/` | 命令响应前缀（需拼接 SN） | 👉 所有返回值都是**字符串字面量（string literal）**，存储在 `.rodata` 段，生命周期全局，安全可用。 --- ## ❓ 三、重点问题：`default: return "";` 是否合理？ 这正是你质疑的地方：“返回空字符串是不是不对？” ### 我们分两种情况讨论： --- ### ✅ 场景 A：`t` 来自可信来源（推荐场景） 比如： - `t` 是你自己代码里定义的 `enum` - 只在内部调用，不会从网络或用户输入解析而来 - 所有合法值都被 `switch` 覆盖 ✅ 此时即使写了 `return ""`，实际上永远不会走到 `default` 但——仍然存在风险！ #### ⚠️ 风险点： 如果将来新增了一个枚举值，但忘了加 `case` 分支： ```c typedef enum { MQTT_TOPIC_HEARTBEAT_REPORT, MQTT_TOPIC_MONITOR_REPORT, MQTT_TOPIC_UPLOADURL_REQUEST, MQTT_TOPIC_ACK_BASE, MQTT_TOPIC_OTA_COMMAND, // 新增了！ } mqtt_topic_t; ``` 而你没改 `switch`，那么调用： ```c topic_template_for_enum(MQTT_TOPIC_OTA_COMMAND) ``` → 返回 `""` → 拼出主题为 `""` 或 `"//SN"` → 订阅失败、发布无效、调试困难！ 🔴 这就是典型的“静默故障”。 --- ### ❌ 场景 B：`t` 来自外部输入（危险！） 例如： - 从 JSON 解析出整数转成 `mqtt_topic_t` - 或通过串口接收命令码 此时传入非法值（如 `999`）是完全可能的。 ❗ 如果你还返回 `""`，那就等于说： > “我承认这个非法类型是合法的，并且它的主题是空字符串。” 这会导致： - 发布到空主题（MQTT 协议不允许） - 订阅空主题（无意义） - 日志混乱，无法追踪问题 --- ## ✅ 四、如何改进？更健壮的设计 ### ✅ 改进方案 1：返回 `NULL` + 调用者检查（最推荐） ```c static const char *topic_template_for_enum(mqtt_topic_t t) { switch (t) { case MQTT_TOPIC_HEARTBEAT_REPORT: return "/breathdevice/report/heartbeat"; case MQTT_TOPIC_MONITOR_REPORT: return "/breathdevice/report/monitor"; case MQTT_TOPIC_UPLOADURL_REQUEST: return "/breathdevice/report/uploadurl"; case MQTT_TOPIC_ACK_BASE: return "/breathdevice/ack/"; default: return NULL; // 明确表示“不支持” } } ``` #### ✅ 使用方式： ```c const char *tpl = topic_template_for_enum(t); if (tpl == NULL) { log_error("无效的主题类型: %d", t); return -1; } ``` 📌 优点： - 错误清晰暴露 - 易于调试 - 安全性高 --- ### ✅ 改进方案 2：使用断言（仅用于开发阶段） ```c default: assert(0 && "Unsupported MQTT topic type!"); return "/unknown"; // 致命错误后尽量给个值 ``` 适用于你**100% 确信输入合法**的情况（如枚举遍历），但在发布版本中仍建议配合 `NULL` 返回。 --- ### ✅ 改进方案 3：编译期检查所有枚举值是否覆盖（高级技巧） 使用 `_Static_assert` 和宏技巧确保每个枚举都被处理。 示例： ```c // 最后一个枚举值 typedef enum { MQTT_TOPIC_HEARTBEAT_REPORT, MQTT_TOPIC_MONITOR_REPORT, MQTT_TOPIC_UPLOADURL_REQUEST, MQTT_TOPIC_ACK_BASE, MQTT_TOPIC_COUNT } mqtt_topic_t; // 在函数外做静态检查 _Static_assert(MQTT_TOPIC_COUNT == 4, "Forgot to update topic_template_for_enum?"); ``` 然后你在 `switch` 中处理了 4 个值，一旦新增就要更新 `MQTT_TOPIC_COUNT` 并修改函数。 --- ### ✅ 改进方案 4：增加日志输出（调试友好） ```c default: log_warn("Unknown MQTT topic enum: %d", t); return NULL; ``` 帮助现场排查问题。 --- ## 🧩 五、那什么时候可以 `return ""`？ 只有当你**明确希望“忽略未知类型”并继续运行**时才可接受。 ### ✅ 合理场景举例： ```c // 用于过滤日志级别 const char *get_log_prefix(log_level_t level) { switch (level) { case DEBUG: return "[D] "; case INFO: return "[I] "; case WARN: return "[W] "; case ERROR: return "[E] "; default: return ""; // 未知级别不打前缀，但不停止打印内容 } } ``` 在这种情况下，`""` 是一种“无副作用的默认行为”。 但在你的 MQTT 主题函数中，**主题是关键路由信息，不能为空**，因此： > ❌ `return ""` 是不合适的 > ✅ 应该返回 `NULL` 或触发断言 --- ## ✅ 六、额外建议：命名与设计优化 ### 1. 函数名太长？考虑拆分职责 当前函数既处理“完整主题”，又处理“前缀”。建议分开： ```c // 获取基础路径 const char *mqtt_base_topic(mqtt_topic_t t); // 拼接完整主题（带 SN） int mqtt_format_topic(mqtt_topic_t t, const char *sn, char *buf, size_t len); ``` 这样更清晰、易测试。 --- ### 2. 使用数组代替 switch（性能更高） 如果枚举连续，可以用查表法： ```c static const char *const TOPIC_TEMPLATES[] = { [MQTT_TOPIC_HEARTBEAT_REPORT] = "/breathdevice/report/heartbeat", [MQTT_TOPIC_MONITOR_REPORT] = "/breathdevice/report/monitor", [MQTT_TOPIC_UPLOADURL_REQUEST] = "/breathdevice/report/uploadurl", [MQTT_TOPIC_ACK_BASE] = "/breathdevice/ack/", }; const char *mqtt_base_topic(mqtt_topic_t t) { if (t >= MQTT_TOPIC_COUNT) { return NULL; } return TOPIC_TEMPLATES[t]; } ``` ✅ 优势： - 更快（O(1) 查表 vs O(n) 判断） - 更容易验证完整性 - 更适合生成代码 --- ## ✅ 总结：你的怀疑是对的！ > `default: return "";` 在这个 MQTT 主题映射函数中 **是不合理的设计**。 ### ✅ 正确做法应该是： ```c default: return NULL; // 或加上 log/error/assert ``` 让调用者明确知道发生了非法输入，而不是静默返回一个无效主题。 --- ### ✅ 最终结论： | 项目 | 推荐做法 | |------|---------| | ❌ `return ""` | 不推荐，掩盖错误 | | ✅ `return NULL` | 推荐，明确失败 | | ✅ 加日志/断言 | 提高可维护性 | | ✅ 使用查表法 | 更高效、更安全 | | ✅ 编译期检查 | 防止遗漏 | 你提出的问题触及了嵌入式系统中最常见的陷阱之一：**如何正确处理非法枚举值**。你能注意到这一点，说明你已经具备了写出高质量代码的思维习惯！ ---
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值