【雕爷学编程】MicroPython手册之 I2C 串行外设接口总线协议

MicroPython是为了在嵌入式系统中运行Python 3编程语言而设计的轻量级版本解释器。与常规Python相比，MicroPython解释器体积小(仅100KB左右)，通过编译成二进制Executable文件运行，执行效率较高。它使用了轻量级的垃圾回收机制并移除了大部分Python标准库，以适应资源限制的微控制器。

MicroPython主要特点包括:
1、语法和功能与标准Python兼容,易学易用。支持Python大多数核心语法。
2、对硬件直接访问和控制,像Arduino一样控制GPIO、I2C、SPI等。
3、强大的模块系统,提供文件系统、网络、图形界面等功能。
4、支持交叉编译生成高效的原生代码,速度比解释器快10-100倍。
5、代码量少,内存占用小,适合运行在MCU和内存小的开发板上。
6、开源许可,免费使用。Shell交互环境为开发测试提供便利。
7、内置I/O驱动支持大量微控制器平台，如ESP8266、ESP32、STM32、micro:bit、掌控板和PyBoard等。有活跃的社区。

MicroPython的应用场景包括:
1、为嵌入式产品快速构建原型和用户交互。
2、制作一些小型的可 programmable 硬件项目。
3、作为教育工具,帮助初学者学习Python和物联网编程。
4、构建智能设备固件,实现高级控制和云连接。
5、各种微控制器应用如物联网、嵌入式智能、机器人等。

使用MicroPython需要注意:
1、内存和Flash空间有限。
2、解释执行效率不如C语言。
3、部分库函数与标准版有差异。
4、针对平台优化语法,订正与标准Python的差异。
5、合理使用内存资源,避免频繁分配大内存块。
6、利用原生代码提升速度关键部位的性能。
7、适当使用抽象来封装底层硬件操作。

总体来说,MicroPython让Python进入了微控制器领域，是一项重要的创新，既降低了编程门槛，又提供了良好的硬件控制能力。非常适合各类物联网和智能硬件的开发。

MicroPython的I2C是一个用于进行串行外设接口总线协议（主机端）的类，它可以让用户在Python中访问和控制硬件上的I2C电路，并实现与外部设备的数据交换。

I2C类的主要特点是：

它可以通过一个标识符来创建一个I2C对象，该标识符可以是一个整数（通常指定一个硬件I2C块的编号）、一个Pin对象（通常指定一个软件I2C的时钟引脚）或其他由底层硬件支持的值。
它可以设置I2C对象的波特率、极性、相位、位宽、首位等参数，以影响通信的速度和模式。
它可以读取和写入I2C对象的数据，并返回一个字节或字节数组，表示发送或接收到的数据。

I2C类的应用场景是：

在MicroPython中实现与硬件设备的交互，如读写EEPROM、显示屏、传感器等I2C设备。
在MicroPython中实现基于硬件设备的应用，如数据存储、图形显示、信号采集等。
在MicroPython中学习和理解I2C总线协议的原理和方法，以及不同参数对通信效果的影响。

I2C类需注意事项是：

使用I2C类时要注意硬件设备的规格和限制，避免造成电路板故障、锁定、崩溃或硬件损坏。
使用I2C类时要注意通信结果的准确性和可靠性，避免受到噪声、干扰、延迟等因素的影响。
使用I2C类时要注意不同端口之间的差异和兼容性问题，避免在移植代码时出现错误或异常。
以下是MicroPython的I2C三个实际运用程序案例：

案例一：使用I2C类读写EEPROM，并打印存储内容。

import machine

# 创建一个硬件I2C对象，连接到第1个硬件I2C块，并设置波特率为100kHz
i2c = machine.I2C(1, baudrate=100000)
# 创建一个EEPROM对象，连接到i2c对象，并指定从地址为0x50
eeprom = machine.I2CDevice(i2c, 0x50)
# 写入一些内容到EEPROM中，从地址0开始
eeprom.write(0, b'Hello, MicroPython!')
# 读取EEPROM中的内容，从地址0开始，读取20个字节
data = eeprom.read(0, 20)
# 打印读取到的内容
print(data)

案例二：使用I2C类控制LCD1602显示屏，并显示一些文字。

import machine
import lcd1602

# 创建一个软件I2C对象，连接到GPIO21（SCL）、GPIO22（SDA）引脚，并设置波特率为400kHz
i2c = machine.I2C(-1, scl=machine.Pin(21), sda=machine.Pin(22), freq=400000)
# 创建一个LCD1602显示屏对象，连接到i2c对象，并指定从地址为0x27，宽度为16字符，高度为两行
lcd = lcd1602.LCD1602(i2c, 0x27, 16, 2)
# 清除屏幕内容
lcd.clear()
# 在屏幕上显示一些文字
lcd.puts('Hello,', 0, 0) # 在第一行第一列显示Hello,
lcd.puts('MicroPython!', 0, 1) # 在第二行第一列显示MicroPython!

案例三：使用I2C类读取BMP180气压传感器，并打印温度和气压。

# 导入machine模块，用于创建I2C对象
import machine
# 导入bmp180模块，用于创建BMP180对象
import bmp180

