background image

WE866C3 Wi-Fi Network Interface Card (NIC) User Guide

 

1VV0301545 Rev 1.0  

Page 

11

 of 

37 

2018-07-09

 

 

Linux Host 

The Linux host can be any processor system that can run standard Linux software. It can 
be a high end X86 PC or an embedded platform like i.MX 6SLL. The host processor should 
be a 32-bit system running a 32-bit Linux operating system. 

 

NOTE: 

Currently, WE866C3 driver is supported in 32-bit Linux environment 
only. 

 

WE866C3 Modules 

WE866C3 modules acts as NIC card, providing IEEE802.11 a/b/g/n/ac MAC functionalities. 

 

SDIO Interconnect 

The  SDIO  interconnect  provides  connectivity  between  the  host  and  WE866C3  module 
processor. 

 

Software Components 

The  following  diagram  illustrates  the  software  components  being  used.  Telit  Wi-Fi  NIC 
host software is provided along with the package 

– which is required to be installed in a 

directory and built, for details refer to 

4

Building and Loading the Software

.

 

 

Figure 1:- Software Components 

Summary of Contents for WE866C3

Page 1: ...WE866C3 Wi Fi Network Interface Card NIC User Guide 1VV0301545 Rev 1 0 2018 07 09 ...

Page 2: ...lusive rights for copyrighted material including the exclusive right to copy reproduce in any form distribute and make derivative works of the copyrighted material Accordingly any copyrighted material of Telit and its licensors contained herein or in the Telit products described in this instruction manual may not be copied reproduced distributed merged or modified in any manner without the express...

Page 3: ...igh Risk Activities IV Trademarks TELIT and the Stylized T Logo are registered in Trademark Office All other product or service names are the property of their respective owners V Third Party Rights The software may include Third Party Right software In this case you agree to comply with all terms and conditions imposed on you in respect of such separate software In addition to Third Party Terms t...

Page 4: ...ments 9 2 HARDWARE AND SOFTWARE COMPONENTS 10 Hardware Components 10 Linux Host 11 WE866C3 Modules 11 SDIO Interconnect 11 Software Components 11 Linux Application 12 2 2 1 1 WPA Supplicant 12 2 2 1 2 WPA CLI 12 2 2 1 3 Hostapd 12 2 2 1 4 Hostapd CLI 12 2 2 1 5 UserApp 12 Telit Wi Fi NIC Applications 12 2 2 2 1 WE866C3 Wi Fi Driver 12 2 2 2 2 WE866C3 Firmware 12 Software Package 13 3 REFERENCE PLA...

Page 5: ...t Mode 25 P2P GO Mode 25 Throughput Measurement 26 UDP Throughput Test Procedure in Station Mode 26 TCP Throughput Test Procedure in Station Mode 27 APPENDIX A DOWNLOADING BUILDING AND INSTALLING LINUX KERNEL ON X86 UBUNTU 28 A 1 Test Setup Preparation 28 A 2 Installing Linux Kernel v4 9 11 28 A 3 Building WE866C3 Driver for x86 Platform 30 APPENDIX B BUILDING AND INSTALLING LINUX KERNEL AND DRIVE...

Page 6: ...Guide 1VV0301545 Rev 1 0 Page 6 of 37 2018 07 09 FIGURE LIST Figure 1 Software Components 11 Figure 2 i MX 6SLL EVK Board 14 Figure 3 WE866C3 Board 15 Figure 4 Jumper Position for 1 8v SDIO Signal 15 Figure 5 Jumper Position for 3 3v SDIO Signal 16 ...

Page 7: ...integrators and about to implement their applications using Telit Wi Fi NIC module Contact Information and Support For general contact technical support services technical questions and report documentation errors contact Telit Technical Support at TS SRD telit com Alternatively use http www telit com support For detailed information about where you can buy the Telit modules or for recommendations...

Page 8: ...c equipment failure or bodily injury may occur Caution or Warning Alerts the user to important points about integrating the module if these points are not followed the module and end user equipment may fail or malfunction Tip or Information Provides advice and suggestions that may be useful when integrating the module All dates are in ISO 8601 format i e YYYY MM DD ...

Page 9: ... Network Interface Card NIC User Guide 1VV0301545 Rev 1 0 Page 9 of 37 2018 07 09 Related Documents Please refer to https www telit com m2m iot products wifi bluetooth modules for current documentation and downloads ...

Page 10: ... calibrated for easy integration and building applications instantly without requiring any work on radio connectivity modules WE866C3 modules provide an external interface i e SDIO port to interface it to a variety of hosts The SDIO interface provides Ultra High Speed SDR104 interconnection for faster communication with the host systems that are based on processors with 32 bit CPU and MMU which ru...

Page 11: ...3 driver is supported in 32 bit Linux environment only WE866C3 Modules WE866C3 modules acts as NIC card providing IEEE802 11 a b g n ac MAC functionalities SDIO Interconnect The SDIO interconnect provides connectivity between the host and WE866C3 module processor Software Components The following diagram illustrates the software components being used Telit Wi Fi NIC host software is provided along...

