Summary of Contents for Matrix Orbital GLK12232A-25-SM
Page 1
Distributed by www.texim‐europe.com GLK12232A-25-SM/GLT12232A-SM Including GLK12232A-25-SM-USB and GLT12232A-SM-USB Technical Manual Revision 3.5 PCB Revision: 3.0 or Higher Firmware Revision: 8.4 or Higher...
Distributed by www.texim‐europe.com Revision History Revision Date Description Author January 3, 2018 Correction to Set Non-Standard Baud Rate command Divino October 19, 2015 Minor command updates Clark September 21, 2015 Updated commands for Firmware Revision 8.6 Clark January 30, 2015 Updated Drawings Clark May 21, 2014...
Distributed by www.texim‐europe.com 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 ............................4 Recommended Parts ..........................
Page 4
Distributed by www.texim‐europe.com Region Mode ............................11 5 Troubleshooting ............................12 5.1 Power ..............................12 5.2 Display ............................... 12 5.3 Communication ..........................12 5.4 Manual Override ..........................13 6 Commands ............................... 14 6.1 Communication ..........................14 6.2 Text..............................16 6.3 Drawing ............................. 18 6.4 Fonts ..............................
User input on the GLK12232A-25-SM is available through a five by five matrix style keypad or a resistive touch overlay on the GLT12232A-SM. In addition, two general purpose outputs provide simple switchable five volt sources on each model, while a small piezo speaker offers audio feedback for a completely interactive experience.
Distributed by www.texim‐europe.com 2 Quick Connect Guide 2.1 Available Headers Figure 2: GLK12232A-25-SM/GLT12232A-SM Standard Module Header Locations Figure 3: GLK12232A-25-SM/GLT12232A-SM USB Module Header Locations Table 1: List of Available Headers Header Mate Population GPO Header None Offered All Models Keypad...
Distributed by www.texim‐europe.com 2.2 Standard Module The standard version of the GLK12232A-25-SM/GLT12232A-SM allows for user configuration of two common serial levels. The unit can communicate using serial protocol at either RS323 or TTL voltage levels. Connections for each serial protocol can be accessed through the six pin Communication/Power Header as outlined in the Serial Connections section below.
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 GLK12232A-25-SM-USB/GLT12232A-SM-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 GLK12232A-25-SM- USB/GLT12232A-SM-USB please follow the steps 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.
Series. 3.3 Application Notes Full demonstration programs and code are available for Matrix Orbital displays in the C# language from Simple C# AppNote Pack in the Application Note section at www.matrixorbital.ca/appnotes. Many additional applications are available in a number of different programming languages. These programs are meant to showcase the capability of the display and are not intended to be integrated into a final design.
Figure 8: Extended Communication/Power Header The Extended Communication/Power Header provides a standard connector for interfacing to the GLK12232A-25-SM/GLT12232A-SM. Voltage is applied through pins one and four of the six pin Extended Communication/Power Header. Please ensure the correct voltage input for your display by referencing the Voltage Specifications before connecting power.
NC/Vcc Figure 11: Alternate Power Connector The Alternate Power Connector provides the ability to power the GLK12232A-25-SM-USB/GLT12232A- SM-USB using a second cable. The Tyco 171825-4 style header is particularly useful for connecting to an unmodified floppy power cable, a 171822-4 for example, from a PC power supply for a simple bench power solution.
Row 5 Gnd/Vcc* To facilitate user input, the GLK12232A-25-SM 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.
Distributed by www.texim‐europe.com 4.5 GLT Model Touch Screen The GLT12232A-SM 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.
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.
Distributed by www.texim‐europe.com 5.4 Manual Override Should the settings of your display become altered in a way that dramatically impacts usability, the default settings can be temporarily restored. To override the display, please follow the steps below. 1. Disconnect power from your display. 2.
Distributed by www.texim‐europe.com 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. Baud rate can be temporarily forced to 19200 by a manual override. Speed Byte Valid settings shown below.
Page 21
Distributed by www.texim‐europe.com 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;...
Distributed by www.texim‐europe.com 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 23
Distributed by www.texim‐europe.com 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.
Distributed by www.texim‐europe.com 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 25
Distributed by www.texim‐europe.com 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 26
Distributed by www.texim‐europe.com 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 27
Distributed by www.texim‐europe.com 3.12 Draw a 254 127 X Y XRadius XRadius v8.3 Filled Ellipse FE 7F X Y XRadius XRadius ■ ASCII X Y XRadius XRadius Draw an ellipse using the current drawing colour. Byte Horizontal coordinate of the ellipse centre. Byte Vertical coordinate of the ellipse centre.
Page 28
Distributed by www.texim‐europe.com 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.
Distributed by www.texim‐europe.com 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, between 0 and 7. Value Word 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.
Distributed by www.texim‐europe.com 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.
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#.
Distributed by www.texim‐europe.com 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.
Distributed by www.texim‐europe.com 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. Word Unique 9-slice identification number.
Distributed by www.texim‐europe.com 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 Upload Protocol or XModem Upload Protocol entries.
Distributed by www.texim‐europe.com 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.
Distributed by www.texim‐europe.com 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 Word Frequency of the buzzer beep in Hertz.
Page 38
Distributed by www.texim‐europe.com 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.
Distributed by www.texim‐europe.com 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 40
Distributed by www.texim‐europe.com 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 41
Distributed by www.texim‐europe.com 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.
Distributed by www.texim‐europe.com 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 Word Pressure threshold value. Default is 1000. 11.11 Run 254 139 v8.0 Touchpad FE 8B ■...
Distributed by www.texim‐europe.com 12.5 Set Backlight 254 130 Red Green Blue v8.0 Colour FE 82 Red Green Blue ■ é ASCII Red Green Blue Set the colour of a tri-colour backlight. Only for tri-colour displays. Default is white (255, 255, 255). Byte Brightness level of Red from 0(Dim) to 255(Bright).
Distributed by www.texim‐europe.com 13.3 *Set 254 142 ID Row Column Down Script Up Script v8.4 Scripted Key FE 8E ID Row Column Down Script Up Script ■ Ä ASCII ID Row Column Down Script Up Script Select a previously loaded script to be run when the specified key is pressed. Byte Unique key identification number, maximum based on number of keys available.
Page 45
Distributed by www.texim‐europe.com 14.4 Get Filesystem 254 179 v8.1 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.
Page 46
Distributed by www.texim‐europe.com 14.8 File 254 180 Old Type Old ID New Type New ID v8.1 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 Upload 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 49
Distributed by www.texim‐europe.com The display then performs a CRC check on the data receive and ACKs if it matches that which was sent. Transfer continues with a block count and continues in this way until the end of file is reached. Files may be padded with 255 values to reach an even multiple of 128 bytes in size, but the download command will always report true size.
Distributed by www.texim‐europe.com 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 51
Distributed by www.texim‐europe.com 16.2 Read 254 53 v8.0 Customer Data FE 35 ■ 5 ASCII Reads data previously written to non-volatile memory. Data is only changed when written, surviving power cycles. Response Byte [16] Previously saved user defined data. 16.3 Read Version 254 54 v8.0 Number...
Distributed by www.texim‐europe.com 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 45: Communication Command Summary Name ASCII Parameters...
Page 53
Distributed by www.texim‐europe.com Table 47: 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...
Page 54
Distributed by www.texim‐europe.com Table 50: 9-Slice Command Summary Name ASCII Parameters Response Remembered Upload a 9-Slice File 92 3 5C 03 Word, Double, Byte[] Always 9-Slice File Creation Upload a 9-Slice Mask 92 6 5C 06 Word, Double, Byte[] Always 9-Slice File Creation Display a 9-Slice Word, Byte[4]...
Page 55
Distributed by www.texim‐europe.com Table 54: 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...
Page 56
Distributed by www.texim‐europe.com Table 58: Filesystem Command Summary Name ASCII Parameters Response Remembered Delete Filesystem 33, 89, 33 21, 59, 21 !, Y, ! None None Always Delete a File ¡ Byte, Word None Always Get Filesystem » None Double Never Space Get Filesystem...
Distributed by www.texim‐europe.com 7.1 Block Diagram Figure 17: Functional Diagram 7.2 Data Types The following table outlines native data types in common programming languages that can be used to represent the data types used in this manual. Table 61: Data Types with Representations ANSI C/C++ Visual Basic Byte...
Distributed by www.texim‐europe.com 7.3 Environmental Specifications Table 63: 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 GLT12232A-SM. 7.4 Electrical Tolerances Current Consumption Table 64: Current Consumption...
Distributed by www.texim‐europe.com 8.3 Accessories Power Table 70: Power Accessories Standard Power Cable Communication Table 71: Communication Accessories EXT4PUSB3FT External 4pin USB Cable Extended Serial Communication/5V ESCCPC5V Power Cable Breadboard Cable Peripherals Table 72: Peripheral Accessories KPP4x4 16 Button Keypad Command Summary...
Distributed by www.texim‐europe.com 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. 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.
Page 64
Disclaimer ALL PRODUCTS, PRODUCT SPECIFICATIONS AND DATA ARE SUBJECT TO CHANGE WITHOUT NOTICE TO IMPROVE RELIABILITY, FUNCTION OR DESIGN OR OTHERWISE. Texim Europe B.V. its affiliates, agents, and employees, and all persons acting on its or their behalf (collectively, “Texim”), disclaim any and all liability for any errors, inaccuracies or incompleteness contained in any datasheet or in any other disclosure relating to any product.
Page 65
Texim Europe - contact details Headquarters & Warehouse Elektrostraat 17 NL-7483 PG Haaksbergen The Netherlands +31 (0)53 573 33 33 info@texim-europe.com Homepage: www.texim-europe.com The Netherlands Belgium UK & Ireland Germany Elektrostraat 17 Zuiderlaan 14, box 10 St Mary’s House, Church Lane Bahnhofstrasse 92 NL-7483 PG Haaksbergen B-1731 Zellik...
Need help?
Do you have a question about the GLK12232A-25-SM and is the answer not in the manual?
Questions and answers