Page 1
GLK240128-25/GLT240128 Including GLK240128-25-USB, GLK240128-25-422, GLT240128-USB, and GLT240128-422 Technical Manual Revision 3.0 PCB Revision: 4.0 or Higher Firmware Revision: 8.1 or Higher...
Page 2
Revision History Revision Date Description Author October 19, 2015 Revision to Commands for Firmware Revision 8.6 Clark May 21, 2014 Revision to Commands for Firmware Revision 8.5 Martino March 12, 2014 Revision and correction to Colour in Ordering Options Martino September 9, 2013 Corrected Scripted Button/Key and Keypad Brightness Commands Clark...
Contents 1 Introduction ............................... 1 2 Quick Connect Guide..........................2 2.1 Available Headers ..........................2 2.2 Standard Module ..........................3 Recommended Parts ..........................3 Serial Connections ..........................3 C Connections ............................. 4 2.3 USB Module ............................5 Recommended Parts ..........................5 USB Connections ...........................
Page 4
4.4 GLK Model ............................13 Keypad Header ............................ 13 4.5 GLT Model ............................14 Touch Screen ............................14 Coordinate Mode ..........................14 Region Mode ............................14 4.6 Common Features ..........................15 General Purpose Outputs ........................15 Dallas One-Wire Connector ........................ 15 5 Troubleshooting ............................
In addition to the RS232, TTL and I2C protocols available in the standard model, USB and RS422 communication models allow the GLK240128- 25/GLT240128 to be connected to a wide variety of host controllers. Communication speeds of up to 115.2kbps for serial protocols and 100kbps for I C ensure lightning fast text and graphic display.
2 Quick Connect Guide 2.1 Available Headers Figure 2: GLK240128-25/GLT240128 Header Locations Table 1: List of Available Headers Header Mate Population Mini USB Connector EXTMUSB3FT/INTMUSB3FT USB Model Only RS422 Terminal Block 16-30 AWG Wire 422 Model Only DB9 Serial Header...
2.2 Standard Module The standard version of the GLK240128-25/GLT240128 allows for user configuration of two common communication protocols. First, the unit can communicate using serial protocol at either RS323 or TTL voltage levels. Second, it can communicate using the Inter-Integrated Circuit connect, or I C protocol.
3. Create. This time you're on your own. While there are many examples within the Matrix Orbital AppNote section, www.matrixorbital.ca/appnotes, too many controllers and languages exist to cover them all. If you get stuck in development, it is possible to switch over to another protocol on the standard board, and fellow developers are always on our forums for additional support.
The USB connection is the quickest, easiest solution for PC development. After driver installation, the GLK240128-25-USB/GLT240128-USB will be accessible through a virtual serial port, providing the same result as a serial setup without the cable hassle. To connect to your GLK240128-25-USB/GLT240128- USB please follow the steps below.
Connections section. RS422 Connections The GLK240128-25-422/GLT240128-422 provides a robust RS422 interface to the display line. For this interface, a series of six wires are usually screwed into the RS422 terminal block provided. An alternate header is also available to provide local power to a regular or -V unit. To connect to your GLK240128- 25-422/GLT240128-422, adhere to the steps laid out below.
The multiple communication protocols available and simple command structure of the GLK240128- 25/GLT240128 means that a variety of applications can be used to communicate with the display. Text is sent to the display as a character string, for example, sending the decimal value 41 will result in an 'A' appearing on the screen.
This program provides both a staging areas for your graphics display and a proving ground that will prepare it for any application environment. 3.2 Firmware Upgrade Beginning with revision 8.1, the firmware of the GLK240128-25/GLT240128 can be upgraded in the field. All firmware revisions can be installed using software found at www.matrixorbital.ca/software/GLT Series.
Figure 7: Extended Communication/Power Header The Extended Communication/Power Header provides a standard connector for interfacing to the GLK240128-25/GLT240128. Voltage is applied through pins one and four of the four pin Communication/Power Header. Please ensure the correct voltage input for your display by referencing Voltage Specifications before connecting power.
DB-9 Jumper labelled R82, as illustrated below. This connection can be made using a zero ohm resistor, recommended size 0603, or a solder bridge. The GLK240128-25/GLT240128 allows all voltage models to use the power through DB-9 option, see the Voltage Specifications for power requirements.
171822-4 for example, from a PC power supply for a simple bench power solution. *Note: The YG version of the GLK240128-25-USB/GLT240128-USB may draw more than the 500mA of current permitted by USB standards and will require the alternate power connection. Command Summary...
Tx (A) Figure 12: RS422 Header The six pin RS422 interface header of the GLK240128-25-422/GLT240128-422 offers power and ground connections as well as two differential pair communication lines. Regular and inverted lines are provided for both receive and transmit signals. Power is supplied locally to the regular or –V variants while the –VPT can receive power over a distance.
“Assign Key Codes” command. The straight twelve pin header of the Keypad Interface Connector will interface to a variety of different devices including the Matrix Orbital KPP4x4 keypad. *Note: In I C mode, the “Auto Transmit Keypress”...
4.5 GLT Model Touch Screen The GLT240128 facilitates user touch input in one of two distinct ways. Coordinate mode will report events by supplying their exact position on the screen. Region mode will report events within defined boundaries on the screen. Both modes are outlined below.
Function Figure 16: Dallas One-Wire Connector In addition to the six general purpose outputs the GLK240128-25/GLT240128 offers an Optional Dallas One-Wire bridge, to allow for an additional thirty two one-wire devices to be connected to the display. This header can be populated with a Tyco 173979 connector at an added cost by custom order only.
See the Manual Override section to reset to default. • Make sure that the start screen is not blank. It is possible to overwrite the Matrix Orbital logo start screen, if this happens the screen may be blank. Try writing to the display to ensure it is functional, after checking the contrast above.
2. Place a jumper on the two manual override pins, for the GLK240128-25 model these are the middle two keypad pins, for the GLT240128 these are the two pins near the keypad header. 3. Reconnect power to your unit, and wait for the start screen before removing the jumper. Please note the jumper will adversely affect GLT240128 performance if left in place during use.
6 Commands 6.1 Communication 1.1 Change 254 57 Speed v8.0 Baud Rate FE 39 Speed ■ 9 ASCII Speed Immediately changes the baud rate. Not available in I2C. Baud rate can be temporarily forced to 19200 by a manual override. Speed Byte Valid settings shown below.
Page 24
1.5 Set Flow 254 63 Mode v8.0 Control Mode FE 3F Mode ■ ? ASCII Mode Toggles flow control between hardware, software and off settings. Software and Hardware control can be further tuned using the settings above. Default is Off, or 0. Mode Byte Flow control setting as below.
1.10 Echo 254 255 Length Data v8.3 FE FF Length Data ■ ASCII Length Data Send data to the display that it will echo. Useful to confirm communication or return information from scripts. Length Short Length of data array to be echoed. Data Byte(s) An arbitrary array of data that the module will return.
Page 26
2.4 Set Cursor 254 121 v8.0 Coordinate FE 79 ■ y ASCII Sets the cursor to an exact pixel position where the next transmitted character is printed. Byte Value between 1 and screen width, represents leftmost character position. Byte Value between 1 and screen height, represents topmost character position. 2.5 Get String 254 41 Text...
Page 27
2.9 Initialize 254 45 ID X1 Y1 X2 Y2 Vert Hor Font Background CharSpace v8.3 Label FE 2D ID X1 Y1 X2 Y2 Vert Hor Font Background CharSpace ■ - ASCII ID X1 Y1 X2 Y2 Vert Hor Font Background CharSpace Designates a portion of the screen that can be easily updated with one line of text, often used to display variables.
2.13 Auto Scroll 254 82 v8.0 FE 52 ■ R ASCII New text is written over the top line when the end of the screen is reached. Display default is Auto Scroll on. 6.3 Drawing 3.1 Set Drawing 254 99 Colour v8.0 Colour...
Page 29
3.5 Draw a 254 114 Colour X1 Y1 X2 Y2 v8.0 Rectangle FE 72 Colour X1 Y1 X2 Y2 ■ r ASCII Colour X1 Y1 X2 Y2 Draw a rectangular frame one pixel wide using the colour specified; current drawing colour is ignored. Colour Byte 0 for background or any other value for text colour.
Page 30
3.9 Draw a 254 123 X Y Radius v8.3 Circle FE 7B X Y Radius ■ { ASCII X Y Radius Draw a circular frame one pixel wide using the current drawing colour. Byte Horizontal coordinate of the circle centre. Byte Vertical coordinate of the circle centre.
Page 31
3.14 Initialize a 254 103 ID Type X1 Y1 X2 Y2 v8.3 Bar Graph FE 67 ID Type X1 Y1 X2 Y2 ■ g ASCII ID Type X1 Y1 X2 Y2 Initialize a bar graph in memory for later implementation. Graphs can be located anywhere on the screen, but overlapping may cause distortion.
Page 32
3.17 Initialize a 254 110 ID X1 Y1 X2 Y2 Min Max Step Style ID v8.3 Strip Chart FE 6E ID X1 Y1 X2 Y2 Min Max Step Style ID ■ n ASCII ID X1 Y1 X2 Y2 Min Max Step Style ID Designate a portion of the screen for a chart.
Front files alter the style of text and appearance of the display. By default, a Matrix Orbital graphic display is loaded with a small filled font in slot one and a future bk bt 16 style in slot two. Both are available at www.matrixorbital.ca/software/graphic_fonts.
Page 34
Table 22: Example Font File Header Maximum Width Character Height ASCII Start Value ASCII End Value The font file header contains four bytes: First, the number of columns in the widest character; usually ‘w’, second, the pixel height of each character, and finally, the start and end values of the character range.
Bitmap file data, see the Bitmap File Creation example. Bitmap File Creation In addition to fonts, Matrix Orbital graphic displays can also hold a number of customizable bitmaps to provide further stylistic product integration. Like font files, bitmaps files are most easily uploaded to a display using MOGD#.
Bitmap Masking Like a regular bitmap, a mask can be loaded to the display and used to create a more polished result when drawing in populated areas. When defining a mask, all active values will clear any background information, while any inactive values will leave it untouched. This is best described with an example. Figure 18: Drawing with a Mask Figure 17: Drawing without a Mask 6.6 9-Slices...
9-Slice File Creation A 9-slice file is a scalable graphic composed of nine different bitmap sections as shown below. Figure 19: Adobe 9-slice Representation The 9-slice file format requires that the bitmap dimensions and the locations of divisions be defined before a graphic is uploaded normally as shown in the Bitmap File Creation example.
7.2 Display 254 193 ID File v8.3 Animation FE C1 ID File ■ ┴ ASCII ID File Load the first frame of the specified animation in its stopped state at the specified location. If an animation is already in use at that index it will be overwritten. Use the start animation command to play the displayed file. Byte Unique animation identification number, value between 0 and 15.
Table 31: Animation file format Total Frames One byte representing the total number of frames in the animation Offsets One entry for each frame, 4 bytes indicating the start of the bitmap file. Maximum 32 frames. Times Two bytes for each frame representing the length of time (100ms) for which it is displayed. Header 1 Two bytes, one representing the width and one the height of the first bitmap.
9.3 Set Keypad 254 182 Frequency Duration v8.4 Buzzer Beep FE B6 Frequency Duration ■ ASCII ╢ Frequency Duration Set the frequency and duration of the default beep transmitted when a key is pressed. Frequency Short Frequency of the beep in Hertz, default is 0 or off. Duration Short Duration of the beep in milliseconds, default is 0 or off.
Page 42
10.5 Set 254 85 Time v8.0 Debounce Time FE 55 Time ■ U ASCII Time Sets the time between a key press and a key read by the display. Most switches will bounce when pressed; the debounce time allows the switch to settle for an accurate read. Default is 8 representing approximately 52ms. Time Byte Debounce increment (debounce time =...
10.10 Set 254 158 Interval v8.4 Typematic FE 9E Interval ■ ₧ Interval ASCII Interval Sets the interval between reported key presses when a key is held and the display is in typematic mode. Interval Byte Time between key reports, specified in 100ms increments, default is 2 (200ms). 6.11 Touchpad 11.1 Set Touch 254 135...
Page 44
11.5 Delete All 254 134 v8.0 Touch Regions FE 86 ■ å ASCII Deletes all previously created touch regions. Recommended for use before dividing the screen into new regions. 11.6 Create a 254 186 ID Type X Y Width Height Control Width Min Max v8.3 Slider FE BA...
11.9 Set 254 137 Threshold v8.0 Dragging FE 89 Threshold ■ ë Threshold ASCII Threshold Sets the distance a press is required to travel before a drag event is reported. Precision will vary inversely to data transmitted; care should be taken to find a suitable balance. Distance is calculated as Threshold Byte Dragging threshold value.
12.4 Set and Save 254 152 Brightness v8.0 Brightness FE 98 Brightness ■ ÿ ASCII Brightness Immediately sets and saves the backlight brightness. Although brightness can be changed using the set command, it is reset to this saved value on start up. Default is 255. Brightness Byte Brightness level from 0(Dim) to 255(Bright).
13.3 Set Scripted 254 142 ID X Y Width Height Type Down Script Up Script v8.3 Button FE 8E ID X Y Width Height Type Down Script Up Script ■ Ä ASCII ID X Y Width Height Type Down Script Up Script Create a button region that responds to a touch event by executing an uploaded script.
Page 48
14.4 Get Filesystem 254 179 v8.0 Directory FE B3 ■ │ ASCII Returns a directory to the contents of the filesystem. The total number and type of each entry will be provided. Response Short Number of entries. Byte(s) [8] 8 identification bytes for each entry. Table 36: Filesystem Identification Bytes Byte Description...
Page 49
14.8 File 254 180 Old Type Old ID New Type New ID v8.0 Move FE B4 Old Type Old ID New Type New ID ■ ┤ ASCII Old Type Old ID New Type New ID Used to move a single file and/or alter the type of an existing file. Old ID location must be valid and new ID empty. Old Type Byte Original file type, value between 0 and 1023, see File Types .
Once a bitmap or font file has been created and paired to its command it must be sent using a file protocol developed specifically for Matrix Orbital displays. Once a file upload command has been sent requesting a unique reference number and specifying the file size required, the display will respond indicating whether it has enough room to save the file or not.
XModem Transfer Protocol In addition to its original simple upload format, Matrix Orbital has added an XModem based protocol. This facilitates much faster download speeds by increasing the packet size from 1 byte to 128 bytes and using only a two byte CRC for error checking, greatly increasing throughput.
Page 52
Table 42: XModem File Upload Protocol Table 43: XModem File Download Protocol Host Display Comments Host Display Comments Command Prefix Command Prefix XModem Upload Command XModem Download Command Command Byte One Command Byte One Command Byte Two Command Byte Two Command Byte Three Command Byte Three File ID LSB...
6.15 Data Security 15.1 Set 254 147 Switch v8.0 Remember FE 93 Switch ■ ô ASCII Switch Allows changes to specific settings to be saved to the display memory. Writing to non-volatile memory can be slow and each change consumes 1 write of at least 100,000 available. The Command Summary outlines which commands are saved always, never, and when this command is on only.
6.16 Miscellaneous 16.1 Write 254 52 Data v8.0 Customer Data FE 34 Data ■ 4 ASCII Data Saves a user defined block of data to non-volatile memory. Useful for storing display information for later use. Data Byte [16] User defined data. 16.2 Read 254 53 v8.0...
Page 55
■ 7 ASCII Causes display to respond with its module number. Response Byte Module number, see Sample Module Type Responses for a partial list. Table 47: Sample Module Type Responses GLT240128 GLK240128-25 GLT240128-USB GLK240128-25-USB GLT240128-422 GLK240128-25-422 16.7 Read 254 184 v8.1...
7 Appendix 7.1 Command Summary Available commands below include identifying number, required parameters, the returned response and an indication of whether settings are remembered always, never, or with remember set to on. Table 48: Communication Command Summary Name ASCII Parameters Response Remembered Change Baud Rate...
Page 57
Table 50: Drawing Command Summary Name ASCII Parameters Response Remembered Set Drawing Colour Byte None Remember On Draw Pixel Byte[2] None Never Draw a Line Byte[4] None Never Continue a Line Byte[2] None Never Draw a Rectangle Byte[5] None Never Draw a Filled Rectangle Byte[5] None...
Page 59
Table 57: Keypad Command Summary Name ASCII Parameters Response Remembered Auto Transmit Key Presses On None None Remember On Auto Transmit Key Presses Off None None Remember On Poll Key Press & None Byte Never Clear Key Buffer None None Never Set Debounce Time Byte...
Page 60
Table 61: Filesystem Command Summary Name ASCII Parameters Response Remembered Delete Filesystem 33, 89, 33 21, 59, 21 !, Y, ! None None Always Delete a File ¡ Byte, Short None Always Get Filesystem Space » None Integer Never │ Get Filesystem Directory None Byte[][8]...
Storage Temperature -10°C to +60°C -30°C to +80°C Operating Relative Humidity Maximum 90% non-condensing *Note: The Extended Temperature option is not available for any variant of the GLT240128. 7.3 Electrical Tolerances Current Consumption Table 65: Current Consumption Board Backlight GPOs...
7.1 Optical Characteristics Table 68: Display Optics Module Size 144.00 x 104.00 x 27.8 Viewing Area 114.0 x 64.0 Active Area 107.95 x 57.55 Pixel Size 0.40 x 0.40 Pixel Pitch 0.45 x 0.45 Viewing Direction O’clock Viewing Angle -30 to +30 °...
8.3 Accessories Power Table 71: Power Accessories Standard Power Cable Communication Table 72: Communication Accessories CSS1FT 1 ft. Serial Cable CSS4FT 4 ft. Serial Cable EXTMUSB3FT Mini-USB Cable INTMUSB3FT Internal Mini-USB Cable Extended Serial Communication/5V ESCCPC5V Power Cable Breadboard Cable Command Summary...
9 Definitions ASCII: American standard code for information interchange used to give standardized numeric codes to alphanumeric characters. BPS: Bits per second, a measure of transmission speed. Byte: An unsigned data packet that is eight bits long. FFSTN: Double film super-twisted nematic in reference to an LCD. The addition of two layers of film between the STN display and polarizer improves contrast.
Need help?
Do you have a question about the GLT240128 and is the answer not in the manual?
Questions and answers