Milan / Paylink System Manual
Issue 1.5 29 January 2020
CONFIDENTIAL
Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd
Page 22 of 71
Coin / Note Dispenser Usage Details
Dispenser Power Fail support.
Some dispensers, especially hoppers produced by MCL and some bill recyclers, are guaranteed to
correctly count coins even if power is removed during a payout sequence. This facility is explicitly
supported in the Paylink software. The
Count
field in the interface for these hoppers is set during
Paylink start-
up initialisation to correspond to the “total coins paid since manufacture” value (or its
closest equivalent) retrieved from the hopper, and is then updated as payouts occur. This field allows
for the correct counting of coins over a power failure.
At the end of every payout sequence, the Paylink stores, internally, the
Count
for each hopper. At
initialisation as well as reporting the retrieved count, it is also compared with the saved value. This
enables the
CurrentPaid()
function to continue to report the correct value, and also generates an
IMHEI_COIN_DISPENSER_UPDATE
Event
(see below) to register this update.
Detailed Device Support.
Abandoning a payout in progress (1.11.3)
As well as preventing a payout operation from starting, the Inhibit field in a dispenser is also used
during an actual payout. If the application set a dispenser inhibit while a payout it is in progress,
Paylink will attempt to abandon the payout in progress on that device.
Note that the overall payout will still continue on all the other dispensers that are not inhibited. To
cancel an entire payout the application should inhibit all dispensers.
Control of unwanted bill payout (1.11.3)
Under failure conditions a number of bill handling systems can enter a state where bills are not
accessible to the end user, but cannot be returned to a cash / reject location. When Paylink detects
these circumstances, it will pause its operation, queue a
IMHEI_NOTE_DISPENSER_PENDING
event with
the number of bills as the RawEvent field and automatically set an inhibit on the relevant dispensers.
The bills can be delivered by clearing the inhibit for
all
the dispensers that form part of the unit.
Combi Hopper Support.
This single unit dispenses two different coin values. It is therefore handled in a similar way to the
MDB system. There is a primary dispenser, which is set up as a normal unit with a
Unit
field of
DP_MCL_SCH3A, and a
Value
field with the lower coin value in it. The
Count
in this dispenser is
the count of the lower value coins dispensed. In addition, another dispenser is set up, with a
matching
Address
field, a
Unit
field of DP_CC_GHOST_HOPPER, the
Value
of the higher coin
and the
Count
of the higher value coins dispensed.
Note that, due to limitations of the unit, during a payout operation the
Count
of the main dispenser
only
is updated, as though all coins dispensed were of this value. At the end of the sequence, while
LastPayStatus()
is still returning PAY_ONGOING, the accurate count of both coins is retrieved and
the two separate
Count
fields updates. The result of this is that, as the operation finishes, the
Count
for the lower value dispenser decrements.