background image

 

Command Summary

 

3

 

Software 

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.  A single control character is also available.  Commands are merely values 
prefixed with a special command byte, 254 in decimal. 

Table 2: Reserved Control Characters 

Control Characters 

Bell / Sound Buzzer 

10 

Line feed / New line 

 

Once the correct communication port is identified, the following communication settings can be applied 
to communicate correctly with the GLK240128-25/GLT240128. 

Table 3: Communication Settings 

BPS 

Data Bits  Parity  Stop Bits  Flow Control 

19200 

None 

None 

 

Finally, with a communication port identified and correctly setup simple text strings or even command 
bytes can easily be transmitted to control your display.  

 

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. 

While monochromatic bitmaps can easily be created in virtually any image editing program, MOGD# 
provides an extensive font generation suite to stylize your display to any project design.  In addition to 
standard font wide modifications, character ranges can be specified by start and end values to eliminate 
unused symbols, and individual glyphs can be modified with a double click.  Finally, text spacing can be 
tailored and a complete font library built with your Matrix Orbital graphic display. 

Like uProject, MOGD# offers a scripting capability that provides the ability to stack, run, and save a 
series of commands.  The most basic function is the Send Numeric tool which is used to transmit a string 
of values to the display to write text or execute a command. 

 

 

Summary of Contents for GLK19264A-7T-1U-YG

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: ...n Key and Keypad Brightness Commands Clark 2 6 July 10 2013 Updated Data Packet Size Definitions Clark 2 5 December 13 2012 Added Firmware Revision 8 4 Commands Clark 2 4 October 23 2012 Added Alterna...

Page 3: ...odule 6 RS422 Connections 6 3 Software 7 3 1 MOGD 7 3 2 Firmware Upgrade 8 3 3 Application Notes 8 4 Hardware 9 4 1 Standard Model 9 Extended Communication Power Header 9 Serial DB9 Connector 9 Power...

Page 4: ...16 5 2 Display 16 5 3 Communication 17 5 4 Manual Override 17 6 Commands 18 6 1 Communication 18 6 2 Text 20 6 3 Drawing 23 6 4 Fonts 28 Font File Creation 28 6 5 Bitmaps 30 Bitmap File Creation 31 B...

Page 5: ...6 16 Miscellaneous 49 7 Appendix 51 7 1 Command Summary 51 7 1 Block Diagram 56 7 2 Environmental Specifications 56 7 3 Electrical Tolerances 56 7 4 Dimensional Drawings 57 7 1 Optical Characteristic...

Page 6: ...The simple command structure permits easy software control of many settings including backlight brightness screen contrast and baud rate On board memory provides a whopping 256KB of customizable fonts...

Page 7: ...on 1 Mini USB Connector EXTMUSB3FT INTMUSB3FT USB Model Only 2 RS422 Terminal Block 16 30 AWG Wire 422 Model Only 3 DB9 Serial Header CSS1FT CSS4FT Standard Model Only 4 Extended Communication Power C...

Page 8: ...aces DB9 and floppy power headers provide all necessary input to drive your display Figure 4 Breadboard Cable BBC For a more flexible interface to the GLK240128 25 GLT240128 a Breadboard Cable may be...

Page 9: ...st be supplied from your breadboard or another external source To dive right into your application and use the GLK240128 25 GLT240128 in I2 C mode get started with the guidelines below 1 Set the Proto...

Page 10: ...USB protocol only Model specific hardware prevents this unit from operating in any other protocol and does not allow other models to operate in USB Protocol Select jumpers on the USB model cannot be...

Page 11: ...laid out below 1 Set the Protocol Select jumpers RS422 The GLK240128 25 422 GLT240128 422 offers only RS422 protocol and does not require any jumper changes 2 Make the connections a Screw one wire si...

Page 12: ...ext strings or even command bytes can easily be transmitted to control your display 3 1 MOGD The Matrix Orbital Graphic Display interface MOGD is offered as a free download from www matrixorbital ca s...

Page 13: ...w matrixorbital ca software GLT Series If it is necessary to forgo all current and future upgrades to the filesystem and subsequent commands firmware revision 8 0 may be ordered as a part of a custom...

Page 14: ...tocol Select Jumpers Pins five and six can be used for serial transmission hardware flow control and are ignored for I C communications The Molex 22 04 1061 style header used can be mated to a number...

Page 15: ...o RS 232 mode with solder jumps on the RS232 jumpers In order to place the display module in I C mode you must first remove the solder jumps from the RS232 jumpers and then place them on the I2 C jump...

Page 16: ...ication access in a simple interface package The Optional Alternate USB Header may be added to the GLK240128 25 USB GLT240128 USB for an added charge as part of a custom order Please use the Contact s...

Page 17: ...s supplied locally to the regular or V variants while the VPT can receive power over a distance The Tyco 282834 6 style header is most suited to a simple wire connection Alternate Power Connector Figu...

