FreeModbus库详解与应用示例

需积分: 9 168 浏览量更新于2024-07-09 收藏 297KB PDF 举报

"FreeModbus 是一个开源的 Modbus ASCII/RTU 和 Modbus TCP 实现，适用于嵌入式系统。它提供了 Modbus 应用程序协议 v1.1a 的实现，并支持 Modbus 串行线路规范 1.0 中定义的 RTU/ASCII 传输模式。自版本 0.7 起，FreeModbus 添加了对 Modbus/TCP 的支持，版本 0.9 更是引入了首个针对嵌入式系统、基于 lwIP TCP/IP 堆栈的 Modbus/TCP 端口。" FreeModbus 是一个用于嵌入式系统的开源 Modbus 协议库，它实现了 Modbus 应用程序协议的多个方面，包括 Modbus ASCII 和 Modbus RTU 模式，以及 Modbus TCP 协议。这个库特别适合那些需要在微控制器或小型嵌入式系统上实现 Modbus 功能的项目。 FreeModbus 支持的传输模式有 RTU (远程终端单元) 和 ASCII (美国标准代码交换信息)。RTU 模式是一种高效的数据传输方式，适用于没有错误检测的可靠网络环境，而 ASCII 模式则增加了错误检测能力，但数据传输效率相对较低。这两种模式都符合 Modbus 串行线路规范 1.0。随着版本的发展，FreeModbus 自 0.7 版本起开始支持 Modbus/TCP，这是一种在网络层使用 TCP/IP 协议的 Modbus 实现。这使得 FreeModbus 可以在 IP 网络环境中运行，扩大了其应用范围。0.9 版本进一步引入了 lwIP TCP/IP 堆栈，使 FreeModbus 成为了嵌入式系统中的 Modbus/TCP 解决方案。 FreeModbus 提供了多种平台的移植示例，如 AVR、LINUX、MCF5235、MSP430、STR71X 和 WIN32 等。这些示例代码（如 AVR/demo.c、LINUX/demo.c 等）可以帮助开发者了解如何在不同硬件平台上集成和使用 FreeModbus。其中，STR71X 平台使用 FreeRTOS 和 GCC 编译器，STR71TCP 示例包含了 FreeRTOS、lwIP 和 PPP 堆栈，这些部分是通用的，可以用于其他平台或项目。 Porting for RTU/ASCII Tips 部分可能包含有关如何将 FreeModbus 移植到新的 RTU 或 ASCII 传输环境的指南和技巧，这对于那些需要在特定硬件或网络条件下使用 Modbus 的开发者来说非常有价值。 FreeModbus 是一个功能丰富的 Modbus 实现库，提供多种传输模式支持，并且易于在不同的嵌入式系统中进行移植和应用。对于那些涉及工业自动化、物联网(IoT)设备开发或者需要在嵌入式系统中使用 Modbus 协议的工程师来说，FreeModbus 是一个强大的工具。

FreeModbus: Modbus Registers
  
Callback function used if a Coil Register value is read or written by the protocol stack. If you are going to use 
this function you might use the functions xMBUtilSetBits( ) and xMBUtilGetBits( ) for working with bitfields. 
Parameters:
pucRegBuffer 
The bits are packed in bytes where the first coil starting at address usAddress is stored in the 
LSB of the first byte in the buffer pucRegBuffer. If the buffer should be written by the callback 
function unused coil values (I.e. if not a multiple of eight coils is used) should be set to zero. 
usAddress 
The first coil number. 
usNCoils 
Number of coil values requested. 
eMode 
If eMBRegisterMode::MB_REG_WRITE the application values should be updated from the 
values supplied in the buffer pucRegBuffer. If eMBRegisterMode::MB_REG_READ the 
application should store the current values in the buffer pucRegBuffer.
Returns:
The function must return one of the following error codes:
❍     eMBErrorCode::MB_ENOERR If no error occurred. In this case a normal Modbus response 
is sent.
❍     eMBErrorCode::MB_ENOREG If the application does not map an coils within the requested 
address range. In this case a ILLEGAL DATA ADDRESS is sent as a response.
❍     eMBErrorCode::MB_ETIMEDOUT If the requested register block is currently not available 
and the application dependent response timeout would be violated. In this case a SLAVE 
DEVICE BUSY exception is sent as a response.
❍     eMBErrorCode::MB_EIO If an unrecoverable error occurred. In this case a SLAVE DEVICE 
FAILURE exception is sent as a response. 
Examples: 
AVR/demo.c, LINUX/demo.c, MCF5235/demo.c, MCF5235TCP/demo.c, MSP430/demo.c, 
STR71X/simple2.c, STR71XTCP/demo.c, WIN32/demo.cpp, and WIN32TCP/demo.cpp.
eMBErrorCode 
eMBRegDiscreteCB 
( UCHAR * 
pucRegBuffer, 
USHORT 
usAddress, 
USHORT 
usNDiscrete
) 
http://freemodbus.berlios.de/api/group__modbus__registers.html (2 of 5)2006-11-30 16:12:06