• 正文
  • 相关推荐
申请入驻 产业图谱

i.MX95‑19x19‑EVK Android16 平台 Bringup IW612 WiFi & 蓝牙技术

40分钟前
33
加入交流群
扫码加入
获取工程师必备礼包
参与热点资讯讨论

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 内核预编译工具、构建环境初始化

  1. 设置 clang、kernel‑build‑tools、Rust 等内核编译依赖预编译组件
sudo ./device/nxp/common/tools/setup_android_kernel_prebuilts.sh
  1. 初始化 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 对比输出,核心变更:

  1. aliases 增加mmc2 = &usdhc3;
  2. 新增usdhc3_pwrseq电源时序节点;
  3. 将&pcie0状态由okay修改为disable,关闭默认 PCIe0;
  4. 完整新增&usdhc3节点配置,配置 pinctrl 多速率状态、电源域、bus‑width=4、non‑removable、wakeup‑source 等属性;
  5. 补充 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 = <&reg_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 = <&reg_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 配置说明

  1. device/nxp/common/build/dtbo.mk:DTBO 镜像打包逻辑;
  2. device/nxp/imx9/evk_95/SharedBoardConfig.mk:SUPPORT_GBL宏默认关闭,DTBO 独立镜像生效;开启该宏才会把 dtb 打包进 vendorboot 镜像。
  3. BoardConfig.mk定义BOARD_PREBUILT_DTBOIMAGE指向输出 dtbo‑imx95.img。

5. 固件、内核驱动模块文件路径说明

参考图 4 固件目录;图 5 驱动源码目录

  1. WiFi / 蓝牙固件目录 vendor/nxp/imx‑firmwares/FwImage_IW612_SD,存放 IW612 SDIO 版本固件。
  2. MWLAN 驱动源码目录 vendor/nxp‑opensource/nxp‑mwifiexs,编译输出mlan.ko、moal.ko,同时生成 cfg80211.ko。 编译输出 ko 文件可以通过 find 命令检索:
find -name cfg80211.ko

6. 镜像替换与开发板烧录流程

6.1 dtbo.img 备份替换

  1. 获取版本匹配预编译镜像包16.0.0_1.4.0_DEMO_95;
  2. 将预编译镜像目录原始dtbo‑imx95.img重命名备份:dtbo‑imx95_original.img;
  3. 将编译输出的out/target/product/evk_95/dtbo‑imx95.img复制到预编译镜像目录,完成替换。

6.2 开发板拨码、UUU 烧录

  1. SW1‑SW4 拨码设置为1001,进入 USB 串行下载 SDP 模式;
  2. Type‑C 线缆连接开发板 USB1 端口与 Windows 主机;
  3. 从 github nxp‑imx/mfgtools Releases 下载 UUU 二进制工具;
  4. 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查看内核打印日志,关键成功标识:

  1. mlan: loading out‑of‑tree module taints kernel.
  2. wlan:Loading MWLAN driver
  3. SDIW612:init module param from usr cfg
  4. WLAN FW is active
  5. 依次注册 wlan0、p2p0 网络接口;
  6. wlan: Driver loaded successfully。

日志出现固件下载(FW download)、固件激活打印,代表 SDIO 总线通信正常,IW612 固件加载完成。

7.2 Android 上层界面确认

进入 Android 系统设置:

  1. 查看 WLAN 设置页面,可以扫描 WiFi 热点;
  2. 蓝牙设置页面可以正常打开、扫描蓝牙设备。

没有 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、工具链、硬件规格权利;本文仅供工程开发参考,不构成商业承诺,文档不授予任何知识产权许可。

相关推荐