Leica tps1100 User manual

GeoBASIC FOR TPS1100
User Manual
Version 2.10
1997-2001 Leica Geosystems AG
Heerbrugg, Switzerland

GeoBASIC User Manual 1 — Introduction
TPS1100-Version 2.10 1-1
1Introduction ............................................................................................... 1-3
2Installation.................................................................................................. 2-1
2.1 Setup ........................................................................................................... 2-1
3Creating a GeoBASIC Application.......................................................... 3-1
3.1 GBStudio development environment.......................................................... 3-1
3.2 Typical Development Cycle........................................................................ 3-7
3.3 Project Handling ......................................................................................... 3-3
3.4 Common Problems...................................................................................... 3-4
3.5 Compiler Limitations .................................................................................. 3-5
4Executing a GeoBASIC Program on the theodolite................................ 4-6
4.1 Loading a GeoBASIC program................................................................... 4-6
5Executing a GeoBASIC Program on the Simulatior............................... 5-1
5.1 General........................................................................................................ 5-1
5.2 User Interface.............................................................................................. 5-1
5.3 Loading and executing GeoBASIC programs............................................. 5-2
5.4 Configuration of the Simulator.................................................................... 5-3
5.5 GeoCom Mode............................................................................................ 5-4
5.6 SWTheo Mode............................................................................................ 5-4
5.7 Commonly asked questions and answers..................................................... 5-7
6Additional Debugging Functions.............................................................. 6-1
7Multiple Language Support...................................................................... 7-1
7.1 Text Utility.................................................................................................. 7-2
8Typical GeoBASIC Programming............................................................ 8-1

GeoBASIC User Manual 1 — Introduction
1-2 TPS1100-Version 2.10
8.1 The Text Dialog.......................................................................................... 8-1
8.2 The Graphics Dialog................................................................................... 8-5
8.3 Naming conventions.................................................................................... 8-9
9Refined GeoBASIC Concepts ................................................................... 9-1
9.1 Units............................................................................................................ 9-1
9.2 The User Measurement Dialog.................................................................... 9-2
9.3 TPS1100 Configurability............................................................................ 9-5
9.4 Interapplication-Call ................................................................................... 9-8
9.5 System Function Call .................................................................................. 9-9
9.6 System Event Generation.......................................................................... 9-10
10 GeoBASIC Sample Programs................................................................. 10-1
10.1 MeanHz — Mean Value of Horizontal Angle Measurements................... 10-1
10.2 Sample Programs ...................................................................................... 10-8
11 Porting a TPS1000 Originated Program............................................... 11-1
11.1 TPS1100 Hardware Related Changes....................................................... 11-1
11.2 Changes to the Simulator .......................................................................... 11-2
11.3 New constructs in GB_1100 ..................................................................... 11-2
11.4 GeoBASIC Source Changes...................................................................... 11-3
12 GeoBASIC Releases................................................................................. 12-1
12.1 Changes in GeoBASIC Release 1.30 ........................................................ 12-1
12.2 Changes in GeoBASIC Release 2.10 ........................................................ 12-3

GeoBASIC User Manual 1 — Introduction
TPS1100-Version 2.10 1-3
1 INTRODUCTION
GeoBASIC is a programming language for LEICA theodolites and their simulation
on personal computers. The core language appears similar to today's common
Windows BASIC dialects, thereby it is easy to learn and use. However,
GeoBASIC's main power lies in its ability to use many of the existing theodolite
subsystems and dialogs, just by calling an appropriate built-in function: for setting
parameters, measuring, geodesy mathematics, and many things more. These tools
at hand, the programmer can quickly and flexibly build sophisticated geodesy
applications.
The user manual first describes the installation of GeoBASIC on a PC (Chapter 2).
Then, after learning how to create an GeoBASIC application (Chapter 3), it will
be shown how to actually load and execute a program on a LEICA theodolite
(Chapter 4) and on the Windows simulation (Chapter 5).
As these technicalities are mastered, the main topic is programming in GeoBASIC.
This manual will give you several hints on typical GeoBASIC programming
(Chapter 8), and introduces you to the design and programming of the theodolite
user interface and refined GeoBASIC concepts (Chapter 9).
Finally,GeoBASIC example programs are presented (Chapter 10). The reader will
find a sample code for measuring and computing the mean value of several
horizontal angles. Moreover some introductory examples are given to tell how
special problems can be treated.
Note All the details of the GeoBASIC language and system functions are
composed in the "GeoBASIC Reference Manual".

