Matrix Orbital GLK12232-25-USB User manual

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

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

Command Summary 3
Contents
1 Introduction ............................................................................................................................................... 5
2 Quick Connect Guide..................................................................................................................................6
2.1 Available Headers ............................................................................................................................... 6
2.2 Standard Module ................................................................................................................................ 7
Recommended Parts............................................................................................................................. 7
Serial Connections................................................................................................................................. 7
I2C Connections .....................................................................................................................................8
2.3 USB Module ........................................................................................................................................ 9
Recommended Parts............................................................................................................................. 9
USB Connections................................................................................................................................... 9
3 Software...................................................................................................................................................10
3.1 MOGD# ............................................................................................................................................. 10
3.2 Application Notes.............................................................................................................................. 11
4 Hardware..................................................................................................................................................12
4.1 Standard Model ................................................................................................................................ 12
I2C Communication/Power Header.....................................................................................................12
4.2 USB Model.........................................................................................................................................12
Mini USB Connector............................................................................................................................12
Alternate USB Header .........................................................................................................................12
4.3 Common Features.............................................................................................................................13
General Purpose Outputs ................................................................................................................... 13
Keypad Header....................................................................................................................................13
Protocol Select Jumpers...................................................................................................................... 14
Hardware Lock ....................................................................................................................................14
5 Troubleshooting.......................................................................................................................................15
5.1 Power ................................................................................................................................................15
5.2 Display...............................................................................................................................................15
5.3 Communication.................................................................................................................................15
5.4 Manual Override ...............................................................................................................................16
6 Commands ...............................................................................................................................................17

4 Command Summary
6.1 Communication.................................................................................................................................17
6.2 Text....................................................................................................................................................18
6.3 Drawing.............................................................................................................................................19
6.4 Fonts..................................................................................................................................................21
Font File Creation................................................................................................................................22
6.5 Bitmaps .............................................................................................................................................23
Bitmap File Creation............................................................................................................................24
6.6 General Purpose Output...................................................................................................................25
6.7 Keypad...............................................................................................................................................25
6.8 Display 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.4 Electrical Tolerances .........................................................................................................................36
7.5 Dimensional Drawings ...................................................................................................................... 37
7.6 Optical Characteristics ......................................................................................................................39
8 Ordering ...................................................................................................................................................39
8.1 Part Numbering Scheme ...................................................................................................................39
8.2 Options..............................................................................................................................................39
8.3 Accessories........................................................................................................................................ 40
9 Definitions................................................................................................................................................41
10 Contact...................................................................................................................................................41

Command Summary 5
1Introduction
Figure 1: GLK12232-25 Display
The GLK12232-25 is an intelligent graphic liquid crystal display engineered to quickly and easily add an
elegant creativity to any application. In addition to the RS232, TTL and I2C protocols available in the
standard model, a USB communication model allows the GLK12232-25 to be connected to a wide
variety of host controllers. Communication speeds of up to 115.2kbps for serial protocols and 100kbps
for I2C ensure lightning fast text and graphic display.
The simple command structure permits easy software control of many settings including backlight
brightness, screen contrast, and baud rate. On board memory provides 16KB of customizable fonts and
bitmaps to enhance the graphical user experience.
User input on the GLK12232-25 is available through a five by five matrix style keypad. Two general
purpose outputs provide simple switchable five volt sources on each model.
The versatile GLK12232-25, with all the features mentioned above, is available in a variety of colour and
temperature options to suit almost any application.

6 Command Summary
2Quick Connect Guide
2.1 Available Headers
Figure 2: GLK12232-25 Standard Module Header 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
USB Model Only
3
GPO Header
None Offered
All Models
4
Mini USB Connector
EXTMUSB3FT/INTMUSB3FT
All Models

Command Summary 7
2.2 Standard Module
The standard version of the GLK12232-25 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 I2C protocol. Connections for
each protocol can be accessed through the four pin Communication/Power Header as outlined in the
Serial Connections and I2C Connections sections below.
Recommended Parts
Figure 4: Extended Communication/Power
Cable (ESCCPC5V)
The most common cable choice for any standard Matrix Orbital
display, the Extended Communication/ Power Cable offers a simple
connection to the unit with familiar 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 used. This provides a simple four wire connection that is
popular among developers for its ease of use in a breadboard
environment.
Serial Connections
Serial protocol provides a classic connection to the GLK12232-25 . The Communication/Power Cable is
most commonly used for this set up as it provides connections for DB9 serial and floppy power cables.
To place your board in Serial mode, adhere to the steps laid out below.
1. Set the Protocol Select jumpers.
RS232: Connect the five jumpers*in the 232 protocol box with the zero ohm jumper resistors
provided or an alternate wire or solder solution.
TTL: Connect the four jumpers*in the TTL protocol box.
*Note: Jumpers must be removed from all protocol boxes save for the one in use.

8 Command Summary
2. Make the connections.
a. Connect the six pin female header of the Communication/Power Cable to the
Communication/Power Header of your GLK12232-25 .
b. Insert the male end of your serial cable to the corresponding DB9 header of the
Communication/Power Cable and the mate the female connector with the desired
communication port of your computer.
c. Select an unmodified floppy cable from a PC power supply and connect it to the power header
of the Communication/Power Cable.
3. Create.
MOGD# or a terminal program will serve to get you started, and then you can move on with
your own development. Instructions for the former can be found below and a variety of
application notes are available for the latter at www.matrixorbital.ca/appnotes.
I2C Connections
A more advanced connection to the GLK12232-25 is provided by the I2C protocol setting. This is best
accomplished using a breadboard and the Breadboard Cable. Power must be supplied from your
breadboard or another external source. To dive right into your application and use the GLK12232-25 in
I2C mode, get started with the guidelines below.
1. Set the Protocol Select switches.
I2C: Ensure that the two I2C jumpers in the corresponding protocol box are connected while all
others are open.
2. Make the connections.
a. Connect the Breadboard Cable to the Communication/Power Header on your GLK12232-25
and plug the four leads into your breadboard. The red lead will require power, while the black
should be connected to ground, and the green and yellow should be connected to your
controller clock and data lines respectively.
b. Pull up the clock and data lines to five volts using a resistance between one and ten kilohms on
your breadboard.
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.

Command Summary 9
2.3 USB Module
The GLK12232-25-USB offers a single USB protocol for easy connection to a host computer. The simple
and widely available protocol can be accessed using the on board mini B style USB connector as outlined
in the USB Connections section.
Recommended Parts
Figure 6: Mini USB Cable
(EXTMUSB3FT)
The External Mini USB cable is recommended for the GLK12232-25-USB
display. It will connect to the miniB style header on the unit and provide a
connection to a regular A style USB connector, commonly found on a PC.
USB Connections
The USB connection is the quickest, easiest solution for PC development. After driver installation, the
GLK12232-25-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 GLK12232-25-USB please follow the steps below.
1. Set the Protocol Select jumpers.
USB: The GLK12232-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 USB model cannot be moved.
2. Make the connections.
Plug the mini-B header of your External Mini USB cable into your GLK12232-25-USB and the
regular USB header into your computer USB jack.
3. Install the drivers.
a. Download the latest drivers at www.matrixorbital.ca/drivers, and save them to a known
location.
b. When prompted, install the USB bus controller driver automatically
c. If asked, continue anyway, even though the driver is not signed
d. When the driver install is complete, your display will turn on, but communication will not yet be
possible.
e. At the second driver prompt, install the serial port driver automatically
f. Again, if asked, continue anyway
4. Create.
Use MOGD# or a terminal program to get started, and then move on with your own
development. Instructions for the former can be found below and a number of application
notes are available for the latter at www.matrixorbital.ca/appnotes.

10 Command Summary
3Software
The multiple communication protocols available and simple command structure of the GLK12232-25
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
7
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 GLK12232-25 .
Table 3: Communication Settings
BPS
Data Bits
Parity
Stop Bits
Flow Control
19200
8
None
1
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.