MagTek 99875125 - Manual (Page 29)

Section 3. Commands
rawsend
Function Send arbitrary data to the device.
Syntax /rawsend x
x is an arbitrary string which is transmitted directly to the device. The string x is passed
as-is to the device, except for ‘\’ which is used as an ‘escape’ character:
•
\r is converted to
•
\n is converted to
•
\\ is converted to \
•
\xhh is converted to a character with ASCII value hh (always two hex digits),
e.g., \x20 is converted to a space.
Errors none
Remarks This command as with the other raw commands supports any features that have not been
implemented in the standard set of commands. Note: the driver inserts appropriate framing
characters, e.g., and or and for certain IntelliPIN commands.
Example To change the default message 00 to show “Welcome to Our Bank” on two lines of the
IntelliPIN:
Command /rawsend 5100Welcome to\x1COur Bank
Response none
Note: When using C++, include an extra slash to include the “/r”: “//rawsend…”
rawxact
Function Execute a send/receive transaction with the device in raw mode.
Syntax /rawxact x
x is an arbitrary string which is transmitted directly to the device. The string x is passed
as-is to the device, except for ‘\’ which is used as an ‘escape’ character:
•
\r is converted to
•
\n is converted to
•
\\ is converted to \
•
\xhh is converted to a character with ASCII value hh (always two hex digits),
e.g., \x20 is converted to a space.
Errors /rawxact 45
If a command is already pending.
/rawxact 82
If the command was canceled by the user (e.g., with CLEAR key)
Remarks This command is a combination of /rawsend and /rawrecv. It sends the supplied data to the
device, overrides the default processing of the next message that comes from the device and
returns it to the application as a /rawxact response. After the response is returned (or
canceled), the driver switches to normal operation. The syntax for this command is identical
to the syntax of the /rawsend command; the syntax of the response is identical to the
/rawrecv response.
Example To load a master key of 23AB4589EF6701CD into the IntelliPIN:
Command /rawxact 9423AB4589EF6701CD
Response /rawxact 00 940
21