User Manual
Version 1.2.1
October 2016
Redpine Signals, Inc.
2107 N. First Street, #680
San Jose, CA 95131.
Tel: (408) 748-3385
Fax: (408) 705-2019
Email: info@redpinesignals.com
Website: www.redpinesignals.com
Redpine Signals, Inc. Proprietary and Confidential
User Manual
Version 1.2.1
About this Document
This document describes the usage of the MS32018 n-Link® Driver for testing
transmit & receive Performance for Wi-Fi protocols.
Disclaimer:
The information in this document pertains to information related to Redpine Signals,
Inc. products. This information is provided as a service to our customers, and may
be used for information purposes only.
Redpine assumes no liabilities or responsibilities for errors or omissions in this
document. This document may be changed at any time at Redpine’s sole discretion
without any prior notice to anyone. Redpine is not committed to updating this
document in the future.
Copyright © 2016 Redpine Signals, Inc. All rights reserved.
Redpine Signals, Inc. Proprietary and Confidential Page 2
User Manual
Version 1.2.1
Table Of Contents
1 Introduction .................................................................................................. 4
1.1 Getting Started .................................................................................................4
2 WLAN Performance Test Application Usage ................................... 6
2.1 Transmit Tests ..................................................................................................6
2.1.1 Transmit Command ......................................................................................................... 7
2.1.2 Transmit Command Description ................................................................................. 7
2.1.3 Examples ........................................................................................................................... 10
2.2 Receive Tests .................................................................................................. 11
2.2.1 Receive Command ......................................................................................................... 11
2.2.2 Receive Command Description ................................................................................. 11
2.2.3 Examples ........................................................................................................................... 12
3 FCC and IC Declaration ........................................................................... 13
4 Confirmation on Unlawful Usage of TX power with respect to
Certified Antennas .......................................................................................... 15
4.1 Commands to Program Antenna Type ................................................. 15
4.1.1 Command to Program Antenna Type for Wi-Fi ................................................... 15
4.2 Commands to Program Transmit Power ............................................. 16
4.2.1 Command to Program Transmit Power for Wi-Fi ............................................... 16
4.3 Maximum Transmit Power and Attenuation Values ....................... 17
4.3.1 Maximum Transmit Power and Attenuation Values for Antenova Antenna
18
4.4 Grant Note ........................................................................................................ 19
Table of Figures
No table of figures entries found.
Table of Tables
Table 1: Channel Numbers and Corresponding Center Frequencies .................... 9
Table 2: Rate Flags for Transmit Tests ................................................................................ 9
Table 3: Regulatory Domain Input in Transmit Tests ....... Error! Bookmark not defined.
Table 4: Channel Width Values ............................................................................................. 11
Table 8: List of Antennas Used for MS32018 FCC/IC Certification ..................... 15
Table 9: Command to Program Antenna Type for Wi-Fi ........................................... 16
Table 12: Command to Program Transmit Power for Wi-Fi .................................... 17
Table 15: Low, Mid and High Channel Frequencies for Wi-Fi ................................. 17
Table 16: Maximum Transmit Power and Attenuation Values for Redpine
signals Antenna ..................................................................................................................... 19
Redpine Signals, Inc. Proprietary and Confidential Page 3
1 Introduction
The software provided for the MS32018 n-Link® modules is named
OneBox-Mobile. The software currently supports performance testing for
Wi-Fi.
The subsequent sections explain the use of OneBox-Mobile software on
an x86 platform. Installation and operation of the driver on specific
representative processor platforms have been explained in the Appendix
sections.
1.1 Getting Started
1. Login to user “test” with password “test123”
2. Open a Terminal
3. Type command “su” and press enter key
4. Enter password “test123”
5. Connect EUT to Laptop with USB cable as shown below
User Manual
Version 1.2.1
Redpine Signals, Inc. Proprietary and Confidential Page 4
User Manual
Version 1.2.1
6. Please type “dmesg” on the terminal and press enter key and
check for the below print
7. Please go to directory /work/Regulatory_test/host/releases
8. Please read section 2 for performing WLAN Tests
Redpine Signals, Inc. Proprietary and Confidential Page 5
User Manual
Version 1.2.1
2 WLAN Performance Test Application Usage
The OneBox-Mobile software provides applications to test Transmit and
Receive performance of the module. The Band of operation of the module
needs to be configured before performing any tests.
NOTE: Open the common_insert.sh file present in the “release” folder
using an editor like vim. Ensure that the DRIVER_MODE is set as below:
DRIVER_MODE = 2
COEX_MODE = 1
Run the following command to install the Driver in Performance Test
mode:
# sh wlan_insert.sh
Please type “dmesg” in the terminal and press enter key and check for
the below print for check if driver has been loaded properly.
Next, follow the instructions below to run the Transmit and Receive tests.
2.1 Transmit Tests
The “transmit” utility, present in the “release” folder allows the
configuration of the following parameters and starts the transmission of
packets.
1) Transmit Power
2) Transmit Data Rate
3) Packet Length
4) Transmit Mode
5) Channel Number
Redpine Signals, Inc. Proprietary and Confidential Page 6
User Manual
Version 1.2.1
6) External PA Enable/Disable1
7) Rate Flags like Short GI, Greenfield, etc.
8) Enable/Disable Aggregation
9) Number of packets to be transmitted in Burst Mode
10) Delay between packets in Burst Mode
11) Regulatory Domain
2.1.1 Transmit Command
./transmit
<tpow><rate><len><mode><chan><expa><rf><aggr><num><delay
><reg>
2.1.2 Transmit Command Description
The command usage is explained below.
<tpow>: Transmit power in dBm for controlling transmit power. To set
the transmit power value, enter a value either between -7 and18.If a
value of 127 is entered, the packet will be transmitted at the maximum
power from the Transmit power table in the module.
<rate>: Transmit Data Rate. To set the transmit data rate, select a value
from 1, 2, 5.5, 11, 6, 9, 12, 18, 24, 36, 48, 54, mcs0, mcs1, mcs2,
mcs3, mcs4, mcs5, mcs6 and mcs7.
<len>: Transmit packet length in bytes. Enter a value between 24 and
1536 when aggregation is not enabled and between 24 and 30000 when
aggregation is enabled.
<mode>: Transmit mode. Enter 0 for Burst mode and 1 for Continuous
mode.
<chan>: Transmit channel number2. The following table maps the
channel numbers to the center frequencies for 20MHz and 40MHz
bandwidth modes in 2.4GHz and 5GHz band.
Band
(GHz)
Bandwidth
(MHz)
Channel
Number
Center Frequency (MHz)
2.4 20 1 2412
2.4 20 2 2417
2.4 20 3 2422
2.4 20 4 2427
1
This is not supported in the current release.
2
On-air testing in DFS channels should be avoided till the module is certified for DFS. Cabled tests can be
run in these channels.
Redpine Signals, Inc. Proprietary and Confidential Page 7
User Manual
Version 1.2.1
Band
(GHz)
2.4 20 5 2432
2.4 20 6 2437
2.4 20 7 2442
2.4 20 8 2447
2.4 20 9 2452
2.4 20 10 2457
2.4 20 11 2462
2.4 20 12 2467
2.4 20 13 2472
2.4 20 14 2484
5 20 36 5180
5 20 40 5200
Bandwidth
(MHz)
Channel
Number
Center Frequency (MHz)
5 20 44 5220
5 20 48 5240
5 20 52 5260
5 20 56 5280
5 20 60 5300
5 20 64 5320
5 20 100 5500
5 20 104 5520
5 20 108 5540
5 20 112 5560
5 20 116 5580
5 20 120 5600
5 20 124 5620
5 20 128 5640
5 20 132 5660
Redpine Signals, Inc. Proprietary and Confidential Page 8
User Manual
Version 1.2.1
Band
(GHz)
Bandwidth
(MHz)
Channel
Number
Center Frequency (MHz)
5 20 136 5680
5 20 140 5700
5 20 149 5745
5 20 153 5765
5 20 157 5785
5 20 161 5805
5 20 165 5825
Table 1: Channel Numbers and Corresponding Center Frequencies
<expa>: Enable/Disable External PA. This parameter is not supported in
the current release.
<rf>: Rate Flags. This parameter is used to enable/disable Short GI and
Greenfield and also to set the channel width of the transmitted packets.
The table below explains the flags that can be enabled and disabled.
Multiple flags can be set at a time.
Bit Description
0 Short GI
0 – Disable Short GI
1 – Enable Short GI
1 Greenfield transmission
0 – Disable Greenfield transmission
1 – Enable Greenfield transmission
[4:2] Operating bandwidth of the channel (3 bits)
0 – 20MHz
2 (Bit 3 is set) – NA
4 (Bit 4 is set) – NA
6 (Bits 3 and 4 are set) – NA
Table 2: Rate Flags for Transmit Tests
<aggr>: Enable/Disable Aggregation. Enter 0 to disable aggregation and
1 to enable aggregation. The packet length is divided into chunks of size
1792 bytes and aggregated. This parameter applies only to the Burst
mode transmission and is ignored in the case of Continuous mode of
transmission.
Redpine Signals, Inc. Proprietary and Confidential Page 9
User Manual
Version 1.2.1
<num>: Number of packets to be transmitted in Burst mode. The
transmission stops after the number of packets specified by this
parameter are transmitted in the Burst mode. If this value is 0, then the
transmission will not stop until the user gives the “./transmit 0” command
to stop the transmissions. This parameter is ignored in the case of
Continuous mode of transmission.
<delay>: Delay between packets in Burst mode. This parameter is used
to introduce a delay between any two packets. The delay has to be
specified in microseconds. If this value is 0, then the packets will be
transmitted without any delay. This parameter is ignored in the case of
Continuous mode of transmission.
<reg>: Regulatory Domain.
NOTE: After the transmission starts, the following commands need to be
given to stop the transmissions.
Burst Mode: ./transmit 0
Continuous Mode: ./transmit 0
2.1.3 Examples
#./transmit 2 54 1000 1 11 0 0 0 0 0 255
The above command starts continuous transmission with the following
configuration:
Transmit gain – 2dbm
Data rate – 54Mbps
Packet Length – 1000 bytes
Transmit mode – 1 (continuous mode).
Channel number – 11
External PA – disabled
Rate flags – 0
Aggregation – disabled (ignored in continuous mode)
Number of packets to be transmitted – 0(ignored in continuous mode)
Delay between the packets – 0(ignored in continuous mode)
Regulatory Domain is set to – World Domain
# ./transmit 12 36 1000 0 6 0 25 0 0 1000 0 0
The above command starts burst mode transmission with the following
configuration:
Transmit gain – 12dBm
Data rate – 36Mbps
Redpine Signals, Inc. Proprietary and Confidential Page 10
Packet Length – 1000 bytes
Transmit mode – 0 (Burst mode).
Channel number – 6
External PA – disabled
Rate flags – 25 (Short GI with Full 40MHz Channel width)
Aggregation – disabled
Number of packets to be transmitted – 1000
Delay between the packets – 0
Regulatory Domain is set to – World Domain
2.2 Receive Tests
The “receive” utility, present in the “release” folder, can be invoked for
displaying the following information
User Manual
Version 1.2.1
• Total number of CRC PASS packets
• Total number of CRC FAIL packets and
• Total number of FALSE CCAs
2.2.1 Receive Command
# ./receive <filename><channel_number><start/stop><channel_width>
2.2.2 Receive Command Description
<filename>: Name of the file into which the statistics will be logged, in
addition to being displayed on the console.
<channel_number>3: Channel number in which the statistics need to be
logged. Refer to the Table 1 in Section 2.1.2 for more details.
<start/stop>: Parameter to start or stop logging the statistics. Enter 0 to
start logging and 1 to stop logging.
<channel_width>: Operating bandwidth of the channel. Refer to the table
below.
Value Channel Width
0 20MHz
2 NA
4 NA
6 NA
Table 3: Channel Width Values
3
On-air testing in DFS channels should be avoided till the module is certified for DFS. Cabled tests can be
run in these channels.
Redpine Signals, Inc. Proprietary and Confidential Page 11
2.2.3 Examples
# ./receive stats 6 0 0
The above command starts the receive utility and logs statistics with the
following parameters.
Filename – stats
Channel number – 6
Channel Width – 20MHz
The test utility displays the following information:
• Total number of packets received with correct CRC.
• Total number of packets received with incorrect CRC.
• Total number of False CCA’s received.
# ./receive stats 6 1 0
User Manual
Version 1.2.1
The above command will stop the receive application
Redpine Signals, Inc. Proprietary and Confidential Page 12
User Manual
Version 1.2.1
3 FCC and IC Declaration
This device complies with Part 15 of the FCC Rules.
Operation is subject to the following two conditions:
(1) This device may not cause harmful interference, and
(2) This device must accept any interference received, including
interference that may cause undesired operation.
NOTE: This equipment has been tested and found to comply with the
limits for a Class B digital device, pursuant to part 15 of the FCC Rules.
These limits are designed to provide reasonable protection against
harmful interference when the equipment is operated in a commercial
environment. This equipment generates, uses, and can radiate radio
frequency energy and, if not installed and used in accordance with the
instruction manual, may cause harmful interference to radio
communications. Operation of this equipment in a residential area is
likely to cause harmful interference in which case the user will be
required to correct the interference at his own expense.
This Class B digital apparatus complies with Canadian ICES-003.
Cet appareil numérique de la classe A est conforme à la norme NMB-003
du Canada.
This device complies with Industry Canada license-exempt
RSSstandard(s).Operation is subject to the Following two conditions:(1)
This device may notcause interference, and(2) This device must accept
any interference, including interference that may cause undesired
operation of the device.
Le présent appareil est conforme aux CNR d'Industrie Canada applicables
aux appareils radio exempts de licence.
L'exploitation est autorisée aux deux conditions suivantes:(1) l'appareil
ne doit pas produire de brouillage, et (2) l'utilisateur de l'appareil doit
accepter tout brouillage radioélectrique subi, même si le brouillage est
susceptibled'en compromettre le fonctionnement.
CAUTION: Any changes or modifications not expressly approved by the
party responsible for compliance could void the user’s authority to
operate the equipment.
This equipment should be installed and operated with minimum distance
20 cm between the radiator & your body.
End Product Labeling
This Module is labeled with its own FCC ID. If the FCC ID Certification
Number is not visible while installed inside another device, then the
device should display the label on it referring the enclosed module. In
that case, the final end product must be labeled in a visible area with the
following:
Redpine Signals, Inc. Proprietary and Confidential Page 13
User Manual
Version 1.2.1
“Contains Transmitter Module FCC ID: XF6-MS32018”
OR
“Contains FCC ID: XF6-MS32018”
The OEM should not provide information to the end user regarding
installation or removal of this RF module or change RF related parameters
in the user manual of the end product.
The OEM integrator is still responsible for testing their end-product for
any additional compliance requirements required with this module
installed (for example, digital device emissions, PC peripheral
requirements, etc.).
énoncé de la FCC (états-Unis seulement) Cet équipement a été testé et
jugé conforme aux limites de Classe B pour un appareil numérique, en
vertu de l’article 15 de la réglementation de la FCC. Ces limites ont été
instaurées our fournir une rotection raisonnable contre toute interférence
nuisible dans une installation résidentielle. Cet équipement génère, utilise
et peut émettre de l’énergie radiofréquence. S’il n’est pas installé et
utilisé conformément aux instructions, il peut provoquer des interférences
sur les communications radio. Cependant, il n’est pas garanti que des
interférences ne se produiront pas dans certaines installations. Si cet
équipement cause des interférences à la reception radio ou télévisée (ce
qui peut être vérifi é en éteignant l’appareil puis en le remettant sous
tension),
l’utilisateur peut enter de ésoudre en suivant une ou plusieurs des
mesures ci-après :
Réorienter ou déplacer l’antenne réceptrice.
ugmenter l’espace entre l’appareil et le récepteur. Brancher l’appareil à
une prise de courant différente de celle sur laquelle le récepteur est
branché. Pour obtenir de l’aide, contacter le vendeur ou un technician
radio/television expérimenté.
REMARQUE: Toute modifi cation non autorisée expressément par le
fabricant responsable de la onformité peut annuler le droit de l’utilisateur
à faire fonctionner le produit.
This Module is labeled with its own IC ID. If the IC ID Certification
Number is not visible while installed inside another device, then the
device should display the label on it referring the enclosed module. In
that case, the final end product must be labeled in a visible area with the
following:
“Contains Transmitter Module IC ID: 8407A-MS32018”
OR
“Contains IC ID: 8407A-MS32018”
Redpine Signals, Inc. Proprietary and Confidential Page 14
User Manual
Version 1.2.1
4 Confirmation on Unlawful Usage of TX power with
respect to Certified Antennas
This is to confirm that Redpine Signals, Inc., will ensure that the following
information is included in the MS32018 (FCC ID: XF6-MS32018, IC ID:
8407A-MS32018) Module’s Programming Manual for customers who use
this module with different antennas to help them comply with the FCC/IC
regulatory requirements for products which use the module’s modular
approval.
The list of antennas with which the module has been tested with and
certified for FCC/IC are given in Table 1 below.
Antenna Make Model/Part # Antenna Gain at
2.4GHz (dBi)
Antenova CU5006-2
Table 4: List of Antennas Used for MS32018 FCC/IC Certification
The MS32018 Module’s Programming Reference Manual will include the
information listed below. The Manual is provided to customers as part of
the module’s collateral which also includes the module’s software and
firmware. The module’s firmware applies the attenuations required to
comply with the regulatory requirements based on the type of antenna
programmed. The commands required to program the transmit power
and the antenna type and the attenuations applied are given in the tables
that follow.
1) Commands to program the antenna being used for Wi-Fi – see Table
9.
2) Commands to set transmit power of the module for Wi-Fi– see Table
12.
3) Transmit power and attenuation values used during testing with
Antenova Antenna – see Tables 16.
2.36 5
Antenna Gain
at 5GHz (dBi)
Type of
Antenna
Internal mount
and Cable
connection
4.1 Commands to Program Antenna Type
4.1.1 Command to Program Antenna Type for Wi-Fi
Command Name Program Antenna Type for Wi-Fi
Description This command is used to program antenna
being used by the module for Wi-Fi out of
the list of certified antennas. This command
needs to be given before creating the VAP
in the normal mode and before the
“./transmit” command in the Wi-Fi
Redpine Signals, Inc. Proprietary and Confidential Page 15
User Manual
Version 1.2.1
Default Value 0
Input Parameters Base Interface (string like rpine0)
Output Parameter None
Reset Required No
Usage #
Performance Test mode.
Integer value mapped as follows:
3- Antenova Antenna
./onebox_util<base_interface>ant_type<a
ntenna_type>
Example The command below sets the Antenna type
to Fractus Antenna for Wi-Fi:
# ./onebox_util rpine0 ant_type 3
Table 5: Command to Program Antenna Type for Wi-Fi
4.2 Commands to Program Transmit Power
4.2.1 Command to Program Transmit Power for Wi-Fi
Description This command is used to program the
transmit power of the module for Wi-Fi. If
the value of transmit power exceeds the
maximum allowed power supported by the
channel specified by the regulatory domain,
then the minimum of the two values will be
used.
Default Value -
Input Parameters VAP Name (string like wifi0, wifi1, etc.)
Integer value in dBm
Output Parameter None
Reset Required No.
Usage #
iwconfig<vap_name>txpower<val_in_dBm
>
Example The command below sets the Wi-Fi
Redpine Signals, Inc. Proprietary and Confidential Page 16
User Manual
Version 1.2.1
Output Parameter None
Table 6: Command to Program Transmit Power for Wi-Fi
transmit power to 15dBm:
# iwconfig wifi0 txpower 15
4.3 Maximum Transmit Power and Attenuation Values
The transmit power and attenuation value settings in the following tables are mentioned
for IEEE 802.11a/b/g/n for the Low, Mid and High channel frequencies. The table below lists
the actual frequencies for each technology corresponding to the Low, Mid and High
columns in subsequent tables.
Technology Low
Channel
Frequency
(MHz)
802.11b 2412 2437 2462
802.11g 2412 2437 2462
802.11n 20MHz
Bandwidth
802.11a (5GHz
U-NII- 1)
802.11n 20MHz
Bandwidth(5GHz
U-NII- 1)
802.11a (5GHz
U-NII- 2)
802.11n 20MHz
Bandwidth(5GHz
U-NII- 2)
2412 2437 2462
5180 5200 5240
5180 5200 5240
5260 5500 5720
5260 5500 5720
Mid
Channel
Frequency
(MHz)
High
Channel
Frequency
(MHz)
802.11a (5GHz
U-NII- 3)
802.11n 20MHz
Bandwidth (UNII- 3)
Table 7: Low, Mid and High Channel Frequencies for Wi-Fi
Redpine Signals, Inc. Proprietary and Confidential Page 17
5745 5785 5825
5745 5785 5825
User Manual
Version 1.2.1
4.3.1 Maximum Transmit Power and Attenuation Values for Antenova
Antenna
Mode Data
Rate
(Mbps)
Max.
Tx
Power
(dBm)
802.11 b 1 16 3 16 3 16 3
11 16 3 16 3 16 3
802.11 g
802.11
n_20MHz
802.11a
(5GHz U-
NII-1)
6 11 3 18 3 10 3
24 11 3 18 3 10 3
54 11 3 18 3 10 3
MCS0 10 3 18 4 9
MCS4 10 3 18 4 9
MCS7 10 3 18 4 9
6 12 0 14 0 14 0
24 12 0 14 0 14 0
Low Mid High
Attenuation
Value
(dBm)
Power
(dBm)
Max.
Tx
Channels
Attenuation
Value
(dBm)
Max.
Tx
Power
(dBm)
Attenuation
Value
(dBm)
3
3
3
54 12 0 14 0 14 0
802.11n
20MHz
(5GHz U-
NII-1)
802.11a
(5GHz U-
NII-2)
802.11n
20MHz
(5GHz U-
NII-2)
802.11a 6 11 0 10 0 10 0
Redpine Signals, Inc. Proprietary and Confidential Page 18
MCS0 11 0 14 0 14 0
MCS4 11 0 14 0 14 0
MCS7 11 0 14 0 14 0
6 9 0 10
24 9 0 10
54 9 0 10
MCS0 8 0 9
MCS4 8 0 9
MCS7 8 0 9
0
0
0
0
0
0
7
7
7
5
5
5
0
0
0
0
0
0
User Manual
Version 1.2.1
(5GHz U-
NII-3)
802.11n
20MHz
(5GHz U-
NII-3)
Table 8: Maximum Transmit Power and Attenuation Values for Antenova
Antenna
24 11 0 10 0 10 0
54 11 0 10 0 10 0
MCS0 11 0 9 0 9 0
MCS4 11 0 9 0 9 0
MCS7 11 0 9 0 9 0
4.4 Grant Note
Only those antenna(s) tested with the device or similar type antenna(s) with equal or
lesser gain may be used with this transmitter.
The antenna of this transmitter must be installed to provide a separation distance of
at least 20 cm from all persons, and must not be co-located or operating in
conjunction with other antennas or transmitters within a host device, except in
accordance with FCC multi transmitter product procedures.
*****
Redpine Signals, Inc. Proprietary and Confidential Page 19
Loading...