外设

[English]

UART

I2C

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

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

主要概念更新

  • 用于初始化整个 I2C 总线的结构体 i2c_config_t 已经被移除. 在新驱动中, 从机和主机是分开的. 用户可以独立调用 i2c_master_bus_config_t 和 i2c_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_fifo 和 i2c_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。

此文档对您有帮助吗？