{"id":4528,"date":"2020-12-28T04:37:06","date_gmt":"2020-12-28T04:37:06","guid":{"rendered":"http:\/\/fastbitlab.com\/?p=4528"},"modified":"2023-09-07T17:25:02","modified_gmt":"2023-09-07T11:55:02","slug":"stm32-i2c-lecture-41-i2c-adding-interrupt-related-macros-and-interrupt-apis","status":"publish","type":"post","link":"https:\/\/fastbitlab.com\/blog\/stm32-i2c-lecture-41-i2c-adding-interrupt-related-macros-and-interrupt-apis\/","title":{"rendered":"STM32 I2C Lecture 41: I2C adding interrupt related macros and interrupt APIs"},"content":{"rendered":"
\n
\n
\n
\n

 <\/p>\n<\/div>\n

\n

I2C adding interrupt related macros and interrupt APIs<\/span><\/h1>\n
\n
\n
\n

 <\/p>\n

<\/div>\n

 <\/p>\n<\/div>\n<\/div>\n<\/div>\n

\n
\n<\/div>\n

Let\u2019s start implementing non-blocking data communication APIs to send and receive data with IT.<\/span><\/p>\n

Steps:<\/b><\/span><\/p>\n

1. Modify the handle structure of I2C, as shown in below code snippet.<\/span><\/p>\n

\/*<\/span>\r\n*Handle structure for I2Cx peripheral<\/span>\r\n*\/<\/span>\r\ntypedef struct<\/span>\r\n{\r\n   I2C_RegDef_t<\/span> *pI2Cx;<\/span>\r\n   I2C_Config_t<\/span> I2C_Config;\r\n       uint8_t<\/span> *pTxBuffer; \/* !< To store the app. Tx buffer address > *\/<\/span>\r\n       uint8_t<\/span> *pRxBuffer; \/* !< To store the app. Rx buffer address > *\/<\/span>\r\n       uint32_t<\/span> TxLen; \/* !< To store Tx len > *\/<\/span>\r\n       uint32_t<\/span> RxLen; \/* !< To store Tx len > *\/<\/span>\r\n       uint8_t<\/span> TxRxState; \/* !< To store Communication state > *\/<\/span>\r\n       uint8_t<\/span> DevAddr; \/* !< To store slave\/device address > *\/<\/span>\r\n       uint32_t<\/span> RxSize; \/* !< To store Rx size > *\/<\/span>\r\n       uint8_t<\/span> Sr; \/* !< To store repeated start value > *\/<\/span>\r\n}I2C_Handle_t<\/span>;<\/pre>\n
 <\/p>\n
2. Define the application states.<\/span><\/p>\n
\/*<\/span>\r\n* I2C application states<\/span>\r\n*\/<\/span>\r\n#define<\/span> I2C_READY 0\r\n#define<\/span> I2C_BUSY_IN_RX 1\r\n#define<\/span> I2C_BUSY_IN_TX 2<\/pre>\n
Defining application states<\/span><\/p>\n
 <\/p>\n
3. Go to the I2C_driver.h file of the project and create the prototypes, as shown in Figure 3. <\/span><\/p>\n
The parameters of the API will be the same, but the difference is the return type of the API should be uint8_t since these APIs return the application\u2019s state. The application\u2019s state may be ready, busy in transmission, or busy in reception, etc.<\/span><\/p>\n
\"I2C
Figure 3. Creation of prototypes for APIs.<\/span><\/figcaption><\/figure>\n
 <\/p>\n
4. Implement the APIs in the driver source file, as shown in Figure 4.<\/span><\/span><\/p>\n
\"I2C
Figure 4. Implementing the APIs in the driver source file.<\/span><\/figcaption><\/figure>\n
 <\/p>\n
It is necessary to complete a couple of other things before implementing the MasterSendDataIT and MasterReceiveDataIT APIs.<\/span><\/p>\n