深圳英赛尔电子有限公司产品用户手册 RAK310 用户手册 类别 内容 关键词 RAK310 开发板 摘 要 本文主要介绍 RAK310 开发板套件，针对 wifi 无线学习和开发使用，详细介绍了该套件的使用方法和软件支持 版本 V0.0.1 创建日期 2012-7-12 深圳英赛尔电子深圳英赛尔电子有限公司有限公司 用户手册用户手册 Shenzhen Incel Technology Co.Ltd User Manual i 修订历史修订历史 版本 日期 原因 V0.0.1 2012-7-12 创建文档 深圳英赛尔电子深圳英赛尔电子有限公司有限公司 用户手册用户手册 Shenzhen Incel Technology Co.Ltd User Manual ii 销售与服务销售与服务网络网络 北京总公司北京总公司 FAE 邮箱：allan.jinlthonway.com 金彦哲 销售电话：010-82637265/7289/7279/7269/7261 010-82637272/7276/7288/7909/8791/7293 传真：010-82639385/8368 地址：北京市海淀区苏州街 18 号长远天地 A1 座 1703 室 网址：http:/www.lthonway.com/ 上海分公司上海分公司 FAE 邮箱： lee.zhanglthonway.com 张义宾 销售电话：021-51113181/3086/3633/3396/3586/3323 传真：021-51113220 地址：上海市闵行区万源路 2158 号泓毅大厦 412 室 深圳分公司深圳分公司 FAE 邮箱：peter.penglthonway.com 彭飞 销售电话：0755-8376 4792/3219/7518/8954/4775/9209 0755-83975390 传真：0755-83763347/83290087 地 址 ： 深 圳 市 龙 岗 区 布 吉 镇 坂 田 吉 华 路393号 英 达 丰 科 技 园3楼 深圳英赛尔电子深圳英赛尔电子有限公司有限公司 用户手册用户手册 Shenzhen Incel Technology Co.Ltd User Manual RAK310 WIFI 通信模块通信模块 i 目录目录 1. 功能简介 . 5 2. 硬件描述 . 5 2.1 开发板外观 . 6 2.2 接口配置 . 6 2.3 尺寸规格 . 6 3. RAK310 无线网卡驱动移植 . 7 3.1 移植环境 . 7 3.2 RAK310 驱动编译 . 7 3.2.1 解压 RAK310 驱动源码 . 7 3.2.2 修改配置 Android.mk . 7 3.2.3 配置内核支持 wifi 网络 . 7 4. 配置 Android . 8 4.1 修改 android 支持 wifi 功能 . 8 4.2 修改控制 wifi 管理函数功能 . 8 4.3 修改 wpa_supplicant.conf . 9 4.4 修改 dhcp 配置 . 9 4.5 配置路径和权限 . 10 4.6 配置运行 wpa_supplicant . 10 4.7 编译 android . 10 5. 测试 RAK310 . 11 5.1 测试连接无线 AP . 11 5.2 连接无线 AP . 12 5.3 测试传输速率 . 14 5.3.1 运行 iperf . 15 5.3.2 测试结果 . 15 深圳英赛尔电子深圳英赛尔电子有限公司有限公司 用户手册用户手册 Shenzhen Incel Technology Co.Ltd User Manual RAK310 WIFI 通信模块通信模块 1 1. 功能简介 RAK310是一款小巧功能齐全针对 WIFI 无线通信学习及开发应用的学习套件。 图 1.1 RAK310 开发板 该开发套件，有以下特点： 符合标准的 802.11n/g/ 作为普通的 STA 模式（普通的 wifi 终端，可以接入指定的 AP） AP 模式（路由模式，支持无线路由功能，可以当无线路由器使用） ADHOC 点对点传输或桥接模式 支持两种网络类型 Infra/adhoc 支持多种安全认证机制：WEP64/WEP128/ TKIP/CCMP(AES)/ WEP/WPA-PSK/WPA2-PSK 支持多种网络协议：TCP/UDP/ICMP/DHCP/DNS/HTTP 支持内置/外置天线 支持标准接口 SDIO2.0 （4-bit 和 1-bit） 支持 OS 系统 ANDROID2.3/4.0 2. 硬件描述 2.1 开发板外观开发板外观 深圳英赛尔电子深圳英赛尔电子有限公司有限公司 用户手册用户手册 Shenzhen Incel Technology Co.Ltd User Manual RAK310 WIFI 通信模块通信模块 2 图 2.1 RAK310 和 SD 卡套 2.2 接口配置接口配置 图 2.2 接口定义 2.3 尺寸规格尺寸规格 图 2.3 尺寸定义 深圳英赛尔电子深圳英赛尔电子有限公司有限公司 用户手册用户手册 Shenzhen Incel Technology Co.Ltd User Manual RAK310 WIFI 通信模块通信模块 3 3. RAK310 无线网卡驱动移植 3.1 移植环境：移植环境： 主机操作系统：Ubuntu 11.04 目标系统：ANDROID2.3 目标平台：S5VP210-ARM Cortex-A8 交叉编译器：arm-linux-gcc-4.5.1-v6 3.2 RAK310 驱动编译驱动编译 3.2.1、解压、解压 RAK310 驱动源码驱动源码 在开发平台下首先新建一个工作目录 work，将附带光盘中 atheros_AND.gz 源码拷贝到work 目录下并进行解压: cp /mnt/sd/atheros_AND.tar.gz /work tar zxvf atheros_AND.tar.gz 解压后生成 atheros 和 external 目录。 然后将解压的两个目录放置到 android 系统目录下 cp atheros -rf ./system/wlan/ cp external/ath_supplicant-0.8.x -rf ./external cp external/hostapd-0.8.x -rf./external cp external/iperf-2.0.4 -rf ./external 3.2.2、修改配置、修改配置 Android.mk 首先进入./system/wlan/atheros/AR6kSDK.build_3.1_RC.779/host目录下，利用编辑器打开 Android.mk cd system/wlan/atheros/AR6kSDK.build_3.1_RC.779/host vim Android.mk 修改内核源码路径并指定交叉编译工具： 退出保存。 3.2.3配置内核支持配置内核支持 wifi 网络网络 否则会出现错误 进入到内核所在根目录进行配置 make menuconfig 指定内核路径 指定交叉编译 深圳英赛尔电子深圳英赛尔电子有限公司有限公司 用户手册用户手册 Shenzhen Incel Technology Co.Ltd User Manual RAK310 WIFI 通信模块通信模块 4 配置完毕后，需要编译下内核，目的是使配置在include/linux/autoconfig.h中生效 退出保存 make zImage 4. 配置 android 4.1、修改、修改 android 支持支持 wifi 功能功能 进入/device/BoardConfig.mk 进行修改 cd ./device/ samsung/smdkv210 vi BoardConfig.mk # ADD Wi-Fi BOARD_WPA_SUPPLICANT_DRIVER := AR6000 WPA_BUILD_SUPPLICANT := true WPA_SUPPLICANT_VERSION := VER_0_8_ATHEROS /指定wpa_supplicant版本 BOARD_WLAN_ATHEROS_SDK := system/wlan/atheros/AR6kSDK.build_3.1_RC.779 /驱动位置 BOARD_WPA_SUPPLICANT_DRIVER := WEXT HOSTAPD_VERSION := VER_0_8_ATHEROS #select wake on wireless mode for ar6k BOARD_WLAN_PM_SUSPEND :=2 CONFIG_CTRL_IFACE := y 4.2、修改、修改控制控制 wifi 管理函数库管理函数库 Android中通过wpa_supplicant控制wifi。wpa_supplicant通过socket与hardware/libhardware_legacy/wifi/wifi.c通信，当在UI开启wifi的时候首先要加载wifi模块驱动，然后开启wpa_supplicant配置文件，因此在wifi.c中修改驱动和配置文件的对应位置。 cd ./hardware/libhardware_legacy/wifi/ vi wifi.c 将以下代码将以下代码 #ifndef WIFI_DRIVER_MODULE_PATH #define WIFI_DRIVER_MODULE_PATH /system/lib/modules/wlan.ko #endif 深圳英赛尔电子深圳英赛尔电子有限公司有限公司 用户手册用户手册 Shenzhen Incel Technology Co.Ltd User Manual RAK310 WIFI 通信模块通信模块 5 #ifndef WIFI_DRIVER_MODULE_NAME #define WIFI_DRIVER_MODULE_NAME wlan #endif #ifndef WIFI_DRIVER_MODULE_ARG #define WIFI_DRIVER_MODULE_ARG #endif #ifndef WIFI_FIRMWARE_LOADER #define WIFI_FIRMWARE_LOADER #endif #define WIFI_TEST_INTERFACE sta 修改为修改为 #ifndef WIFI_DRIVER_MODULE_PATH #define WIFI_DRIVER_MODULE_PATH /system/wifi/ar6000.ko #endif #ifndef WIFI_DRIVER_MODULE_NAME #define WIFI_DRIVER_MODULE_NAME ar6000 #endif #ifndef WIFI_DRIVER_MODULE_ARG #define WIFI_DRIVER_MODULE_ARG #endif #ifndef WIFI_FIRMWARE_LOADER #define WIFI_FIRMWARE_LOADER #endif #define WIFI_TEST_INTERFACE wlan0 4.3、修改、修改 wpa_supplicant.conf 把external/ath_supplicant-0.8.x/wpa_supplicant/wpa_supplicant.conf拷贝到out/target/product/smdkv210/system/etc/wifi/目录下， 并把相关配置的修改为： ctrl_interface=DIR=/data/misc/wifi/wpa_supplicant GROUP=wifi /wlan0在这个目录下 eapol_version=1 ap_scan=0 / fast_reauth=1 4.4、修改、修改 dhcp 配置配置 在在/system/etc/dhcpcd/dhcpcd.conf 中修改中修改 interface wlan0 option subnet_mask, routers, domain_name_server 4.5、配置路径和权限、配置路径和权限 wpa_supplicant 运行在 wifi 用户和组下的。代码可见 wpa_supplicant/os_unix.c 中的 os_program_init()函数。 如果配置不对，会出现下面错误： 深圳英赛尔电子深圳英赛尔电子有限公司有限公司 用户手册用户手册 Shenzhen Incel Technology Co.Ltd User Manual RAK310 WIFI 通信模块通信模块 6 E/WifiHW ( ): Unable to open connection to supplicant on /data/system/wpa_supplicant/wlan0: No such file or directory will appear。 如果系统的/system 目录为只读，那应该使用路径/data/misc/wifi/wpa_supplicant.conf. 确认确认 init.rcinit.rc 中有如下配置中有如下配置： cd ./device/samsung/smdkv210 vi init.rc # give system access to wpa_supplicant.conf for backup and restore mkdir /data/misc/wifi 0770 wifi wifi chmod 0770 /data/misc/wifi chmod 0660 /data/misc/wifi/wpa_supplicant.conf chmod 0660 /data/misc/wifi/hostapd.conf mkdir /data/misc/wifi/sockets 0770 wifi wifi chmod 0770 /data/misc/wifi/sockets mkdir /data/misc/dhcp 0770 dhcp dhcp chmod 0770 /data/misc/dhcp chmod 0775 /system/etc/dhcp/dhcp-run-hooks setprop wifi.interface wlan0 4.6、配置运行、配置运行wpa_supplicnat、dhcp和和hostapd 在在init.rc中添加如下语句：中添加如下语句： service wpa_supplicant /system/bin/logwrapper /system/bin/wpa_supplicant -dd -Dwext -iwlan0 -c /data/misc/wifi/wpa_supplicant.conf user root group wifi inet socket wpa_wlan0 dgram 660 wifi wifi oneshot service dhcpcd /system/bin/logwrapper /system/bin/dhcpcd -d -B wlan0 disabled oneshot service hostapd /system/bin/hostapd /system/etc/wifi/hostapd.conf group wifi inet oneshot disabled 4.7、编译、编译android 在android根目录下执行 make j4 制作镜像文件烧写目标板中，启动目标板。 深圳英赛尔电子深圳英赛尔电子有限公司有限公司 用户手册用户手册 Shenzhen Incel Technology Co.Ltd User Manual RAK310 WIFI 通信模块通信模块 7 5. 测试 RAK310 启动目标板后可以在 UI 界面启动 wifi 点击 settingwireless&networks-Wi-Fi 开启 wifi 然后点击 Wi-Fi setting 查看是否正常 通过查看 wifi 已经正常开启并且搜索出附件可用的节点 5.1 测试连接无线测试连接无线 AP 下面连接一个事先配置好的 AP ssid：Android-test 配置无线配置无线 AP (型号型号 TL-WR700N) 准备一个无线路由器登入路由配置界面，在 pc 浏览器中输入路由 ip 地址(图 5.1) 图 5.1 进入路由界面后将路由配置成 AP 模式(图 5.2) 深圳英赛尔电子深圳英赛尔电子有限公司有限公司 用户手册用户手册 Shenzhen Incel Technology Co.Ltd User Manual RAK310 WIFI 通信模块通信模块 8 图 5.2 对 AP 模式进行基本参数设置(图 5.3) 图 5.3 对 AP 进行无线安全设置，在此我们设置为无线 WPA 加密模式(图 5.4)，当然也可以设置成 wep 等加密模式 图 5.4 配置完成后保存，重启 AP 5.2 连接连接无线无线 AP 然后通过界面搜索到我们所设置的然后通过界面搜索到我们所设置的 ap，如图所示，如图所示 UI 显示显示 Android-test 为为 wpa 加密模式加密模式 深圳英赛尔电子深圳英赛尔电子有限公司有限公司 用户手册用户手册 Shenzhen Incel Technology Co.Ltd User Manual RAK310 WIFI 通信模块通信模块 9 然后点击 Android-test 进行连接，如图所示输入设置密码： 然后点击 connect 进行连接。如图显示连接状态。 图显示连接后自动获取 ip 地址 深圳英赛尔电子深圳英赛尔电子有限公司有限公司 用户手册用户手册 Shenzhen Incel Technology Co.Ltd User Manual RAK310 WIFI 通信模块通信模块 10 通过前面 UI 显示已经正确连接上 ap，下面可以通过网页进行验证，如图显示： 测试成功。 5.3、测试传输速率、测试传输速率 在测试速率采用的是 iperf 测试工具，Iperf 是一个网络性能测试工具。使用 iPerf 之前，必须安装两个组件：iPerf 服务器（用于监听到达的测试请求）和 iPerf 客户端（用于发起测试会话） 。iPerf可通过开放源代码或可执行二进制方式获取， 它支持许多操作系统平台， 包括 Win32、 Linux、 FreeBSD、MacOS X、 OpenBSD和Solaris。 你可以在NLANR上下载iPerf的Win32安装程序， 而Java GUI版本 （JPerf）则可以从 SourceForge 下载。 在套件光盘中已经提供了 iperf 安装组件， 在光盘中平台工具文件夹里提供了一个运行于 windows下的测试软件 iperf.exe，将它拷贝到任何一个盘符中（如 D:） 5.35.3.1.1、运行、运行 iperfiperf 我们将运行在 pc 机上的 iperf 作为 server，目标板上的 iperf 作为 client； 首先首先在命令提示符中打开服务端： 1、点击“开始”“运行”在弹出的运行对话框中输入 cmd-点击确定弹出一个 dos 命令提示符 2、在命令提示符中输入 d:点击回车进入 D 盘 3、在命令提示符中输入 iperf -s i 1 w 1M 深圳英赛尔电子深圳英赛尔电子有限公司有限公司 用户手册用户手册 Shenzhen Incel Technology Co.Ltd User Manual RAK310 WIFI 通信模块通信模块 11 然后然后在目标板中开启 iperf 客户端： 进入目标板根目录运行 iperf / #cd / / #./iperf -c 192.168.9.19 i 5 w 1M t 20s 5.35.3.2.2、iperfiperf 测试结果测试结果 Iperf 测试参数说明： -s 以 server 模式启动。#iperf -s -c host 以 client 模式启动。host 是 server 端地址。#iperf -c serverip -i sec 以秒为单位显示报告间隔，#iperf -c 192.168.1.102 -i 5 -w 指定 TCP 窗口大小，默认是 8KB ，#iperf s w 1M -t 测试时间，默认 20 秒,#iperf c 192.168.1.102 -t 60s -f kmKM 分别表示以 Kbits, Mbits, KBytes, MBytes 显示报告，默认以 Mbits 为单位,#iperf -c 192.168.1.102 -f K -p 指定服务器端使用的端口或客户端所连接的端口#iperf -s -p 9999;or iperf -c 192.168.1.102 -p 深圳英赛尔电子深圳英赛尔电子有限公司有限公司 用户手册用户手册 Shenzhen Incel Technology Co.Ltd User Manual RAK310 WIFI 通信模块通信模块 12 9999 -u 使用 udp 协议，不指定默认为 tcp -C 兼容旧版本（当 server 端和 client 端版本不一样时使用） -F 指定需要传输的文件