庐山派K230芯片I2C模块API手册主从模式配置与Python编程实战最近在玩庐山派K230开发板发现它内置了5个硬件I2C模块用起来挺方便的。I2C这个通信协议在嵌入式里太常用了各种传感器、EEPROM存储器、触摸芯片都靠它。但很多朋友刚开始用的时候对怎么配置主从模式、怎么调用API不太清楚今天我就结合官方文档手把手带大家过一遍K230的I2C编程。这篇文章适合正在使用庐山派K230开发板的嵌入式开发者特别是需要连接I2C外设的朋友。我会详细讲解machine模块里的I2C和I2C_Slave两个类从最基础的设备扫描到主从通信实战最后还会分享一个K230模拟EEPROM从机的完整例子。咱们一步步来保证你能看懂、能用上。1. K230的I2C硬件基础与模式选择在开始写代码之前咱们先了解一下K230芯片的I2C硬件家底。这决定了你能用哪些功能。K230芯片内部集成了5个独立的硬件I2C控制器编号从I2C0到I2C4。每个控制器都支持三种标准通信速率标准模式100 kbit/s快速模式400 kbit/s高速模式3.4 Mbit/s注意具体使用哪个物理引脚作为I2C的SCL时钟线和SDA数据线需要参考IOMUXIO复用模块的配置来设置。简单理解就是芯片的引脚功能不是固定的你需要通过配置告诉芯片“这个引脚现在用作I2C的SCL”。这个配置通常在板级支持包BSP或底层驱动中完成对于大多数应用开发板厂商已经帮你配好了。除了硬件I2CK230还支持软件模拟I2C。当你硬件I2C的引脚被其他功能占用或者需要更多的I2C通道时就可以用普通的GPIO口来模拟I2C的时序非常灵活。软件I2C的设备ID从5开始即5~9。2. 主设备模式编程详解大部分时候我们的K230都是作为“主设备”Master去控制外部的“从设备”Slave比如读取温湿度传感器数据。machine.I2C类就是干这个的。2.1 初始化I2C主设备首先得把I2C通道初始化起来。这里分硬件I2C和软件I2C两种初始化方法。硬件I2C初始化 这是最常用、性能也最好的方式。假设我们要使用第一个硬件I2C控制器I2C0通信速率设为标准的100kHz。from machine import I2C # 初始化硬件I2C0时钟频率100kHz i2c I2C(0, freq100000)id0指定使用硬件I2C0。freq100000设置通信频率为100kHz即100,000 Hz。软件I2C初始化 当硬件通道不够用时我们可以指定两个普通的GPIO引脚来模拟I2C。比如我们使用ID为5的软件I2C设备并指定引脚10为SCL引脚11为SDA。from machine import I2C # 初始化软件I2C (ID5)指定SCL和SDA引脚频率100kHz超时时间1000ms i2c I2C(5, scl10, sda11, freq100000, timeout1000)id5指定使用软件I2C设备5。scl和sda必须指定用于模拟时钟线和数据线的GPIO引脚编号。timeout软件模拟时通信超时时间单位毫秒。这个参数对硬件I2C无效。2.2 扫描总线上的从设备新接上一个传感器第一步就是看看它有没有“上线”地址是多少。scan()方法就是干这个的。# 扫描I2C总线寻找所有从设备 device_list i2c.scan() print(Found I2C devices at addresses:, device_list)这个方法会返回一个列表里面是所有响应了扫描的从设备的7位地址注意I2C地址通常是7位不带读写位。如果返回空列表[]那就要检查一下接线、电源和从设备是否正常了。2.3 基础数据读写readfrom和writeto找到设备后就可以跟它“聊天”了。最基本的操作就是发送数据和接收数据。向从设备发送数据 比如我们要向地址为0x68的从设备发送一串数据。data_to_send bytearray([0x01, 0x02, 0x03]) # 要发送的数据 bytes_sent i2c.writeto(0x68, data_to_send, True) print(fSent {bytes_sent} bytes.)addr0x68目标从设备的地址。buf要发送的数据必须是bytes或bytearray类型。stopTrue发送完成后产生一个停止信号。目前API仅支持True。返回值成功发送的字节数。从从设备读取数据 比如从地址0x68的设备读取5个字节。# 方法一直接返回读取的数据 received_data i2c.readfrom(0x68, 5, True) print(Received data (method 1):, received_data) # 方法二读取到预先分配好的缓冲区更高效避免重复分配内存 buf bytearray(5) # 预先创建一个5字节的缓冲区 i2c.readfrom_into(0x68, buf, True) print(Received data (method 2):, buf)readfrom直接返回读取到的bytes对象。readfrom_into将数据读入一个已有的bytearray缓冲区buf。这在需要反复读取数据时性能更好。2.4 操作寄存器设备readfrom_mem和writeto_mem很多I2C设备如传感器、EEPROM内部有寄存器或存储单元你需要先指定一个“内存地址”memaddr然后再读写这个地址的数据。这需要两个步骤的复合操作。读取寄存器值 假设一个温度传感器的设备地址是0x48它的当前温度值存放在寄存器地址0x00我们需要读取2个字节。# 方法一直接读取 temp_data i2c.readfrom_mem(0x48, 0x00, 2, mem_size8) print(Temperature raw data:, temp_data) # 方法二读取到缓冲区 temp_buf bytearray(2) i2c.readfrom_mem_into(0x48, 0x00, temp_buf, mem_size8)memaddr0x00要读取的寄存器起始地址。nbytes2要读取的字节数。mem_size8寄存器地址的宽度默认为8位即1字节地址。有些设备是16位地址就需要设为mem_size16。向寄存器写入数据 向地址0x48设备的配置寄存器地址0x01写入一个字节的配置值0x60。config_value bytearray([0x60]) i2c.writeto_mem(0x48, 0x01, config_value, mem_size8)2.5 释放资源当不再使用I2C设备时最好显式地释放资源。虽然Python有垃圾回收但主动释放是个好习惯。i2c.deinit()3. 从设备模式编程实战K230的I2C控制器默认是主模式但它也能“扮演”从设备这个功能非常有用比如你可以让一块K230模拟成一个EEPROM存储器供另一块主控板比如另一块K230、树莓派、STM32等来读写。要实现这个功能需要定制固件。3.1 开启从机模式支持进入K230 SDK的编译配置菜单make rtsmart-menuconfig导航到路径Drivers Configuration-Enable-I2C-Enable I2Cx。找到并勾选Enable I2Cx SLAVE mode选项x代表你要启用从模式的I2C编号比如I2C0。保存配置退出并重新编译固件、烧录。只有编译了支持从机模式的固件下面的代码才能运行。3.2 模拟EEPROM从机完整示例咱们来看一个实战场景用K230从机模拟一个20字节的EEPROM用另一块开发板K210主机来读写它。同时K230会用一根GPIOPin5来通知主机“数据有更新快来读”K230端代码作为从机from machine import Pin, FPIOA, I2C_Slave import time import os # 初始化一个GPIO用于给主机发中断信号 def gpio_int_init(): fpioa FPIOA() # 实例化FPIOA用于引脚功能复用配置 fpioa.set_function(5, FPIOA.GPIO5) # 将物理引脚5的功能设置为GPIO5 # 实例化Pin5为输出模式无上下拉驱动能力设为7最强 pin Pin(5, Pin.OUT, pullPin.PULL_NONE, drive7) pin.value(1) # 初始化为高电平 return pin # 主程序开始 pin gpio_int_init() # 1. 获取系统中可用的I2C从机设备ID device_id_list I2C_Slave.list() print(找到的I2C从机设备ID:, device_id_list) # 通常只有一个我们取第一个 if not device_id_list: print(错误未找到可用的I2C从机设备请检查固件配置。) # 这里应该退出或处理错误 # 2. 创建I2C从机对象 # 参数设备ID从机地址设为0x10模拟20字节的EEPROM内存 i2c_slave I2C_Slave(device_id_list[0], addr0x10, mem_size20) print(I2C从机已启动地址0x10等待主机写入数据...) # 3. 循环等待主机写入数据 last_data i2c_slave.readfrom_mem(0, 20) # 首次读取内存初始值可能全0 current_data last_data while current_data last_data: # 如果数据没变就继续等 current_data i2c_slave.readfrom_mem(0, 20) # 从内存地址0开始读20字节 time.sleep_ms(100) # 休眠100ms避免CPU占用率过高 os.exitpoint() # 检查退出点允许程序被中断 print(f收到主机写入的数据: {current_data}) # 4. 处理数据并写回模拟EEPROM操作 # 这里我们简单地把收到的每个字节加1实际应用可能是处理传感器数据等 for i in range(len(current_data)): current_data[i] (current_data[i] 1) % 256 # 防止溢出 # 将处理后的数据写回模拟EEPROM的内存 i2c_slave.writeto_mem(0, current_data) # 5. 拉低再拉高GPIO5通知主机数据已更新可以读取了 pin.value(0) # 产生一个下降沿脉冲 time.sleep_ms(1) # 保持低电平1ms确保主机能检测到 pin.value(1) # 恢复高电平 print(数据已更新并已通知主机。)K210端代码作为主机from machine import I2C from fpioa_manager import fm # K210的引脚管理模块 from maix import GPIO import time # 配置K210的GPIO2连接K230的GPIO5为输入用于接收中断 fm.register(8, fm.fpioa.GPIO2) # 将物理引脚8映射为功能GPIO2 int_io GPIO(GPIO.GPIO2, GPIO.IN, GPIO.PULL_UP) # 上拉输入 # 初始化K210的I2C3作为主机 i2c_master I2C(I2C.I2C3, freq100000, scl6, sda7) # 1. 主机先向从机地址0x10的“EEPROM”写入一串数据 data_to_write bytearray(babcdefghijklnmopqrst) # 正好20字节 print(主机正在写入数据...) i2c_master.writeto_mem(0x10, 0, data_to_write, mem_size8) print(写入完成等待从机中断信号...) # 2. 等待从机的GPIO中断信号低电平 while int_io.value() 1: # 循环检测直到引脚变低 time.sleep_ms(10) # 短暂休眠降低CPU占用 pass print(收到中断信号开始读取从机数据...) # 3. 从机已更新数据主机去读取 received_buf i2c_master.readfrom_mem(0x10, 0, 20, mem_size8) print(从从机读取到的数据:, received_buf) # 预期输出应该是原始字符串每个字符的ASCII码加1即bcdefghijklmnopqrstu3.3 从机API关键点解析I2C_Slave.list()这个函数很重要必须先调用它来获取当前系统支持的从机设备ID。这个ID列表取决于你编译固件时使能了哪个I2C控制器作为从机。构造函数I2C_Slave(id, addr, mem_size)id必须使用list()方法返回的ID之一。addr这个从机在I2C总线上的7位地址主机会用这个地址来访问它。mem_size模拟的EEPROM内存大小。主机会通过readfrom_mem/writeto_mem来读写这片内存。内存映射读写从机的readfrom_mem和writeto_mem方法操作的就是mem_size定义的那片内存区域。主机的readfrom_mem/writeto_mem操作会映射到这里。4. 调试技巧与常见问题扫描不到设备检查接线SCL、SDA、GND是否接好电源是否稳定检查上拉电阻I2C总线必须要有上拉电阻通常4.7kΩ或10kΩ接到总线的电源如3.3V。很多开发板已集成如果自己接线别忘记。地址确认确认从设备地址是否正确注意是7位地址有的数据手册给的是8位带读写位的地址需要右移一位。通信失败或数据错误降低频率先尝试用最低的100kHz频率排除时序问题。检查电平确保主机和从机是相同的电压电平如都是3.3V。逻辑分析仪如果有条件用逻辑分析仪抓一下I2C波形是最直接的调试手段。从机模式无法使用确认固件这是最常见的问题务必按照3.1节的步骤重新编译并烧录支持I2C SLAVE模式的固件。检查ID确保I2C_Slave.list()返回了有效的ID并且初始化时使用了正确的ID。软件I2C不稳定软件I2C靠CPU延时模拟时序容易被其他中断打断。如果通信要求高优先使用硬件I2C。可以适当增加timeout参数的值。好了关于庐山派K230的I2C编程从主设备到从设备从基础API到实战项目核心内容就是这些了。实际项目中大部分时间你都是在做主设备去操作各种传感器。从设备模式则在一些需要板间通信或者设备模拟的场景下非常有用。多动手试试上面的代码遇到问题对照着排查很快就能掌握。