axesstelpst manual
TRANSCRIPT
AXESSTEL Software User's Guide Contents
AX CDMA Technology
ESSTEL PST Software User's Guide Restricted Distribution: This document
contains critical information about AXESSTEL
products and may not be distributed to anyone
that is not an employee of AXESSTEL without
the approval of Configuration Management.
AXESSTEL Incorporated San Diego, U.S.A.
AXESSTEL Proprietary 1
AXESSTEL Software User's Guide Contents
Axesstel, Inc.6305 Lusk Blvd.
San Diego, CA 92121 U.S.A
1 (858) 625-2100 phone
1 (858) 625-2110 fax
Copyright © 2000 AXESSTEL Incorporated. All rights reserved.
Printed in the United States of America.
All data and information contained in or disclosed by this document is confidential and
proprietary information of AXESSTEL Incorporated, and all rights therein are expressly reserved.
By accepting this material the recipient agrees that this material and the information contained
therein is held in confidence and in trust and will not be used, copied, reproduced in whole or in
part, nor its contents revealed in any manner to others without the express written permission of
AXESSTEL Incorporated.
Export of this technology may be controlled by the United States Government. Diversion
contrary to U.S. law prohibited.
Restricted Distribution:
This document contains critical information about AXESSTEL products and may not be
distributed to anyone that is not an employee of AXESSTEL without the approval of
Configuration Management. AXESSTEL is a registered trademark and registered service mark of AXESSTEL Incorporated.
Other product and brand names may be trademarks or registered trademarks of their respective
owners.
Information in this document is preliminary and subject to change and does not represent a
commitment on the part of AXESSTEL Incorporated.
AXESSTEL CDMA Technologies
PST Software User's Guide
July 14, 2003
AXESSTEL Proprietary 2
AXESSTEL Software User's Guide Contents
Contents
1 Introduction........................................................................................ 1 1.1 Purpose ................................................................................................................1-1 1.2 Scope and intended audience...............................................................................1-2 1.3 Revision history.....................................................................................................1-3 1.4 Reference documents...........................................................................................1-4 1.5 Technical assistance.............................................................................................1-5 2 Installation.......................................................................................... 2 2.1 Required hardware and software .........................................................................2-1 2.2 Installing PST........................................................................................................2-2 2.3 Physical connectivity.............................................................................................2-3 3 Communication Parameters ............................................................ 3 4 Display and Function Overview.........................................................4 4.1 Status....................................................................................................................4-1 4.2 Download..............................................................................................................4-2 4.3 Nv edit ..................................................................................................................4-3 4.4 Nv Script................................................................................................................4-4 4.5 Lcd simulator.........................................................................................................4-5 4.6 Prl download…………………….............................................................................4-6 4.6.2 Prl Edit ……………………………………………………………………………….4-6-2 4.7 Dm logging …………….........................................................................................4-7 4.8 Cai msg..……………….........................................................................................4-8 4.9 Setup………………...............................................................................................4-9 4.10 Pst Frame Overview….......................................................................................4-10 5 Troubleshooting................................................................................. 5
Appendix NV Scripts command.............................................................................A SCAN_CONFIG Parameters..................................................................B Sample Script Files................................................................................C
AXESSTEL Proprietary 3
AXESSTEL Software User's Guide Contents
1 Introduction 1.1 Purpose
PST (AXESSTEL Extensible Diagnostic Monitor) provides a diagnostic client for DMSS software. Its interface is based on the Mobile Diagnostic Monitor (MDM) and the CDMA Air Interface Tester (CAIT). It was developed to provide a rapid prototyping platform for new diagnostic clients and diagnostic protocol packets
PST provides a graphical user interface that displays data retrieved from DMSS Also It Can download data to DMSS.
1.2 Scope and intended audience
This user guide is intended for users of PST who need to know how to install, use, and understand information provided by PST. Many features in PST are documented elsewhere. The following is an overview of what is covered by this guide:
_ Installation
_ Physical connectivity
_ Communication parameters
_ Overview of PST screens _ Description of using PST
1.3 Revision history
The revision history for this document is provided in the below Revision history
AxessPst Rev. – JULY 14 2003 Initial release Ver. 0.1 The following is an overview of what is covered by this guide Phone status Download Nv item edit Prl Download and Edit Lcd simulator Dm log
AXESSTEL Proprietary 4
AXESSTEL Software User's Guide Contents
1.4 Reference documents
Reference documents are listed in the following table
Reference documents 1 CDMA DMSS Serial Data Interface Control Document 80-V1294-1 X5 Dec 2000 2. Qualcomm QXDM user guide 3. Qualcomm QPST user guide 4. Qualcomm CAIT user guide
1.5 Technical assistance
For assistance or clarification on information in this guide, email AXESSTEL CDMA Technologies at [email protected]
AXESSTEL Proprietary 5
AXESSTEL Software User's Guide Contents
2 Installation 2.1 Required hardware and software
PST is designed to be installed and run on a workstation running at Windows 95 , Windows 98 , Windows 2000 series, Windows XP series NOTE An OS higher than Microsoft Windows 95 is required to run Axesstel PST. PST installer program required which enables PST to run for a specified period of time
2.2 Physical connectivity
Connect a phone to a COM port on your PC using a serial cable as depicted in the Figure 2-2.
You need following accessories: - PC running PST - Axesstel Wireless Phone - UART COM Port - COM Port - RS-232 Cable provided by Axesstel.
AXESSTEL Proprietary 6
AXESSTEL Software User's Guide Contents
2.3 Installing PST
The PST software is provided either over the network or on CD-ROM, setup files alone.
This installer installs the User Release of PST, which includes the PST client components.
The following procedure explains the User Release Installer only.
To install PST, run this file
1. From the Windows desktop, select START RUN Setup.exe
2. Click OK to confirm your choice and to run the executable file
3. By default, PST will be installed to this location on your machine:
Figure 2-3-1 Installer introduction
AXESSTEL Proprietary 7
AXESSTEL Software User's Guide Contents
Figure 2-3-2 Choosing Setup Type
Choose Install Folder , By Default c:\Program Files\Axesstel\PST The installer will allow you to change the installation directory to one of your choice. The installer creates a PST folder in your START menu. PST can be run from your START menu by selecting START ->Programs-> AxesstelPST -> AxessPST.exe
AXESSTEL Proprietary 8
AXESSTEL Software User's Guide Contents
Figure 2-3-3 Selecting Destination Folder
AXESSTEL Proprietary 9
AXESSTEL Software User's Guide Contents
3 Communication Setup PST communication parameters should be configured for proper communication between the phone and the PC. The Communications dialog allows you to configure the COM port that will be used by PST, as well as the Model of Phone. Click Tool >> Setup 1. Select COM port number to be used. 2. Select Model Name
Axesstel Product Model Name WLL products A2 Mobile phones E2 Hybrid products W2
Figure 3–1 Configure COM port & Product Model
AXESSTEL Proprietary 10
AXESSTEL Software User's Guide Contents
4 Display and Function Overview The AxesstelPST based on Multi document is composed of 7 components. Click Tool to see the components. Status Download Nv edit Lcd simulator Prl edit Dm log Setup
4.1 Status Status window shows the current status of DMSS Note: The modification of the status value is not allowed You can only get current value of DMSS (Below: Figure 4–1 PST status window)
AXESSTEL Proprietary 11
AXESSTEL Software User's Guide Contents
Figure 4–1 PST status window The fields and functions of the Status window are described in the following.
ESN Electronic Serial Number (ESN) of the test phone. Digital MIN Digital phone Mobile Identification Number (MIN). Analog MIN Analog phone Mobile Identification Number (MIN). Channel Number of the CDMA channel. SID System Identification Number. NID Network Identification Number
AXESSTEL Proprietary 12
AXESSTEL Software User's Guide Contents
Code channel Number of the CDMA code channel, range from 1 to 63.
Pilot PN offset The PN offset number
Protocol revision The highest protocol revision which the base station is capable. This value appears at the end of a call, and is one of the following: _ J_STD008
_ IS-95 in Cellular Band
_ IS-95A + TSB74
_ IS-95B Partial
_ IS-95B Full
_ IS-2000 Release 0
_ IS-2000 Release A
Mobile P_REV The highest protocol revision of which the DMSS software is capable, which is one of the
following:
_ J_STD008
_ IS-95 in Cellular Band
_ IS-95A + TSB74
_ IS-95B Partial
_ IS-95B Full
_ IS-2000 Release 0
_ IS-2000 Release A
P_REV in use The protocol currently in use between the base and mobile stations, which is one of the following: _ J_STD008
_ IS-95 in Cellular Band
_ IS-95A + TSB74
_ IS-95B Partial
AXESSTEL Proprietary 13
AXESSTEL Software User's Guide Contents
_ IS-95B Full
_ IS-2000 Release 0
_ IS-2000 Release A
SO in use Slot cycle index Frequency that the test phone checks the paging channel for data. SCM Station class mark (SCM) specifies the test phone hardware transmit (Tx) and receive (Rx) capabilities. Compiled date Date the test phone firmware was compiled, displayed in month, day, and year format. Compiled time Time of day the test phone firmware was compiled, indicated in hours, minutes, and seconds. Released date Date the test phone firmware was approved for release, indicated in the month, day, and year format. Released time Time of day the test phone firmware was approved for release, displayed in hours, minutes, and seconds. Phone time Current time of the test phone RF Mode Operating mode of phone under test. Mode types: CDMA, Analog, or PCS.
AXESSTEL Proprietary 14
AXESSTEL Software User's Guide Contents
Phone State CDMA state of phone under test, such as CDMA Idle, CDMA Conversation, etc.
CDMA rx state RX State of the test phone. Aquire or Not available Entry reason CDMA frame crc RSSI Current analog RSSI measurement
Output power The signal’s Ec/Io power level (from 0 to –25 dB) Locaid Analog location area identification number. Analog word sync Analog good frames Analog bad frames MSM Demod ID MSM Chip ID HW major version HW minor version Firmware version
AXESSTEL Proprietary 15
AXESSTEL Software User's Guide Contents
Version directory Model code Model number of the test phone For example, A2, W2, E2
COM port Serial port in use COM port state State of Serial Port that used by PST If serial port is active, this field displays data speed. If not, this field displays “Port not opened”
4.2 Download Software Download is used to: _ Download software to a phone from a Axesstel Phone Image (.HEX) file _ Download software to a phone from a Axesstel Phone Image (.BIN) file
_ Backup and Recover User Data
To start Download, Select menu -> window-> Download.
The first window, as shown in Figure 4–2, appears.
AXESSTEL Proprietary 16
AXESSTEL Software User's Guide Contents
Figure 4–2 PST Download window 4.2.1 Downloading a file The Software Download application let you select a phone connected to your PC, select a file to download into the phone, and monitor the status of your download session in the lower portion of the window
The application can download new code to any Axesstel phone
4.2.2 Selecting a file to download Click Find button located in Download windows next , choose the Phone Image in the Phone Image dialog Use this dialog to locate the file to download
4.2.3 Starting the download To start the download:
1. Click Start. You will see the progress of the download in the lower portion of the PST
AXESSTEL Proprietary 17
AXESSTEL Software User's Guide Contents
Software, Download window 2. Download is stating 3. when download is end, download window display “download is end successfully” 4. Total time to end nomally is 3’ 45
4.2.4 Saving and restoring NV memory Items in a phone’s NV memory are backuped automatically during the download process If the User Data Backup/Restore check box is checked. You can also save and restore them manually. The USER DATA tabs let you select files for backing up or restoring phone settings.
Figure 4–1-4 Backup & Restore
4.2.5 Backing up NV items
AXESSTEL Proprietary 18
AXESSTEL Software User's Guide Contents
To back up a phone’s NV memory:
1. Click the Read from phone Button in the USER DATA tab
2. select the target file to save nvitems from the resulting You will see the progress of the bakup process in the lower portion of the dialog.
4.2.6 Restoring NV items To restore a phone’s NV memory from a backup (usr) file:
1. Click User Data File Button to access the restored file
2. select the target file restored nvitems 3. Click Start. You will see the progress of the restore process in the lower portion of the dialog.
4.3 Nv Edit This screen allows you to read and write NV items. When you click on an NV item, it will display the names within the item in right window And Click the Read button to read the current value of the selected NV item int right window After modifying the values, click the Write button to write the updated values back to the phone.
AXESSTEL Proprietary 19
AXESSTEL Software User's Guide Contents
Figure 4–3 Nv edit window The NV Edit can read and write nv item in the DMSS The NV Edit Support to next items * Electronic Serial Number. ESN Electronic Serial Number ESN_CHKSUM Electronic Serial Number checksum VERNO_MAJ NV Major version number VERNO_MIN NV Minor version number * Permanent physical station configuration parameters. SCM SCMp SLOT_CYCLE_INDEX Slot cycle index MOB_CAI_REV Mobile CAI revision number MOB_FIRM_REV Mobile firmware revision number MOB_MODEL Mobile model CONFIG_CHKSUM Checksum of physical configuration parameters * Permanent general NAM items. Each of these is associated with a * particular NAM (there are up to four NAMs per unit). The NAM id is * specified in the request. Certain analog parameters are truly * associated with the MIN, but since there is only one MIN per NAM * in analog mode they are defined as a NAM item. PREF_MODE DigitalAnalog mode preference CDMA_PREF_SERV CDMA preferred serving system (AB) ANALOG_PREF_SERV Analog preferred serving system (AB) CDMA_SID_LOCK CDMA SID(s) to lockout CDMA_SID_ACQ CDMA SID to acquire ANALOG_SID_LOCK ANALOG SID(s) to lockout ANALOG_SID_ACQ ANALOG SID to acquire ANALOG_FIRSTCHP Analog FIRSTCHPp ANALOG_HOME_SID Analog HOME_SIDp
AXESSTEL Proprietary 20
AXESSTEL Software User's Guide Contents
ANALOG_REG Analog registration setting PCDMACH Primary CDMA channel SCDMACH Secondary CDMA channel PPCNCH Primary PCN channel SPCNCH Secondary PCN channel NAM_CHKSUM NAM checksum * Authentication NAM items. Each of these is associated with a NAM * authentication (there are up to four NAMs per unit). The NAM id is * specified in the request. A_KEY Authentication A key A_KEY_CHKSUM Authentication A key checksum SSD_A SSD_Asp SSD_A_CHKSUM SSD_Asp checksum SSD_B SSD_Bsp SSD_B_CHKSUM SSD_Bsp checksum COUNT COUNTsp * MIN items. Each of these is associated with a particular MIN within * the NAM (there are up to 2 MINs per NAM). The MIN id itself is * specified in the request. When operating in analog mode the first MIN * is the one and only meaningfull one. MIN1 MIN1p MIN2 MIN2p MOB_TERM_HOME CDMA MOB_TERM_HOMEp registration flag MOB_TERM_FOR_SID CDMA MOB_TERM_FOR_SIDp registration flag MOB_TERM_FOR_NID CDMA MOB_TERM_FOR_NIDp registration flag ACCOLC ACCOLCp SID_NID CDMA SIDNID pairs MIN_CHKSUM MIN checksum * Operational NAM settings.
AXESSTEL Proprietary 21
AXESSTEL Software User's Guide Contents
CURR_NAM Current NAM ORIG_MIN Call origination MIN within NAM AUTO_NAM Select NAM automatically on roaming NAME_NAM A user selectable name for each NAM * Semi-permanent analog registration parameters. NXTREG Holds the registration count per CAI section 2.3.4.1. LSTSID SIDsp (last SID registered) LOCAID LOCAIDsp PUREG PUREGsp * Semi-permanent CDMA registration and channel parameters. ZONE_LIST ZONE_LISTsp SID_NID_LIST SID_NID_LISTsp DIST_REG Distance registration variables LAST_CDMACH Last CDMA channel acquired * Timers, each associated with a specific NAM. CALL_TIMER Last call time AIR_TIMER Air time (resettable cummulative call timer) ROAM_TIMER Roam time (resettable cummulative roam timer) LIFE_TIMER Life time (non-resettable cumm. call timer) * Run timer, independent of NAM. RUN_TIMER Run timer (time hardware has been running) * Memory (speed) dial numbers. DIAL Speed dial number STACK Call stack number STACK_IDX Call stack last number index
AXESSTEL Proprietary 22
AXESSTEL Software User's Guide Contents
REDIAL * Telephone pages (obsolete). PAGE_SET OBSOLETE Page setting PAGE_MSG OBSOLETE Page message and time * Volumes. EAR_LEVEL Handset ear piece volume level SPEAKER_LEVEL Handsfree speaker volume level RINGER_LEVEL Ringer volume level BEEP_LEVEL Key beep volume level * Tones. CALL_BEEP One minute call beeper select CONT_KEY_DTMF Continuous keypad DTMF tones select CONT_STR_DTMF Continuous string (memory) DTMF tones select SVC_AREA_ALERT Service area enterexit alert select CALL_FADE_ALERT Call fade alert select * Various phone settings. BANNER Idle banner to display LCD Display brightness setting AUTO_POWER Auto power settings (power savings) AUTO_ANSWER Auto answer setting AUTO_REDIAL Auto redial setting AUTO_HYPHEN Auto hyphen setting BACK_LIGHT Backlighting manualauto mode AUTO_MUTE Auto radio mute setting * Locks and restrictions values. MAINTRSN Base station maintance required reason
AXESSTEL Proprietary 23
AXESSTEL Software User's Guide Contents
LCKRSN_P Base station lock reason, until power cycled LOCK Indicator of whether user locked the phone LOCK_CODE Lock code string AUTO_LOCK Auto lock setting CALL_RSTRC Call restrictions SEC_CODE Security code HORN_ALERT Horn alert setting * Error log. ERR_LOG Error log * Miscellaneous items. UNIT_ID Unit hardware id (obsolete) FREQ_ADJ Frequency adjust values (obsolete) * V Battery MinMax. (Portable Only Item) VBATT V battery regulator array for minmax * Audio Adjustment values VOC_GAIN * Spare items (2) for developer SPARE_1 SPARE_2 * Data Services items DATA_IO_MODE External port (IO) mode for Data svc DATA_MODE_ENABLED Data Service(Task) EnabledDisabled DATA_MODE_ENABLED IDLE_DATA_TIMEOUT Data service idle time in seconds
AXESSTEL Proprietary 24
AXESSTEL Software User's Guide Contents
* Initial Muting Modes INI_MUTE * Factory free format test buffer FACTORY_INFO * DM address item (for multi-drop HDLC) DM_ADDR CDMA_PN_MASK SEND_TIMEOUT ----------------------------------------------------------------------------- POWER_CYCLES ALERTS_LVL ALERTS_LVL_SHADOW RINGER_LVL_SHADOW BEEP_LVL_SHADOW EAR_LVL_SHADOW TIME_SHOW MESSAGE_ALERT message alert type AIR_CNT ROAM_CNT LIFE_CNT DWNR_UP_CNT SEND_PIN AUTO_ANSWER_SHADOW AUTO_REDIAL_SHADOW SMS IMSI_11_12 IMSI_T_11_12
AXESSTEL Proprietary 25
AXESSTEL Software User's Guide Contents
IMSI_MCC IMSI_T_MCC DIR_NUMBER DIR_NUMBER_PCS VOICE_PRIV FSC ----------------------------------------------------------------------------- * MSM2P and beyond NV items. (continued) N1M ALARMS STANDING_ALARM DIALING_PLAN ISD_STD_PASSWD ISD_STD_RESTRICT FSC2 FSC2_CHKSUM WDC HW_CONFIG * TMSI NAM parameters and extensions. IMSI OBSOLETE InternationaMobileStationID IMSI_ADDR_NUM Length of IMSI IMSI_T_ADDR_NUM TMSI_ZONE_LENs-p ASSIGNING_TMSI_ZONE_LEN TMSI_ZONEs-p ASSIGNING_TMSI_ZONE TMSI_CODEs-p TMSI_CODE TMSI expiration time TMSI_EXP Subscriber's home block HOME_PCS_FREQ_BLOCK Directory number, PCS format * Roaming List and MRU Table. ROAMING_LIST The roaming list
AXESSTEL Proprietary 26
AXESSTEL Software User's Guide Contents
MRU_TABLE Most recently used channels MRU2_TABLE NOTE: This item is obsolete LIFE_TIMER_G CALL_TIMER_G OTKSL One-time keypad subsidy lock TIMED_PREF_MODE To allow analog-only operation RINGER_TYPE Ringer type setting ANY_KEY_ANSWER Answer call with any key BACK_LIGHT_HFK Hands Free Kit backlight setting RESTRICT_GLOBAL Global phone book restriction KEY_SOUND Type of keypress sound emitted DIALS_SORTING_METHOD Phone book sorting method LANGUAGE_SELECTION Language for user interface MENU_FORMAT Type of user interface menus RINGER_SPKR_LVL External speaker ringer volume BEEP_SPKR_LVL External speaker key beep volume VIBRATOR Use vibrator instead of ringer FLIP_ANSWERS Opening clamshell answers call DIAL_RESTRICT_LVLS ISS2 dialing restriction levels DIAL_STATE_TABLE_LEN Number elements in state table DIAL_STATE_TABLE ISS2 dialing plan state table VOICE_PRIV_ALERT Voice privacy alert for TGP DATA_QNC_ENABLED QNC enabled flag DATA_SO_SET Which Service Option set is in effect UP_LINK_INFO IP addresses and key data UP_KEY UP_PARMS Current gateway, alert state, etc. UP_CACHE The Unwired Planet cache ELAPSED_TIME Timer for formal test use PDM2 For RF Cal use VBATT_AUX Auxillary VBATT min-max DTACO_CONTROL DTACO enableddisabled control DTACO_INTERDIGIT_TIMEOUT DTACO interdigit timeout PDM1 For RF Cal use BELL_MODEM Flag for ISS2 SID_NID_LOCK CDMA SID(s) and NID(s) to lockout
AXESSTEL Proprietary 27
AXESSTEL Software User's Guide Contents
PRL_ENABLED If the roaming list is enabled or not SYSTEM_PREF System Preference, per NAM HOME_SID_NID "Home" SIDNID list OTAPA_ENABLED Whether OTAPA is enabled, per NAM NAM_LOCK SPASM protection per NAM IMSI_T_S1 True IMSI - MIN1 IMSI_T_S2 True IMSI - MIN2 UP_ALERTS Unwired Planet alert records UP_IDLE_TIMER Idle time timer SMS_UTC Specifies format of SMS time display ROAM_RINGER Specifies roam ringer on or off RENTAL_TIMER The rental timer item RENTAL_TIMER_INC The rental timer increment value RENTAL_CNT The rental counter RENTAL_TIMER_ENABLED Enablesdisables the rental timer FULL_SYSTEM_PREF Controls system pref display options BORSCHT_RINGER_FREQ Ringer freq used for BORSCHT port (RJ-11) PAYPHONE_ENABLE Enabledisable payphone support DSP_ANSWER_DET_ENABLE Enabledisable dsp answer detection EVRC_PRI EVRC13K priority: EVRC first, 13K first AFAX_CLASS_20 Obsolete item V52_CONTROL V52 control option CARRIER_INFO Bitmap and ASCII name info for carrier AFAX Analog FAX type: end to end or class 2.0 SIO_PWRDWN Distinguishes oldnew UART hardware PREF_VOICE_SO EVRC voice service options SMS_AUTO_DELETE SMS auto-deletion enabled status SRDA_ENABLED Silent redial enabled status OUTPUT_UI_KEYS Enable-disable sending UI keystrokes POL_REV_TIMEOUT Timeout for polarity reversal SI_TEST_DATA_1 First stack-checker diagnostic buffer SI_TEST_DATA_2 Second stack-checker diagnostic buffer SPC_CHANGE_ENABLED Enable-disable OTASP SPC change DATA_MDR_MODE DATA_PKT_ORIG_STR Dial string for originating packet calls DATA_AUTO_PACKET_DETECTION Packet data configuration item
AXESSTEL Proprietary 28
AXESSTEL Software User's Guide Contents
ROAM_MSG Downloadable roaming messages SMS_REMINDER_TONE Reminder tone is on or off PAP_USER_ID User_ID for Password Auth. Protocol PAP_PASSWORD Actual password for PAP SMS_BC_SERVICE_TABLE_SIZE SMS_BC_SERVICE_TABLE SMS_BC_CONFIG SMS_BC_USER_PREF PREF_FOR_RC IS2000 CAI radio configuration RC preference DS_DEFAULT_BAUD DATA SERVICES default SIO baud rate PRIMARY_DNS Contains the IP Address of the DNS Server SECONDARY_DNS Contains the IP Address of the Secondary DNS Server DATA_SCRM_ENABLED Enablesdisables the mobile's ability to SCRM DATA_TRTL_ENABLED In IS2000, if mobile should self-throttle R-SCH ------------------------------------------------------------------------------------------------------------------------------ *Axesstel Item for Only W2 Model SHORTCUT_ONE SHORTCUT_TWO SHORTCUT_THR SHORTCUT_FOR SHORTCUT_FIV SHORTCUT_SIX SHORTCUT_SEV SHORTCUT_EIG SHORTCUT_NIN SHORTCUT_TEN VOICEMAIL_NUMBER GPS1_LOCK TOLL_FREE_LIST LONG_DISTANCE INTERNATIONAL
AXESSTEL Proprietary 29
AXESSTEL Software User's Guide Contents
PAY_PER_USE
4.4 Nv Scripting
4.4.1 Overview PST contains a scripting language that allows you to extend its functions for special-purpose testing. Script commands allow you to send single or multiple commands to a test phone from PST. You can either enter and send commands manually or have them sent from a prepared script file. Some script commands direct packets to the test phone, while others affect only PST operations. When data packets are sent to the test phone, response packets are returned to PST containing data or acknowledgment (ACK) messages. These responses are displayed on the Scripting window and can be logged to a file.
4.4.2 Scripting window You can view or run scripts displayed on the Scripting window. This window contains two areas where you can enter commands, control script execution, and view output after running ascript.
Figure 4-4-2-1 Script window
AXESSTEL Proprietary 30
AXESSTEL Software User's Guide Contents
Figure 4–6-2-2 Changed LCD simulator after executing command
In the View menu, click Script to open the window. The fields and functions available in the Scripting window are defined in the following table. Run Run On: If you click Run Button , The the entire script you picked automatically execute without stopping (no user control) Scripting The Script Command line can execute or run a single command, a group of commands, or an entire script file. Commands from a script file appear in the edit section of the window under Script File Info. The output of an executed script command or file appears in the Command Results section. Color codes help you distinguish between different types of output. Green represents executed commands typed in the Script Command line. Blue represents variables and messages produced by the script.
AXESSTEL Proprietary 31
AXESSTEL Software User's Guide Contents
Red indicates an error condition or warning. To resize the edit and output sections of the window, grab and pull on the frame edges with the cursor.
4.3.3 Using scripts Script commands and files are processed and executed by a built-in interpreter. This utility does not support basic features such as looping, decision-making, or array processes or functions. Scripts are executed line-by-line, in strict sequence without any pointers, jumps, or branches. All script commands must be in the standard format described in Appendix A Script command list . You should be familiar with the script commands Single Step Selects automatic execution of entire script without stopping (no direct user control) Item Description There are three different ways to run scripts using the procedures in this section Run a single script command from the window like Figure 4–6-2-1
1. In the Script Command line, type the script command. 2. Press Enter to run the command. 3. Check the Command Results section to view any output.
AXESSTEL Proprietary 32
AXESSTEL Software User's Guide Contents
Figure 4–6-2-1 Typing of the single command
Figure 4–6-2-2 Changed LCD simulator after executing command
Run a script file from the window: 1. Click Run Button 2 If the Dialog box search script file, select a script file(*.scr) When you select a right file, The Scrips window execute script file automatically The result from scripts file are flowing in Figure
AXESSTEL Proprietary 33
AXESSTEL Software User's Guide Contents
Figure 4–6-2-3 Message after scripts was executed
4.4.4 Script command conventions To run properly, every script command described in Appendix A must be typed in the exact format described there. Where commands appear in upper case, they are keywords and must be typed as shown (although lowercase is allowed). Numeric values used in scripting are always integers, never float types. Hexadecimal representation of integers is allowed, and normally indicated by the 0x prefix. There is one exception to the rule regarding hexadecimal integers requiring the 0x prefix: when Scripting an address is specified in seg:off format. The segment (seg) and offset (off) values are in hexadecimal form, for example, 1234:ABCD. Strings are enclosed in double quotes, for example, “string”. There is no way to include a double-quote character inside of a string, for example, “string “another” string”. Where a command allows a variable number of arguments, such as the nv_write command, the variable part is enclosed in {var} braces. In script files, the semicolon ( ; ) introduces a comment line. All text on a line after the semicolon is ignored. A line that starts with a semicolon is ignored completely. Lines in script files can be up to 512 characters long, but lines entered directly on the Script Command line may be only 71 characters long.
AXESSTEL Proprietary 34
AXESSTEL Software User's Guide Contents
There are no looping commands in the PST script language. To execute a command repeatedly, you must insert the command into the script the desired number of times. A script file cannot run (execute) itself, and run commands are only allowed to be nested 5 deep.
Script commands list Appendix A, “Script Command List” on page 56 provides a complete list of the script commands for scripting read or write operations. For each command, there is a definition of its function, syntax form, and, in many cases, an example of its usage in a script.
AXESSTEL Proprietary 35
AXESSTEL Software User's Guide Contents
Figure 4–4-1 a example of nv script file ]
AXESSTEL Proprietary 36
AXESSTEL Software User's Guide Contents
4.5 Lcd simulator
4.5.1 Overview The lcd simulator Retrieves the current handset display screen from the phone. Returns the backlight and annunciator information as well as the
current appearance of the screen. (The phone display alternates
showing the screen size)
Figure 4–5 Lcd simulator window 4.5.1 LCD MODE The fields of the Combo box describe Lcd Size displayed int LCD window
Choose the right lcd size
4.5.2 KEY
AXESSTEL Proprietary 37
AXESSTEL Software User's Guide Contents
Sends a specified key press to the phone.
The keys value is describe in the next
Name Definition/Value
PF1 Soft-key #1 (left-most)
PF2 Soft-key #2 (right-most)
MSG Message waiting
# key POUND
* key STAR
0 key ZERO
1 key ONE
2 key TWO
3 key THREE
4 key FOUR
5 key FIVE
6 key SIX
7 key SEVEN
8 key EIGHT
9 key NINE
Send key SEND
End key END
CLR Clear key
STO Store key
UP Up-arrow key
DOWN Down-arrow key
MUTE Mute key
RCL Recall key
MENU Menu key
SELECT Select key
ALPHA Alpha key
PWR_ON Power key was actuated
PWR_OFF Power key was actuated
PWR Power key
INFO Info key
AXESSTEL Proprietary 38
AXESSTEL Software User's Guide Contents
FREE Phone placed in hands-free cradle
PHONE Phone lifted from hands-free cradle
REDIAL Redial key
PUSH_TO_TALK Push to Talk button
RELEASE Key to note that all keys are up
ON_HOOK Phone has gone on-hook
OFF_HOOK Phone has gone off-hook
RING_VOL_0 Ringer volume 0
RING_VOL_1 Ringer volume 1
RING_VOL_2 Ringer volume 2
EAR_UP Ear-piece up
EAR_UP_END Ear-piece up + end pressed
EAR_DOWN Ear-piece down
4.6 Prl
Overview The Prl is displays and Edit a phone’s roaming protocol information
Also You may use this tool to Download an existing roaming list file to the phone
If you have a existing prl file, you may go to the 4.5.2 prl download
AXESSTEL Proprietary 39
AXESSTEL Software User's Guide Contents
Figure 4–6-1 Prl window 4.6.1 Prl edit The Roaming List Editor displays a phone’s roaming protocol information.
You can use this tool to edit an existing roaming list file, create a new roaming list
To start Roaming List Editor, from the Start menu, Click the Edit PRL Button
4.6.1.1 Edit PRL Roaming List Editor opens in Edit mode. You can then view specific files using the Edit mode.
The Edit mode screen is divided into three areas
All entries and changes to a roaming list file must be made in Edit mode To Edit an existing roaming list file, Click the Open Button On the Constrast , To Create new file, Click the New Button After You did Edit all Information , you can save the data For saving the data, Click “Save” & “Save As” Button
AXESSTEL Proprietary 40
AXESSTEL Software User's Guide Contents
Figure 4–6-1 PRL Editor
4.6.1.2 System settings (roaming list type) Each of the two roaming list types has default settings, that can be edited in the system settings
region. Roaming List Editor accepts only permissible entries. Thus, a value of 1 can be entered in the field for Default Roaming Indicator while a value of ONE cannot.
These settings apply to the entire file. However, the system record table lets you assign different
default roaming indicators to individual records
4.6.2 Acquisition record table (acquisition types) The middle region of the Edit mode screen defines acquisition types. Use the acquisition record table to establish the priority the phone will follow in finding a channel when roaming.
AXESSTEL Proprietary 41
AXESSTEL Software User's Guide Contents
Create new rows in the table as needed to define settings for different acquisition types. The acquisition record table must contain at least one completely filled-in row of data for an acquisition type. Select the acquisition type for each row from the drop-down list in that field. Roaming List Editor defines options for the other fields depending on the acquisition type. For example, when Analog Cellular acquisition is selected, only one channel in that row is available to accept input.
Figure 4–6-2-1 Add a row to Aquistion table
AXESSTEL Proprietary 42
AXESSTEL Software User's Guide Contents
Figure 4–6-2-2 Selecting Acquisition Record Type
AXESSTEL Proprietary 43
AXESSTEL Software User's Guide Contents
Figure 4–6-2-3 Selecting a Number of Channnel
4.6.2.1 Acquisition Permissible entries
Roaming List Editor ensures that the entries and selections in each field of the acquisition record table
conform to predefined parameters. Table 4-6-2-1 describes the permissible values in acquisition records. Roaming List Editor ensures that the entries and selections in each field of the acquisition record table and system record table conform to predefined parameters. Acquisition records ACQ type Permissible values Analog Cellular Select A, B, or Both under Ch 1. CDMA Cellular (standard) Select A, B, or Both under Ch 1.
AXESSTEL Proprietary 44
AXESSTEL Software User's Guide Contents
Select Pri, Sec, or Both under Ch 2. CDMA Cellular (custom) IS-683A:
Enter at least one (up to 31) channel to search within the ranges 1013 to 1023, 1 to 311, 356 to 644, 689 to 694, or 739 to 777, inclusive. Note: This acquisition type does not apply to nonstandard.
Generic Cellular Select A, B, or Both under Ch 1. PCS (using blocks) Select at least one (up to six) block to
search, A, B, C, D, E, F, or Any to search any block. Do not mix channels and blocks in the same record.
PCS (using channels) IS-683A: Enter at least one (up to 31) channel to search within the range of 25 to 1175, inclusive. Nonstandard: Enter at least one (up to 25) channel to search within the range of 25 to 1175, inclusive.
Table 4-6-2-1 Permissible values in acquisition records 4.6.2.2 Record entry and edit
New Roaming List Editor files open with the first row, or record, of the acquisition record table,
Index 0, ready to be defined. Select the acquisition type from the drop-down list. Then specify the available channel(s) for that type as needed.
As indicated in the list of permissible entries, some channels may be left blank for some acquisition types.
AXESSTEL Proprietary 45
AXESSTEL Software User's Guide Contents
However, Roaming List Editor does not permit you to skip columns in this table.
If you skip a channel, or if you fail to select an acquisition type for a row, a warning is displayed when you attempt to save the file.
To add another acquisition record, Double -click in the firt colunm area in aquistion table and input value of row in num_acq_rec. Select an acquisition type for that record as before and continue specifying the
channels Editing records
To delete a record, double-click the first column in the selecting row and click Delete Record(s) from pop-up To insert a record, double-click in the first row and click Insert Record from pop-up
NOTE The Cut, Copy, and Delete commands apply to the record level, not to fields within a record, even if only one field appears to be selected. For deleting all record, click Clear Other fields in the records are not affected
4.6.3 System record table (system types)
The lower region of the Edit mode screen defines system types
Use the system record table to provide settings that will enable specified acquisition types to find a system.
The system record table must include at least one completely filled-in row of data corresponding to a record entry in the acquisition record table. Every system record must refer, by acquisition index number, to a record in the acquisition record table. However, not all acquisition records need corresponding system records.
Roaming List Editor defines permissible values for these data depending on the acquisition type. If you input an incorrect entry, a warning displays, giving the allowed range for that field. You cannot leave the field until you have corrected it.
You can use acquisition records more than once. You can also create a roaming list with as little as one acquisition record entry and one system record entry. You can also create a roaming list as large as the phone permits.
AXESSTEL Proprietary 46
AXESSTEL Software User's Guide Contents
4.6.3.1 System Permissible entries Roaming List Editor ensures that the entries and selections in each field of the system record table
conform to predefined parameters. Table 4-5-3-1 describes the permissible values in system records. System records Field Permissible values SID (System ID) Enter 1 to 32767, or 0 for any (wildcard)
System ID. NID (Network ID) Enter 0 to 65534, or 65535 for any
(wildcard) Network ID. Neg/Pref Select Neg for Negative, Pref for
Preferred. Geography Select New for the first record in a
geographical region. Select Same if the record is for the same region as the preceding record. Note: This field is automatically set to New in the first record and, like all gray fields, cannot be changed.
Priority Select Same or More priority than the next record.
Acq Index Enter the index number (left column) of the corresponding acquisition record entry. Note: The entered index number will be automatically updated if acquisition records are inserted or removed. However, Roaming List Editor does not check entered values until you save the file.
Roam Indicator IS-683A: Enter 0 to 255.
AXESSTEL Proprietary 47
AXESSTEL Software User's Guide Contents
Nonstandard: Select Off, On, or Flashing Note: This individual record setting enables you to override the Default Roaming Indicator setting shown for the roaming list type in the system settings region of the Edit mode screen.
Table 4-6-3-1 Permissible values in system records
Figure 4–6-3-1 Prl edit window
4.6.3.2 Record entry and edit
Editing records
To delete a record, double-click the first column in the selecting row and click Delete Record(s) from pop-up
AXESSTEL Proprietary 48
AXESSTEL Software User's Guide Contents
To insert a record, double-click in the first row and click Insert Record from pop-up
NOTE The Cut, Copy, and Delete commands apply to the record level, not to fields within a record, even if only one field appears to be selected. For deleting all record, click Clear Other fields in the records are not affected
Figure 4–6-3-2 Insert record into system table
4.6.4 prl download A prl file that is made out from prl edit is required to download prl. Click Download button below to download prl. If a prl file is not selected, click File button to open a prl file. Clicking Download button, prl is started to download with a message pop-up as
AXESSTEL Proprietary 49
AXESSTEL Software User's Guide Contents
shown in the following picture. Click ‘Yes(Y)’ to erase existing MRU information, ‘No(N)’ not to erase. If the download successfully completed, ‘prl download success’ would be shown in a pop-up message.
Figure 4–6-4 Prl Download Check the performance of RF mode and channel searching value in the status window to confirm the completion of prl.
AXESSTEL Proprietary 50
AXESSTEL Software User's Guide Contents
4.7 Dm logging
Overview AxesstelPst provides important features that let you log various types of data and messages. You can configure and access logging operations, level selections, and max logging line. This section covers the following features: _ Logging status _ Viewing log files _ Logging mask configuration _ Mobile message display and configuration
Figure 4–7 Dm logging window
4.7.1 Logging Status window The Logging Status window displays a summary of logging activities . The Logging Status window displays the event status, signaling, and diagnostic messages generated during operation of the mobile phone. These messages offer a valuable source of information about the performance and diagnostics of any axesstel ‘phone. Messages can be tracked in real-time or logged to a file for later analysis. The information contained in the log files can be analyzed to measure test phone performance or high-level traffic patterns in the
AXESSTEL Proprietary 51
AXESSTEL Software User's Guide Contents
network. DM log windows is composed the following Level: The Level is Message Level from the DMSS There is 5 kind of Message type H : High level message M; Medium level message L: Low level Message F: Fatal level Message E : Error level Message Time: The time that messages were generated, formatted as a 9-digit number in hours, minutes, seconds, and milliseconds, with hours displayed in 24-hour form. File: Name of the source code file where the message was generated. Line: Line number in source code file where the message was generated. Message: Plain text description of message.
4.7.2 Logging Mask dialog box You can control mobile message file format and logging functions with the Mobile Messages Configuration dialog box, including message logging operation, priority threshold To open this dialog box, press Config Button from the DM log window You can use the Logging Mask dialog box to specify which messages from the test phone are to be logged. These log mask settings allow more efficient use of the limited serial interface bandwidth used for
AXESSTEL Proprietary 52
AXESSTEL Software User's Guide Contents
logging. The log mask bits specify what data will accumulate in the logging queue of the test phone. The queued data is sent over the serial interface link to the computer, where it accumulates in a file in memory. Logging messages are written from memory to the hard disk every five seconds.
Figure 4–7-2 Configuration Dialog for Dm log
Logging and Messages By altering the log mask, you can limit the amount of data logged and the time required to log it. At times, high volumes of data can cause the logging queue of the test phone to overflow. This overflow can result in lost data packets, and missing information in the log file. The dialog box is typically used to configure the logging mask at the start of logging operations.
4.7.3 Control Logging flow “Start” & “stop” Button can control Logging flowing flow when button is displayed “Start”, It provide starting message flow In contrast, if button is displayed “Stop”, Dm log is writing the logging message in the window “Stop” button provide stoping message flow
4.7.4 Saving the message log
AXESSTEL Proprietary 53
AXESSTEL Software User's Guide Contents
The Messages can be tracked in real-time or logged to a file Clicking the Add to Log button, the DM log save the log in real-time to “msgsaved.log file” in the subdirectory named “LOG” The picture in Figure 4–6-3 Dm log file If you installed AxesstelPst in the c:\program\AxesstelPst, LOG directory is located in
c:\program\AxesstelPst\LOG And Clicking the Save button, the DM log Save the all log and message displayed in the message window to the date-time file Ex) 06080306.txt
Figure 4–7-4 Dm log file
4.8 CAI MSG Logging and Messages Overview CAI MSG provides more features than DM log Msg window You can configure and access logging operations, data selections, and file formats. This section covers the following features
AXESSTEL Proprietary 54
AXESSTEL Software User's Guide Contents
_ Logging status _ Annotating log files _ Viewing log files _ Logging mask configuration _ Mobile message display and configuration _ Layer III message display and configuration _ Conversion utilities (separate from CAIT) for parsing _ The Friendly Viewer utility provided for parsing and viewing log files.
Logging Status window The Logging Status window displays a summary of logging activities, including a summary of the current log file and those log files already closed. This information is useful for managing the format and size of the file, and types of data collected. In the View menu, click CAI MSG to open the window. The following table describes this window’s fields and functions.
Figure 4–9 CAI MSG Window
Item Description Current Log File File Name Name of the log file being written
AXESSTEL Proprietary 55
AXESSTEL Software User's Guide Contents
File Size Total number of data bytes stored in the file Duration Total time spent logging data into the file, indicated in seconds Log Files Summary Directory The directory where log files are currently being written. To change this directory, click the button at the right of this field and select a new directory from the resulting Select Directory dialog box. Log file filter This field lets you invoke one of CAI’s conversion utilities to be applied to each log file as it is closed. To add or change a command, click the button at the right of this field and, in the resulting Custom Trigger dialog box, type a new command, or select a previous one from the drop down list, then click OK. A Delete button is also provided in the Custom Trigger dialog box so you can delete commands from the list. Logging and Messages The status values appearing in the Logging Status window cannot be controlled from within the window. Log files can be named using CAI MSG’s default naming format or that of the Mobile Diagnostic Monitor program. You can change the type of file name format used in the Configure CAI MSG dialog box To remove a command from this field, click the button at the right of it, then drag to select the text in the Custom Trigger dialog box and press the Delete key. This way, your command will still be available in the drop down list on the Custom Trigger dialog box. # of Files Total number of files logged during current operating session Overall Size Total number of bytes for all files logged during the current operating session
(Table Headings) File # Identification number assigned to the file by CAI MSG File Name Name of the log file(s) written and closed. Right-clicking on this filename presents a pop-up menu with the option of opening the file for viewing.
AXESSTEL Proprietary 56
AXESSTEL Software User's Guide Contents
Start Time Time the file was created and data logging started End Time Time data logging stopped and the file was closed Duration(sec) Total number of seconds spent logging data to the file Size Total number of data bytes stored in the file Description In this column, you can type a description of any log file listed in the table. This description is stored in the header of the log file, and can be up to 79 characters in length. Close Log Control button that closes the current log file and begins writing a new file Export Control button that lets you save the current table of log file data to a comma-separated text file Clear Click this button to clear the list of files. Doing so does not delete the files from the logging directory. Item Description CAI MSG ’s default filename format consists of 11 alphanumeric characters arranged as follows: For example, m0214212.156 is a log file created on day 2 of the month at 2 PM, 21 minutes, 21 seconds for a test phone with a MIN ending in 56. After a log file is created and closed, it is listed in the Logging Status display. Each log file is saved in binary format, and must be viewed using CAI MSG ’s Open Log File feature.
Logging Status menu When the Logging Status window is displayed, the Logging Status menu provides you with options for handling the log files and the log file table in the Logging Status window. In the CAI MSG main window, click Logging Status to open the menu. The following table describes the functions of the Logging Status menu. m Letter ‘m’ indicates this is a log file. dd Day of the month, range 01 to 31. hh Hour of the day, range 00 to 23. mm Minutes in the hour, range 00 to 59. ss Seconds in the hour, range 00 to 59. ii Last two digits in the test phone’s mobile identification number (MIN).
AXESSTEL Proprietary 57
AXESSTEL Software User's Guide Contents
Item Description Close Log File Closes the current log file and begins logging to a new file. Export Log File Names Displays a directory dialog box that lets you save the current table of log file data to a comma-separated text file. Clear Log File Names Empties the contents of the log file table in the Logging Status window.
Annotating log files CAI MSG provides an annotation feature that lets you insert simple text markers in the current log file. By selecting Annotate Log File, you can access a menu of preset annotations to insert at the current point in the log file. Selecting one of these annotations from the menu inserts it at the current line in the log file. Or, if you want to use an annotation that is not in the list, choose Custom Annotation. The Custom Annotation dialog box appears, in which you can specify a new annotation. Item Description All annotations that you add in this dialog box are available in the drop-down list that appears when you click the arrow at the right of the text box. Then, click OK to choose the selected annotation, or click Delete to remove a custom annotation from the list.
Viewing log files To view log files you have recorded with CAI MSG , choose Open Log File. A directory dialog box appears in which you can locate the log file to open. When you select a file and click OK, a log file viewing window appears. This window consists of two panes. The upper pane contains a scrollable list of messages that are in the log file. When you select a message, its details appear in the lower pane. You can drag to select
AXESSTEL Proprietary 58
AXESSTEL Software User's Guide Contents
these details and copy them for pasting to another program.
Logging Mask dialog box You can use the Logging Mask dialog box to specify which messages from the test phone are to be logged. These log mask settings allow more efficient use of the limited serial interface bandwidth used for logging. The log mask bits specify what data will accumulate in the logging queue of the test phone. The queued data is sent over the serial interface link to the computer, where it accumulates in a file in memory. Logging messages are written from memory to the hard disk every five seconds. Logging and Messages
By altering the log mask, you can limit the amount of data logged and the time required to log it. At times, high volumes of data can cause the logging queue of the test phone to overflow. This overflow can result in lost data packets, and missing information in the log file. The dialog box is typically used to configure the logging mask at the start of logging operations. To to open this dialog box, click Logging Mask
The dialog box presents the available settings in an expandable tree, organized into categories by their function. Clicking on a plus sign (+) next to a category displays the subcategories or settings it contains. Click the check box for each configuration item you want to select. A check mark indicates the item is selected, whereas no check mark indicates the item is not selected. The Logging Mask dialog box also lets you set priorities for each message to be logged. To the right of each message type in the list there is a symbol specifying its priority: a green arrow for high priority, a yellow tilde (~) for medium priority, and a red arrow for low priority. The phone software employs a complex algorithm to apply logging priorities. The test phone has a 2048 byte output buffer, into which all log records are placed prior to being transmitted to the mobile station (MS). Normally, when a task is ready to queue a log record
AXESSTEL Proprietary 59
AXESSTEL Software User's Guide Contents
for output to the MS, it issues an allocation request that reserves exactly enough space for the type of log record to be transmitted. It then fills in the space that has been allocated, and eventually the log record is transmitted. If there was not enough space in the output buffer to satisfy the allocation request, the log record is “dropped” and never gets transmitted to the MS. The priority mechanism modifies this process by assigning each log code with a priority value, ranging from 0 to 2048. When a task is ready to queue a log record, it issues an allocation request for the size of the log record, plus (2048 – priority) bytes. This means that a log code with a priority of 2048 requests exactly enough bytes to hold the associated record, while an log code with a priority of 0 gets an allocation request for 2048 bytes plus the actual record size. The lower the priority value, the more space must be free in the output queue in order to allocate the log record. This should squelch the logging of records with low priority values when the output queue is fairly full. It is important to note that since the output buffer in most phones is 2048 bytes, priority codes of less than the size of the log packet will always cause the packet to be dropped. CAI MSG allows you to assign numeric values to represent Low, Medium, and High priorities, and then to set the priority of any log code to one of the three symbolic values in the log mask dialog. It also maps log priorities read from the phone to one of the three user-defined priorities. The mask bit values available in this dialog box are defined in the following table. Item Description Logging Mask Displays the hexadecimal value of the logging mask code. Signaling Messages Common IS95/IS2000 Channels Sync Channel When selected, logs all sync channel messages received. Paging Channel When selected, logs all paging channel signaling messages received.
AXESSTEL Proprietary 60
AXESSTEL Software User's Guide Contents
Access Channel When selected, records all access channel signaling messages sent. Logging and Messages Forward Traffic Channel When selected, records all forward traffic channel signaling messages received in the traffic channel. Reverse Traffic Channel When selected, logs all reverse traffic channel signaling messages sent in the traffic channel. IS2000 Channels Quick Paging Channel When selected, logs all quick paging channel signaling messages. Forward Channel/Multipath Info Temporal Analyzer Finger Info When selected, records all Temporal Analyzer finger PN offset and power level data. Note: This option is mutually exclusive with the General TA and General TA with Supplemental Channels options. Searcher Path log When selected, logs searcher results in a dense Fast Log Data packet. This packet is supported only by special test phones, such as the Retriever pilot scanner test phone. New Temporal Analyzer When selected, records Temporal Analyzer data (window size and position, pilot offset, signal power, etc.). Note: This option is mutually exclusive with the General TA and General TA with Supplemental Channels options.
AXESSTEL Proprietary 61
AXESSTEL Software User's Guide Contents
General TA When selected and if using a 5GP-series phone, logs Temporal Analyzer finger PN offset and power level data as well as searcher data (window size and position, pilot offset, signal power, etc.). Note: This option is mutually exclusive with the Temporal Analyzer Finger Info, TA Searcher, and MDR Gen TA Data options. General TA with Supplemental Channels When selected and if using a 5GP-series phone, logs Temporal Analyzer finger PN offset data, power level data, searcher data (window size and position, pilot offset, signal power, etc.), and a count of MDR supplemental channel data. Note: This option is mutually exclusive with the TA and Finger Data, TA Searcher, and Gen TA Data options. Searcher and Finger Info When selected, records all logs searcher results data as well as Temporal Analyzer finger PN offset and power level data. Item Description Receive/Transmit Power, Power Control Sparse AGC/TX/RX Power When selected, records all sparse AGC and closed loop power control messages. IS2000 Fast Forward Power Control When selected, records all IS2000 fast forward power control messages. IS2000 Reverse Power Control When selected, records all IS2000 reverse power
AXESSTEL Proprietary 62
AXESSTEL Software User's Guide Contents
control messages. Frame Type Logging Forward Link Markov Statistics When selected, records Markov rate and error data for all frames. IS2000 Dedicated Channels Frame Types When selected, records frame type information for dedicated IS2000 forward link frames. Reverse Link Access Probe When selected, logs all access probe data. IS2000 Dedicated Channels Frame Type When selected, records frame type information for dedicated IS2000 reverse link frames. Frame Content Logging Forward Link IS95 Forward Link Frames When selected, records frame content information for IS95 forward link frames. IS2000 RLP Forward Frames When selected, records frame content information for IS2000 RLP forward frames. Reverse Link IS95 Reverse Link Frames When selected, records frame content information for IS95 reverse link frames. IS2000 RLP Transmit Frames When selected, records frame content information for IS2000 RLP transmit frames.
AXESSTEL Proprietary 63
AXESSTEL Software User's Guide Contents
IS2000 Logging Service Configuration When selected, records service configuration information for IS2000-capable targets. Active Set Configuration When selected, records active set configuration information for IS2000-capable targets. Item Description Logging and Messages RLP Statistics When selected, records RLP statistics information for IS2000-capable targets. Test Data Service Option When selected, records test data service option information for IS2000-capable targets. Data Link Logging Async TCP/IP Segments When selected, records information on asynchronous TCP/IP segments. IP Data Packets When selected, records information on IP data packets. IS95 RLP Data Packets When selected, records information on IS95 RLP data packets. Vocoder Packets Vocoder Bit Rate Mask When selected, records vocoder bit rate mask information. Forward Link Vocoder Packets When selected, logs all vocoder rate and message data in forward channel of transmission link.
AXESSTEL Proprietary 64
AXESSTEL Software User's Guide Contents
Reverse Link Vocoder Packets When selected, logs all vocoder rate and message data in reverse channel of transmission link. AMPS Logging Forward Channel When selected, logs all forward channel signaling messages received for AMPS calls. Reverse Channel When selected, logs all reverse channel signaling messages received for AMPS calls. Analog Handoff When selected, logs all handoff messages received for AMPS calls. Slot Statistics When selected, logs all slot statistics received for AMPS calls. Word Sync Count When selected, logs all word sync messages received for AMPS calls. Voice Channel Information When selected, logs all voice channel information received for AMPS calls. Miscellaneous Debug Messages When selected, records all debugging messages generated by the test phone software. GPS Location When selected, records GPS position information, if available. Diagnostic Commands When selected, records diagnostic commands issued to the test phone during logging.
Mobile Messages window The Mobile Messages window displays the event status, signaling, and diagnostic messages generated during operation of the mobile phone. These messages offer a valuable source of information about the performance and diagnostics of the test phone. Messages can be tracked in real-time or logged to a file for later analysis. The information contained in the log files can be analyzed to measure
AXESSTEL Proprietary 65
AXESSTEL Software User's Guide Contents
test phone performance or high-level traffic patterns in the network. In the View menu, click Mobile Messages or press F3 to open the window. Logmask Change When selected, records changes to the logmask made during logging. Band Class Change When selected, records changes in channel or band class for multi-band test phones. Test Mobile Commands When selected, records test mobile commands. Embedded File System Information When selected, records changes to the test phone’s embedded file system. Event Reports When selected, records event reports from CAI MSG . Factory Test Mode When selected, records Factory Test Mode log packets. Data Statistics When selected, records statistics collected by the Data Statistics window. Obsolete Fujitsu Handset Information When selected, records Fujitsu handset information. AGC Values When selected, records AGC values. ETAK Position and Speed Information When selected, records GPS position and speed information in ETAK format. OK Saves the new log mask configuration and sends it to the test phone. Cancel Closes the dialog box without changing the log mask, discarding any changes that have been made. Item Description Logging and Messages The fields and functions of the message window are defined in the following table. Item Description
AXESSTEL Proprietary 66
AXESSTEL Software User's Guide Contents
(Message Headings) Time Stamp The time that messages were generated, formatted as a 9-digit number in hours, minutes, seconds, and milliseconds, with hours displayed in 24-hour form. File Name Name of the source code file where the message was generated. Line # Line number in source code file where the message was generated. Msg Lvl Priority level assigned to message, color coded for easy identification. Priority types: Red=HIGH, Green=MEDIUM, and Blue=LOW. Message Text Plain text description of message. (Status Bar—Window Bottom) Message Level Minimum priority assigned for display of messages. Any messages below this priority will not be displayed. Current Message Number of messages in the buffer being logged in the current (open) log file. The messages appearing in this window cannot be modified. You can also view these messages by saving a log file, then extracting the mobile messages you want to see using the conversion utilities
Mobile Messages menu The Mobile Messages menu allows you to select functions for controlling and configuring mobile message display and logging. You can use the cursor, control key, or hot key to select any command in the menu without actually opening the menu. This menu is accessible only when the Mobile Messages window is active. In the CAI MSG main window, click Mobile Messages to open the menu. The following table describes the items available from the Mobile Messages menu. Free Messages Number of free entries in a message buffer. These are used to store new messages when you have paused the display. Dropped Messages Number of messages dropped by the phone due to
AXESSTEL Proprietary 67
AXESSTEL Software User's Guide Contents
buffer overflow.
Mobile Messages Configuration dialog box You can control mobile message file format and logging functions with the Mobile Messages Configuration dialog box, including message logging operation, priority threshold, and data fields displayed. To open this dialog box, press C or choose Configuration from the Mobile Messages menu. The following table describes the fields and functions of the configuration dialog box. Item Description Paused On: Temporarily suspends logging of mobile messages. Off: Normal message logging. Message Level Selection control that assigns the minimum priority for display of messages. Any messages below this priority will not be displayed. View All On: Displays all mobile message fields in the window. Off: Displays set of currently selected mobile message fields. Select Fields to View Time Stamp On: Displays time stamp information for messages. Off: Does not display time stamp information for messages. File Name On: Displays file name information for messages. Off: Does not display file name information for messages. Logging and Messages Select the check box for each configuration item you want to activate. A check mark indicates the item is selected, whereas no check mark indicates that the item is not selected.
Layer III messages CAI MSG displays IS-95-A, IS-95-B, and IS-2000 Layer III messages in three separate windows:
AXESSTEL Proprietary 68
AXESSTEL Software User's Guide Contents
_ Log Message Summaries _ Log Message Inspector _ Log Message Monitor As listed here, these windows each display an increasing amount of Layer III message information, allowing you to monitor behavior of the test phone at a variable level of focus—as broad or narrow as your needs require. The Log Message Summaries window displays a continually-refreshing view of the most recent Layer III messages. The newest message is highlighted by a yellow bar to indicate the progress of the message list’s refreshing. This window has a resizable configuration pane on the left. In this pane, you select the type of messages you want to see by selecting check boxes in an expandable list of messages. As CAI MSG receives messages of the types selected, it populates the panel on the right To open the window, in the View menu, click Log Message Summaries. Line Number On: Displays line number for messages. Off: Does not display line number or messages. Message Level On: Enables message filtering according to minimum priority level. Priority types: Red=HIGH, Green=MEDIUM, and Blue=LOW. Off: No priority filtering. OK Control button that saves the mobile message configuration settings and closes the configuration dialog box. Item Description By double-clicking a message in the Log Message Summaries window, you can view the details of that message in the Log Message Inspector window. This window consists of two panes. The upper pane contains a scrollable list of messages that were in the message buffer when the window opened. The list may no longer be current, but it allows you to view the details of each message for further information, as well as copy message details to paste into another program. When you select a message, its details appear in the lower pane. Initially, this
AXESSTEL Proprietary 69
AXESSTEL Software User's Guide Contents
lower pane displays the details of the message you double-clicked in the Log Message Summaries window. This window can only be accessed by double-clicking a message in the Log Message Summaries window or the Log Message Monitor window. You can save all the messages listed in this window to a log file. From the Log Message Inspector menu, select either Save as Binary or Save as Text. A directory dialog box appears, so that you can name the file. By default, binary log files are saved with the extension “log,” while text log files are saved with the extension “txt.” Logging and Messages Note that the Log Message Inspector window is basically the same window as the one used to view log files To view Layer III message details in real time, use the Log Message Monitor window. This configurable window lets you select which Layer III messages you want to view in real time, and displays a single, detailed panel for each selected message type that is updated by every occurrence of that type of message. In the View menu, click Log Message Monitor to open the window. 94 Chapter 5: Logging and Messages AXESSTEL Proprietary Like the Log Message Summaries window, this window has a resizable configuration pane on the left. In this pane, you select the type of messages you want to monitor by selecting check boxes in an expandable list of messages. As CAI MSG receives messages of the types selected, it populates the panel on the right with individual panes that each show the most recent message of a given type. The scroll bar in the right panel lets you view all selected messages. Also, up
and down arrows in the lower right of an individual pane indicate
that there is additional message detail that you can view by clicking
the arrows to scroll within the pane or by dragging the lower border
of the pane downward. Double-clicking a message causes it to be
displayed in the Log Message Inspector window, unless it displays
the words “Out of cache” instead of an age value, which indicates
that it’s no longer available to be displayed in the Log Message
Inspector window.
AXESSTEL Proprietary 70
AXESSTEL Software User's Guide Contents
Two modes of parsing are available within the message text
displayed in this window. The default is verbose mode, which
shows all message information. For long messages, you may choose
to view a condensed version of the message by disabling the Parse
in Verbose option on the Log Message Monitor menu.
To make monitoring individual message types easier, you can open
multiple instances of the Log Message Monitor window and
configure them to each show a unique set of messages.
4.9 Setup Click Window->setup
4.9.1 Selecting comport select a comport using possible If you do not select a comport, pst chose enable comport automatically
4.9.2 selecting a phone To select a phone select the phone to which you want to download software By default, A2 is set
AXESSTEL Proprietary 71
AXESSTEL Software User's Guide Contents
Figure 4–9-1 Select Port dialog
4.10 Pst Environment Overview The composition of AxesstelPst is shown in the Figure 4-8-1 The AesstelPst basically supports multi document to perform various works at the same time. But, only ‘download‘ does not support Multi Working with other windows
AXESSTEL Proprietary 72
AXESSTEL Software User's Guide Contents
Figure 4–10 AxesstelPst
4.10.1 Pst Environment file The Environment of Axesstel pst is based on configuring file named “Defualt.cfg” This file have a lot of information about Pst and frame You can find Nv parameter in the middle of file If Nv parameter value is 1 , you can see the nv item in the Nv Edit If Nv parameter value is 0, this field is disappeared
4.10.2 selecting a window For window display, you can select window in the View tab
AXESSTEL Proprietary 73
AXESSTEL Software User's Guide Contents
Figure 4–10-2 View
5 Troubleshooting
This chapter shows several situations you might encounter while using AxesstelPST and solutions to try.
AXESSTEL Proprietary 74
AXESSTEL Software User's Guide Contents
1. When an error occurs while downloading, try once more If it does not help, contact to [email protected]. 2. When the power is not automatically switched on after downloading or prl editing
please check the wire is alive and push the ‘power’ button. 3. When the screen does not work properly
please adjust the LCD size. 4. When an error message -COMPORT connection failed- shows up after executing PST
please exit the program and re-execute PST. For problems not covered here, please send email to [email protected]
Appendix A Script Command List Overview This appendix contains a complete list of the script commands for
AXESSTEL Proprietary 75
AXESSTEL Software User's Guide Contents
read and write operations. Over 60 commands, functions, and processes are described in alphabetical order. For each command there is a definition of its function and syntax format, and in many cases an example of its usage in a script. Some commands do not have examples, since their usage is clear from their definitions.
Script commands AKEY Allows you to enter an authorization key number. This command is for Module targets only. Syntax akey “number” Example akey “15423” Response Enters the A-key number 15423.
APPEND_LOG Opens a script log in append mode so the new data is added to the file rather than a new file created. Syntax append_log filename.ext Example append_log mylogfile.txt Response New messages are added to the file without overwriting the existing content.
APR_LIST_WR Writes an abbreviated Preferred Roaming List (PRL) to any Axesstel phone using a shortcut write command. This allows specifying only channel numbers for the PRL list. All other entries default to wild cards. Syntax apr_lst_wr {nam, ch1, ch2...ch32} Example apr_lst_wr {0, 500, 250} Response The list containing the channel numbers is sent to the mobile phone.
APR_LIST_WR_683 Loads a standard-format abbreviated IS-683-A preferred roaming list. Syntax apr_list_wr_683 {nam, [cell], [pcs], channel_1, [channel_2, channel_3,...] [AMPS_A | AMPS_B]} The “cell” argument specifies cellular channels; “pcs” specifies PCS channels. Up to 32 channels can be specified per NAM. Example apr_list_wr_683 {0, cell, 777, pcs, 500, AMPS_B}
AXESSTEL Proprietary 76
AXESSTEL Software User's Guide Contents
Response Writes a PRL instructing NAM 1 to look for CDMA cellular service on channel 777, CDMA PCS service on channel 500, or B-side AMPS service. Script Command List AUDIO_CONTROL Allows control of various audio characteristics of the module. This command is for Module targets only. Syntax audio_control {audio_command_code, [arg_1,...arg_8]} The following table lists the possible values for audio_command_code and the arguments required or available for each code. Code Definition/Arguments 0 Set audio path and muting arg_1=audio path: 0=no path, 1=handset path, 2=external path arg_2=mute output path: 0=no, 1=yes arg_3=mute input path: 0=no, 1=yes 1 Set voice volume arg_1=volume level for handset: 0–7 arg_2=volume level for hands-free kit (HFK) speaker: 0–7 2 Set ringer volume arg_1=volume level for handset: 0–7 arg_2=volume level for hands-free kit (HFK) speaker: 0–7 3 DTMF start arg_1=tone possible values 4 DTMF stop (no arguments) 5 Tone start arg_1=tone definition possible values arg_2=duration (in milliseconds) arg_3=audio path: 0=no path, 1=handset path, 2=external path arg_4=sound class: 1=beep, 2=voice beep, 3=voice arg_5=volume for handset: 0–3 for beep or voice beep, 0–7 for voice arg_6=volume level for hands-free kit (HFK) speaker: 0–7 for beep or voice beep, 0–3 for voice arg_7=DTMF path: 0=play locally, 1=transmit, 2=play locally and transmit, 3=mute
AXESSTEL Proprietary 77
AXESSTEL Software User's Guide Contents
6 Tone stop (no arguments) Example audio_control {2, 5, 7} Response Sets the ringer volume at 5 for the handset and 7 for the hands-free kit speaker.
BEEP Makes an audio noise to alert the user. Syntax beep
CAIT_VERSION Returns the full version number for PST as listed in the About PST dialog box. Syntax cait_version
CALL_INFO Requests information about the call including caller ID string, service option, etc. This command is for Module targets only. Syntax call_info 7 Sound start arg_1=sound code possible values arg_2=audio path: 0=no path, 1=handset path, 2=external path arg_3=sound class: 1=beep, 2=voice beep, 3=voice arg_4=volume: 0–3 for beep or voice beep, 0–7 for voice arg_5=DTMF path: 0=play locally, 1=transmit, 2=play locally and transmit, 3=mute 8 Sound stop (no arguments) 9 Set key sound class arg_1=sound class: 1=beep, 2=voice beep, 3=voice Code Definition/Arguments Script Command List CARRIER (analog test command) Turns mobile phone carrier on or off. Syntax carrier on | off Example carrier on Response Mobile phone carrier turns on.
CDATA (analog test command) Specifies six bytes of data to transmit on the reverse control channel message.
AXESSTEL Proprietary 78
AXESSTEL Software User's Guide Contents
Syntax cdata byte1, byte2, byte3... (where byte is 1 byte) Example cdata 1 2 3 4 5 6 Response Data is transmitted in message on the reverse control channel.
CDMA_RSSI Requests the current CDMA RSSI value. This command is for Module targets only. Syntax cdma_rssi CLOSELOG Closes the currently open transcript file. If no transcript file is open, a message informing the user of that fact is displayed. Syntax closelog See also openlog append_log
CLS Clears the CAIT display screen. Syntax cls COMP (analog test command) Turns the compander (compressor/ expander) on or off. Syntax comp on | off Example comp on Response Turns the compander on.
CWAIT Halts scripting for a specified duration. Syntax cwait centiseconds Example cwait 300 Response Halts scripting for three seconds.
DATA_PARM_GET Requests statistics regarding a specific data protocol from CST phones like the QSec™-800. Available protocols are Radio Link Protocol (RLP), Point to Point Protocol (PPP), Internet Protocol (IP), Transport Control Protocol (TCP), User Datagram Protocol (UDP), Real Time Protocol (RTP), Compressed Real Time Protocol (CRTP). Specify ALL to return statistics for all supported protocols. Syntax data_parm_get RLP | PPP | IP | TCP | UDP | RTP | CRTP | ALL Example data_parm_get IP Response The command returns the following Internet Protocol statistics:
AXESSTEL Proprietary 79
AXESSTEL Software User's Guide Contents
Internet Protocol Statistics 5/20/99 16:26:47 *Datagrams received 14392 *Datagrams discarded due to errors 132 *Datagrams discarded due to protocol 59 *Datagrams delivered to IP user proto. 3443 *Datagrams requesting transmission 4337 Script Command List DIAL_CST Originates a call to the given number on CST phones like the QSec™-800. Syntax dial_cst V | A | P | M | L | C | S | N| CN | SN “dial_string_or_packet_url” V=voice, A=Async, P=packet, M=Markov, L=Loopback, C=Clear, S=Secure, N=No dial string, CN=clear number, SN=secure number Example dial_cst V S CN “5035550523” Response A secure voice call will be made to 503-555-0523. Because the dial string is a clear number, the CST will make a clear voice call and then do the necessary signalling to perform secure dialed number discovery.
DIAL Originates a call to the given number with the given service option. For the Axesstel phone, this is accomplished by simulating the key presses needed to originate the specified call type through the handset. Therefore, activity on the actual keypad, if not locked out, may interfere with this operation. Syntax dial “number_string” service_option The following table lists the possible values for service_option. Option Definition V Voice call (IS96A) V96 Voice call (IS96) V13 13K voice call V733 IS733 13 kbits/sec voice call LB 8 kbits/sec loopback call LB13 13 kbits/sec loopback call M Old style 8 kbits/sec Markov call M8 New style 8 kbits/sec Markov call
AXESSTEL Proprietary 80
AXESSTEL Software User's Guide Contents
M13 New style 13 kbits/sec Markov call EVRC EVRC call Example 1 dial “555-1212” V Response Originates voice call to 555-1212 (V=IS96A, V96=IS96). For the AXESSTEL phone, any of the “V” options will only originate a call in the default voice service option. The other phone targets will use the specified service option. Example 2 dial “ ” M Response Originates an old 8K Markov call. Notice that the string is empty, as a Markov call does not originate to any particular number, but the string must be there. The same syntax is used for loopback calls as well. If a number is given for the axesstel phone, that number is used in the “dialed-digits” field of the Markov origination. See also hs_lock
DIAL_END Ends the current phone call. For a axesstel phone, this is accomplished by simulating a press of the end key. Therefore, activity on the actual keypad, if not locked out, may interfere with this operation. Syntax dial_end Example dial_end Response Sends the command to end the call. See also hs_lock MDR1 MDR Fwd RS1 Rev RS1 call (IS-707A service option number 22) MDR2 MDR Fwd RS1 Rev RS2 call (IS-707A service option number 23) MDR3 MDR Fwd RS2 Rev RS1 call (IS-707A service option number 24) MDR4 MDR Fwd RS2 Rev RS2 call (IS-707A service option number 25) MDR5 MDR Data Pattern Test 1 call (proprietary service option) MDR6 MDR Data Pattern Test 2 call (proprietary service option) TDSO Full Test Data Service Option STDSO Simple Test Data Service Option (proprietary service option) Option Definition Script Command List DIPSW Sets the specified DIP switches to on (1) or off (0), where the value is 16 bit hexadecimal
AXESSTEL Proprietary 81
AXESSTEL Software User's Guide Contents
Syntax dipsw [value] Example dipsw 0xFFFF Response This turns on all of the DIP switches.
DP_READ Creates a dialing plan file for WLL phones by reading from the specified NAM. Syntax dp_read nam file_string Example dp_read 1 dialplan.bin Response The dialing plan for NAM 2 is written to a file named dialplan.bin.
DP_WRITE For WLL phones, loads a dialing plan, created by a dialing plan tool, to the specified NAM. Syntax dp_write nam file_string Example dp_write 1 dialplan.bin Response The dialing plan in a file named dialplan.bin is written to NAM 2.
DTMF (analog test command) Activates the DTMF generator with a digit, where digit is 1–9, 0,*,#, or off. Syntax dtmf [digit] Example dtmf 0
ERR_CLR Clears one or all of the errors in the NV memory. If item is 0xFF, it clears all errors, otherwise it clears that one entry. Syntax err_clr [item] Example err_clr 0xFF Response All errors in non-volatile (NV) memory are cleared. Note The only time this command might be used is at the beginning of a test run. It is suggested that at the end of the test run, the ERR_GET command may be used to retrieve any errors that occurred during the test run.
ERR_GET Reads all the errors in the NV memory and displays them. Syntax err_get Example err_get Response The total logged messages: 0002 The total ignored messages: 0041
FEATURE_QUERY
AXESSTEL Proprietary 82
AXESSTEL Software User's Guide Contents
Lists features supported by a mobile phone. Syntax feature_query Also supported as the following: _ feature_query_page _ fq_page Storage addr The err Filecode Line # 0 7A mc 1442 NF 1 FF rxc 3001 NF Script Command List GET_EXT_STATE Requests the module status from the extended state packet. This command is for Module targets only. Syntax get_ext_state GET_SCREEN Retrieves the current handset display screen from the phone. Returns the backlight and annunciator information as well as the current appearance of the screen. (The phone display alternates showing the screen and blink screen. It alternates between annunciator and blink annunciator, so if something is on one and not the other it will blink.) Syntax get_screen Example get_screen Response Backlight ON Screen: Axesstel Feb 13, Thu 6:16pm (special characters here) Annunciator: 0001 Blink Screen: Axesstel Feb 13, Thu 6:16pm (special characters here) Blink Annunciator: 0001 RSSI: 05
AXESSTEL Proprietary 83
AXESSTEL Software User's Guide Contents
Blink Rate: 0500 The special characters are mapped characters on the mobile phones. At this time, PST does not interpret them into anything readable.
GET_SMS Requests the most recent SMS message and provides options for deleting SMS messages. This command is for Module targets only. Syntax get_sms erase_code erase_code can be any of the following: Example get_sms 0 Response Retrieves the latest SMS message and does not delete any messages.
GPS_LAST_PKT As part of the GPS receiver configuration, this command is used to set the last packet in the burst from the GPS receiver. The packet name is given in quotation marks. This setting is only good while PST is running. The information is lost when you exit PST. Syntax gps_last_pkt “packet_name” Example gps_last_pkt “vtg” Response The vtg message is set as the last one in a burst. Code Definition/Value 0 Do not delete any SMS messages 1 Delete all SMS text messages 2 Delete the most recently accessed SMS text message 3 Delete the oldest accessed SMS text message 4 Delete all SMS voice messages 5 Delete the most recent SMS voice message 6 Delete the oldest SMS voice message 7 Delete all SMS messages Script Command List HELP Displays a brief description of the command syntax. If entered with no argument, all commands are listed with help text. If the topic option is used, an explanation of only that topic is displayed. Syntax help [topic] Example 1 help Response All commands with topic options are displayed. Example 2 help NV
AXESSTEL Proprietary 84
AXESSTEL Software User's Guide Contents
Response A complete list of NV items are displayed by name. For more specific help with NV items, type help nv_read or help nv_write in the Scripting window.
HL_PR_LIST_RD Allows the user to read the Preferred Roaming List (PRL) into a file. The NAM parameter indicates which NAM the PRL should be read from. The filename parameter must be given in quotation marks and names the file that the PR list will be read into. If the file already exists, it will be overwritten. If it does not exist, it will be created in the format readable by the offline AXESSTEL Preferred Roaming List Print Tool (Print PRL). This is the same format to be written to the phone using the hl_pr_list_wr command or the Product Support Tool (PST) for phones supporting PCS mode. This command differs from pr_list_rd in that the file it writes lacks the 3- or 5-byte header used in the older implementation. Syntax pr_list_rd nam “filename” Example pr_list_rd 0 “nam1prl.hin” Response The list is printed to a file named nam1prl.hin.
HL_PR_LIST_WR Allows the user to write a Preferred Roaming List (PRL) file to the phone. The NAM parameter specifies which NAM the PRL should be written to. The filename must be given in quotation marks and must be a file that was previously read from a phone using the hl_pr_list_rd command, read from a phone using the PST, or created using the AXESSTEL Roaming List Generator (RLG) for phones supporting PCS mode. Use this command only with headerless PRL
files. For PRL files which have the 3- or 5-byte header, use
pr_list_wr.
Syntax pr_list_wr nam “filename”
Example pr_list_wr 0 “nam1prl.hin”
Response The list in the file nam1prl.hin is sent to the mobile phone.
See also pr_list_wr
HS_LOCK Locks or unlocks manual key operation for handset emulation. It is
recommended that if the handset emulation commands are used
(key, get_screen), the manual operation be locked out for
AXESSTEL Proprietary 85
AXESSTEL Software User's Guide Contents
consistency.
Syntax hs_lock l | u Example hs_lock l
Response Normal manual keypad operation is locked out.
See also key
get_screen
INP Requests a port input operation where port is accessed either as a
byte (8 bits) or word (16 bits) port, depending on the syntax of the
command.
Syntax inp byte | word Example inp byte 0x01
Response Requested byte is input from port address 0x01.
KEY Sends a specified key press to the phone. The keys include keys
other than just handset keys.
Syntax key [key_name] Script Command List
Values for key names can be any of the following: Name Definition/Value
NONE No more keys available
ON_HOOK Phone has gone on-hook
OFF_HOOK Phone has gone off-hook
RING_VOL_0 Ringer volume 0
RING_VOL_1 Ringer volume 1
RING_VOL_2 Ringer volume 2
EAR_UP Ear-piece up
EAR_UP_END Ear-piece up + end pressed
EAR_DOWN Ear-piece down
PF1 Soft-key #1 (left-most)
PF2 Soft-key #2 (right-most)
MSG Message waiting
POUND # key
STAR * key
ZERO 0 key
ONE 1 key
AXESSTEL Proprietary 86
AXESSTEL Software User's Guide Contents
TWO 2 key
THREE 3 key
FOUR 4 key
FIVE 5 key
SIX 6 key
SEVEN 7 key
EIGHT 8 key
NINE 9 key
SEND Send key
END End key
CLR Clear key
STO Store key
UP Up-arrow key
DOWN Down-arrow key
MUTE Mute key
RCL Recall key
SD1 Speed dial #1
SD2 Speed dial #2
SD3 Speed dial #3
MENU Menu key
SELECT Select key
ALPHA Alpha key
DEC_POUND Decoded # DTMF
DEC_STAR Decoded * DTMF
DEC_0 Decoded 0 DTMF
DEC_1 Decoded 1 DTMF
DEC_2 Decoded 2 DTMF
DEC_3 Decoded 3 DTMF
DEC_4 Decoded 4 DTMF
DEC_5 Decoded 5 DTMF
DEC_6 Decoded 6 DTMF
DEC_7 Decoded 7 DTMF
DEC_8 Decoded 8 DTMF
DEC_9 Decoded 9 DTMF
DEC_A Decoded A DTMF
DEC_B Decoded B DTMF
AXESSTEL Proprietary 87
AXESSTEL Software User's Guide Contents
DEC_D Decoded C DTMF
DEC_D Decoded D DTMF
PWR_ON Power key was actuated
PWR_OFF Power key was actuated
PWR Power key
INFO Info key
FREE Phone placed in hands-free cradle
PHONE Phone lifted from hands-free cradle
IGN_OFF Ignition was turned off
IGN_ON Ignition was turned on
Name Definition/Value
Script Command List
Example key rcl
Response The rcl key press is sent to the subscriber station.
Note The PWR_ON keystroke cannot actually power on the test phone or subscriber
station.
TMR_ON Power-up timer ’on’ pseudo-key
TMR_OFF Power-up timer ’off’ pseudo-key
BAD_BATT The car battery is failing
EXT_PWR_ON External power was turned on
EXT_PWR_OFF External power was turned off
REDIAL Redial key
RSSI_KEY RSSI key
HFK_CORD Coil cord car-kit
HFK_NOCORD Non-coil-corded car-kit
HEADSET Headset
DEV_UNKNOWN Unknown device ID
EXT_DEV ONES detector finds external device
LOUDSPEAKER Loudspeaker
LSPKR Loudspeaker
HDS Home docking station attached
HEADSET_ON Analog Headset on
HEADSET_OFF Analog Headset off
PUSH_TO_TALK Push to Talk button
PTT Push to Talk button
HAT_UP HAT Up press
AXESSTEL Proprietary 88
AXESSTEL Software User's Guide Contents
HAT_DOWN HAT Down press
HAT_LEFT HAT Left press
HAT_RIGHT HAT Right press
RELEASE Key to note that all keys are up
Name Definition/Value
KEY_HOLD Sends a key press to the phone without release as if you were
holding the key down.
Syntax key_hold [key] Example key_hold pwr
Response The end key is sent to the test phone; and if it is a axesstel phone,
it will actually power off.
LOAD_SYNTH (analog test command) Tunes the synthesizer to a given channel (analog only).
Syntax load_synth [channel]
LOGGING Turns data logging on and off from the scripting screen command
line or in a script file. This command is equivalent to typing Alt+L
from anywhere in PST. If using this command to turn logging on,
you can optionally specify a file name to which the log will be
written.
Syntax logging on [“filename”]| off Example logging on
Response PST starts polling the test phone for logging messages.
LOGMASK Used to change the current log mask from the scripting screen or in
a script file. If logging is on when this command is executed, the new
log mask is sent to the phone. If not, the log mask is set in PST
Syntax logmask [mask_value]. Where mask_value is the new log mask to change. Script Command List
Example logmask 0XFFFFFFFF
Response This turns on all possible logging fields in the current log mask in
PST.
MODE Requests a mode change of the subscriber station. Many test
AXESSTEL Proprietary 89
AXESSTEL Software User's Guide Contents
commands are only accepted by the subscriber station when it is in
offline mode. In the offline options below, the A and D stand for
analog and digital, respectively.
Syntax mode offline-a | offline-d | reset Example 1 mode offline-a
Response Directs the subscriber station to enter the offline analog mode. After
this command is sent, it may take several seconds to complete the
transition into the offline mode. Monitor the phone_state
Example 2 mode reset
Response Directs the subscriber station to perform a software restart, and the
test phone will cycle power. This command is not valid unless the
phone is already in an offline state first.
NV_READ Requests an NV (non-volatile memory) item by name from the
phone. There are hundreds of NV items. For a complete listing of the
NV items which can be read, type help nv_read. Some of the items
need modifiers to specify which element you want to read.
Syntax nv_read item [modifiers] Example nv_read esn
Response The test phone ESN (electronic serial number of test phone) is
requested.
NV_READ_HEX Requests an NV (non-volatile memory) item by name from the
phone, in hexadecimal format. There are hundreds of NV items. For
a complete listing of the NV items which can be read, type help
nv_read_hex. Some of the items need modifiers to specify which
element you want to read.
Syntax nv_read_hex item [modifiers]
NV_WRITE Provides a value to be written to the named NV item.
Syntax nv_write item {parameters} Example nv_write slot_cycle_index{1}
Response The value 1 is written to the slot cycle index NV item. Note that
because different NV items require different types of data, the
argument list varies from item to item. Type help nv_write for an
argument list. The dot operator ( ) is required, but the content can be
AXESSTEL Proprietary 90
AXESSTEL Software User's Guide Contents
a string, address, or numeric. The list may have up to 40 arguments.
A comma must separate each item.
NV_WRITE_ONLINE Writes an NV item as does nv_write, but does so without going
offline.
Syntax nv_write_online item {parameters} Example nv_write_online ringer_level {2}
Response The value 2 is written to the ringer level NV item while the phone
remains online.
See Also nv_write
OPENLOG Open a transcript file and writes every line echoed to the screen in
the script scrolling area. An optional ECHO switch enables
recording of scripting commands within the log file opened. Script Command List
Syntax openlog “log_file_name” [echo] Example openlog “foo.dat” echo
Response The file foo.dat is opened for transcript output. The quotation marks
are not required but are recommended for correct interpretation. For
example, if the file is named “2test.dat” without using quotations,
PST would warn of a syntax error. This is because the “2” as the
first character would be interpreted as a number not a string.
Additionally, the presence of the ECHO switch results in
subsequent scripting commands being recorded in the file foo.dat.
Note The openlog command cannot be nested (only one file can be open at a time).
OUTP Requests a port output operation.
Syntax outp byte | word Example outp byte 0x01 12
Response Decimal 12 is output to the byte port 0x01.
PARM_GET Requests the specified parameters as follows: _ MUX1 = Rate Set 1 Traffic Channel Parameters _ MUX2 = Rate Set 2 Traffic Channel Parameters _ PAGE = Paging Channel _ ACCESS = Access Channel
AXESSTEL Proprietary 91
AXESSTEL Software User's Guide Contents
_ LAYER2 = Layer 2 Statistics _ ALL = All of the above Syntax parm_get MUX1 | MUX2 | PAGE | ACCESS | LAYER2 | ALL Example parm_get access Response The PST displays the access channel statistics as follows: Access Channel Statistics 5/20/93 16:26:47 *Acc Chn req msgs 740 *Acc Chn rsp msgs 0 *Probe Tx > 1 17 *Probe Tx > 2 8 *Probe Tx > 3 4 *Probe Tx > 4 3 *Probe Tx > 5 1 *Num of failed attempts 0
PARM_SET Sets the specified parameters. A -1 value clears all parameters.
Syntax parm_set parm_id [value] Example parm_set -1 0
Response All parameters are cleared (reset to zero).
PASSWORD Allows the user to send the phone’s security password. This is the
password associated with the DMSS Security Plan, not to be
confused with the Service Programming Code. If a phone has this
password set, sending this command with the correct password will
unlock secure features (memory peek/poke, port I/O). If the wrong
password is sent, the phone powers off. The password argument is
a 16-character string of hexadecimal digits (0–9, A–F), representing
the 8-byte password of the phone.
Syntax password “password”
Example password “0123456789abcdef”
Response The security password of 0x0123456789abcdef is sent to the
phone to unlock the secure features of the phone. Script Command List
PAUSE Stops reading commands from the script file until a keystroke is
entered.
AXESSTEL Proprietary 92
AXESSTEL Software User's Guide Contents
Syntax pause Example pause
Response A dialog box with the text “Paused ! Press Enter or click
the OK Button” opens. The execution of the script is suspended
till the user closes this dialog box.
PCM_LB Turns the Vocoder PCM Loop Back on or off. This mode feeds
samples from the address codec back to the codec effectively looping
microphone audio to the handset (or other) speaker.
Syntax pcm_lb on | off Example pcm_lb off
Response The Vocoder PCM Loop Back turns off.
PEEK This command causes PST to ask the subscriber station for the
contents of a specified region of its memory up to 16 bytes at a time.
Syntax peek byte | word | dword | nv_byte | nv_word | nv_dword | voc addr length
Example peek byte 0040:0000 4
Response Peeks at the 4 bytes starting at memory address 0040:0000.
PHONE_STATE Requests the current phone state (analog, CDMA), displays state
and event count, which is a count of the number of handoffs, and
other state-significant events. Possible phone states are:
_ No Service
_ Analog States: Initialization, Idle, Voice Channel Initialization,
Waiting for Order, Waiting for Answer, Conversation, Release,
System Access
_ CDMA States: Initialization, Idle, Voice Channel Initialization,
Waiting for Order, Waiting for Answer, Conversation, Release,
Update Overhead Information, Mobile Station Origination
Attempt, Page Response, Order/Message Response,
Registration Access, Message Transmission
Syntax phone_state
PILOT_SETS Requests current pilot sets information (members of active,
candidate, neighbor sets, PN offset, strength)
AXESSTEL Proprietary 93
AXESSTEL Software User's Guide Contents
Syntax pilot_sets Example Active Set Candidate Set Neighbor Set
PN Strength PN Strength PN Strength PN Strength
* 396 12 76 63 152 63
* 236 63 288 63
* 328 63 296 63
* 24 35 316 63
* 488 29
* 44 63
* 364 26
* 204 63
* 344 63
* 368 63
*Remaining Set Pilot Inc: 4
PKT_LB Turns the Vocoder Packet Loop Back on or off. This mode returns
voice packets received on the forward traffic channel back over the
reverse traffic channel. For this command to take effect, the phone
must be in a call. The command must be repeated for each call.
Syntax pkt_lb on | off Example pkt_lb on
Response Turns the Packet Loop Back on.
POKE Directs the subscriber station to set a given memory location to a
specified value. Note that using this command, without any
knowledge of a particular memory location, has the potential to
disable the subscriber station.
Syntax poke byte | word | dword | nv_byte | nv_word | nv_dword | voc addr value Script Command List
Example poke word 0040:0000 0xFFFF
Response Pokes (inserts) 0xFFFF into the word at memory address 0040:0000.
PR_ LIST_RD Allows the user to read the Preferred Roaming List (PRL) into a file.
The NAM parameter indicates which NAM the PRL should be read
from. The filename parameter must be given in quotation marks and
AXESSTEL Proprietary 94
AXESSTEL Software User's Guide Contents
names the file that the PR list will be read into. If the file already
exists, it will be overwritten. If it does not exist, it will be created in
the format readable by the offline Axesstel Preferred Roaming
List Print Tool (print PRL). It is the same format to be written to the
phone using the pr_list_wr command or the Product Support Tool
(PST) for phones supporting PCS mode.
Syntax pr_list_rd nam “filename” Example pr_list_rd 0 “nam1prl.bin”
Response The list is printed to a file named nam1prl.bin.
PR_LIST_WR Allows the user to write a Preferred Roaming List (PRL) file to the
phone. The NAM parameter specifies which NAM the PRL should
be written to. The filename must be given in quotation marks and
must be a file that was previously read from a phone using the
pr_list_rd command, read from a phone using the PST, or created
using the AXESSTEL Roaming List Generator (RLG) for phones
supporting PCS mode.
Syntax pr_list_wr nam “filename” Example pr_list_wr 0 “nam1prl.bin”
Response The nam1prl.bin list is sent to the mobile phone.
PRINT Prints a line on the display window.
Syntax print “text” Example print “Next we will test the symbol error rate”
Response The string “Next we will test the symbol error rate” is printed
on the display screen. The quotation marks delimit the string.
RCVERSUS1 (analog test command) Returns the message count on the analog control channel.
Syntax rcversus1
RCVS1 (analog test command) Returns the message count on the analog control channel. Shorthand
for rcversus1.
Syntax rcvs1
RSSI (analog test command) Returns the current analog RSSI measurement.
Syntax RSSI
AXESSTEL Proprietary 95
AXESSTEL Software User's Guide Contents
RUN Starts executing commands from a script file. This also allows one
script file to execute another.
Syntax run [script_file_name] Example run test0001.scr
Response PST starts running the test0001.scr script file. This command is
entered on the command line or contained in a script file. When
entered on the command line, the file is opened and commands are
parsed and executed from the beginning of the file to the end. When
this command is contained in a script file, the position in the current
file is remembered, the new file is run, then processing is resumed in
the original file. Nesting of files up to five deep is supported. Script Command List
RXMUTE (analog test command) Mutes or unmutes the receiver audio signal.
Syntax rxmute on | off Example rxmute off
Response Unmutes the receiver audio signal.
SATOFF (analog test command) Disables the SAT (supervisory audio tone) transmission.
Syntax satoff
SATON (analog test command) Transmits a SAT (supervisory audio tone). Value may be 5970, 6000,
or 6030 Hz.
Syntax saton [value] Example saton 6000
Response Transmits a SAT at 6000 Hz.
SCAN_CONFIG Lets you alter the Pilot Scanner’s PN search parameters and
algorithms.
The scan_config command requires you to you specify the values of
all parameters even if you want to change only one of them.
For a detailed description of each scan_config parameter, see
Syntax scan_config scan_mode incr win_siz integ ho_typ log_fmt log_thr
The following table lists the possible values for each parameter: Parameter Value
AXESSTEL Proprietary 96
AXESSTEL Software User's Guide Contents
scan_mode 0=A R R R (all PNs), 1=A N N N (list).
incr 0=Use pilot_inc, 1,2...=User specified.
win_siz 0=Use (PN 64*Incr), 1= WinN, 2... 512=User specified.
Example scan_config 0 3 1 2 0 0 0
Response Resets PN scanning to scan all PN space using an increment of 3.
SCAN_NLIST This command lets you load the Retriever Pilot Scanner with
Neighbor list information to either augment or override the OTA
Neighbor List, or to provide a pilot list for scanning PN offsets in List
mode.
Syntax scan_nlist replace_all active_pn nlist_siz {P1, P2,... P20}
replace_all controls how Retriever uses this list. Use replace_all=1 to
completely replace the Neighbor list. Use replace_all=0 to append the new list to the end of the existing Neighbor list. Retriever
supports up to 20 total pilots in Idle/Scan List mode.
active_pn is the Active serving system’s PN to associate this list with
nlist_siz is the length of the list being entered
P1, P2, etc., is the list of pilot PNs to include in the Neighbor list.
Example 1 scan_nlist 0 160 2 {24,48}
Response Pilots PN=24 and PN=48 are added to Active pilot PN=160’s
Neighbor List.
Example 2 scan_nlist 1 160 5 {4,16,32,96,104}
Response Replaces any existing pilot list with PN offsets 4,16,32,96, and 104 for
scanning in List mode.
SCAN_ON Starts PN scanning using either the default parameters or
parameters that have been entered using the scan_config command.
Syntax scan_on integ 0=256, 1=360, 2=512, 3=720, 4=1020.
ho_typ 0=Within Nlist only, 1=All, 2=None.
log_fmt 0=Dense Scanner format, 1=STD AXESSTEL DM format.
log_thr 0=All, 1=T_DROP, 2=T_ADD (STD log_fmt only).
Parameter Value
Script Command List
Example scan_on
Response PN scanning begins.
AXESSTEL Proprietary 97
AXESSTEL Software User's Guide Contents
SCAN_OFF Turns the PN scanner OFF and returns the scanner to normal phone
operation.
Syntax scan_off Example scan_off
Response PN scanning ends.
SCAN_PARSE Reads in a binary log file containing Dense-Pack searcher packets
and writes out an ASCII file listing the Dense-Pack search scans
only.
The Dense-Pack scanner log packet contains the time stamp of the
search, Rx power at the end of the search, LNA state during the
search, instantaneous Ec/Io of each of the four largest energy peaks
in the search window of each PN, and each peak’s position (time
delay).
Individual Ec values can be computed from this by adding
Rx + Ec/Io, where Rx represents an estimate of the total power Io.
Note The scan_parse command only parses out Dense-Pack searcher packets from
the binary data.
The following is an example of output from the scan_parse
command: Time PN S Win L Rx E1 E2 E3 E4 P1 P2 P3 P4 WPos
00:37:26.087 192 A 256 1 -85.9 -10.5 -19.3 -19.5 -20.0 0102 0071 0119 00e4 f838
00:37:26.100 400 R 256 1 -84.9 -18.3 -19.6 -19.7 -20.4 00e0 003d 011d 01b0 f838
00:37:26.120 404 R 256 1 -84.9 -18.8 -19.5 -19.8 -20.0 0039 014a 009e 00ac f838
00:37:26.135 408 R 256 1 -84.9 -18.2 -19.2 -19.2 -19.6 01da 0042 0100 01c3 f838
The columns of scan_parse output contain the following data:
Syntax scan_parse log_file_name output_file_name
Example scan_parse M2817330.007 search_scans.txt
Response The Dense-Pack log file M2817330.007 is parsed and the Dense-Pack
search scans it contains are written to the file search_scans.txt.
SCAN_PN_ID In user interface screen mode, the Retriever Pilot Scanner supports
the ability to display 4-letter cell sector names rather than PN offset
numbers. The scan_pn_id command lets you enter these cell sector
names into the phone’s programmable memory.
AXESSTEL Proprietary 98
AXESSTEL Software User's Guide Contents
Be aware that at this time, no ability to resolve PN reuse ambiguities
within a network is supported. It is assumed that the main
usefulness of the PN name mapping feature will either be in
networks having no PN reuse (small to mid-size networks), or in
situations where the user wants to enter a cluster of
uniquely-assigned PNs confined to an area within a larger network. Column Data
Time CDMA system time at the end of the search period.
PN PN offset of the search.
S Set membership of the search (Active, Neighbor, Remaining)
deduced by Retriever by comparing the searched PN to the
contents of the latest Extended neighbor list message. “N”
indicates that Retriever cannot deduce the membership.
L LNA (low noise amplifier) state during the search (1=on, 0=off).
Rx Estimate of the total receive power in the 1.25 MHz CDMA
channel (can be considered the open loop total signal +
interface + noise term Io).
E1–E4 Four largest energy peaks’s Ec/Io found in the search window.
P1–P4 Position of each peak in half chip windows. A peak position of
0100 half chop hex units refers to a peak exactly centered in the
search window.
Wpos Lower 16 bits of the absolute position of the search window.
Script Command List
Syntax scan_pn_id pilot_pn name
pilot_pn is the PN offset number to map to the cell sector name.
name is a 4-letter cell sector name string.
Example scan_pn_id 4 MIRX
scan_pn_id 8 MIRY
scan_pn_id 12 MIRZ
scan_pn_id 16 SORX
scan_pn_id 20 SORY
Response The PN offsets 4, 8, 12, 16, and 20 are assigned the names MIRX,
MIRY, MIRZ, SORX, and SORY, respectively.
SCAN_RF_CNTL The Retriever Pilot Scanner can be service programmed with CDMA
channels like a normal commercial phone. However, the
AXESSTEL Proprietary 99
AXESSTEL Software User's Guide Contents
scan_rf_cntl command is provided to ensure Pilot Scanner will lock
onto a particular RF channel and suppress registrations on that
channel.
Syntax scan_rf_cntl cdma_channel reg
cdma_channel is the CDMA channel you want to lock onto. When
cdma_channel is nonzero, the Retriever Pilot Scanner will always
tune and lock onto this channel, ignoring any service-programmed
system selection parameters, OTA Channel List hashing, or Global
Service Redirection commands. When cdma_channel is set to zero (0),
system selection returns to automatic; that is, it is controlled by the
contents of Retriever’s service-programmed system selection and
OTA system commands.
reg is a boolean value (0=yes, 1=no) that indicates whether or not
Retriever should register on this CDMA channel according to the
Active serving sector’s registration parameters (contained in the
latest received Extended System Parameters Message.)
Example scan_rf_cntl 2 1
Response The Retriever phone locks onto RF channel 2 and suppresses
registration on that channel.
SCAN_TRANS Reads in a binary log file containing Dense-Pack searcher packets
and writes out another binary log file in which the Dense-Pack
packets have been converted to Standard DM Temporal Analyzer
packets.
Syntax scan_trans input_file output_file
Example scan_trans M2817330.007 M2817330.out
Response The Dense-Pack log file M2817330.007 is translated and output as a
log file in standard DM format file, M2817330.out.
SEND_DATA This command sends the contents of a hexadecimal string to the
phone. The hexadecimal data string is translated into a binary byte
stream before being transmitted. Any response returned by the
phone is displayed in the scripting window in HEX and ASCII.
Syntax send_data “hex_string”
SEND_DATA_FILE This command sends the contents of the specified data file to the
AXESSTEL Proprietary 100
AXESSTEL Software User's Guide Contents
phone. The data file is treated as binary, and no translation is
applied to its contents. Any data returned by the phone is displayed
in the scripting window in HEX and ASCII.
Syntax send_data_file “file_name”
SEQ_NUMS Requests that packets be sent with sequence numbers included.
Syntax seq_nums
SER_REPORT Reports the Symbol Error Rate (SER) counts, but does not reset them.
Syntax ser_report Example ser_report Script Command List
Response Polls the subscriber station for current SER statistics, without
resetting the counters.
SER_RESET Resets the Symbol Error Rate (SER) statistics.
Syntax ser_reset Example ser_reset
Response Resets the SER counters.
SET ATTN (analog test command) Sets the analog power control to a specific value (range 07).
Syntax set attn [value] Example set_attn 1
Response Power control is set to 1 volt.
SET_EXT_INT_TYPE Sets the type of interrupt (0–2). This command is for Module targets
only.
Syntax set_ext_int_type 0 | 1 | 2
SET EXT_RSSI Sets the sensitivity and range of RSSI reporting for both CDMA and
analog modes. This command is for Module targets only.
Syntax set ext_rssi {cmd_code, sub_sys, subcmd_code, cdma_rssi_sensitivity, cdma_lower_threshold, cdma_upper_threshold, analog_rssi_sensitivity,
analog_lower_threshold, analog_upper_threshold}
cmd_code is a 1-byte message ID.
sub_sys is a 1-byte identifier for the generic subsystem, used for
AXESSTEL Proprietary 101
AXESSTEL Software User's Guide Contents
diagnostic purposes. The default is 0.
subcmd_code is a 1-byte flag. Possible values: 0=Extended state,
1=RSSI sensitivity, 3=Masking interrupt.
cdma_rssi_sensitivity sets the sensitivity of CDMA RSSI change, in
dB. The default is 3 dB. If the difference between current RSSI and
last RSSI is larger than this value and within the range of sensitivity
test, the system unit will be notified.
cdma_lower_threshold sets the lower bound of CDMA RSSI in
absolute value, in dB. The normal setting is –80 dB in absolute,
which is 80 dB, but there is no default value.
cdma_upper_threshold sets the upper bound of CDMA RSSI in
absolute value, in dB (1 mW). The normal setting is –100 dB in
absolute, which is 100 dB (1 mW), but there is no default value.
analog_rssi_sensitivity sets the sensitivity of analog RSSI change, in
dB. The default is 3 dB. If the difference between current RSSI and
last RSSI is larger than this value and within the range of sensitivity
test, the system unit will be notified.
analog_lower_threshold sets the lower bound of analog RSSI in
absolute value, in dB. The normal setting is –85 dB in absolute,
which is 85 dB, but there is no default value.
analog_upper_threshold sets the upper bound of analog RSSI in
absolute value, in dB. The normal setting is –115 dB in absolute,
which is 115 dB, but there is no default value.
The range of RSSI reporting can be set in absolute values by using
the cdma_lower_threshold, cdma_upper_threshold,
analog_lower_threshold, and analog_upper_threshold parameters. If the
current RSSI value and the last RSSI value are both out of this range,
the system unit will not be notified, even if the difference between
current RSSI and last RSSI is greater than the RSSI sensitivity setting.
Also, the last RSSI value will not be updated as the current RSSI.
RSSI sensitivity is set by setting the cdma_rssi_sensitivity and
analog_rssi_sensitivity parameters. These values set the reporting
sensitivity for CDMA and analog modes, respectively. However, if
current RSSI or last RSSI, or both, are within the range of RSSI, the
difference between current RSSI and last RSSI is subject to the
sensitivity test. If the difference between the absolute value of
AXESSTEL Proprietary 102
AXESSTEL Software User's Guide Contents
current RSSI and the last recorded RSSI value is greater than the
RSSI sensitivity setting, the system unit will be notified, and the last
RSSI value will be updated as current RSSI. The default sensitivity
for CDMA and analog is 3 dB. The RSSI range of CDMA and analog
is not set by default.
Example set_ext_rssi {12, , 1, 1, 80, 100, 1, 85, 115} Script Command List
Response Sets the RSSI sensitivity parameters to one and maintains threshold
levels at their norm.
SET_LOG_DIR Sets the directory where log files are written, either permanently or
temporarily.
Syntax set_log_dir “logging_directory_path” [TEMPORARY] Example set_log_dir “c:\PST_log\just4now” TEMPORARY
Response Sets the logging directory to the specified directory until the script
finishes running.
SET_MAX_FWD_MUX Sets the maximum number of supplemental channels. This
command is for MDR targets only.
Syntax set_max_fwd_mux service_option max_num_sup_ch
service_option is a code representing the type of transmission for
which you are setting a maximum number of supplemental
channels, as described in the following table. Code Description
0 None
1 IS-96 Voice
2 8K Loopback
3 Old 8K Markov
4 Data
5 IS-96A Voice
6 13K (MSM2 only) Voice call
7 13K (MSM2 only) Markov call (new)
8 New 8K Markov
9 13K Loopback
10 13K (MSM2 only) Markov call (old)
11 EVRC voice option
AXESSTEL Proprietary 103
AXESSTEL Software User's Guide Contents
max_num_sup_ch is the maximum number of supplemental channels
you are specifying, 0–7.
Example set_max_fwd_mux 5 3
Response Sets the maximum number of supplemental channels for IS-96A
Voice calls to 3.
SET_STATUS_FLAG_MASK Sets the status mask flag. This command is for Module targets only.
Syntax set_status_flag_mask status_flag_mask
status_flag_mask is a 2-byte value. The individual bit values each
indicate an event or state, as described in the following table. 22 Medium Data Rate (also known as High Speed Data) PPP Packet
Data Service (IS-707A) with rate set 1 forward and reverse. Default
Mux = 9 forward 1 reverse.
23 Medium Data Rate (also known as High Speed Data) PPP Packet
Data Service (IS-707A) with rate set 1 forward and rate set 2 reverse.
Default Mux = 9 forward 2 reverse. This service option is not
supported by MSM3000.
24 Medium Data Rate (also known as High Speed Data) PPP Packet
Data Service (IS-707A) with rate set 2 forward and rate set 1 reverse.
Default Mux = 10 forward 1 reverse. This service option is not support
by MSM3000.
25 Medium Data Rate (also known as High Speed Data) PPP Packet
Data Service (IS-707A) with rate set 2 forward and reverse. Default
Mux = 10 forward 2 reverse.
Code Description
Bit Description
0 Digital service: 0=analog service, 1=digital service
1 New SMS message. This bit will be reset every two minutes until
you power cycle the module, if the new SMS message is not
read. It is cleared to 0 whenever an Extended State Packet
Response is sent.
2 Maintenance request when set to 1; cleared by the unlock_order
message defined by IS-95A
Script Command List
Example set_status_flag_mask 32192
SLEEP
AXESSTEL Proprietary 104
AXESSTEL Software User's Guide Contents
Toggles the phone’s sleep state.
Syntax sleep on | off
SPC Allows the user to send the service programming code to the phone.
The parameter security_code is a string of 6 digits (09) enclosed in
quotation marks. If the code is incorrect, a message appears and
PST time out for about 10 seconds. This command is required to be
given before writing or reading certain NV items.
Syntax spc “security_code” Example spc “000000”
Response Sends the service programming code “000000” to the phone in order
to unlock write access to service programming parameters. 3 caller_id_available when set to 1; this bit is cleared when a
conversation ends and whenever an Extended State Packet
Response is sent.
4 mod_pwr is on when set to 1.
5 call_waiting (not implemented)
6 NAM_change_alert; module changes NAM to get more
preferred service. This bit is cleared to 0 whenever an Extended
State Packet Response is sent.
7 lock_until_pwr_cycle; if this bit is set to 1, Bit 2 is also set to 1.
If this bit is cleared to 0 (by the unlock_order message defined
in IS-95A, Bit 2 is also cleared to 0.
8 voice_privacy_alert; indicates that voice privacy has been lost
or gained during a call. You must enable the voice privacy alert
in the module to activate the voice_privacy function. 0=voice
privacy lost; 1=voice privacy gained.
9–15 Reserved
Bit Description
SRCH_PARM The Retriever Pilot Scanner has the ability to operate as a normal
phone with some of the parameters from the Extended System
Parameters Message overridden and controlled using the srch_parm
command. The parameters that can be overwritten include handoff
parameters (T_ADD, T_DROP, T_COMP, T_TDROP), search
windows (Win_A, Win_N, Win_R), and the Neighbor aging
AXESSTEL Proprietary 105
AXESSTEL Software User's Guide Contents
parameter NGHBR_MAX_AGE.
Be aware of the following:
_ Currently the srch_parm command groups search windows and
handoff parameters together. The user must override all of them
together.
_ Retriever currently overrides these system parameters for all
serving sectors encountered during the test.
_ If handoff parameters T_ADD, T_DROP, and T_COMP are
specified which are different than those being used OTA in the
network, Pilot Strength Measurement Messages will be adjusted
so that the pilots’ reported energies conform to those which
would have generated the respective T_ADD, T_DROP, or
T_COMP events using the OTA thresholds. That is, if the user’s
desired T_ADD is lower than the actual threshold the system is
using, pilots generating add events may have their reported
energies adjusted upward in the PSMM, if necessary, to match
the Over-the-Air T_ADD. This is to force handoffs in networks
utilizing certain infrastructure brands which look at pilot
energies in the PSMMs to decide whether or not to actually add
the pilot.
Syntax srch_parm win_a win_n win_r t_add t_drop t_comp t_tdrop
nghbr_max_age
win_a, win_n and win_r are IS-95A/J-STD-008 window sizes 0–15.
For example, 7=40 chips, 8=60 chips, 9=80 chips, 10=100 chips, and
so on.
t_add, t_drop, and t_comp are the handoff parameters, specified in
half-dB units.
t_tdrop is the index into the T_TDROP threshold table given in
IS-95A/J-STD-008. For example, 2=2 seconds, 3=4 seconds, 4=6 Script Command List
nghbr_max_age is the maximum number of consecutive Neighbor
List Update messages not containing a pilot to be retained in the
Neighbor set, as defined in IS-95A/J-STD-008.
Example srch_parm 7 12 10 28 32 5 3 0
Response Sets up the Retriever to operate as a normal phone with the
following pre-defined parameters: T_ADD=14dB, T_DROP=16dB,
AXESSTEL Proprietary 106
AXESSTEL Software User's Guide Contents
T_COMP=2.5dB, T_TDROP=4 seconds, Win_A=40 chips,
Win_N=160 chips, Win_R=100 chips, and NGHBR_MAX_AGE=0.
The Retriever will use these parameters for all search and handoff
operations in Sync, Idle, and Traffic states until it is power-cycled.
SRCH_95B_SOFT_ENA In terms of system parameter overrides, the Retriever Pilot Scanner
supports enabling the IS-95B extensions to soft-handoff whereby a
soft-handoff slope, Add Intercept value, and Drop Intercept value
are applied to the handset’s Traffic-state soft-handoff algorithms.
The advantage of these extensions in IS-95B is to reduce the amount
of network resources a handset uses for soft-handoff.
The srch_95b_soft_ena command allows you to explore “what-if”
scenarios looking ahead to IS-95B deployment by sending IS-95B
soft-handoff parameters to Retriever and enabling the IS-95B
handoff algorithm.
Syntax srch_95b_soft_ena soft_slope add_int drop_int rpt_ota_thr
soft_slope is the IS-95B soft handoff slope in hundredths (0.01) units.
add_int is the Add Intercept value in half-dB units.
drop_int is the Drop Intercept value in half-dB units.
rpt_ota_thr is the Report OTA Threshold enable flag. When enabled
(rpt_ota_thr=1), this flag tells the Retriever to adjust energies in the
Pilot Strength Measurement Message (PSMM) so that events occur
consistent with the existing IS-95A thresholds. This is the
recommended setting for Lucent and Motorola infrastructure. When
disabled (rpt_ota_thr=0), the Retriever sorts all PSMMs in strength
order. This is the recommended setting for Nortel infrastructure.
In IS-95B, pilots can be promoted to the Candidate set without the
handset sending a PSMM. This situation occurs if there is ample
Active set energy such that the dynamic add threshold (controlled
by the IS-95B parameters) is higher than T_ADD. If the dynamic add
threshold later drops, a PSMM may be sent to add the Candidate
pilot, but the Candidate may have dropped slightly below T_ADD.
In order to force this kind of IS-95B add event in IS-95A networks
utilizing certain makes of infrastructure, the actual reported energy
must be adjusted upward to T_ADD by enabling the rpt_ota_thr flag
(rpt_ota_thr=1) so that the IS-95A base station will add the pilot as
AXESSTEL Proprietary 107
AXESSTEL Software User's Guide Contents
requested. Again, the PST log files can indicate these events as
having happened.
Example srch_95b_soft_ena 200 4 6 1
Response This command enables IS-95B soft-handoff by Retriever with a soft
slope of 200, Add Intercept value of 4, Drop Intercept of 6, and the
Report OTA Threshold enabled as appropriate for a Lucent or
Motorola network.
ST (analog test command) Starts or stops the transmission of signaling tone.
Syntax st on | off Example st on
Response Starts transmission of the signaling tone.
TERMINATE (analog test command) Stops RCVERSUS1 or WSTS and reports the counts.
Syntax terminate
TIMESTAMP Allows the user to request that a time stamp be retrieved from the
phone and displayed on the scripting screen. Time stamp is
displayed in the format MM/DD/YY HH:mm:ss.hhh, where MM is
month, DD is day, YY is year, HH is hour, mm is minutes, ss is
seconds, and hhh is milliseconds.
Syntax timestamp Script Command List
TO_DATA_MODE Directs the phone to switch to data operation mode (where the AT
command processor is) instead of normal diagnostic mode.
Syntax to_data_mode
TXMUTE (analog test command) Mutes or unmutes the transmitter audio signal.
Syntax txmute on | off Example txmute on
Response Mutes the transmitter audio signal.
VERSION_REQUEST Returns the information in the Version Number Response Packet
which is similar to what is displayed in PST’s Mobile Version
i
AXESSTEL Proprietary 108
AXESSTEL Software User's Guide Contents
Syntax version_request
WAIT Waits a specified number of seconds before executing the next script
command.
Syntax wait [seconds_value] Example wait 20
Response The interpreter waits 20 seconds before reading the next command
from a script file.
WSTS (analog test command) Returns the word sync count on the analog control channel.
Syntax wsts
Appendix B SCAN_CONFIG Parameters By default, the Retriever Pilot Scanner scans the entire PN space.
To change the scan, alter the Pilot Scanner’s PN search parameters
and algorithms using the scan_config command. The syntax for this
AXESSTEL Proprietary 109
AXESSTEL Software User's Guide Contents
command is:
scan_config scan_mode incr win_siz integ ho_typ log_fmt log_thr
The following table lists the possible values for each parameter:
The scan_config command requires you to specify the values of all
parameters even if you want to change only one of them.
The sections which follow describe each parameter and the effect
changing it has upon scanner operation and performance. Parameter Value
scan_mode 0=A R R R (all PNs), 1=A N N N (list)
incr 0=Use pilot_inc, 1,2... =User specified.
win_siz 0=Use (PN 64*Incr), 1= WinN, 2... 512=User specified.
integ 0=256, 1=360, 2=512, 3=720, 4=1020.
ho_typ 0=Within Nlist only, 1=All, 2=None.
log_fmt 0=Dense Scanner format, 1=STD AXESSTEL DM format.
log_thr 0=All, 1=T_DROP, 2=T_ADD (STD log_fmt only).
SCAN_MODE The scan_mode parameter controls how the Retriever Pilot Scanner
searches PN space. The choices are (0) All PNs and (1) List.
All PNs mode In the All PNs mode, PN offsets are searched sequentially in
increments controlled by the incr parameter as
follows: A, P1, P2, P3... P15, P16, A, P17, P18, P19...
For example, if the current serving system Active pilot is PN=356
and increment parameter incr=1, Retriever’s search pattern is: 356, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13,
14, 15, 356, 16, 17, 18, 19...
If incr=4, Retriever’s search pattern is: 356, 0, 4, 8, 12, 16, 20, 24, 28, 32, 36, 40, 44,
48, 52, 56, 60, 356, 64, 68, 72, 76...
The search pattern returns to the Active serving system’s pilot once
every 16 searches. This pattern allows the Retriever Pilot Scanner to
constantly maintain acquisition, demodulation, and CDMA system
time tracking to the strongest serving cell sector in the CDMA
network. Generally, this is associated with the closest proximity
AXESSTEL Proprietary 110
AXESSTEL Software User's Guide Contents
cell’s sector face, the antenna field of which the user is in at that point
in the scan. The Retriever Pilot Scanner can be configured either to
lock onto that single sector regardless of its strength or to switch to
the best sector by performing idle handoffs.
List mode In List search mode, the scanner performs one of the following scan
operations, depending upon what has been pre-loaded into the
Retriever Pilot Scanner:
_ Over-the-Air (OTA) Neighbor List only A, N1, N2, N3... N15, N16, A, N17, N18, N19...
_ User-defined Pilot Scan List only A, L1, L2, L3... L15, L16, A, L17, L18, L19...
SCAN_CONFIG
Parameters
For example, if the current serving system Active pilot is PN=356
and the OTA Neighbor List of the current serving sector being
demodulated is (N1=16, N2=400, N3=164, N4=8), the search pattern
will be: 356, 8, 16, 164, 400, 8, 16, 164, 400, 8, 16, 164, 400, 8,
16, 164, 400, 356, 8, 16, 164, 400...
Note The Neighbor list is searched in ascending PN order, with the Retriever Pilot
Scanner returning to the Active pilot once every 16 searches. However, this
pattern may change as the scanner occasionally tries to verify candidates for
idle handoff.
If the user has loaded a pilot list into the Pilot Scanner using the
scan_nlist command, the Pilot Scanner searches this list in ascending
PN order instead of (or in addition to) the OTA Neighbor List. For
details on scan_nlist
INCR The incr parameter controls how the Pilot Scanner steps through PN
space in All-PNs mode. For example, with the setting incr=4,
Retriever searches PN=0,4,8,12,16... in blocks of win_siz chips.
By default, Retriever uses the Over-the-Air pilot_inc value contained
in the IS-95A or J-STD-008 Extended Neighbor List Message. This
value is recommended because the network plan uses it to
AXESSTEL Proprietary 111
AXESSTEL Software User's Guide Contents
determine what legal PN offsets are assigned to each sector face of
each cell. However, any value (1,2,3...) can be entered by the user as
well.
WIN_SIZ The win_siz parameter controls how many chips delay (or advance)
from the Active pilot the searcher scans for each PN. The choices are
Use WinN (1), Incr*64 (0), and User specified (2... 512).
Incr*64 mode (recommended) By default, the Retriever Pilot Scanner uses Incr*64 (0). In this mode,
the entire 32,768-chip PN space is broken up into equal windows of
Incr*64 chips centered on each PN offset on increment incr.
Therefore, if incr=4, the PN space will be divided evenly into 128 PN
offset windows, each 256 chips wide. This setting covers the entire
32,768 chips of the short-code with no overlap or gaps in time.
On an average, the RF propagation yields approximately 6.5 chips
per mile of propagation delay. This means that if incr=4 and
win_siz=256, cells approximately 19.5 miles away can be uniquely
resolved by the Pilot Scanner.
Use WinN and User Specified modes The Use WinN and User Specified modes are not recommended
unless the user is certain of the purpose and goals of controlling this
variable.
In Use WinN (1) mode, the Retriever Pilot Scanner uses the OTA Air Neighbor window of the Active serving sector for its search
window. This mode can be used when it is known that Neighbor
windows are well-tailored in a particular area.
In User Specified mode, any window size from 2 to 512 can be entered by the user.
Note Using either the Use WinN mode or the User Specified mode can result in
problems. If the windows chosen are too small, important RF information may
be missed. If the windows chosen are too large, PN ambiguities may be
introduced.
INTEG The integ parameter controls how long the Retriever Pilot Scanner’s
AXESSTEL Proprietary 112
AXESSTEL Software User's Guide Contents
searcher will dwell coherently at each chip during a sweep of a
search window. The choices are phone default (0), 360 (1), 512 (2), 720 (3), and 1020 (4). Using small numbers of integration chips yields faster search scans
at the expense of a higher apparent noise floor. Using more chips
yields a lower noise floor at the cost of speed. The default value (the
value normal AXESSTEL phones utilize) is 512 chips. At this
level, the apparent noise floor is approximately -20 dB Ec/Io.
The following equation estimates the scanner noise floor given
parameter integ: Noise Floor Ec/Io = 18 - 10 * log10( 13 * integ )
SCAN_CONFIG
Parameters
Using this equation, the approximate noise floor for the different
settings is as follows:
The column Average Search Speed was obtained by benchmarking the
average time it takes to complete a scan of the entire PN space (all
32,768 chips), assuming that incr=4 and win_siz=256.
Speed benchmarks for other incr/win_siz combinations will
approximately track these numbers except when incr is very small
(for example, incr=1). For small incr values, the all-PN-space search
speed will be slower than these values, due to Pilot Scanner software
processing overhead latencies with very frequent searching.
HO_TYP The ho_typ parameter determines how the Retriever Pilot Scanner
maintains the channel while scanning PNs.
By default, the Retriever Pilot Scanner uses ho_typ=0 to maintain the channel like a normal operational phone. That is, according to
IS-95-A/J-STD-008, the phone tracks the Active pilot (serving
system), monitors the Neighbor PNs as listed in the Extended
Neighbor List Message, and performs an Idle Handoff if the
Neighbor is sufficiently stronger than the Active to warrant handoff. Integ Noise Floor (dB) Average Search Speed (Sec)
360 -18.5 1.5
512 -20 2.0
AXESSTEL Proprietary 113
AXESSTEL Software User's Guide Contents
720 -21.5 3.0
1020 -23 4.0
The user may change the default ho_typ=0 setting to either of the
following:
_ All (1) allows idle handoffs to all pilots being scanned regardless of whether they are Neighbors or not.
_ None (2) suppresses Idle handoffs entirely. In this mode, the Retriever Pilot Scanner acquires the best serving system, then
stays locked on this system regardless of whether or not an Idle
handoff is possible. This setting is useful for single-sector
coverage area logging without the complication of Idle handoffs
being present in the data. It is often referred to as “Sounder”
mode.
LOG_FMT The log_fmt parameter controls how the Retriever Pilot Scanner
packages data for remote logging using the external Pilot Scanner
Interface Program. The following logging formats are supported:
_ Standard DM, for interfacing with AXESSTEL and other vendors’ test gear, displays, and analysis tools
_ Dense-Pack, a special format which overcomes the link limitations of the Standard format, allowing logging of every
search the Scanner sees
By default, the Retriever Pilot Scanner logs search scans in the
Dense-Pack format (Option 0). If necessary, Dense-Pack format can
be translated into DM format using the scan_trans command
The content of the Dense-Pack scanner log packet includes the time
stamp of the search, Rx power at the end of the search, LNA state
during the search, instantaneous Ec/Io of each of the four largest
energy peaks in the search window of each PN, and each peak’s
position (time delay).
Individual Ec values can be computed from this by adding Rx +
Ec/Io, where Rx represents an estimate of the total power Io.
Overall, the content of the binary log file using the Pilot Scanner
Interface Tool is the same as data collected by a standard
AXESSTEL Diagnostic Monitor. The only difference between
AXESSTEL Proprietary 114
AXESSTEL Software User's Guide Contents
Dense-Pack and Standard DM format is that Dense-Pack uses a
condensed searcher packet instead of the normal DM format. SCAN_CONFIG
Parameters
LOG_THR When the Retriever Pilot Scanner is logging in Standard DM format,
the serial link is limited in the number of searches which can be
logged to an external device such as a DM or the Interface Tool. For
instance, in a commercial AXESSTEL phone, link bandwidth
limitations result in roughly a one-tenth undersampling during
search logging. That is, the external device can log only about
one-tenth of the actual number of searches the phone performs. In
Retriever, this effect is even more pronounced since Retriever uses
special hardware and software features to increase several fold its
average search scan rate over a conventional commercial phone.
To log only the most interesting searches Retriever Pilot Scanner
sees, a thresholding feature is provided, applicable only to
Standard-AXESSTEL logging mode. The log_thr parameter
controls what threshold is used. The choices are as follows:
_ If log_thr=1, the Over-the-Air T_DROP threshold is used to weed out searches. Retriever will not log searches whose energy
is below that threshold.
_ If log_thr=2, the Over-the-Air T_ADD threshold (generally a higher threshold than T_DROP) is used. Retriever will not log
searches whose energy is below that threshold.
_ If log_thr=0, no thresholding will be performed. Retriever will attempt to log all searches with the resultant undersampling.
AXESSTEL Proprietary 115
AXESSTEL Software User's Guide Contents
Appendix C Sample Script Files H. Sample Script Files
Overview This appendix contains two samples of script files. The first sample
is a script to perform service programming on a test phone. The
second sample contains three script files that set up and tear down
AXESSTEL Proprietary 116
AXESSTEL Software User's Guide Contents
multiple, mobile-originated calls.
Service programming script file This sample script file programs a DMSS mobile phone. ;================================================================
; Name:
; srv_prog.scr
; Description:
; This DM script file performs service programming for a
; DMSS mobile phone. Most phones take the same basic set
; of parameters. This file should be edited only for those
; parameters unique to your phone. These parameters are
; detailed below and highlighted in the script commands.
; Service programming is performed by commanding the DMSS
; to OFFLINE, then programming the new parameters to the non
; volatile memory (NV), and finally resetting the DMSS
; to use the new parameters.
; With mobile releases 116 and later, you must first enter the SPC
; (Service Programming Code) before you will have read or write
; access to the service programming items.
; Dependencies:
;================================================================
; NV-items are programmed using the nv_write command:
; nv_write itemname { [nam index,] val1, val2, ..., valn }
; Only NAM 0 has meaningful values. Values for NAMs 1-3 are
; zeroed out or set to default values.
; Some items require a nam index (0-3). The curly braces
; are required and they surround the values to be written.
; You must supply every value the item expects. Hex values
; you supply need the 0x prefix.
; Semi-colons introduce comments. Whole line and
; to-end-of-line comments are possible.
; THE FOLLOWING PARAMETERS SHOULD BE SET FOR EACH PHONE:
; ------------------------------------------------------
; 1. CDMA preferred serving system (System A or System B)
AXESSTEL Proprietary 117
AXESSTEL Software User's Guide Contents
; 2. Analog preferred serving system (System A or System B)
; 3. Analog Home SID (the SID of the preferred serving system)
; 4. Analog first paging channel (for system A or system B)
; 5. CDMA primary and secondary channels (including PCN, if in
; use)
; 6. CDMA SID/NID pairs (the SID of the preferred serving system)
; 7. MIN1 and MIN2 parameters.
;================================================================
print "Start Service Programming"
; Enter the Service Programming Code (factory defaulted to 000000)
; If you don’t have version 116 or later, this command will fail.
; This allows access to the SP items (both reading _and_ writing)
spc "000000"
; Put the DMSS in offline analog mode
mode offline-a
;openlog srv_prog.log ; Uncomment if you want a log
; Display the ESN and permanent physical station
; configuration parameters
nv_read esn
nv_read verno_maj
nv_read verno_min
nv_read scm
nv_read slot_cycle_index
nv_read mob_cai_rev
nv_read mob_firm_rev
nv_read mob_model
print "Hit any key to continue"
pause
; NAM parameters.
; Preferred serving system
print "Programming CDMA Preferred Server"
nv_write cdma_pref_serv {0, "b only"}
nv_write cdma_pref_serv {1, "b only"}
nv_write cdma_pref_serv {2, "b only"}
nv_write cdma_pref_serv {3, "b only"}
; Analog preferred serving system
AXESSTEL Proprietary 118
AXESSTEL Software User's Guide Contents
print "Programming Analog Preferred Server"
nv_write analog_pref_serv {0, "b only"}
nv_write analog_pref_serv {1, "b only"}
nv_write analog_pref_serv {2, "b only"}
nv_write analog_pref_serv {3, "b only"}
; CDMA SIDs to lock out
Sample Script Files
print "Programming CDMA SID Lock List"
nv_write cdma_sid_lock {0, 0, 0, 0, 0, 0, 0}
nv_write cdma_sid_lock {1, 0, 0, 0, 0, 0, 0}
nv_write cdma_sid_lock {2, 0, 0, 0, 0, 0, 0}
nv_write cdma_sid_lock {3, 0, 0, 0, 0, 0, 0}
; Analog SIDs to lock out
print "Programming Analog SID Lock List"
nv_write analog_sid_lock {0, 0, 0, 0, 0, 0, 0}
nv_write analog_sid_lock {1, 0, 0, 0, 0, 0, 0}
nv_write analog_sid_lock {2, 0, 0, 0, 0, 0, 0}
nv_write analog_sid_lock {3, 0, 0, 0, 0, 0, 0}
; Analog first paging channel
print "Programming Analog First Paging Channel"
nv_write analog_firstchp {0, 334} ; Set for the preferred carrier
nv_write analog_firstchp {1, 334}
nv_write analog_firstchp {2, 334}
nv_write analog_firstchp {3, 334}
; Analog home SID
print "Programming Analog Home SID"
nv_write analog_home_sid {0, 4} ; Set to the preferred carrier SID
nv_write analog_home_sid {1, 0}
nv_write analog_home_sid {2, 0}
nv_write analog_home_sid {3, 0}
; Analog registration setting
print "Programming Analog Registration setting"
nv_write analog_reg {0, "whereabouts known"}
nv_write analog_reg {1, "whereabouts known"}
nv_write analog_reg {2, "whereabouts known"}
nv_write analog_reg {3, "whereabouts known"}
AXESSTEL Proprietary 119
AXESSTEL Software User's Guide Contents
; Primary CDMA Channels for A carrier and B carrier
; CDMA channels are NOT allowed to be 0 anymore
print "Programming Primary CDMA Channel"
nv_write pcdmach {0, 400, 400} ; A and B primary CDMA channels
nv_write pcdmach {1, 283, 384}
nv_write pcdmach {2, 283, 384}
nv_write pcdmach {3, 283, 384}
; Secondary CDMA Channel
print "Programming Secondary CDMA Channel"
nv_write scdmach {0, 201, 201} ; set only if secondary channels
; offered
nv_write scdmach {1, 691, 777}
nv_write scdmach {2, 691, 777}
nv_write scdmach {3, 691, 777}
; Primary PCN Channel
; PCN channels aren’t being restricted to non-zero.
; Setting these channels is only effective for the "old-style"
; system acquisition in PCS. They are replaced by the Preferred
; Roaming List in the new method.
;print "Programming Preferred Roaming List"
;pr_list_wr {0, "prl0.bin"}
;pr_list_wr {1, "prl1.bin"}
print "Programming Primary PCN Channel"
nv_write ppcnch {0, 177, 177} ; A and B primary PCN channels
nv_write ppcnch {1, 177, 177}
nv_write ppcnch {2, 177, 177}
nv_write ppcnch {3, 177, 177}
; Secondary PCN Channel
print "Programming Secondary PCN Channel"
nv_write spcnch {0, 177, 177} ; set only if secondary channels
; offered
nv_write spcnch {1, 177, 177}
nv_write spcnch {2, 177, 177}
nv_write spcnch {3, 177, 177}
; NAM Checksums must all be 0xffff
print "Programming NAM Checksums"
AXESSTEL Proprietary 120
AXESSTEL Software User's Guide Contents
nv_write nam_chksum {0, 0xffff}
nv_write nam_chksum {1, 0xffff}
nv_write nam_chksum {2, 0xffff}
nv_write nam_chksum {3, 0xffff}
; Authentication NAM items
; These are all zero now
; Authentication A Key
print "Programming Authentication NAM items"
nv_write a_key {0, 0x00000000, 0x00000000 }
nv_write a_key {1, 0x00000000, 0x00000000 }
nv_write a_key {2, 0x00000000, 0x00000000 }
nv_write a_key {3, 0x00000000, 0x00000000 }
; Authentication A key checksum
print "Programming Authentication A key checksums"
nv_write a_key_chksum {0, 0xffff}
nv_write a_key_chksum {1, 0xffff}
nv_write a_key_chksum {2, 0xffff}
nv_write a_key_chksum {3, 0xffff}
; SSD_Asp
print "Programming SSD_A"
nv_write ssd_a {0, 0x00000000, 0x00000000 }
nv_write ssd_a {1, 0x00000000, 0x00000000 }
nv_write ssd_a {2, 0x00000000, 0x00000000 }
nv_write ssd_a {3, 0x00000000, 0x00000000 }
; SSD_Asp checksum
print "Programming SSD_A checksums"
nv_write ssd_a_chksum {0, 0xffff}
nv_write ssd_a_chksum {1, 0xffff}
nv_write ssd_a_chksum {2, 0xffff}
nv_write ssd_a_chksum {3, 0xffff}
; SSD_Bsp
print "Programming SSD_Bsp"
nv_write ssd_b {0, 0x00000000, 0x00000000 }
nv_write ssd_b {1, 0x00000000, 0x00000000 }
nv_write ssd_b {2, 0x00000000, 0x00000000 }
nv_write ssd_b {3, 0x00000000, 0x00000000 }
AXESSTEL Proprietary 121
AXESSTEL Software User's Guide Contents
; SSD_Bsp checksum
print "Programming SSD_Bsp checksums"
nv_write ssd_b_chksum {0, 0xffff}
nv_write ssd_b_chksum {1, 0xffff}
nv_write ssd_b_chksum {2, 0xffff}
nv_write ssd_b_chksum {3, 0xffff}
; MIN items
; The 2 MIN1s for each NAM, in order from 0 to 1
; THESE ITEMS MUST BE SUPPLIED FOR EACH USE
; Notice that because the MIN1 contains a ’-’, it is actually a
; string, not a number. The double quotes distinguish it from a
; number.
;
; The first MIN in each NAM is the analog MIN, the second MIN in
; each NAM is the CDMA MIN
; One active min in NAM0, no active mins in NAM1, NAM2, or NAM3
print "Programming MIN1"
nv_write min1 {0, "925-9885", "625-1272"}
nv_write min1 {1, "0000000", "0000000"}
nv_write min1 {2, "0000000", "0000000"}
nv_write min1 {3, "0000000", "0000000"}
; The 4 MIN2s for each NAM, in order from 0 to 3
; THESE ITEMS MUST BE SUPPLIED FOR EACH USE
print "Programming MIN2"
nv_write min2 {0, "619", "619"} ; NAM 0 has one active MIN2, 619
nv_write min2 {1, "000", "000"} ; NAM 1
nv_write min2 {2, "000", "000"}
nv_write min2 {3, "000", "000"}
; NV_IMSI_MCC_I,
print "Programming Mobile Country Code"
nv_write imsi_mcc {0, "310"}
nv_write imsi_mcc {1, "000"}
nv_write imsi_mcc {2, "000"}
nv_write imsi_mcc {3, "000"}
; NV_IMSI_11_12_I,
Sample Script Files
AXESSTEL Proprietary 122
AXESSTEL Software User's Guide Contents
print "Programming Mobile Network Code"
nv_write imsi_11_12 {0, "00"}
nv_write imsi_11_12 {1, "00"}
nv_write imsi_11_12 {2, "00"}
nv_write imsi_11_12 {3, "00"}
; MOB_TERM_HOME registration flag
print "Programming MOB_TERM_HOME"
nv_write mob_term_home {0, true, true}
nv_write mob_term_home {1, true, true}
nv_write mob_term_home {2, true, true}
nv_write mob_term_home {3, true, true}
; MOB_TERM_FOR_SID registration flag
print "Programming MOB_TERM_FOR_SID"
nv_write mob_term_for_sid {0, true, true}
nv_write mob_term_for_sid {1, true, true}
nv_write mob_term_for_sid {2, true, true}
nv_write mob_term_for_sid {3, true, true}
; MOB_TERM_FOR_NID registration flag
print "Programming MOB_TERM_FOR_NID"
nv_write mob_term_for_nid {0, true, true}
nv_write mob_term_for_nid {1, true, true}
nv_write mob_term_for_nid {2, true, true}
nv_write mob_term_for_nid {3, true, true}
; ACCOLCp
print "Programming ACCOLCp"
nv_write accolc {0, 0, 0}
nv_write accolc {1, 0, 0}
nv_write accolc {2, 0, 0}
nv_write accolc {3, 0, 0}
; CDMA SID/NID pairs
; SID/NIDs come in pairs, 4 pairs for each NAM/MIN
; combination. The first parameter in the braces is
; NAM, the second is the MIN, the rest are SID, NID
; pairs. All non-zero SIDs have to have the same
; even/odd parity.
; SID of 0 is "undefined SID",
AXESSTEL Proprietary 123
AXESSTEL Software User's Guide Contents
; NID of 0xffff is "any NID"
;
; Only the CDMA (MIN=1) sid_nid is programmed.
; The analog one has no meaning.
print "Programming SID/NID pairs"
nv_write sid_nid {0, 1, 1,0xffff, 0,0, 0,0, 0,0}
nv_write sid_nid {1, 1, 1,0xffff, 0,0, 0,0, 0,0}
nv_write sid_nid {2, 1, 1,0xffff, 0,0, 0,0, 0,0}
nv_write sid_nid {3, 1, 1,0xffff, 0,0, 0,0, 0,0}
; MIN checksum
print "Programming MIN checksums"
nv_write min_chksum {0, 0xffff, 0xffff}
nv_write min_chksum {1, 0xffff, 0xffff}
nv_write min_chksum {2, 0xffff, 0xffff}
nv_write min_chksum {3, 0xffff, 0xffff}
; Supply a winning banner
print "Programming banner"
nv_write banner { "AXESSTEL" }
; Done
nv_write curr_nam {0}
print "End of Service Programming"
;closelog
Call origination test scripts These three sample files set up and tear down multiple
mobile-originated phone calls. ;================================================================
; Name:
; orig.scr
; Description:
; This script will originate 100 mobile to land calls and generate
; binary and text log files for post-processing analysis.
; USAGE: The ’orig.scr’, ’dial10.scr’ and ’dial.scr’ text files
; should be present in the PST working directory. The phone
; should have service and be connected to the PST via
; the data cable. From the PST <F8> command line prompt,
AXESSTEL Proprietary 124
AXESSTEL Software User's Guide Contents
; type "run orig.scr" to start the script. After the script
; completes, quit the PST (Ctrl-<F10>) and rename the
; ’orig.log’ ASCII text file to a unique file name. The text
; file may be viewed immediately. The binary log file requires
; post-processing with the NPAR parsing utility.;
; Dependencies:
; This script file calls the ’dial10.scr’ and ’dial.scr’ scripts.
; Copyright (c) 2002 by AXESSTEL Incorporated. All Rights Reserved.
;================================================================
; EDIT HISTORY FOR SCRIPT
; This section contains comments describing changes made to this
; file. Changes are listed in reverse chronological order.
;when who what, where, why
;------ --- ------------------------------------------------
;================================================================
print "Starting Origination script..."
print " "
; Clear all of the phone’s error log entries.
err_clr 255
; Set an appropriate log mask for Axesstel phone and WLL phones.
; NOTE: The PST logging feature requires the NPAR post-processing
; tool to parse the binary file into readable ASCII text format.
logmask 0x0058c9f0
wait 1
logging on
; Record the script messages that scroll by on the <F8> screen.
; Viewable in the ’orig.log’ ASCII text file when the script
; completes.
wait 1
openlog orig.log
; Clear the Paging/Access/Traffic parameters stored by the phone.
; These values can also be viewed in real-time via the
; alt-<F4> <F5> <F6> <F7> CAIT screens.
parm_set -1 0
; Scripts may be called from within the running script (nested up
; to 5 deep).
AXESSTEL Proprietary 125
AXESSTEL Software User's Guide Contents
; Here, the effect achieves 100 call originations.
; OPTION: Comment out ’run dial10.scr’ lines to reduce the desired
; number of script originations.
Sample Script Files
run dial10.scr
print "*** 10 calls complete ***"
;run dial10.scr
print "*** 20 calls complete ***"
;run dial10.scr
print "*** 30 calls complete ***"
;run dial10.scr
print "*** 40 calls complete ***"
;run dial10.scr
print "*** 50 calls complete ***"
;run dial10.scr
print "*** 60 calls complete ***"
;run dial10.scr
print "*** 70 calls complete ***"
;run dial10.scr
print "*** 80 calls complete ***"
;run dial10.scr
print "*** 90 calls complete ***"
;run dial10.scr
print "*** 100 calls complete ***"
; Retrieve the Paging/Access/Traffic statistics.
print " "
print "**********Retrievable Phone Parameters*******************"
parm_get all
print "*********************************************************"
; Turn the PST binary logging off (equivalent to alt-L)
logging off
; Save the <F8> text log (’orig.log’) to the PST working
; directory.
timestamp
closelog
; Retrieve the phone’s error logs. If abnormal phone behavior is
AXESSTEL Proprietary 126
AXESSTEL Software User's Guide Contents
; encountered,
; these logs may prove useful to the phone development team. "F"
; indicates a
; fatal error that should be forwarded to the AXESSTEL Subscriber
; Hotline.
err_get
print " "
print "* Press Ctrl-<F10> to quit PST. The binary log file will be saved.
*"
print " "
print "* Remember to rename the ’orig.log’ text file to a unique filename.
*"
print " "
Print " *** Script completed !!! ***"
; Audible alert that script has completed (requires the computer’s
; speaker volume to be on.
; OPTION: Use the ’key’ command to general keypad audio at the phone
; (requires the phone’s Key Beep audio level to be on.
beep
beep
beep
beep
;================================================================
; Name:
; dial10.scr
; Description:
; This script will originate ten MtoL calls.
; Dependencies:
; This script file:
; - is called by ’orig.scr’
; - calls ’dial.scr’
; Copyright (c) 2002 by AXESSTEL Incorporated. All Rights Reserved.
;================================================================
; EDIT HISTORY FOR SCRIPT
; This section contains comments describing changes made to this
; file. Changes are listed in reverse chronological order.
AXESSTEL Proprietary 127
AXESSTEL Software User's Guide Contents
;when who what, where, why
;------ --- ------------------------------------------------
;02/11/97 sf Initial (commented) release
;================================================================
run dial.scr
run dial.scr
run dial.scr
run dial.scr
run dial.scr
run dial.scr
run dial.scr
run dial.scr
run dial.scr
run dial.scr
;================================================================
; Name:
; dial.scr
; Description:
; This script will originate one MtoL call.
; Dependencies:
; This script file:
; - is called by ’dial10.scr’ directly
; - is called by ’orig.scr’ indirectly
; Copyright (c) 2002 by AXESSTEL Incorporated. All Rights Reserved.
;================================================================
; EDIT HISTORY FOR SCRIPT
; This section contains comments describing changes made to this
; file. Changes are listed in reverse chronological order.
;when who what, where, why
;------ --- ------------------------------------------------
;================================================================
cls
print "Originating call..."
print " "
timestamp
pilot_sets
AXESSTEL Proprietary 128
AXESSTEL Software User's Guide Contents
; Change the dial string and service option as needed for making
; these CDMA service options. Typing ’help dial’ on the <F8>
; command line will provide these dialing options for originating
; a call to the given phone number:
; SRV_OPT COMMENTS
; V IS-96A voice (AMPS voice call when in analog mode)
; V96 IS-96 voice
; M "old" 8K Markov
; M13 "new" 13K Markov
; M8 "new" 8K Markov
; LB 8K Loopback
; LB13 13K Loopback
dial "555-1212" M13
; Modify the ’wait’ command as required to obtain desired call
; duration.
; The phone_state command is repeated to see call setup
; progression.
print "Waiting to assure call-setup..."
phone_state
wait 5
phone_state
wait 5
phone_state
wait 5
phone_state
Sample Script Files
; ’get_screen’ is not applicable for phones with no UI display
; capability, such as wireless local loop (WLL) phones !
print "Getting screen and phone state..."
timestamp
get_screen
phone_state
; Modify the ’wait’ command as required to obtain MS Idle State
; duration.
print "Terminating call..."
dial_end
AXESSTEL Proprietary 129
AXESSTEL Software User's Guide Contents
print "Waiting to assure call tear-down..."
wait 8
print " "
print "-----------------------------------------------"
print " "
NAM Programming scripts This sample files set up NAM Information field of phone calls. ;================================================================
; print "+----------------------------------+"
; print "| File Name : A2_NAM.scr |"
; print "| Made by : Axesste.com |"
; print "| Version : 1.00 |"
; print "| Date : 02/06/2003 |"
; print "+----------------------------------+"
; ---------------------------------------------
; 1. Initialized Service Programming Conditions
; ---------------------------------------------
print " 1. Initialized Service Programming Conditions"
; cls
; Put the DMSS in offline digital mode
; mode offline-d
; wait 3
; Enter the Service Programming Code (factory defaulted to 000000)
; Write Service Programming Code
; SPC "000000"
; password "0000000000000000"
; -----------------------------------------------
; 2. Programming System Configuration Parameters
AXESSTEL Proprietary 130
AXESSTEL Software User's Guide Contents
; -----------------------------------------------
print " 2. Programming System Configuration Parameters"
; Write NEW ESN
nv_write esn {0x65c6163e} ; Electronic Serial Number
; Write Station Class Mark
nv_write scm { 0x2a } ;Station Class
Mark
; Write Slot Cycle Index
nv_write slot_cycle_index {2}
; -----------------------------------------------
; 3. Programming NAM Dependent Parameters
; -----------------------------------------------
print " 3. Programming NAM Dependent Parameters"
; Current NAM
nv_write curr_nam {0}
; NAME_NAM
nv_write name_nam {0," A2 "}
; NAM Checksums must all be 0xffff
nv_write nam_chksum {0, 0xffff}
; -----------------------------------------------
; 4. Programming Channel Information
; -----------------------------------------------
print " 4. Programming Channel Information"
; Primary CDMA Channel
; nv_write pcdmach {0, 29, 111} ;Cellular Primary Channel
; Secondary CDMA Channel
AXESSTEL Proprietary 131
AXESSTEL Software User's Guide Contents
; nv_write scdmach {0, 779, 738} ;Cellular Secondary Channel
; -----------------------------------------------
; 5. Programming Mobile Country Code
; -----------------------------------------------
print " 5. Programming Mobile Country Code "
; Mobile Country Code
nv_write imsi_mcc {0,"450"} ; Mobile Country Code -
Korea : 450
; Programming IMSI Mobile Network Code
nv_write imsi_11_12 {0,0} ; Mobile network code
; -----------------------------------------------
; 9. Programming CDMA MIN for each NAM
; -----------------------------------------------
print " 9. Programming CDMA MIN for each NAM"
; Programming MIN1
nv_write min1 {0, "277-3065", "277-3066"} ;MIN1(Tell No) Test phone Samsung SCH-X350
; print "Programming MIN1(IMSI_T_S1)" ; artken
; nv_write imsi_t_s1 {0, "277-3066", "277-3066"}
; Programming MIN2
nv_write min2 {0, "119", "119"} ;MIN2(Tell No)
; MIN checksum
nv_write min_chksum {0, 0xffff, 0xffff}
; Programming Dial number for UI
AXESSTEL Proprietary 132
AXESSTEL Software User's Guide Contents
nv_write dir_number {0, "1192773065"}
; -----------------------------------------------
; 10. Programming CDMA etc. Parameters
; -----------------------------------------------
print " 10.Programming CDMA etc. Parameters"
; MOB_TERM_HOME registration flag
nv_write mob_term_home {0, true, true}
; MOB_TERM_FOR_SID registration flag
nv_write mob_term_for_sid {0, true, true}
; MOB_TERM_FOR_NID registration flag
nv_write mob_term_for_nid {0, true, true}
; ACCOLCp
nv_write accolc {0, 0x5, 0x6} ; genarally write last number of min1
; -----------------------------------------------
; xx. etc
; -----------------------------------------------
; Back to the Future
; nv_write cdma_enc_btf 0x00000C95
; nv_write pcs_enc_btf 0x00000C94
mode reset
; print "The end A2_NAM"
AXESSTEL Proprietary 133