Huawei Atool User manual

HUAWEI Module
Atool User Guide
Issue
02
Date
2015-01-31

Copyright © Huawei Technologies Co., Ltd. 2015. All rights reserved.
No part of this manual may be reproduced or transmitted in any form or by any means without prior written
consent of Huawei Technologies Co., Ltd. and its affiliates ("Huawei").
The product described in this manual may include copyrighted software of Huawei and possible licensors.
Customers shall not in any manner reproduce, distribute, modify, decompile, disassemble, decrypt, extract,
reverse engineer, lease, assign, or sublicense the said software, unless such restrictions are prohibited by
applicable laws or such actions are approved by respective copyright holders.
Trademarks and Permissions
, , and are trademarks or registered trademarks of Huawei Technologies Co., Ltd.
LTE is a trade mark of ETSI.
Other trademarks, product, service and company names mentioned may be the property of their respective
owners.
Notice
Some features of the product and its accessories described herein rely on the software installed, capacities
and settings of local network, and therefore may not be activated or may be limited by local network
operators or network service providers.
Thus, the descriptions herein may not exactly match the product or its accessories which you purchase.
Huawei reserves the right to change or modify any information or specifications contained in this manual
without prior notice and without any liability.
DISCLAIMER
ALL CONTENTS OF THIS MANUAL ARE PROVIDED “AS IS”. EXCEPT AS REQUIRED BY APPLICABLE
LAWS, NO WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE, ARE MADE IN RELATION TO THE ACCURACY, RELIABILITY OR CONTENTS OF THIS
MANUAL.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL HUAWEI BE
LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT, OR CONSEQUENTIAL DAMAGES, OR LOSS OF
PROFITS, BUSINESS, REVENUE, DATA, GOODWILL SAVINGS OR ANTICIPATED SAVINGS
REGARDLESS OF WHETHER SUCH LOSSES ARE FORSEEABLE OR NOT.
THE MAXIMUM LIABILITY (THIS LIMITATION SHALL NOT APPLY TO LIABILITY FOR PERSONAL
INJURY TO THE EXTENT APPLICABLE LAW PROHIBITS SUCH A LIMITATION) OF HUAWEI ARISING
FROM THE USE OF THE PRODUCT DESCRIBED IN THIS MANUAL SHALL BE LIMITED TO THE
AMOUNT PAID BY CUSTOMERS FOR THE PURCHASE OF THIS PRODUCT.
Import and Export Regulations
Customers shall comply with all applicable export or import laws and regulations and be responsible to
obtain all necessary governmental permits and licenses in order to export, re-export or import the product
mentioned in this manual including the software and technical data therein.
Privacy Policy
To better understand how we protect your personal information, please see the privacy policy at
http://consumer.huawei.com/privacy-policy.

HUAWEI Module Atool User Guide
About This Document
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
3
About This Document
Revision History
Document
Version
Date
Chapter
Descriptions
01
2012-02-29
Creation
02
2015-01-31
2
Updated operations to perform on the Atool
3
Updated limitations to use the Atool
5
Updated console commands and
parameters
6
Updated Error Messages
7
Updated saving of test results
8
Added FAQ

HUAWEI Module Atool User Guide
Contents
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
4
Contents
1 Purpose ...................................................................................................................................... 5
2 Overview ................................................................................................................................... 6
3 Limitations ................................................................................................................................ 7
4 Connection Diagram................................................................................................................ 8
5 Console Commands and Parameters ..................................................................................... 9
5.1 conf............................................................................................................................................. 9
5.2 imsi............................................................................................................................................10
5.3 imei............................................................................................................................................10
5.4 meid...........................................................................................................................................11
5.5 esn.............................................................................................................................................11
5.6 rssi.............................................................................................................................................12
5.7 sim.............................................................................................................................................15
5.8 uim.............................................................................................................................................16
5.9 simlock.......................................................................................................................................16
5.10 bodysar....................................................................................................................................17
5.11 gps...........................................................................................................................................17
5.12 iccid.........................................................................................................................................18
6 Error Messages........................................................................................................................ 19
7 Saving Test Results................................................................................................................ 20
7.1 Setting the Log Save Path..........................................................................................................20
7.2 Setting the Log Save Mode........................................................................................................20
8 FAQ .......................................................................................................................................... 21
8.1 Why Is theAtool Not Running?...................................................................................................21
8.2 Why Do Module's Ports Fail to Be Initialized or Read/Write Operations May Fail When theAtool Is
Running?.........................................................................................................................................21
9 Acronyms and Abbreviations............................................................................................... 22

