84 lines
2.7 KiB
Markdown
84 lines
2.7 KiB
Markdown
|
||
# mqttclient代码生产工具介绍
|
||
|
||
mqttclient代码生产工具主要是用于配置MQTT的参数，并且生成相应的代码，因为是可视化的配置，极易使用。
|
||
|
||
地址：[https://jiejietop.gitee.io/mqtt/index.html](https://jiejietop.gitee.io/mqtt/index.html)
|
||
|
||
|
||
|
||
与此同时改工具页面还包含了mqttclient的API接口介绍及示例，通过它们就能知道这个工具应该配置了什么内容。
|
||
|
||
|
||
|
||
# 连接参数配置
|
||
|
||
首先连接参数代表着MQTT客户端应该如何连接到服务器，建立MQTT会话应该是如何配置，这些就是连接参数
|
||
|
||
- 与服务器相关的参数有：
|
||
|
||
- 服务器地址。
|
||
|
||
- 服务器端口号。
|
||
|
||
- 服务器CA证书（如果有TLS加密的话）。
|
||
|
||
- 建立MQTT连接需要的参数有：
|
||
|
||
- MQTT协议版本。
|
||
|
||
- 用户名。
|
||
|
||
- 密码。
|
||
|
||
- 客户端ID。
|
||
|
||
- 配置是否清除会话，默认清除会话。
|
||
|
||
- 心跳时间间隔，默认是50秒。
|
||
|
||
- 是否使用遗嘱。
|
||
|
||
- 是否保留遗嘱消息。
|
||
|
||
- 设置遗嘱主题。
|
||
|
||
- 设置遗嘱消息的服务质量等级。
|
||
|
||
- 设置遗嘱消息的内容。
|
||
|
||
- 与与客户端资源相关的配置：
|
||
|
||
- 设置命令的超时，它主要是用于socket读写超时，默认是5000毫秒。
|
||
|
||
- 读缓冲区大小，默认是1024。
|
||
|
||
- 写缓冲区大小，默认是1024。
|
||
|
||
|
||
|
||
# 订阅主题相关的代码配置
|
||
|
||
此配置用于配置MQTT客户端订阅的主题信息，指定订阅主题名字，服务质量等级以及当收到来自这个主题消息时候的回调处理函数（可以为NULL），mqttclient代码生成工具支持动态添加多个主题，满足绝大部分的日常需求。
|
||
|
||
|
||
|
||
# 发布消息相关的代码配置
|
||
|
||
mqttclient代码生成工具支持动态添向多个主题发布消息，满足绝大部分的日常需求。只需指定要发布消息的主题名字、服务质量等级、以及发布的消息内容即可。
|
||
|
||
|
||
|
||
# 生成代码
|
||
|
||
在配置完成后，点击下方的生成代码按钮，即可生成对应的配置代码。当然，你也可以点击导入模板，使用模板默认的配置来生成代码。
|
||
|
||
|
||
|
||
直接将生成的代码复制到你的main.c文件即可编译运行。
|
||
|
||
|
||
**上一篇**：[MQTT通信过程](./mqtt-communication.md)
|
||
|
||
**下一篇**：[mqttclient配置及裁剪工具](./mqtt-config.md)
|