1        Android平台的Wifi模块移植要点

1.1      Wifi结构

user interface

Android WiFiService

WPA_Supplicant

DHD Driver

Dongle Binary

BCM43xxHardware

蓝色：需要修改

黑色：不需要修改

蓝色部分是为了在android环境下，支持bcm43xx芯片需要修改的部分，各个部分的功能如下：

1. User interface（用户接口层）：控制和设置wifi的用户接口层

2. Android wifi service：它是android系统中的wifi服务部分，主要用来启动和停止wpa_supplicant，并作为用户接口层和wpa_supplicant交互的桥梁存在

3. Wpa_supplicant：支持wpa和wapi的外部库

4. Dhd driver：wifi模块的驱动

5. Dongle binary：BCM43xx的固件

6. BCM43xx：wifi的硬件芯片（是一个组合集成芯片）

1.2      Wifi模块环境

Wifi模块环境包括以下部分：

1.      bcm43xx驱动源码

2.      wpa_supplicant和支持WAPI的wapilib库

3.      nvram.txt（BCM43xx芯片配置文件）

4.      wpa_supplicant.conf和wifi固件

一般来说，第三和第四条件的文件在BCM43xx源码中都有包含。

1.3      Wifi模块的编译

1.3.1       Wifi驱动源码

这里不以某个类型的BCM43xx芯片和android版本作为特例来讲解wifi模块的编译过程，只是对编译的通用部分做简要的说明。

一般来说，wifi模块的编译可采用两种红方式：一是内部编译，二是模块编译。通常使用的是模块编译，这里也以模块编译wifi模块为例来说明wifi模块的编译过程。

在wifi模块驱动源码中，主要包含以下几个目录：

Firmware：里面会提供对应BCM43xx芯片的固件

Config：提供wpa_supplicant.conf和nvram.txt以及dhcpcd.conf，还有android.mk文件。如果没有上面的配置文件，需要找到放入该目录。

Android.mk：这是一个文件，也是编译android平台编译wifi模块的入口

Src：wifi驱动的源码目录

其实，你看到的broadcom提供的驱动源码可能的组织方式跟上面是有差别的，但大致的内容差不多，上面只是针对模块源码中目录和文件的不同用途来说明的。

1.3.2       在android平台添加BCM43xx驱动

要在android平台编译wifi模块，首先要将wifi模块的源码添加到android平台下的目录中。至于添加到什么地方也不是固定的，一般会添加到vendor目录下的某个目录下，下面我们把BCM43xx模块源码放在vendor/xxxx/wlan/bcm43xx下（XXXXX代表产品名称）。要知道，在添加源码之前，这个bcm43xx目录是不存在的，需要手动创建，并在该目录下创建android和src两个目录：

PC$ cd<ANDROID_ROOT>

PC$ mkdir ‐p vendor/xxxx/wlan/bcm4325/

PC$ cdvendor/xxxx/wlan/bcm4325/

PC$ mkdirandroid src

PC$ ls

android src

在创建好上面的目录后，就可以在目录下添加BCM43xx的相关源码了，src存放的是驱动源码，android目录下主要存放固件（即二级制镜像），编译文件（Android.mk），配置文件（nvram.txt和wpa_supplicant.conf）等。

添加好相关源码后，还需要做一定的修改工作（主要对编译文件的修改），不然模块无法被正常编译的，Android.mk的内容修改操作如下。

PC$ cp<WORK>/bcm4325_source/open‐src/src/dhd/android/config/Android.mk

<ANDROID_ROOT>/vendor/xxxx/wlan/bcm4325/android

PC$ cd<ANDROID_ROOT>/vendor/xxxx/wlan/bcm4325/android

PC$ viAndroid.mk     //到这里，找到Android.mk文件，文件内容如下

……

#

# Install WLAN Driver, firmware, and configurationfiles.

#

local_target_dir :=$(TARGET_OUT_ETC)/firmware    //这里定义local_target_dir的路径，在后面会用到

########################

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)

LOCAL_MODULE :=sdio-g-cdc-reclaim-idsup-wme-ccx-wapi.bin

LOCAL_MODULE_TAGS := user development

LOCAL_MODULE_CLASS := ETC

LOCAL_MODULE_PATH := $(local_target_dir)

LOCAL_SRC_FILES := $(LOCAL_MODULE)

include $(BUILD_PREBUILT)

