background image

 

EVK-LILY-W1 - User Guide 

UBX-15030290 - R04 

Software

  

Page 13 of 25 

 

 

 

4

 

Software 

The LILY-W1 module series is based on the Marvell Avastar 88W8801 chipset and it supports Wi-Fi 
802.11b/g/n simultaneous client/station, access point, and Wi-Fi Direct operations. 

The LILY-W1 modules connect to the host processor either through an SDIO 2.0 or USB 2.0 device 
interface. 

From the software point of view, the LILY-W1 series modules contain only calibration data and basic 
operation settings in an on-board non-volatile memory and thus require a host-side driver and a 
firmware to run. Each base software package contains the following: 

 

A firmware image that has to be downloaded to the module on system start   

 

A driver, which is placed between the bus driver and the attached network stacks 

Various control tools are also included optionally. 

4.1

 

Driver versions 

Marvell reference drivers for the LILY-W1 series modules are currently available for Linux and Android 
operating systems as SDIO or USB driver versions. The drivers are usually released for a single 
reference host platform and operating system version, but can be easily ported to comparable 
platforms. It is recommended to use the latest available host interface driver version and port this to 
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 are distributed with the 
Linux kernel are not officially supported by u-blox. 

 

Refer to the Release Notes that is bundled with each driver release for a list of supported driver 
features. 

4.2

 

Driver and firmware architecture 

The software for the LILY-W1 modules is split into the following parts: 

 

The Wi-Fi driver, running on the host system   

 

The device firmware, which runs on the module itself 

The host drivers interface with the SDIO or USB bus drivers and upper layer protocol stacks of the 
Linux/Android system. The basic architecture of the Wi-Fi driver is typical of a thick firmware 
architecture, where the Wi-Fi firmware handles all 802.11 MAC management tasks. Figure 8 shows 
the basic driver and firmware architecture. 

The following steps are performed while loading the Wi-Fi host driver: 

 

The driver registers itself with the MMC/SDIO or USB bus driver. 

 

Upon successful registration, the bus driver calls the Wi-Fi driver's probe handler, when the module 

is detected. 

 

The probe handler allocates and initializes internal structures, registers the interrupt service 

routine and starts the main driver threads. 

 

The firmware image is downloaded to the module and the hardware is initialized. 

 

Network devices such as STA, AP, and WFD are registered. 

 

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: