freeModbus代码库的代码阅读和移植的学习笔记说明

　　freeModbus的代码库还是很好用的，本人在wince和C8051F410下均移植成功（只用到RTU模式）。但freeModbus提供的文档比较少，只能对照着Modbus协议一点点试着读懂源代码。下面是阅读代码期间的跟踪笔记：

　　1、eMBErrorCode为枚举类型变量，代表错误码，共有8个错误代号。常用的是MB_ENOERR，即没有错误。

　　2、eMBMode枚举类型变量代表设备的工作模式，分别是MB_RTU、MB_ASCII和MB_TCP。

　　3、eMBEventType枚举类型变量定义了event的类型，分别是EV_READY，代表Startup启动完成；EV_FRAME_RECEIVED代表接收到帧；EV_EXECUTE代表执行功能函数；EV_FRAME_SENT代表帧已发送。

　　4、eMBParity枚举类型变量代表奇偶校验选项，分别是MB_PAR_NONE无校验，MB_PAR_ODD奇校验，和MB_PAR_EVEN偶校验。

　　5、mb.c文件中的静态变量ucMBAddress存储设备地址，此变量在eMBInit函数中初始化。

　　6、在C51Modbus中将freeModbus库中的源码进行了更改，例如尽量不使用函数指针，而是直接调用相关功能函数，根据 eMBCurrentMode中的工作模式，来判断调用哪个函数。在freeModbus库中某些函数声明前加上reentrant，这是Keil编译器特有的关键词。这样做带来的一个不足是：不能动态绑定函数，从而导致库代码失去可移植性。这样做是C51编译器与ANSI标准不兼容的特殊性导致的。

　　7、ENTER_CRITICAL_SECTION（）和EXIT_CRITICAL_SECTION（）宏，实际上就是关闭和打开全局中断。

　　8、带xMBPort前缀的函数都属于port layer层，也就是独立于ModBus协议栈。

　　9、freeModbus库中函数名称的第一个字母表示返回值类型，例如e表示返回enum枚举类型；v表示void无返回值；x表示BOOL布尔类型。注意这条规则并不是总成立，但主要函数基本上还是符合此规则的。第一个字母后的MB代表是属于ModBus协议栈的函数。