Wavecom GX64 Installation and operating instructions

Page: 1/18
Gx64 APPLICATION NOTE
Using Optitrace
T
his document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement.
Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable
Revision: 001
Date: 2007/01/31
Using Optitrace
Gx64 APPLICATION NOTE
Reference:
W
I_DEV_Gx64_APN_011

Trademarks
®, WAVECOM®, WISMO®, Open AT®, Wireless CPU®, Wireless Microprocessor®and certain
other trademarks and logos appearing on this document, are filed or registered trademarks
of Wavecom S.A. in France or in other countries. All other company and/or product names
mentioned may be filed or registered trademarks of their respective owners.
Copyright
This manual is copyrighted by WAVECOM with all rights reserved. No part of this manual
may be reproduced in any form without the prior written permission of WAVECOM.
No patent liability is assumed with respect to the use of the information contained herein.
No Warranty
WAVECOM publishes this manual without making any warranty as to the content contained
herein. Further Wavecom Inc reserves the right to make modifications, additions and
deletions to this manual due to typographical errors, inaccurate information, or
improvements to programs and/or equipment at any time and without notice. Such
changes will, nevertheless be incorporated into new editions of this manual.
Gx64 APPLICATION NOTE
Using Optitrace
T
his document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement.
Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable
Page: 2/18

Table of Contents
1General................................................................................................. 5
1.1 SCOPE.................................................................................................................... 5
1.2 ABBREVIATIONS AND TERMS .................................................................................. 5
2Optitrace .............................................................................................. 6
2.1 OVERVIEW.............................................................................................................. 6
2.2 DOWNLOADING OPTITRACE ................................................................................... 6
3Hardware .............................................................................................. 8
3.1 OVERVIEW.............................................................................................................. 8
3.2 GR64 ..................................................................................................................... 8
3.3 GS64 ..................................................................................................................... 8
3.3.1 USE WITH THE UNIVERSAL DEVELOPERS KIT..................................................... 8
4Running Optitrace................................................................................. 9
4.1 OVERVIEW.............................................................................................................. 9
4.2 TRDATA.XML ......................................................................................................... 9
4.3 PROJECT FILES...................................................................................................... 11
4.4 MAIN WINDOW..................................................................................................... 12
4.5 TCP/IP ................................................................................................................. 13
4.6 EMBEDDED APPLICATIONS.................................................................................... 14
5Reporting an Issue.............................................................................. 15
5.1 FIRMWARE VERSION ............................................................................................. 15
Gx64 APPLICATION NOTE
Using Optitrace
T
his document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement.
Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable
Page: 3/18

5.2 FIRMWARE UPGRADE ............................................................................................ 15
5.3 HARDWARE PLATFORM......................................................................................... 15
5.4 PROBLEM DESCRIPTION ........................................................................................ 15
5.5 LOCATION ........................................................................................................... 15
5.6 COPY OF SCRIPT .................................................................................................. 16
5.7 OPTITRACE LOG................................................................................................... 16
5.8 PCAP FILE (SOCKETS ONLY) .................................................................................. 16
6References.......................................................................................... 17
6.1 OPTITRACE .......................................................................................................... 17
6.2 AT COMMANDS.................................................................................................... 17
6.3 INTEGRATORS MANUAL........................................................................................ 17
6.4 TOOLS ................................................................................................................. 17
Gx64 APPLICATION NOTE
Using Optitrace
T
his document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement.
Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable
Page: 4/18

1General
1.1 Scope
This application note describes how to use the Optitrace tool used to capture debug
logging information from the GR64 or GS64. This document is meant to be used in
addition to the Integrators Manual and the AT Command Manual for the GR/GS64
wireless CPU.
1.2 Abbreviations and Terms
Abbreviation Description
EA
Embedded Applications - Customer script stored in
GR/GS64 non volatile memory which can be invoked to
control GR/GS64.
External
Application
Customer hardware and software that contain and control
the GR/GS64 via AT commands.
IDE Integrated Development Environment
GR47/48 Legacy GSM/GPRS module
QBGC Quad Band GSM/GPRS Core (GR/GS64 product line)
TCP/IP Transmission Control Protocol/Internet Protocol
APN Access Point Name
Gx64 APPLICATION NOTE
Using Optitrace
T
his document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement.
Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable
Page: 5/18

