Wi2Wi W2SW0025 User manual

User Manual
Revision 0.2
January 29, 2016

Copyright © 2016 Wi2Wi, Inc.
Page 2 of 20
Disclaimers
Wi2Wi, Inc. PRODUCTS ARE NOT AUTHORISED FOR USE AS CRITICAL COMPONENTS IN
LIFE SUPPORT DEVICES OR SYSTEMS WITHOUT THE EXPRESS WRITTEN APPROVAL OF
THE MANAGING DIRECTOR OF Wi2Wi, Inc.
The definitions used herein are:
a) Life support devices or systems are devices which (1) are intended for surgical implant into the body,
or (2) support or sustain life and whose failure to perform when properly used in accordance with the
instructions for use provided in the labeling can reasonably be expected to result in a significant injury
to the user. b) A critical component is any component of a life support device or system whose failure to
perform can be reasonably expected to cause the failure of the life support device or system, or to affect
its safety or effectiveness.
Wi2Wi does not assume responsibility for use of any of the circuitry described, no circuit patent licenses
are implied and Wi2Wi reserves the right at any time to change without notice said circuitry and
specifications.
The content of this document is to be treated as strictly confidential and is not to be disclosed,
Reproduced or used, except as authorized in writing by Wi2Wi, Inc.
IC RSS Statement:
English:
This device complies with Industry Canada license‐exempt RSS standard(s). Operation is subject to the
following two conditions:
1) This device may not cause harmful interference;
2) This device must accept any interference received, including interference that may cause
undesired operation of the device.
French:
Cet appareil est conforme à Industrie Canada une licence standard RSS exonérés (s). Son
fonctionnement est soumis aux deux conditions suivantes:
1) Cet appareil ne doit pas provoquer d'interférences
2) Cet appareil doit accepter toute interférence reçue, y compris les interférences pouvant
provoquer un fonctionnement indésirable de l'appareil.
FCC Part 15 Statement:
This device complies with part 15 of the FCC Rules. Operation is subject to the following two
conditions:
1) This device may not cause harmful interference, and
2) This device must accept any interference received, including interference that may cause
undesired operation.
This equipment has been tested and found to comply with the limits for a Class B digital device,
pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against

Copyright © 2016 Wi2Wi, Inc.
Page 3 of 20
harmful interference in a residential installation. This equipment generates, uses, and radiates radio
frequency energy; and if not installed and used in accordance with the instructions, may cause harmful
interference to radio communications. However, there is no guarantee that interference will not occur in
a particular installation. If this equipment does cause harmful interference to radio or television
reception, which can be determined by turning the equipment off and on, the user is encouraged to try to
correct the interference by one or more of the following measures:
a) Reorient or relocate the receiving antenna.
b) Increase the separation between the equipment and receiver.
c) Connect the equipment into an outlet on a circuit different from that to which the receiver is
connected.
d) Consult the dealer or an experienced radio/TV technician for help.
The FCC requires the user to be notified that any changes or modifications made to this device that are
not expressly approved by Wi2Wi may void the user‟s authority to operate the equipment.
Integrator Guidance:
 Only the antenna(s) described in the filings under this FCC ID or equivalent antenna(s) with
equal or lesser gain may be used with this transmitter. Any new antenna type, or higher gain
antenna would require a Class II permissive change.
 If the operation of the equipment is for portable use (within 20 cm of user), or where co-location
configuration use is required; the end product, including the transmitter will require re-evaluation
in accordance to the FCC rules.
Labeling:
The final end product must be labeled in a visible area with the following:
 "Contains FCC ID: XXXXXXXX, IC: YYYYYYYYY"
where XXXXXXXX, YYYYYYYYY are the approved FCC/IC ID for the device being installed.
The grantee's FCC/IC ID can be used only when all FCC/IC compliance requirements are met.

Copyright © 2016 Wi2Wi, Inc.
Page 4 of 20
Table of Contents
Disclaimers..................................................................................................................................................2
Table of Contents .......................................................................................................................................4
1. Introduction ........................................................................................................................................6
1.1 W2SW0025 Module ................................................................................................................. 6
1.2 W2SW0025 EVK Board ........................................................................................................... 6
2. Scope ....................................................................................................................................................7
2.1 Pre-requisites ........................................................................................................................... 7
2.2 Setup ........................................................................................................................................ 7
2.3 Release Package Contents ..................................................................................................... 7
2.4 Driver and Firmware Architecture ............................................................................................ 8
2.5 Driver Building ......................................................................................................................... 8
2.5.1 Kernel Configuration .......................................................................................................................... 8
2.5.2 Compile Time Driver Configuration .................................................................................................... 9
2.5.3 Building ............................................................................................................................................... 9
2.6 WiFi Functional mode Driver Installation ................................................................................. 9
2.7 MFG mode Driver Installation ................................................................................................ 10
3. WiFi Usage Examples .......................................................................................................................11
3.1 WiFi Station Mode ................................................................................................................. 11
3.2 WiFi Access Point Mode ........................................................................................................ 11
3.3 WiFi Direct Mode ................................................................................................................... 12
3.4 Data Transfer ......................................................................................................................... 12
3.5 Driver Proc and Debug commands ....................................................................................... 12
3.6 Driver Configuration commands ............................................................................................ 12
4. Configuration of Kernels .................................................................................................................13
4.1 SDIO Stack Options ............................................................................................................... 13
4.2 Kernel Compilation ................................................................................................................ 13
5. Driver building for Embedded Platforms ......................................................................................14
5.1 Driver Building for i.MX6 SoloLite EVK .................................................................................. 14
5.1.1 Requirements ................................................................................................................................... 14
5.1.2 Hardware Setup ............................................................................................................................... 14
5.1.3 Cross Compiling the Driver for i.MX6 SoloLite EVK ........................................................................ 15
5.2 Driver Building for i.MX6 WandBoard .................................................................................... 15
5.2.1 Requirements ................................................................................................................................... 15
5.2.2 Host PC for Wandboard ................................................................................................................... 15
6. References ..........................................................................................................................................20
6.1 Specifications ......................................................................................................................... 20
6.2 Trademarks, Patents and Licenses ....................................................................................... 20
6.3 Other ...................................................................................................................................... 20

