How it Works
Telit Wireless Solutions
Loading...
WE866C3
User Manual
37 pgs830.45 Kb0

Telit Wireless Solutions WE866C3 User Manual

WE866C3 Wi-Fi Network Interface Card
(NIC) User Guide
1VV0301545 Rev 1.0 – 2018-07-09
WE866C3 Wi-Fi Network Interface Card (NIC) User Guide
SPECIFICATIONS ARE SUBJECT TO CHANGE WITHOUT NOTICE
NOTICE
While reasonable efforts have been made to assure the accuracy of this document, Telit assumes no liability resulting from any inaccuracies or omissions in this document, or from use of the information obtained herein. The information in this document has been carefully checked and is believed to be reliable. However, no responsibility is assumed for inaccuracies or omissions. Telit reserves the right to make changes to any products described herein and reserves the right to revise this document and to make changes from time to time in content hereof with no obligation to notify any person of revisions or changes. Telit does not assume any liability arising out of the application or use of any product, software, or circuit described herein; neither does it convey license under its patent rights or the rights of others.
It is possible that this publication may contain references to, or information about Telit products (machines and programs), programming, or services that are not announced in your country. Such references or information must not be construed to mean that Telit intends to announce such Telit products, programming, or services in your country.
COPYRIGHTS
This instruction manual and the Telit products described in this instruction manual may be, include or describe copyrighted Telit material, such as computer programs stored in semiconductor memories or other media. Laws in the Italy and other countries preserve for Telit and its licensors certain exclusive 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 written permission of Telit. Furthermore, the purchase of Telit products shall not be deemed to grant either directly or by implication, estoppel, or otherwise, any license under the copyrights, patents or patent applications of Telit, as arises by operation of law in the sale of a product.
COMPUTER SOFTWARE COPYRIGHTS
WE866C3 Wi-Fi Network Interface Card (NIC) User Guide
USAGE AND DISCLOSURE RESTRICTIONS
I. License Agreements
The software described in this document is the property of Telit and its licensors. It is furnished by express license agreement only and may be used only in accordance with the terms of such an agreement.
II. Copyrighted Materials
Software and documentation are copyrighted materials. Making unauthorized copies is prohibited by law. No part of the software or documentation may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language or computer language, in any form or by any means, without prior written permission of Telit
III. High Risk Materials
Components, units, or third-party products used in the product described herein are NOT fault-tolerant and are NOT designed, manufactured, or intended for use as on-line control equipment in the following hazardous environments requiring fail-safe controls: the operation of Nuclear Facilities, Aircraft Navigation or Aircraft Communication Systems, Air Traffic Control, Life Support, or Weapons Systems (High Risk Activities"). Telit and its supplier(s) specifically disclaim any expressed or implied warranty of fitness for such High 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, the disclaimer of warranty and limitation of liability provisions in this License shall apply to the Third Party Right software.
TELIT HEREBY DISCLAIMS ANY AND ALL WARRANTIES EXPRESS OR IMPLIED FROM ANY THIRD PARTIES REGARDING ANY SEPARATE FILES, ANY THIRD PARTY MATERIALS INCLUDED IN THE SOFTWARE, ANY THIRD PARTY MATERIALS
FROM WHICH THE SOFTWARE IS DERIVED (COLLECTIVELY “OTHER CODE”), AND
THE USE OF ANY OR ALL THE OTHER CODE IN CONNECTION WITH THE SOFTWARE, INCLUDING (WITHOUT LIMITATION) ANY WARRANTIES OF SATISFACTORY QUALITY OR FITNESS FOR A PARTICULAR PURPOSE.
NO THIRD PARTY LICENSORS OF OTHER CODE SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND WHETHER MADE UNDER CONTRACT, TORT OR OTHER LEGAL THEORY, ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE OTHER CODE OR THE EXERCISE OF ANY RIGHTS GRANTED UNDER EITHER OR BOTH THIS LICENSE AND THE LEGAL TERMS APPLICABLE TO ANY SEPARATE FILES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
WE866C3 Wi-Fi Network Interface Card (NIC) User Guide
Contents
NOTICE….. ....................................................................................................... 2
COPYRIGHTS .................................................................................................. 2
COMPUTER SOFTWARE COPYRIGHTS ....................................................... 2
USAGE AND DISCLOSURE RESTRICTIONS ................................................ 3
CONTENTS ...................................................................................................... 4
1. INTRODUCTION ............................................................................ 7
Scope ............................................................................................. 7
Audience ........................................................................................ 7
Contact Information and Support ................................................... 7
Text Convention ............................................................................. 8
Related Documents ........................................................................ 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 PLATFORM .......................................................... 14
X86 PC Host Platform .................................................................. 14
Arm Cortex A9 Embedded Platform ............................................. 14
4. BUILDING AND LOADING THE SOFTWARE ............................ 17
WE866C3 Wi-Fi Network Interface Card (NIC) User Guide
X86 PC Host Platform .................................................................. 17
ARM Cortex A9 Embedded Platform ............................................ 17
WE866C3 Linux Package ............................................................ 17
Building WE866C3 Driver ............................................................. 17
Loading the Driver Module ........................................................... 17
5. WIRELESS NETWORK OPERATIONS ...................................... 19
WE866C3 WLAN Interface Details ............................................... 19
STA Mode .................................................................................... 19
AP Mode ....................................................................................... 21
Concurrent Mode Operation ......................................................... 23
STA - AP Mode Concurrency ....................................................... 23
STA - P2P Mode Concurrency ..................................................... 24
P2P Mode ..................................................................................... 24
P2P Client 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 DRIVER ON NXP
I.MX 6 EMBEDDED HOST ............................................................................. 31
B.1 Basic Requirements ..................................................................... 31
B.2 Building the Kernel for i.MX 6 Platform......................................... 31
B.3 Setting up the SD Card ................................................................ 33
B.4 Building WE866C3 Wi-Fi Linux Application for i.MX 6 on EVK
platform ........................................................................................ 34
6. DOCUMENT HISTORY ................................................................ 36
WE866C3 Wi-Fi Network Interface Card (NIC) User Guide
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
WE866C3 Wi-Fi Network Interface Card (NIC) User Guide
1. INTRODUCTION
Scope
This user guide provides information required to install and evaluate Telit Wi-Fi NIC driver for Linux hosts with WE866C3 modules. It also provides guidelines to prepare the host platform and start testing the module using the Linux supplicant applications.
Audience
This document is intended for Telit customers, who are 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 on accessories and components visit:
http://www.telit.com
Our aim is to make this guide as helpful as possible. Keep us informed of your comments and suggestions for improvements.
Telit appreciates feedback from the users of our information.
WE866C3 Wi-Fi Network Interface Card (NIC) User Guide
Text Convention
Danger – This information MUST be followed or catastrophic 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.
WE866C3 Wi-Fi Network Interface Card (NIC) User Guide
Related Documents
Please refer to https://www.telit.com/m2m-iot-products/wifi-bluetooth-modules/ for current documentation and downloads.
WE866C3 Wi-Fi Network Interface Card (NIC) User Guide
2. HARDWARE AND SOFTWARE COMPONENTS
This chapter describes the components and procedures for building a wireless application with a Linux host and Telit WE866C3 Wi-Fi NIC module.
The Telit WE866C3 module provides IEEE802.11a/b/g/n/ac Wireless LAN functionalities. It integrates complete MAC, PHY and RF functionality on a single chip providing a low cost and an easy-to-use solution for adding wireless connectivity to applications.
WE866C3 modules integrate the required components like crystals, regulators, RF front end components to provide ready-to-use WLAN radio modules that can be used as NIC cards to provide network connectivity to hosts. These modules are regulatory, certified and 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 run on Linux operating systems. The Linux host runs the WLAN drivers, the network stack, the supplicant and authenticator 802.11 security applications to establish an 802.11 based Wireless LAN network using the WE866C3 module.
Standard Linux applications such as “wpa_supplicant” and “hostapd” are used for control path communications and standard Linux data path is used for data communications, and no custom software required.
Hardware Components
The following diagram illustrates the hardware components:
Figure :-Hardware Components
The description to the hardware components are as follows:
WE866C3 Wi-Fi Network Interface Card (NIC) User Guide
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
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
WE866C3 Wi-Fi Network Interface Card (NIC) User Guide
Linux Application
Standard Linux applications are used for network connection setup and management. Following are the standard Linux application:
2.2.1.1. WPA Supplicant
“wpa_supplicant” is a WPA supplicant for Linux, BSD, Mac OS X, and Windows with WPA and WPA2 (IEEE 802.11i / RSN) support. It is suitable for both desktop/laptop computers and embedded systems. The supplicant is IEEE 802.1X/WPA component that is used in the client stations. It implements key negotiation with a WPA Authenticator, controls the roaming and IEEE 802.11 authentication/association of WLAN driver.
2.2.1.2. WPA CLI
“wpa_cli” is a text-based frontend program interacting with “wpa_supplicant”. It is used to get the status, change configuration, trigger events, and request interactive user input.
2.2.1.3. Hostapd
“hostapd” is a user space daemon for access point and authentication servers. It implements IEEE 802.11 access point management, IEEE 802.1X/WPA/WPA2/EAP Authenticators, 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 module which implements Wi-Fi driver for interfacing the Linux kernel network control and data path to the WE866C3 Wi-Fi device. It’s implemented as an IEEE802.11 Soft-MAC driver to establish communication between the Linux kernel and WE866C3 device. It contains SDIO driver adaptation layer for communication between Linux kernel and WE866C3 device over SDIO interconnect. It also performs queuing and flow control.
2.2.2.2. WE866C3 Firmware
WE866C3 firmware binaries are provided as part of the driver software package. These binaries should be placed at a certain location in the Linux host machine file system. These binaries will be accessed by the WE866C3 device to implement the IEEE 802.11 MAC functionality. It handles scan, association and data transfer functionality and implements other MAC features, PHY and RF functionalities etc.
Loading...
+ 25 hidden pages
Buy Points How it Works FAQ Contact Us Questions and Suggestions Privacy Policy Cookie Policy Terms of Use