CODESYS-MQTT客户端库使用指南

CODESYS-MQTT客户端库使用指南

项目地址:https://gitcode.com/gh_mirrors/co/CODESYS-MQTT

1. 项目目录结构及介绍

CODESYS-MQTT 是一个专为 CODESYS 开发的MQTT客户端库，支持所有QoS（服务质量）等级。下面是该仓库的基本目录结构及其简介：

• master: 主分支，存放最新的稳定代码。
• doc: 文档目录，包含了集成指导和其他相关技术文档，如 integration.md 详细介绍了如何将此库集成到您的CODESYS项目中。
• LICENSE: 许可证文件，声明了MIT许可协议，说明了代码的使用条件。
• MQTT: 核心库源码目录，每个子目录可能对应不同的版本或功能实现。
  • 如 MQTT 1.2.0.1、MQTT 1.2.0.2 等，表示不同版本的MQTT客户端实现。
• GreatExampleOfAdvantages: 示例项目之一，展示高级用法，可以即刻运行并与 test.mosquitto.org 配合工作。
• README.md: 项目的主要读我文件，提供了快速入门的信息。
• Test*: 多个测试项目，分别针对Windows、Raspberry Pi等平台，并且有带TLS和不带TLS的示例，展示了MQTT接口的使用方法。
• 其他辅助文件和脚本：比如 .gitignore, OSCAT.txt 等。

2. 项目启动文件介绍

虽然没有直接指明特定的“启动文件”，但在实际应用中，您通常从包含主逻辑的CODESYS工程开始。对于这个库的使用，初始化过程通常在您的CODESYS项目中的某个起始点进行，这可能是通过调用类似 MQTTClient_Init 的函数来实现的。具体起始文件依赖于用户的项目结构，但示例项目中的 Main.prg 或类似的程序通常是好的起点，它负责设置MQTT客户端并开始连接到MQTT服务器。

3. 项目的配置文件介绍

配置主要不是通过单独的配置文件完成的，而是通过CODESYS的变量和FB（功能块）参数设置来实现。这意味着配置细节是嵌入在您的CODESYS项目内的。例如，您可能需要通过修改示例项目中的FB实例参数来指定MQTT broker的地址、端口、用户名和密码，以及是否启用TLS等。

如果您希望对MQTT客户端的行为进行更细粒度的控制，这通常涉及在初始化过程中或通过回调函数传递特定配置选项。具体的配置项和它们对应的设置方式需参考 doc/integration.md 文件或在代码内寻找相关FB的文档注释以获取详细信息。

请注意，对于复杂的配置调整，有时候开发者会在CODESYS的应用代码内部创建自己的配置结构体或使用环境变量来管理这些设置，以便于维护和重配置。

CODESYS-MQTT MQTT client library for CODESYS, supporting all QoS 项目地址: https://gitcode.com/gh_mirrors/co/CODESYS-MQTT