大家好，我是麦鸽，在工业自动化、物联网设备开发中，Modbus 协议凭借其简单可靠的特点，成为设备通信的常用标准。
然而，在资源受限的嵌入式系统中，如何高效实现 Modbus 协议往往是一大挑战。
本文将介绍一款专为嵌入式设计的轻量级 C 语言库——nanoModbus，帮助开发者快速构建稳定高效的 Modbus 通信功能。
项目首页
项目地址：https://github.com/debevv/nan...
一、为什么需要 nanoModbus？
传统 Modbus 库往往功能庞大，占用较多内存和计算资源，难以在微控制器等硬件资源有限的环境中运行。nanoModbus 应运而生，其核心设计理念是精简高效：
- 代码量极小：仅约 2000 行代码，核心功能无冗余。
- 零动态内存分配：避免内存泄漏风险，适合实时系统。
- 模块化设计：可禁用客户端/服务端代码，按需裁剪功能。
- 跨平台支持：仅依赖 C99 标准库，轻松移植到各类硬件。
二、核心功能一览
- 协议支持全面
- 传输模式：RTU（串口）和 TCP（网络）双支持。
- 角色支持：客户端（主站）和服务端（从站）可独立启用。
- 功能码覆盖：包含读线圈（01）、读寄存器（03/04）、写单寄存器（06）、批量写（15/16）等常用功能，甚至支持文件记录读写（20/21）和设备识别（43/14）等高级操作。
- 性能优化设计
- 用户自定义 CRC 计算：允许替换高效硬件加速实现。
- 超时机制灵活：支持字节级超时设置，适应不同网络环境。
- 广播通信支持：满足群控设备场景需求。
三、快速上手示例
以下通过一个 TCP 客户端示例，展示如何用 nanoModbus 实现寄存器读写：
#include "nanomodbus.h"
// 自定义平台读写函数（需开发者实现）
int32_t my_transport_read(uint8_t* buf, uint16_t count, int32_t timeout_ms, void* conn) {
return tcp_read((SocketHandle)conn, buf, count, timeout_ms);
}
int32_t my_transport_write(const uint8_t* buf, uint16_t count, int32_t timeout_ms, void* conn) {
return tcp_write((SocketHandle)conn, buf, count, timeout_ms);
}
int main() {
// 1. 初始化平台配置
nmbs_platform_conf platform_conf;
nmbs_platform_conf_create(&platform_conf);
platform_conf.transport = NMBS_TRANSPORT_TCP;
platform_conf.read = my_transport_read;
platform_conf.write = my_transport_write;
platform_conf.arg = tcp_connect("192.168.1.100", 502); // 连接Modbus服务端
// 2. 创建客户端实例
nmbs_t nmbs;
nmbs_client_create(&nmbs, &platform_conf);
// 3. 批量写入2个寄存器（地址26）
uint16_t write_data[2] = {123, 124};
nmbs_write_multiple_registers(&nmbs, 26, 2, write_data);
// 4. 读取验证
uint16_t read_data[2];
nmbs_read_holding_registers(&nmbs, 26, 2, read_data);
tcp_close(platform_conf.arg);
return0;
}通过四步操作即可完成通信流程，代码简洁易维护。
四、集成与安装
nanoModbus 提供两种集成方式：
- 手动集成
直接将 nanomodbus.c 和 nanomodbus.h 加入项目，适用于小型工程。 - CMake 集成（推荐）
通过 CMake 自动拉取仓库并链接库文件：
include(FetchContent)
FetchContent_Declare(
nanomodbus
GIT_REPOSITORY https://github.com/debevv/nanoMODBUS
GIT_TAG master
)
FetchContent_MakeAvailable(nanomodbus)
target_link_libraries(your_project nanomodbus)五、平台适配指南
nanoModbus 通过平台函数抽象实现跨平台，开发者需实现两个关键函数：
// 从串口/TCP读取数据
int32_t your_read_func(uint8_t* buf, uint16_t count, int32_t timeout_ms, void* arg);
// 向串口/TCP写入数据
int32_t your_write_func(const uint8_t* buf, uint16_t count, int32_t timeout_ms, void* arg);- 超时处理：函数需严格遵循超时参数（毫秒），timeout_ms < 0 表示无限等待，=0 表示非阻塞。
- 错误处理：返回实际读写的字节数，负数表示错误。
六、高级优化技巧
- 代码裁剪
通过宏定义禁用不需要的功能，如 NMBS_CLIENT_DISABLED 可移除客户端代码，进一步减小体积。
- 调试支持
定义 NMBS_DEBUG 宏可打印通信报文，便于排查问题。
- 超时设置
使用 nmbs_set_read_timeout() 针对不同网络环境调整超时阈值，提升通信稳定性。
七、总结
通过本文的介绍，希望您能快速掌握 nanoModbus 的核心能力，为您的嵌入式项目增添高效通信支持。
END
作者：麦鸽
来源：小麦大叔
推荐阅读
欢迎大家点赞留言，更多 Arm 技术文章动态请关注极术社区嵌入式客栈专栏欢迎添加极术小姐姐微信（id:aijishu20)加入技术交流群，请备注研究方向。