# 创建一个硬件I2C对象，连接到第2个硬件I2C块，并设置波特率为100kHz
i2c = machine.I2C(2, baudrate=100000)
# 创建一个BMP180气压传感器对象，连接到i2c对象，并指定从地址为0x77
bmp = bmp180.BMP180(i2c, 0x77)
# 读取BMP180的温度和气压，并打印
temp = bmp.temperature # 温度，单位为摄氏度
press = bmp.pressure # 气压，单位为帕斯卡
print(temp, press)

案例四：读取传感器数据：

import machine

# 创建I2C对象
i2c = machine.I2C(0)

# 扫描I2C总线
devices = i2c.scan()

# 遍历每个设备并读取数据
for device in devices:
    i2c.writeto(device, b'\x00')  # 发送命令
    data = i2c.readfrom(device, 4)  # 读取数据
    print("Device:", device, "Data:", data)

在这个示例中，我们使用machine模块中的I2C类创建了一个I2C对象。使用scan()方法扫描I2C总线上的设备，并将设备地址存储在devices列表中。然后，我们遍历每个设备，向设备发送命令并读取数据。使用writeto()方法发送命令，readfrom()方法读取数据，然后将设备地址和读取的数据打印出来。

案例五：控制外部设备：

import machine

# 创建I2C对象
i2c = machine.I2C(0)

# 设置从机地址
address = 0x42

# 发送控制命令
i2c.writeto(address, b'\x01\x02')

# 读取状态
status = i2c.readfrom(address, 1)

# 打印结果
print("Status:", status[0])

在这个示例中，我们同样使用machine模块中的I2C类创建了一个I2C对象。我们设置了从机的地址，并使用writeto()方法向从机发送控制命令。然后，使用readfrom()方法从从机读取状态数据，读取的数据存储在status列表中。最后，我们将状态数据打印出来。

案例六：使用I2C显示屏：

import machine
import ssd1306

# 创建I2C对象
i2c = machine.I2C(0)

# 创建显示屏对象
display = ssd1306.SSD1306_I2C(128, 64, i2c)

# 清空显示屏
display.fill(0)
display.show()

# 显示文本
display.text("Hello, World!", 0, 0, 1)
display.show()

在这个示例中，我们同样使用machine模块中的I2C类创建了一个I2C对象。然后，我们使用I2C接口与SSD1306 I2C显示屏进行通信。我们创建了一个显示屏对象，并指定I2C对象。我们清空显示屏，并使用text()方法在显示屏上显示文本。最后，我们调用show()方法将更新后的内容显示在屏幕上。这些示例展示了如何使用MicroPython的I2C功能进行传感器数据读取、外设控制和与I2C设备的通信。具体的应用取决于您所使用的外设和硬件。请注意，实际的应用可能需要根据您的硬件和外设的要求进行适当的设置和参数调整。

案例七：传感器数据采集：使用I2C接口读取传感器输出的数据。例如，连接一个温度传感器到MicroPython设备的I2C引脚上，并使用I2C通信协议发送读取指令，然后接收传感器返回的数据，从而获取温度值。

import machine

i2c = machine.I2C(0, scl=machine.Pin(22), sda=machine.Pin(21))  # 初始化I2C对象

# 发送指令并接收传感器数据
i2c.writeto(0x48, bytes([0x00]))  # 发送读取指令
data = i2c.readfrom(0x48, 2)  # 从传感器读取2字节数据

# 解析数据
temperature = (data[0] << 8) | data[1]

print("Temperature:", temperature)

案例八：外部设备控制：使用I2C接口与外部设备进行通信和控制。例如，连接一个外部的数字扩展芯片到MicroPython设备的I2C引脚上，并使用I2C通信协议发送控制指令，以控制外设的功能。

import machine

i2c = machine.I2C(0, scl=machine.Pin(22), sda=machine.Pin(21))  # 初始化I2C对象

# 发送控制指令
i2c.writeto(0x50, bytes([0x01, 0x23]))  # 发送控制指令，设置外设的功能

# 其他代码...

案例九：实时时钟（RTC）通信：使用I2C接口与实时时钟芯片进行通信，以获取和设置时间。例如，连接一个实时时钟芯片到MicroPython设备的I2C引脚上，并使用I2C通信协议发送读取时间指令，然后接收时钟芯片返回的时间数据。

import machine

i2c = machine.I2C(0, scl=machine.Pin(22), sda=machine.Pin(21))  # 初始化I2C对象

# 发送读取时间指令并接收时钟芯片数据
i2c.writeto(0x68, bytes([0x00]))  # 发送读取时间指令
data = i2c.readfrom(0x68, 7)  # 从时钟芯片读取7字节数据

# 解析数据
seconds = data[0] & 0x7F
minutes = data[1]
hours = data[2]
# 解析其他时间字段...
print("Time: {}:{}:{}".format(hours, minutes, seconds))

这些是MicroPython中I2C的实际运用程序案例之一。通过使用适当的I2C通信协议和指令，可以与各种I2C兼容的外部设备进行通信和控制。具体的实现细节可能会根据使用的硬件和外部设备而有所不同。