Rev 522 | Details | Compare with Previous | Last modification | View Log | RSS feed
| Rev | Author | Line No. | Line |
|---|---|---|---|
| 482 | killagreg | 1 | #ifndef __I2C_H |
| 2 | #define __I2C_H |
||
| 3 | |||
| 4 | #include "91x_lib.h" |
||
| 5 | |||
| 6 | // I2C states |
||
| 7 | #define I2C_STATE_UNDEF 0 |
||
| 8 | #define I2C_STATE_IDLE 1 |
||
| 9 | #define I2C_STATE_BUFFBUSY 2 |
||
| 10 | #define I2C_STATE_TX_PENDING 3 |
||
| 11 | #define I2C_STATE_TX_PROGRESS 4 |
||
| 12 | #define I2C_STATE_RX_PENDING 5 |
||
| 13 | #define I2C_STATE_RX_PROGRESS 6 |
||
| 14 | // I2C Errors |
||
| 15 | #define I2C_ERROR_NONE 0 |
||
| 16 | #define I2C_ERROR_UNKNOWN 1 |
||
| 17 | #define I2C_ERROR_NOACK 2 |
||
| 18 | |||
| 19 | // the pointer to the rxbuffer handler function |
||
| 20 | // called by the IRQ routine after all bytes are recieved from slave |
||
| 21 | typedef void (*I2C_pRxHandler_t) (u8* pRxBuffer, u8 RxBufferSize); |
||
| 22 | |||
| 23 | |||
| 24 | typedef struct |
||
| 25 | { |
||
| 26 | u8 State; // bus status |
||
| 27 | u8 Error; // bus error code |
||
| 28 | u32 Timeout; // # time of last transfer |
||
| 29 | u8 *pData; // # data buffer |
||
| 30 | u8 TxBufferSize; // # of bytes to send |
||
| 31 | u8 RxBufferSize; // # of bytes to read |
||
| 32 | u8 Direction; // bus direction |
||
| 33 | u8 SlaveAddr; // slave address |
||
| 34 | u16 VIC_Source; // irq source |
||
| 35 | I2C_pRxHandler_t pRxHandler; // function pointer to call back handler after transfer |
||
| 36 | } __attribute__((packed)) I2C_Bus_t; |
||
| 37 | |||
| 38 | #define I2C_TIMEOUT 500 // 500 ms |
||
| 522 | holgerb | 39 | #define I2C_BUFFER_LEN 200 // define the size of the rx/tx buffer in bytes |
| 482 | killagreg | 40 | |
| 41 | // Retourns pointer to data structure of the selected bus |
||
| 42 | volatile I2C_Bus_t* I2CBus(I2C_TypeDef* I2Cx); |
||
| 43 | |||
| 44 | // initialize the I2C bus |
||
| 45 | void I2CBus_Init(I2C_TypeDef* I2Cx); |
||
| 46 | // deinitialize the I2C bus |
||
| 47 | void I2CBus_Deinit(I2C_TypeDef* I2Cx); |
||
| 48 | // try to allocate the I2C_Buffer within the timeout limit |
||
| 49 | // returns 1 on success |
||
| 50 | u8 I2CBus_LockBuffer(I2C_TypeDef* I2Cx, u32 timeout); |
||
| 51 | // Initiate i2c transmission |
||
| 52 | // A transmission sends first TxBytes from pTxData to slave |
||
| 53 | // and then RxBytes are read from slave to internal buffer |
||
| 54 | // replacing the byte that have been sent. |
||
| 55 | // Then the RxHandler function is called to handle the result. |
||
| 56 | // This function returns imediatly after a start condition in the bus. |
||
| 57 | // returns 1 if a transmission has been started, returns 0 otherwise |
||
| 58 | u8 I2CBus_Transmission(I2C_TypeDef* I2Cx, u8 SlaveAddr, u8* pTxData, u8 TxBytes, I2C_pRxHandler_t pRxHandler, u8 RxBytes); |
||
| 59 | // wait until transmission progess is finished or timeout |
||
| 60 | // returns 1 if no timeout occurs |
||
| 61 | u8 I2CBus_WaitForEndOfTransmission(I2C_TypeDef* I2Cx, u32 timeout); |
||
| 62 | |||
| 63 | #endif // I2C_H |
||
| 64 |