编译Linux I2C从设备内核模块遇i2c_slave_register未定义错误求助

问题分析 #

编译时出现的未定义符号错误，说明链接器无法找到这两个函数的实际实现，通常由内核配置、API版本不匹配或构建脚本问题导致。

解决方案 #

1. 检查并启用内核I2C Slave支持 #

i2c_slave_register和i2c_slave_unregister仅在内核开启CONFIG_I2C_SLAVE选项时才会被编译并导出：

• 针对自定义内核：运行make menuconfig，进入Device Drivers -> I2C support -> I2C slave support，将该选项设置为y（编译进内核）或m（编译为模块），重新编译内核及模块。
• 针对发行版内核：安装对应版本的完整内核头文件和源码包，确认发行版内核配置包含CONFIG_I2C_SLAVE（可查看/boot/config-$(uname -r)文件）。

2. 适配API版本（函数重命名） #

Linux内核5.15及以后版本中，原i2c_slave_register/i2c_slave_unregister已被重命名为i2c_slave_add/i2c_slave_remove：

• 打开linux/i2c.h确认函数定义，若原函数不存在，替换代码中的调用：

  // 旧API
  i2c_slave_register(client);
  i2c_slave_unregister(client);
  
  // 新API替换
  i2c_slave_add(client);
  i2c_slave_remove(client);
  

3. 修正模块Makefile依赖 #

确保模块Makefile正确关联内核构建系统，示例Makefile如下：

obj-m += your_slave_module.o
KDIR := /lib/modules/$(shell uname -r)/build
PWD := $(shell pwd)

all:
	make -C $(KDIR) M=$(PWD) modules

clean:
	make -C $(KDIR) M=$(PWD) clean

编译前确认i2c-core模块已加载（执行lsmod | grep i2c_core），若未加载，运行modprobe i2c_core。

4. 确认函数实现存在 #

头文件中的函数存根仅为接口声明，实际实现位于drivers/i2c/i2c-core-slave.c，该文件仅在CONFIG_I2C_SLAVE开启时才会被编译进i2c-core模块。若内核未开启该选项，即使头文件有声明，链接时也会出现未定义符号错误。

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