Page 18: ...c to that key press is automatically sent on the Tx communication line If a synchronous read method is desired in serial mode the Auto Transmit Keypress function can be turned off to allow the key pre...

Page 19: ...but transmits much more data to the host Care should be taken to find balance This mode offers a great degree of flexibility and creativity Table 11 Coordinate Mode Event Prefixes Return Value 1 2 4 T...

Page 20: ...female connectors to provide control to any peripheral devices required Note If connecting a relay be sure that it is fully clamped using a diode and capacitor in order to absorb any electro motive fo...

Page 21: ...tocol select jumpers are connected and all unused protocol jumpers are disconnected The last step will be to check the interface connector in use on your display If the power connections have become l...

Page 22: ...lay to its default settings using the Manual Override procedure outlined below Note I C communication will always require pull up resistors on SCL and SDA of one to ten kilohms 5 4 Manual Override Sho...

Page 23: ...elect Dec Hex ASCII 254 160 FE A0 Protocol Protocol Protocol v8 0 Selects the protocol used for data transmission from the display Data transmission to the display is not affected Must be set to the p...

Page 24: ...d a different Xon byte when the buffer is almost empty Full value should provide enough room for the largest data packet to be received without buffer overflow No data should be sent to the display be...

Page 25: ...CII 254 253 77 79 117 110 FE FD 4D 4F 75 6E M O u n v8 4 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 a...

Page 26: ...Font CharSpace LineSpace Scroll v8 3 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 ID Byte Unique tex...

Page 27: ...kground CharSpace Delay ID X1 Y1 X2 Y2 Vert Dir Font Background CharSpace Delay v8 6 Designates a portion of the screen that can be easily updated with one line of text often used to display variables...

Page 28: ...the current drawing colour X Byte Horizontal position of pixel to be drawn Y Byte Vertical position of pixel to be drawn 3 3 Draw a Line Dec Hex ASCII 254 108 FE 6C l X1 Y1 X2 Y2 X1 Y1 X2 Y2 X1 Y1 X2...

Page 29: ...coordinate Y1 Byte Topmost coordinate X2 Byte Rightmost coordinate Y2 Byte Bottommost coordinate 3 7 Draw a Rounded Rectangle Dec Hex ASCII 254 128 FE 80 X1 Y1 X2 Y2 Radius X1 Y1 X2 Y2 Radius X1 Y1 X2...

Page 30: ...t on the ellipse perimeter and centre YRadius Byte Distance between the furthest vertical point on the ellipse perimeter and centre 3 12 Draw a Filled Ellipse Dec Hex ASCII 254 127 FE 7F DEL X Y XRadi...

Page 31: ...9 slice bar graph in memory for later implementation 9 slice graphs are also be filled using the Draw a Bar Graph command and are allocated to the same memory as regular bitmaps ID Byte Unique bar id...

Page 32: ...ne pixel less than chart height Step Byte Scroll distance between updates in pixels Style Byte Chart style value which is an OR d combination of type and direction as per the tables below ID Short 9 s...

Page 33: ...the font spacing or metrics used with the current font Changes only appear in text sent after command LineMargin Byte Space between left of display and first column of text Default 0 TopMargin Byte S...

Page 34: ...character data it references The first byte of the file maximum width has an offset of zero The width byte of each character can be identical as in a fixed width font or in our case variable The char...

Page 35: ...x ASCII 254 92 5 FE 5C 05 ENQ ID Size Data ID Size Data ID Size Data v8 3 Upload a bitmap mask that can clear areas of the screen before a bitmap is drawn Programmatically bitmap mask screen mask is s...

Page 36: ...le 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 produ...

Page 37: ...see the 9 Slice File Creation example 6 2 Upload a 9 Slice Mask Dec Hex ASCII 254 92 6 FE 5C 06 ACK ID Size Data ID Size Data ID Size Data v8 3 Upload a 9 slice mask that can clear areas of the scree...

Page 38: ...ction of the 9 slice Right One byte specifying the width of the right column section of the 9 slice Bitmap Data Data outlining the entire bitmap as per the Bitmap File Creation example 6 7 Animations...

Page 39: ...n displayed ID Byte Animation number to start stop value between 0 and 15 Start Byte Any non zero value will start the specified animation 0 will stop it 7 5 Set Animation Frame Dec Hex ASCII 254 197...

Page 40: ...Turns the specified GPO off sinking current to an output of zero volts Number Byte GPO to be turned off 8 3 Set Start Up GPO State Dec Hex ASCII 254 195 FE C3 Number State Number State Number State v...

Page 41: ...0 1 Auto Transmit Key Presses On Dec Hex ASCII 254 65 FE 41 A v8 0 Key presses are automatically sent to the host when received by the display Use this mode for I2C transactions 10 2 Auto Transmit Key...

Page 42: ...v8 0 Turns auto repeat mode off Default is on typematic 10 8 Assign Keypad Codes Dec Hex ASCII 254 213 FE D5 Key Down Key Up Key Down Key Up Key Down Key Up v8 0 Assigns the key down and key up value...