Page 12: ... RADIUS client EAP server and RADIUS authentication server 2 2 1 4 Hostapd CLI hostapd_cli utility is a text based frontend program for interacting with hostapd 2 2 1 5 UserApp UserApp makes use of networking services to setup socket connections and perform data transfer Telit Wi Fi NIC Applications 2 2 2 1 WE866C3 Wi Fi Driver WE866C3 Wi Fi driver software package provided by Telit is a kernel mo...

Page 13: ...rted application software files 2 build This folder contains scripts and make files to compile the driver software 3 drivers This folder contains driver source code files and make files a patches This folder contains required patch files to be used in the Linux host system b firmware This folder contains binary images needed to run the WE866C3 device 4 bsp This folder contains the files that suppo...

Page 14: ...t machine is booted with Ubuntu 16 04 32 bit OS and the Linux kernel version 4 9 11 Arm Cortex A9 Embedded Platform i MX 6SLL EVK board is used as embedded host platform to test WE866C3 module i MX 6SLL application processor is a single Arm Cortex A9 which operates up to a speed of 1GHz Products based on the i MX 6SLL application processors enables cost effective rapid development of multimedia ap...

Page 15: ...nd 3 3v SDIO line signal operations depending on the host platform with SDIO controller capabilities If the host SDIO controller is based on SD 2 0 protocol then it supports only 3 3v I O operation So the jumper should be put into 3 3v position If the host SDIO controller is based on SD 3 0 protocol then it supports 1 8v I O operation The jumper should be put in the 1 8v position 1 8v and 3 3v jum...

Page 16: ...WE866C3 Wi Fi Network Interface Card NIC User Guide 1VV0301545 Rev 1 0 Page 16 of 37 2018 07 09 Figure 5 Jumper Position for 3 3v SDIO Signal ...

Page 17: ...e cross compiled for the i MX 6SLL_EVK platform For details refer to Appendix B Building and Installing Linux Kernel and Driver on NXP i MX 6 Embedded Host WE866C3 Linux Package This step is common for all Linux host platforms 1 Create a folder called telit mkdir telit 2 Copy WE866C3 tar gz package into this directory 3 Unzip the package using following command tar xvf WE866C3 tar gz Building WE86...

Page 18: ...er object wlan ko file plug the WE866C3 Wi Fi card in SDIO slot of the host machine 1 Insert the WE866C3 kernel object ko file into Linux kernel sudo insmod rootfs te p233 build lib modules wlan ko 2 WE866C3 Wi Fi card will be listed as a wireless device with the names wlan0 p2p0 in the network interface list ifconfig a ...

Page 19: ...his is verified using the following command Ifconfig The following command is used to find the physical device corresponding to WE866C3 WLAN interface iw dev The following command is used to check the features and commands supported by all devices iw phy STA Mode Telit WE866C3 module supports 802 11 b g n a ac modes in STA operations STA mode supports connecting to both 2 4 GHz 5GHz BSS networks F...

Page 20: ...s running sudo killall wpa_supplicant sudo rfkill unblock wifi 5 Start wpa_supplicant and initiate connection use the required conf file For example wpa_supplicant B i wlan0 nl80211 c sta_open_con conf wpa_supplicant B i wlan0 nl80211 c sta_aes_con conf 6 Get IP address by running dhclient dhclient wlan0 7 To check the IP address and status ifconfig wlan0 8 If needed disable power save feature sud...

Page 21: ...aces b File content auto wlan0 iface wlan0 inet static address 10 0 0 1 netmask 255 255 255 0 gateway 10 0 0 1 c Restart networking etc init d networking restart 3 Open dhcp configuration file and modify if required vi etc dhcp dhcpd conf Sample configuration given below ddns update style none ignore client updates authoritative option routers 10 0 0 1 option subnet mask 255 255 255 0 option broad...

Page 22: ...nterface wlan0 driver nl80211 ssid Test_AP_OPEN channel 11 hw_mode g ieee80211n 1 b 802 11 b g n mode AP with AES security hostapd_aes conf interface wlan0 driver nl80211 ssid Test_AP_AES channel 11 hw_mode g ieee80211n 1 wpa 2 wpa_passphrase TelitDemo123 wpa_key_mgmt WPA PSK rsn_pairwise CCMP c 802 11 a ac VHT 80 mode AP with AES security hostapd_11ac_aes conf interface wlan0 driver nl80211 ssid ...

Page 23: ...AP mode of operation iw dev wlan0 interface add ap0 type __ap 3 Start STA mode in WLAN0 interface and connect to the required AP sudo wpa_supplicant B i wlan0 D nl80211 c sta_aes_con conf 4 Run dhclient application to get the IP address for the STA interface sudo dhlcient wlan0 5 Assign static address to the newly created AP interface ap0 and start DHCP server as shown in the section 5 3 AP Mode 6...

