Matrix-orbital GTT70A Manuel d'utilisateur Page 1

GTT Protocol For all variants of the GTT35A, GTT38A, GTT43A, GTT50A & GTT70A Protocol Manual Revision 2.2 Firmware Revision: 2.0 or

Command Summary 6 Region File Touch regions may be defined using a simple text file for speed and greater ease of use. Each line in a region file

7 Command Summary 1.5 Application Notes Full demonstration programs and code are available for many different Matrix Orbital displays in a number o

Command Summary 8 2 Commands 2.1 Basic Commands 1.1 Set Customer Data Dec Hex ASCII 254 52 FE 34 þ 4 Length Data Length Data Length Data 2.0 Wri

9 Command Summary 1.6 Read ScratchPad Dec Hex ASCII 254 205 FE CD þ Í Index Length Index Length Index Length 2.0 Read data previously stored in

Command Summary 10 2.4 Set Flow Control Mode Dec Hex ASCII 254 58 FE 3A þ : FlowControl FlowControl FlowControl 2.0 Toggle flow control between

11 Command Summary 2.3 Module 3.1 Get Protocol Revision Dec Hex ASCII 254 0 FE 00 þ [NUL] 2.0 Read the firmware version currently used by the di

Command Summary 12 3.6 Get Module Type Dec Hex ASCII 254 55 FE 37 þ 7 2.0 Read a two byte value that can be used to identify the display. Retur

13 Command Summary 2.4 Drawing 4.1 Set Background Drawing Colour Dec Hex ASCII 254 86 FE 56 þ V R G B R G B R G B 2.0 Set the display colour whe

Command Summary 14 4.5 Enable Manual Update Dec Hex ASCII 254 90 FE 5A þ Z Enable Enable Enable 2.0 Stop all drawing commands from automaticall

15 Command Summary 4.9 Get Drawing Colour Dec Hex ASCII 254 100 FE 64 þ d 2.0 Read the colour that is currently being used by all drawing comma

Revision History Revision Date Description Author 2.2 26 September 2014 Added Region Activation Features, Improved Readability Clark 2.1 8 April 201

Command Summary 16 4.14 Draw Filled Rectangle Dec Hex ASCII 254 120 FE 78 þ x X Y Width Height X Y Width Height X Y Width Height 2.0 Draw a fil

17 Command Summary 4.19 Draw Rounded Rectangle Dec Hex ASCII 254 127 FE 7F þ • X Y Width Height Radius X Y Width Height Radius X Y Width Height