2Optitrace
2.1 Overview
With the next generation Gx64 Wireless CPUs a new set of tools are required when
debugging. The platform has the ability to log debug information from all
subsystems such as SIM, GSM layer 3, SMS, CSD, etc using the Optitrace application.
If a customer has problems with the GR64 that are not easily reproduced at
Wavecom facilities then this application is designed to be easily setup on a standard
Microsoft Windows PC to capture debug information that may be analyzed by
Wavecom engineers. This tool can be downloaded from the Wavecom website.
This document provides a guide to using the application with both the GR and GS
models.
Gx64 APPLICATION NOTE
Using Optitrace
2.2 Downloading Optitrace
In order to download the files required to run Optitrace the user must have a
Wavecom.com extranet account. Optitrace can be found in the “Product” tab, in the
“G/C Series Support” product section, under the “Gx64 Software” subsection.
T
his document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement.
Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable
Page: 6/18

In this area of the extranet you can not only download the latest version of the
Optitrace application but also the software updater for the latest version of
firmware. In order to run optitrace you must have one additional file, the trdata.xml
file which debug trace information. This xml file must match the version of the of
the firmware currently installed on the Wireless CPU.
Gx64 APPLICATION NOTE
Using Optitrace
T
his document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement.
Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable
Page: 7/18

3Hardware
3.1 Overview
The GR64 and the GS64 send all debug information out via UART2. Wavecom
recommends that customers design their PCBs to allow the second UART to be
populated during the design and development phase so that debug information may
be retrieved when required. Also, debug information may be retrieved from the
second UART output of the UMA or TINA development boards.
3.2 GR64
The GR64 was designed to be as backwards compatible with the Gx4x modules as
possible. One of the major differences between the platforms was the Gx4x had
three UARTs and UART 2 was used for debugging but the Gx64 only has two UARTs.
In the GR64, the pins for the second UART are laid out where the pins for UART 3
were laid out for the GR47 (pins 43 and 44).
3.3 GS64
The GS64 has the debug UART lead out of pins 63 and 64.
3.3.1 Use with the Universal Developers Kit
When using the universal developers kit with the GS64 adaptor boards you should
move the jumpers X501 and X502 to the SEC PORT position, this is due to the
second UART being routed out through the UART2 pins on the GR47 system
connector.
Gx64 APPLICATION NOTE
Using Optitrace
T
his document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement.
Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable
Page: 8/18

4Running Optitrace
4.1 Overview
This section will describe how to setup and run Optitrace after it has been installed.
4.2 TRdata.xml
For each build of software that is loaded onto the module a file called trdata.xml is
created. The purpose of this file is to tell optitrace what traces have been activated
within the build, without the correct file optitrace will be unable to interpret the
information coming out of the unit. The software revision currently loaded on the
Wireless CPU can be found by typing “AT+CGMR”.
Prior to running optitrace the trdata.xml file for the corresponding build on the
module should be placed in the optitrace directory as shown in the windows
explorer screen shot below. Once you have downloaded the file from the extranet,
rename the file to “trdata.xml” and copy it to the directory that holds Optitrace.exe.
If you would like to work with more than one firmware version please review the
Optitrace users manual installed with the application.
Gx64 APPLICATION NOTE
Using Optitrace
T
his document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement.
Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable
Page: 9/18

When the module is turned on and you are able to see logging data running through
the window, the two check sums, Trace table CRC and Mobile CRC should match, if
they do not then the trdata.xml file does not correspond with the build of software
that is on the module.You can tell what the value of the XML CRC and the CRC the
module expects in the bottom left hand corner of the application. If you see a red
box with an “X” through it, you are using the wrong trdata.xml file. See below for an
example.
Gx64 APPLICATION NOTE
Using Optitrace
T
his document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement.
Ce document est la propriété exclusive de WAVECOM. Il ne peut être communiqué ou divulgué à des tiers sans son autorisation préalable
Page: 10/18