background image

 

EVK-LILY-W1 - User Guide 

UBX-15030290 - R04 

Software

  

Page 16 of 25 

 

 

 

The manufacturing firmware support is required, if the driver is used with the "

Manufacturing and 

Labtools" packages, which can be used for setting up the test modes for certification [5]. 

4.3.4

 

Building  

4.3.4.1

 

Prepare kernel sources 

Primarily, ensure that your kernel is prepared for compiling external kernel modules. For this, change 
to the kernel's source directory and run the following: 

 

 

"make  modules_prepare" will not build Module.symvers even if  CONFIG_MODVERSIONS is set; 
therefore, a full kernel build must be executed to make the module versioning work. 

4.3.4.2

 

Wi-Fi driver and tools 

To compile the Wi-Fi drivers and tools, go to the driver packages's 

wlan_src

 subdirectory and run “

make 

build

”. For cross-compilation, you should specify the target architecture, cross-toolchain prefix, and 

the directory with the kernel sources used to build the kernel on the target system, that is: 

 

This command will build the Wi-Fi kernel modules and all the included user space applications. The 
build results will be copied to 

../bin_sd8801/

 (or 

../bin_usb8801

 in case of USB driver), related to the 

wlan_src

 directory. The following table summarizes the content of the Wi-Fi build results directory: 

File 

Description 

mlan.ko, 
sd8801.ko/usb8801.ko 

Wi-Fi driver kernel modules 

README* 

Usage instructions for the provided tools 

