Matrix Orbital GLK12232-25 Technical Manual Download Page 22

22 

Command Summary

 

 

4.3

 

Set Font 

Metrics 

Dec 
Hex 
ASCII

 

254 50 

FE 32 

 2 

LineMargin  TopMargin  CharSpace  LineSpace  Scroll 
LineMargin  TopMargin  CharSpace  LineSpace  Scroll  
LineMargin  TopMargin  CharSpace  LineSpace  Scroll 

 v5.8 

Set 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 

Space between top of display area and first row of text.  Default 0. 

CharSpace 

Byte 

Space between characters.  Default 0. 

LineSpace 

Byte 

Space between character rows.  Default 1. 

Scroll 

Byte 

Point at which text scrolls up screen to display additional rows.  Default 1. 

 
 

4.4

 

Set Box Space 

Mode 

Dec 
Hex 
ASCII 

254 172 

FE AC 

 ¼ 

Switch 
Switch 
Switch 

 v5.8 

Toggle box space on or off.  When on, a character sized box is cleared from the screen before a character is 
written.  This eliminates any text or bitmap remnants behind the character.  Default is on. 

Switch 

Byte 

1 for on or 0 for off. 

 

 

Font File Creation 

Matrix Orbital graphic displays are capable of displaying text in a wide variety of styles customizable to 
suit any project design.  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 easiest way to create, add, or modify the fonts of any graphic display is through the MOGD# tool.  
This provides a simple graphic interface that hides the more complex intricacies of the font file. 

Table 12: Example 

Font File Header

 

Maximum Width  Character Height  ASCII Start Value  ASCII End Value 

104 

106 

 

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.  The range represents the values that must be sent to the display to trigger the characters to 
appear on the screen.  In the example, the decimal values corresponding to the lowercase letters ‘h’ 
through ‘j’ will be used resulting in the range shown. 

Table 13: Example Character Table 

 

MSB  LSB  Width 

13 

18 

21 

 

Summary of Contents for GLK12232-25

Page 1: ...Command Summary 1 GLK12232 25 Including GLK12232 25 USB Technical Manual Revision 3 1 PCB Revision 3 0 or Higher Firmware Revision 5 8 or Higher...

Page 2: ...2 Command Summary Revision History Revision Date Description Author 3 1 November 23 2015 Initial Release Divino 0 2 Updated Images Clark 0 1 Initial Concept Clark...

Page 3: ...onnections 9 3 Software 10 3 1 MOGD 10 3 2 Application Notes 11 4 Hardware 12 4 1 Standard Model 12 I2 C Communication Power Header 12 4 2 USB Model 12 Mini USB Connector 12 Alternate USB Header 12 4...

Page 4: ...ay Functions 27 6 9 Filesystem 28 File Transfer Protocol 29 6 10 Data Security 30 6 11 Miscellaneous 31 7 Appendix 33 7 1 Command Summary 33 7 2 Block Diagram 35 7 3 Environmental Specifications 36 7...

Page 5: ...ocols and 100kbps for I2 C ensure lightning fast text and graphic display The simple command structure permits easy software control of many settings including backlight brightness screen contrast and...

Page 6: ...r Locations Figure 3 GLK12232 25 USB Model Header Locations Table 1 List of Available Headers Header Mate Population 1 Communication Power Connector ESCCPC5V BBC Standard Model Only 2 Keypad KPP4x4 US...

Page 7: ...iar interfaces DB9 and floppy power headers provide all necessary input to drive your display Figure 5 Breadboard Cable BBC For a more flexible interface to the GLK12232 25 a Breadboard Cable may be u...

Page 8: ...e supplied from your breadboard or another external source To dive right into your application and use the GLK12232 25 in I2 C mode get started with the guidelines below 1 Set the Protocol Select swit...

Page 9: ...LK12232 25 USB offers 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...

Page 10: ...s 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 so...

Page 11: ...und that will prepare it for any application environment 3 2 Application Notes Full demonstration programs and code are available for Matrix Orbital displays in the C language from Simple C AppNote Pa...

Page 12: ...onnector Table 5 Mini USB Pinout Pin Function 1 Vcc 2 D 3 D 5 Gnd The GLK12232 25 USB USB comes with a familiar Mini USB Connector to fulfill both communication and power needs The standard MiniB styl...

Page 13: ...d Vcc To facilitate user input the GLK12232 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 pre...

Page 14: ...efault slave address of 80 unless changed with the appropriate command Similarly in order to change the display to TTL mode simply remove the zero ohm resistors from the RS232 or I C jumpers and solde...

Page 15: ...not the case check out these tips Ensure the contrast is not too high or too low This can result in a darkened or blank screen respectively See the Manual Override section to reset to default Make su...

Page 16: ...ow 1 Disconnect power from your display 2 Place a jumper on the two manual override pins for the GLK12232 25 model these are the middle two keypad pins 3 Reconnect power to your unit and wait for the...

Page 17: ...ud must be within 3 of desired baud to ensure accurate communication Not available in I2C Can be temporarily forced to 19200 by a manual override Speed Short Calculations shown below standard crystal...

