CToolbox User Guide
CToolbox User Guide
CToolbox User Guide
User Guide
Version 5.60
Part Number 27768-56-ENG
F
Revision A
March 2005
Contact Information whole or in part, except as expressly provided for in this
Trimble Geomatics and Engineering Division Agreement. Subject to the restrictions provided above and
5475 Kellenburger Road provided the Software is not copy-protected, the End User may
Dayton, Ohio 45424-1099 make one (1) copy of the Software for back-up purposes only;
U.S.A. the use of such copy shall be subject to the terms, conditions and
800-538-7800 (toll free in USA) restrictions of this Agreement.
+1-937-245-5600 Phone 4. Use of the Software: The License authorizes the End User to
+1-937-233-9004 Fax use the Software in machine-readable form on any single
www.trimble.com computer system at any time. The Software may be moved from
Copyright and Trademarks one computer system to another, as long as at any time only one
(1) copy is in use per License. A License may not be shared or
© 1996–2005, Caterpillar Trimble Control Technologies LLC. used concurrently on different computers.
All rights reserved.
5. Uses not Permitted: The End User is expressly forbidden,
Trimble and the Globe & Triangle logo are trademarks of and shall not allow any third parties, to copy (except as permitted
Trimble Navigation Limited, registered in the United States by this Agreement), decompile, reverse engineer, disassemble,
Patent and Trademark Office and other countries. reverse translate, reverse compile, or in any manner decode the
MS750 and MS860 are trademarks of Trimble Navigation Software in order to derive any source code form, disable copy
Limited. protection, and/or decode undisclosed communication and data
Microsoft, Windows, and Windows NT are trademarks or storage protocols.
registered trademarks of Microsoft Corporation in the United 6. Copyrights, Trademark Notices, Legends, and Logos: The
States and/or other countries. Software and documentation (including without limitations
All other trademarks are the property of their respective owners. images, photographs, animations, video, audio, music and text
Release Notice incorporated in the Software), logos, product names, and other
support materials, if any, are either patented, patentable,
This is the March 2005 release (Revision A) of the copyrighted, trademarked, or otherwise proprietary to CTCT and
Configuration Toolbox User Guide, part number owned by CTCT. The End User agrees never to remove, cover,
27768-56-ENG. It applies to version 5.60 of the Configuration or alter any patent, copyright or trademark notices and product
Toolbox software. identification information on the Software or any packaging and
The following limited warranties give you specific legal rights. related materials without the prior written approval of an
You may have others, which vary from state/jurisdiction to authorized representative of CTCT.
state/jurisdiction. 7. Term: The License is effective until terminated as provided
End-User License Agreement herein. The End User may terminate this License Agreement by
THIS END USER LICENSE AGREEMENT ("AGREEMENT") returning or destroying the Software and documentation and all
IS A LEGAL AGREEMENT BETWEEN YOU AND copies thereof. CTCT may immediately terminate this License
CATERPILLAR TRIMBLE CONTROL TECHNOLOGIES without notice to the End User if the End User fails to comply
LLC (CTCT) with any of the provisions of the License.
IMPORTANT - READ THIS AGREEMENT PRIOR TO 8. Limited Warranty: For a period of one (1) year from the
USING CTCT SOFTWARE date of delivery of the Software, CTCT warrants that (i) the
The End User agrees to carefully read all of the terms and Software will substantially conform to the accompanying
conditions of this Agreement prior to installing this CTCT specifications, provided it is used on the computer hardware and
software product package ("Software"). The parties agrees that with the operating system for which it was designed; and (ii) the
installation of the Software in any manner indicates the End media on which the Software is distributed, and the
User's acceptance of these terms and conditions. If the End User documentation, are free from defects in materials and
does not agree to all of the terms and conditions of this workmanship. During the warranty period, CTCT's sole
Agreement, the End User is asked not to install the Software. obligation and the End User's sole remedy will be replacement of
The End User should promptly return the uninstalled Software the defective media or documentation or correction of any
and any items delivered with it for a full refund. substantial program errors at no charge. In the event CTCT is
unable to replace defective media or documentation, or correct
1. Granting of License: In consideration of payment of the substantial program errors, CTCT will refund the price paid for
License Fee (which is a portion of the price paid by End User for the Software. This limited warranty is void if the failure of the
the Product), and End User's agreement to abide by the terms Software resulted from accident, abuse, or misapplication. Any
and conditions of the License, CTCT grants to the End User, on replacement or corrected software will be warranted for the
the following terms and conditions, a limited, non-exclusive, longer of (i) the remaining period of the original warranty
non-transferable, non-sublicensable License to use the Software period, or (ii) thirty (30) days.
stored on the diskettes or CD in the accompanying package, and
any related user documentation. CTCT hereby reserves all rights 9. NO OTHER WARRANTIES: TO THE MAXIMUM
not expressly granted. EXTENT PERMITTED BY APPLICABLE LAW, CTCT
DISCLAIMS ALL OTHER WARRANTIES AND
2. Ownership of the Software: CTCT retains all rights, title CONDITIONS, EITHER EXPRESS OR IMPLIED,
and ownership to and of the Software and all subsequent copies, INCLUDING BUT NOT LIMITED TO, IMPLIED
versions, upgrades and modifications of the Software, regardless WARRANTIES AND CONDITIONS OF
of the form in which the same may exist. This License is not a MERCHANTABILITY AND FITNESS FOR A PARTICULAR
sale of the original software or any copy, version, upgrade or PURPOSE, TITLE, AND NON-INFRINGEMENT WITH
modification. REGARD TO THE SOFTWARE AND THE PROVISION OF
3. Copies and Modifications: The copyright in the Software OR FAILURE TO PROVIDE SUPPORT SERVICES. TO THE
and related documentation is owned by CTCT. The End User EXTENT ALLOWED BY APPLICABLE LAW, IMPLIED
may NOT use, copy, modify, or transfer the programs and related WARRANTIES AND CONDITIONS ON THE SOFTWARE
documentation or any copy, modification, or merged portion, in
ARE LIMITED TO NINETY (90) DAYS. THE END USER
MAY HAVE OTHER LEGAL RIGHTS WHICH VARY FROM
STATE/JURISDICTION TO STATE/JURISDICTION.
10. Limitation of Liability: Because the Software is inherently
complex and may not be completely free of errors, the End User
is advised to verify its work. CTCT’S ENTIRE LIABILITY
UNDER ANY PROVISION OF THIS AGREEMENT SHALL
BE LIMITED TO THE GREATER OF THE AMOUNT PAID
BY THE END USER FOR THE SOFTWARE LICENSE OR
U.S. $25.00. TO THE MAXIMUM EXTENT PERMITTED BY
APPLICABLE LAW, IN NO EVENT SHALL CTCT OR ITS
SUPPLIERS BE LIABLE FOR ANY SPECIAL,
INCIDENTAL, INDIRECT OR CONSEQUENTIAL
DAMAGES WHATSOEVER (INCLUDING, WITHOUT
LIMITATION, DAMAGES FOR LOSS OF BUSINESS
PROFITS, BUSINESS INTERRUPTION, LOSS OF
BUSINESS INFORMATION, OR ANY OTHER PECUNIARY
LOSS) ARISING OUT OF THE USE OR INABILITY TO USE
THE SOFTWARE, OR THE PROVISION OF OR FAILURE
TO PROVIDE SUPPORT SERVICES, EVEN IF CTCT HAS
BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES. BECAUSE SOME STATES AND
JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR
LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR
INCIDENTAL DAMAGES, THE ABOVE LIMITATION MAY
NOT APPLY TO THE END USER.
11. Applicable Law: This Agreement shall be construed,
interpreted, and governed by the laws of Ohio, U.S.A. Should
any provision of this Agreement be found unenforceable by a
court of competent jurisdiction, the remainder of the Agreement
shall not be affected and shall continue to be enforceable to the
fullest extent permitted by law.
12. Acknowledgement: The End User acknowledges that it has
read this agreement, understands it, and agrees to be bound by its
terms and conditions. The End User further agrees that this
Agreement is the complete and exclusive statement of agreement
between the End User and CTCT, which supersedes any
proposal or prior agreement, whether verbal or written, and any
other communications between the parties relating to the subject
matter of this Agreement.
13. CTCT reserves all rights not expressly granted by this
Agreement.
Contents
About this Manual
1 Installation
1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 System Requirements . . . . . . . . . . . . . . . . . . . . . . . 2
1.3 Installation Procedure . . . . . . . . . . . . . . . . . . . . . . . 3
2 Receiver Configuration
2.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
2.2 Starting Configuration Toolbox . . . . . . . . . . . . . . . . . .7
2.3 Creating an Application File . . . . . . . . . . . . . . . . . . . .8
2.4 Building and Editing an Application File . . . . . . . . . . . . .9
2.4.1 Contents list . . . . . . . . . . . . . . . . . . . . . . . 10
2.4.2 Page area . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.4.3 Operations . . . . . . . . . . . . . . . . . . . . . . . . 11
2.5 Opening, Saving, and Closing an Application File . . . . . . . . 12
2.5.1 Open . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.5.2 Save . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.5.3 Save As . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.5.4 Close . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.6 Creating a Report. . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.7 Communicating with a Receiver . . . . . . . . . . . . . . . . . . 15
2.7.1 Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Index
Related Information
Other sources of related information are:
• Help – the software has built-in Help that lets you quickly find
the information you need. Access it from the Help menu.
Alternatively, click the Help button in a dialog, or press [F1].
• Release notes – the release notes describe new features of the
product and information that may not be included in the
manuals. Access the release notes from the Start menu. For
more information, see Installation Procedure on page 3.
Technical Assistance
If you have a problem and cannot find the information you need in the
product documentation, contact your local dealer.
Your Comments
Your feedback about the supporting documentation helps us to
improve it with each revision. E-mail your comments to
ReaderFeedback@trimble.com.
1
Installation 1
In this chapter:
Introduction
System Requirements
Installation Procedure
1.1 Introduction
The Trimble Configuration Toolbox software is a 32-bit Windows
application that runs on the following Microsoft® Windows®
operating systems:
• Windows 98
• Windows Millennium Edition (Windows Me)
• Windows NT® 4.0
• Windows 2000
• Windows XP
Subfolder Description
bin\ Contains Configuration Toolbox executable and dynamic
link libraries.
appfiles\ This is the preferred folder for storing application files.
Existing application files from earlier versions of
Configuration Toolbox are left here during installation.
2
Receiver Configuration 2
In this chapter:
Introduction
Creating a Report
Communicating with a Receiver
2.1 Introduction
The Trimble Configuration Toolbox software provides the tools to
configure various Trimble GPS receivers. These tools let you change
the settings that control the operation of the receiver. These settings
are stored in an application file.
Configuration Toolbox lets you create and edit the files, transfer them
to and from your receiver, and activate a file stored in the receiver so
that the file settings take effect on the receiver. You can also
download, from the receiver, a file that reflects the current state and
operation of the receiver.
With Configuration Toolbox, you can perform the following
operations:
• Store application files on both your receiver and computer
• Maintain multiple files to represent multiple modes of operation
• Save the application file to audit the operating settings of a
receiver
This selection defines the type of application file that is created. It also
ensures that the available pages match the selected receiver.
B Tip – If the type of receiver is not in the list, use the Any Receiver option.
This option creates a file that contains most settings for any Trimble
receiver. When a file of this type is sent to a receiver, the receiver ignores
settings that do not apply.
You can also modify an existing file that is stored either on the
receiver or on your computer. For more information, see Opening,
Saving, and Closing an Application File on page 12, and Getting and
Transmitting an Application File on page 19.
Available
list
Adding a page
To add a new page to an application file, complete the following steps:
1. Complete one of the following actions:
– Highlight the page then click the Add button
– Double-click the page in the Available list
2. Change the settings in the page area.
Removing a page
To remove a page from an application file, complete one of the
following actions:
• Highlight the page then click the Remove button
• Double-click the page in the Contents list
If you remove a page from an application file, Configuration Toolbox
retains the settings of the page for as long as the Configuration File
dialog is open.
The General, Reference, SV Enable, and Antenna pages can be added
only once to a .cfg file. If you remove one of these pages,
Configuration Toolbox remembers the settings of the page until you
close the .cfg file.
If you put the page back into the .cfg file, you do not have to re-enter
the parameters. For example, if you put the Reference page back into
the .cfg file, the Configuration Toolbox software will remember the
original base station coordinates.
The Serial, Output, and Device pages can have multiple entries in a
.cfg file. If these pages are removed and re-added, the Configuration
Toolbox software does not remember the previous settings and goes
back to the default settings.
2.4.3 Operations
You can perform the following operations from the Configuration File
dialog.
Transmit
To transmit the application file to an attached receiver, click the
Transmit button or select Communications / Transmit File. For more
information, see Getting and Transmitting an Application File on page
19.
Save
To save the application file on your computer, click the Save button or
select File / Save. For more information, see Opening, Saving, and
Closing an Application File on page 12.
Close
To close the Configuration File dialog, click the Close button or
select File / Close. If the file was modified since it was last saved, you
can save the file before closing. For more information, see Close on
page 13.
B Tip – You do not need to store an application file on your computer when
you configure a receiver. However, it does provide a permanent copy of
the settings that were sent to a receiver. You can also use a stored
application file to configure multiple receivers and as a template to create
additional configuration files.
2.5.1 Open
To open an application file that is stored on your computer, select
File / Open.
Configuration Toolbox lets you work with one application file at a
time. For this reason, File / New and File / Open are only available if
no application file is open for editing in the Configuration File dialog.
2.5.2 Save
To save an application file, do one of the following actions:
• Click the Save button
• Select File / Save
Saving a file writes a copy of the application file to the file whose
name appears in the caption of the Configuration File dialog. An
application file that has not been saved previously will open the Save
As dialog.
Note – Application files are stored with a .cfg extension.
2.5.3 Save As
Use the Save As dialog to modify the filename or the disk or the folder
where the file is stored. It is always available when you select
File / Save As, and is automatically used when a file is saved for the
first time.
The filename used to store the application file in the computer and the
name under which the file is stored in the receiver can differ. The Store
in receiver as name on the File page determines the name used on the
receiver.
2.5.4 Close
Click the Close button to close the Configuration File dialog and the
application file. If the file was modified since it was last saved, you
can save the file before closing.
Use this report to review the contents or to print the report for storage
or transmission, such as faxing.
To create a report, select File / Report. This option is only available
when you have an application file open.
The report shows the current state of the application file. The report is
displayed in Microsoft Notepad. You can use the menu options in
Notepad to print or save the file. When you have finished with the
report, close Notepad and return to Configuration Toolbox.
2.7.1 Port
Select Communications / Port. Select the COM port on your computer
to which the GPS receiver is connected.
The other settings of baud rates, parity, and flow control are chosen by
the receiver and are matched automatically by Configuration Toolbox.
These values reflect the settings last used to communicate with the
receiver, and changing the values has no effect on communications.
For more information, see Receiver settings on page 16.
2.7.3 Communication
While Configuration Toolbox is communicating or attempting to
communicate with the receiver, the message Communicating with Receiver
appears. During this time no other operations are possible.
Note – Communicating with a receiver can disrupt the current tasks of
a receiver for a short period of time.
Error messages
The most common error message is No response from receiver.
Select the application file that you want to retrieve, and click the Get
File button. The software retrieves the file from the receiver. The file
opens in the Configuration File dialog. Alternatively, the software
reports an error as discussed in Communication errors on page 16.
Click the Yes button to overwrite the existing file with the file that you
are transmitting. Click the No button to abort the operation. The
Configuration File dialog appears. You can change the file name and
then click the Transmit button again.
Note – The special file DEFAULTS cannot be overwritten. Do not
name an application file CURRENT if you want to revert to these
settings while in the field. For more information, see Current and
Default application files on page 20.
If the operation was successful, the file is stored on the receiver, or is
applied to the receiver, or both, depending on the File page settings.
For more information, refer to the online Help.
If the Stored in receiver check box on the File page is selected, you
can use the Get File operation and the file should appear in the
receiver directory listing, along with its size, creation date, and time.
2. Select the application file that you want to activate, and click
the Activate File button. Configuration Toolbox tells the
receiver to activate the selected file and reports that the
operation was successful or that an error occurred. For more
information about errors, see Communication errors on page 16.
2. Select the application file that you want to delete. Click the
Delete File button and confirm that you want to delete the
selected file.
Resetting the receiver loads the DEFAULTS application file and returns
the receiver to its original configuration.
To reset the receiver, complete the following steps:
1. Select Communications / Reset Receiver. The Reset Receiver
dialog appears:
3
Application File Pages 3
In this chapter:
Introduction
Page Descriptions
3.1 Introduction
An application file consists of one or more application file pages.
Each application file page configures different options on a GPS
receiver. These options describe serial port settings, serial outputs, or
general configuration items. General configuration items include
settings for items as diverse as the elevation mask of the receiver and
information about the coordinate system.
Some pages are not supported on a given receiver. Some pages may
have slightly different options. These different options depend on the
receiver they are chosen for.
When creating a new application file, best practice is to select the
receiver type rather than Any Receiver option. When you select a
specific receiver type, only the relevant options are available.
Output Contains settings for each data output message which the receiver
transmits. The settings are used in conjunction with the Serial page to
completely configure a target port for output.
An application file can contain up to 20 different output messages.
Variants of the same type are treated as separate output message
types. For example, GSOF PosTime and GSOF PosLLH are treated
as two distinct output messages.
Each message must be independently configured and included.
Position mode Configures the RTK position solution type depending on the base line
length.
Reference Contains settings for defining a reference position that can be used
by the receiver when outputting RTCM or CMR corrections.
SV Enable Specifies under what health conditions each of the 32 GPS satellites
will be used. SV stands for Space Vehicle. GPS satellite health is an
indication of the quality of each satellite’s signal. The satellite health
indication is set by the ground controllers, and transmitted directly to
the receiver by the satellites.
Time activation Configures a receiver to start up at a prescribed time.
G
R
General page 29
getting application file 19 Receiver Details dialog 18
receiver, communication 15
Reference page 29
I release notes v
reports, creating 14
installation procedure 3 Reset Receiver dialog 25
resetting the receiver 25
RTCM Input page 29
L
Logging page 29
S
Save As dialog 13
M Serial page 30
main window 7 serial port list 15
serial ports 2
Shutdown page 30
sleep mode 30
N
special application files
No response from receiver error 16 CURRENT 23
DEFAULTS 23
starting Configuration Toolbox 7
Static page 30
status bar 18
subfolders 3
SV Enable page 30
system requirements 2
T
Time Activation page 30
transmitting application file 20
W
WAAS page 30
website v
Wide Area Augmentation System
Support 30