Matrix Orbital PK162-12 User manual

PK162-12
Technical Manual
Revision: 1.0

Contents
Contents ii
1 Introduction 1
1.1 What to Expect From the PK162-12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.2 What Not to Expect From the PK162-12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.3 Keypad Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.4 Setup for Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.5 Trying Out the PK162-12 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.6 Trying out a Keypad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.6.1 Here’s what to do: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.7 Manual Over-ride . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.8 Memory Chip Lock Down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2 Connections 5
2.1 Connector Pinout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.1.1 Power Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.1.2 Five Volt Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.1.3 Wide Voltage Range Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.1.4 Power through the DB-9 Connector . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.1.5 RS-232 Communications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.1.6 DB9 Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.1.7 Alternate Serial Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.1.8 TTL Communications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.1.9 I2C Communications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.1.10 ACK .......................................... 10
2.2 General Purpose Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3 Displaying Text 12
3.1 General ............................................. 13
3.2 The built in Character Font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3.3 Writing Text to the Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.4 Text Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.4.1 Auto Line Wrap On (254 67) (R) . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.4.2 Auto Line Wrap Off (254 68) (R) . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.4.3 Auto Scroll On (254 81) (R) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.4.4 Auto Scroll Off (254 82) (R) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.4.5 Set Cursor Position (254 71 [column] [row]) (R) . . . . . . . . . . . . . . . . . . . 15
3.4.6 Send Cursor Home (254 72) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.4.7 Turn on Underline Cursor (254 74) (R) . . . . . . . . . . . . . . . . . . . . . . . . 15
3.4.8 Turn off Underline Cursor (254 75) (R) . . . . . . . . . . . . . . . . . . . . . . . . 15
3.4.9 Turn on Blinking Cursor (254 83) (R) . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.4.10 Turn Off Blinking Cursor (254 84) (R) . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.4.11 Cursor Left (254 76) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.4.12 Cursor Right (254 77) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Matrix Orbital PK162-12 ii

4 Keypad Interface 16
4.1 General ............................................. 16
4.2 Connections........................................... 16
4.3 I2CInterface .......................................... 17
4.4 RS-232 Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.5 Keypad Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.5.1 Auto Repeat Mode On (254 126 [mode]) (R) . . . . . . . . . . . . . . . . . . . . . 18
4.5.2 Auto Repeat Mode Off (254 96) (R) . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.5.3 Auto Transmit Keypresses On (254 65) (R) . . . . . . . . . . . . . . . . . . . . . . 19
4.5.4 Auto Transmit Keypresses Off (254 79) (R) . . . . . . . . . . . . . . . . . . . . . . 19
4.5.5 Clear Key Buffer (254 69) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.5.6 Poll Keypad (254 38) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.5.7 Set Debounce Time (254 85 [time]) (R) . . . . . . . . . . . . . . . . . . . . . . . . 19
4.5.8 GPO or Keypad Mode (254 37 [mode]) . . . . . . . . . . . . . . . . . . . . . . . . 20
5 Bar Graphs and Special Characters 20
5.1 Command List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
5.1.1 Initialize Wide Vertical Bar Graph (254 118) . . . . . . . . . . . . . . . . . . . . . 20
5.1.2 Initialize Narrow Vertical Bar Graph (254 115) . . . . . . . . . . . . . . . . . . . . 20
5.1.3 Draw Vertical Bar Graph (254 61 [column] [height]) . . . . . . . . . . . . . . . . . 21
5.1.4 Initialize Horizontal Bar Graph (254 104) . . . . . . . . . . . . . . . . . . . . . . . 21
5.1.5 Draw Horizontal Bar Graph (254 124 [column] [row] [dir] [length]) . . . . . . . . . 21
5.1.6 Define Custom Character (254 78 [c] [8 bytes]) . . . . . . . . . . . . . . . . . . . . 21
5.1.7 Initialize Medium Digits (254 109) . . . . . . . . . . . . . . . . . . . . . . . . . . 23
5.1.8 Draw Medium Digits (254 111 [row] [column] [digit]) . . . . . . . . . . . . . . . . 23
6 Miscellaneous Commands 23
6.1 Command List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
6.1.1 Remember ....................................... 23
6.1.2 Clear Display (254 88) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
6.1.3 Display On (254 66 [minutes]) (R) . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
6.1.4 Display Off (254 70) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
6.1.5 Load Startup Screen (254 64 [32 characters]) . . . . . . . . . . . . . . . . . . . . . 24
6.1.6 Set brightness (254 153 [brightness]) (R) . . . . . . . . . . . . . . . . . . . . . . . 25
6.1.7 Set brightness and save (254 152 [brightness]) (R) . . . . . . . . . . . . . . . . . . 25
6.1.8 General Purpose Output Off (254 86 [gpo #]) . . . . . . . . . . . . . . . . . . . . . 25
6.1.9 General Purpose Output On (254 87 [gpo #]) . . . . . . . . . . . . . . . . . . . . . 25
6.1.10 Set I2C Address 254 51 [address]) (R) . . . . . . . . . . . . . . . . . . . . . . . . . 26
6.1.11 Read Module Type (254 55) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
6.1.12 Set RS-232 port speed (254 57 [speed]) . . . . . . . . . . . . . . . . . . . . . . . . 26
6.1.13 Set Serial Number (254 52 [byte1] [byte2]) (R) . . . . . . . . . . . . . . . . . . . . 27
6.1.14 Read Serial Number (254 53) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
6.1.15 Read Version Number (254 54) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
6.2 Flow Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
6.2.1 Enter Flow Control Mode (254 58 [full][empty]) . . . . . . . . . . . . . . . . . . . 27
6.2.2 Exit Flow Control Mode (254 59) . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Matrix Orbital PK162-12 iii

7 Appendix: Command Summary 28
7.1 General ............................................. 28
7.2 Issuing Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
7.3 OnNumbers........................................... 28
7.3.1 ASCII Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
7.4 Text Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
7.5 Keypad Interface Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
7.6 Bar Graphs and Special Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
7.7 Miscellaneous Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
8 Appendix: Specifications and Options 35
8.1 Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
8.2 Options ............................................. 37
9 Appendix: Glossary 37
Matrix Orbital PK162-12 iv

1 Introduction
The PK162-12 comes equipped with the following features;
•16 column by 2 line text PLED display
•Built in font with provision for up to 8 user defined characters
•Speeds from 1200 bps to a lighting fast 19.2 Kbps over RS-232
•Communication over I2C or RS-232 (with software controlled speed)
•Use of up to 127 modules on the same 2-wire I2C interface
•Fully buffered so that no delays in transmission are ever necessary
•Ability to add a customized splash / start-up screen
•Use of Matrix Orbital’s "Remember" functions to save settings
•Software controlled brightness with configurable time-out setting up to 90 minutes
•Use of up to a 12 key keypad with a 10 key buffer
•Seven general purpose outputs for a variety of applications
•Horizontal or vertical bar graphs
•Medium digits capability
•Variable power options, +5V or +9V to +15V
•Extended temperature option
1.1 What to Expect From the PK162-12
The display is designed as the display unit for an associated controller. The controller may be anything
from a single board, special purpose micro-controller to a PC, depending on the application. This controller
is responsible for what is displayed on the screen of the display.
The display provides a simple command structure to allow text and bar graphs to be displayed on the
screen. Text fonts are built in, and use standard ASCII mapping. Provision is made for up to 8 user defined
characters.
The screen is luminous for low light situations. Display may be turned on or off under program control.
Brightness is adjustable to compensate for differing lighting conditions.
General purpose outputs allow the controller to switch up to six electronic or electro-mechanical devices
by issuing commands to the display unit. These can be used for controlling LEDs, relays, etc.
1.2 What Not to Expect From the PK162-12
The display does not include bitmap graphics capability, except that permitted by defining special char-
acters.
1.3 Keypad Interface
The keypad interface takes row / column input and converts it to ASCII characters, which are delivered
out the RS-232 or I2C port to the associated controller. Please note that the keypad is not used to directly
control any aspect of the operation of the display, which acts simply as a matrix to serial converter. To use
the keypad to control the display the controller must be programmed accordingly.
Matrix Orbital PK162-12 1

1.4 Setup for Testing
Before setting up the application the user may want to try out the display. This is easily done with a PC.
If not equipped with a dual bay PC mounting kit, the following will be required;
•A 4-pin power connector of the type used to connect 3.5" floppy drive. Take care not to connect the
display to an unmodified spare power connector in a PC
•A 5 V power supply
•A PC with a spare RS-232 port (COM1 or COM2)
•A 9 or 25 pin RS-232 serial cable. If using a 25 conductor cable, a 9 to 25 pin adapter will be required
Figure 1: Connections for Testing
1. Refer to the Figure above for the following steps.
2. Wire the connector to the power supply. On most connectors the RED lead will go to +5V and the
BLACK lead to GND.
NOTE The Manufacturer’s Warranty becomes void if the unit is subjected to over-voltage
or reversed polarity.
3. Connect the display to the PC using the serial cable and adapter if required.
NOTE Make certain the RS-232 cable includes the required ground lead. There must be
no voltage differential between the RS-232 ground and the power supply ground.
4. Connect the power connector, making sure that the +5V goes to V+. Turn on the power: the display
backlight should come on.
Matrix Orbital PK162-12 2

1.5 Trying Out the PK162-12
The unit should be connected to power and the PC and backlight should be on.
To experiment with typing text, run a PC terminal program such as Hyperterm.
Make sure it’s configured to use the correct port. Set the baud rate to 19,200.
If characters are typed on the keyboard, they should now appear on the display screen. Text will wrap
around to the next line when the end of a line has been reached.
1.6 Trying out a Keypad
Since a number of different keypad types can be connected to the display, the results may be a little
unpredictable. At this point all we need to do is make sure that the keypad and interface work, and possibly
generate an ASCII map for any programming needs. The keypad interface on the display converts a row /
column connection to an ASCII character. By default, a keypress is transmitted as serial data immediately.
Keypad buffering can be selected using the appropriate commands.
1.6.1 Here’s what to do:
1. The PC should be running a terminal program, such as Hyperterm, as in the previous section.
2. With the display connected to the PC, plug the keypad in. If the connector has fewer pins than the one
on the display, center it as well as possible.
NOTES
•The keypad connector must be wired with columns on one side and rows on the other
side of the center of the connector. If the keypad isn’t wired this way an adapter must
be made or the connector must be rewired to meet this requirement.
•The connector is reversible. Reversing the connector will not damage the keypad or
the display, but will however, change the ASCII character map.
3. Press a key on the keypad. An upper case ASCII character (A-Y) should appear on the PC screen.
Different keys should generate different characters.
To experiment, reverse the connector and see if it generates a more logical set of characters. Ultimately, the
program in the micro-controller will have to ’map’ these characters to the ones marked on the keypad, which
will likely be different.
1.7 Manual Over-ride
Manual over-ride should only be required in one instance. If for some reason the module is set at a baud
rate which cannot be produced by the host system and all communication to the display is lost, then the user
should follow this simple procedure;
Matrix Orbital PK162-12 3

1. Turn off the display
2. Put a jumper on pins 3 and 4 of the keypad connector (C3 and R1)
3. Power up the display. The baud rate is now set to 19,200
4. Remove the jumper and change the RS-232 port settings to the desired baud rate
5. Turn off the display
6. Power up the display
Refer to the "Set RS-232 port speed" command for acceptable baud rates.
Figure 2: Manual Over-ride
Place jumper on the above pins.
1.8 Memory Chip Lock Down
The display uses a memory chip to store speed, start up screen contrast, I2C setting and other settings.
When everything has been changed to the desired settings and the unit is in a finished product or in the field,
locking down the memory chip so no settings can be changed might be desirable. This is only to be done
by knowledgeable people. Any damage to the display by this procedure resulting from user error will not be
covered under the Manufacturer’s Warranty.
Figure 3: Unlocked & Locked
Matrix Orbital PK162-12 4

To lock down the memory chip, solder the jumper as shown in the LOCKED picture above. This will
lock down the memory chip, not allowing anything to be changed inside it until the jumpers are restored to
their original position.
2 Connections
2.1 Connector Pinout
Refer to the Figure below for this chapter.
Figure 4: Electrical Connections
The display has four connectors;
Table 1: Connectors & Functions
Connector Function
14 Pin Dual Header General purpose outputs or Keypad (2x7)
4 Pin Power (Vdc) and I2C communications
DB-9F RS-232 / Power
Table 2: Mating Connectors
14 Pin Dual Header Many, ex. MOLEX 70058
4 Pin MOLEX 7880
DB-9F
Matrix Orbital PK162-12 5

2.1.1 Power Connection
Power is applied via pins 1 and 4. Power requirement for standard units is +5 VDC ±0.25V (units with
the wide voltage range option require 7 - 15 Vdc). Power may also be supplied via the RS-232 connector.
WARNINGS
•Do not apply any power with reversed polarization.
•Do not apply any voltage other than the specified voltage.
•Do not use any cables other than the cables supplied by Matrix
Orbital, unless aware of the modifications required.
•Do not apply power to the DB-9 connector AND the power con-
nector. Do not apply more than +5Vdc to pin 9 on the DB-9 con-
nector.
2.1.2 Five Volt Modules
If the display is used in a PC it becomes tempting to plug a spare power connector into the unit. Don’t
do this! Wiring for the PC power connector and that required for the display are different.
Figure 5: Wiring for 5V Modules
Matrix Orbital can supply an adapter cable designed for use with the display when it’s installed in a PC.
Note that the cable below does not provide connections for I2C.
Matrix Orbital PK162-12 6

Figure 6: Five Volt Power Cable
2.1.3 Wide Voltage Range Modules
NOTE Do not use this cable unless the display module has the "Wide voltage range"
option (option V). Use of the 12 volt power cable with 5 volt modules will damage the
module.
The 12 volt power cable is designed for use with wide voltage range display modules mounted in a PC.
Wiring required for the 12 volt power connector is shown in the Figure below.
Figure 7: Wiring for 12 Volt Modules
Matrix Orbital can supply an adapter cable designed for use with the display module when it’s installed
in a PC. The cable is wired as shown in the Figure below.
Figure 8: Twelve Volt Power Cable
Matrix Orbital PK162-12 7

2.1.4 Power through the DB-9 Connector
The display can be powered by pin 9 on the DB-9 connector. If power is applied here, power cannot be
applied to the other power connector. The input voltage for pin 9 can only be +5Vdc, even if the unit is wide
voltage.
NOTE Failure to follow these instructions will result in the destruction of the unit.
The jumper shown in the Figure below will have to soldered to use the DB-9 connector for power.
Figure 9: DB-9 Power
2.1.5 RS-232 Communications
The RS-232 connector on the PC cable is wired so that a standard ’straight through’ 9 pin D-sub cable
may be used to connect the module to a standard serial port such as COM ports on PCs. Note that this device
complies with the EIA232 standard in that it uses signal levels from ±12V to ±12V and can be converted
to TTL levels as well. The display is set at 19.2Kbps default speed. Other settings are;
8 bits, no parity, 1 stop bit.
2.1.6 DB9 Connection
A standard DB-9F is provided for RS-232 communications. Power may also be supplied via this con-
nector if desired.
Figure 10: RS-232 and Power Connector
Matrix Orbital PK162-12 8

Table 3: RS-232 Pinout
Pin Number Direction Description LCD Host
2 Data from LCD Data out(LCD) Tx Rx
3 Data to LCD Data in (LCD) Rx Tx
5 - Ground gnd gnd
2.1.7 Alternate Serial Connection
An optional alternate connection header is provided to allow one cable for data and power. Two jumpers
will have to be soldered and two removed.
Figure 11: RS-232 SIPs
Connector pinout is as follows;
Figure 12: Power Connector
Table 4: Connector Pinout
Pin 4 Ground
Pin 3 Rx
Pin 2 Tx
Pin 1 Vdc
Matrix Orbital PK162-12 9

2.1.8 TTL Communications
The display can be talked to at TTL (logic 0V to +5V) levels. Two modifications must be made.
Figure 13: RS-232 Selects
Jumpers 2 and 3 must be closed and 1 and 4 open.
2.1.9 I2C Communications
I2C communications runs at 100Kbps and supports up to 127 units on a single communications line. The
I2C data line operates on 5 volt CMOS levels.
2.1.10 ACK
The idea of ACK is to indicate when the data has been received correctly. ACK does not indicate data
incorrectly received. ACK simply fails to indicate when data is correctly received. Clearly, this is of limited
usefulness and even less so with Matrix Orbital modules. Matrix orbital modules are not capable of failing
to acknowledge an incorrectly received byte in response to that byte’s transition. They are only capable of
failing to acknowledge the bytes following the byte, which was not received. To fully understand the reasons
for this, one needs to understand how a Matrix Orbital module processes data. Basically, the reason why a
Matrix Orbital module might fail to receive a byte correctly is that it was unable to process the byte previous
before the failed byte was transmitted. Because the module cannot possibly know that it would be unable to
store the byte before the next byte was received it cannot know to not ACK. The reason for this situation in
deference to situations one might be familiar with (i.e., memory chips, etc) is that the Matrix Orbital module
employs a micro-processor to perform these data storage functions. A memory chip takes care of these
things entirely within hardware subsystems which operate at the same speed as the transmission themselves.
The display uses a standard Phillips 7bit address as defined by Phillips. However, Matrix Orbital specifies
I2C address in 8bits. The 8th bit, least significant bit, LSB or Low Order Bit of the 8bit address is a read
Matrix Orbital PK162-12 10

/ write bit. If we take a standard Phillips 7bit address of 45hex this would be in binary 1000101. This is
7bits. Matrix Orbital would describe the Phillips I2C address of 45hex as 8Ahex. The read address would
be 8Bhex.
For more information on Phillips I2C please visit;
!"#%$!&%'()*
and for more information specific to our displays visit;
+!&",-%.%*0/12!,3*4",-.*5/%673%,!89:3
To communicate by I2C two jumpers have to be set into the I2C position left of the power SIP connector.
The I2C setting is default on the display.
Figure 14: RS-232 SIPs
Connector pinout is as follows;
Figure 15: Power Connector
Table 5: Connector Pinout
Pin 4 Ground
Pin 3 SDA (I2C data)
Pin 2 SCL (I2C clock)
Pin 1 Vdc
2.2 General Purpose Outputs
The display has seven general purpose outputs. These are provided to control relays or other electronic
devices. This allows external devices to be turned on or off using the PC or controller and software com-
Matrix Orbital PK162-12 11

mands. The + terminal is connected directly to the module positive supply, the - terminal is connected
through a 240ohm current limiting resistor and the electronic switch to ground.
Figure 16: General Purpose Outputs
Maximum allowable current is 20mA, which is enforced by the current limiting resistor. If the device
being switched has a resistance of 240ohms or more the corresponding resistor may be shorted.
NOTE The GPOs do not have any over current or over / under voltage protection so
care must be taken when using them. For instance if the external device is a relay it must
be fully clamped using a diode and capacitor to absorb any generated back electro-motive
force (EMF).
Figure 17: Clamping a Relay
3 Displaying Text
This chapter describes the various text display commands in detail. Before issuing commands to the
PK162-12 please read sections 7.2 and 7.3.
Matrix Orbital PK162-12 12

3.1 General
Text is displayed on the PK162-12 using the built in 5x8 dot matrix font, in addition to up to 8 user
defined characters.
3.2 The built in Character Font
The display includes a built in 5x8 dot matrix font with the full range of ASCII characters plus a variety
of extended characters.
Figure 18: Character Set
In addition to the built in characters, users may define up to 8 special characters (which, once defined,
occupy positions 0x00 to 0x07 in the above chart). The display does not have provision to download other
Matrix Orbital PK162-12 13

fonts.
3.3 Writing Text to the Display
When the display receives a character, it displays that character at the position currently defined. The
next character sent to the module then advances to the following position on the display. Characters are
drawn using the built in font, and only characters defined in the font are actually displayed. Characters that
are not defined by the built in font print as a space. An example of this would be that the cursor is advanced
for the next character.
The position where text is to be inserted is a character location stored in the display’s volatile memory
and maintained internally by the display’s firmware. This position is manipulated by the commands shown
in the following section.
3.4 Text Commands
In this section commands are identified by their names and decimal values.
Some commands, marked with an “R”, may be ’remembered’ to set new defaults that will be in effect
each time the unit is powered on.
3.4.1 Auto Line Wrap On (254 67) (R)
Enables automatic line wrapping. Note that this is not ’word wrapping’ and wraps may occur in the
middle of a word.
3.4.2 Auto Line Wrap Off (254 68) (R)
Disables automatic line wrapping. Characters beyond the end of a line will be lost.
3.4.3 Auto Scroll On (254 81) (R)
When auto scrolling is on, it causes the display to shift the entire display’s contents up to make room for
a new line of text when the text reaches the scroll position (the bottom right character position).
3.4.4 Auto Scroll Off (254 82) (R)
When auto scrolling is disabled, text will wrap to the top left corner of the display area. Existing text in
the display area is not erased before new text is placed. A series of ’spaces’ followed by a “Cursor home”
command may be used to erase the top line of text.
Matrix Orbital PK162-12 14

3.4.5 Set Cursor Position (254 71 [column] [row]) (R)
This command sets the cursor position (text insertion point) to the [column] and [row] specified. Columns
have values from 1 to 20 (0x01 to 0x14) and rows have values of 1 and 2 (0x01 and 0x02).
3.4.6 Send Cursor Home (254 72)
This command moves the cursor position (text insertion point) to the top left of the display area.
3.4.7 Turn on Underline Cursor (254 74) (R)
Turns on the underline cursor. The cursor shows the current text insertion point. Both underline and
blinking cursors may be turned on or off independently. The cursor is off by default.
3.4.8 Turn off Underline Cursor (254 75) (R)
Turns off the underline cursor. Does not affect the blinking block cursor.
3.4.9 Turn on Blinking Cursor (254 83) (R)
Turns on the blinking block cursor. The cursor shows the current text insertion point. Both blinking and
underline cursors may be turned on or off independently. The cursor is off by default.
3.4.10 Turn Off Blinking Cursor (254 84) (R)
Turns off the blinking block cursor. Does not affect the underline cursor.
3.4.11 Cursor Left (254 76)
Moves the cursor one position to the left but does not erase any character that may be in that position.
Note that this command moves the text insertion point even if the cursor is turned off.
NOTE A ’destructive backspace’, which erases the character to the left of the original
position, may be done by issuing the following sequence: cursor left, space, cursor left.
Matrix Orbital PK162-12 15

3.4.12 Cursor Right (254 77)
Moves the cursor one position to the right but does not erase any character that may be in that position.
Note that this command moves the text insertion point even if the cursor is turned off.
4 Keypad Interface
This chapter describes the keypad interface and associated commands in detail.
4.1 General
The display keypad interface processes the keypad row / column matrix into a serial (RS-232 or I2C)
data byte stream. Aside from this processing, the keypad has no effect on the display. To send keystrokes
to the display, they must be routed through the controller. Whenever a columns and a row pin are shorted
together, a keystroke will be generated and either held in the buffer (I2C) or send over the serial line to the
host (RS-232). The keypad shares the same pins as the seven GPOs on the display and only one or the other
can be used at one time.
4.2 Connections
Figure 19: Keypad Connector
The connector is not ’keyed’ so the keypad will probably plug in either of two ways. The display will not
be damaged by reversing the connector, but the keypad will generate a different ASCII character mapping
Matrix Orbital PK162-12 16