4.15 WFS_CMD_CDM_CALIBRATE_CASH_UNIT

Description This command is used to initialize the reference value of a cash unit. It will action a vendor dependent sequence of hardware events which will calibrate the physical cash unit. This is necessary if a new type of bank note is put into the cash unit. By this command the cash unit gets the new measures of the bank notes.

If more than one physical cash unit is related to the logical cash unit, it is up to the Service Provider to select the appropriate actions. Whether, all the physical cash units have to be calibrated or if it is sufficient to do the calibration for one physical unit and load the data into the others.

Input Param LPWFSCDMCALIBRATE lpCalibrateIn;

typedef struct _wfs_cdm_calibrate
{
USHORT usNumber;
USHORT usNumOfBills;
} WFSCDMCALIBRATE, * LPWFSCDMCALIBRATE;

usNumber
Logical number of cash unit.

usNumOfBills
Number of bills to be dispensed during the process of measuring.

Output Param LPWFSCDMCALIBRATE lpCalibrateOut;

For a description of the WFSCDMCALIBRATE structure, see the definition of the Input Param.

usNumber
Logical number of cash unit.

usNumOfBills
Number of bills that were dispensed during the process of measuring. It can differ from the value in the input structure, if the cash dispenser always dispenses a default number of bills.

Error Codes The following additional error code can be generated by this command:

Value Meaning

WFS_ERR_CDM_EXCHANGEACTIVE The CDM service is in an exchange state (see WFS_CMD_CDM_START_EXCHANGE).

WFS_ERR_CDM_CASHUNITERROR The specified cash unit caused an error.

Events The following additional events can be generated by this command:

Value Meaning

WFS_SRVE_CDM_CASHUNITINFOCHANGED A cash unit was changed.

Comments None.