i.MX95‑19x19‑EVK 开发板出厂 M.2 接口默认配置为 PCIe 模式 WiFi 模块。Murata 2EL(IW612)属于 SDIO 接口 M.2 无线模组,无法直接使用默认 PCIe 硬件配置。本文完整还原 Android 16(imx‑android‑16.0.0_1.4.0)BSP 环境下 IW612 模组移植、设备树修改、DTBO 镜像编译、镜像替换、烧录、功能验证全流程,同时说明工具链版本、固件路径、驱动模块路径、拨码开关配置,梳理移植过程典型问题点,面向嵌入式 Android 平台无线驱动移植开发人员。
资料获取:NXP Wi-Fi&Bluetooth-iMX95-19x19-EVK Android 16上Bringup IW612 WiFi 和蓝牙
1. 项目背景与硬件约束
i.MX95‑19x19‑EVK 开发板 M.2 插槽硬件同时引出 PCIe、SDIO 信号。出厂设备树默认启用 pcie0,适配 PCIe 接口 M.2 无线模块;Murata 2EL(IW612)是 SDIO 接口 M.2 模组,不能直接复用 PCIe 配置。 移植核心变更:禁用pcie0节点,启用usdhc3作为 SDIO 无线模块总线,配置电源时序、引脚复用,编译 DTBO 设备树叠加镜像,替换原有 dtbo 镜像完成适配。 BSP 版本固定:imx‑android‑16.0.0_1.4.0_ANDROID_SOURCE,预编译镜像版本:16.0.0_1.4.0_DEMO_95,版本必须一一匹配,不可混用其他 BSP 版本。
2. 整体开发环境准备
2.1 BSP 源码包下载与解压
下载imx‑android‑16.0.0_1.4.0.tar.gz,通过 scp 上传到编译主机 VMSIS 环境,执行解压命令:
tar -xzf imx-android-16.0.0_1.4.0.tar.gz
2.2 Android 源代码拉取
进入源码根目录,执行脚本拉取 Android 源码:
source ./imx_android_setup.sh
2.3 GCC 交叉编译工具链部署
工具链版本:Arm GNU Toolchain 15.3.rel1,i.MX95 平台需要同时 AArch64、AArch32 两套工具链。
- 64 位工具链文件:
arm‑gnu‑toolchain‑15.3.rel1‑x86_64‑aarch64‑none‑linux‑gnu.tar.xz - 32 位工具链文件:
arm‑gnu‑toolchain‑15.3.rel1‑x86_64‑arm‑none‑eabi.tar.xz
部署操作:
#64位工具链解压
sudo tar -xvJf arm-gnu-toolchain-15.3.rel1-x86_64-aarch64-none-linux-gnu.tar.xz -C /opt/
export AARCH64_GCC_CROSS_COMPILE=/opt/arm-gnu-toolchain-15.3.rel1-x86_64-aarch64-none-linux-gnu/bin/aarch64-none-linux-gnu‑
#32位工具链解压
sudo tar -xvJf arm-gnu-toolchain-15.3.rel1-x86_64-arm-none-eabi.tar.xz -C /opt/
export AARCH32_GCC_CROSS_COMPILE=/opt/arm-gnu-toolchain-15.3.rel1-x86_64-arm-none-eabi/bin/arm-none-eabi‑
注意 export 环境变量仅对当前终端会话生效,切换终端需要重新执行 export。
2.4 内核预编译工具、构建环境初始化
- 设置 clang、kernel‑build‑tools、Rust 等内核编译依赖预编译组件
sudo ./device/nxp/common/tools/setup_android_kernel_prebuilts.sh
- 初始化 Android 构建环境,选择 evk_95‑nxp_stable‑userdebug 编译目标
source build/envsetup.sh
lunch evk_95-nxp_stable-userdebug
可选完整全镜像编译:
./imx-make.sh -j4 2>&1 | tee build-log.txt
本案例仅需要编译 DTBO 镜像,不需要完整编译整机镜像。
3. 设备树 DTS 关键修改
文件路径:vendor/nxp‑opensource/kernel_imx/arch/arm64/boot/dts/freescale/imx95‑19x19‑evk.dts
参考 git diff 对比输出,核心变更:
- aliases 增加
mmc2 = &usdhc3; - 新增
usdhc3_pwrseq电源时序节点; - 将
&pcie0状态由okay修改为disable,关闭默认 PCIe0; - 完整新增
&usdhc3节点配置,配置 pinctrl 多速率状态、电源域、bus‑width=4、non‑removable、wakeup‑source 等属性; - 补充 usdhc3 全套 pinctrl 引脚组:
pinctrl_usdhc3_pwrseq、pinctrl_usdhc3、pinctrl_usdhc3_100mhz、pinctrl_usdhc3_200mhz引脚复用配置。
3.1 DTS 完整变更片段
/ {
aliases {
mmc0 = &usdhc1;
mmc1 = &usdhc2;
+ mmc2 = &usdhc3;
serial0 = &lpuart1;
ethernet0 = &enetc_port0;
ethernet1 = &enetc_port2;
};
+ usdhc3_pwrseq: usdhc3_pwrseq {
+ compatible = "mmc-pwrseq-simple";
+ pinctrl-names = "default";
+ pinctrl-0 = <&pinctrl_usdhc3_pwrseq>;
+ post-power-on-delay-ms = <100>;
};
···
&pcie0 {
reset-gpio = <&i2c7_pcal6524 5 GPIO_ACTIVE_LOW>;
vpcie-supply = <®_pcie0>;
supports-clkreq;
‑ status = "okay";
+ status = "disable";
};
···
+&usdhc3 {
+ pinctrl-names = "default", "state_100mhz", "state_200mhz", "sleep";
+ pinctrl-0 = <&pinctrl_usdhc3>;
+ pinctrl-1 = <&pinctrl_usdhc3_100mhz>;
+ pinctrl-2 = <&pinctrl_usdhc3_200mhz>;
+ pinctrl-3 = <&pinctrl_usdhc3>;
+ mmc-pwrseq = <&usdhc3_pwrseq>;
+ vmmc-supply = <®_pcie0>; /*Both PCIE0 and USDHC3 use same power supply. */
+ bus-width = <4>;
+ keep-power-in-suspend;
+ non-removable;
+ wakeup-source;
+ status = "okay";
+};
同时在文件末尾补齐全套pinctrl_usdhc3*引脚配置,包含 pwrseq、default、100mhz、200mhz 四组 IO 复用。
4. DTBO 镜像编译方法
参考图 2 dtbo.mk;图 3 BoardConfig.mk 配置片段 DTBO 是设备树叠加镜像,i.MX95 平台默认使用 DTBO 机制,没有开启 SUPPORT_GBL,dtbo.img 独立产出,编译耗时大约 40 分钟。
4.1 编译命令
source build/envsetup.sh
lunch evk_95-nxp_stable-userdebug
./imx-make.sh dtboimage -j4
编译产物输出路径:out/target/product/evk_95/dtbo‑imx95.img,通过文件时间戳确认编译已经更新。
4.2 Makefile 配置说明
device/nxp/common/build/dtbo.mk:DTBO 镜像打包逻辑;device/nxp/imx9/evk_95/SharedBoardConfig.mk:SUPPORT_GBL宏默认关闭,DTBO 独立镜像生效;开启该宏才会把 dtb 打包进 vendorboot 镜像。BoardConfig.mk定义BOARD_PREBUILT_DTBOIMAGE指向输出 dtbo‑imx95.img。
5. 固件、内核驱动模块文件路径说明
参考图 4 固件目录;图 5 驱动源码目录
- WiFi / 蓝牙固件目录
vendor/nxp/imx‑firmwares/FwImage_IW612_SD,存放 IW612 SDIO 版本固件。 - MWLAN 驱动源码目录
vendor/nxp‑opensource/nxp‑mwifiexs,编译输出mlan.ko、moal.ko,同时生成 cfg80211.ko。 编译输出 ko 文件可以通过 find 命令检索:
find -name cfg80211.ko
6. 镜像替换与开发板烧录流程
6.1 dtbo.img 备份替换
- 获取版本匹配预编译镜像包
16.0.0_1.4.0_DEMO_95; - 将预编译镜像目录原始
dtbo‑imx95.img重命名备份:dtbo‑imx95_original.img; - 将编译输出的
out/target/product/evk_95/dtbo‑imx95.img复制到预编译镜像目录,完成替换。
6.2 开发板拨码、UUU 烧录
- SW1‑SW4 拨码设置为1001,进入 USB 串行下载 SDP 模式;
- Type‑C 线缆连接开发板 USB1 端口与 Windows 主机;
- 从 github nxp‑imx/mfgtools Releases 下载 UUU 二进制工具;
- Windows 管理员 CMD,进入预编译镜像目录,执行烧录脚本:
uuu_imx_android_flash.bat -f imx95 -a -e -u trusty-dual
烧录输出Success 1 Failure 0代表烧录完成。
7. 系统启动后功能验证
7.1 内核 dmesg 日志校验
断电,将 SW7 拨码切换为1010,切换为 eMMC 启动模式,上电开机。 执行dmesg查看内核打印日志,关键成功标识:
mlan: loading out‑of‑tree module taints kernel.wlan:Loading MWLAN driverSDIW612:init module param from usr cfgWLAN FW is active- 依次注册 wlan0、p2p0 网络接口;
wlan: Driver loaded successfully。
日志出现固件下载(FW download)、固件激活打印,代表 SDIO 总线通信正常,IW612 固件加载完成。
7.2 Android 上层界面确认
进入 Android 系统设置:
- 查看 WLAN 设置页面,可以扫描 WiFi 热点;
- 蓝牙设置页面可以正常打开、扫描蓝牙设备。
没有 LCD 显示屏,可以使用 scrcpy 工具通过 USB 远程投屏访问 Android 界面,完成功能确认。
8. 工程实操 FAQ
Q1:BSP 版本和预编译镜像版本可以不匹配吗?
A:不可以。必须严格使用 imx‑android‑16.0.0_1.4.0 的源码包和对应 16.0.0_1.4.0_DEMO_95 预编译镜像,版本不一致会导致 dtbo 镜像不兼容,系统启动异常。
Q2:修改 DTS 之后,只需要编译 dtboimage,不需要全量编译整机镜像吗?
A:本移植场景只改动设备树,仅编译 dtboimage 即可,不需要执行完整imx‑make.sh全量编译。但是驱动 ko、固件仍然依赖 BSP 源码树完整。
Q3:pcie0 和 usdhc3 共用 reg_pcie0 电源,会有什么风险?
A:文档 DTS 中明确说明硬件二者共用一路电源域;pcie0 已经 disable,usdhc3 使用该电源给 SDIO 模组供电,硬件原理图支持该用法。
Q4:烧录完成 dmesg 看不到 wlan 驱动打印,排查顺序?
A:1)确认 dtbo.img 已经是自己编译输出的版本,没有忘记替换;2)确认 SW7 拨码烧录完成后切换为 eMMC 启动 1010;3)确认 DTS 中 pcie0=disable,usdhc3 status=okay;4)核对引脚 pinctrl 配置;5)确认固件目录存在 IW612‑SD 固件文件。
Q5:dmesg 报固件下载失败是什么原因?
A:优先核对固件路径,确认 BSP 包中 FwImage_IW612_SD 固件文件完整;SDIO 总线时序、pinctrl 引脚配置错误也会导致固件加载失败。
Q6:为什么不能直接使用开发板默认 PCIe M.2 配置跑 IW612?
A:IW612(Murata2EL)模组硬件接口为 SDIO,物理 M.2 插槽引脚虽然兼容,但是芯片侧通信总线是 SDIO,不支持 PCIe 通信,硬件层面不能跑 PCIe 模式。
本文全部技术内容引自 NXP 文档《iMX95‑19x19‑EVK Android 16 上 Bringup IW612 WiFi 和蓝牙》,全部命令、设备树片段、拨码配置、文件路径完整还原原文,没有新增文档以外观点。NXP 保留修改 BSP、工具链、硬件规格权利;本文仅供工程开发参考,不构成商业承诺,文档不授予任何知识产权许可。
33