Arm Logel User Guide Issue 01 (2010 - 03 - 09) Spreadtrum Communications Inc. i ArmLogel User Guide Version: 1.0. 0 DocCode: SW - BASE - UG - 000 3 Date: Mar ch 1 9 , 20 1 15 www.spreadtr um.com Arm Logel User Guide ii Spreadtrum Communications Inc. Issue 01 (2010 - 03 - 09) I mportant Notice C opyright Notice Copyri ght © 2007 - 2010 , Spreadtrum Communications, Inc. All rights reserved. T rademarks Spreadtrum Communications, Inc. and Spreadtrum Communications, Inc.'s products are exclusively owned by Spreadtrum Communications, Inc. References to other companies and their products use trademarks owned by the respective companies and are for reference purpose only. W arranty Disclaimer Spreadtrum Communications, Inc. makes no representations or warranties, either expressed or implied, by or with respect to anything in this d ocument, and shall not be liable for any implied warranties of merchantability or fitness for a particular purpose or for any indirect, special or consequential damages. C onfidentiality The information contained herein (including any attachments) is confid ential. The recipient hereby acknowledges the confidentiality of this document, and except for specific purposes, this document shall not be disclosed to any third party. Arm Logel User Guide Issue 01 (2010 - 03 - 09) Spreadtrum Communications Inc. iii About This Document Purpose T he ArmLogel User Guide describes the functions of ArmLog el and how to use it Intended Audience This document is intended for : ArmLogel development engineer Test engineer Organi z ation This document consists of three chapters and is organi z ed as follows Chapter Describes 1 Introduction Functions and file co mposition of ArmLogel 2 Interface Description Main interface, menu, toolbar , and status bar. 3 Operation Guide How to use ArmLogel Arm Logel User Guide iv Spreadtrum Communications Inc. Issue 01 (2010 - 03 - 09) Contents 1 Introduction ................................ ................................ ................................ ........................... 1 - 2 1.1 Functions ................................ ................................ ................................ ................................ ................ 1 - 2 1.2 File Composition ................................ ................................ ................................ ................................ .... 1 - 2 2 Interface Description ................................ ................................ ................................ ............ 2 - 3 2.1 Main Interface ................................ ................................ ................................ ................................ ........ 2 - 3 2.2 Menu ................................ ................................ ................................ ................................ ...................... 2 - 4 2 .3 Toolbar ................................ ................................ ................................ ................................ ................... 2 - 5 2.4 Status Bar ................................ ................................ ................................ ................................ ............... 2 - 7 3 Operation Guide ................................ ................................ ...... Error! Bookmark not defined. 3.1 Mode s ................................ ................................ ................................ ................................ .................... 3 - 8 3.1.1 Real - Time Mode ................................ ................................ ................................ ............................ 3 - 8 3.1.2 Playback Mode ................................ ................................ ................................ .............................. 3 - 8 3.2 Work Mode ................................ ................................ ................................ ................................ ............ 3 - 8 3.2.1 Four Work Modes ................................ ................................ ................................ .......................... 3 - 8 3.2.2 Playback Batch ................................ ................................ ................................ .............................. 3 - 9 3.3 Load DLL( TD/DM) ................................ ................................ ................................ ............................. 3 - 10 3.4 Configuration ................................ ................................ ................................ ................................ ........ 3 - 11 3.4.1 ARMLOGEL Config Dialog Box ................................ ................................ ................................ .. 3 - 11 3.4.2 Configuration File ................................ ................................ ................................ ........................ 3 - 14 3.5 Receiving Data ................................ ................................ ................................ ................................ ..... 3 - 14 3.5.1 Connecting ChannelServer ................................ ................................ ................................ ........... 3 - 14 3.5.2 Logging ................................ ................................ ................................ ................................ ....... 3 - 16 3.5.3 Status Information ................................ ................................ ................................ ....................... 3 - 17 3.6 Message Windows ................................ ................................ ................................ ................................ 3 - 17 3.6.1 Message Types ................................ ................................ ................................ ............................. 3 - 17 3.6.2 Log Message Window ................................ ................................ ................................ .................. 3 - 18 3.6.3 Message Decod ing Window ................................ ................................ ................................ ......... 3 - 23 3.6.4 Trace Message Window ................................ ................................ ................................ ............... 3 - 26 3.6.5 Log & Trace Window ................................ ................................ ................................ ................... 3 - 27 3.6.6 Air Message Window ................................ ................................ ................................ ................... 3 - 28 3.6.7 Cell Information Window ................................ ................................ ................................ ............. 3 - 29 3.6.8 GPRS Information Window ................................ ................................ ................................ ......... 3 - 32 Arm Logel User Guide Issue 01 (2010 - 03 - 09) Spreadtrum Communications Inc. v 3.6.9 Measurement Report Window ................................ ................................ ................................ ...... 3 - 32 3.6.10 Common MsgFlow Window ................................ ................................ ................................ ...... 3 - 33 3.6.11 MsgFlow Window ( TD/GSM ) ................................ ................................ ................................ .. 3 - 34 3.6.12 Engineer Mode Statistic Window( TD/GSM ) ................................ ................................ ............. 3 - 35 3.6.13 GSM Cell Measurement Window( TD/GSM ) ................................ ................................ ............ 3 - 35 3.6.14 TD Cell Measurement Window( TD/GSM ) ................................ ................................ ................ 3 - 36 3.7 Playing Back ArmLogel Files ................................ ................................ ................................ ............... 3 - 37 3.7.1 Playing Back a File ................................ ................................ ................................ ...................... 3 - 37 3.7.2 Playback orignal file ................................ ................................ ................................ .................... 3 - 39 3.7.3 Saving a File ................................ ................................ ................................ ................................ 3 - 40 3.7.4 File Types ................................ ................................ ................................ ................................ .... 3 - 41 3.8 Auxiliary Functions ................................ ................................ ................................ .............................. 3 - 45 3.8.1 Assert Information Window ................................ ................................ ................................ ......... 3 - 45 3.8.2 Filtering Messages ................................ ................................ ................................ ....................... 3 - 47 3.8.3 TD Filtering Messages( TD / DM) ................................ ................................ ................................ 3 - 48 3.8.4 Searching Messages ................................ ................................ ................................ ..................... 3 - 48 3.8.5 Message Decoding ................................ ................................ ................................ ....................... 3 - 52 3.8.6 AT Commands ................................ ................................ ................................ ............................. 3 - 54 3.8.7 Key Records ................................ ................................ ................................ ................................ 3 - 55 3.8.8 AutoTest ................................ ................................ ................................ ................................ ...... 3 - 56 3.8.9 Accelerator ................................ ................................ ................................ ................................ .. 3 - 58 Arm Logel User Guide Issue 01 (2010 - 03 - 09) Spreadtrum Communications Inc. vii Figure s Figure 2 - 1 GSM Main interface ................................ ................................ ................................ ................... 2 - 3 Figure 2 - 2 TD/DM Main interface ................................ ................................ ................................ ............... 2 - 3 Figure 2 - 3 About Spreadtrum ArmLogel dialog box ................................ ................................ ..................... 2 - 4 Figure 2 - 4 Window menu ................................ ................................ ................................ ............................ 2 - 5 Figure 2 - 5 Toolbar icons ................................ ................................ ................................ .............................. 2 - 5 Figure 3 - 1 Set work mode menu ................................ ................................ ................................ .................. 3 - 9 Figure 3 - 2 Set work mode menu: LOG - >Work Mode - >Playback Batch...: ................................ ................... 3 - 9 Figure 3 - 3 Browse directory dialog box : ................................ ................................ ................................ ... 3 - 10 Figure 3 - 4 Playback batch dialog box : ................................ ................................ ................................ ....... 3 - 10 Figure 3 - 5 Dll Settings dialog box : ................................ ................................ ................................ ............. 3 - 11 Figure 3 - 6 Log tab page ................................ ................................ ................................ ............................. 3 - 12 Figure 3 - 7 Save List File dialog box ................................ ................................ ................................ ........... 3 - 13 Figure 3 - 8 Filter tab page ................................ ................................ ................................ ........................... 3 - 14 Figure 3 - 9 IP Settings dialog box ................................ ................................ ................................ ............... 3 - 15 Figure 3 - 10 Status information ................................ ................................ ................................ ................... 3 - 17 Figure 3 - 11 Log message window ................................ ................................ ................................ .............. 3 - 18 Figure 3 - 12 Tiled windows ................................ ................................ ................................ ........................ 3 - 20 Figure 3 - 13 Recently viewed windows ................................ ................................ ................................ ....... 3 - 21 Figure 3 - 14 Special Window dialog box ................................ ................................ ................................ ..... 3 - 22 Figure 3 - 15 Previously defined tasks ................................ ................................ ................................ .......... 3 - 23 Figure 3 - 16 Message decoding window ................................ ................................ ................................ ..... 3 - 24 Figure 3 - 17 Message structure ................................ ................................ ................................ ................... 3 - 25 Figure 3 - 18 Message data ................................ ................................ ................................ .......................... 3 - 26 Figure 3 - 19 Trace message window ................................ ................................ ................................ ........... 3 - 27 Figure 3 - 20 SysInfo menu ................................ ................................ ................................ .......................... 3 - 27 Figure 3 - 21 Log & Trace dialog box ................................ ................................ ................................ .......... 3 - 28 Arm Logel User Guide viii Spreadtrum Communications Inc. Issue 01 (2010 - 03 - 09) Figure 3 - 22 Layer3 messages ................................ ................................ ................................ ..................... 3 - 29 Figure 3 - 23 Cell Information window ................................ ................................ ................................ ........ 3 - 30 Figure 3 - 24 Cell Info Config dialog box ................................ ................................ ................................ ..... 3 - 30 Figure 3 - 25 Cell information displayed by column ................................ ................................ ..................... 3 - 31 Figure 3 - 26 Cell information displayed by row ................................ ................................ ........................... 3 - 31 Figure 3 - 27 Cell information curves ................................ ................................ ................................ ........... 3 - 32 Figure 3 - 28 GPRS Information dialog box ................................ ................................ ................................ 3 - 32 Figure 3 - 29 Measurement Report (3G) dialog box ................................ ................................ ...................... 3 - 33 Fi gure 3 - 30 Common MsgFlow window ................................ ................................ ................................ .... 3 - 34 Figure 3 - 31 MsgFlow window ................................ ................................ ................................ ................... 3 - 35 Figure 3 - 32 Engineer Mode Statistic Window ................................ ................................ ............................ 3 - 35 Figure 3 - 33 GSM Cell Measurement Window ................................ ................................ ............................ 3 - 36 Figure 3 - 34 TD Cell Measurement Window ................................ ................................ ............................... 3 - 36 Figure 3 - 35 Opening a file ................................ ................................ ................................ ......................... 3 - 37 Figure 3 - 36 Playback Settings dialog box ................................ ................................ ................................ ... 3 - 38 Figure 3 - 37 Script setting dialog bo x ................................ ................................ ................................ .......... 3 - 39 Figure 3 - 38 Save as dialog box ................................ ................................ ................................ .................. 3 - 40 Figure 3 - 39 Save as dialog box ................................ ................................ ................................ .................. 3 - 4 0 Figure 3 - 40 List file ................................ ................................ ................................ ................................ ... 3 - 42 Figure 3 - 41 RLV file ................................ ................................ ................................ ................................ .. 3 - 43 Figure 3 - 42 Layer3 file ................................ ................................ ................................ .............................. 3 - 43 Figure 3 - 43 IP file ................................ ................................ ................................ ................................ ..... 3 - 44 Figure 3 - 44 CAP file ................................ ................................ ................................ ................................ 3 - 45 Figure 3 - 45 Assert Information window ................................ ................................ ................................ ..... 3 - 46 Figure 3 - 46 Save Assert Records to... dialog box ................................ ................................ ........................ 3 - 46 Figure 3 - 47 Log Filter dialog box ................................ ................................ ................................ .............. 3 - 47 Figure 3 - 48 TD Log Filter dialog box ................................ ................................ ................................ ........ 3 - 48 Figure 3 - 49 Find Message dialog box ................................ ................................ ................................ ......... 3 - 49 Figure 3 - 50 Find result dialog box ................................ ................................ ................................ ............. 3 - 50 Figure 3 - 51 CAI Message Decoding dialog box ................................ ................................ ......................... 3 - 53 Figure 3 - 52 AT Command dialog box ................................ ................................ ................................ ......... 3 - 54 Figure 3 - 53 Key Record Settings dialog box ................................ ................................ .............................. 3 - 55 Figure 3 - 54 Key Records dialog box ................................ ................................ ................................ .......... 3 - 56 Arm Logel User Guide Issue 01 (2010 - 03 - 09) Spreadtrum Communications Inc. ix Figure 3 - 55 Error message ................................ ................................ ................................ ......................... 3 - 56 Arm Logel User Guide Issue 01 (2010 - 03 - 09) Spreadtrum Communications Inc. 1 - 1 Tables Table 2 - 1 Toolbar icons ................................ ................................ ................................ ................................ 2 - 5 Table 3 - 1 Log tab page elements ................................ ................................ ................................ ................ 3 - 12 Table 3 - 2 Status information ................................ ................................ ................................ ...................... 3 - 17 Table 3 - 3 Message types ................................ ................................ ................................ ............................ 3 - 18 Table 3 - 4 Column description ................................ ................................ ................................ .................... 3 - 19 Table 3 - 5 SysInfo menu items ................................ ................................ ................................ .................... 3 - 27 Table 3 - 6 File types ................................ ................................ ................................ ................................ ... 3 - 41 Table 3 - 7 Log Filter dialog box columns ................................ ................................ ................................ .... 3 - 47 Table 3 - 8 Find Message dialog box elements ................................ ................................ .............................. 3 - 49 Table 3 - 9 CAI Message Decoding dialog box elements ................................ ................................ .............. 3 - 53 Table 3 - 10 AT Command dialog box elements ................................ ................................ ............................ 3 - 54 Table 3 - 11 Accelerator and responding function ................................ ................................ ......................... 3 - 58 Arm Logel User Guide 1 - 2 Spreadtrum Communications Inc. Issue 01 (2010 - 03 - 09) 1 In tro duction 1.1 Functions ArmLogel is used to diagnose and monitor the internal messages, air messages, and system information (PS status and memory allocation) of the mobile. It performs the following functions: D isplaying messages of the tasks by layer Decoding message structures and data Configuring and filtering messages Real - time data display enables ArmLogel to be an ideal tool for finding and locating errors and problems. At the same time, the data displayed is saved in the log file, which ensures that all the messages can be represented and decoded. ArmLogel can receive data from both a real mobile or a simulated mobile on PC. All the data is transferred by ChannelServer , so ArmLogel needs to be connected to C hannelServer ChannelServer can be installed eit her on a local or remote PC. For details, refer to the ChannelServer User Guide 1.2 File Composition ArmLogel consists of the following files: ArmLogel .exe CommSockd.dll CJ609Libd.dll DPSrvd.dll LogelSidedPSd.dll Message_Define.def signal_id_header_gen.h ta sk_id_header_gen.h TD parser files ： libuetoolsup.so, ms_offsize.dat,tt_gui.exe, tcl80.dll, TCL lib directory Note: After running, ArmLogel generates a configuration file logel.ini in the same directory as ArmLogel .exe ArmLogel that supports ASN message dec oding requires files ASN1DPSrvd.dll and ASN1DPSrv_SYSd.dll Arm Logel User Guide Issue 01 (2010 - 03 - 09) Spreadtrum Communications Inc. 2 - 3 2 Interface Description 2.1 Main Interface Figure 2 - 1 GSM m ain interface Figure 2 - 2 TD/DM m ain interface Arm Logel User Guide 2 - 4 Spreadtrum Communications Inc. Issue 01 (2010 - 03 - 09) 2.2 Menu Choose Help > About Logel ... . The version information is displayed, as shown in Figure 2 - 3 Figure 2 - 3 About Spreadtrum Logel dialog box Select a message window on the Window menu, as shown in Figure 2 - 4 . The corresponding message window is displayed. Arm Logel User Guide Issue 01 (2010 - 03 - 09) Spreadtrum Communications Inc. 2 - 5 Figure 2 - 4 Window menu 2.3 Toolbar Figure 2 - 5 Toolbar icons Table 2 - 1 Toolbar icons Icon D escription Connect to ChannelServer Set IP address Logging / Stop logging Auto test Open a file Save a file Qui cken the playback speed Key record Clear all the data Add description Arm Logel User Guide 2 - 6 Spreadtrum Communications Inc. Issue 01 (2010 - 03 - 09) Icon D escription Filter messages Auto scroll Open message decoding window Open Trace message window Open layer2 message window Open layer3 message window Open MAC message window Open LLC message window Open SNDCP message window Open cell message window Open GPRS message window Open L og &T race message window Tile the windows in the Log message window Open MsgFlow window Send force on cell command S e nd version query command Send AT commands Search in the Log message window or the Trace window Status win dow Load the p arser information library files （ TD/DM ） Set the parser information library file path （ TD/DM ） Use oss asn.1 to parse peer message （ TD/DM ） GPS State indicator Arm Logel User Guide Issue 01 (2010 - 03 - 09) Spreadtrum Communications Inc. 2 - 7 Note: After ArmLogel is connected to ChannelServer, changes to , which is used to disconnect ArmLogel from ChannelServer. After ArmLogel starts running, changes to , which is used to stop logging. After a file is opened, changes t o the icon that is used to close the file. indicates that a file is being played. C l ick it to stop playing. If is shown again, it indicates that file play ends. The toolbars vary with ArmLogel of different product s or platforms. 2.4 Status Bar The status bar displays the current operation status as follow: Handover statistic information The ArmLogel file path Parser version information Mobile version information Arm Logel User Guide 3 - 8 Spreadtrum Communications Inc. Issue 01 (2010 - 03 - 09) 3 Operation Guide 3.1 Running Modes ArmLogel r uns in two modes : real - time mode and playback mode. 3.1.1 Real - Time Mode In real - time mode, the messages displayed are transferred by ChannelServe r. These messages can be sent either from a real mobile or from a simulated mobile on the PC. ArmLogel and Channel Server connect through Socket . T he IP address must be correctly set. The connection status is displayed in the status window. All the messages receive d are saved in a file in the History directory . The file name is the time when it is created. 3.1.2 Playback Mo de In playback mode, the messages displayed are loaded from the ArmLogel file. In order to further analysis, t he message s are displayed by order. 3.2 Work Mode s 3.2.1 Four Work Mode s Arm Logel has four work modes: Original Mode : ArmLogel will save original data as d efault. A nd it is just for real - time mode. Normal M ode : T his is the default mode , and the o riginal files won ’ t be saved in this mode . It is just for real - time mode. Q uick M ode : ArmLogel will save original files as default, a nd will use quick method to di splay message s . It just show s cell information, TD /GSM m es s a g e flow , layer3 information 。 T race M ode : ArmLogel will save original files as default. It only show s the trace message s So it is just for auto test or the development engineers who only care the trace message s A s the same as quick mode, the mode can work for real - time mode and pl ayback mode. Arm Logel User Guide Issue 01 (2010 - 03 - 09) Spreadtrum Communications Inc. 3 - 9 Figure 3 - 1 Set work mode menu 3.2.2 Playback Batch F or quick playback the original files that are generate d from the quick mode or trace mode, we can use the playback batch. It can handle all the original files in the speci fic directory. Figure 3 - 2 Set work mode me nu: LOG - >Work Mode - > P layback B atch ... : Arm Logel User Guide 3 - 10 Spreadtrum Communications Inc. Issue 01 (2010 - 03 - 09) Figure 3 - 3 Browse directory dialog box : After selecting the directory, the Playback batch dialog box shown as Figure 3 - 4 will be displayed. P ress start button to begin. If playback files exist, we can re - generate the playba ck files according to select the check box. P ress cancel button to stop. The list playback file will generate at the same directory as the original file. Figure 3 - 4 P layback batch dialog box : 3.3 Load DLL( TD/DM) ArmLogel with TD/DM version need s to load the parse i nformation library at first. These files include messagedef.def , libuetoolsup.so , ms_offsize.dat and so on. You must select these files according to the mobile version.