Page 1
This document is the property of Aardvark Embedded Solutions Ltd and may not be reproduced in part or in total by any means, electronic or otherwise, without the written permission of Aardvark Embedded Solutions Ltd. Aardvark Embedded Solutions Ltd does not accept liability for any errors or omissions contained within this document.
MDB changer / BCR / CR10x / CLS recycler / SmartHopper support....19 MDB Payout ..........................19 MDB tube level monitoring.......................20 CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 2 of 71...
Page 3
Keeping Notes ..........................36 Operation ......................37 Abnormal Situations ..................38 Cashless Processing ..................39 Background ....................... 39 Processing ......................40 Credit Card Sequencing ......................40 CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 3 of 71...
Page 4
Gen2 Protocol ....................68 F56 Protocol ...................... 69 MFS Protocol ....................69 Cassettes ......................69 Original Paylink Definition................. 70 Disclaimer ......................71 CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 4 of 71...
Page 5
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 5 of 71...
12 December 2016 D Bush 1.12.8 updates 11 September 2019 D Bush 1.12.9 & 1.12.10 updates 29 January 2020 D Bush 1.12.11 updates CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 6 of 71...
(Micro Paylink) a PC software only version, for use with Money controls USB peripherals. PCI Card This is the original obsolescent hardware unit. It was known as Milan a long time ago, but this is its current name, CONFIDENTIAL...
29 January 2020 Supported Facilities It should be noted that this document cover all versions of the Milan / Paylink system, even those versions that are not yet generally available. Where a facility may not be available with the version that you are running, the topic titles are suffixed...
LastPayStatus() is PAY_ONGOING - when the entire payout process is complete it will either report PAY_FINISHED (indicating the value request has been paid out) or it will report the last failure code that was processed. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 10 of 71...
A number of mechanical / pulse meters can be connected to Paylink’s standard outputs. There are controlled by the same interface as the SEC meter. Provision is made for CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 11 of 71...
Milan firmware installed on the Milan / Paylink unit. As the Milan / Paylink unit is connected to the PC by a USB cable, there has to be software at both ends of this USB link to conduct the communications over the link.
(I / E) JCM Vega on cctalk (I / E) Innovative NV11 on cctalk (I / E) Merkur MD100 (I / E) Innovative Smart Payout (NV200) CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 13 of 71...
Milan / Paylink System Manual Issue 1.5 29 January 2020 Note Dispensers (I) MFS series note dispensers. (G) Fujitsu F53 (G) Fujitsu F56 CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 14 of 71...
MEIBNR These are taken from the DenominationList, the Currency Code, Value and Variant are concatenated to give the string used. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 15 of 71...
DefaultPath 2 for coin 1, 0 for all other coins PathSwitchLevel 400 for coin 1, 0 for all other coins CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 16 of 71...
Setting route 0 should be avoided as it does not exist on an SR5 coin acceptor. The settings for PathSwitchLevel and PathCount are restored automatically by Paylink after a reset. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 17 of 71...
Respond to a BCR fault reports with a subsystem clear command Report the unit is busy while any of the carousel, singulator, payout belt etc. are active CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 18 of 71...
Unit field with the constant value of while the DP_MDB_TYPE_3_PAYOUT individual tubes have Unit fields with the constant value of DP_MDB_LEVEL_2_TUBE CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 19 of 71...
While a payout is in progress, no updates are made to the coin level. As soon as the payout completes, Paylink immediately issues a Tube Status (0x02) MDB command to obtain the changer’s opinion of the new levels. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 20 of 71...
Is taken from the first component returned by GetIdentification It is the numeric value of the 1st 6 characters of the name field. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 21 of 71...
Count fields updates. The result of this is that, as the operation finishes, the Count for the lower value dispenser decrements. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 22 of 71...
The phsyicalCashUnit name. The Dispenser.SerialNumber field is generated as follows: ccTalk The binary reply to the ID Serial No (242) command. Not Available CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 23 of 71...
ACCEPTOR_NO_KEY the AcceptorBlock.Status field. The mechanism for triggering a key exchange is unique to each manufacturer / device. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 24 of 71...
- but this is device specific. This may cause different value bills already in that recycler to be dumped to the cashbox. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 25 of 71...
Triggering this is implemented on Paylink by the user setting the count of bills that are to be dumped in the new DispenserBlock.NotesToDump field and a value of in the DISPENSER_PARTIAL_DUMP DispenserBlock.Status field. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 26 of 71...
Page 27
The application can check for the value being replaced by another DISPENSER_PARTIAL_DUMP status. Where the dump process completes normally, the status will take value of DISPENSER_DUMP_FINISHED. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 27 of 71...
Count fields before a payout is started, and then react accordingly if on startup they discover that a payout was in progress. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 28 of 71...
RawEvent field. If the number of bills is unknown then 99 is used. To complete the delivery process, the application should clear the inhibit setting on all the relevant dispensers. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 29 of 71...
IMHEI_NOTE_DISPENSER_ event to the application, which identifies the drum and in question and includes the count of MISREAD bills that are missing. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 30 of 71...
It is not possible to initiate a recycler to cash box note dump so the DUMP and PARTIAL_DUMP operations have no effect. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 31 of 71...
The counts returned by Paylink are those from the unit, and so under these circumstances will be incorrect - it is up to the application to compensate for those bills it knows have been manually inserted. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 32 of 71...
When Paylink discovers this situation, during startup, or following a “long” power fail, it will undertake Unpaid Bill processing as above. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 33 of 71...
If this succeeds, then any bills “in progress” will be returned to the stacker. This recycler is capable of directing the same bill to multiple dispensers, using the method described above. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 34 of 71...
The application, which uses the Paylink escrow facilities to control and monitor this, can then decide to either stack (keep) the notes, or can decide to return the notes to the user. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 35 of 71...
This status stays until fixed RETURNED_OK ACCEPT WAITING This clears the previous transaction STOP RETURNING_PROBLEM RETURN RETURNING Retry the return FULL PAUSE PAUSED CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 37 of 71...
To allow the application control over the timing of this return, the extended escrow system transitions from when the command is issued. RETURNED_PROBLEM START CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 38 of 71...
The device failed during processing - no credit taken CR_FAILED_TAKEN The device failed during processing - credit was taken CR_INVALID_REF Invalid Reference CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 39 of 71...
The above table represent the normal way that credit acquisition proceeds. Paylink however includes facilities to handle abnormal situations. These situations use the fields: TotalAcquisitions and TotalCredit. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 40 of 71...
Call CashlessReadData () Credit Available ? Commit the transaction Vend Product and Call CashlessTakeCredit () Call CashlessReset () CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 41 of 71...
(as it is not driven for long enough) but no spurious pulses can be generated. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 42 of 71...
NOW_OK “fault” event will be generated. A specific bit in the event code is reserved for indicating fault events. Full details on the make up of the event codes are given in the “Milan / Paylink Programmers Manual” document.
Reject slug FRAUD Reject sensor blocked Games overload INTERNAL_PROBLEM Max. coin meter pulses exceeded INTERNAL_PROBLEM 128-159 Inhibited Coin INHIBITED Flight Deck Open RETURN CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 44 of 71...
Stacker jammed OUTPUT_PROBLEM Bill jammed in transport ( safe mode ) Opto fraud detected FRAUD String fraud detected FRAUD Anti-string mechanism faulty INTERNAL_PROBLEM CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 45 of 71...
The bit number of this first bit (i.e. a number between 0 to 31) is then returned in RawEvent and an EventCode of either IMHEI_COIN_DISPENSER_FRAUD_ATTEMPT IMHEI_COIN_DISPENSER_REPORTED_ FAULT CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 46 of 71...
Page 47
Unused Information only Unused Information only Unused Information only Unused Information only Use other hopper Information only PAY_NOT_EXACT Opto fraud Fraud PAY_FRAUD CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 47 of 71...
JAM IN ACCEPTOR 0x46 JAM IN STACKER OUTPUT_PROBLEM 0x47 PAUSE UNKNOWN 0x48 CHEATED FRAUD 0x49 FAILURE - Fault Report 0x4A COMMUNICATION ERROR INTERNAL_PROBLEM CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 48 of 71...
GENERIC BB ERROR FAULT 0x82 nn RETURNED RETURN 0x14 IDLING Generate an OK_NOW or OUTPUT_FIXED if in fault / output problem. 0x19 DISABLED CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 49 of 71...
( timeout, coin not seen ) 11 to 18 = Carousel gate NVRAM checksum corrupted Fault on coin return mechanism Fault on thermistor CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 50 of 71...
Page 51
1 = +24V rail operating limits 2 = +5V rail D.C.E. fault 0, 1 = Blocked 2 = Broken RAM test fail CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 51 of 71...
Page 52
Initialisation error 1 = Flush timeout Supply current outside 1 = +5V rail operating limits 2 = Hopper rail 3 = Solenoid rail CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 52 of 71...
RawEvent = the returned F56 error code (as described in the Fujitsu “F56-BDU ERROR CODE LIST” manual.) Index = F56 Cassette. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 53 of 71...
The same Windows programming utility is contained in all the firmware release files. When run normally it will check that a Milan / Paylink unit is installed and accessible, and will then compare the version of the firmware that it contains with version installed on the Interface. If they differ it will then load the new firmware: if they are the same it will display the (matching) details for 10 seconds and then automatically exit.
/Nogui - will never display anything on the screen and will report progress to stdout or a console window, if either is available. /Check - will cause the loader to exit without showing an window if the Milan firmware matches, and has no errors.
Since then, the number of possible configurations has grown to the point where some method is needed to tell Milan / Paylink details about where to look for specific peripherals, and how it should regard those peripherals when it found them.
“Using Dongle” line is present in the System section. On Linux this requires the Paylink executable, which is only available on some Intel distributions. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 57 of 71...
1, 8, 9 and 11 on the Paylink lid. These connectors provide the connections to peripherals concerned with handling currency. In this case there are many possible peripherals that can be connected to the Milan / Paylink unit. The peripherals actually connected are specified in the configuration file.
The keywords MAX, MAXIMUM & FLOAT are all equivalent, and can be interchanged at will. The keywords CONNECTOR & PORT are equivalent, and can be interchanged at will. In general plural keywords are equivalent to singular. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 59 of 71...
This is used in multiple Paylink installations, and specifies the serial number of the Paylink device that this driver is to connect to. (This is also available as a Driver program option.) CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 60 of 71...
2 three numbers define a colour to used for an enabled acceptor. At present this is only implemented on the Innovative SmartPayout. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 61 of 71...
F56 | F53 | F400 - These are synonym of each other for the Fujitsu D-Level protocol. GEN2 - The Future Logic ticket printer protocol. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 62 of 71...
Normally note / bill acceptors are at address 40 (28H), and often use a BNV key of 123456 and CRC message validation. The optional “No Reset” keyword supresses multiple resets performed as a part of cctalk automatic note recovery. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 63 of 71...
Page 64
“payout timeout” value from its default of 10 seconds to <Count> periods of 1/3 second. This is unlikely to work on hoppers not made by Money Controls. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 64 of 71...
Page 65
PC via a USB lead. The optional parameter causes the Paylink start-up code to send the appropriate message to set the level for the hoppers. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 65 of 71...
ACCEPTOR [AT] <Address> [SCALE [BY] <Scale Factor>] At present <Address> must be 3. This specifies that a CCNet bill acceptor is connected. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 66 of 71...
“standard” ID003 note acceptor or to a recycler that is using the JCM UBA recycler ID_003 extensions. (In the file this will typically follow the <Connector> on the same line.) CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 67 of 71...
A CX25 coin dispenser can be connected to USB. Gen2 Protocol A GEN2 communications line can connect to one singe Future Logic compatible ticket printer. CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 68 of 71...
Less common is one magnet, but an alternative set uses the four one bit numbers: Cassette 1 Value 10000 Cassette 2 Value 1000 Cassette 4 Value 500 Cassette 8 Value 100 CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 69 of 71...
1 Readout Value Protocol ID003 on connector RJ45 Protocol GEN2 on connector 11 Protocol MDB on connector MDB Changer at 08H Bill at 30H CONFIDENTIAL Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd Page 70 of 71...
This manual is intended only to assist the reader in the use of this product and therefore Aardvark Embedded Solutions shall not be liable for any loss or damage whatsoever arising from the use of any information or particulars in, or any incorrect use of the product.
Need help?
Do you have a question about the Milan and is the answer not in the manual?
Questions and answers