I2C类 – 二线串行协议¶
I2C是一个设备间传输的二线串行协议。其物理层包括两条线：SCL和SDA，分别为时钟和数据线。 OpenMV不再为SDA和SCL提供上拉，因此SDA和SCL需要外部上拉才能使I2C工作。
I2C对象创建在特定总线上。可在创建时或创建后初始化。
Example:
from pyb import I2C
i2c = I2C(1) # create on bus 1
i2c = I2C(1, I2C.MASTER) # create and init as a master
i2c.init(I2C.MASTER, baudrate=20000) # init as a master
i2c.init(I2C.SLAVE, addr=0x42) # init as a slave with given address
i2c.deinit() # turn off the peripheral
打印i2c对象可以提供关于其配置的信息。 基本方法是发送和接收:
基本的方法是send和recv:
i2c.send('abc') # send 3 bytes
i2c.send(0x42) # send a single byte, given by the number 发送以数字形式给出的单个字节
data = i2c.recv(3) # receive 3 bytes
要接收数据，先创建一个bytearray:
data = bytearray(3) # create a buffer 创建一个缓冲区
i2c.recv(data) # receive 3 bytes, writing them into data 接收3个字节，并将其写入数据
你可以指定一个超时时长（单位：毫秒）:
i2c.send(b'123', timeout=2000) # timeout after 2 seconds
主机必须指定接收方地址
i2c.init(I2C.MASTER)
i2c.send('123', 0x42) # send 3 bytes to slave with address 0x42 使用0x42地址向子机发送3个字节
i2c.send(b'456', addr=0x42) # keyword for address
主机也有其他方法
i2c.is_ready(0x42) # check if slave 0x42 is ready 检查从机0x42是否准备充分
i2c.scan() # scan for slaves on the bus, returning
# a list of valid addresses 在总线上浏览从机，返回一个有效地址列表
i2c.mem_read(3, 0x42, 2) # read 3 bytes from memory of slave 0x42, 从从机0x42的内存中读取3个字节
# starting at address 2 in the slave 从从机的地址2开始
i2c.mem_write('abc', 0x42, 2, timeout=1000) # write 'abc' (3 bytes) to memory of slave 0x42 将“abc”写入从机内存
# starting at address 2 in the slave, timeout after 1 second 从从机的地址2开始，1秒后超时
构造函数¶
-
class
pyb.I2C(bus, ...) 在给定总线上构建一个I2C对象。
bus可为1,2。在没有其他参数的情况下，可创建I2C对象，但未进行初始化（ 该对象的设置来自总线的最后一次初始化，若存在的话）。若给定额外参数，则总线进行初始化。初始化参数详见init。在Pyboards V1.0 和 V1.1 中I2C总线的物理引脚为：
I2C(1)is on the X position:(SCL, SDA) = (X9, X10) = (PB6, PB7)I2C(2)is on the Y position:(SCL, SDA) = (Y9, Y10) = (PB10, PB11)
在 Pyboard Lite 中:
I2C(1)is on the X position:(SCL, SDA) = (X9, X10) = (PB6, PB7)I2C(3)is on the Y position:(SCL, SDA) = (Y9, Y10) = (PA8, PB8)
Calling the constructor with ‘X’ or ‘Y’ enables portability between Pyboard types.
-
class
pyb.I2C(bus, ...) 在给定总线上构建一个I2C对象。
bus可为1,2。在没有其他参数的情况下，可创建I2C对象，但未进行初始化（ 该对象的设置来自总线的最后一次初始化，若存在的话）。若给定额外参数，则总线进行初始化。初始化参数详见init。在星瞳stm32中I2C总线的物理引脚为：
I2C(1):(SCL, SDA) = (P24, P23) = (PB6, PB7)I2C(2):(SCL, SDA) = (P25, P26) = (PB10, PB11)
方法¶
-
I2C.deinit() 关闭I2C总线。
-
I2C.init(mode, *, addr=0x12, baudrate=400000, gencall=False, dma=False) 使用给定参数初始化I2C总线:
mode须为I2C.MASTER或I2C.SLAVEaddr是一个7位地址(只对从机有效)baudrate是SCL的时钟频率(只对主机有效)gencall是指是否支持一般调用模式。dma是否允许将DMA用于I2C传输（请注意，DMA传输具有更精确的时序，但目前不能正确处理总线错误）
-
I2C.is_ready(addr) 检查I2C设备是否响应给定地址。只在主模式有效。
-
I2C.mem_read(data, addr, memaddr, *, timeout=5000, addr_size=8) 从I2C设备内存中读取：
data可为一个要读入的整数(要读取的字节数量)或缓冲区addr是I2C设备地址memaddr是I2C设备中内存的位置timeout是以毫秒计的等待读取的超时时长addr_size选择memaddr宽度：8或16位
返回读取数据。只在主模式下有效。
-
I2C.mem_write(data, addr, memaddr, *, timeout=5000, addr_size=8) 写入I2C设备的内存：
data可为一个用来写入的整数或缓冲区。addr是I2C设备的地址。memaddr是I2C设备中内存的位置timeout是以毫秒计的等待写入的超时时长addr_size选择memaddr宽度：8或16位
返回
None. 只在主模式下有效。
-
I2C.recv(recv, addr=0x00, *, timeout=5000) 在总线上接收数据：
recv可为一个整数，即接收的字节的数量；或为一个使用收到的字节来填充的可变缓冲区。addr是用以接收的地址（只在主模式下需要）timeout是以毫秒计的等待接收的超时时长
返回值：若
recv为一个整数，则有一个新的字节缓冲区来接收，否则这一缓冲区将传递给``recv``.
-
I2C.send(send, addr=0x00, *, timeout=5000) 在总线上发送数据:
send是要发送的数据（一个整数或一个缓冲区对象）addr是要发送到的地址（只在主模式下需要timeout是以毫秒计的等待发送的超时时长
返回值:
None.
-
I2C.scan() 浏览从0x01到0x7f的所有I2C地址，并返回一个响应的地址的列表。只在主模式下有效。