Page 24: ...ion 5 2 STA Mode 2 Start P2P functionality in the p2p0 interface using the wpa_supplicant application P2P mode supports both GO and client functionalities Refer section 5 5 P2P Mode for the steps to configure the p2p0 interface P2P Mode WE866C3 driver supports the P2P mode of operation WE866C3 device registers a p2p0 physical interface which is used for P2P mode P2P mode can be started as either P...

Page 25: ... 7 Connect the GO MAC address using the PIN method p2p_connect GO MAC addr pin go_intent 1 This command generates the PIN number to be typed in the keypad of the GO device 8 When the P2P connection is successful then the command for the status of the device provides the new BSS status 9 Get the IP address for the P2P client interface dhclient p2p0 Once the IP address is received check the data tra...

Page 26: ...ce issue the connect command to the client device address along with the PIN generated by the client address p2p_connect Client MAC address pin_value go_intent 15 10 Run the dhclient in the P2P client device and check the data transfer between P2P GO and client devices Throughput Measurement iPerf is a tool used to measure the maximum TCP UDP throughput For peak performance tests are conducted in ...

Page 27: ...tion Mode Bring up WE866C3 Wi Fi NIC module say STA 1 and connect to an AP Connect one of the PC Laptop say STA 2 to same AP through ethernet cable Disable power save in WE866C3 Wi Fi NIC sudo iw dev wlan0 set power_save off Start TCP server in Laptop iperf s Now issue the following command in STA 1 iperf c IP address of STA 2 t 60 ...

Page 28: ...o apt get install ncurses dev sudo apt get install libssl dev sudo apt get install libnl 3 dev sudo apt get install libnl genl 3 dev sudo apt get install bison sudo apt get install flex A 2 Installing Linux Kernel v4 9 11 1 Before downloading the kernel set the git credentials which will be used while patching the kernel git config global user name name git config global user email name mail com 2...

Page 29: ...test mode MMC To enable MMC SD SDIO card support MMC_DEBUG To enable MMC debugging If debugging is required CFG80211_INTERNAL_REGDB To use the statically compiled regulatory rule data base 7 Build and install the Linux kernel with the required modules make j8 make modules make modules_install make headers_install make install 8 After installation reboot the host to boot with kernel v4 9 11 If the ...

Page 30: ...ries and configuration files should be copied to the required locations in the kernel 1 The binary files should be copied to the location lib firmware in the Linux kernel file system of the host machine sudo cp rf WE866C3 rootfs te p233 build lib firmware WLAN firmware lib firmware 2 The configuration files should be copied to the location lib firmware wlan in the Linux kernel file system Create a...

Page 31: ...untu com B 2 Building the Kernel for i MX 6 Platform 1 Create a directory mcimx6sll evk and consider this as the build directory mkdir mcimx6sll evk cd mcimx6sll evk 2 Create directory boot kernel_modules which would hold the final images and info mkdir mcimx6sll evk boot mkdir mcimx6sll evk kernel_modules 3 Download the pre built Linaro GCC compiler for cross compilation wget c no check certifica...

Page 32: ...9 11 wl_cfg80211 patch 12 Patch the kernel using the patches given along with the WE866C3 package git am mcimx6sll evk WEX866C3 drivers patches te p233 v4 9 11 patch 13 Make the default config for i mx series devices make imx_v7_defconfig 14 Modify the kernel configuration for any required changes make menuconfig Enable the following settings in the kernel CFG80211 To enable Wireless configuration...

Page 33: ...mmcblk0 lsblk is used for determining the device id export DISK dev mmcblk0 2 To erase the partition table labels on microSD card execute the following command sudo dd if dev zero of DISK bs 1M count 50 Now remove and re insert the MMC card 3 Install the bootloader sudo dd if mcimx6sll evk u boot 2018 01 u boot dtb imx of DISK seek 2 bs 512 4 Create Partition Layout util linux v2 26 sfdisk is rewr...

Page 34: ...v mcimx6sll evk linux imx arch arm boot dts imx6sll dtb media rootfs boot dtbs kernel_version 11 Copy the kernel modules sudo cp rv mcimx6sll evk kernel_modules lib media rootfs 12 Create static information about filesystem sudo sh c echo dev mmcblk1p1 auto errors remount ro 0 1 media rootfs etc fstab 13 Unmount the SD card sync sudo umount media rootfs B 4 Building WE866C3 Wi Fi Linux Application...

Page 35: ...ct is built the binaries and configuration is available in the folder WE866C3 rootfs te p233 build These binaries and configuration should be copied to the Linux files system expanded in the i MX 6 host SD card 1 Insert the SD card in the laptop Copy the cross compiled driver output folder to the SD card sudo cp rf mcimx6sll evk WE866C3 rootf te p233 build media rootfs home ubuntu 2 Copy the binar...

Page 36: ...terface Card NIC User Guide 1VV0301545 Rev 1 0 Page 36 of 37 2018 07 09 6 DOCUMENT HISTORY Revision Date Changes 0 0 2018 06 21 First issue 1 0 2018 07 09 Updated section B 2 Building the Kernel for i MX 6 Platform 5 3 AP Mode ...

Page 37: ......

Reviews: