Professional Documents
Culture Documents
AxesstelPst Manual
AxesstelPst Manual
Contents
AXESSTEL
CDMA Technology 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
AXESSTEL
Proprietary
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
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
5 Troubleshooting................................................................................. 5
Appendix
NV Scripts command.............................................................................A SCAN_CONFIG Parameters..................................................................B Sample Script Files................................................................................C
AXESSTEL Proprietary
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.
_ Communication _ Overview
_ Description
AXESSTEL
Proprietary
Contents
AXESSTEL
Proprietary
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 An OS higher than Microsoft Windows 95 is required to run Axesstel PST.
NOTE
PST installer program required which enables PST to run for a specified period of time
You need following accessories: - PC running PST - Axesstel Wireless Phone - UART COM Port - COM Port - RS-232 Cable provided by Axesstel.
AXESSTEL
Proprietary
Contents
AXESSTEL
Proprietary
Contents
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
Contents
AXESSTEL
Proprietary
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 WLL products Mobile phones Hybrid products Model Name A2 E2 W2
AXESSTEL
Proprietary
10
Contents
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 41 PST status window)
AXESSTEL
Proprietary
11
Contents
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
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
_ IS-2000 _ IS-2000
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
_ IS-95A _ IS-95B
AXESSTEL
Proprietary
13
Contents
_ IS-95B
_ IS-2000 _ IS-2000
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
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 signals 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
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 _ Download _ Backup
software to a phone from a Axesstel Phone Image (.HEX) file software to a phone from a Axesstel Phone Image (.BIN) file
To start Download, Select menu -> window-> Download. The first window, as shown in Figure 42, appears.
AXESSTEL
Proprietary
16
Contents
17
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
18
Contents
To back up a phones 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.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
Contents
Figure 43 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 ESN_CHKSUM VERNO_MAJ VERNO_MIN Electronic Serial Number Electronic Serial Number checksum NV Major version number NV Minor version number
* Permanent physical station configuration parameters. SCM SLOT_CYCLE_INDEX MOB_CAI_REV MOB_FIRM_REV MOB_MODEL CONFIG_CHKSUM SCMp Slot cycle index Mobile CAI revision number Mobile firmware revision number Mobile model Checksum of physical configuration parameters Each of these is associated with a The NAM id is
* 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 CDMA_PREF_SERV ANALOG_PREF_SERV CDMA_SID_LOCK CDMA_SID_ACQ ANALOG_SID_LOCK ANALOG_SID_ACQ ANALOG_FIRSTCHP ANALOG_HOME_SID DigitalAnalog mode preference CDMA preferred serving system (AB) Analog preferred serving system (AB) CDMA SID(s) to lockout CDMA SID to acquire ANALOG SID(s) to lockout ANALOG SID to acquire Analog FIRSTCHPp Analog HOME_SIDp
AXESSTEL Proprietary
20
Contents
Analog registration setting Primary CDMA channel Secondary CDMA channel Primary PCN channel Secondary PCN channel NAM checksum
* Authentication NAM items. * specified in the request. A_KEY A_KEY_CHKSUM SSD_A SSD_A_CHKSUM SSD_B SSD_B_CHKSUM COUNT * MIN items.
Authentication A key Authentication A key checksum SSD_Asp SSD_Asp checksum SSD_Bsp SSD_Bsp checksum COUNTsp Each of these is associated with a particular MIN within The MIN id itself is When operating in analog mode the first MIN
* the NAM (there are up to 2 MINs per NAM). * specified in the request. * is the one and only meaningfull one. MIN1 MIN2 MOB_TERM_HOME MOB_TERM_FOR_SID MOB_TERM_FOR_NID ACCOLC SID_NID MIN_CHKSUM * Operational NAM settings. MIN1p MIN2p
CDMA MOB_TERM_HOMEp registration flag CDMA MOB_TERM_FOR_SIDp registration flag CDMA MOB_TERM_FOR_NIDp registration flag ACCOLCp CDMA SIDNID pairs MIN checksum
AXESSTEL
Proprietary
21
Contents
Current NAM Call origination MIN within NAM Select NAM automatically on roaming A user selectable name for each NAM
* Semi-permanent analog registration parameters. NXTREG LSTSID LOCAID PUREG Holds the registration count per CAI section 2.3.4.1. SIDsp (last SID registered) LOCAIDsp PUREGsp
* Semi-permanent CDMA registration and channel parameters. ZONE_LIST SID_NID_LIST DIST_REG LAST_CDMACH ZONE_LISTsp SID_NID_LISTsp Distance registration variables Last CDMA channel acquired
* Timers, each associated with a specific NAM. CALL_TIMER AIR_TIMER ROAM_TIMER LIFE_TIMER Last call time Air time (resettable cummulative call timer) Roam time (resettable cummulative roam 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 STACK STACK_IDX Speed dial number Call stack number Call stack last number index
AXESSTEL Proprietary
22
Contents
REDIAL * Telephone pages (obsolete). PAGE_SET PAGE_MSG * Volumes. EAR_LEVEL SPEAKER_LEVEL RINGER_LEVEL BEEP_LEVEL * Tones. CALL_BEEP CONT_KEY_DTMF CONT_STR_DTMF SVC_AREA_ALERT CALL_FADE_ALERT * Various phone settings. BANNER LCD AUTO_POWER AUTO_ANSWER AUTO_REDIAL AUTO_HYPHEN BACK_LIGHT AUTO_MUTE * Locks and restrictions values. MAINTRSN Base station maintance required reason
AXESSTEL Proprietary
Handset ear piece volume level Handsfree speaker volume level Ringer volume level Key beep volume level
One minute call beeper select Continuous keypad DTMF tones select Continuous string (memory) DTMF tones select Service area enterexit alert select Call fade alert select
Idle banner to display Display brightness setting Auto power settings (power savings) Auto answer setting Auto redial setting Auto hyphen setting Backlighting manualauto mode Auto radio mute setting
23
Contents
LCKRSN_P LOCK LOCK_CODE AUTO_LOCK CALL_RSTRC SEC_CODE HORN_ALERT * Error log. ERR_LOG * Miscellaneous items. UNIT_ID FREQ_ADJ * V Battery MinMax. VBATT * Audio Adjustment values VOC_GAIN * Spare items (2) for developer SPARE_1 SPARE_2 * Data Services items DATA_IO_MODE DATA_MODE_ENABLED DATA_MODE_ENABLED IDLE_DATA_TIMEOUT
Base station lock reason, until power cycled Indicator of whether user locked the phone Lock code string Auto lock setting Call restrictions Security code Horn alert setting
Error log
Unit hardware id
(obsolete) (obsolete)
External port (IO) mode for Data svc Data Service(Task) EnabledDisabled Data service idle time in seconds
AXESSTEL Proprietary
24
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 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
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 IMSI_ADDR_NUM IMSI_T_ADDR_NUM ASSIGNING_TMSI_ZONE_LEN ASSIGNING_TMSI_ZONE TMSI_CODE TMSI_EXP HOME_PCS_FREQ_BLOCK * Roaming List and MRU Table. ROAMING_LIST The roaming list
AXESSTEL Proprietary
OBSOLETE InternationaMobileStationID Length of IMSI TMSI_ZONE_LENs-p TMSI_ZONEs-p TMSI_CODEs-p TMSI expiration time Subscriber's home block Directory number, PCS format
26
Contents
MRU_TABLE MRU2_TABLE LIFE_TIMER_G CALL_TIMER_G OTKSL TIMED_PREF_MODE RINGER_TYPE ANY_KEY_ANSWER BACK_LIGHT_HFK RESTRICT_GLOBAL KEY_SOUND DIALS_SORTING_METHOD LANGUAGE_SELECTION MENU_FORMAT RINGER_SPKR_LVL BEEP_SPKR_LVL VIBRATOR FLIP_ANSWERS DIAL_RESTRICT_LVLS DIAL_STATE_TABLE_LEN DIAL_STATE_TABLE VOICE_PRIV_ALERT DATA_QNC_ENABLED DATA_SO_SET UP_LINK_INFO UP_KEY UP_PARMS UP_CACHE ELAPSED_TIME PDM2 VBATT_AUX DTACO_CONTROL DTACO_INTERDIGIT_TIMEOUT PDM1 BELL_MODEM SID_NID_LOCK
One-time keypad subsidy lock To allow analog-only operation Ringer type setting Answer call with any key Hands Free Kit backlight setting Global phone book restriction Type of keypress sound emitted Phone book sorting method Language for user interface Type of user interface menus External speaker ringer volume External speaker key beep volume Use vibrator instead of ringer Opening clamshell answers call ISS2 dialing restriction levels Number elements in state table ISS2 dialing plan state table Voice privacy alert for TGP QNC enabled flag Which Service Option set is in effect IP addresses and key data Current gateway, alert state, etc. The Unwired Planet cache Timer for formal test use For RF Cal use Auxillary VBATT min-max DTACO enableddisabled control DTACO interdigit timeout For RF Cal use Flag for ISS2 CDMA SID(s) and NID(s) to lockout
AXESSTEL Proprietary
27
Contents
PRL_ENABLED SYSTEM_PREF HOME_SID_NID OTAPA_ENABLED NAM_LOCK IMSI_T_S1 IMSI_T_S2 UP_ALERTS UP_IDLE_TIMER SMS_UTC ROAM_RINGER RENTAL_TIMER RENTAL_TIMER_INC RENTAL_CNT RENTAL_TIMER_ENABLED FULL_SYSTEM_PREF BORSCHT_RINGER_FREQ PAYPHONE_ENABLE DSP_ANSWER_DET_ENABLE EVRC_PRI AFAX_CLASS_20 V52_CONTROL CARRIER_INFO AFAX SIO_PWRDWN PREF_VOICE_SO SMS_AUTO_DELETE SRDA_ENABLED OUTPUT_UI_KEYS POL_REV_TIMEOUT SI_TEST_DATA_1 SI_TEST_DATA_2 SPC_CHANGE_ENABLED DATA_MDR_MODE DATA_PKT_ORIG_STR DATA_AUTO_PACKET_DETECTION
If the roaming list is enabled or not System Preference, per NAM "Home" SIDNID list Whether OTAPA is enabled, per NAM SPASM protection per NAM True IMSI - MIN1 True IMSI - MIN2 Unwired Planet alert records Idle time timer Specifies format of SMS time display Specifies roam ringer on or off The rental timer item The rental timer increment value The rental counter Enablesdisables the rental timer Controls system pref display options Ringer freq used for BORSCHT port (RJ-11) Enabledisable payphone support Enabledisable dsp answer detection EVRC13K priority: EVRC first, 13K first Obsolete item V52 control option Bitmap and ASCII name info for carrier Analog FAX type: end to end or class 2.0 Distinguishes oldnew UART hardware EVRC voice service options SMS auto-deletion enabled status Silent redial enabled status Enable-disable sending UI keystrokes Timeout for polarity reversal First stack-checker diagnostic buffer Second stack-checker diagnostic buffer Enable-disable OTASP SPC change Dial string for originating packet calls Packet data configuration item
Proprietary
AXESSTEL
28
Contents
ROAM_MSG SMS_REMINDER_TONE PAP_USER_ID PAP_PASSWORD SMS_BC_SERVICE_TABLE_SIZE SMS_BC_SERVICE_TABLE SMS_BC_CONFIG SMS_BC_USER_PREF PREF_FOR_RC DS_DEFAULT_BAUD PRIMARY_DNS SECONDARY_DNS DNS Server DATA_SCRM_ENABLED DATA_TRTL_ENABLED
Downloadable roaming messages Reminder tone is on or off User_ID for Password Auth. Protocol Actual password for PAP
IS2000 CAI radio configuration RC preference DATA SERVICES default SIO baud rate Contains the IP Address of the DNS Server Contains the IP Address of the Secondary Enablesdisables the mobile's ability to SCRM 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
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.
30
Contents
Figure 46-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
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.
AXESSTEL
Proprietary
32
Contents
AXESSTEL
Proprietary
33
Contents
34
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.
AXESSTEL
Proprietary
35
Contents
AXESSTEL
Proprietary
36
Contents
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)
4.5.2 KEY
AXESSTEL Proprietary
37
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
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 phones 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
Contents
AXESSTEL
Proprietary
40
Contents
41
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.
AXESSTEL
Proprietary
42
Contents
AXESSTEL
Proprietary
43
Contents
44
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 PCS (using blocks) Select A, B, or Both under Ch 1. 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
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
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
AXESSTEL
Proprietary
46
Contents
47
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
48
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
49
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 46-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
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
51
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.
52
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 47-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.
53
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 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 The picture in Figure 46-3 Dm log file If you installed AxesstelPst in the c:\program\AxesstelPst, LOG directory is located in
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
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.
Figure 49 CAI MSG Window Item Description Current Log File File Name Name of the log file being written
AXESSTEL Proprietary
55
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 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 MSGs 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
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.
57
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.
58
Contents
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
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
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
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
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
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
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.
65
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 phones 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
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 BarWindow 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
67
Contents
buffer overflow.
68
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 focusas 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 lists 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 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
receives
69
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 its no longer available to be displayed in the Log Message Inspector window.
AXESSTEL Proprietary
70
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
AXESSTEL
Proprietary
71
Contents
AXESSTEL
Proprietary
72
Contents
73
Contents
5 Troubleshooting
This chapter shows several situations you might encounter while using AxesstelPST and solutions to try.
AXESSTEL
Proprietary
74
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.
75
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
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: 07 arg_2=volume level for hands-free kit (HFK) speaker: 07 2 Set ringer volume arg_1=volume level for handset: 07 arg_2=volume level for hands-free kit (HFK) speaker: 07 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: 03 for beep or voice beep, 07 for voice arg_6=volume level for hands-free kit (HFK) speaker: 07 for beep or voice beep, 03 for voice arg_7=DTMF path: 0=play locally, 1=transmit, 2=play locally and transmit, 3=mute
AXESSTEL Proprietary
77
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: 03 for beep or voice beep, 07 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
78
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
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
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
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
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.
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
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
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
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
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
AXESSTEL
Proprietary
86
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
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
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,
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].
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
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
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
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
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 phones 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 (09, AF), representing the 8-byte password of the phone.
Syntax password password Example password 0123456789abcdef Response The security password of 0x0123456789abcdef is sent to the
PAUSE
Stops reading commands from the script file until a keystroke is entered.
AXESSTEL Proprietary
92
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
_ Analog
Waiting for Order, Waiting for Answer, Conversation, Release, System Access
_ CDMA
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
Contents
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 |
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
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
AXESSTEL
Proprietary
95
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
SCAN_CONFIG
Lets you alter the Pilot Scanners 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
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 systems 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=160s
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
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
AXESSTEL
Proprietary
97
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 peaks 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.
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 phones programmable memory.
AXESSTEL Proprietary
98
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). E1E4 Four largest energy peakss Ec/Io found in the search window. P1P4 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
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_RF_CNTL
The Retriever Pilot Scanner can be service programmed with CDMA channels like a normal commercial phone. However, the
AXESSTEL Proprietary
99
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 Retrievers 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 sectors 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
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
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
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
SER_RESET
Resets the Symbol Error Rate (SER) statistics.
Syntax ser_reset Example ser_reset Response Resets the SER counters.
SET_EXT_INT_TYPE
Sets the type of interrupt (02). This command is for Module targets only.
Syntax set_ext_int_type 0 | 1 | 2
SETEXT_RSSI
Sets the sensitivity and range of RSSI reporting for both CDMA and analog modes. This command is for Module targets only.
Syntax setext_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
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
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
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
Contents
max_num_sup_ch is the maximum number of supplemental channels you are specifying, 07.
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.
SLEEP
AXESSTEL Proprietary
104
Contents
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
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
Contents
handoff parameters together. The user must override all of them together.
_ Retriever
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 users 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 015. 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
106
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 handsets 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
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.
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
VERSION_REQUEST
Returns the information in the Version Number Response Packet which is similar to what is displayed in PSTs Mobile Version i
AXESSTEL Proprietary
108
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
109
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.
For example, if the current serving system Active pilot is PN=356 and increment parameter incr=1, Retrievers 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...
The search pattern returns to the Active serving systems 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
Contents
cells 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
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
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).
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 Scanners
AXESSTEL Proprietary
112
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
Contents
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 (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 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 peaks 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
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
weed out searches. Retriever will not log searches whose energy is below that threshold.
_ If
higher threshold than T_DROP) is used. Retriever will not log searches whose energy is below that threshold.
_ If
AXESSTEL
Proprietary
115
Contents
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
Contents
; 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
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 dont 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
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
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 arent 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
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
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
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
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
AXESSTEL
Proprietary
124
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 phones 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
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 phones error logs. If abnormal phone behavior is
AXESSTEL
Proprietary
126
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 computers ; speaker volume to be on. ; OPTION: Use the key command to general keypad audio at the phone ; (requires the phones 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
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
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
Contents
print "Waiting to assure call tear-down..." wait 8 print " " print "-----------------------------------------------" print " "
; print "+----------------------------------+"
; --------------------------------------------; 1. Initialized Service Programming Conditions ; --------------------------------------------print " 1. Initialized Service Programming Conditions"
cls
; Enter the Service Programming Code (factory defaulted to 000000) ; Write Service Programming Code ; ; SPC "000000" password "0000000000000000"
AXESSTEL
Proprietary
130
Contents
; Write Station Class Mark nv_write scm { 0x2a } Mark ;Station Class
; ----------------------------------------------; 3. Programming NAM Dependent Parameters ; ----------------------------------------------print " 3. Programming NAM Dependent Parameters"
; Primary CDMA Channel ; nv_write pcdmach {0, 29, 111} ;Cellular Primary Channel
AXESSTEL
Proprietary
131
Contents
; ----------------------------------------------; 5. Programming Mobile Country Code ; ----------------------------------------------print " 5. Programming Mobile Country Code "
; Mobile Country Code nv_write imsi_mcc Korea : 450 {0,"450"} ; Mobile Country Code -
; 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
; artken
AXESSTEL
Proprietary
132
Contents
; ----------------------------------------------; 10. Programming CDMA etc. Parameters ; ----------------------------------------------print " 10.Programming CDMA etc. Parameters"
; 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
AXESSTEL
Proprietary
133