config/* 

Sample configuration files used by various tools 

uaputl.exe 

Micro-AP configuration tool 

mlanutl 

Configuration tool for additional driver parameters 

mlanevent.exe 

Netlink event listener 

mlan2040coex 

802.11 20/40 MHz coexistence handler 

Table 13: Content of the Wi-Fi build results directory 

4.4

 

Deploying the software 

The following steps describe how to install the drivers, firmware, and provided tools on the target 
system: 

1.

 

Copy the application binaries to an appropriate location on the target file system and add it to 
the 

$PATH

 

environment variable, if required. 

2.

 

The kernel modules should be copied to somewhere below the modules directory of the kernel, 
for example, 

/lib/modules/3.1

9.8

/updates/

.  Run the 

depmod  command afterwards to 

update the module dependencies and to have the modules findable by the 

modprobe utility. 

3.

 

Copy the firmware image file 

sd8801

_uapsta.bin

  (or 

usb8801_uapsta.bin

)  from the driver 

package's 

FwImage

 directory to the directory 

/lib/firmware/mrvl/

 on the target file system.  

An example deployment is shown below: 

make modules_prepare

 

# e.g.:

 

# ARCH=arm

 

CROSS_COMPILE= 

arm

-

poky

-linux-

gnueabi

KERNELDIR=~

/

elin-w160-

evk/build/tmp/sysroots/elin

-w160-

evk/usr/src/kernel/

 

 

make ARCH=${ARCH} CROSS_COMPILE=${CROSS_COMPILE} KERNELDIR=${KERNELDIR} build

 

Summary of Contents for EVK-LILY-W1

Page 1: ...Guide Abstract This document describes how to set up the EVK LILY W1 evaluation kit to evaluate the LILY W1 host based Wi Fi modules It also describes how to compile the Marvell Linux reference driver...

Page 2: ...ge SD UAPSTA 8801 FC18 MMC 14 85 36 p101 C3X14160_B0 GPL Firmware version 14 85 36 p101 USB driver Package USB UAPSTA 8801 FC18 X86 14 85 36 p101 C3X14160_B0 GPL Firmware version 14 85 36 p101 N A u b...

Page 3: ...4 1 Single antenna 10 3 4 2 Antenna diversity 11 3 4 3 LTE filter 11 3 5 LED 11 3 6 Schematic 12 3 7 Assembly 12 4 Software 13 4 1 Driver versions 13 4 2 Driver and firmware architecture 13 4 3 Compi...

Page 4: ...EVK LILY W1 User Guide UBX 15030290 R04 Page 4 of 25 4 7 1 Compile time debug options 21 4 7 2 Runtime debug options 21 Appendix 23 A Glossary 23 Related documents 24 Revision history 24 Contact 25...

Page 5: ...tions Table 1 lists the available evaluation kit versions Evaluation kit Description Suitable for evaluation of EVK LILY W131 Evaluation kit for version with antenna pin without internal LTE filter LI...

Page 6: ...ption Min Max Unit SDCARD VDD SD card power supply 4 0 V USB VBUS USB power supply 6 0 V TSTORAGE Storage temperature 40 85 C Table 2 Absolute maximum ratings for the LILY W1 evaluation board Paramete...

Page 7: ...ing steps are required to start the evaluation 1 For the EVK LILY W131 connect the included 2 4 GHz antenna via the adapter cable to the U FL single antenna connector J6 on the EVB LILY W131 evaluatio...

Page 8: ...either a built in reader usually found in laptops but not all models support SDIO or a separate reader in one of the extension slots An example card reader for Linux is the Sonnet SDXC UHS I Pro Read...

Page 9: ...the EVB LILY W131 disconnected by default J4 Diversity external antenna connector 2 U FL coaxial connector for second external 2 4 GHz Wi Fi antenna for antenna diversity can only be used on the EVB L...

Page 10: ...1 8 V supply from internal LDO 4 6 8 VCC VCC Module main voltage supply 5 SDCARD VDD SDIO 3 3 V power supply 7 USB_3V3 3 3 V supply from VBUS and internal LDO 9 POWER_DOWN N PD n Power down active low...

Page 11: ...using the antenna diversity configuration The filter can be disabled by populating C18 and C20 instead of C19 and C21 For evaluating the performance of the LTE filter the signals ANT SEL and ANT SEL N...

Page 12: ...LILY W1 User Guide UBX 15030290 R04 Board description Page 12 of 25 3 6 Schematic Figure 6 Schematic of the EVB LILY W1 evaluation board 3 7 Assembly Figure 7 Assembly of the EVB LILY W1 evaluation bo...

Page 13: ...the used operating system version The Software section of this manual describes only the Marvell reference drivers which can be obtained through u blox support The mwifiex open source drivers that ar...

Page 14: ...the description if applicable The drivers should be able to support Linux kernel versions from 2 6 13 to 4 2 Older or more recent kernels might require some patches due to the changed kernel APIs Patc...

Page 15: ...ach other Follow the steps mentioned below to extract the Marvell driver package Once you remove the archives you should find something similar to the following in your working directory 4 3 3 Compile...

Page 16: ...Fi build results directory File Description mlan ko sd8801 ko usb8801 ko Wi Fi driver kernel modules README Usage instructions for the provided tools config Sample configuration files used by various...

Page 17: ...ion and roaming etc on the client side iw CLI configuration utility for wireless devices wireless tools CLI tools for configuring wireless device drivers using Wireless Extensions crda User space udev...

Page 18: ...uing the following command which will load the usb8801 kernel module and all its dependencies such as mlan or cfg80211 For a full description of the available module parameters refer to the README fil...

Page 19: ...r package Module Size Used by usb8xxx 349149 0 mlan 243114 1 usb8xxx wlan Loading MWLAN driver usbcore registered new interface driver usb8xxx wlan Driver loaded successfully usb 2 1 new high speed US...

Page 20: ...wpa_supplicant handle the connection to the access point For this create a configuration file containing the following network settings uaputl exe sys_cfg_ssid LILY W1 set AP SSID to LILY W1 uaputl ex...

Page 21: ...erfaces respectively Debug messages are also printed to the kernel ring buffer through printk calls These messages can be accessed raw using the proc kmsg interface or by the dmesg command Alternative...

Page 22: ...RINTM MEVENT bit 6 MINTR PRINTM MINTR bit 7 MIOCTL PRINTM MIOCTL bit 16 MDAT_D PRINTM MDAT_D DBG_HEXDUMP MDAT_D bit 17 MCMD_D PRINTM MCMD_D DBG_HEXDUMP MCMD_D bit 18 MEVT_D PRINTM MEVT_D DBG_HEXDUMP M...

Page 23: ...Internet Protocol LDO Low Drop Out LED Light Emitting Diode LTE Long Term Evolution MAC Medium Access Control MMC MultiMedia Card OS Operating System SD Secure Digital SDIO Secure Digital Input Output...

Page 24: ...om Revision history Revision Date Name Comments R01 8 Mar 2016 mzes kgom Initial release R02 8 Apr 2016 mzes Document status updated to Advance Information Updated the version of the USB driver packag...

Page 25: ...Office China Beijing Phone 86 10 68 133 545 E mail info_cn u blox com Support support_cn u blox com Regional Office China Chongqing Phone 86 23 6815 1588 E mail info_cn u blox com Support support_cn u...

Reviews: