Digilent, Inc.

PmodCLS Reference Manual

www.digilentinc.com

www.digilentinc.com

page 3 of 4

Copyright Digilent, Inc. All rights reserved. Other product and company names mentioned may be trademarks of their respective owners.

Instruction

Result

<pt>t

save RAM character

table to EEPROM

<pt>l

load EEPROM

character table to RAM

<pn>…<pn>;<ps>d

define user

programmable character

<ps>m

save communication

mode to EEPROM

w

enable write to

EEPROM

<ps>n

save cursor mode to

EEPROM

<ps>o

save display mode to

EEPROM

Symbol

Definition

<pr>

row number (0 - 1)

<pc>

column number (0 – 39)

<pn>

numeric parameter

(decimal, hex, or binary)

<ps>

decimal selection

parameter

<pt>

character table selector

(0 – 2 in EEPROM, 3 in

RAM)

EEPROM

Before you can store any value to an address

in EEPROM, writing to EEPROM must first be

enabled. The command to enable writing to

the EEPROM must be sent before each

successive write to EEPROM. If the command

to enable writing to the EEPROM is not sent

before an EEPROM-related command, the

command will be ignored.

Custom Characters

The module can display up to eight custom

characters at a time, but is capable of storing

four sets of eight characters. This consists of

three stored character tables in EEPROM and

one table loaded into the LCD’s RAM.

To create a new custom character, send the

command (ESC)[<pn>…<pn>;<ps>d where

<pn> is a numeric parameter that describes a

row in the character and <ps> is a decimal

selection parameter (0 through 7.) A custom

character definition contains eight rows, so the

escape sequence to define one must have

eight <pn> values followed by the <ps> value

that specifies the character being defined.

To create a new character, first draw out the

pattern. Then, determine the numerical value

of each row in the character. Note that the left-

most segment is the most significant bit.

Record each row, from top to bottom, and

record which character in the table to save it

to. Each row of the character contains six

pixels, so only the low six bits of each byte

value are used.

For example, the following character would be

saved by writing:

lcdChar(0x1B);

lcdString("[14;31;21;31;23;16;31;14;0d");

where lcdChar( ) and lcdString( ) are functions

that write characters and arrays of characters.

The above command saves the character to

the ‘0’ address in the LCD’s RAM table. To

display this character, send the numerical

value of the addressed character. In this

example, it is performed by writing

lcdChar(0x00);

The character will appear at the location of the

LCD’s cursor.