Command Summary 18 2.5 Buffers 5.1 Load Font Dec Hex ASCII 254 40 FE 28 þ ( Index FileName Index FileName Index FileName 2.0 Load a font file fr

19 Command Summary 5.3 Copy Screen Rectangle Dec Hex ASCII 254 96 FE 60 þ ` Index X Y Width Height Index X Y Width Height Index X Y Width Height

Command Summary 20 5.7 Clear All Buffers Dec Hex ASCII 254 209 FE D1 þ Ñ 2.0 Clear all data from all buffers, freeing significant buffer memory.

21 Command Summary 2.6 Text 6.1 Create a Label Dec Hex ASCII 254 16 FE 10 þ [DLE] Index X Y Width Height Rot VJst HJst Font R G B Index X Y Width

Command Summary 22 6.3 Print Unicode String Dec Hex ASCII 254 36 FE 24 þ $ Length Text Length Text Length Text 2.0 Print a Unicode formatted

23 Command Summary 6.8 Set Text Window Dec Hex ASCII 254 43 FE 2B þ + X Y Width Height X Y Width Height X Y Width Height 2.0 Create an invisibl

Command Summary 24 6.13 Get Font Dec Hex ASCII 254 48 FE 30 þ 0 2.0 Read the font index of the font currently in use. Return Message 252 48 Len

25 Command Summary 6.19 Get Text Insertion Point Dec Hex ASCII 254 122 FE 7A þ z 2.0 Read the upper left coordinate of the next text string to

Contents 1 Introduction ...

Command Summary 26 2.7 Bitmaps 7.1 Display Bitmap Dec Hex ASCII 254 97 FE 61 þ a Index X Y Index X Y Index X Y 2.0 Display a bitmap previously l

27 Command Summary 2.8 NineSlices 8.1 Display 9-Slice Dec Hex ASCII 254 145 FE 91 þ ‘ Index X Y Width Height Index X Y Width Height Index X Y Wid

Command Summary 28 2.9 Animations 9.1 Set Up Animation Dec Hex ASCII 254 193 FE C1 þ Á Index Instance X Y Index Instance X Y Index Instance X Y

29 Command Summary 9.5 Stop All Animations Dec Hex ASCII 254 198 FE C6 þ Æ 2.0 Stop all currently running animations at their present frame. 9

Command Summary 30 2.10 Graphs 10.1 List All Bargraphs Dec Hex ASCII 254 102 FE 66 þ f 2.0 Read a list of all bargraph entries. Three bytes per

31 Command Summary 10.3 Define A 9-Slice Bargraph Dec Hex ASCII 254 104 FE 68 þ h Index Min Max X Y Width Height BFG BBG D Index Min Max X Y Widt

Command Summary 32 10.7 Reset a Trace Value Dec Hex ASCII 254 109 FE 6D þ m Index Index Index 2.1 Clear all data from a specified trace, and eras

33 Command Summary Table 26: eTraceTypeandDirection values Value Description 0 Bar 1 Line 2 Step 3 Box 0 Bottom Left 16 Left Up 32 Top Right 48 Ri

Command Summary 34 10.14 Set Trace Min/Max Dec Hex ASCII 254 148 FE þ Index Min Max Index Min Max Index Min Max 2.2 Update the min and

35 Command Summary 2.11 Keypad 11.1 Clear Key Buffer Dec Hex ASCII 254 69 FE 45 þ E 2.0 Clear all saved key presses from the key buffer. 11.2 S

2.8 NineSlices ...

Command Summary 36 11.6 Set Auto Repeat Mode Dec Hex ASCII 254 165 FE A5 þ ¥ Mode Mode Mode 2.0 Set key press repeat mode to typematic or hold.

37 Command Summary 2.12 Touch 12.1 Create A Touch Region Dec Hex ASCII 254 132 FE 84 þ „ Index X Y Width Height Up Down Index X Y Width Height Up

Command Summary 38 12.5 Set Dragging Threshold Dec Hex ASCII 254 137 FE 89 þ ‰ Threshold Threshold Threshold 2.0 Set the distance a press is re

39 Command Summary 12.9 Set Out of Region Setting Dec Hex ASCII 254 142 FE 8E þ Ž Setting Setting Setting 2.0 Set reporting status for out of r

Command Summary 40 2.13 Output 13.1 Set GPO State Dec Hex ASCII 254 73 FE 49 þ I Number Setting Number Setting Number Setting 2.0 Toggle the spe

41 Command Summary 13.5 Activate Buzzer Dec Hex ASCII 254 187 FE BB þ » Frequency Duration Frequency Duration Frequency Duration 2.0 Generate a

Command Summary 42 2.14 Scripts 14.1 Run Script File Dec Hex ASCII 254 93 FE 5D þ ] FileName FileName FileName 2.0 Send an array of bytes saved

43 Command Summary 3 Appendix 3.1 Command Summary Available commands below include identifying number, required parameters, the returned response a

Command Summary 44 Table 37: Drawing Commands Name Dec Hex ASCII Parameters Response Set Background Drawing Colour 86 56 V R, G, B None Get Backgro

45 Command Summary Table 39: Text Commands Name Dec Hex ASCII Parameters Response Create a Label 16 10 [DLE] Index, X, Y, Width, Height, Rot, VJst,

1 Command Summary 1 Introduction 1.1 Communication Settings The multiple communication protocols available and simple command structure of the GTT

Command Summary 46 Table 42: Animations Commands Name Dec Hex ASCII Parameters Response Set Up Animation 193 C1 Á Index, AnimationNum, X, Y None St

47 Command Summary Table 45: Touch Commands Name Dec Hex ASCII Parameters Response Create A Touch Region 132 84 „ Index, X, Y, Width, Height, Up, D

Command Summary 48 3.2 Data Types Common Language Representations The following table outlines native data types in common programming languages t

49 Command Summary 4 Definitions 9-Slice: Graphic format used to scale bitmaps, usually rectangular, without distorting their geometry. Nine regio

Command Summary 2 1.2 Basic Features Drawing The most basic commands available for the GTT line are the drawing features. Simple shapes, from pixe

3 Command Summary Fonts TrueType Font (.ttf) files can be uploaded to the SD memory card, loaded into a font buffer, and used to display customizab

Command Summary 4 Animations While the image data for animations is stored in the Animation buffer, the actual state of animations is stored in a s

5 Command Summary 1.2 Interactive Input Keypad Unique values can be assigned for up to 25 keys. When a key event occurs it will be saved to a 20 k