Revision History Revision Date Description Author January 3, 2018 Correction to Set Non-Standard Baud Rate command Divino 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...
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 ............................
User input on the GLK240128-25 is available through a five by five matrix style keypad or a resistive touch overlay on the GLT240128. Six general purpose outputs provide simple switchable five volt sources on each model.
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.
3.1 MOGD# The Matrix Orbital Graphic Display interface, MOGD#, is offered as a free download from www.matrixorbital.ca/software/software_graphic. It provides a simple graphical interface that allows settings, fonts, and bitmaps to be easily customised for any application.
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.
Row 5 Gnd/Vcc* To facilitate user input, the GLK240128-25 provides a Keypad Interface Connector which allows a matrix style keypad of up to twenty-five keys to be directly connected to the display module. Key presses are generated when a short is detected between a row and a column. When a key press is generated, a character specific to that key press is automatically sent on the Tx communication line.
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. Coordinate Mode In coordinate mode all touch events are reported using three single byte values.
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.
To override the display, please follow the steps below. 1. Disconnect power from your display. 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.
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.6 Set Hardware 254 62 Level v8.0 Flow Control FE 3E Level ■ > Trigger Level ASCII Level Sets the hardware flow control trigger level. The Clear To Send signal will be deactivated once the number of characters in the display buffer reaches the level set; it will be reactivated once all data in the buffer is handled. Level Byte Trigger level as above.
1.12 Software 254 253 77 79 117 110 v8.4 Reset FE FD 4D 4F 75 6E ■ ² M O u n ASCII Reset the display as if power had been cycled via a software command. No commands should be sent while the unit is in the process of resetting;...
Page 26
2.6 Initialize 254 43 ID X1 Y1 X2 Y2 Font CharSpace LineSpace Scroll v8.3 Text Window FE 2B ID X1 Y1 X2 Y2 Font CharSpace LineSpace Scroll ■ + ASCII ID X1 Y1 X2 Y2 Font CharSpace LineSpace Scroll Designates a portion of the screen to which text can be confined. Font commands affect only the current window, default (entire screen) is window 0.
2.10 Initialize 254 47 ID X1 Y1 X2 Y2 Vert Dir Font Background CharSpace Delay v8.6 Scrolling Label FE 2F ID X1 Y1 X2 Y2 Vert Dir Font Background CharSpace Delay ■ / ASCII ID X1 Y1 X2 Y2 Vert Dir Font Background CharSpace Delay Designates a portion of the screen that can be easily updated with one line of text, often used to display variables.
Page 28
3.2 Draw 254 112 v8.0 Pixel FE 70 ■ p ASCII Draw a single pixel at the specified coordinate using the current drawing colour. Byte Horizontal position of pixel to be drawn. Byte Vertical position of pixel to be drawn. 3.3 Draw a 254 108 X1 Y1 X2 Y2...
Page 29
3.7 Draw a 254 128 X1 Y1 X2 Y2 Radius v8.3 Rounded FE 80 X1 Y1 X2 Y2 Radius ■ Ç Rectangle ASCII X1 Y1 X2 Y2 Radius Draw a rounded rectangular frame one pixel wide using the current drawing colour. Byte Leftmost coordinate of the rectangle.
Page 30
3.12 Draw a 254 127 X Y XRadius YRadius v8.3 Filled Ellipse FE 7F X Y XRadius YRadius ■ ASCII X Y XRadius YRadius Draw an ellipse using the current drawing colour. Byte Horizontal coordinate of the ellipse centre, zero indexed from left. Byte Vertical coordinate of the ellipse centre, zero indexed from top.
Page 31
3.15 Initialize 9- 254 115 ID Type X1 Y1 X2 Y2 Fore 9Slice Back 9Slice v8.3 Slice Bar Graph FE 73 ID Type X1 Y1 X2 Y2 Fore 9Slice Back 9Slice ■ s ASCII ID Type X1 Y1 X2 Y2 Fore 9Slice Back 9Slice Initialize a 9-slice bar graph in memory for later implementation.
3.18 Update a 254 111 ID Value v8.3 Strip Chart FE 6F ID Value ■ o ASCII ID Value Shift the specified strip chart and draw a new value. Byte Chart identification number, value between 0 and 7. Value Short Value to add to the 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.
The character data is a binary graphical representation of each glyph in a font. Each character is drawn on a grid containing as many rows as the height specified in the header and as many columns as the width specified in the character table. Cells are drawn by writing a one in their location and cleared by setting a value of zero.
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#.
Table 27: Smiley Face Bitmap Table 28:Smiley Face Data Table 29: Example Bitmap File Header Bitmap Data 80 34 224 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.
6.3 Display a 254 91 ID X1 Y1 X2 Y2 v8.3 9-Slice FE 5B ID X1 Y1 X2 Y2 ■ [ ASCII ID X1 Y1 X2 Y2 Displays a previously loaded 9-slice at the specified location. Short Unique 9-slice identification number, value between 0 and 1023. Byte Leftmost coordinate of the 9-slice.
6.7 Animations 7.1 Upload an 254 92 4 File ID Size Data v8.3 Animation File FE 5C 04 File ID Size Data ■ \ ASCII File ID Size Data Upload an animation file to a graphic display. To create an animation see the Animation File Creation section, for upload protocol see the File Transfer Protocol or XModem Transfer Protocol entries.
7.6 Get 254 196 v8.3 Animation FE C4 ■ ─ Frame ASCII Get the current frame of a displayed animation. Byte Animation number to request frame number, value between 0 and 15. Response Byte Current frame number of the animation specified, value between 0 and 31. Animation File Creation An animation file is a series of bitmaps, each displayed for a specified length of time within a continuous rotation.
6.9 Piezo Buzzer 9.1 Activate Piezo 254 187 Frequency Time v8.0 Buzzer* FE BB Frequency Time ■ ╗ ASCII Frequency Time Activates a buzz of specific frequency from the onboard piezo buzzer for a specified length of time. Frequency Short Frequency of buzz in hertz.
Page 41
10.3 Poll Key 254 38 v8.0 Press FE 26 ■ & ASCII Reads the last unread key press from the 10 key display buffer. If another key is stored in the buffer the MSb will be 1, the MSb will be 0 when the last key press is read. If there are no stored key presses a value of 0 will be returned.
10.8 Assign Keypad 254 213 Key Down Key Up v8.0 Codes FE D5 Key Down Key Up ■ ╒ ASCII Key Down Key Up Assigns the key down and key up values sent to the host when a key press is detected. A key up and key down value must be sent for every key, a value of 255 will leave the key unaltered.
Page 43
11.2 Set Region 254 136 Mode v8.0 Reporting Mode FE 88 Mode ■ ê ASCII Mode Defines the events transmitted in region mode. Allows only events specified to return a value to the host. Key down values are transmitted for press and drag events, key up for release, and the value 255 for out of region. Mode Byte Defines the events reported, see Region Reporting Mode.
Page 44
11.6 Create a 254 186 ID Type X Y Width Height Control Width Min Max v8.3 Slider FE BA ID Type X Y Width Height Control Width Min Max ■ ║ ASCII ID Type X Y Width Height Control Width Min Max Draw a slider on the screen that responds visually and numerically when tapped or slid.
11.10 Set 254 138 Threshold v8.0 Pressure FE 8A Threshold ■ è Threshold ASCII Threshold Sets the pressure required to trigger a touch event. Threshold Short Pressure threshold value. Default is 1000. 11.11 Run 254 139 v8.0 Touchpad FE 8B ■...
12.5 Set 254 80 Contrast v8.0 Contrast FE 50 Contrast ■ P ASCII Contrast Immediately sets the contrast between background and text. If an inverse display color is used this also represents the text brightness. Default is 128. Contrast Byte Contrast level from 0(Light) to 255(Dark).
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.
Page 54
FE 37 ■ 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 Command Summary...
Page 55
16.7 Read 254 184 v8.1 Screen FE B8 ■ ╕ ASCII Return a two byte screen size, followed by the current commanded state of each pixel on the screen. Response Byte Width of the screen in pixels. Byte Height of the screen in pixels. Byte(s) Boolean values of each pixel on the screen, starting top left moving right then down.
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]...
7.1 Block Diagram Figure 20: Functional Diagram 7.2 Environmental Specifications Table 64: Environmental Limits Standard *Extended (-E) Operating Temperature 0°C to +50°C -20°C to +70°C 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.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 GLK240128-25 and is the answer not in the manual?
Questions and answers