freeModbus代碼庫的代碼閱讀和移植的學習筆記說明

　　freeModbus的代碼庫還是很好用的，本人在wince和C8051F410下均移植成功（只用到RTU模式）。但freeModbus提供的文檔比較少，只能對照著Modbus協(xié)議一點點試著讀懂源代碼。下面是閱讀代碼期間的跟蹤筆記：

　　1、eMBErrorCode為枚舉類型變量，代表錯誤碼，共有8個錯誤代號。常用的是MB_ENOERR，即沒有錯誤。

　　2、eMBMode枚舉類型變量代表設備的工作模式，分別是MB_RTU、MB_ASCII和MB_TCP。

　　3、eMBEventType枚舉類型變量定義了event的類型，分別是EV_READY，代表Startup啟動完成；EV_FRAME_RECEIVED代表接收到幀；EV_EXECUTE代表執(zhí)行功能函數；EV_FRAME_SENT代表幀已發(fā)送。

　　4、eMBParity枚舉類型變量代表奇偶校驗選項，分別是MB_PAR_NONE無校驗，MB_PAR_ODD奇校驗，和MB_PAR_EVEN偶校驗。

　　5、mb.c文件中的靜態(tài)變量ucMBAddress存儲設備地址，此變量在eMBInit函數中初始化。

　　6、在C51Modbus中將freeModbus庫中的源碼進行了更改，例如盡量不使用函數指針，而是直接調用相關功能函數，根據 eMBCurrentMode中的工作模式，來判斷調用哪個函數。在freeModbus庫中某些函數聲明前加上reentrant，這是Keil編譯器特有的關鍵詞。這樣做帶來的一個不足是：不能動態(tài)綁定函數，從而導致庫代碼失去可移植性。這樣做是C51編譯器與ANSI標準不兼容的特殊性導致的。

　　7、ENTER_CRITICAL_SECTION（）和EXIT_CRITICAL_SECTION（）宏，實際上就是關閉和打開全局中斷。

　　8、帶xMBPort前綴的函數都屬于port layer層，也就是獨立于ModBus協(xié)議棧。

　　9、freeModbus庫中函數名稱的第一個字母表示返回值類型，例如e表示返回enum枚舉類型；v表示void無返回值；x表示BOOL布爾類型。注意這條規(guī)則并不是總成立，但主要函數基本上還是符合此規(guī)則的。第一個字母后的MB代表是屬于ModBus協(xié)議棧的函數。