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 <CR>
•
\n is converted to <LF>
•
\\ 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., <stx> and <etx> or <si> and <so> 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<LF>
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 <CR>
•
\n is converted to <LF>
•
\\ 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<LF>
If a command is already pending.
/rawxact 82<LF>
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<LF>
Response /rawxact 00 940<LF>
21