简介本资源是一份面向Linux内核开发者与嵌入式系统工程师的BMI260六轴IMU驱动模块专为博世BMI260惯性测量单元设计解决其在Linux平台下加速度计与陀螺仪功能缺失或支持不完善的问题适用于工业控制、运动追踪、姿态感知等实时传感场景。压缩包共11个文件含2个核心C源码bmi260_i2c.c、bmi260_core.c、2个头文件bmi260.h、bmi260_config.h、Makefile构建脚本、DKMS配置文件dkms.conf、Arch Linux打包脚本PKGBUILD、README.md说明文档、.gitignore及附赠的Word格式安装配置指南附赠资源.docx和纯文本功能概要说明文件.txt整体仅55KB轻量易集成。已有54人学习下载资源结构清晰以BMI160驱动为基线演进而来兼顾兼容性与BMI260新增特性如更高精度采样、低功耗模式支持提供完整编译加载流程与硬件接口抽象便于读者快速移植、调试并拓展至实际项目。 最近在调一个可穿戴设备的姿态解算模块选型时用了博世BMI260这颗六轴IMU。它有加速度计和陀螺仪和内核里已有的BMI160驱动在寄存器层面上有不少相通的地方但Linux主线并没有直接支持BMI260的独立驱动。我最后做的方案非常直接基于现有内核BMI160驱动框架适配出一份BMI260专用的内核驱动模块。这篇文章就把完整的移植思路、寄存器差异、代码实现和调试过程整理出来给正在做IMU驱动开发的朋友一个能直接参考的路径。整个驱动最终挂到了IIO子系统里应用层通过iio设备节点读加速度和角速度数据也支持中断触发和数据buffer读取。整个过程踩了不少坑尤其是芯片ID判断、数据寄存器长度、量程换算这几个地方属于那种手册上写了但很容易忽略的细节。这篇内容会从硬件差异讲到代码细节再到设备树和常见问题排查篇幅有点长但每一节都是实打实的知识点。1. 项目背景与整体设计思路1.1 BMI260 是一颗怎样的IMUBMI260是博世推出的一款六轴惯性测量单元内部整合了三轴MEMS加速度计和三轴MEMS陀螺仪封装尺寸很小功耗控制也不错很适合用在便携式设备里。和更早期的BMI160对比BMI260主要改善了传感器噪声性能和温度漂移尤其在高动态场景下陀螺仪数据的稳定性会明显好一些。我这次项目的需求是采集六轴原始数据然后在MCU/DSP侧做姿态融合因此IMU驱动必须稳定、低延迟并且能够配置不同的量程和输出速率。这颗芯片支持I2C和SPI两种通信接口I2C地址可以通过SDO引脚配置为0x68或0x69SPI支持四线模式。片内集成FIFO可以缓存传感器数据适合配合中断批量读取。对Linux驱动来说这几个硬件特性都很有价值I2C/SPI可以走内核regmapFIFO和中断可以配合IIO触发器和buffer机制实现高效的批量采集。我选它还有一个很重要的原因BMI260的大多数基础寄存器和BMI160保持兼容包括数据输出寄存器、CMD寄存器、量程配置寄存器等。这意味着驱动移植不需要从零开始而是可以基于成熟的内核BMI160驱动做增量适配。但是兼容不等于完全一致芯片ID寄存器、部分配置寄存器的默认值、陀螺仪性能参数都有差异所以不能简单地把BMI160驱动里的芯片ID改成BMI260就完事必须逐项核对。1.2 为什么选择基于BMI160驱动适配Linux内核里现有的BMI160驱动位于drivers/iio/imu/bmi160/已经实现了完整的IIO驱动框架包括I2C/SPI regmap初始化、设备树匹配、加速度计和陀螺仪的通道定义、数据读取、中断配置、FIFO支持等。从功能完整性来看这套框架非常扎实我只需要在它的基础上抽离出BMI260需要的那部分逻辑再替换掉寄存器配置和芯片匹配信息就能很快得到一个可用的驱动。如果用博世官方提供的Sensor API驱动包原理上也能跑但官方驱动通常是独立的字符设备驱动和Linux IIO子系统不打通。我们产品里其他传感器都已经用IIO框架管理应用层统一通过/sys/bus/iio/devices/iio:deviceX/读取数据如果BMI260走独立字符设备就得单独维护一套读取协议非常不划算。所以从系统架构角度看让BMI260也进IIO是更干净的选择。另外还有一个原因BMI160驱动已经过了大量内核review和实际产品验证涉及到的并发处理、缓存对齐、读取时序等问题都已经处理过了。我的移植工作重点是“差异适配”而不是“重新发明轮子”。这种思路在实际项目里非常高效也能减少很多低级bug。当然适配不是直接复制文件而是参考它的逻辑重新组织BMI260专属的驱动文件避免和原驱动产生符号冲突。1.3 驱动模块的整体架构驱动模块从整体上分为四层。第一层是物理传输层负责通过I2C或SPI和BMI260芯片交换数据这里直接复用内核的regmapAPI代码里只需要配置 regmap 的读写函数即可。第二层是芯片配置层负责初始化BMI260的寄存器、配置量程和采样率、控制待机/正常模式这部分是BMI260差异化的核心。第三层是IIO设备层向内核注册加速度计和陀螺仪通道并提供read_raw、write_raw等回调接口。第四层是事件/数据层负责处理中断、FIFO和数据读取将原始MEMS数据交给上层应用。在实际文件组织上我保留了类似BMI160驱动的风格一个bmi260_core.c放核心逻辑一个bmi260_i2c.c和bmi260_spi.c放总线适配代码头文件定义寄存器地址和私有数据结构。这样移植到新平台时只需要改总线相关文件核心逻辑可以保持不变。2. 硬件协议与寄存器差异分析2.1 I2C/SPI 接口配置BMI260的I2C接口非常标准支持标准模式、快速模式最高速率可以到1MHz。I2C设备地址由SDO引脚决定SDO接地时地址是0x68SDO接高电平是0x69。在多传感器系统中I2C地址冲突是个很容易踩的坑如果板上还有别的传感器也占用了0x68一定要通过SDO引脚错开。使用SPI时BMI260工作在主模式下的从机角色支持最高10MHz时钟。这里要注意SPI模式BMI260手册要求的是CPOL0、CPHA0和很多标准SPI外设一致。SPI读写操作和I2C不同读寄存器时需要先发送寄存器地址再把最高位置1表示读请求写寄存器则直接发送地址和数据。如果直接沿用水内核驱动里SPI的regmap配置这个问题通常会被封装好但如果是裸写寄存器一定要留意。我在调I2C时还发现一个问题不能用i2cdetect在驱动加载后直接扫描0x68因为设备已经被内核驱动占用扫描会返回异常。建议先在未加载驱动的状态下扫描确认设备地址再加载驱动验证。还有一个细节是BMI260的burst读方式可以一次性连续读出多个寄存器的数据例如一次性读取加速度计和陀螺仪的全部6轴数据但要保证读操作是连续的不能拆成多个单字节I2C读事务否则可能在两次读之间数据发生变化导致组合出来的三轴数据不是同一个采样点。2.2 BMI260与BMI160的寄存器映射差异BMI260虽然在继承BMI160寄存器体系但并不是完全一致。我这次移植时重点关注了几个差异点芯片ID寄存器、软复位寄存器、量程配置寄存器、数据输出寄存器偏移、FIFO相关寄存器。芯片ID寄存器是最典型的差异。BMI160的chip_id读出来是0xD1BMI260则是另一个值具体以芯片手册标注为准。如果驱动里的whoami校验还是等于0xD1就会导致probe直接失败。实际项目中我们不能假设所有寄存器都一致必须逐字节读一遍特别是芯片ID、错误状态寄存器、内部状态寄存器这些基础信息。和BMI160相比BMI260的CMD寄存器地址和主要功能位置相同软复位都需要往CMD寄存器写入0xB6。不过软复位之后芯片进入休眠模式还是正常模式不同版本的芯片行为可能有差异我建议驱动初始化时先软复位然后延时等待再重新配置模式而不是依赖默认值。量程配置方面BMI260同样支持加速度计±2g/±4g/±8g/±16g陀螺仪±125/±250/±500/±1000/±2000dps。寄存器地址和BMI160基本一致但配置位所在的位置以及默认值要仔细核对不能想当然。这里最安全的做法是移植前先用手册的寄存器位定义把BMI160驱动里的宏替换成BMI260的宏并加一个编译期检查。2.3 关键寄存器初始化流程初始化流程我总结为以下几步读取chip_id校验芯片存在且型号正确。软复位写0xB6到CMD寄存器延时20ms左右等待芯片稳定。将传感器从待机模式切换到正常模式。BMI260有多种电源模式包括待机、正常、低功耗、暂停等我一般先用正常模式调试。配置加速度计量程和输出数据速率。配置陀螺仪量程和输出数据速率。如果使用中断配置中断引脚和中断类型。如果使用FIFO配置FIFO水印和FIFO模式。读取一次所有通道数据确认不是全0或者乱码。初始化顺序非常关键。有一次我直接把加速度计和陀螺仪都配置到正常模式然后立即去读传感器ID和状态寄存器结果读到的是0xFF就是因为没有等芯片从软复位中恢复。后来在每次配置之间加了延时问题就消失了。另一个关键点是有些寄存器只能在待机模式下配置比如量程和采样率如果芯片处于正常模式写入不生效。驱动里需要先切换到待机配置完再切回正常模式。3. 驱动代码实现与核心逻辑拆解3.1 驱动框架与文件结构我沿用了BMI160驱动的文件结构创建了bmi260.h、bmi260_core.c、bmi260_i2c.c、bmi260_spi.c。核心数据结构里保存了struct regmap、设备指针、中断信息、量程/采样率配置、数据缓冲等字段。驱动入口通常放在总线驱动里I2C驱动用module_i2c_driver注册SPI驱动用module_spi_driver注册。核心probe函数由总线驱动调用完成以下工作static int bmi260_core_probe(struct device *dev, struct regmap *regmap, int irq) { struct iio_dev *indio_dev; struct bmi260_data *data; int ret; indio_dev devm_iio_device_alloc(dev, sizeof(*data)); if (!indio_dev) return -ENOMEM; data iio_priv(indio_dev); >static int bmi260_chip_init(struct bmi260_data *data) { unsigned int val; int ret; ret regmap_read(data-regmap, BMI260_REG_CHIP_ID, val); if (ret) return ret; if (val ! BMI260_CHIP_ID) { dev_err(data-dev, invalid chip id 0x%02x\n, val); return -ENODEV; } ret regmap_write(data-regmap, BMI260_REG_CMD, BMI260_CMD_SOFTRESET); if (ret) return ret; msleep(20); /* 配置加速度计±4g采样率100Hz */ ret regmap_update_bits(data-regmap, BMI260_REG_ACC_CONF, BMI260_ACC_RANGE_MASK | BMI260_ACC_ODR_MASK, BMI260_ACC_RANGE_4G | BMI260_ACC_ODR_100HZ); if (ret) return ret; /* 配置陀螺仪±500dps采样率100Hz */ ret regmap_update_bits(data-regmap, BMI260_REG_GYR_CONF, BMI260_GYR_RANGE_MASK | BMI260_GYR_ODR_MASK, BMI260_GYR_RANGE_500DPS | BMI260_GYR_ODR_100HZ); if (ret) return ret; /* 按需配置中断 */ return 0; }在配置前我建议把芯片先切换到待机模式等配置完成后再切回正常模式。因为BMI260在正常模式下部分配置寄存器可能不能直接修改。这个操作要在芯片初始化时做否则可能出现寄存器写了但读回来还是旧值的情况。另外regmap_update_bits的使用可以避免覆盖同一寄存器里其他位段这是IMU驱动开发里非常基础但容易忽略的点。很多寄存器在一个字节里同时存放了量程、滤波和采样率的位段如果用regmap_write直接整字节写入很容易把其他字段改错。3.3 数据读取与中断处理BMI260的数据寄存器按照固定顺序排列可以一次性读取6个字节分别对应加速度计X/Y/Z和陀螺仪X/Y/Z的高低位。使用二字节小端格式的补码。IIO驱动里的读取函数一般通过regmap_bulk_read将数据一次性读入缓冲static int bmi260_read_raw(struct iio_dev *indio_dev, struct iio_chan_spec const *chan, int *val, int *val2, long mask) { struct bmi260_data *data iio_priv(indio_dev); unsigned int reg; __le16 buf; int ret; switch (mask) { case IIO_CHAN_INFO_RAW: reg BMI260_REG_DATA_START chan-scan_index * 2; ret regmap_bulk_read(data-regmap, reg, buf, sizeof(buf)); if (ret) return ret; *val sign_extend32(le16_to_cpu(buf), 15); return IIO_VAL_INT; case IIO_CHAN_INFO_SCALE: /* 根据当前量程返回scale */ ... } return -EINVAL; }这里chan-scan_index用来计算数据寄存器偏移既简洁又不容易出错。加速度计和陀螺仪的数据寄存器在BMI260里是连续的所以使用同一个BMI260_REG_DATA_START起始地址加上偏移即可。如果使用中断就需要在中断服务程序里读取数据并送给IIO buffer。中断服务程序尽量只做标记然后通过schedule_work或iio_trigger_poll将工作放到线程上下文处理避免在中断上下文做耗时操作。BMI260支持数据就绪中断也就是新数据产生时引脚触发一次这在低功耗场景非常有用应用层不需要频繁轮询。3.4 加速度计与陀螺仪数据转换BMI260输出的是16位有符号原始值需要乘以一个scale系数才能转换成真实物理量。加速度计的标准单位是m/s^2陀螺仪的标准单位是rad/s。以加速度计±4g为例物理范围是±4 * 9.80665 m/s^2也就是约±39.2266m/s^2量程扩展到32768因此每个LSB对应的物理量为39.2266 / 32768 ≈ 0.001197 m/s^2。所以读取到原始值1000对应的加速度大约是1.197m/s^2。陀螺仪以±500dps为例满量程物理范围是±500度/秒每个LSB对应的角速度为500 / 32768 ≈ 0.01526 dps。换算成弧度制时需要再乘以π / 180所以最终scale是0.01526 * π / 180 ≈ 0.0002663 rad/s。在IIO驱动里我将scale作为分数返回例如scale 0.001197对应整数值1197和1000000应用层读到的格式是两个整数需要自行相除。为了让数据精度更高建议在应用层用浮点数计算scale不要在驱动里做浮点运算因为内核驱动里使用浮点是不推荐的。3.5 功耗管理与待机模式BMI260的电源模式控制也是驱动开发的重点。默认情况下芯片上电后可能处于待机模式。待机模式下传感器不采集数据电流很低正常模式下加速度计和陀螺仪才真正工作。驱动里可以通过CMD寄存器发送BMI260_CMD_WAKEUP和BMI260_CMD_SLEEP控制状态。实际项目中我一般是在系统休眠时让IMU进入待机模式在恢复时再退回到正常模式。如果应用需要低功耗但保持连续采集可以配置中断唤醒让SoC在数据到达时唤醒。这里要注意切换模式后需要延时几个毫秒等芯片稳定否则立刻读取数据可能读到上一次的数据。另一个重要点是BMI260支持加速度计单独工作和陀螺仪单独工作。如果应用只需要计步或者倾角测量可以只开加速度计陀螺仪不进入正常模式功耗能低很多。驱动层面需要把加速度计和陀螺仪的配置拆开不要一刀切地同时切换电源模式。4. 设备树配置与驱动编译加载4.1 设备树节点写法设备树是Linux驱动匹配硬件信息的核心。在I2C总线下BMI260的设备树节点大致如下i2c2 { status okay; clock-frequency 400000; bmi26068 { compatible bosch,bmi260; reg 0x68; interrupt-parent gpio1; interrupts 13 IRQ_TYPE_LEVEL_LOW; status okay; }; };如果使用SPI接口则需要放在SPI总线下并且注意reg写的是片选编号不是I2C地址。SPI节点示例spi3 { status okay; bmi2600 { compatible bosch,bmi260; reg 0; spi-max-frequency 5000000; interrupt-parent gpio1; interrupts 13 IRQ_TYPE_LEVEL_LOW; status okay; }; };这里的compatible字符串必须和驱动里of_device_id表保持一致。如果设备树里写的是bosch,bmi260驱动中也要有对应的匹配项static const struct of_device_id bmi260_of_match[] { { .compatible bosch,bmi260 }, { } }; MODULE_DEVICE_TABLE(of, bmi260_of_match);我调试中经常遇到设备树里compatible写错导致驱动probe根本执行不到的情况这类错误排查起来不算难但还是建议先从/sys/bus/iio/devices/下看有没有新增设备节点如果没有再看驱动是否被加载最后确认设备树匹配状态。4.2 内核编译配置驱动编译有两种方式编入内核镜像或者编译成独立模块。我推荐在开发阶段使用独立模块方便修改和重新加载。在驱动目录下需要修改对应的Kconfig和Makefile。如果新建驱动目录需要先添加Kconfig条目config BMI260_IIO tristate Bosch BMI260 IMU driver depends on I2C || SPI select REGMAP_I2C select REGMAP_SPI help Say yes here to build support for Bosch BMI260 six-axis IMU.Makefile中添加obj-$(CONFIG_BMI260_IIO) bmi260_core.o bmi260_i2c.o bmi260_spi.o然后在内核配置界面开启BMI260_IIO。编译模块后生成bmi260_core.ko、bmi260_i2c.ko、bmi260_spi.ko加载时需要注意顺序insmod bmi260_core.ko insmod bmi260_i2c.ko如果驱动编入内核就不存在加载顺序问题但调试验证周期会长一些。开发阶段还是模块方式更方便。4.3 模块加载与验证模块加载成功后可以通过IIO用户空间接口验证驱动是否正常工作。先看内核日志dmesg | grep bmi260确认没有报错后查看IIO设备节点ls /sys/bus/iio/devices/正常情况下应该看到一个iio:deviceX。进入该目录查看可用通道cat /sys/bus/iio/devices/iio:deviceX/name cat /sys/bus/iio/devices/iio:deviceX/in_accel_scale cat /sys/bus/iio/devices/iio:deviceX/in_anglvel_scale读取原始数据cat /sys/bus/iio/devices/iio:deviceX/in_accel_x_raw cat /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_raw如果设备支持IIO buffer还可以用工具如iio_generic_buffer或iiod获取批量数据。我更推荐在开发初期直接用cat读原始值因为这样可以快速确认传感器是否响应排除路径问题。5. 常见问题与排查技巧5.1 传感器ID读取错误症状是驱动probe时打印invalid chip id或者读到的chip_id是0xFF、0x00。首先检查I2C地址或SPI片选是否配对其次检查SDO引脚电平是否正确再检查电源是否稳定。有一个容易忽略的原因如果前一个驱动或者uboot已经把BMI260放到某个模式读取ID前需要先软复位。另一个常见原因是I2C总线频率过高传感器在I2C读写时状态不稳定导致读回0xFF。这时可以降低I2C频率到100kHz试试。如果chip_id还是不对直接用逻辑分析仪抓I2C波形确认主设备是否真的发送了正确的寄存器地址和读命令。芯片ID问题基本都能通过这三步解决。5.2 数据全零或噪声过大数据全零通常说明寄存器地址读错或者传感器没有真正进入正常模式。我遇到过一种情况配置了量程和采样率但忘记把芯片从待机模式切到正常模式导致加速度计和陀螺仪的数据寄存器一直是0。另外如果读的是FIFO但FIFO没有写入数据也会出现全零。噪声过大的原因一般是量程配置太小或采样率过高。比如在振动环境中如果加速度计量程只有±2g高动态冲击会导致输出进入饱和表现为数据跳变。此时需要根据实际应用把量程调整到±8g或±16g。另外陀螺仪对震动比较敏感如果板子机械固定不好数据噪声会明显增大可以在应用中加低通滤波或者调整BMI260内部滤波带宽。还有一个常见的软件坑读取数据时没有用le16_to_cpu转换字节序导致高字节和低字节交换数据看起来跳变得很夸张。这类问题在I2C和SPI下都可能出现一定要确认数据寄存器的字节序配置。5.3 中断不触发中断不触发时先检查设备树中中断GPIO是否配置正确再看BMI260中断引脚是否使能。BMI260的INT1和INT2默认可能是关闭的需要显式写入中断映射寄存器把数据就绪中断映射到对应引脚。还要确认中断类型是否符合设备树配置。如果你在设备树里配置为IRQ_TYPE_LEVEL_LOW但芯片实际拉高触发那永远等不到中断。我调试时常用GPIO sysfs先把中断脚设为输入用cat /sys/kernel/debug/gpio查看引脚电平变化再回来调整驱动。如果中断触发频率太高也可能导致系统负载异常。这个通常是不小心把中断配置成了“任意数据变化触发”而不是“新数据就绪触发”需要检查中断映射寄存器的设置。5.4 陀螺仪零偏校准陀螺仪即使静止不动输出也不完全为0这是MEMS器件的正常现象。在姿态解算前一定要做零偏校准。简单做法是让设备水平静止5秒采样陀螺仪数据取平均得到每个轴的零偏值然后在应用层减去这个偏移。BMI260部分版本支持内部偏移寄存器可以把校准后的offset写回芯片。但要注意这个offset会影响所有后续数据如果产品在产线上做一次性校准写芯片比较方便如果应用需要长期稳定性我更建议在应用层维护offset因为芯片寄存器空间有限而且写入偏移寄存器后需要重新初始化。在校准过程中还有一个小技巧不要只采几个点就平均最好采集成百上千个点然后取中位数或者均值。对于低成本MEMS器件噪声是高斯分布均值能有效减小随机噪声带来的偏差。这次移植工作总体上挺顺利但有一个教训我印象特别深刚开始为了图省事直接在BMI160驱动基础上改芯片ID结果probe倒是通过了但读取加速度数据和陀螺仪数据的寄存器偏移对不上数据跳变非常严重。后来我静下心把BMI260手册和BMI160手册的寄存器图逐页对照重新整理了所有偏移和掩码问题才算彻底解决。之后我养成了一个习惯只要做IMU驱动移植先把寄存器表格用脚本提取出来做一次自动对比再开始写代码。这个小习惯帮我在后续的传感器驱动开发里省了很多时间也推荐你试试。本文还有配套的精品资源点击获取 
长河君 · 2026/9/1 1:28:10 · 阅读 1.2k 基于BMI160驱动框架移植BMI260六轴IMU内核驱动详解
简介本资源是一份面向Linux内核开发者与嵌入式系统工程师的BMI260六轴IMU驱动模块专为博世BMI260惯性测量单元设计解决其在Linux平台下加速度计与陀螺仪功能缺失或支持不完善的问题适用于工业控制、运动追踪、姿态感知等实时传感场景。压缩包共11个文件含2个核心C源码bmi260_i2c.c、bmi260_core.c、2个头文件bmi260.h、bmi260_config.h、Makefile构建脚本、DKMS配置文件dkms.conf、Arch Linux打包脚本PKGBUILD、README.md说明文档、.gitignore及附赠的Word格式安装配置指南附赠资源.docx和纯文本功能概要说明文件.txt整体仅55KB轻量易集成。已有54人学习下载资源结构清晰以BMI160驱动为基线演进而来兼顾兼容性与BMI260新增特性如更高精度采样、低功耗模式支持提供完整编译加载流程与硬件接口抽象便于读者快速移植、调试并拓展至实际项目。 最近在调一个可穿戴设备的姿态解算模块选型时用了博世BMI260这颗六轴IMU。它有加速度计和陀螺仪和内核里已有的BMI160驱动在寄存器层面上有不少相通的地方但Linux主线并没有直接支持BMI260的独立驱动。我最后做的方案非常直接基于现有内核BMI160驱动框架适配出一份BMI260专用的内核驱动模块。这篇文章就把完整的移植思路、寄存器差异、代码实现和调试过程整理出来给正在做IMU驱动开发的朋友一个能直接参考的路径。整个驱动最终挂到了IIO子系统里应用层通过iio设备节点读加速度和角速度数据也支持中断触发和数据buffer读取。整个过程踩了不少坑尤其是芯片ID判断、数据寄存器长度、量程换算这几个地方属于那种手册上写了但很容易忽略的细节。这篇内容会从硬件差异讲到代码细节再到设备树和常见问题排查篇幅有点长但每一节都是实打实的知识点。1. 项目背景与整体设计思路1.1 BMI260 是一颗怎样的IMUBMI260是博世推出的一款六轴惯性测量单元内部整合了三轴MEMS加速度计和三轴MEMS陀螺仪封装尺寸很小功耗控制也不错很适合用在便携式设备里。和更早期的BMI160对比BMI260主要改善了传感器噪声性能和温度漂移尤其在高动态场景下陀螺仪数据的稳定性会明显好一些。我这次项目的需求是采集六轴原始数据然后在MCU/DSP侧做姿态融合因此IMU驱动必须稳定、低延迟并且能够配置不同的量程和输出速率。这颗芯片支持I2C和SPI两种通信接口I2C地址可以通过SDO引脚配置为0x68或0x69SPI支持四线模式。片内集成FIFO可以缓存传感器数据适合配合中断批量读取。对Linux驱动来说这几个硬件特性都很有价值I2C/SPI可以走内核regmapFIFO和中断可以配合IIO触发器和buffer机制实现高效的批量采集。我选它还有一个很重要的原因BMI260的大多数基础寄存器和BMI160保持兼容包括数据输出寄存器、CMD寄存器、量程配置寄存器等。这意味着驱动移植不需要从零开始而是可以基于成熟的内核BMI160驱动做增量适配。但是兼容不等于完全一致芯片ID寄存器、部分配置寄存器的默认值、陀螺仪性能参数都有差异所以不能简单地把BMI160驱动里的芯片ID改成BMI260就完事必须逐项核对。1.2 为什么选择基于BMI160驱动适配Linux内核里现有的BMI160驱动位于drivers/iio/imu/bmi160/已经实现了完整的IIO驱动框架包括I2C/SPI regmap初始化、设备树匹配、加速度计和陀螺仪的通道定义、数据读取、中断配置、FIFO支持等。从功能完整性来看这套框架非常扎实我只需要在它的基础上抽离出BMI260需要的那部分逻辑再替换掉寄存器配置和芯片匹配信息就能很快得到一个可用的驱动。如果用博世官方提供的Sensor API驱动包原理上也能跑但官方驱动通常是独立的字符设备驱动和Linux IIO子系统不打通。我们产品里其他传感器都已经用IIO框架管理应用层统一通过/sys/bus/iio/devices/iio:deviceX/读取数据如果BMI260走独立字符设备就得单独维护一套读取协议非常不划算。所以从系统架构角度看让BMI260也进IIO是更干净的选择。另外还有一个原因BMI160驱动已经过了大量内核review和实际产品验证涉及到的并发处理、缓存对齐、读取时序等问题都已经处理过了。我的移植工作重点是“差异适配”而不是“重新发明轮子”。这种思路在实际项目里非常高效也能减少很多低级bug。当然适配不是直接复制文件而是参考它的逻辑重新组织BMI260专属的驱动文件避免和原驱动产生符号冲突。1.3 驱动模块的整体架构驱动模块从整体上分为四层。第一层是物理传输层负责通过I2C或SPI和BMI260芯片交换数据这里直接复用内核的regmapAPI代码里只需要配置 regmap 的读写函数即可。第二层是芯片配置层负责初始化BMI260的寄存器、配置量程和采样率、控制待机/正常模式这部分是BMI260差异化的核心。第三层是IIO设备层向内核注册加速度计和陀螺仪通道并提供read_raw、write_raw等回调接口。第四层是事件/数据层负责处理中断、FIFO和数据读取将原始MEMS数据交给上层应用。在实际文件组织上我保留了类似BMI160驱动的风格一个bmi260_core.c放核心逻辑一个bmi260_i2c.c和bmi260_spi.c放总线适配代码头文件定义寄存器地址和私有数据结构。这样移植到新平台时只需要改总线相关文件核心逻辑可以保持不变。2. 硬件协议与寄存器差异分析2.1 I2C/SPI 接口配置BMI260的I2C接口非常标准支持标准模式、快速模式最高速率可以到1MHz。I2C设备地址由SDO引脚决定SDO接地时地址是0x68SDO接高电平是0x69。在多传感器系统中I2C地址冲突是个很容易踩的坑如果板上还有别的传感器也占用了0x68一定要通过SDO引脚错开。使用SPI时BMI260工作在主模式下的从机角色支持最高10MHz时钟。这里要注意SPI模式BMI260手册要求的是CPOL0、CPHA0和很多标准SPI外设一致。SPI读写操作和I2C不同读寄存器时需要先发送寄存器地址再把最高位置1表示读请求写寄存器则直接发送地址和数据。如果直接沿用水内核驱动里SPI的regmap配置这个问题通常会被封装好但如果是裸写寄存器一定要留意。我在调I2C时还发现一个问题不能用i2cdetect在驱动加载后直接扫描0x68因为设备已经被内核驱动占用扫描会返回异常。建议先在未加载驱动的状态下扫描确认设备地址再加载驱动验证。还有一个细节是BMI260的burst读方式可以一次性连续读出多个寄存器的数据例如一次性读取加速度计和陀螺仪的全部6轴数据但要保证读操作是连续的不能拆成多个单字节I2C读事务否则可能在两次读之间数据发生变化导致组合出来的三轴数据不是同一个采样点。2.2 BMI260与BMI160的寄存器映射差异BMI260虽然在继承BMI160寄存器体系但并不是完全一致。我这次移植时重点关注了几个差异点芯片ID寄存器、软复位寄存器、量程配置寄存器、数据输出寄存器偏移、FIFO相关寄存器。芯片ID寄存器是最典型的差异。BMI160的chip_id读出来是0xD1BMI260则是另一个值具体以芯片手册标注为准。如果驱动里的whoami校验还是等于0xD1就会导致probe直接失败。实际项目中我们不能假设所有寄存器都一致必须逐字节读一遍特别是芯片ID、错误状态寄存器、内部状态寄存器这些基础信息。和BMI160相比BMI260的CMD寄存器地址和主要功能位置相同软复位都需要往CMD寄存器写入0xB6。不过软复位之后芯片进入休眠模式还是正常模式不同版本的芯片行为可能有差异我建议驱动初始化时先软复位然后延时等待再重新配置模式而不是依赖默认值。量程配置方面BMI260同样支持加速度计±2g/±4g/±8g/±16g陀螺仪±125/±250/±500/±1000/±2000dps。寄存器地址和BMI160基本一致但配置位所在的位置以及默认值要仔细核对不能想当然。这里最安全的做法是移植前先用手册的寄存器位定义把BMI160驱动里的宏替换成BMI260的宏并加一个编译期检查。2.3 关键寄存器初始化流程初始化流程我总结为以下几步读取chip_id校验芯片存在且型号正确。软复位写0xB6到CMD寄存器延时20ms左右等待芯片稳定。将传感器从待机模式切换到正常模式。BMI260有多种电源模式包括待机、正常、低功耗、暂停等我一般先用正常模式调试。配置加速度计量程和输出数据速率。配置陀螺仪量程和输出数据速率。如果使用中断配置中断引脚和中断类型。如果使用FIFO配置FIFO水印和FIFO模式。读取一次所有通道数据确认不是全0或者乱码。初始化顺序非常关键。有一次我直接把加速度计和陀螺仪都配置到正常模式然后立即去读传感器ID和状态寄存器结果读到的是0xFF就是因为没有等芯片从软复位中恢复。后来在每次配置之间加了延时问题就消失了。另一个关键点是有些寄存器只能在待机模式下配置比如量程和采样率如果芯片处于正常模式写入不生效。驱动里需要先切换到待机配置完再切回正常模式。3. 驱动代码实现与核心逻辑拆解3.1 驱动框架与文件结构我沿用了BMI160驱动的文件结构创建了bmi260.h、bmi260_core.c、bmi260_i2c.c、bmi260_spi.c。核心数据结构里保存了struct regmap、设备指针、中断信息、量程/采样率配置、数据缓冲等字段。驱动入口通常放在总线驱动里I2C驱动用module_i2c_driver注册SPI驱动用module_spi_driver注册。核心probe函数由总线驱动调用完成以下工作static int bmi260_core_probe(struct device *dev, struct regmap *regmap, int irq) { struct iio_dev *indio_dev; struct bmi260_data *data; int ret; indio_dev devm_iio_device_alloc(dev, sizeof(*data)); if (!indio_dev) return -ENOMEM; data iio_priv(indio_dev); >static int bmi260_chip_init(struct bmi260_data *data) { unsigned int val; int ret; ret regmap_read(data-regmap, BMI260_REG_CHIP_ID, val); if (ret) return ret; if (val ! BMI260_CHIP_ID) { dev_err(data-dev, invalid chip id 0x%02x\n, val); return -ENODEV; } ret regmap_write(data-regmap, BMI260_REG_CMD, BMI260_CMD_SOFTRESET); if (ret) return ret; msleep(20); /* 配置加速度计±4g采样率100Hz */ ret regmap_update_bits(data-regmap, BMI260_REG_ACC_CONF, BMI260_ACC_RANGE_MASK | BMI260_ACC_ODR_MASK, BMI260_ACC_RANGE_4G | BMI260_ACC_ODR_100HZ); if (ret) return ret; /* 配置陀螺仪±500dps采样率100Hz */ ret regmap_update_bits(data-regmap, BMI260_REG_GYR_CONF, BMI260_GYR_RANGE_MASK | BMI260_GYR_ODR_MASK, BMI260_GYR_RANGE_500DPS | BMI260_GYR_ODR_100HZ); if (ret) return ret; /* 按需配置中断 */ return 0; }在配置前我建议把芯片先切换到待机模式等配置完成后再切回正常模式。因为BMI260在正常模式下部分配置寄存器可能不能直接修改。这个操作要在芯片初始化时做否则可能出现寄存器写了但读回来还是旧值的情况。另外regmap_update_bits的使用可以避免覆盖同一寄存器里其他位段这是IMU驱动开发里非常基础但容易忽略的点。很多寄存器在一个字节里同时存放了量程、滤波和采样率的位段如果用regmap_write直接整字节写入很容易把其他字段改错。3.3 数据读取与中断处理BMI260的数据寄存器按照固定顺序排列可以一次性读取6个字节分别对应加速度计X/Y/Z和陀螺仪X/Y/Z的高低位。使用二字节小端格式的补码。IIO驱动里的读取函数一般通过regmap_bulk_read将数据一次性读入缓冲static int bmi260_read_raw(struct iio_dev *indio_dev, struct iio_chan_spec const *chan, int *val, int *val2, long mask) { struct bmi260_data *data iio_priv(indio_dev); unsigned int reg; __le16 buf; int ret; switch (mask) { case IIO_CHAN_INFO_RAW: reg BMI260_REG_DATA_START chan-scan_index * 2; ret regmap_bulk_read(data-regmap, reg, buf, sizeof(buf)); if (ret) return ret; *val sign_extend32(le16_to_cpu(buf), 15); return IIO_VAL_INT; case IIO_CHAN_INFO_SCALE: /* 根据当前量程返回scale */ ... } return -EINVAL; }这里chan-scan_index用来计算数据寄存器偏移既简洁又不容易出错。加速度计和陀螺仪的数据寄存器在BMI260里是连续的所以使用同一个BMI260_REG_DATA_START起始地址加上偏移即可。如果使用中断就需要在中断服务程序里读取数据并送给IIO buffer。中断服务程序尽量只做标记然后通过schedule_work或iio_trigger_poll将工作放到线程上下文处理避免在中断上下文做耗时操作。BMI260支持数据就绪中断也就是新数据产生时引脚触发一次这在低功耗场景非常有用应用层不需要频繁轮询。3.4 加速度计与陀螺仪数据转换BMI260输出的是16位有符号原始值需要乘以一个scale系数才能转换成真实物理量。加速度计的标准单位是m/s^2陀螺仪的标准单位是rad/s。以加速度计±4g为例物理范围是±4 * 9.80665 m/s^2也就是约±39.2266m/s^2量程扩展到32768因此每个LSB对应的物理量为39.2266 / 32768 ≈ 0.001197 m/s^2。所以读取到原始值1000对应的加速度大约是1.197m/s^2。陀螺仪以±500dps为例满量程物理范围是±500度/秒每个LSB对应的角速度为500 / 32768 ≈ 0.01526 dps。换算成弧度制时需要再乘以π / 180所以最终scale是0.01526 * π / 180 ≈ 0.0002663 rad/s。在IIO驱动里我将scale作为分数返回例如scale 0.001197对应整数值1197和1000000应用层读到的格式是两个整数需要自行相除。为了让数据精度更高建议在应用层用浮点数计算scale不要在驱动里做浮点运算因为内核驱动里使用浮点是不推荐的。3.5 功耗管理与待机模式BMI260的电源模式控制也是驱动开发的重点。默认情况下芯片上电后可能处于待机模式。待机模式下传感器不采集数据电流很低正常模式下加速度计和陀螺仪才真正工作。驱动里可以通过CMD寄存器发送BMI260_CMD_WAKEUP和BMI260_CMD_SLEEP控制状态。实际项目中我一般是在系统休眠时让IMU进入待机模式在恢复时再退回到正常模式。如果应用需要低功耗但保持连续采集可以配置中断唤醒让SoC在数据到达时唤醒。这里要注意切换模式后需要延时几个毫秒等芯片稳定否则立刻读取数据可能读到上一次的数据。另一个重要点是BMI260支持加速度计单独工作和陀螺仪单独工作。如果应用只需要计步或者倾角测量可以只开加速度计陀螺仪不进入正常模式功耗能低很多。驱动层面需要把加速度计和陀螺仪的配置拆开不要一刀切地同时切换电源模式。4. 设备树配置与驱动编译加载4.1 设备树节点写法设备树是Linux驱动匹配硬件信息的核心。在I2C总线下BMI260的设备树节点大致如下i2c2 { status okay; clock-frequency 400000; bmi26068 { compatible bosch,bmi260; reg 0x68; interrupt-parent gpio1; interrupts 13 IRQ_TYPE_LEVEL_LOW; status okay; }; };如果使用SPI接口则需要放在SPI总线下并且注意reg写的是片选编号不是I2C地址。SPI节点示例spi3 { status okay; bmi2600 { compatible bosch,bmi260; reg 0; spi-max-frequency 5000000; interrupt-parent gpio1; interrupts 13 IRQ_TYPE_LEVEL_LOW; status okay; }; };这里的compatible字符串必须和驱动里of_device_id表保持一致。如果设备树里写的是bosch,bmi260驱动中也要有对应的匹配项static const struct of_device_id bmi260_of_match[] { { .compatible bosch,bmi260 }, { } }; MODULE_DEVICE_TABLE(of, bmi260_of_match);我调试中经常遇到设备树里compatible写错导致驱动probe根本执行不到的情况这类错误排查起来不算难但还是建议先从/sys/bus/iio/devices/下看有没有新增设备节点如果没有再看驱动是否被加载最后确认设备树匹配状态。4.2 内核编译配置驱动编译有两种方式编入内核镜像或者编译成独立模块。我推荐在开发阶段使用独立模块方便修改和重新加载。在驱动目录下需要修改对应的Kconfig和Makefile。如果新建驱动目录需要先添加Kconfig条目config BMI260_IIO tristate Bosch BMI260 IMU driver depends on I2C || SPI select REGMAP_I2C select REGMAP_SPI help Say yes here to build support for Bosch BMI260 six-axis IMU.Makefile中添加obj-$(CONFIG_BMI260_IIO) bmi260_core.o bmi260_i2c.o bmi260_spi.o然后在内核配置界面开启BMI260_IIO。编译模块后生成bmi260_core.ko、bmi260_i2c.ko、bmi260_spi.ko加载时需要注意顺序insmod bmi260_core.ko insmod bmi260_i2c.ko如果驱动编入内核就不存在加载顺序问题但调试验证周期会长一些。开发阶段还是模块方式更方便。4.3 模块加载与验证模块加载成功后可以通过IIO用户空间接口验证驱动是否正常工作。先看内核日志dmesg | grep bmi260确认没有报错后查看IIO设备节点ls /sys/bus/iio/devices/正常情况下应该看到一个iio:deviceX。进入该目录查看可用通道cat /sys/bus/iio/devices/iio:deviceX/name cat /sys/bus/iio/devices/iio:deviceX/in_accel_scale cat /sys/bus/iio/devices/iio:deviceX/in_anglvel_scale读取原始数据cat /sys/bus/iio/devices/iio:deviceX/in_accel_x_raw cat /sys/bus/iio/devices/iio:deviceX/in_anglvel_z_raw如果设备支持IIO buffer还可以用工具如iio_generic_buffer或iiod获取批量数据。我更推荐在开发初期直接用cat读原始值因为这样可以快速确认传感器是否响应排除路径问题。5. 常见问题与排查技巧5.1 传感器ID读取错误症状是驱动probe时打印invalid chip id或者读到的chip_id是0xFF、0x00。首先检查I2C地址或SPI片选是否配对其次检查SDO引脚电平是否正确再检查电源是否稳定。有一个容易忽略的原因如果前一个驱动或者uboot已经把BMI260放到某个模式读取ID前需要先软复位。另一个常见原因是I2C总线频率过高传感器在I2C读写时状态不稳定导致读回0xFF。这时可以降低I2C频率到100kHz试试。如果chip_id还是不对直接用逻辑分析仪抓I2C波形确认主设备是否真的发送了正确的寄存器地址和读命令。芯片ID问题基本都能通过这三步解决。5.2 数据全零或噪声过大数据全零通常说明寄存器地址读错或者传感器没有真正进入正常模式。我遇到过一种情况配置了量程和采样率但忘记把芯片从待机模式切到正常模式导致加速度计和陀螺仪的数据寄存器一直是0。另外如果读的是FIFO但FIFO没有写入数据也会出现全零。噪声过大的原因一般是量程配置太小或采样率过高。比如在振动环境中如果加速度计量程只有±2g高动态冲击会导致输出进入饱和表现为数据跳变。此时需要根据实际应用把量程调整到±8g或±16g。另外陀螺仪对震动比较敏感如果板子机械固定不好数据噪声会明显增大可以在应用中加低通滤波或者调整BMI260内部滤波带宽。还有一个常见的软件坑读取数据时没有用le16_to_cpu转换字节序导致高字节和低字节交换数据看起来跳变得很夸张。这类问题在I2C和SPI下都可能出现一定要确认数据寄存器的字节序配置。5.3 中断不触发中断不触发时先检查设备树中中断GPIO是否配置正确再看BMI260中断引脚是否使能。BMI260的INT1和INT2默认可能是关闭的需要显式写入中断映射寄存器把数据就绪中断映射到对应引脚。还要确认中断类型是否符合设备树配置。如果你在设备树里配置为IRQ_TYPE_LEVEL_LOW但芯片实际拉高触发那永远等不到中断。我调试时常用GPIO sysfs先把中断脚设为输入用cat /sys/kernel/debug/gpio查看引脚电平变化再回来调整驱动。如果中断触发频率太高也可能导致系统负载异常。这个通常是不小心把中断配置成了“任意数据变化触发”而不是“新数据就绪触发”需要检查中断映射寄存器的设置。5.4 陀螺仪零偏校准陀螺仪即使静止不动输出也不完全为0这是MEMS器件的正常现象。在姿态解算前一定要做零偏校准。简单做法是让设备水平静止5秒采样陀螺仪数据取平均得到每个轴的零偏值然后在应用层减去这个偏移。BMI260部分版本支持内部偏移寄存器可以把校准后的offset写回芯片。但要注意这个offset会影响所有后续数据如果产品在产线上做一次性校准写芯片比较方便如果应用需要长期稳定性我更建议在应用层维护offset因为芯片寄存器空间有限而且写入偏移寄存器后需要重新初始化。在校准过程中还有一个小技巧不要只采几个点就平均最好采集成百上千个点然后取中位数或者均值。对于低成本MEMS器件噪声是高斯分布均值能有效减小随机噪声带来的偏差。这次移植工作总体上挺顺利但有一个教训我印象特别深刚开始为了图省事直接在BMI160驱动基础上改芯片ID结果probe倒是通过了但读取加速度数据和陀螺仪数据的寄存器偏移对不上数据跳变非常严重。后来我静下心把BMI260手册和BMI160手册的寄存器图逐页对照重新整理了所有偏移和掩码问题才算彻底解决。之后我养成了一个习惯只要做IMU驱动移植先把寄存器表格用脚本提取出来做一次自动对比再开始写代码。这个小习惯帮我在后续的传感器驱动开发里省了很多时间也推荐你试试。本文还有配套的精品资源点击获取