Copyright © 2016 Wi2Wi, Inc.
Page 5 of 20
List of Figures
No table of figures entries found.
List of Tables:
No table of figures entries found.
Revision History:
Revision
Revision Date
Originator
Changes
0.1
0.2

Copyright © 2016 Wi2Wi, Inc.
Page 6 of 20
1. Introduction
This document describes how to set up the W2SW0025 EVK to evaluate Wi-Fi performance of the
W2SW0025 host based module. It also describes how to compile the Linux reference drivers and
provides some basic usage example.
1.1 W2SW0025 Module
W2SW0025 is a complete wireless subsystem featuring 802.11 b/g/n WLAN capabilities in a small form
factor module. The W2SW0025 module is designed to simplify the process of adding wireless capability
without lengthy design cycles or complex RF circuit. It is completely tested for functionality and
performance along with coexistence with other wireless standards.
W2SW0025 has been fully optimized for throughput and receive sensitivity using careful design
practices Based on world-class silicon from Marvell.
1.2 W2SW0025 EVK Board
The W2SW0025 EVK board is a development platform based on the W2SW0025 with integrated USB
and SDIO. This EVB shows the abilities of the W2SW0025 and it is perfect for learning and developing
USB-based applications using the W2SW0025. The W2SW0025 evaluation kit includes an evaluation
board which can be used as a reference design for the W2SW0025 modules.
Figure 1: W2SW0025 Evaluation Kit Overview
W2SW0025 Module
Default SMA Connector
Mini USB Connector
SDIO Connector

Copyright © 2016 Wi2Wi, Inc.
Page 7 of 20
2. Scope
2.1 Pre-requisites
This section details the pre-requisites for SDK hardware usage. A machine with the following specification:
1. PC with Linux Operating System version x.x.x above
2. At least 2GB of hard disk space available
3. Administrator rights on the machine
2.2 Setup
This section details the system setup to evaluate and use the driver
***** Insert the picture
2.3 Release Package Contents
The W2SW0025 Release package is delivered as a tar ball named in the format W2SW0025.LINUX.x.y.z.tgz,
where
x.y.z –identifies the software package.
The package contains the following files/folders:
1) Readme.txt
2) Releasenotes.txt
3) Documents
4) WiFi Driver Software and README_WLAN, README_UAP, README_WDT.

Copyright © 2016 Wi2Wi, Inc.
Page 8 of 20
2.4 Driver and Firmware Architecture
*** redraw the diagram
2.5 Driver Building
2.5.1 Kernel Configuration
The versions of the W2SW0025 package and the Linux OS that are used for this document are:
 W2SW0025 reference driver version x.x.x
 Linux 3.10.17
The drivers should be able to support Linux kernel versions from 2.6.31 to 3.10 or newer (not verified
thoroughly). Older or more recent kernels might require some patches due to changed kernel APIs.
W2SW0025 depend on the MMC/SDIO stack of the Linux kernel, so it must be enabled on the target Linux
system, the following must be selected in the kernel configuration "kernel.config" file while compiling the
Linux kernel.
CONFIG_WIRELESS_EXT=y
CONFIG_WEXT_PRIV=y
CONFIG_CFG80211=y
For older kernels which are <3.2, it is advised to use compat-wireless (now named backports) to provide recent
versions of the kernel's 802.11 APIs to support all the driver features. In this case,cfg80211 has to be compiled
as a module (CONFIG_CFG80211=m).

