Magtek DynaPro Go, Programmer'S Manual

Page: 173 / 247

Appendix G - Custom Messages (Custom Messages Only)
DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)
Page 173 of 247 ( D998200136-31 )
Appendix G Custom Messages (Custom Messages Only)
The host can set custom messages on the device as follows:
1) Create a block of custom message data (see Table 4-111 ) containing one or more message strings
2) Send it to the device using Command 0x10 - Send Big Block Data to Device
3) The messages are then available when using Command 0x06 - Request Cardholder Selection or
Command 0x07 - Display Message .
Table 4-111 - Custom messages Big Block Format
Bit 7 6 5 4 3 2 1 0
Byte 0 # of custom messages
Byte 1..a1 Custom message 1 (see Table 4-112 )
Bytes
a1+1..a2
Optional custom message 2 (see Table 4-112 )
…
Etc. (see Table 4-112 )
Table 4-112 - Custom Message Format
Bit 7 6 5 4 3 2 1 0
Byte 0 Length of para string (no null at end of string) [includes this byte]
Byte 1 X axis location of string (0x00..0x7F)
Byte 2 Y axis location of string (0x00..0x3F)
Byte 3
0 =
background
unchanged
1 =
Background
cleared
Set to 1
for
underline
Spacing:
0 = Proportional
1 = Prop except #’s
2 = Fixed spacing Alignment:
0 = Left
1 = Center
2 = Right Font size:
0 = Small
1 = Small Bold
2 = Big
Byte 4 0x00 (rfu)
Bytes 5..n String data (no terminating null)
This code snippet provides an example of how to write a custom message to the device:
void addCustomMessageString(MemoryStream m, byte x, byte y, byte p1,
byte p2,string s)
{
m.WriteByte((byte)(s.5));
m.WriteByte(x);
m.WriteByte(y);
m.WriteByte(p1);
m.WriteByte(p2);
System.Text.ASCIIEncoding encoding = new
System.Text.ASCIIEncoding();