GTT Protocol
For all variants of the GTT29A, GTT35A, GTT38A, GTT43A, GTT50A ,
and GTT70A
Protocol Manual
Revision 2.6
Firmware Revision: 2.0 or Higher
Revision History
Revision
2.6
2.5
2.4
2.3
2.2
2.1
2.0
Date
9 December 2016
1 September 2016
25 July 2016
18 March 2016
21 October 2014
8 April 2014
8 October 2013
Description
Added commands for Firmware 2.6 release
Added Filled Slider and corrected Get Toggle State
command
Restructuring Manual for Firmware 2.5 Release
Added Read Screen, Toggle, Slider, and Label Features
Added Scripting, Label, and Strip Chart Features
Added Scripting, Label, and Trace Features
Initial Release
Author
Divino
Divino
Divino
Clark
Clark
Clark
Clark
Contents
1 Introduction ............................................................................................................................................... 1
1.1 Design.................................................................................................................................................. 1
Design Tool............................................................................................................................................ 1
Connections .......................................................................................................................................... 1
SD Card .................................................................................................................................................. 2
Communication ..................................................................................................................................... 2
Flow Control .......................................................................................................................................... 2
1.2 Basic Features ..................................................................................................................................... 2
Text ....................................................................................................................................................... 2
Commands ............................................................................................................................................ 3
Return Messages ................................................................................................................................... 3
Control Characters ................................................................................................................................ 3
Drawing ................................................................................................................................................. 4
Buffers ................................................................................................................................................... 4
Index Numbers ...................................................................................................................................... 4
Fonts...................................................................................................................................................... 5
Bitmaps ................................................................................................................................................. 5
Bargraphs .............................................................................................................................................. 5
Traces .................................................................................................................................................... 5
1.3 Advanced Features.............................................................................................................................. 6
9-Slice .................................................................................................................................................... 6
9-Slice Graphs ....................................................................................................................................... 6
Animations ............................................................................................................................................ 6
Keypad................................................................................................................................................... 6
Touch..................................................................................................................................................... 7
Region ................................................................................................................................................... 7
Scripts .................................................................................................................................................... 7
Autoexec ............................................................................................................................................... 8
1.4 Support................................................................................................................................................ 8
Support Tool.......................................................................................................................................... 8
Application Notes.................................................................................................................................. 8
Firmware Upgrades............................................................................................................................... 9
2 Commands ............................................................................................................................................... 10
2.1 Communication ................................................................................................................................. 10
2.2 Module .............................................................................................................................................. 11
2.3 Drawing ............................................................................................................................................. 14
2.4 Buffers ............................................................................................................................................... 19
2.5 Text.................................................................................................................................................... 22
2.6 Bitmaps ............................................................................................................................................. 31
2.7 NineSlices .......................................................................................................................................... 31
2.8 Animations ........................................................................................................................................ 31
2.9 Graphs ............................................................................................................................................... 33
2.10 Keypad............................................................................................................................................. 38
2.11 Touch............................................................................................................................................... 40
2.12 Output ............................................................................................................................................. 46
2.13 Scripts.............................................................................................................................................. 48
3 Appendix .................................................................................................................................................. 50
3.1 Command Summary ......................................................................................................................... 50
3.2 File Examples..................................................................................................................................... 56
9-Slices ................................................................................................................................................ 56
Animations .......................................................................................................................................... 57
Region File ........................................................................................................................................... 57
Script ................................................................................................................................................... 58
Autoexec File ....................................................................................................................................... 58
3.3 Memory............................................................................................................................................. 59
3.4 Data Types......................................................................................................................................... 59
Common Language Representations .................................................................................................. 59
4 Definitions ................................................................................................................................................ 60
5 Contact ..................................................................................................................................................... 60
1 Introduction
1.1 Design
Design Tool
The GTT Design software, available at
http://matrixorbital.ca/gtt-software,
makes development for the
GTT quick and easy, while still maintaining beautiful user interfaces and menu structures. Simulating the
GTT display that is being used, the GTT Design Software allows users to place buttons, shapes, images,
graphs and text exactly where they want on screen. With its intuitive design, users will be able to create
and deploy multiple screens to be used on their GTT.
Figure 1: GTT Design Software
As shown above, the simple and intuitive design of the GTT Design tool provides users the ability to drag
objects onto their simulated GTT screen. Once placed on screen, the user will be able to re-size, and re-
position the object to their liking. The properties tab offers more precision when making adjustments to
an object, and allows a user to change a plethora of other parameters of the object selected.
Loaded with the full library of GTT series commands, the GTT Design Software also provides users the
ability to create scripts that can be loaded on the GTT. Furthermore, scripts can be linked to buttons
created by the designer, and can be executed whenever the button is pressed.
Connections
In order to communicate with the GTT, you will need to connect to the appropriate communication
header. From the factory, a standard GTT unit will come with RS232 selected as the communication
protocol. If a different communication protocol is preferred over the standard RS232 protocol, the
protocol select jumpers will have to be relocated in order to allow proper communication to the GTT.
Header locations for each available protocol can be found in your respective GTT Hardware manual. GTT
hardware manuals can be found at
http://matrixorbital.ca/manuals/gtt-series.
1