HUAWEI Module Atool User Guide
Purpose
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
5
1 Purpose
This document describes how to use Huawei module Atool, including the purpose of
this guide, overview of Atool, commands and parameters of Atool, examples, and
precautions.
This document enables relevant technical engineers to understand the commands of
theAtool and use the Atool to test Huawei modules.

HUAWEI Module Atool User Guide
Overview
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
6
2 Overview
The Atool is used to test Huawei modules. The Atool can test the product's basic
information (including the product name, IMEI, IMSI, hardware version, and software
version), and antenna connectivity. The Atool can also save test results.
You can perform operations on the Atool using console commands only.
Atool is the tool set of Atool_x86 and Atool_arm. The Atool_x86 and Atool_arm apply
to the systems using x86 and arm architectures, respectively.

HUAWEI Module Atool User Guide
Limitations
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
7
3 Limitations
Applicable
products:
See Release Notes of the Atool.
Operating
systems:
See Release Notes of the Atool.
Driver
version:
See Release Notes of the Atool.
Other
requirement:
Set the Atool according to its instructions to ensure proper
running of the Atool.
The driver must be the standard driver provided by Huawei.
The Atool needs to create result files when it is running. To log in
to the Atool, you must get the root right.
When the Atool is running, do not power off or hibernate the
operating system or perform operations that interfere with the
Atool.
In command lines, do not place parameters in quotation marks (')
or double quotation marks (").
The paths where the Atool is running and the log is saved must
contain English characters only.

HUAWEI Module Atool User Guide
Connection Diagram
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
8
4 Connection Diagram
The instrument shown in the figure is the CMU200, which can be replaced with any other
instruments that can test modules' Radio Frequency (RF).
It is recommended that the laptop be placed in a shield box during the test to avoid external
signal interference.
The test scheme applies to near-field coupling tests on module's antenna connectivity.

HUAWEI Module Atool User Guide
Console Commands and Parameters
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
9
5 Console Commands and Parameters
Optional parameters are presented in [] and mandatory parameters are presented in <>.
Parameters are separated by only one space character.
Parameters are case-insensitive.
5.1 conf
Command
syntax:
atool conf [-fw firmware] [-hw hardware]
Command
function:
Tests and displays product's basic information, including the
product name, software version, hardware version, IMEI/MEID
and IMSI.
Parameter
description:
-fw: Configure this parameter to check the software version of
the tested product (default value: null).
-hw: Configure this parameter to check the hardware version
of the tested product (default value: null).
Example:
Other
examples:
atool conf –fw 11.350.99.04.00
atool conf –hw ML1ME936M

HUAWEI Module Atool User Guide
Console Commands and Parameters
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
10
atool conf –fw 11.350.99.04.00 –hw ML1ME936M
5.2 imsi
Command
syntax:
atool imsi
Command
function:
Tests and displays the SIM card's IMSI number.
Parameter
description:
No parameter.
Example:
5.3 imei
Command
syntax:
atool imei
Command
function:
Tests and displays the product's IMEI number.
Parameter
description:
No parameter.
Example:

HUAWEI Module Atool User Guide
Console Commands and Parameters
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
11
This command can be executed only in the LTE/UMTS/TD-SCDMAmodule.
5.4 meid
Command
syntax:
atool meid
Command
function:
Tests and displays the product's MEID number.
Parameter
description:
No parameter.
Example:
This command can be executed only in the CDMAmodule.
5.5 esn
Command
syntax:
atool esn
Command
function:
Tests and displays the product's ESN number.
Parameter
description:
No parameter.
Example:

HUAWEI Module Atool User Guide
Console Commands and Parameters
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
12
This command can be executed only in the CDMAmodule. You must specify either the ESN or
MEID for CDMA modules.
5.6 rssi
Command
syntax:
atool rssi <-m mode> <-f frequency> [-g gain] [-pt primary
target] [-at aux target] [-w window] [-rt overtime] [-tt test times]
[-div]
Command
function:
Tests the RSSI value and checks whether the antenna is properly
installed.
Parameter
description:
-m: This parameter sets the band to be tested by the Atool. Table
5-1 lists the recommended frequency settings. For other
frequency setting details, see 3GPP specifications.
-f: This parameter sets the reference frequency (unit: MHz). See
Table 5-1 for details.
-g: This parameter sets the Low-Noise Amplifier (LNA) level for
the product. The default value is 1. The detailed parameter
configuration is shown in Table 5-2 . The recommended test
power range is from –70 dBm to –20 dBm. If the power is out of
this range, the Atool detects no power.
-pt: This parameter sets the target value for the main RSSI test
(unit: dBm). This parameter must work with parameter -w. If -pt is
not configured, the Atool does not check the target value. (default
value: null)
-at: This parameter sets the target value for the diversity RSSI
test (unit: dBm). This parameter must work with parameter -w. If -
at is not configured, the Atool does not check the target value.
(default value: null)
-w: This parameter sets the limit test of RSSI (unit: dB). This
parameter must work with parameter -pt and -at. If -pt and -at are
not configured, the Atool does not check the target value. (default
value: null)
-div: This parameter sets the test for antenna diversity. If -div is
not added in the command, the Atool does not take the test for
antenna diversity.
-rt: This parameter sets the timeout duration for RSSI value
reading and must be a positive integer. The unit is s. (default
value: 5)
-tt: This parameter sets the number of times for RSSI value
reading and is used for figuring out the average RSSI value.
(default value: 1)

HUAWEI Module Atool User Guide
Console Commands and Parameters
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
13
Example:
Other
examples:
Test the main RSSI of LTE_Band1: The target power is –55 dBm,
and the test threshold is –55 dBm±20 dBm.
atool rssi -m 21 -f 1950 -g 1 -pt -55 -w 40
Test the main and diversity RSSI of WCDMA2100: The target
power is –55 dBm, and the test threshold is –55 dBm±20 dBm.
atool rssi -m 13 -f 2140 -g 1 -pt -55 -at -55 -w 40 -div
Test the main RSSI of CDMA800: The target power is –55 dBm,
and the test threshold is –55 dBm±20 dBm.
atool rssi -m 2 -f 881 -g 1 -pt -55 -w 40
Test the RSSIs of the bands above at the same time:
atool rssi -m 21 -f 1950 -g 1 -pt -55 -w 40 rssi -m 13 -f 2140 -g
1 -pt -55 -at -55 -w 40 –div rssi -m 2 -f 881 -g 1 -pt -55 -w 40
The power level indicated by the LNA parameter varies with products and is used as a
reference only.
RSSI tests may not be performed in airplane mode.
The frequency at which the instrument sets modulation signals must be the same as the
parameter specified by the module.
Only downlink frequencies are supported to be set.
If the -w parameter is not set, the Atool displays the signal strength but does not determine
whether the signal strength is within the threshold.
If the -pt or -at parameter has been set, set the -w parameter. If the -w parameter has been
set, set the -pt or -at parameter.
Only the unit or delimiter character can follow parameter values.
Table 5-1 Huawei module test bands and recommended frequencies
Standard
m
Band
Reference Frequency (MHz)
CDMA
2
CDMA800
881.5
3
CDMA1900
1960
5
CDMA2100
2141.9
GSM
9
GSM900
947.4
10
DCS1800
1842.6
11
PCS1900
1960
12
GSM850
882
UMTS
13
WCDMA2100
2140

HUAWEI Module Atool User Guide
Console Commands and Parameters
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
14
Standard
m
Band
Reference Frequency (MHz)
14
WCDMA1900
1960
15
WCDMA850
880
16
WCDMA800
880
17
WCDMA900
942.6
18
WCDMA1700
1862.4
19
AWS1700
2140
20
WCDMA_BAND19
877.5
LTE
21
LTE_B1
2140
22
LTE_B2
1960
23
LTE_B3
1842.5
24
LTE_B4
2132.5
25
LTE_B5
881.5
26
LTE_B7
2655
27
LTE_B8
942.5
28
LTE_B11
1485.9
29
LTE_B13
751
30
LTE_B17
740
31
LTE_B18
867.5
32
LTE_B19
882.5
33
LTE_B20
806
34
LTE_B21
1503.4
35
LTE_B25
1962.5
36
LTE_B26
876.5
56
LTE_B38
2595
57
LTE_B39
1900
58
LTE_B40
2350
59
LTE_B41
2593
TD-SCDMA
65
Band A
2016.2
70
Band F
1897.6

HUAWEI Module Atool User Guide
Console Commands and Parameters
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
15
Table 5-2 LNAlevels and power ranges
Standard
g
LNA level
Power ranges
WCDMA
0
LNA low gain level
–106 dBm to –70 dBm
1
LNA low gain level
–70 dBm to –44 dBm
2
LNA middle gain level
–44 dBm to –34 dBm
3
LNA high gain level
–34 dBm to –21 dBm
LTE
0
LNA low gain level
–109 dBm to -60 dBm
1
LNA low gain level
–60 dBm to –45 dBm
2
LNA middle gain level
–45 dBm to –27 dBm
3
LNA high gain level
–27 dBm to –10 dBm
CDMA
0
LNA low gain level
–115 dBm to –75 dBm
1
LNA low gain level
–75 dBm to –35 dBm
2
LNA middle gain level
–35 dBm to –23 dBm
3
LNA high gain level
–23 dBm to –13 dBm
GSM
0
LNA low gain level
–110 dBm to –95 dBm
1
LNA low gain level
–95 dBm to –75 dBm
2
LNA middle gain level
–75 dBm to –54 dBm
3
LNA high gain level
–54 dBm to –11 dBm
TD-SCDMA
0
LNA low gain level
–110 dBm to –90 dBm
1
LNA low gain level
–90 dBm to –75 dBm
2
LNA middle gain level
–75 dBm to –50 dBm
3
LNA high gain level
–50 dBm to –11 dBm
5.7 sim
Command
syntax:
atool sim
Command
function:
Tests and displays whether the SIM card has connected to the
module.
Parameter
description:
No parameter.
Example:

HUAWEI Module Atool User Guide
Console Commands and Parameters
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
16
This command can be executed only in the LTE/UMTS/TD-SCDMAmodule.
5.8 uim
Command
syntax:
atool uim
Command
function:
Tests and displays whether the UIM card has connected to the
module.
Parameter
description:
No parameter
Example:
This command can be executed only in the CDMAmodule.
5.9 simlock
Command
syntax:
atool simlock
Command
function:
Tests and displays the simlock status of the module.
Parameter
description:
No parameter.
Example:

HUAWEI Module Atool User Guide
Console Commands and Parameters
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
17
This command can be executed only in the LTE/UMTS/TD-SCDMAmodule.
5.10 bodysar
Command
syntax:
atool bodysar
Command
function:
Tests and displays the bodysar status of the module as well as the
bodysar settings of each communications standard supported by
the module.
Parameter
description:
No parameter.
Example:
5.11 gps
Command
syntax:
atool gps [-t CN0 target]
Command
function:
Tests whether the GPS antenna is properly installed based on the
highest carrier-to-noise ratio (CNR), namely, CN0.
Parameter
description:
-t: This parameter sets the CNR threshold, which must be a positive
integer. If this parameter is set, the Atool compares the obtained
CNR with the specified CNR. If the obtained CNR is lower than the
specified CNR, an error is reported.

HUAWEI Module Atool User Guide
Console Commands and Parameters
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
18
Example:
GPS signal input is required during the test. You are advised to use a GPS analog signal
source for the test.
5.12 iccid
Command
syntax:
atool iccid
Command
function:
Tests and displays the SIM card's ICCID number.
Parameter
description:
No parameter.
Example:

HUAWEI Module Atool User Guide
Error Messages
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
19
6 Error Messages
Error Message
Description
Error Code 1
Both main and auxiliary RSSI values do not meet threshold
conditions
Error Code 2
Main RSSI values do not meet threshold conditions
Error Code 3
Auxiliary RSSI values do not meet threshold conditions
Error Code 4
No response, time out
Error Code 5
Invalid parameters or parameters missing

HUAWEI Module Atool User Guide
Saving Test Results
Issue 02 (2015-01-31)
Huawei Proprietary and Confidential
Copyright © Huawei Technologies Co., Ltd.
20
7 Saving Test Results
7.1 Setting the Log Save Path
On the Windows command line interface, use the -p command to set the test results
save path:
atool rssi -m 19 -f 1950 -g 1 -pt -55 -w 100 -p /home/test/hw_log.txt
The /home/test/hw_log.txt parameter value that follows -p must contain the
absolute path that ends with the file name extension.
If the parameter is not configured, the test results will be saved to the pass. txt or fail.
txt file in the installation directory of the Atool by default, depending on the test
results.
7.2 Setting the Log Save Mode
On the Windows command line interface, run -ow.
This command indicates that the write mode is overwrite. If there is no parameter -ow,
the write mode is add.
Exapmle:
atool conf -p /home/test/hw_log.txt –ow
atool rssi -m 19 -f 1950 -g 1 -pt -55 -w 30 -ow