树莓派开启I²C并安装对应工具后i2cdetect无法检测到设备地址怎么办

一、硬件连接排查 #

• 确认设备供电匹配：多数I²C设备默认使用3.3V供电，部分5V供电的设备需单独供电，避免树莓派引脚输出功率不足导致设备未启动
• 确认引脚接线正确：树莓派默认I²C总线1的SDA对应物理引脚3（GPIO2）、SCL对应物理引脚5（GPIO3），需与外接设备的SDA、SCL引脚对应连接，必须保证外接设备与树莓派共接GND，GND不连通会直接导致I²C通信失败
• 排查线路故障：更换全新杜邦线重试，排除线路断路、引脚接触不良的问题
• 验证设备本身可用性：将该I²C设备连接到其他已验证可用的主控板上测试，排除设备本身硬件损坏的可能

二、系统配置排查 #

• 验证I²C内核模块是否正常加载：执行命令 lsmod | grep i2c，正常返回结果需包含i2c_bcm2835、i2c_dev两个模块，若返回为空说明I²C功能未正确启用
  • 模块未加载时，可执行命令 sudo raspi-config，进入「Interface Options」菜单找到「I2C」选项，选择启用后重启树莓派重试
• 确认使用的总线编号正确：早期256MB内存版本的初代树莓派B默认I²C总线编号为0，对应检测命令为i2cdetect -y 0，可分别尝试两个总线编号确认是否匹配
• 检查设备树配置：查看/boot/config.txt（Bookworm及之后版本的新系统路径为/boot/firmware/config.txt），确认文件中存在dtparam=i2c_arm=on配置，且无其他设备树配置占用I²C对应的GPIO2、GPIO3引脚

三、兼容问题处理 #

• 调整I²C通信波特率：部分低速率I²C设备对时钟信号要求较高，可在上述config.txt文件中添加配置dtparam=i2c_arm_baudrate=10000，将通信波特率降到10kbit/s，重启后重试，可逐步提升波特率找到设备兼容的数值
• 自定义I²C设备额外排查：若你使用的是自行开发的单片机I²C设备，确认设备固件中I²C应答逻辑正常，且设置的I²C地址未被系统保留、未与其他设备冲突

内容的提问来源于stack exchange，提问作者Nawaf Alsamman