4 - Command Set
DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)
Page 109 of 247 (
D998200136-31
)
4.4.14
Report 0x2F - Request Host Connection (Handheld Operation Only, 802.11 Wireless
Only)
When the device is configured in a handheld solution to not persistently listen for host commands on a
predetermined TCP/IP port (see
Network Connection Mode
in
Command 0x09 - Set / Get Device
), it sends this report to the host to request the host initiate the connection:
1)
The device must first be properly configured, which will include specifying how it should connect to
the host [see section
4.6 Wireless Connection Commands and Reports (802.11 Wireless Only |
2)
On the device’s keypad, an operator enters a
Start Transaction
keypad sequence.
3)
The device checks its connection to the Wireless 802.11 Access Point, and if necessary, registers its
device name (
TLS
plus its serial number) with the DNS server, and gets an IP address.
4)
The device opens an unsecured TCP connection to the configured host.
5)
The device sends the host this notification, which contains the Device TLS Certificate Common
Name, which is the same as the registered DNS Name of the device, and will only accept an ACK
response from the host.
a)
If the host responds correctly, the device closes the TCP connection, opens a secure listening
socket for the host to connect to, and waits for the host to initiate a connection.
b)
If the host does not respond or responds incorrectly, the device closes the socket, shows an error
on the display, and terminates the operation. The operator must enter a
Start Transaction
keypad sequence to start again.
6)
The host can now connect to the listening socket and send any available command.
7)
The host should perform all required operations, then close the socket. If there is no user activity and
the host leaves the connection inactive past the timeout set by
Command 0xE2 - Set / Get Wireless
Timeouts (802.11 Wireless Only | PCI Bluetooth LE Only)
, the device closes the connection
automatically and returns to the Welcome screen. To deal with this case, the host should always
check to make sure it has an open connection before assuming it can continue with a multi-part
operation. If the socket is not available, the host should assume the device has returned to the
Welcome screen.
Although all commands are then available for the host to call over the connection, generally the host
should assume the device is performing a handheld transaction, and respond by sending the device either
Command 0x1F - Request Clear Text Cardholder Data Entry (Clear Text User Data Only)
Command 0x14 - Request Cardholder Data Entry
with the command’s Cardholder Data Mode set to
one of the Handheld Operation selections. In many cases the host would then issue
Request Tip or Cashback (Handheld Operation Only)
to gather further information from the
cardholder, then use the gathered data to send
Command 0xA2 - Start EMV Transaction
Table 4-73 - Usage table for Report 0x2F - Request Host Connection
Byte
Description
Byte 0
0x2F
Bytes 1..2
Device Listening Port
Byte 3
TLS Enabled
0x00 = Disabled
0x01=Enabled
Byte 4
Device TLS Certificate Common Name length