Page 18: ...d Column Byte Value between 1 and number of character columns Row Byte Value between 1 and number of character rows 2 4 Set Cursor Coordinate Dec Hex ASCII 254 121 FE 79 y X Y X Y X Y v5 8 Sets the cu...

Page 19: ...l coordinate of the first terminus zero indexed from top X2 Byte Horizontal coordinate of second the terminus zero indexed from left Y2 Byte Vertical coordinate of second the terminus zero indexed fro...

Page 20: ...e on the screen but overlapping may cause distortion Graph should be filled using the Draw a Bar Graph command ID Byte Unique bar identification number between 0 and 255 Type Byte Graph style see Bar...

Page 21: ...ID Value ID Value v5 8 Shift the specified strip chart and draw a new value ID Byte Chart identification number value between 0 and 7 Value Short Value to add to the chart 6 4 Fonts 4 1 Upload a Font...

Page 22: ...tal graphic displays are capable of displaying text in a wide variety of styles customizable to suit any project design Front files alter the style of text and appearance of the display By default a M...

Page 23: ...ach 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 the...

Page 24: ...ovide 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...

Page 25: ...Byte 1 for on or 0 for off 6 7 Keypad 7 1 Auto Transmit Key Presses On Dec Hex ASCII 254 65 FE 41 A v5 8 Key presses are automatically sent to the host when received by the display Use this mode for I...

Page 26: ...key is released Default is typematic Mode Byte 1 for hold mode or 0 for typematic 7 7 Auto Repeat Mode Off Dec Hex ASCII 254 96 FE 60 v5 8 Turns auto repeat mode off Default is on typematic 7 8 Assign...

Page 27: ...rightness level from 0 Dim to 255 Bright 8 4 Set and Save Brightness Dec Hex ASCII 254 152 FE 98 Brightness Brightness Brightness v5 8 Immediately sets and saves the backlight brightness Although brig...

Page 28: ...4 Get Filesystem Directory Dec Hex ASCII 254 179 FE B3 v5 8 Returns a directory to the contents of the filesystem The total number and type of each entry will be provided Response Short Number of entr...

Page 29: ...file Old ID location must be valid and new ID empty OldType Byte Original file type value between 0 and 1023 see File Types OldID Byte Original unique file identification number value between 0 and 1...

Page 30: ...Command Prefix 94 Upload Bitmap File Command 1 Reference ID LSB 0 Reference ID MSB 5 Bitmap File Size LSB 0 Bitmap File Size 0 Bitmap File Size 0 Bitmap File MSB 1 Acknowledge Size 5 First Bitmap Data...

Page 31: ...Dec Hex ASCII 254 203 245 160 FE CB F5 A0 Level Level Level v5 8 Locks certain aspects of the display to ensure no inadvertent changes are made The lock is not affected by a power cycle A new level ov...

Page 32: ...ype Dec Hex ASCII 254 55 FE 37 7 v8 0 Causes display to respond with its module number Response Byte Module number see Sample Module Type Response for a partial list Table 30 Sample Module Type Respon...

Page 33: ...rdinate 121 79 y Byte 2 None Never Auto Scroll On 81 51 Q None None Remember On Auto Scroll Off 82 52 R None None Remember On Table 33 Drawing Command Summary Name Dec Hex ASCII Parameters Response Re...

Page 34: ...Never Set Debounce Time 85 55 U Byte None Remember On Auto Repeat Mode Off 96 60 None None Remember On Assign Keypad Codes 213 D5 Byte 25 Byte 25 None Always Table 38 Display Functions Command Summar...

Page 35: ...r On Set and Save Data Lock 203 245 160 CB F5 A0 Byte None Always Table 41 Miscellaneous Command Summary Name Dec Hex ASCII Parameters Response Remembered Write Customer Data 52 34 4 Byte 16 None Alwa...

Page 36: ...torage Temperature 10 C to 60 C 20 C to 70 C Operating Relative Humidity Maximum 90 non condensing 7 4 Electrical Tolerances Current Consumption Table 43 Current Consumption Board Backlight GPOs 57mA...

Page 37: ...Command Summary 37 7 5 Dimensional Drawings Figure 15 Standard Model Dimensional Drawing...

Page 38: ...38 Command Summary Figure 16 USB Model Dimensional Drawing...

Page 39: ...cheme Table 47 Part Numbering Scheme GLK 12232 25 USB FGW E 1 2 3 5 6 7 8 2 Options Table 48 Display Options Designator Options 1 Product Type GLK Graphic Liquid Crystal Display with Keypad Input 2 Di...

Page 40: ...ation Table 49 Communication Accessories EXTMUSB3FT Mini USB Cable INTMUSB3FT Internal Mini USB Cable SCCPC5V Extended Serial Communication 5V Power Cable BBC Breadboard Cable Peripherals Table 50 Per...

Page 41: ...ial protocol A low level is 30V a high is 30V SDA Serial data line used to transfer data in I2 C protocol This open drain line should be pulled high through a resistor Nominal values are between 1K an...

Reviews: