Experience Seamless Communication with WTD I2C Driver

• Example:

    static void Write_Callback(boolean bStatus, void* lpParam) {
        /* Process synchronization via 'test-and-set' intrinsic with
        globally scoped semaphore */
        sem_Set(&global_flag_var, MY_WRITE_FLAG_BIT);
    }
  
    int Write_With_Callback(uint8_t addr) {  
        uint8_t tx_buffer[2];  
        tx_buffer[0] = addr; 
        tx_buffer[1] = 0xaa;  
        return i2cmanager_QueueWriteCb(eI2cBus0, (uint16_t)addr, 2, tx_buffer, Write_Callback, NULL);  
    }
  

• Read

All I2C read functions require a Callback. If a null parameter is passed for lpNotify the request is dumped and failure is retruned form i2cmanager_QueueRead())

Read with callback notification (u8CommandLength = 0u)

int32_t i2cmanager_QueueRead(I2CMGRBus_t bus, uint16_t u16SlaveAddress, uint8_t u8CommandLength, uint8_t u8ReadLength, uint8_t* pu8Buffer, LpI2cCallBack lpNotify, void* lpParam)

The zero value of the u8CommandLength variable signifies that this read operation will not be preceeded by a write operation in the low-level driver to set the slave read address. This presupposes that the slave device has no addressing or a default address or that it retains an internal address set by a previous operation.

Example:

    static __far int32_t handle;
    static __far uint8_t read_buf[2];

    static void Read_MyNotify(boolean bStatus, void* lpParam) {
        if (bStatus == TRUE) {
            /* Copy received data to local global array */
            i2cmanager_GetReceivedData(eI2cBus0, handle, 2, read_buf);
        }
        /* Process synchronization via 'test-and-set' intrinsic with
        globally scoped semaphore */
        sem_Set(&global_flag_var, MY_READ_FLAG_BIT);            
    }

    int Read_With_Callback(uint8_t addr) {   
        handle = i2cmanager_QueueRead(eI2cBus0, (uint16_t)addr, 0, 2, NULL, Read_MyNotify, NULL);
        return handle;  
    }

• Random ReadRead with callback notification (u8CommandLength != 0u)
  

  int32_t i2cmanager_QueueRead(I2CMGRBus_t bus, uint16_t u16SlaveAddress, uint8_t u8CommandLength, uint8_t u8ReadLength, uint8_t* pu8Buffer, LpI2cCallBack lpNotify, void* lpParam)

  The non-zero value of the u8CommandLength variable signifies that this read operation will be preceeded by a write operation in the low-level driver to set the slave read address (write/read turnaround). The following example shows the use of the I2CObjId_t structure for passing information to the notifyFunction.

  Example:

    static __far I2CObjId_t i2c_oid;
    static __far uint8_t read_buf[4];
  
    static void Rnd_Read_Notify(boolean bStatus, void* lpParam) {  
        I2CObjId_t* pParam = ((I2CObjId_t*)lpParam);
  
        if ((bStatus == TRUE) && (pParam != NULL)) {
            /* Copy received data to local global array */
            i2cmanager_GetReceivedData(eI2cBus0, pParam->i32Id, pParam->u8Length, read_buf);
        }
        /* Process synchronization via 'test-and-set' intrinsic with
        globally scoped semaphore */
        sem_Set(&global_flag_var, MY_READ_FLAG_BIT);            
    }
  
    int Random_Read_With_Callback(uint8_t addr, uint16_t dev_addr) {
        uint8_t write_buf[2];
  
        /* Convert 16-bit slave internal address to a byte array */
        write_buf[0] = (uint8_t)(dev_addr >> 8);
        write_buf[1] = (uint8_t)dev_addr;
        i2c_oid.u8Length = sizeof(read_buf);  
        i2c_oid.i32Id = i2cmanager_QueueReadCb(eI2cBus0, (uint16_t)addr, sizeof(write_buf), sizeof(read_buf), write_buf, Rnd_Read_Notify, (void*)&i2c_oid);
        return i2c_oid.i32Id;  
    }