MaixCAM MaixPy 使用 I2C

前置知识

请先学会使用pinmap 模块设置引脚功能。

要让一个引脚能使用 I2C 功能，先用pinmap设置对应引脚功能为I2C。

I2C 简介

I2C 使用两个引脚SCL SDA 即可实现总线通信，即一个主机可以挂多个从机，实现一对多通信，十分方便。
常用来：

• 读取传感器数据，比如温湿度、IMU、触摸屏。
• 控制设备，比如设置摄像头参数。
• 两个设备通信。

关于 I2C 基础知识，网上有很多好教程，本文不展开讲解，请自行搜索学习。

选择合适的 I2C 使用

首先我们需要知道设备有哪些引脚和 I2C，如图：

设备型号	引脚简图	引脚复用说明
MaixCAM		板子丝印比如A15是引脚名，I2C5_SCL是功能名
MaixCAM-Pro		第一个名如A15是引脚名，对应I2C5_SCL是功能名
MaixCAM2		第一个名如IO0_A1是引脚名，对应I2C6_SCL是功能名

需要注意的是，引脚默认可能用做其它用途，最好避开这些引脚，请看pinmap 文档中的说明。

比如：

• 对于MaixCAM / MaixCAM-Pro, 引出的 I2C1 I2C3 引脚和 WiFi 模块（SDIO1）重合了，所以不建议使用了，另外还有一个I2C5，是底层驱动软件模拟的，建议使用它，底层已经做好了驱动，使用时和使用硬件I2C一样。
• MaixCAM2引出的I2C6 / I2C7则是空闲的，设置了 pinmap 就能使用。

MaixPy 中使用 I2C

先用pinmap设置引脚功能为I2C，然后初始化I2C对象即可：

from maix import i2c, pinmap, sys, err


# get pin and i2c number according to device id
device_id = sys.device_id()
if device_id == "maixcam2":
    scl_pin_name = "IO0_A1"
    scl_i2c_name = "I2C6_SCL"
    sda_pin_name = "IO0_A0"
    sda_i2c_name = "I2C6_SDA"
    i2c_id = 6
else:
    scl_pin_name = "A15"
    scl_i2c_name = "I2C5_SCL"
    sda_pin_name = "A27"
    sda_i2c_name = "I2C5_SDA"
    i2c_id = 5

# set pinmap
err.check_raise(pinmap.set_pin_function(scl_pin_name, scl_i2c_name), "set pin failed")
err.check_raise(pinmap.set_pin_function(sda_pin_name, sda_i2c_name), "set pin failed")

bus = i2c.I2C(i2c_id, i2c.Mode.MASTER)
slaves = bus.scan()
print("find slaves:")
for s in slaves:
    print(f"{s}[0x{s:02x}]")

更多例程

看MaixPy examples。

API 文档

更多 API 看 i2c API 文档

使用其它库

另外，由于是 Linux 标准驱动，除了使用 MaixPy 提供的 API，你也可以使用 Linux 通用库，比如smbus / smbus2。

使用步骤：

• 在开发板终端执行pip install smbus 安装库。
• 使用pinmap 映射引脚功能。
• 调用smbus API 对 i2c 进行读写。

from maix import i2c, pinmap, sys, err
import smbus

# get pin and i2c number according to device id
device_id = sys.device_id()
if device_id == "maixcam2":
    scl_pin_name = "IO0_A1"
    scl_i2c_name = "I2C6_SCL"
    sda_pin_name = "IO0_A0"
    sda_i2c_name = "I2C6_SDA"
    i2c_id = 6
else:
    scl_pin_name = "A15"
    scl_i2c_name = "I2C5_SCL"
    sda_pin_name = "A27"
    sda_i2c_name = "I2C5_SDA"
    i2c_id = 5

# set pinmap
err.check_raise(pinmap.set_pin_function(scl_pin_name, scl_i2c_name), "set pin failed")
err.check_raise(pinmap.set_pin_function(sda_pin_name, sda_i2c_name), "set pin failed")


bus = smbus.SMBus(i2c_id)