Telit Wireless Solutions GS2K User Manual
Telit Wireless Solutions GS2K User Manual

Telit Wireless Solutions GS2K User Manual

Wi-fi network interface card
Hide thumbs Also See for GS2K:
Table of Contents

Advertisement

Quick Links

GS2K Wi-Fi Network Interface Card
(NIC) User Guide
1VV0301491 Rev 2.0 – 2018-02-13

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the GS2K and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Telit Wireless Solutions GS2K

  • Page 1 GS2K Wi-Fi Network Interface Card (NIC) User Guide 1VV0301491 Rev 2.0 – 2018-02-13...
  • Page 2: Notices

    GS2K Wi-Fi Network Interface Card (NIC) User Guide TELIT MAY MAKE CHANGES TO SPECIFICATIONS AND PRODUCT DESCRIPTIONS AT ANY TIME, WITHOUT NOTICE. NOTICES LIMITATION OF LIABILITY 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.
  • Page 3: Usage And Disclosure Restrictions

    GS2K Wi-Fi Network Interface Card (NIC) User Guide USAGE AND DISCLOSURE RESTRICTIONS 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.
  • Page 4: Table Of Contents

    GS2K Wi-Fi Network Interface Card (NIC) User Guide CONTENTS NOTICES………….................... 2 LIMITATION OF LIABILITY ................2 COPYRIGHT ..................... 2 USAGE AND DISCLOSURE RESTRICTIONS ..........3 CONTENTS ...................... 4 INTRODUCTION ................7 1.1. Scope ..................... 7 1.2. Audience ..................7 1.3.
  • Page 5 Preparing the Test Setup ............. 16 4.3.3. Loading and Running the Driver ........... 16 WIRELESS NETWORK OPERATIONS ........17 5.1. Steps to load the GS2K Wi-Fi module during boot time: ....17 5.2. GS2K WLAN interface details ............17 5.3. STA Mode ..................17 5.4.
  • Page 6 GS2K Wi-Fi Network Interface Card (NIC) User Guide APPENDIX B: BUILDING AND INSTALLING LINUX KERNEL AND DRIVER ON NXP I MX6 EMBEDDED HOST ................34 Bringing up the NXP IMX6 EVK Board: ........34 Setting up the SD card ..............36 APPENDIX C: RF TEST COMMAND AND ARGUMENT DESCRIPTION ..
  • Page 7: Introduction

    INTRODUCTION 1.1. Scope This user guide provides information required to install and evaluate Telit Wi-Fi NIC driver for Linux hosts with GS2K modules. It also provides guidelines for using firmware update and RF test commands. 1.2. Audience This document is intended for Telit customers, who are integrators and about to implement their applications using Telit Wi-Fi NIC module.
  • Page 8: Related Documents

    GS2K Wi-Fi Network Interface Card (NIC) User Guide 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. 1.5. Related Documents Please refer to http://www.telit.com/gnss/ for current documentation and downloads.
  • Page 9: Hardware And Software Components

    These modules are regulatory, certified and calibrated for easy integration and build applications instantly without requiring any work on radio connectivity modules. GS2K based modules provides host interface over SDIO, SPI and UART for connecting a variety of hosts. The SDIO interface provides high speed interconnection for bigger host systems that are based on processors with 32-bit CPU and MMU which run on Linux operating systems.
  • Page 10: Gs2K Modules

    GS2K Wi-Fi Network Interface Card (NIC) User Guide 2.1.2. GS2K Modules GS2K modules acts as NIC card, it is based on GS2K chipset and supports all GS2K modules. 2.1.3. SDIO Interconnect The SDIO interconnect provides connectivity between the host and GS2K processor.
  • Page 11: Hostapd

    2.2.4. GS2K Wi-Fi Driver GS2K Wi-Fi driver is a kernel module provided by Telit. This module implements driver for interfacing Linux kernel network control and data path to GS2K Wi-Fi device. It interprets commands and messages between Linux kernel and GS2K. It also performs queuing and flow control.
  • Page 12: Software Package

    GS2K Wi-Fi Network Interface Card (NIC) User Guide 2.3. Software Package Telit Wi-Fi NIC software package “gs2k_wifi_nic.tar.gz” consists of Telit Wi-Fi NIC software components and few tools. Following are the software package contents: 1. fw – gs2k fw single image binary 2.
  • Page 13: Reference Platform

    3.1. X86 PC Host Platform “Lenovo Thinkpad T440p” laptop is used for X86 PC host running Ubuntu 16.4 and Linux Kernel version 4.9.11. This machine has a SD card slot to plug the GS2K target board for testing. 3.2. Arm Cortex A9 Embedded Platform i.MX6SLL application processor is a single Arm®...
  • Page 14 GS2K Wi-Fi Network Interface Card (NIC) User Guide GS2K SDIO WAB is plugged into SD card slot on laptop for testing. 1VV0301491 Rev 2.0 Page 14 of 54 2018-02-13...
  • Page 15: Building And Loading The Software

    1. Go to “~/telit/gs2k_wifi_nic/drv” 2. Build the driver 4.2.3. Preparing the Test Setup Program GS2K WAB with GS2K firmware provided in ‘fw’ folder of the package using the flash programmer tool. Refer “Appendix D: Programming Setup - GainSpan WAB Board” for preparing the test setup and for programming steps using flash programmer refer “GS2K Module...
  • Page 16: Preparing The Test Setup

    Kernel and Driver on NXP i MX6 Embedded Host” to download, build and install the kernel, root filesystem and GS2K driver. 4.3.2. Preparing the Test Setup Program GS2K WAB with GS2K firmware provided in ‘fw’ folder of the package using the flash programmer tool. Refer “Appendix D: Programming Setup - GainSpan WAB Board”...
  • Page 17: Wireless Network Operations

    • Once the above commands are successfully executed the at every restart the GS2K Wi-Fi module will be automatically loaded. • Run command “lsmod | grep” for gs2k to check whether “gs2k_sdio” is currently loaded. 5.2. GS2K WLAN interface details...
  • Page 18 GS2K Wi-Fi Network Interface Card (NIC) User Guide > /etc/init.d/networking restart 2. Create or update the configuration file. Typical configuration file contains the following references: a) Open Mode (for example sta_open_con.conf file) ctrl_interface=/run/wpa_supplicant update_config=1 network={ ssid="MY_AP_OPEN" scan_ssid=1 key_mgmt=NONE b) AES security (for example sta_aes_con.conf file)
  • Page 19: Ap Mode

    Check whether GS2K Wi-Fi module is already installed. >lsmod | grep gs2k If above command does not list gs2k_sdio, then load the module manually. Go to the directory in which GS2K Wi-Fi NIC driver installed. >cd ~/telit/gs2k_wifi_nic/drv >sudo insmod gs2k_sdio.ko 5.
  • Page 20 GS2K Wi-Fi Network Interface Card (NIC) User Guide a) Open configuration file and make sure static configuration. > vi /etc/network/interfaces File content: auto wlan0 iface wlan0 inet static address 10.0.0.1 netmask 255.255.255.0 gateway 10.0.0.1 b) restart networking > /etc/init.d/networking restart 1.2.
  • Page 21 GS2K Wi-Fi Network Interface Card (NIC) User Guide a) Open Mode ( hostapd_open.conf) interface=wlan0 driver=nl80211 ssid=Test_AP_OPEN channel=11 hw_mode=g ieee80211n=1 b) AES security (hostapd_aes.conf) interface=wlan0 driver=nl80211 ssid=Test_AP_AES channel=11 hw_mode=g ieee80211n=1 wpa=2 wpa_passphrase=GSDemo123 wpa_key_mgmt=WPA-PSK rsn_pairwise=CCMP c) TKIP security (hostapd_tkip.conf) interface=wlan0 driver=nl80211 ssid=Test_AP_TKIP...
  • Page 22: Throughput Measurement

    5.5.1. UDP throughput Test procedure in station mode • Bring up GS2K Wi-Fi NIC module (say STA#1) and connect to an AP • Connect one of the PC/Laptop (say STA#2) to the same AP through an ethernet cable •...
  • Page 23: Tcp Throughput Test Procedure In Station Mode

    >iperf -u -c <IP address of STA#2> -t 60 -b 100m 5.5.2. TCP throughput Test procedure in station mode • Bring up GS2K 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 •...
  • Page 24: Over The Host Firmware Update

    OTHFU application provided in the package. 6.1. GS2K OTHFU Application ‘gs2k_othfu’ is a service tool for GS2K firmware upgrade. It is generic netlink based CLI utility that allows GS2K device firmware to be updated by Host MCU. Host MCUs updates the node with OTHFU application.
  • Page 25: Compiling And Building The Application

    >sudo killall wpa_supplicant >sudo rfkill unblock wifi 2. Bring up GS2K Wi-Fi module Go to the directory in which GS2K Wi-Fi driver installed (driver/gs2k/). >sudo insmod gs2k_sdio.ko 3. Initiate firmware update Go to the directory in which OTHFU userapp installed.
  • Page 26: Rf Test Commands

    7.1. GS2K RF Test Application 'gs2k_rftest' is the utility tool for RF testing of GS2K driver. It is Generic Netlink based CLI utility for GS2K RF testing that allows host to send RF Test commands to GS2K device.
  • Page 27: Compiling And Building The Application

    >sudo killall wpa_supplicant >sudo rfkill unblock wifi 2. Bring up GS2K Wi-Fi module Go to the directory in which GS2K Wi-Fi driver installed (driver/gs2k/). >sudo insmod gs2k_sdio.ko 3. RF Test Tx frame Go to the directory in which RFTEST userapp installed.
  • Page 28 GS2K Wi-Fi Network Interface Card (NIC) User Guide >sudo ./gs2k_rftest wlan0 wframetxtest 1 0 50000 1000 11 16 00:11:22:33:44:55 00:50:c2:5e:10:99 0 0 0 0 0 4 0 2 0 1 >sudo ./gs2k_rftest wlan0 wrfteststop 4. RF Test Rx Test >sudo ./gs2k_rftest wlan0 wrfteststart >sudo ./gs2k_rftest wlan0 wrxtest 6 0 0 00:1d:c9:17:8d:b1 0...
  • Page 29: Appendix A: Downloading, Building And Installing Linux Kernel On X86 Ubuntu

    GS2K Wi-Fi Network Interface Card (NIC) User Guide APPENDIX A: DOWNLOADING, BUILDING AND INSTALLING LINUX KERNEL ON X86 UBUNTU Refer the documentation of Linux for changes in the kernel source code or to verify the tool version to be used to build the kernel.
  • Page 30 GS2K Wi-Fi Network Interface Card (NIC) User Guide make menuconfig 8. The following prompt appears: 9. Navigate to Networking support, click on Enter Key - this shows the Network Modules. Navigate to Wireless, click on Enter Key and include the “cfg80211”- wireless configuration API by pressing "Y"...
  • Page 31 GS2K Wi-Fi Network Interface Card (NIC) User Guide 10. Navigate to the Device drivers, enter and enable MMC/SD/SDIO support. 11. Save the configuration file. 1VV0301491 Rev 2.0 Page 31 of 54 2018-02-13...
  • Page 32 GS2K Wi-Fi Network Interface Card (NIC) User Guide 1VV0301491 Rev 2.0 Page 32 of 54 2018-02-13...
  • Page 33: Building The Kernel

    GS2K Wi-Fi Network Interface Card (NIC) User Guide Building the kernel 1. Compile the kernel using the following command: make make -jx (Where x = 2*no.of cores in your system) to speed up the build. Installing and booting the kernel Login as a super user using “sudo”...
  • Page 34: Appendix B: Building And Installing Linux Kernel And Driver On Nxp Imx6 Embedded Host

    GS2K Wi-Fi Network Interface Card (NIC) User Guide APPENDIX B: BUILDING AND INSTALLING LINUX KERNEL AND DRIVER ON NXP I MX6 EMBEDDED HOST Bringing up the NXP IMX6 EVK Board: Basic Requirements Laptop or a desktop running a recent release of Debian, Fedora or Ubuntu;...
  • Page 35 17. Create an environment variable using the folder name "4.X.Y-Z" exactly as shown in the folder” ~/mcimx6sll-evk/kernel_modules/lib/modules/ “. export kernel_version=4.X.Y-Z 18. Navigate to the GS2K driver, the project directory cd ~/telit/gs2k_wifi_nic/drv 19. Build the driver using the following command: make ARCH=arm CROSS_COMPILE=~/imx6sl-evk/gcc-linaro-6.4.1-2017.11-...
  • Page 36: Setting Up The Sd Card

    GS2K Wi-Fi Network Interface Card (NIC) User Guide Setting up the SD card Insert the SD card into the laptop 1. Assume “DISK=/dev/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.
  • Page 37 GS2K Wi-Fi Network Interface Card (NIC) User Guide 7. Copy the root file system sudo tar xfvp ~/mcimx6sll-evk/ubuntu-16.04.3-minimal-armhf-2017-12-09/armhf- rootfs-ubuntu-xenial.tar -C /media/rootfs sudo chown root:root /media/rootfs/ sudo chmod 755 /media/rootfs/ 8. Set uname_r in /boot/uEnv.txt sudo sh -c "echo 'uname_r=${kernel_version}' >> /media/rootfs/boot/uEnv.txt"...
  • Page 38: Appendix C: Rf Test Command And Argument Description

    GS2K Wi-Fi Network Interface Card (NIC) User Guide APPENDIX C: RF TEST COMMAND AND ARGUMENT DESCRIPTION Regulatory and Transmit Tests using RF Test Commands C.1.1 Regulatory Testing The lowest data rate of each standards (802.11b, 802.11g, and 802,11n) is used, as the transmit power is highest at these rates.
  • Page 39 GS2K Wi-Fi Network Interface Card (NIC) User Guide <GreenField> <PreambleType> <QosEnable> <AckPolicy> <Scrambler> <AifsnVal> <Antenna> <ccaBypass> Parameter Description: The following table provides the Asynchronous Frame Transmission parameters. Parameter Optional/Mandatory Value Description Use iw dev command to find the device Mandatory wlan0-n device ID.
  • Page 40 GS2K Wi-Fi Network Interface Card (NIC) User Guide Parameter Optional/Mandatory Value Description long QosEnable Mandatory Enable QoS AckPolicy (Debug parameter) Mandatory Scrambler (Debug parameter) Mandatory AifsnVal Mandatory Antenna Mandatory ccaBypass Mandatory The following table describes the Asynchronous Frame Transmission Data Rates:...
  • Page 41: C.1.7 Start Asynchronous Frame Reception

    GS2K Wi-Fi Network Interface Card (NIC) User Guide TxRate HtEnable Data Rate (Mbps) MCS6 MCS7 ./gs2k_rftest wlan0 wframetxtest 1 0 50000 1000 11 16 00:11:22:33:44:55 00:50:c2:5e:10:99 0 0 0 0 0 4 0 2 0 1 NOTE: Check the wireless sniffer to see if the frames on air.
  • Page 42 GS2K Wi-Fi Network Interface Card (NIC) User Guide Example: ./gs2k_rftest wlan0 wrxteststart ./gs2k_rftest wlan0 wrxtest 6 0 4294930106 00:1d:c9:17:8d:b1 0 ./gs2k_rftest wlan0 wrxstop No of packets recieved = 6988 No of byte recieved = 6988000 No of packets received with CRC Errors = 6933...
  • Page 43: C.1.8 Stop Asynchronous Frame Reception

    GS2K Wi-Fi Network Interface Card (NIC) User Guide From the Tx end, transmit frames with MAC address specified in Rx command. Use the following command: ./gs2k_rftest wlan0 wframetxtest 6 0 10000 1000 24 16 00:11:22:33:44:55 00:33:44:55:66:77 0 0 0 0 0 4 0 2 0 1 ./gs2k_rftest wlan0 wrxtest 1 0 0 00:11:22:33:44:55 0...
  • Page 44: Asynchronous Frame Transmission (Tx99 Mode)

    GS2K Wi-Fi Network Interface Card (NIC) User Guide No of packets received at 36M = 0 No of packets received at 48M = 0 No of packets received at 54M = 0 No of packets received atrespective MCS Index with Short GI=00000000...
  • Page 45 GS2K Wi-Fi Network Interface Card (NIC) User Guide Parameter Optional/Mandatory Value Description Note: For continuous transmission, configure this parameter with the value 99. The length of the payload. FrameLen Mandatory 32-1500 • Non HT Rates - 0 TxRate Mandatory 0 to 7 •...
  • Page 46 GS2K Wi-Fi Network Interface Card (NIC) User Guide Parameter Optional/Mandatory Value Description 0, 1 It allows to enable or disable Spreader Mandatory • 0 - Spreader is OFF Spreader. • 1 - Spreader is ON 0, 1 It allows to enable or disable...
  • Page 47 GS2K Wi-Fi Network Interface Card (NIC) User Guide 802.11g MCS0 MCS1 MCS2 MCS3 802.11n MCS4 MCS5 MCS6 MCS7 Example for Mode 802.11b To support data rate of 11 Mbps, configure the ModeSelect parameter to 1, TxRate parameter to 0, and PhyTestTxRate to 3.
  • Page 48 GS2K Wi-Fi Network Interface Card (NIC) User Guide The following table provides examples of Tx99 mode command for corresponding Data rates. Data Rate (Mbps) Example ./gs2k_rftest wlan0 wtx99test 1 0 99 1000 0 18 00:11:22:33:44:55 00:50:c2:5e:10:99 0 0 0 0 1 0 1 1 1 0 3 0 1 ./gs2k_rftest wlan0 wtx99test 1 0 99 1000 0 8...
  • Page 49: Asynchronous Frame Transmission (Tx100 Mode)

    GS2K Wi-Fi Network Interface Card (NIC) User Guide Data Rate (Mbps) Example ./gs2k_rftest wlan0 wtx99test 1 0 99 1000 1 27 00:11:22:33:44:55 00:50:c2:5e:10:99 0 0 0 0 0 0 0 0 0 MCS1 0 3 1 2 ./gs2k_rftest wlan0 wtx99test 1 0 99 1000 2 27...
  • Page 50 GS2K Wi-Fi Network Interface Card (NIC) User Guide Parameter Optional/Mandatory Value Description The value of this parameter can range from 0 to 27. Where 27 is the index TxPower Mandatory 0-27 corresponding to Maximum TxPower supported by GS node. Antenna...
  • Page 51 GS2K Wi-Fi Network Interface Card (NIC) User Guide MCS0 MCS1 MCS2 MCS3 MCS4 MCS5 MCS6 MCS7 ./gs2k_rftest wlan0 wtx100test=1 0 16 0 0 1 0 0 1 1 0 1 3 1 NOTE: To observe the signals, a special equipment may be required.
  • Page 52: Appendix D: Programming Setup - Gainspan Wab Board

    BOARD Following is the steps to prepare the test setup with GainSpan WAB: Step1: Plug GS2K WAB Board into SD card slot of the laptop. Step2: Plug the mini-USB cable, one end of the USB port to GS2101MIP WAB Board USB0 and the other end of the USB port to the laptop.
  • Page 53: Document History

    GS2K Wi-Fi Network Interface Card (NIC) User Guide DOCUMENT HISTORY Revision Date Changes 2018-01-29 First issue 2018-02-13 Updated Appendix B: Building and Installing Linux Kernel and Driver on NXP i MX6 Embedded Host 1VV0301491 Rev 2.0 Page 53 of 54...

Table of Contents