外设

[English]

UART

I2C

I2C 驱动已经被重新设计在 I2C, 以统一接口并扩展 I2C 外设的使用。尽管我们推荐使用新驱动的接口, 但用户仍然可以通过包含路径 driver/i2c.h 来使用老驱动。

主要的概念上和用法上的改变如下所示:

主要概念更新

  • 用于初始化整个 I2C 总线的结构体 i2c_config_t 已经被移除. 在新驱动中, 从机和主机是分开的. 用户可以独立调用 i2c_master_bus_config_ti2c_slave_config_t

  • i2c_mode_t 用来判断 I2C 控制器是工作在从模式还是主模式。该枚举器已被弃用。在新驱动程序中,用户无需自行设置,驱动程序会妥善处理。

  • i2c_rw_t 用来判断 I2C 主控制器是在进行 “写 “还是 “读”。现在,它已被弃用。

  • i2c_addr_mode_t 被重命名为 i2c_addr_bit_len_t.

  • 在老驱动中,你需要将 I2C 命令通过 I2C_LINK_RECOMMENDED_SIZE, i2c_cmd_link_create_static, 等链接成链表. 在新驱动中,你不需要这么做,你只需要调用相关的接口函数即可。

  • 在老驱动中,选择时钟通过例如 I2C_SCLK_SRC_FLAG_FOR_NOMAL 的时钟标志位. 在新驱动中,你可以直接选择时钟源。

主要用法更新

  • I2C 总线初始化通过两部分完成. 第一步通过 i2c_new_master_bus() 初始化 I2C 总线, 然后初始化 I2C 设备通过 i2c_master_bus_add_device()

  • i2c_reset_tx_fifoi2c_reset_rx_fifo 已被删除,因为用户不太需要重置 fifo。但可以通过 i2c_master_bus_reset 重置整个总线。

  • 删除了 i2c_cmd_link_xxx 函数,用户不需要自己使用 link 来链接命令。

  • i2c_master_write_to_device 更名为 i2c_master_transmit

  • i2c_master_read_from_device 已更名为 i2c_master_receive

  • i2c_master_write_read_device 已更名为 i2c_master_transmit_receive

  • i2c_slave_write_buffer 重命名为 i2c_slave_transmit

  • i2c_slave_read_buffer 已更名为 i2c_slave_receive