GeoBASIC User Manual 2 — Installation
TPS1100-Version 2.10 2-1
2 INSTALLATION
The requirements for using GeoBASIC are a Personal Computer based on an Intel
486 processor or higher and at least 8MB of main memory. The installation of the
whole development environment occupies about 10 MB of disk space, excluding
the PDF version of the manual. The delivered software needs Microsoft Win95,
Win98 or WinNT to run successfully.
2.1 SETUP
The following directory structure is created during the installation per default.
Notice that the location of this directory tree is user definable. Hence it is not a
granted to be exactly that location. Notice also that the CodeConverter application
is installed in a separate Setup installation procedure.
…+-SurveyOffice
|
+-UserTools
||
| +-TPS1100Tools
|||
| | + - CodeConverter
| | + - GBSamples
|||
Content of the directories (only the main objects are listed):
•TPS1100Tools\
TPS1100.exe TPS Simulator for TPS1100 Series
GBStudio.exe GeoBASIC IDE application
GBI_1100_xxx.prg GeoBASIC Interpreter for TPS1100 series *)
… and maybe several more tools, help files or DLL’s
•CodeConverter\
CGB_Dlg.exe CODE to GeoBASIC converter
Code_ex1.cod CODE sample
GBC_xxx.exe GeoBASIC Compiler for TPS1000 series *)
GBI_xxx.prg GeoBASIC Interpreter for TPS1000 series *)
GBI_1100_xxx.prg GeoBASIC Interpreter for TPS1100 series *)

GeoBASIC User Manual 2 — Installation
2-2 TPS1100-Version 2.10
•…
Several TPS1100Sim specific directories which contain language files, code
lists, configurations and things like that.
* xxx means: i.e. 210 for Release 2.10
Loading the GeoBASIC Interpreter:
The GeoBASIC Interpreter will be loaded automatically with the loading of the
first application into the theodolite using the Software Upload for TPS1100. Hence
you have to copy the GeoBASIC Interpreter (GBI_TPS1100_xxx.prg) into the
same directory as the application before loading it. Otherwise you will get an error
message. (For details, please see Chapter 4.1 Loading a GeoBASIC program or
5.3 Loading and executing GeoBASIC programs)

GeoBASIC User Manual 3 — Creating a GeoBASIC Application
TPS1100-Version 2.10 3-1
3 CREATING A GEOBASIC APPLICATION
Starting from the specification of a GeoBASIC application, several steps have to
be performed until the program can be executed on the theodolite or by simulation:
1. Write the program,
2. compile the program,
3. load the program, either onto the simulation or the theodolite, and
4. start the execution of it.
5. if the execution fails, start a debugging session.
3.1 GBSTUDIO DEVELOPMENT ENVIRONMENT
GBStudio is an integrated development environment and includes a source editor,
compiler, project handling and a source level debugger. It is able to debug
GeoBASIC 2.10 applications for TPS1100 series total stations. Both, the TPS
simulator and the TPS device as the execution platform are supported.

GeoBASIC User Manual 3 — Creating a GeoBASIC Application
3-2 TPS1100-Version 2.10
GBStudio contains several views for different purposes. The main source view is
for showing/editing source files. The ‘Open Files’-tab can be used to switch
quickly between different source windows. Toolbars help the user to start actions
with one mouse click. The ‘Build/Output’-window is used to display informative
messages of the compiler and during the debugging session for the user.
Use the integrated help system to get more descriptive explanations of what can be
done with GBStudio. You can invoke the Help documentation by either using the
context-help-cursor (Edit toolbar) or the shortcut F1, which opens the content
page.
3.1.1 The Editor
It establishes a modern programming language editor, which supports syntax and
keyword highlighting, multilevel undo/redo, Intellisense and Tooltip info,
Bookmarks, indent and outdent of a block of source lines, and several other
features.
The ‘Workspace Preferences’-dialog can be used to customize the features, which
should be active during debugging.

GeoBASIC User Manual 3 — Creating a GeoBASIC Application
TPS1100-Version 2.10 3-3
To choose a different font use the ‘Font …’-buttons in the ‘Font’-tab, which will
offer a dialog to choose one of the installed fonts on the system. Fonts can be
chosen separately for the Editor window, Build/Debug output window and for the
Watch Variable window.
3.1.2 The Compiler
The source-file has to be compiled before it can be loaded and executed.
Compiling the source file with the GeoBASIC compiler results into 3 files, one for
the executable object itself (file extension “.gba”; i.e. sample.gba), one for
the language data (file extension “.lng”; i.e. sample.lng) and a debug-info
file (file extension “.gbd”; i.e. sample.gbd). The first two files are necessary
to execute the program, either on a LEICA theodolite or with the simulator on a
personal computer. The debug-info file is necessary for debugging a program
using GBStudio. See the following diagram:
sample.gbs
GBStudio
sample.gba sample.lng sample.gbd
Diagram: Compiling a GeoBASIC program
The compiler is fully integrated in the development environment. The compilation
of the source file is just one mouse click away. If an error occurs the editor will
place the cursor automatically at the position of the error in the source window.
Use Ctrl-F1 to get a more descriptive explanation of what caused the failure of the
compilation process.
Depending on the compiler settings also the debug info file is generated which is
necessary for debugging the application.

GeoBASIC User Manual 3 — Creating a GeoBASIC Application
3-4 TPS1100-Version 2.10
Depending on the selected project type, use either the ‘Default Project
Preferences’-dialog or the ‘Project Preferences’-dialog to set the build options for
the compiler.
The compiler understands the following options:
Setting Meaning
Language The language on which the resulting application is based
on. The default is ENGLISH, other languages are
FRENCH, GERMAN, etc.
Character Set The character set on which the application is based on.
The default character set is 0.
Output File The name of the resulting applications file name. If it is
empty, the resulting files get the same file base name as
the source code file.