I2C

API 文档

构造函数

I2C( unit_id [选填], 「sda_pin」 [必填], 「scl_pin」 [必填], frequency [选填])
创建一个I2C对象并关联其到所给的引脚上，使用别的参数来配置该对象。
如此便可在I2C上发送以及接收数据。

  • unit_id : 硬件I2C的组号, 如不填则使用默认值

  • "sda_pin": SDA引脚名

  • "scl_pin": SCL引脚名

  • frequency: I2C 的运行频率, 如不填则使用默认值

備註

所有选填参数的默认值如下

参数

Default

默认值

0

Frequency

100000 (Hz)

方法

I2C.reset()
该方法取消I2C 设备的初始化.
I2C.scan()
该方法扫描并返回可用I2C地址.
I2C.readinto( buf[必填], flag[选填])
该方法读取I2C缓存器中的数据并存入用户定义的缓存器中

  • buf: 一个string / array /byte array 类型的缓存器

  • flag: 一个布尔标记, 如果是True则在数据末尾发送 NACK, 反则反之

I2C.write(buf[必填])
该方法发送已存在buf中的数据

  • buf: 一个string / array /byte array 类型的缓存器

I2C.readfrom(addr[必填], len[必填], stop[选填])
该方法从所给的地址上读取len长度的数据。如果stop值为真，则在传输结尾发送STOP字节。

  • addr: 读取的地址

  • len: 要读取的数据长度

  • stop: 布尔标记，若True则在传输结束发送STOP字节

I2C.readfrom_into(addr[必填], buf[必填], stop[选填])
该方法从所给的地址上读取len长度的数据。如果stop值为真，则在传输结尾发送STOP字节。

  • addr: 读取的地址

  • buf: 一个string / array /byte array 类型的缓存器

  • stop: 布尔标记，若True则在传输结束发送STOP字节

I2C.writeto(addr[必填], value[必填], stop[选填])
该方法发送一个整数数据到所给的地址上。如果stop值为真，则在传输结尾发送STOP字节。

  • addr: 写入的地址

  • value: 要发送的整数数值

  • stop: 布尔标记，若True则在传输结束发送STOP字节