5.5.7 Set debounce time (254 85 [time])
[time] is in increments of 6554 microseconds.
This command sets the time between key press and key read. All key types with the exception of latched
piezo switches will ’bounce’ for a varying time, depending on their physical characteristics. The default
debounce time for the module is about 52 mS, which is adequate for most membrane keypads.
6 Fonts and Graphics Files
6.1 General
Matrix Orbital graphic modules contain a sophisticated file system for storing and retrieving font infor-
mation, bitmaps and system parameters; not unlike the way that a computer deals with files on a hard drive.
However, the modules use no moving parts, therefore, data is stored far more reliably than data on a home
PC.
Operationally, there is one important difference between the Matrix Orbital file system and that of a PC.
While a PC will allow fragmentation of its files across the available file space, the Matrix Orbital file system
takes great care to ensure that all parts of a file are stored together. This system works well to maximize
storage space and operational efficiency, however, during file downloads, the modules may need to spend
considerable time moving files to make room for the new file. This delay during download can be as much
as a minute, but generally it will not exceed 10 seconds.
When a file is being downloaded with the same ’name’ or reference number as a previously existing
file, the old file needs to be deleted first. We cannot know if the new file is exactly the same size as the old
file, since the space vacated by the old files is filled by moving previously existing files down to fill up the
vacated space. This ensures that no file space is wasted.
Of course, the average module will simply have files loaded into it and it will then get to work, without
ever having to perform this file reorganization task. The file space may be rewritten up to 100 000 times, but
most users will simply load in their fonts and bitmaps once and that will be it.
6.2 Using mogd.exe
The Matrix Orbital interface program "mogd.exe", which is provided on the disk and the website, gen-
erates and saves fonts larger than 14 pixels in height. It is also used to save graphic images (bitmaps) to the
display.
To make use of smaller fonts it is recommended that a pre-generated font be used. These fonts can
be located on the disk or the website. Unfortunately, integrating these fonts is not as straight forward as
generating the fonts. To make use of these fonts the user must place the font files in their font directory as
defined in the interface program. This directory can be found under "settings".
A font file consists of a single file with an extension.mgf and a directory which contains bitmaps for
every character. All .mgf files are contained within the font directory and all bitmap directories are sub
directories of the font directory. After download of a font file use a "Zip" program to "UnZip" the .mgf file
and bitmap sub-directory into the font directory. Start or restart mogd.exe and click on the font tab. The font
Matrix Orbital GLK12232-25-WBL 18
list of mogd should now display the new pre-generated font list.
6.3 Commands
In addition to the commands listed below, the mogd.exeprogram saves fonts and bitmaps to the display’s
flash memory.
6.3.1 Erase file (254 173 [type] [ref])
This command erases a file within the display’s memory, in addition to erasing a single file at a time.
This command needs to be given two parameters: [type] and [ref]. The file type and reference number
are defined when the file is saved to the display using mogd.exe. Since there is no command to list files in
memory, the user must keep track of the memory contents.
[type] = 1 is a font file
[type] = 5 is a bitmap
Once this command is completed, all files ’move up’ and recover the empty space for efficient memory
management.
6.3.2 Purge memory (254 33 89 33)
This commandcompletely erases the display’s non-volatilememory. This removesall fonts, font metrics,
bitmaps, and settings (current font, cursor position, communication speed, etc.). It is an ’odd’ command in
that it is three bytes in length. This is to prevent accidental execution.
6.3.3 Upload Font (254 36 [ref] [file size] [file data])
This command begins a font upload to the display’s non-volatile memory. [ref] is the reference number
to be used for this font. File size is a 2 byte value that must be calculated by the host before the transfer takes
place.
6.3.4 Upload Bitmap (254 94[ref] [file size] [file data])
This command begins a bitmap upload to the display’s non-volatile memory. [ref] is the reference
number to be used for this bitmap. File size is a 2 byte value that must be calculated by the host before
the transfer takes place.
6.4 Working with Font Files
A font file consists of a header, a character list and character bitmaps.
Matrix Orbital GLK12232-25-WBL 19
The header consists of;
Placeholder for actual EOF (2 bytes, use 0xFF 0xFF - these bytes will be set to their final value by the
module)
Nominal character width (1 byte)
Absolute font height (1 byte)
ASCII value of first character defined in this file (1 byte)
ASCII value of last character defined in this file (1 byte)
The character list consists of groups of 3 bytes per character;
Offset to character bitmap (2 bytes)
Actual width of this character (1 byte)
6.4.1 Font File in Table Form
The table below shows the layout of a font file in table form.
Table 5: File Format
0xFF 0xFF X size Y size Start End O-High O-Low
Width O-High O-Low Width O-High O-Low Width O-High
O-Low Width O-High O-Low Width O-High O-Low Width
O-High O-Low Width Data Data Data Data Data
Data Data Data Data Data Data Data Data
Data Data Data Data Data Data Data Data
Data Data Data Data Data Data Data Data
Data Data Data Data Data Data Data Data
Data Data Data Data Data Data Data Data
Data Data Data Data Data Data Data Data
Data Data Data Data Data Data Data Data
Data Data Data Data Data Data Data Data
Data Data Data Data Data Data Data Data
Data Data Data Data Data
6.4.2 Uploading the File to the Module
The “Upload font” command is used to actually upload the font file. Recall that the syntax for this
command is;
0xFE 0x24 [ref] [file size] [file data]
In this example the file size is 94 bytes (0x5E) and the reference number is 2. The communications
exchange between the host and the module looks like this;
Matrix Orbital GLK12232-25-WBL 20

GLK12232-25-WB-E

Mfr. #:
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