########################

include $(CLEAR_VARS)

LOCAL_MODULE := nvram_4325b0.txt

LOCAL_MODULE_TAGS := user development

LOCAL_MODULE_CLASS := ETC

LOCAL_MODULE_PATH := $(local_target_dir)

LOCAL_SRC_FILES := $(LOCAL_MODULE)

include $(BUILD_PREBUILT)

########################

include $(CLEAR_VARS)

LOCAL_MODULE := dhd.ko

LOCAL_MODULE_TAGS := user development

LOCAL_MODULE_CLASS := ETC

LOCAL_MODULE_PATH :=$(TARGET_OUT)/lib/modules

LOCAL_SRC_FILES := $(LOCAL_MODULE)

include $(BUILD_PREBUILT)

########################

include $(CLEAR_VARS)

LOCAL_MODULE := wpa_supplicant.conf

LOCAL_MODULE_TAGS := user development

LOCAL_MODULE_CLASS := ETC

LOCAL_MODULE_PATH := $(TARGET_OUT_ETC)/wifi

LOCAL_SRC_FILES := $(LOCAL_MODULE)

include $(BUILD_PREBUILT)

########################

include $(CLEAR_VARS)

LOCAL_MODULE := dhcpcd.conf

LOCAL_MODULE_TAGS := user development

LOCAL_MODULE_CLASS := ETC

LOCAL_MODULE_PATH :=$(TARGET_OUT_ETC)/dhcpcd

LOCAL_SRC_FILES := android_dhcpcd.conf

include $(BUILD_PREBUILT)

########################

对上面的内容有必要说明一下：LOCAL_MODULE和LOCAL_MODULE_PATH的定义是这里需要修改的地方。对于LOCAL_MODULE_PATH的修改时一定的，但它主要依赖与android平台已经定义好的一些变量，如：TARGET_OUT _ETC和TARGET_OUT等。LOCAL_MODULE定义的是要操作的对象，也是前面提到的配置文件，编译好的驱动模块二进制文件和固件等。

该文件的作用：将各个文件拷贝到定义的地方，以供驱动模块和wpa_supplicant等使用。、

对于驱动的源码，用户可以通过定制的wifi芯片管理函数来关闭和开启wifi模块，在dhd/sys/dhd_custom_gpio.c文件中有如下的函数定义：

#define CUSTOMER_HW

#ifdef CUSTOMER_HW

extern void bcm_wlan_power_off(int);

BCM43xx BCM43xx Porting Guide for Android System

Broadcom Corporation Proprietary and Confidential

9

extern void bcm_wlan_power_on(int);

#endif /* CUSTOMER_HW */

所以用户可以使用自己定制的开关函数，或者使用BCM43xx自带的开关函数来控制wifi模块的开关。如果使用定制的开关函数，则需要在平台相关的代码中定义这两个函数：

Path：kernel/arch/arm/mach‐XXX/board‐XXXX.c

……

void bcm_wlan_power_off(int onoff);

void bcm_wlan_power_on(int onoff);

……

前面的Android.mk的修改中，有对dhd.ko的拷贝操作，这就是说源码编译后生成的模块二进制文件应该被暂时拷贝到Android.mk中指示的地方。这个暂时拷贝操作在驱动源码的编译文件dhd/linux/Makefile中被执行。

PC$ cd<ANDROID_ROOT>/vendor/xxxx/wlan/bcm4325/src

PC$ vi dhd/linux/Makefile +315

modules: $(OFILES)

test -r ./Makefile || ln –s $(SRCBASE)/dhd/linux/makefile.26./Makefile

$(MAKE) -C $(LINUXDIR) M=$(shell pwd) $(if $(VERBOSE),V=1)modules

cp $(KMODULES) $(SRCBASE)/../android/.

下一步需要做的就是将wifi模块源码的顶层目录下的android.mk文件放到bcm43xx目录下，它是android编译入口文件，表示在编译android时，这个wifi驱动模块被包含到整个android编译系统中。它的内容如下：

PC$ cd <ANDROID_ROOT>/vendor/xxxx/wlan/bcm4325/

PC$ vim Android.mk

ifeq ($(BOARD_WLAN_DEVICE),bcm43xx)

include $(callall-subdir-makefiles)

endif