Copyright © 2016 Wi2Wi, Inc.
Page 9 of 20
2.5.2 Compile Time Driver Configuration
The W2SW0025 driver package contains the firmware image, the Wi-Fi driver sources and also a release notes
that describes the tested hardware platform, supported features, bug fixes and known limitations of the release.
The package comes as several archives that are packed into each other. Follow the steps mentioned below to
extract the driver package.
# tar xf USB-8801-FC18-X86-14.68.36.p38-C3X14047_B0-app-src.tar
# tar xf USB-8801-FC18-X86-14.68.36.p38-C3X14047_B0-GPL-src.tar
# tar xf USB-8801-FC18-X86-14.68.36.p38-C3X14047_B0-mlan-src.tar
The Wi-Fi driver has several compile-time configuration options that can be set in the driver's Makefile.
Change to the wlan_src subdirectory and ensure that the following are enabled in "Makefile".
# Enable STA mode support
CONFIG_STA_SUPPORT=y
# Enable uAP mode support
CONFIG_UAP_SUPPORT=y
# Manufacturing firmware support
CONFIG_MFG_CMD_SUPPORT=y
2.5.3 Building
Follow the below mentioned steps to compile the driver.
1. Goto source code directory wlan_src/. (*** copy all contents from three different directories to GPL
directory).
2. make clean
3. make build
4. The driver and utility binaries can be found in ../bin_xxxx directory. The driver code supports Linux
kernel up to 3.4.
2.6 WiFi Functional mode Driver Installation
1. Copy firmware image "FwImage/usb8766_uapsta.bin" to "/lib/firmware/mrvl/" directory, create the directory if it
doesn't exist.
2. Plug-In SDIO/USB card in SDIO/USB slot in case of using EVB.
3. Connect USB power supply to SDIO/USB EVB.
4. When the module is detected on the SDIO interface, the driver will automatically download the firmware to it,
initialize the hardware, and register the network interfaces. The following is the kernel log after inserting the SDIO
card.
mmc1: new high speed SDIO card at address 0001
vendor=0x02DF device=0x9119 class="0" function=1
rx_work=0 cpu_num=1
Wlan: FW download over, firmwarelen=449964 downloaded 449964
WLAN FW is active
fw_cap_info=0xf03, dev_cap_mask=0xffffffff
5. Install WLAN driver, by providing the drv_mode, max_sta_bss, max_uap_bss as input module parameters.
The bit settings of drv_mode are,
Bit 0 : STA
Bit 1 : uAP
Bit 2 : WIFIDIRECT

Copyright © 2016 Wi2Wi, Inc.
Page 10 of 20
 max_sta_bss: Maximum number of STA BSS (default 1, max 1), sta_name: Name of the STA interface
(default: "mlan").
 max_uap_bss: Maximum number of uAP BSS (default 1, max 2), uap_name: Name of the uAP interface
(default: "uap")
 max_wfd_bss: Maximum number of WIFIDIRECT BSS (default 1, max 1), wfd_name: Name of the
WIFIDIRECT interface (default: "wfd")
 Install cfg80211 driver, for example to install cfg80211 driver
modprobe cfg80211
 For example, to install USB87xx driver,
insmod mlan.ko
insmod usb8766.ko [drv_mode=3] [fw_name=mrvl/usb8766_uapsta.bin]
 To load driver in STA only mode,
insmod mlan.ko
insmod usb8766.ko drv_mode=1 [fw_name=mrvl/usb8766_uapsta.bin]
 To load driver in uAP only mode,
insmod mlan.ko
insmod usb8766.ko drv_mode=2 [fw_name=mrvl/usb8766_uapsta.bin]
 To switch mode between STA only, uAP only and uAPSTA in run time,
echo drv_mode=1 > /proc/mwlan/config // STA mode
echo drv_mode=2 > /proc/mwlan/config // uAP mode
echo drv_mode=3 > /proc/mwlan/config // uAPSTA mode
 when the driver is installed properly the following new network interfaces will be created (using ifconfig
command)
mlan0 -- Wi-Fi station mode
uap0 -- Wi-Fi micro access point mode
wfd0 -- Wi-Fi Direct
 To switch mode between STA only, uAP only and uAPSTA in run time,
echo drv_mode=1 > /proc/mwlan/config // STA mode
echo drv_mode=2 > /proc/mwlan/config // uAP mode
echo drv_mode=3 > /proc/mwlan/config // uAPSTA mode
6. Uninstall WLAN driver,
ifconfig mlanX down
ifconfig uapX down
ifconfig wfdX down (*** Check this)
rmmod usb8xxx
rmmod mlan
2.7 MFG mode Driver Installation
1. To load driver with MFG firmware file, use mfg_mode=1 when insmod WLAN driver and specify MFG firmware
name if needed.
2. There are some other parameters for debugging purpose etc. Use modinfo to check details.
 drvdbg=<bit mask of driver debug message control>
 mac_addr=xx:xx:xx:xx:xx:xx <override the MAC address (in hex)>
 auto_ds=0|1|2 <use MLAN default | enable auto deepsleep | disable auto deepsleep>
 ps_mode=0|1|2 <use MLAN default | enable IEEE PS mode | disable IEEE PS mode>
 max_tx_buf=2048|4096|8192 <maximum AMSDU Tx buffer size>
 cfg_11d=0|1|2 <use MLAN default | enable 11d | disable 11d>
 req_fw_nowait=0|1 <use request_firmware API (default) | use request_firmware_nowait API>
 init_cfg=<init config (MAC addresses, registers etc.) file name>
e.g. copy init_cfg.conf to firmware directory, init_cfg=mrvl/init_cfg.conf