background image

 

Command Summary

 

31 

 

5.4

 

Draw a Partial 

Bitmap 

Dec 
Hex 
ASCII 

254 192 

FE C0 

└  

ID  X  Y  XPart  YPart  Width  Height 
ID  X  Y  XPart  YPart  Width  Height 
ID  X  Y  XPart  YPart  Width  Height 

v8.6 

Draw a portion of a previously uploaded bitmap confined to the width and height specified. 

ID 

Short 

Unique bitmap identification number, value between 0 and 1023. 

Byte 

Leftmost coordinate of partial bitmap placement. 

Byte 

Topmost coordinate of partial bitmap placement. 

XPart  

Byte 

Rightmost coordinate of the bitmap portion to be drawn. 

YPart  

Byte 

Bottommost coordinate of the bitmap portion to be drawn. 

Width 

Byte 

Width of the bitmap portion to be drawn. 

Height 

Byte 

Width of the bitmap portion to be drawn. 

 

 

5.5

 

Draw a Bitmap 

Directly 

Dec 
Hex 
ASCII 

254 100 

FE 64 

 d 

X1   Y1  Data 
X1   Y1  Data 
X1   Y1  Data 

v8.0 

Draw a bitmap directly to the graphic display without saving to memory.  Cannot be implemented in a script. 

X1 

Byte 

Leftmost coordinate of bitmap. 

Y1 

Byte 

Topmost coordinate of bitmap. 

Data 

Byte(s) 

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#.  However, the critical data component of the bitmap upload command is detailed 
below for reference. 

The bitmap data block is similar to that of a font.  However, as a bitmap is a single glyph, only a simple 
two byte header is required.  First, one byte representing the bitmap width is sent, then one byte for the 
height.  Each bitmap is merely encoded in binary fashion using a series of ones and zeroes.  Again a grid 
can be created using the width and height specified in the upload command, populated in the manner 
above, and converted into byte values.  A smiley face example is shown below to indicate the ultimate 
affect of the Matrix Orbital graphic stylization ability. 

Table 27: Smiley Face Bitmap 

0  0  0  0  0 

0  0  0 

1  1  1 

 

Table 28:Smiley Face Data 

0  0  0  0 

50 

80 

0  0 

0  0  0 

0

  22 

34 

1  1  1 

0  0  0  0  0 

E0  224 

 

 

Table 29: Example Bitmap File 

Header 

5 4 

Bitmap Data 

80 34 224 

 

 

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: