RIOT OS I2C 外设驱动测试指南基于 shell 命令逐字节验证底层 I2C 功能【免费下载链接】RIOTRIOT - The friendly OS for IoT项目地址: https://gitcode.com/GitHub_Trending/riot/RIOT本文面向 RIOT OSThe friendly OS for IoT开发者系统讲解仓库中tests/periph/i2c测试应用的使用方法它通过 shell 暴露全部底层 I2C 驱动接口读/写寄存器、读写字节、总线占用/释放、总线扫描等帮助你在真实硬件上验证 SDA/SCL 时序、从机地址应答与寄存器读写行为。读完本文你将掌握每个 shell 命令的参数语义、FLAG 标志位的底层作用、错误返回值的含义并能独立完成一次完整的 I2C 外设联调。测试目的与背景tests/periph/i2c是 RIOT OS 中针对底层 I2C 外设驱动low-level I2C peripheral driver的功能测试应用。其 README 明确说明该测试允许你通过shell调用所有可用的底层 I2C 函数它既可以手动运行连接终端逐条输入命令也可以通过python 脚本接口自动化执行测试覆盖的设备编号、从机地址、寄存器号、读写长度与标志位均可由命令行参数指定因此可以针对不同传感器灵活组合验证。测试应用入口位于 tests/periph/i2c/main.c其中注册了 12 个含可选命令与 I2C 相关的 shell 命令并在启动时打印Start: Test for the low-level I2C driver后进入 shell 交互循环。术语表DEV / ADDR / REG / LEN / FLAG在使用 shell 命令之前先明确 README 中给出的五个核心参数测试中大量命令共用这套参数语义参数含义说明DEVI2C 设备总线控制器编号通常是0具体编号与引脚映射请查阅目标板卡的periph_conf.h头文件ADDRI2C 从机设备地址通常是传感器地址从机地址信息应在其数据手册datasheet中查找REG从机设备/传感器的寄存器号注意并非所有传感器都遵循寄存器访问方式某些设备可能需要配合I2C_NOSTOP0x04使用LEN读取或写入的长度字节数数值范围受测试内部缓冲区限制见下文FLAG为 I2C 传输设置的标志位更多信息见 drivers/include/periph/i2c.h其中 FLAG 可用的标志位定义在 drivers/include/periph/i2c.htypedef enum { I2C_ADDR10 0x01, /* 使用 10 位设备寻址 */ I2C_REG16 0x02, /* 使用 16 位寄存器寻址大端序 */ I2C_NOSTOP 0x04, /* 传输结束后不发送 STOP 条件 */ I2C_NOSTART 0x08, /* 跳过 START 序列忽略地址字段 */ } i2c_flags_t;以I2C_NOSTOP0x04为例某些器件要求在写完寄存器地址后保持总线占用不发送 STOP随后再发起重复起始RESTART读取数据这就需要在写寄存器地址时传入I2C_NOSTOP。这也是 README 特别提示“部分传感器需要I2C_NOSTOP”的原因。构建与烧录运行该测试的构建配置位于 tests/periph/i2c/MakefileBOARD ? samr21-xpro include ../Makefile.periph_common FEATURES_REQUIRED periph_i2c FEATURES_OPTIONAL periph_i2c_reconfigure USEMODULE shell_cmds_default USEMODULE shell_cmd_i2c_scan USEMODULE xtimer关键点解读默认目标板为samr21-xpro可通过BOARD...覆盖必须满足特性periph_i2c即目标 MCU 提供 I2C 外设否则无法编译periph_i2c_reconfigure为可选特性只有支持引脚重配置的平台才会使能i2c_gpio命令main.c中以#ifdef MODULE_PERIPH_I2C_RECONFIGURE包裹额外启用shell_cmd_i2c_scan从而在 shell 中获得i2c_scan总线扫描命令。构建并烧录到板卡# 指定板卡编译默认 samr21-xpro make BOARDsamr21-xpro # 烧录 make BOARDsamr21-xpro flash # 连接串口终端以 term 目标为例 make BOARDsamr21-xpro term进入 shell 后输入help即可看到本测试注册的全部命令及其用途。注意tests/periph/Makefile.periph_common引用了通用的Makefile.tests_common并默认不启用 Kconfig配置SHOULD_RUN_KCONFIG ?为空。内存受限板卡并非所有板卡都能运行本测试。内存不足的板卡被排除在 CI 之外清单见 tests/periph/i2c/Makefile.ci例如arduino-uno、atmega328p、nucleo-l011k4、samd10-xmini等 AVR 与部分小内存 ARM 板卡。若你的板卡在此列表中建议换用内存更大的目标板。Shell 命令详解参数、语义与底层调用所有命令的参数校验统一由_check_param()完成见 main.c先校验参数个数再校验 DEV 是否落在[0, I2C_NUMOF)区间内越界会打印Error: No device, only %d supported。数字解析使用strtol(str, temp, 0)base 0因此同时支持十进制与0x前缀的十六进制写法与 shell 中命令参数的常见用法一致。总线占用与释放i2c_acquire DEV i2c_release DEVi2c_acquire DEV获取指定 I2C 总线的互斥访问权。若总线正忙调用会阻塞直到总线空闲对应底层i2c_acquire()。i2c_release DEV释放总线供其他线程/驱动使用对应底层i2c_release()。这两个命令直接映射 drivers/include/periph/i2c.h 中的接口。RIOT 的 I2C 驱动采用基于事务的访问模型所有读/写操作都应在i2c_acquire()与i2c_release()之间执行这是多线程共享总线时的基本并发契约。从功耗角度看驱动实现应当在i2c_acquire()时才为外设上电时钟门控开启、在i2c_release()时关闭外设电源从而做到按需供电。寄存器读取带重复起始i2c_read_reg DEV ADDR REG FLAG i2c_read_regs DEV ADDR REG LEN FLAGi2c_read_reg读取1 字节寄存器底层调用i2c_read_reg()成功时输出Success: i2c_%i read 1 byte(s) from reg 0x%02x : [0x..]。i2c_read_regs连续读取LEN 字节寄存器底层调用i2c_read_regs()LEN 需满足1 LEN 128否则报Error: invalid LENGTH parameter given。两者在实现上使用**重复起始repeated START**序列先写寄存器地址、再读数据。REG支持 8 位或 16 位配合I2C_REG16标志右对齐。直接读写设备不涉及寄存器i2c_read_byte DEV ADDR FLAG i2c_read_bytes DEV ADDR LENGTH FLAG i2c_write_byte DEV ADDR BYTE FLAG i2c_write_bytes DEV ADDR FLAG BYTE0 [BYTE1 [BYTE_n [...]]]i2c_read_byte/i2c_read_bytes直接从从机读取 1 个 / LENGTH 个字节底层分别调用i2c_read_byte()与i2c_read_bytes()。i2c_write_byte向从机写入 1 字节数据。i2c_write_bytes向从机写入多个字节字节列表直接跟在 FLAG 之后最多可写满 128 字节缓冲区BUFSIZE 128参数上限为3 BUFSIZE底层调用i2c_write_bytes()。注意i2c_write_bytes与i2c_write_regs的参数顺序不同写裸字节时 FLAG 在数据之前DEV ADDR FLAG BYTE0 ...写寄存器时 FLAG 也在数据之前DEV ADDR REG FLAG BYTE0 ...输入时需按各自 Usage 提示对齐。寄存器写入i2c_write_reg DEV ADDR REG BYTE FLAG i2c_write_regs DEV ADDR REG FLAG BYTE0 [BYTE1 ...]i2c_write_reg向寄存器写入 1 字节底层调用i2c_write_reg()实现采用连续序列先写寄存器号再写数据。i2c_write_regs向寄存器连续写入多个字节底层调用i2c_write_regs()成功时输出Success: i2c_%i wrote %i bytes to reg 0x%02x。设备信息查询i2c_get_devs i2c_get_idi2c_get_devs返回当前平台支持的 I2C 设备数量I2C_NUMOF用于确认板卡暴露了几条总线。i2c_get_id返回固件标识[periph_i2c]供自动化脚本识别当前固件。总线扫描来自 shell_cmd_i2c_scan由于 Makefile 启用了shell_cmd_i2c_scanshell 中还会出现i2c_scan命令其实现位于 sys/shell/cmds/i2c_scan.ci2c_scan [DEVICE_NUMBER]默认扫描I2C_DEV(0)也可指定设备号。扫描结果以表格形式打印 8 位地址空间0x00–0x7f-表示该地址无应答not ACKedX表示该地址有应答ACKed即总线上存在设备R表示保留地址低于0x08或高于0x77见is_addr_reserved()E表示发生错误。这是排查“传感器地址填错/没焊好/上拉电阻缺失”等硬件问题的最快手段先用i2c_scan找出实际应答的地址再对照数据手册确认是否正确。参数校验细节与返回值语义main.c中_get_num()使用strtol解析并将非法输入映射为CONVERT_ERROR (-32768)_check_param()负责命令参数个数与设备号的校验。长度参数 LEN 超出[1, 128]时i2c_read_regs、i2c_read_bytes会直接拒绝执行。底层驱动返回的错误码在_print_i2c_error()main.c中被翻译为可读信息与 drivers/include/periph/i2c.h 中声明的返回值一一对应返回值含义0/I2C_ACK成功-EIO从机未对字节 ACK从机不应答数据-ENXIO总线上地址无设备响应无 ACK-ETIMEDOUT设备响应超时-EINVAL参数非法-EOPNOTSUPPMCU 驱动不支持所请求的标志位操作-EAGAIN总线仲裁丢失源码级原理acquire/release、标志位与模拟驱动事务式访问与功耗管理drivers/include/periph/i2c.h 详细说明了 I2C 驱动的功耗模型I2C 采用事务式总线访问因此驱动实现应仅在i2c_acquire()–i2c_release()区间内为外设供电初始化后外设应处于断电时钟门控状态。若实现使用 DMA 传输并使当前线程休眠还可能需要阻塞某些低功耗状态。硬件注意事项上拉电阻I2C 的 SDA/SCL 信号线必须连接外部上拉电阻到 Vcc驱动实现应尽量启用引脚内部上拉。但某些场景如接入逻辑分析仪导致总线电容升高下内部上拉不足会引发总线异常此时应外接上拉电阻。典型取值见 drivers/include/periph/i2c.hNormal 模式~100 kbit/s10kΩFast 模式~400 kbit/s2kΩFast plus 模式~1000 kbit/s2kΩ总线速度枚举i2c_speed_tdrivers/include/periph/i2c.h从I2C_SPEED_LOW~10 kbit/s到I2C_SPEED_HIGH~3400 kbit/s共五档具体速度在板卡periph_conf.h中为每个设备配置。可选命令 i2c_gpio引脚复用重配置当平台支持periph_i2c_reconfigure特性时会多出命令i2c_gpio DEV它演示了将 I2C 引脚动态切换为普通 GPIOi2c_deinit_pins()→gpio_init/gpio_set/gpio_clear再恢复为 I2C 功能i2c_init_pins()的完整流程。这类需求典型出现在与 I2C 总线复用的器件如 ATECC608A 安全芯片上对应底层接口i2c_init_pins()/i2c_deinit_pins()drivers/include/periph/i2c.h。模拟驱动扩展点main.c中还有一段针对periph_i2c_mock的示例当启用模拟驱动模块时可自定义i2c_write_bytes()实现如打印“Mock write intercepted”后忽略写入用于无硬件环境下的驱动开发与单元测试展示了如何对底层写函数进行拦截定制。从寄存器级验证到完整外设联调结合以上命令一次典型的传感器调试流程为i2c_scan扫描总线确认传感器应答的 7 位地址如0x68i2c_acquire 0获取总线读取传感器 WHO_AM_I 寄存器i2c_read_reg 0 0x68 0x0f 0核对返回值与数据手册一致对需要先写寄存器地址再读的设备写地址时加I2C_NOSTOPi2c_write_byte 0 0x68 0x0f 4后再i2c_read_byte 0 0x68 0配置寄存器i2c_write_reg 0 0x68 0x20 0x10 0批量读取采样数据i2c_read_regs 0 0x68 0x28 6 0i2c_release 0释放总线。自动化场景下可依据i2c_get_id输出的[periph_i2c]与各命令统一的Success:/Error:前缀编写 Python 测试脚本实现板卡级回归验证README 中亦注明对应的自动化用例可在 RobotFW-tests 仓库的tests/periph/i2c目录找到。小结tests/periph/i2c把 RIOT OS 底层 I2C 驱动的全部能力以 shell 命令形式暴露出来覆盖总线占用、寄存器读写、裸字节读写、标志位控制、总线扫描与引脚重配置是验证板卡 I2C 硬件与驱动实现的直接工具。理解 DEV/ADDR/REG/LEN/FLAG 五元组语义与I2C_NOSTOP等标志位的总线时序影响即可用它对绝大多数 I2C 传感器完成快速联调与故障定位。【免费下载链接】RIOTRIOT - The friendly OS for IoT项目地址: https://gitcode.com/GitHub_Trending/riot/RIOT创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 RIOT OS I2C 外设驱动测试指南：基于 shell 命令逐字节验证底层 I2C 功能
RIOT OS I2C 外设驱动测试指南基于 shell 命令逐字节验证底层 I2C 功能【免费下载链接】RIOTRIOT - The friendly OS for IoT项目地址: https://gitcode.com/GitHub_Trending/riot/RIOT本文面向 RIOT OSThe friendly OS for IoT开发者系统讲解仓库中tests/periph/i2c测试应用的使用方法它通过 shell 暴露全部底层 I2C 驱动接口读/写寄存器、读写字节、总线占用/释放、总线扫描等帮助你在真实硬件上验证 SDA/SCL 时序、从机地址应答与寄存器读写行为。读完本文你将掌握每个 shell 命令的参数语义、FLAG 标志位的底层作用、错误返回值的含义并能独立完成一次完整的 I2C 外设联调。测试目的与背景tests/periph/i2c是 RIOT OS 中针对底层 I2C 外设驱动low-level I2C peripheral driver的功能测试应用。其 README 明确说明该测试允许你通过shell调用所有可用的底层 I2C 函数它既可以手动运行连接终端逐条输入命令也可以通过python 脚本接口自动化执行测试覆盖的设备编号、从机地址、寄存器号、读写长度与标志位均可由命令行参数指定因此可以针对不同传感器灵活组合验证。测试应用入口位于 tests/periph/i2c/main.c其中注册了 12 个含可选命令与 I2C 相关的 shell 命令并在启动时打印Start: Test for the low-level I2C driver后进入 shell 交互循环。术语表DEV / ADDR / REG / LEN / FLAG在使用 shell 命令之前先明确 README 中给出的五个核心参数测试中大量命令共用这套参数语义参数含义说明DEVI2C 设备总线控制器编号通常是0具体编号与引脚映射请查阅目标板卡的periph_conf.h头文件ADDRI2C 从机设备地址通常是传感器地址从机地址信息应在其数据手册datasheet中查找REG从机设备/传感器的寄存器号注意并非所有传感器都遵循寄存器访问方式某些设备可能需要配合I2C_NOSTOP0x04使用LEN读取或写入的长度字节数数值范围受测试内部缓冲区限制见下文FLAG为 I2C 传输设置的标志位更多信息见 drivers/include/periph/i2c.h其中 FLAG 可用的标志位定义在 drivers/include/periph/i2c.htypedef enum { I2C_ADDR10 0x01, /* 使用 10 位设备寻址 */ I2C_REG16 0x02, /* 使用 16 位寄存器寻址大端序 */ I2C_NOSTOP 0x04, /* 传输结束后不发送 STOP 条件 */ I2C_NOSTART 0x08, /* 跳过 START 序列忽略地址字段 */ } i2c_flags_t;以I2C_NOSTOP0x04为例某些器件要求在写完寄存器地址后保持总线占用不发送 STOP随后再发起重复起始RESTART读取数据这就需要在写寄存器地址时传入I2C_NOSTOP。这也是 README 特别提示“部分传感器需要I2C_NOSTOP”的原因。构建与烧录运行该测试的构建配置位于 tests/periph/i2c/MakefileBOARD ? samr21-xpro include ../Makefile.periph_common FEATURES_REQUIRED periph_i2c FEATURES_OPTIONAL periph_i2c_reconfigure USEMODULE shell_cmds_default USEMODULE shell_cmd_i2c_scan USEMODULE xtimer关键点解读默认目标板为samr21-xpro可通过BOARD...覆盖必须满足特性periph_i2c即目标 MCU 提供 I2C 外设否则无法编译periph_i2c_reconfigure为可选特性只有支持引脚重配置的平台才会使能i2c_gpio命令main.c中以#ifdef MODULE_PERIPH_I2C_RECONFIGURE包裹额外启用shell_cmd_i2c_scan从而在 shell 中获得i2c_scan总线扫描命令。构建并烧录到板卡# 指定板卡编译默认 samr21-xpro make BOARDsamr21-xpro # 烧录 make BOARDsamr21-xpro flash # 连接串口终端以 term 目标为例 make BOARDsamr21-xpro term进入 shell 后输入help即可看到本测试注册的全部命令及其用途。注意tests/periph/Makefile.periph_common引用了通用的Makefile.tests_common并默认不启用 Kconfig配置SHOULD_RUN_KCONFIG ?为空。内存受限板卡并非所有板卡都能运行本测试。内存不足的板卡被排除在 CI 之外清单见 tests/periph/i2c/Makefile.ci例如arduino-uno、atmega328p、nucleo-l011k4、samd10-xmini等 AVR 与部分小内存 ARM 板卡。若你的板卡在此列表中建议换用内存更大的目标板。Shell 命令详解参数、语义与底层调用所有命令的参数校验统一由_check_param()完成见 main.c先校验参数个数再校验 DEV 是否落在[0, I2C_NUMOF)区间内越界会打印Error: No device, only %d supported。数字解析使用strtol(str, temp, 0)base 0因此同时支持十进制与0x前缀的十六进制写法与 shell 中命令参数的常见用法一致。总线占用与释放i2c_acquire DEV i2c_release DEVi2c_acquire DEV获取指定 I2C 总线的互斥访问权。若总线正忙调用会阻塞直到总线空闲对应底层i2c_acquire()。i2c_release DEV释放总线供其他线程/驱动使用对应底层i2c_release()。这两个命令直接映射 drivers/include/periph/i2c.h 中的接口。RIOT 的 I2C 驱动采用基于事务的访问模型所有读/写操作都应在i2c_acquire()与i2c_release()之间执行这是多线程共享总线时的基本并发契约。从功耗角度看驱动实现应当在i2c_acquire()时才为外设上电时钟门控开启、在i2c_release()时关闭外设电源从而做到按需供电。寄存器读取带重复起始i2c_read_reg DEV ADDR REG FLAG i2c_read_regs DEV ADDR REG LEN FLAGi2c_read_reg读取1 字节寄存器底层调用i2c_read_reg()成功时输出Success: i2c_%i read 1 byte(s) from reg 0x%02x : [0x..]。i2c_read_regs连续读取LEN 字节寄存器底层调用i2c_read_regs()LEN 需满足1 LEN 128否则报Error: invalid LENGTH parameter given。两者在实现上使用**重复起始repeated START**序列先写寄存器地址、再读数据。REG支持 8 位或 16 位配合I2C_REG16标志右对齐。直接读写设备不涉及寄存器i2c_read_byte DEV ADDR FLAG i2c_read_bytes DEV ADDR LENGTH FLAG i2c_write_byte DEV ADDR BYTE FLAG i2c_write_bytes DEV ADDR FLAG BYTE0 [BYTE1 [BYTE_n [...]]]i2c_read_byte/i2c_read_bytes直接从从机读取 1 个 / LENGTH 个字节底层分别调用i2c_read_byte()与i2c_read_bytes()。i2c_write_byte向从机写入 1 字节数据。i2c_write_bytes向从机写入多个字节字节列表直接跟在 FLAG 之后最多可写满 128 字节缓冲区BUFSIZE 128参数上限为3 BUFSIZE底层调用i2c_write_bytes()。注意i2c_write_bytes与i2c_write_regs的参数顺序不同写裸字节时 FLAG 在数据之前DEV ADDR FLAG BYTE0 ...写寄存器时 FLAG 也在数据之前DEV ADDR REG FLAG BYTE0 ...输入时需按各自 Usage 提示对齐。寄存器写入i2c_write_reg DEV ADDR REG BYTE FLAG i2c_write_regs DEV ADDR REG FLAG BYTE0 [BYTE1 ...]i2c_write_reg向寄存器写入 1 字节底层调用i2c_write_reg()实现采用连续序列先写寄存器号再写数据。i2c_write_regs向寄存器连续写入多个字节底层调用i2c_write_regs()成功时输出Success: i2c_%i wrote %i bytes to reg 0x%02x。设备信息查询i2c_get_devs i2c_get_idi2c_get_devs返回当前平台支持的 I2C 设备数量I2C_NUMOF用于确认板卡暴露了几条总线。i2c_get_id返回固件标识[periph_i2c]供自动化脚本识别当前固件。总线扫描来自 shell_cmd_i2c_scan由于 Makefile 启用了shell_cmd_i2c_scanshell 中还会出现i2c_scan命令其实现位于 sys/shell/cmds/i2c_scan.ci2c_scan [DEVICE_NUMBER]默认扫描I2C_DEV(0)也可指定设备号。扫描结果以表格形式打印 8 位地址空间0x00–0x7f-表示该地址无应答not ACKedX表示该地址有应答ACKed即总线上存在设备R表示保留地址低于0x08或高于0x77见is_addr_reserved()E表示发生错误。这是排查“传感器地址填错/没焊好/上拉电阻缺失”等硬件问题的最快手段先用i2c_scan找出实际应答的地址再对照数据手册确认是否正确。参数校验细节与返回值语义main.c中_get_num()使用strtol解析并将非法输入映射为CONVERT_ERROR (-32768)_check_param()负责命令参数个数与设备号的校验。长度参数 LEN 超出[1, 128]时i2c_read_regs、i2c_read_bytes会直接拒绝执行。底层驱动返回的错误码在_print_i2c_error()main.c中被翻译为可读信息与 drivers/include/periph/i2c.h 中声明的返回值一一对应返回值含义0/I2C_ACK成功-EIO从机未对字节 ACK从机不应答数据-ENXIO总线上地址无设备响应无 ACK-ETIMEDOUT设备响应超时-EINVAL参数非法-EOPNOTSUPPMCU 驱动不支持所请求的标志位操作-EAGAIN总线仲裁丢失源码级原理acquire/release、标志位与模拟驱动事务式访问与功耗管理drivers/include/periph/i2c.h 详细说明了 I2C 驱动的功耗模型I2C 采用事务式总线访问因此驱动实现应仅在i2c_acquire()–i2c_release()区间内为外设供电初始化后外设应处于断电时钟门控状态。若实现使用 DMA 传输并使当前线程休眠还可能需要阻塞某些低功耗状态。硬件注意事项上拉电阻I2C 的 SDA/SCL 信号线必须连接外部上拉电阻到 Vcc驱动实现应尽量启用引脚内部上拉。但某些场景如接入逻辑分析仪导致总线电容升高下内部上拉不足会引发总线异常此时应外接上拉电阻。典型取值见 drivers/include/periph/i2c.hNormal 模式~100 kbit/s10kΩFast 模式~400 kbit/s2kΩFast plus 模式~1000 kbit/s2kΩ总线速度枚举i2c_speed_tdrivers/include/periph/i2c.h从I2C_SPEED_LOW~10 kbit/s到I2C_SPEED_HIGH~3400 kbit/s共五档具体速度在板卡periph_conf.h中为每个设备配置。可选命令 i2c_gpio引脚复用重配置当平台支持periph_i2c_reconfigure特性时会多出命令i2c_gpio DEV它演示了将 I2C 引脚动态切换为普通 GPIOi2c_deinit_pins()→gpio_init/gpio_set/gpio_clear再恢复为 I2C 功能i2c_init_pins()的完整流程。这类需求典型出现在与 I2C 总线复用的器件如 ATECC608A 安全芯片上对应底层接口i2c_init_pins()/i2c_deinit_pins()drivers/include/periph/i2c.h。模拟驱动扩展点main.c中还有一段针对periph_i2c_mock的示例当启用模拟驱动模块时可自定义i2c_write_bytes()实现如打印“Mock write intercepted”后忽略写入用于无硬件环境下的驱动开发与单元测试展示了如何对底层写函数进行拦截定制。从寄存器级验证到完整外设联调结合以上命令一次典型的传感器调试流程为i2c_scan扫描总线确认传感器应答的 7 位地址如0x68i2c_acquire 0获取总线读取传感器 WHO_AM_I 寄存器i2c_read_reg 0 0x68 0x0f 0核对返回值与数据手册一致对需要先写寄存器地址再读的设备写地址时加I2C_NOSTOPi2c_write_byte 0 0x68 0x0f 4后再i2c_read_byte 0 0x68 0配置寄存器i2c_write_reg 0 0x68 0x20 0x10 0批量读取采样数据i2c_read_regs 0 0x68 0x28 6 0i2c_release 0释放总线。自动化场景下可依据i2c_get_id输出的[periph_i2c]与各命令统一的Success:/Error:前缀编写 Python 测试脚本实现板卡级回归验证README 中亦注明对应的自动化用例可在 RobotFW-tests 仓库的tests/periph/i2c目录找到。小结tests/periph/i2c把 RIOT OS 底层 I2C 驱动的全部能力以 shell 命令形式暴露出来覆盖总线占用、寄存器读写、裸字节读写、标志位控制、总线扫描与引脚重配置是验证板卡 I2C 硬件与驱动实现的直接工具。理解 DEV/ADDR/REG/LEN/FLAG 五元组语义与I2C_NOSTOP等标志位的总线时序影响即可用它对绝大多数 I2C 传感器完成快速联调与故障定位。【免费下载链接】RIOTRIOT - The friendly OS for IoT项目地址: https://gitcode.com/GitHub_Trending/riot/RIOT创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考