基于RT-Thread移植FreeModbus

平臺：正點原子STM32F407探索者開發板 + FreeModbus V1.6 + RT-Thread

原始碼鏈接：https://www.embedded-solutions.at/en/freemodbus-downloads/

原始碼串列如圖所示，需要的檔案包括modbus檔案夾和demo檔案夾內的port相關檔案，port檔案位置如下圖

在BASE檔案夾內有一個port檔案夾（內含需要的port相關檔案）和一個demo檔案，demo檔案寫好了FreeModbus的啟動使用，

將這些檔案載入到工程中，并包含相關的頭檔案

由于第一次移植，沒敢亂動，直接全部移植進來只開啟了需要的功能，mb開頭的檔案為協議堆疊程式，暫時不必改動；port開頭檔案是需要用戶進行相關配置的檔案，其中 portevent.c 不用動，portserial.c 和 porttimer.c 內部實作串口功能和定時器功能，包括初始化配置以及啟動和關閉，

第一步：配置portserial.c

　　原始碼檔案中portserial.c包含下面幾個函式，大體功能如注釋所述，

 1 void
 2 vMBPortSerialEnable( BOOL xRxEnable, BOOL xTxEnable )//可以根據輸入引數配置RS485收發器的收發模式
 3 {
 4     /* If xRXEnable enable serial receive interrupts. If xTxENable enable
 5      * transmitter empty interrupts.
 6      */

 7 }
 8 
 9 BOOL
10 xMBPortSerialInit( UCHAR ucPORT, ULONG ulBaudRate, UCHAR ucDataBits, eMBParity eParity )
11 {
　　　　//初始化串口 --> 查找串口設備，根據引數配置串口，打開串口設備，設定串口接識訓呼函式等
12     return FALSE;//添加代碼后需要修改為 TRUE
13 }
14 
15 BOOL
16 xMBPortSerialPutByte( CHAR ucByte )
17 {
18     /* Put a byte in the UARTs transmit buffer. This function is called
19      * by the protocol stack if pxMBFrameCBTransmitterEmpty( ) has been
20      * called. */
　　　　//發送一個位元組資料，只需要呼叫發送介面即可

21     return TRUE;
22 }
23 
24 BOOL
25 xMBPortSerialGetByte( CHAR * pucByte )
26 {
27     /* Return the byte in the UARTs receive buffer. This function is called
28      * by the protocol stack after pxMBFrameCBByteReceived( ) has been called.
29      */
　　　　//接收一個位元組資料

30     return TRUE;
31 }
32 
33 /* Create an interrupt handler for the transmit buffer empty interrupt
34  * (or an equivalent) for your target processor. This function should then
35  * call pxMBFrameCBTransmitterEmpty( ) which tells the protocol stack that
36  * a new character can be sent. The protocol stack will then call 
37  * xMBPortSerialPutByte( ) to send the character.
38  */
39 static void prvvUARTTxReadyISR( void )
40 {
　　　　//協議堆疊的發送中斷函式，可以在串口發送中斷里面呼叫它
41     pxMBFrameCBTransmitterEmpty(  );
42 }
43 
44 /* Create an interrupt handler for the receive interrupt for your target
45  * processor. This function should then call pxMBFrameCBByteReceived( ). The
46  * protocol stack will then call xMBPortSerialGetByte( ) to retrieve the
47  * character.
48  */
49 static void prvvUARTRxISR( void )
50 {
　　　　//協議堆疊的接收中斷函式，可以在串口接收中斷里面呼叫它；放在回呼函式即可
51     pxMBFrameCBByteReceived(  );
52 }

第二步：配置porttimer.c

　　原始碼檔案與串口的形式類似，具體如下

 1 BOOL
 2 xMBPortTimersInit( USHORT usTim1Timerout50us )//定時器設備初始化，查找設備，打開設備，配置設備，根據引數設定超時時間
 3 {
 4     return FALSE;//添加代碼后需要改為 TRUE
 5 }
 6 
 7 
 8 inline void
 9 vMBPortTimersEnable(  )//此處理解為定時器的啟動，呼叫該介面即開始定時