Page 43: ...ss 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 Default reporting returns all events Table 34 Region Reporting...

Page 44: ...ing point for the control as below X Byte Leftmost coordinate Y Byte Topmost coordinate Width Short Width of slider Height Short Height of slider Control Width Byte Width of the slider control Min Sho...

Page 45: ...s command is recommended for use when environmental or user conditions change to ensure correct operation Response Short Command byte 254 then 21 for success or 20 for failure 6 12 Display Functions 1...

Page 46: ...2 STX ID Length Data ID Length Data ID Length Data v8 3 Save a list of commands to be executed at a later time Bytes are saved as if they are being sent by the host for upload protocol see the File Tr...

Page 47: ...ded script Script 0 is loaded automatically on startup unless in override mode ID Short Identification number of the script to run value between 0 and 1023 6 14 Filesystem 14 1 Delete Filesystem Dec H...

Page 48: ...0 Size Data Size Data Size Data v8 0 This command will upload a filesystem image to the display The size used is almost always the entire memory Filesystem data can be uploaded LSB to MSB using the Fi...

Page 49: ...oaded LSB to MSB using the XModem Transfer Protocol Size Integer Size of the filesystem to upload Data Byte s Filesystem data to upload must be padded to an even multiple of 256 bytes 14 10 XModem Fil...

Page 50: ...pecifying the file size required the display will respond indicating whether it has enough room to save the file or not As is the case throughout the upload protocol a response of 1 will indicate conf...

Page 51: ...ownload 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 To begin the upload a series of command bytes are s...

Page 52: ...and 133 Command Byte One 6 Command Byte Two 48 Command Byte Three 1 File ID LSB 0 File ID MSB 1 File Type 0 Size LSB NAK if not found 0 Size 1 Size 0 Size MSB 67 C 1 Start of Header 128 Block Count 12...

Page 53: ...cycle A new level overrides the old and levels can be combined Default is 0 Level Byte Lock level see Data Lock Bits table Table 45 Data Lock Bits Display Command Filesystem Setting Address Reserved...

Page 54: ...er use Address Short Address where data is to be saved in volatile memory Value between 0 and 256 Length Short Length of data to be saved in bytes Value between 0 and 256 address limited Data Byte s D...

Page 55: ...ponses 122 GLT240128 114 GLK240128 25 123 GLT240128 USB 108 GLK240128 25 USB 112 GLT240128 422 111 GLK240128 25 422 16 7 Read Screen Dec Hex ASCII 254 184 FE B8 v8 1 Return a two byte screen size foll...

Page 56: ...mber On Turn Software Flow Control Off 59 3B None None Remember On Set Software Flow Control Response 60 3C Byte 2 None Remember On Echo 255 FF Short Byte Byte Never Delay 251 FB Short None Never Soft...

Page 57: ...Initialize 9 Slice Bar Graph 115 73 s Byte 6 Short 2 None Remember On Draw a Bar Graph 105 69 i Byte 2 None Never Initialize a Strip Chart 106 6A n Byte 5 Short 2 Byte 2 Short None Remember On Update...

Page 58: ...Byte None Never Delete Animation 199 C7 Byte None Always Start Stop Animation 194 C2 Byte 2 None Never Set Animation Frame 197 C5 Byte 2 None Never Get Animation Frame 196 C4 Byte Byte Never Table 55...

Page 59: ...ete All Touch Regions 134 86 None None Remember On Create a Slider 186 BA Byte 7 Short 2 None Remember On Delete a Slider 189 BD Byte None Always Delete All Sliders 190 BE None None Always Set Draggin...

Page 60: ...0 None Integer Byte Never XModem File Upload 220 133 6 48 DC 85 6 30 ACK 0 Short Byte Integer Byte None Always XModem File Download 221 133 6 48 DD 85 6 30 ACK 0 Short Byte Integer Byte Never Table 6...

Page 61: ...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 Curr...

Page 62: ...Command Summary 57 7 4 Dimensional Drawings Figure 21 Display Dimensional Drawing Figure 22 Standard Model Dimensional Drawing...

Page 63: ...58 Command Summary Figure 23 USB Model Dimensional Drawing Figure 24 RS422 Model Dimensional Drawing...

Page 64: ...oduct Type GLK Graphic Liquid Crystal Display with Keypad Input GLT Graphic Liquid Crystal Display with Touchpad Input 2 Display Size 240128 240 pixel columns by 128 rows 3 Keypad Size NP No keypad 25...

Page 65: ...ies PCS 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 ESCCPC5V Ex...

Page 66: ...Command Summary 61 Peripherals Table 73 Peripheral Accessories KPP4x4 16 Button Keypad...

Page 67: ...transmission the leftmost when read RS232 Recommended standard 232 a common serial protocol A low level is 30V a high is 30V RS422 Recommended standard 422 a more robust differential pair serial prot...

Reviews: