GLK12232-25-WB-E Datasheet GLK12232-25-WB-E | P16-P18

4.2.1 Set drawing color (254 99 [color])

This command sets the drawing color for subsequent graphic commands that do not have the drawing

color passed as a parameter. The parameter [color] is the value of the color where white 0 Hex, and black is

255 Hex.

NOTE All non-zero values will display as black.

4.2.2 Draw line (254 108 [x1][y1][x2][y2])

This command will draw a line from (x1,y1) to (x2,y2) using the current drawing color. Lines may

be drawn from any part of the display to any other part, but may be important to note that the line may

interpolate differently right to left, or left to right. This means that a line drawn in white from right to left

may not fully erase the same line drawn in black from left to right.

4.2.3 Continue line (254 101 [x][y])

This command will draw line with the current drawing color from the last line end (x2,y2) to (x,y). This

command uses the global drawing color so the “Set drawing color” command should be used before the ﬁrst

line segment if required.

4.2.4 Put pixel (254 112 [x][y])

This command will draw a pixel at (x,y) using the current drawing color. The unit processes these

requests fast enough to keep up with a steady stream at 115 kbaud, so ﬂow control is not required.

4.2.5 Draw outline rectangle (254 114 [color][x1][y1][x2][y2])

This command draws a rectangular box in the speciﬁed color (0 = white, non-zero = black). The top left

corner is speciﬁed by (x1,y1) and the bottom right corner by (x2,y2).

4.2.6 Draw solid rectangle (254 120 [color][x1][y1][x2][y2])

This command draws a solid rectangle in the speciﬁed color (0 = white, non-zero = black). The top left

corner is speciﬁed by (x1,y1) and the bottom right corner by (x2,y2). Since this command involves consid-

erable processing overhead, we strongly recommend the use of ﬂow control, particularly if the command

is to be repeated frequently.

This procedure is common for monitoring applications where there is a ’ﬁeld’ on the display that is

constantly being updated from, say, a temperature sensor.

Matrix Orbital GLK12232-25-WBL 12

4.2.7 Initialize bar graph (254 103 [ref][type][x1][y1][x2][y2])

This command initializes a bar graph referred to by number [reference number] of type [type] with size

from (x1,y1) (top left) to (x2,y2) (bottom right). A maximum of 16 bar graphs with reference numbers from

0 to 15 can be initialized as;

• [type = 0] Vertical, bottom referenced

• [type = 1] Horizontal left referenced

• [type = 2] Vertical top referenced

• [type = 3] Horizontal right referenced

The bar graphs may be located anywhere on the display, but if they overlap, they will not display properly.

NOTE It is important that [x1] is less than [x2], and [y1] is less than [y2].

This command doesn’t actually draw the graph, it must be ’ﬁlled in’ using the “Write to bar graph” com-

mand, described below. The unit saves time by only drawing that part of the bar graph which has changed

from the last write, so the representation on the screen may not survive a screen clear or other corruptive

action. A write of value zero, followed by new values will restore the proper look of the bar graph.

4.2.8 Write to bar graph (254 105 [reference number][value])

Once the bar graph has been initialized it can be ’ﬁlled in’ using this command. This command sets the

bar graph [reference number] to value [value]. [value] is given in pixels and should not exceed the available

height / width of the graph. (If it does, the graph will simply be written to its maximum size.)

4.2.9 Display saved bitmap (254 98 [reference number][x][y])

This command causes a previously stored bitmap referenced by [reference number] to be displayed to

the screen at pixel location (x, y) where this location deﬁnes the top left corner of the bitmap. Bitmaps and

fonts may use the same reference numbers, for example it is possible to have both a bitmap 1 and a font 1.

NOTE The reference number is established when the bitmap is saved, normally using

mogd.exe.

4.3 Flow Control

The display has built in ﬂow control which is very useful during direct bitmap display and multiple pixel

placement. Flow control is enabled or disabled by two commands. If ﬂow control is enabled, the display

will return an "almost full" message (0xFE) to the micro-controller when its internal buffer ﬁlls to a deﬁned

level, and an "almost empty" message (0xFF) when the buffer contents drop to a deﬁned level.

Matrix Orbital GLK12232-25-WBL 13

4.3.1 Enter Flow Control Mode (254 58 [full][empty])

NOTE Flow control applies only to the RS-232 interface. It is not available for I

This command enables ﬂow control. When the buffer ﬁlls so that only [full] bytes are available the display

will return an "almost full" message (0xFE) to the micro-controller. When the buffer empties so that only

[empty] bytes remain the display will return an "almost empty" message (0xFF) to the micro-controller.

The display will return the "almost full" message for every byte sent to the display until the used buffer

space once more drops below the [full] level.

Whether the user is in ’ﬂow control mode’ or not, the module will ignore display or command bytes

which would overrun the buffer. While in ’ﬂow control mode’ the unit will return 0xFE when the buffer is

almost full even though it may have already thrown rejected data away. The buffer size for the display is 96

bytes.

When using this command in an application, selection of the value for the buffer almost full should be

considered very carefully. This is a critical aspect of using this command to it’s full potential. When using a

host system or PC which contains a FIFO, the user should set the value of equal to or greater than the size of

the FIFO. The reason for this is that the FIFO may be full when the host system receives 0xFE. In the case

of 16550 UART the size at its maximum is 16, therefore the value of should be set to 16 or greater.

NOTE This mode must not be used during loading of fonts and bitmaps. It is highly

recommended for use with direct screen write and multiple pixel placements.

4.3.2 Exit Flow Control Mode (254 59)

This command turns off ﬂow control. Bytes may overﬂow the buffer without warning.

5 Keypad Interface

This chapter describes the keypad interface and associated commands in detail.

5.1 General

The display keypad interface processes the keypad row / column matrix into a serial (RS-232 or I

data byte stream. Aside from this processing, the keypad has no effect on the display. If it is necessary to

send keystrokes to the display, they must be routed through the micro-controller.

Matrix Orbital GLK12232-25-WBL 14

P1-P3 P4-P6 P7-P9 P10-P12 P13-P15 P16-P18 P19-P21 P22-P24 P25-P27 P28-P30 P31-P33 P34-P36 P37-P39

GLK12232-25-WB-E

Mfr. #:

Buy GLK12232-25-WB-E

Manufacturer:

Matrix Orbital

Description:

LCD Graphic Display Modules & Accessories Graphic Display White/Blue Ext Temp

Lifecycle:

New from this manufacturer.

Delivery:

DHL FedEx Ups TNT EMS

Payment:

T/T Paypal Visa MoneyGram Western Union

Products related to this Datasheet

GLK12232-25-WB-E