很简单，如果被BOARD_WLAN_DEVICE被定义为bcm43xx，调用call all-subdir-makefiles函数来包含所有子目录下的Android.mk文件，这是android编译系统的规则。

那么，最后一步就是在相关的平台配置文件中定义BOARD_WLAN_DEVICE为bcm43xx，文件路径：vendor/XXXX/XXXX/BoardConfig.mk。

1.3.3       编译wifi驱动源码

在编译wifi驱动源码之前，首先要建立kernel环境，即要在编译wifi模块之前编译kernel，因为模块的编译时依赖与内核的。

内核的编译如下：

PC$ cd <ANDROID_ROOT>/kernel

PC$ make ARCH=arm CROSS_COMPILE=<ANDROID_ROOT>/prebuilt/

linuxx86/toolchain/arm‐eabi‐4.4.0/bin/arm‐eabi‐ XXXX_defconfig

PC$ make ARCH=armCROSS_COMPILE=<ANDROID_ROOT>/prebuilt/

linuxx86/toolchain/arm‐eabi‐4.4.0/bin/arm‐eabi‐ zImage

如果设置好了ARCH和CROSS_COMPILE的环境变量，就可以省略这两个选项的定义，直接使用make命令生成zImage了。

在编译好kernel之后，就可以进入bcm43xx源码目录dhd/linux下，这里面有两个文件Makefile和Makefile.26，如果没有Makefile文件就将Makfeile.26拷贝成Makfile文件（实际上是建立了一个符号链接文件），当然也要做前面的dhd.ko暂时拷贝命令的添加了。在该目录下输入如下命令编译模块源码：

PC$ cd<ANDROID_ROOT>/vendor/xxxx/wlan/bcm4325/src

PC$ cd dhd/linux/

PC$ make ARCH=armLINUXDIR=<ANDROID_ROOT>/kernel

CROSS_COMPILE=<ANDROID_ROOT>/prebuilt/linux‐x86/toolchain/arm‐eabi‐

4.4.0/bin/arm‐eabi‐ dhd‐cdc‐sdmmc‐gpl

最后一条命令增加了一个命令选项LINUXDIR的传值，即告诉该编译文件kernel的所在位置，进入kernel的Makefile文件做设置工作，然后返回该目录下的Makefile文件进行编译工作。

到这里bcm43xx驱动源码已经编译完成，可以到android目录下查看有没有dhd.ko文件生成，如果有，即表明编译成功，否则查看编译过程的出错信息，解决错误问题再编译，直至编译成功。

1.3.4       在android中使用BCM43xx

前面的过程只是在android系统中添加编译了BCM43xx驱动源码，但是要想在android中使用它，还需要费一番功夫。需要修改的地方在开始的地方已经用蓝色背景标注了，在这里我们要看看到底要修改哪些文件。

1.3.4.1        hardware/libhardware_legacy/wifi/wifi.c

为BCM43xx驱动模块做适当修改。Wifi.c作为加载wifi驱动模块和启动关闭wpa_supplicant的重要角色而存在，为了使wifi能更好的工作，该文件中的一些变量参数必须被适当的设置（根据wpa_supplicant.conf）。

PC$ vi hardware/libhardware_legacy/wifi/wifi.c

......

#define WIFI_DRIVER_MODULE_PATH

"/system/lib/modules/dhd.ko"

......

#define WIFI_DRIVER_MODULE_NAME"dhd"

......

#define WIFI_DRIVER_MODULE_ARG

"firmware_path=/etc/firmware/sdio-g-cdc-reclaim-idsup-wme-ccxwapi.

bin nvram_path=/etc/firmware/nvram_4325b0.txt"

......

#define WIFI_TEST_INTERFACE "eth0"

......

static const char IFACE_DIR[] = "";

......

static const char SUPP_CONFIG_TEMPLATE[]=

"/data/misc/wifi/wpa_supplicant.conf";

……

static const char SUPP_CONFIG_FILE[] =

"/etc/wifi/wpa_supplicant.conf";

......

 

上面的红色部分，就是对wifi驱动的特殊化定义，不同的wifi驱动会有不同的定义。修改还包括了固件的和配置文件的路径，以及接口名的相关定义。

WIFI_TEST_INTERFACE定义的是wpa_supplicant和UI的交互接口名，当通过property_get()函数获取wifi接口名错误时，就会使用此定义的接口名。Property_get()函数获取的接口名，就是init.xx.rc文件中的接口定义的wifi.interface：

