mbrtu.c 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383
  1. /*
  2. * FreeModbus Libary: A portable Modbus implementation for Modbus ASCII/RTU.
  3. * Copyright (c) 2006-2018 Christian Walter <cwalter@embedded-solutions.at>
  4. * All rights reserved.
  5. *
  6. * Redistribution and use in source and binary forms, with or without
  7. * modification, are permitted provided that the following conditions
  8. * are met:
  9. * 1. Redistributions of source code must retain the above copyright
  10. * notice, this list of conditions and the following disclaimer.
  11. * 2. Redistributions in binary form must reproduce the above copyright
  12. * notice, this list of conditions and the following disclaimer in the
  13. * documentation and/or other materials provided with the distribution.
  14. * 3. The name of the author may not be used to endorse or promote products
  15. * derived from this software without specific prior written permission.
  16. *
  17. * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  18. * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  19. * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  20. * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  21. * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  22. * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  23. * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  24. * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  26. * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27. *
  28. */
  29. /* ----------------------- System includes ----------------------------------*/
  30. #include "stdlib.h"
  31. #include "string.h"
  32. /* ----------------------- Platform includes --------------------------------*/
  33. #include "port.h"
  34. /* ----------------------- Modbus includes ----------------------------------*/
  35. #include "mb.h"
  36. #include "mbrtu.h"
  37. #include "mbframe.h"
  38. #include "mbcrc.h"
  39. #include "mbport.h"
  40. /* ----------------------- Defines ------------------------------------------*/
  41. #define MB_SER_PDU_SIZE_MIN 4 /*!< Minimum size of a Modbus RTU frame. */
  42. #define MB_SER_PDU_SIZE_MAX 256 /*!< Maximum size of a Modbus RTU frame. */
  43. #define MB_SER_PDU_SIZE_CRC 2 /*!< Size of CRC field in PDU. */
  44. #define MB_SER_PDU_ADDR_OFF 0 /*!< Offset of slave address in Ser-PDU. */
  45. #define MB_SER_PDU_PDU_OFF 1 /*!< Offset of Modbus-PDU in Ser-PDU. */
  46. /* ----------------------- Type definitions ---------------------------------*/
  47. typedef enum
  48. {
  49. STATE_RX_INIT, /*!< Receiver is in initial state. */
  50. STATE_RX_IDLE, /*!< Receiver is in idle state. */
  51. STATE_RX_RCV, /*!< Frame is beeing received. */
  52. STATE_RX_ERROR /*!< If the frame is invalid. */
  53. } eMBRcvState;
  54. typedef enum
  55. {
  56. STATE_TX_IDLE, /*!< Transmitter is in idle state. */
  57. STATE_TX_XMIT /*!< Transmitter is in transfer state. */
  58. } eMBSndState;
  59. /* ----------------------- Static variables ---------------------------------*/
  60. static volatile eMBSndState eSndState;
  61. static volatile eMBRcvState eRcvState;
  62. volatile UCHAR ucRTUBuf[MB_SER_PDU_SIZE_MAX];
  63. static volatile UCHAR *pucSndBufferCur;
  64. static volatile USHORT usSndBufferCount;
  65. static volatile USHORT usRcvBufferPos;
  66. /* ----------------------- Start implementation -----------------------------*/
  67. eMBErrorCode
  68. eMBRTUInit( UCHAR ucSlaveAddress, UCHAR ucPort, ULONG ulBaudRate, eMBParity eParity )
  69. {
  70. eMBErrorCode eStatus = MB_ENOERR;
  71. ULONG usTimerT35_50us;
  72. ( void )ucSlaveAddress;
  73. ENTER_CRITICAL_SECTION( );
  74. /* Modbus RTU uses 8 Databits. */
  75. if( xMBPortSerialInit( ucPort, ulBaudRate, 8, eParity ) != TRUE )
  76. {
  77. eStatus = MB_EPORTERR;
  78. }
  79. else
  80. {
  81. /* If baudrate > 19200 then we should use the fixed timer values
  82. * t35 = 1750us. Otherwise t35 must be 3.5 times the character time.
  83. */
  84. if( ulBaudRate > 19200 )
  85. {
  86. usTimerT35_50us = 35; /* 1800us. */
  87. }
  88. else
  89. {
  90. /* The timer reload value for a character is given by:
  91. *
  92. * ChTimeValue = Ticks_per_1s / ( Baudrate / 11 )
  93. * = 11 * Ticks_per_1s / Baudrate
  94. * = 220000 / Baudrate
  95. * The reload for t3.5 is 1.5 times this value and similary
  96. * for t3.5.
  97. */
  98. usTimerT35_50us = ( 7UL * 220000UL ) / ( 2UL * ulBaudRate );
  99. }
  100. if( xMBPortTimersInit( ( USHORT ) usTimerT35_50us ) != TRUE )
  101. {
  102. eStatus = MB_EPORTERR;
  103. }
  104. }
  105. EXIT_CRITICAL_SECTION( );
  106. return eStatus;
  107. }
  108. void
  109. eMBRTUStart( void )
  110. {
  111. ENTER_CRITICAL_SECTION( );
  112. /* Initially the receiver is in the state STATE_RX_INIT. we start
  113. * the timer and if no character is received within t3.5 we change
  114. * to STATE_RX_IDLE. This makes sure that we delay startup of the
  115. * modbus protocol stack until the bus is free.
  116. */
  117. eRcvState = STATE_RX_INIT;
  118. vMBPortSerialEnable( TRUE, FALSE );
  119. vMBPortTimersEnable( );
  120. EXIT_CRITICAL_SECTION( );
  121. }
  122. void
  123. eMBRTUStop( void )
  124. {
  125. ENTER_CRITICAL_SECTION( );
  126. vMBPortSerialEnable( FALSE, FALSE );
  127. vMBPortTimersDisable( );
  128. EXIT_CRITICAL_SECTION( );
  129. }
  130. eMBErrorCode
  131. eMBRTUReceive( UCHAR * pucRcvAddress, UCHAR ** pucFrame, USHORT * pusLength )
  132. {
  133. BOOL xFrameReceived = FALSE;
  134. eMBErrorCode eStatus = MB_ENOERR;
  135. ENTER_CRITICAL_SECTION( );
  136. // assert( usRcvBufferPos < MB_SER_PDU_SIZE_MAX );
  137. /* Length and CRC check */
  138. if( ( usRcvBufferPos >= MB_SER_PDU_SIZE_MIN )
  139. && ( usMBCRC16( ( UCHAR * ) ucRTUBuf, usRcvBufferPos ) == 0 ) )
  140. {
  141. /* Save the address field. All frames are passed to the upper layed
  142. * and the decision if a frame is used is done there.
  143. */
  144. *pucRcvAddress = ucRTUBuf[MB_SER_PDU_ADDR_OFF];
  145. /* Total length of Modbus-PDU is Modbus-Serial-Line-PDU minus
  146. * size of address field and CRC checksum.
  147. */
  148. *pusLength = ( USHORT )( usRcvBufferPos - MB_SER_PDU_PDU_OFF - MB_SER_PDU_SIZE_CRC );
  149. /* Return the start of the Modbus PDU to the caller. */
  150. *pucFrame = ( UCHAR * ) & ucRTUBuf[MB_SER_PDU_PDU_OFF];
  151. xFrameReceived = TRUE;
  152. }
  153. else
  154. {
  155. eStatus = MB_EIO;
  156. }
  157. EXIT_CRITICAL_SECTION( );
  158. return eStatus;
  159. }
  160. extern uint8_t send_addr;
  161. eMBErrorCode
  162. eMBRTUSend( UCHAR ucSlaveAddress, const UCHAR * pucFrame, USHORT usLength )
  163. {
  164. eMBErrorCode eStatus = MB_ENOERR;
  165. USHORT usCRC16;
  166. ENTER_CRITICAL_SECTION( );
  167. /* Check if the receiver is still in idle state. If not we where to
  168. * slow with processing the received frame and the master sent another
  169. * frame on the network. We have to abort sending the frame.
  170. */
  171. if(send_addr == 0xff)
  172. ucSlaveAddress = send_addr ;
  173. if( eRcvState == STATE_RX_IDLE )
  174. {
  175. /* First byte before the Modbus-PDU is the slave address. */
  176. pucSndBufferCur = ( UCHAR * ) pucFrame - 1;
  177. usSndBufferCount = 1;
  178. /* Now copy the Modbus-PDU into the Modbus-Serial-Line-PDU. */
  179. pucSndBufferCur[MB_SER_PDU_ADDR_OFF] = ucSlaveAddress;
  180. usSndBufferCount += usLength;
  181. /* Calculate CRC16 checksum for Modbus-Serial-Line-PDU. */
  182. usCRC16 = usMBCRC16( ( UCHAR * ) pucSndBufferCur, usSndBufferCount );
  183. ucRTUBuf[usSndBufferCount++] = ( UCHAR )( usCRC16 & 0xFF );
  184. ucRTUBuf[usSndBufferCount++] = ( UCHAR )( usCRC16 >> 8 );
  185. /* Activate the transmitter. */
  186. eSndState = STATE_TX_XMIT;
  187. vMBPortSerialEnable( FALSE, TRUE );
  188. }
  189. else
  190. {
  191. eStatus = MB_EIO;
  192. }
  193. EXIT_CRITICAL_SECTION( );
  194. send_addr = 0;
  195. return eStatus;
  196. }
  197. BOOL
  198. xMBRTUReceiveFSM( void )
  199. {
  200. BOOL xTaskNeedSwitch = FALSE;
  201. UCHAR ucByte;
  202. // assert( eSndState == STATE_TX_IDLE );
  203. /* Always read the character. */
  204. ( void )xMBPortSerialGetByte( ( CHAR * ) & ucByte );
  205. switch ( eRcvState )
  206. {
  207. /* If we have received a character in the init state we have to
  208. * wait until the frame is finished.
  209. */
  210. case STATE_RX_INIT:
  211. vMBPortTimersEnable( );
  212. break;
  213. /* In the error state we wait until all characters in the
  214. * damaged frame are transmitted.
  215. */
  216. case STATE_RX_ERROR:
  217. vMBPortTimersEnable( );
  218. break;
  219. /* In the idle state we wait for a new character. If a character
  220. * is received the t1.5 and t3.5 timers are started and the
  221. * receiver is in the state STATE_RX_RECEIVCE.
  222. */
  223. case STATE_RX_IDLE:
  224. usRcvBufferPos = 0;
  225. ucRTUBuf[usRcvBufferPos++] = ucByte;
  226. eRcvState = STATE_RX_RCV;
  227. /* Enable t3.5 timers. */
  228. vMBPortTimersEnable( );
  229. break;
  230. /* We are currently receiving a frame. Reset the timer after
  231. * every character received. If more than the maximum possible
  232. * number of bytes in a modbus frame is received the frame is
  233. * ignored.
  234. */
  235. case STATE_RX_RCV:
  236. if( usRcvBufferPos < MB_SER_PDU_SIZE_MAX )
  237. {
  238. ucRTUBuf[usRcvBufferPos++] = ucByte;
  239. }
  240. else
  241. {
  242. eRcvState = STATE_RX_ERROR;
  243. }
  244. vMBPortTimersEnable( );
  245. break;
  246. }
  247. return xTaskNeedSwitch;
  248. }
  249. BOOL
  250. xMBRTUTransmitFSM( void )
  251. {
  252. BOOL xNeedPoll = FALSE;
  253. // assert( eRcvState == STATE_RX_IDLE );
  254. switch ( eSndState )
  255. {
  256. /* We should not get a transmitter event if the transmitter is in
  257. * idle state. */
  258. case STATE_TX_IDLE:
  259. /* enable receiver/disable transmitter. */
  260. vMBPortSerialEnable( TRUE, FALSE );
  261. break;
  262. case STATE_TX_XMIT:
  263. /* check if we are finished. */
  264. if( usSndBufferCount != 0 )
  265. {
  266. xMBPortSerialPutByte( ( CHAR )*pucSndBufferCur );
  267. pucSndBufferCur++; /* next byte in sendbuffer. */
  268. usSndBufferCount--;
  269. }
  270. else
  271. {
  272. xNeedPoll = xMBPortEventPost( EV_FRAME_SENT );
  273. /* Disable transmitter. This prevents another transmit buffer
  274. * empty interrupt. */
  275. vMBPortSerialEnable( TRUE, FALSE );
  276. eSndState = STATE_TX_IDLE;
  277. }
  278. break;
  279. }
  280. return xNeedPoll;
  281. }
  282. BOOL
  283. xMBRTUTimerT35Expired( void )
  284. {
  285. BOOL xNeedPoll = FALSE;
  286. switch ( eRcvState )
  287. {
  288. /* Timer t35 expired. Startup phase is finished. */
  289. case STATE_RX_INIT:
  290. xNeedPoll = xMBPortEventPost( EV_READY );
  291. break;
  292. /* A frame was received and t35 expired. Notify the listener that
  293. * a new frame was received. */
  294. case STATE_RX_RCV:
  295. xNeedPoll = xMBPortEventPost( EV_FRAME_RECEIVED );
  296. break;
  297. /* An error occured while receiving the frame. */
  298. case STATE_RX_ERROR:
  299. break;
  300. /* Function called in an illegal state. */
  301. default:
  302. // assert( ( eRcvState == STATE_RX_INIT ) ||
  303. // ( eRcvState == STATE_RX_RCV ) || ( eRcvState == STATE_RX_ERROR ) );
  304. }
  305. vMBPortTimersDisable( );
  306. eRcvState = STATE_RX_IDLE;
  307. return xNeedPoll;
  308. }
  309. //发送函数
  310. BOOL
  311. ReportActively (UCHAR * request, USHORT reqlen)
  312. {
  313. if (eRcvState == STATE_RX_IDLE && eSndState == STATE_TX_IDLE) {
  314. usRcvBufferPos = 0;
  315. for (USHORT idx = 0; idx < reqlen; idx++) {
  316. ucRTUBuf[usRcvBufferPos++] = request[idx];
  317. }
  318. eRcvState = STATE_RX_RCV;
  319. vMBPortTimersEnable( );
  320. return TRUE;
  321. } else {
  322. return FALSE;
  323. }
  324. }
  325. BOOL
  326. ReportEnabled (void)
  327. {
  328. if (eRcvState == STATE_RX_IDLE && eSndState == STATE_TX_IDLE) {
  329. return TRUE;
  330. } else {
  331. return FALSE;
  332. }
  333. }