QCC512x QCC302x 使用I2C驱动外设（Bitserial）

QCC512x QCC302x 使用I2C驱动外设（Bitserial）

1、旧接口 I2cTransfer

ADK6.x 版本对 i2c的库进行了重写，在 app 层不能够直接使用 #include <i2c.h> 里面的 API了。

uint16 I2cTransfer(uint16 address, const uint8 * tx, uint16 tx_len, uint8 * rx, uint16 rx_len);

开发底层库的话，依然可以调用 I2cTransfer，需要在 subsys7_config3.htf 指定 I2C pios ，第一个是 SCL、第二个是 SDA。类似于用 PSTool 的设置。

2、新接口 Bitserial

在 app 层调用的话，只能用 Bitserial API，需要包含此头文件 #include <bitserial_api.h>
使用 Bitserial 需要将此宏打开 #if TRAPSET_BITSERIAL，在 <build_defs.h> 该头文件内定义（默认打开）
Bitserial 同时支持 I2C 与 SPI 两种通信。
Bitserial 提供的功能有以下几个，常用为前三个。

API	功能
BitserialOpen	初始化 Bitserial 、分配 PIO（需由硬件控制）; 返回一个打开成功的句柄（通常为1、255是打开失败）
BitserialClose	释放 Bitserial，传入的参数为 Open 返回的句柄
BitserialTransfer	传输函数：用于读与写，对I2C来说，会自动加入地址的读写位
BitserialWrite	写函数，BitserialTransfer 实现，可以不直接使用
BitserialRead	读函数，BitserialTransfer 实现，可以不直接使用
BitserialChangeParam	用于修改 i2C 地址，同一条总线上挂载 2个及以上 I2C 设备时会用到

2.1、I2C 初始化

I2C 初始化分为几步

1. 设置 PIO 由硬件控制；
   PioSetMapPins32Bank(bank, mask, 0);
2. 设置 PIO 功能；
   PioSetFunction(pio,func);
3. 设置 PIO 方向；
   PioSetDir32Bank(bank, mask, 0);
4. 设置 PIO 电平；
   PioSet32Bank(bank, mask, mask);
PioSetStrongBias32Bank(bank, mask, mask);
5. 设置 Bitserial 模式为 I2C；
   bsconfig.mode = BITSERIAL_MODE_I2C_MASTER;
6. 设置 Bitserial 速度；
   bsconfig.clock_frequency_khz = prox->config->i2c_clock_khz;
7. 设置 Bitserial 从地址；
   bsconfig.u.i2c_cfg.i2c_address = I2C_ADDRESS;
8. 调用 BitserialOpen 并返回句柄。
   handle = BitserialOpen((bitserial_block_index)BITSERIAL_BLOCK_1, &bsconfig);

2.2、I2C 读写函数

可以直接调用 BitserialTransfer 来实现 I2C 的写操作。

static uint8 user_i2c_write_byte(bitserial_handle handle, uint8 reg, uint8 value)
{
    uint8 ret;
    uint8 txbuf[2];
    txbuf[0] = reg;
    txbuf[1] = value;
    ret = BitserialTransfer(handle, 0, txbuf, 2, NULL, 0);
    return ret;
}

同时可以实现连续写入多个寄存器操作。

static uint8 user_i2c_write_buffer(bitserial_handle handle, uint8 buffer[], uint16 buflen)
{
    uint8 ret;
    ret = BitserialTransfer(handle, 0, buffer, buflen, NULL, 0);
    return ret;
}

2.3、I2C 读函数

可以直接调用 BitserialTransfer 来实现 I2C 的读操作。

static uint8 user_i2c_read(bitserial_handle handle, uint8 txdat,uint8 rxbuf[], uint8 rxlen)
{
    uint8 ret;
    uint8 txbuf[1];
    txbuf[0] = txdat;
    memset(rxbuf,0,rxlen);
    ret = BitserialTransfer(handle, 0, txbuf, 1, rxbuf, rxlen);
    return ret;
}

3、总结

对比：

API	优点	缺点
<i2c.h>	1.处于更加底层的位置，底层库已经完成好初始化工作，调用的时候只需要在PSTool中选中下IO口，直接使用 I2cTransfer()即可 2.挂载 2个及以上 I2C 设备时，比较容易实现单独对某一设备操作	1.只能够操作I2C，不支持SPI（其实也不算缺点）
<bitserial_api.h>	1.更加抽象，通过一个API 同时支持 I2C 与 SPI 并且通过句柄来管理。 2.可以方便地设置任意通信速率。	1.对挂载 2个及以上的 I2C 设备时，需要手动判断地址并且修改（使用同一个句柄） 2.增加了初始化的步骤

I2C地址相关注意事项：
I2cTransfer：传入设备的地址为8位写地址。
Bitserial ：传入设备的地址为7位地址。