Loading...
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 | #ifndef I2C_EXPORT_H #define I2C_EXPORT_H /**************************************************** * * Copyright Motrola 1999 * ****************************************************/ /* These are the defined return values for the I2C_do_transaction function. * Any non-zero value indicates failure. Failure modes can be added for * more detailed error reporting. */ typedef enum _i2c_status { I2C_SUCCESS = 0, I2C_ERROR, } I2C_Status; /* These are the defined tasks for I2C_do_transaction. * Modes for SLAVE_RCV and SLAVE_XMIT will be added. */ typedef enum _i2c_transaction_mode { I2C_MASTER_RCV = 0, I2C_MASTER_XMIT = 1, } I2C_TRANSACTION_MODE; typedef enum _i2c_interrupt_mode { I2C_INT_DISABLE = 0, I2C_INT_ENABLE = 1, } I2C_INTERRUPT_MODE; typedef enum _i2c_stop { I2C_NO_STOP = 0, I2C_STOP = 1, } I2C_STOP_MODE; typedef enum _i2c_restart { I2C_NO_RESTART = 0, I2C_RESTART = 1, } I2C_RESTART_MODE; /******************** App. API ******************** * The application API is for user level application * to use the functionality provided by I2C driver. * This is a "generic" I2C interface, it should contain * nothing specific to the Kahlua implementation. * Only the generic functions are exported by the library. * * Note: Its App.s responsibility to swap the data * byte. In our API, we just transfer whatever * we are given **************************************************/ /* Initialize I2C unit with the following: * driver's slave address * interrupt enabled * optional pointer to application layer print function * * These parameters may be added: * desired clock rate * digital filter frequency sampling rate * * This function must be called before I2C unit can be used. */ extern I2C_Status I2C_Initialize( unsigned char addr, /* driver's I2C slave address */ I2C_INTERRUPT_MODE en_int, /* 1 - enable I2C interrupt * 0 - disable I2C interrupt */ int (*app_print_function)(char *,...)); /* pointer to optional "printf" * provided by application */ /* Perform the given I2C transaction, only MASTER_XMIT and MASTER_RCV * are implemented. Both are only in polling mode. * * en_int controls interrupt/polling mode * act is the type of transaction * addr is the I2C address of the slave device * len is the length of data to send or receive * buffer is the address of the data buffer * stop = I2C_NO_STOP, don't signal STOP at end of transaction * I2C_STOP, signal STOP at end of transaction * retry is the timeout retry value, currently ignored * rsta = I2C_NO_RESTART, this is not continuation of existing transaction * I2C_RESTART, this is a continuation of existing transaction */ extern I2C_Status I2C_do_transaction( I2C_INTERRUPT_MODE en_int, I2C_TRANSACTION_MODE act, unsigned char i2c_addr, unsigned char data_addr, int len, char *buffer, I2C_STOP_MODE stop, int retry, I2C_RESTART_MODE rsta); #endif |