10 {
11     /* Enable the timer with the timeout passed to xMBPortTimersInit( ) */
12 }
13 
14 inline void
15 vMBPortTimersDisable(  )//定時器的關閉，我個人使用的單次定時，所以就沒做處理，如果是回圈的需要關閉定時器
16 {
17     /* Disable any pending timers. */
18 }
19 
20 static void prvvTIMERExpiredISR( void )//超時函式，可以放到定時器超時回呼函式中呼叫
21 {
22     ( void )pxMBPortCBTimerExpired(  );
23 }

第三步：配置demo.c檔案

　　該檔案下有有一個main函式，其它函式為不同功能的回呼函式，官方下載的原始碼中main函式和eMBRegInputCB已經實作，可以參考使用，

 1 int
 2 main( void )
 3 {
 4     const UCHAR     ucSlaveID[] = { 0xAA, 0xBB, 0xCC };
 5     eMBErrorCode    eStatus;
 6 
 7     eStatus = eMBInit( MB_RTU, 0x0A, 0, 38400, MB_PAR_EVEN );
 8 
 9     eStatus = eMBSetSlaveID( 0x34, TRUE, ucSlaveID, 3 );
10     sei(  );
11 
12     /* Enable the Modbus Protocol Stack. */
13     eStatus = eMBEnable(  );
14 
15     for( ;; )
16     {
17         ( void )eMBPoll(  );
18 
19         /* Here we simply count the number of poll cycles. */
20         usRegInputBuf[0]++;
21     }
22 }

　　main函式內容實作的是協議堆疊的初始化、啟動和回圈更新，重要的三個函式為eMBInit、eMBEnable、eMBPoll，官方原始碼中作為一個功能回圈使用，在RT-Thread中我把其作為一個獨立任務，在任務函式里進行協議堆疊初始化和啟動，狀態更新作為執行緒回圈，

 1 eMBErrorCode
 2 eMBRegInputCB( UCHAR * pucRegBuffer, USHORT usAddress, USHORT usNRegs )
 3 {
 4     eMBErrorCode    eStatus = MB_ENOERR;
 5     int             iRegIndex;
 6 
 7     if( ( usAddress >= REG_INPUT_START )
 8         && ( usAddress + usNRegs <= REG_INPUT_START + REG_INPUT_NREGS ) )
 9     {
10         iRegIndex = ( int )( usAddress - usRegInputStart );
11         while( usNRegs > 0 )
12         {
13             *pucRegBuffer++ =
14                 ( unsigned char )( usRegInputBuf[iRegIndex] >> 8 );
15             *pucRegBuffer++ =
16                 ( unsigned char )( usRegInputBuf[iRegIndex] & 0xFF );
17             iRegIndex++;
18             usNRegs--;
19         }
20     }
21     else
22     {
23         eStatus = MB_ENOREG;
24     }
25 
26     return eStatus;
27 }
28 
29 eMBErrorCode
30 eMBRegHoldingCB( UCHAR * pucRegBuffer, USHORT usAddress, USHORT usNRegs,
31                  eMBRegisterMode eMode )
32 {
33     return MB_ENOREG;
34 }
35 
36 
37 eMBErrorCode
38 eMBRegCoilsCB( UCHAR * pucRegBuffer, USHORT usAddress, USHORT usNCoils,
39                eMBRegisterMode eMode )
40 {
41     return MB_ENOREG;
42 }
43 
44 eMBErrorCode
45 eMBRegDiscreteCB( UCHAR * pucRegBuffer, USHORT usAddress, USHORT usNDiscrete )
46 {
47     return MB_ENOREG;
48 }

　　這些函式是協議堆疊對應功能的回呼函式，并且給了一個示例，它們由function檔案下的函式呼叫，只需在需要的功能里作出對應實作即可，這些函式的回傳值是特定的形式，參考示例函式進行操作即可，至于相應地址資料的處理根據實際需求，

最后：

　　新手上路，還有很多地方理解不到位，暫時記錄這么多，繼續學習！

標籤：C

上一篇：如何構建B+Tree索引？

下一篇：回爐重造之重讀Windows核心編程-001-錯誤處理