Setprop wifi.interface “eth0”

SUPP_CONFIG_TEMPLATE定义的是wpa_supplicant配置文件的临时文件。而SUPP_CONFIG_FILE定义的是wpa_supplicant运行时使用的配置文件，并且对wifi配置的修改也会保持到这个文件里。

IFACE_DIR是wpa_supplicant控制接口的目录，该目录下的接口被UI用来连接到wpa_supplicant，这个目录是由wpa_supplicant决定的，其实，这个接口实际上是一个socket，在wpa_supplicant启动时被创建，wpa_supplicant_ctrl_iface_init()

中有两种方式来创建这个socket接口：

（1）android系统的socket

它使用wpa_%ctrl_interface%组合来定义自己的名字，通过socketwpa_eth0 dgram ...命令来生成的（在init.rc中），如果使用这种socket，下面的代码中的接口名必须是一直的：

ctrl_interface=eth0 (In wpa_supplicant.conf)

"socket wpa_eth0 ..." (In init.*.rc )

setprop wifi.interface "eth0" (In init.*.rc)

wpa_supplicant ‐ieth0 ... (In init.*.rc)

此时，IFACE_DIR的定义为NULL。

（2）特殊socket

Wpa_supplicant会通过wpa_supplicant.conf中的ctrl_interface目录来创建控制接口socket，而这个值一般被定义为："ctrl_interface=DIR=/data/misc/...."，这个socket的名字由wpa_supplicant的“-i”参数传递，如果使用这种方式的socket，下面的变量定义必须一致：

ctrl_interface=DIR=/data/misc/ (In wpa_supplicant.conf)

IFACE_DIR=/data/misc/ (In wifi.c)

1.3.4.2        kernel/arch/arm/mach‐XXX/board‐XXXX.c

为BCM43xx 驱动添加电源管理部分内容，这里不详细叙述。

1.3.4.3        system/core/rootdir/etc/init.xxx.rc

为支持BCM43xx驱动模块，修改wpa_supplicant服务。Init.xxx.rc文件的内容一般如下所示：

PC$ vi system/core/rootdir/etc/init.xxx.rc

......         //添加android系统接口

# to enable wifi

setprop wifi.interface "eth0"

# end of wifi

......         //修改wpa_supplicant.conf的权限

chmod 0660 /etc/wifi/wpa_supplicant.conf

chown wifi wifi /etc/wifi/wpa_supplicant.conf

......         //wpa_supplicant服务的启动命令

service wpa_supplicant /system/bin/logwrapper

/system/bin/wpa_supplicant -Dwext -ieth0 -

c/etc/wifi/wpa_supplicant.conf

......         //给wpa_supplicant修改socket接口

socket wpa_eth0 dgram 660 wifi wifi

......         //修改dhcp接口

service dhcpcd /system/bin/dhcpcd -BKL eth0

......

1.3.4.4        vendor/XXXX/XXXX/BoardConfig.mk

为BCM43xx驱动添加配置变量。

PC$ vi vendor/XXXX/XXXX/BoardConfig.mk

……

ifneq ($(BUILD_TINY_ANDROID), true)

……

BOARD_WPA_SUPPLICANT_DRIVER := WEXT

BOARD_WLAN_DEVICE := bcm43xx

endif # !BUILD_TINY_ANDROID

……

对BCM43xx的WAPI的支持也需要做一系列的修改，这里不再对其进行详细的叙述了。

2        总结

最近一段时间里对wifi模块的学习，让我对wifi有了更多的了解，但这些也是不够的。对于wifi模块，需要了解的东西很多，这里只对其工作原理和工作流程以及移植过程进行了简单的阐述，还有很多方面没有概括到，如：协议层的实现方式和过程，以及数据传输中的细节和SDIO相关内容等等，这些在实际的wifi模块工作时可能都需要我们去进一步的分析和把握，虽然对wifi的理解可能不到位，但对这段时间学习做一次总结，也是大有裨益的，希望有机会可以更深入的学习wifi模块。

在wifi模块调试的过程中也会出现一系列的问题，这些问题可以归纳成不同的类型，对这些类型的问题做分析和总结，可以帮助我们在以后调试工作中快速定位问题所在。

对wifi的了解还远远不够，希望和wifi感兴趣的和已经成为高手的同仁能有更多的交流。