Configuration
Set RS232 Interface Baudrate (MDB USB Plus & MDB USB Ultra versions only)
By default, the MDB-USB will communicate through the USB interface and ignore the serial port.
To communicate through the RS232 interface, it is necessary to first configure a baudrate for the serial port via USB. Note that you will need to unplug USB ( you can provide power, but no USB host must be connected) for the device to use the serial port.
F,SERIAL,<baudrate>
Answer:
- f,ACK
Description:
- Sets the serial port (RS232) Baudrate. Default (0) means serial port disabled.
This configuration is stored in nonvolatile memory and, therefore, it is not needed to set this configuration at each boot.
The serial port uses the exact same command set which is used on the USB port.
When the device boots, it first tries to detect a USB host. Only if NO USB host is available AND a serial baudrate is configured the device will switch to the RS-232 host interface.
Set the response timeout (milliseconds)
F,RESPTIMEOUT,<timeout>
Answer:
- f,ACK
Description:
- While in master mode, the MDB interface, will wait this amount of time, before it assumes the peripheral does not answer the POLLS and therefore, is disconnected. This value, by standard, will be 5ms, but many "modern" Peripherals are much slower. The timeout value can be configured in a range from 10 to 1000.
- If you have problems with a peripheral, try to set the value to 1000.
Set Cashless Slave Parameter
Many "modern" peripherals do not answer within the default answer time (first character must be send within 5ms). If you have trouble with a device, adjust the timeout with the F,RESPTIMEOUT, command documented above.
To perform configurations on the cashless peripheral, it is necessary to disable the cashless peripheral first. That can be done by issuing the following command below.
C,0
Once the Cashless Slave is disabled, configurations can be modified by parameter changes. That can be done by the following command:
C,SETCONF,<parameter>=<value>
Answer:
- c,SET,OK
Description:
- Assigns value to parameter . The list of possible parameters is presented in the table below. To confirm the respective possible values, please check MDB specification.
These parameters must be set every time that the interface is powered on.
Parameter | Value | Description | Example | Default |
---|---|---|---|---|
mdb-always-idle | 0 or 1 | When enabled, the Cashless Device supports Always Idle(Selection First) operation. Note: even when enabled, if the machine does not support this mode, it may still choose not to use it, using Idle Mode (Authorization First) instead. | C,SETCONF,mdb-always-idle=0 | 1 (Enabled) |
mdb-currency-code | 0x1<ISO 4217 numeric currency code> | Set cashless currency code (see appendix A of the MDB specification ) in brief: 1840 is USD, 1978 is Euro, 1756 is CHF, 1826 is GBP | C,SETCONF,mdb-currency-code=0x1840 | Swiss Francs |
mdb-ftl-enabled | 0 or 1 | Makes the Cashless Peripheral announce FTL Capability to the VMC | C,SETCONF,mdb-ftl-enabled=1 | 0 |
mdb-address | 0x10 or 0x60 | Cashless device address | C,SETCONF,mdb-address=0x60 | 0x10 |
mdb-decimal-places | 0 to 3 | Set number of decimal digits (increase precision and decrease maximum limit) | C,SETCONF,mdb-decimal-places=0 | 2 |
mdb-scale-factor | 1 to 100 | Multiplier to increase/decrease maximum value allowed for transactions (used in undervalue currency) | C,SETCONF,mdb-scale-factor=2 | 1 |
mdb-timeout | 1 to 10000000000 | MDB message timeout (seconds) | C,SETCONF,mdb-timeout=3 | 5 |
mdb-timeout-idle | 0 to 10000000000 | Idle session timeout (seconds) | C,SETCONF,mdb-timeout-idle=10 | 0 (no timeout) |
mdb-timeout-vend | 0 to 10000000000 | Vend confirm timeout (seconds) | C,SETCONF,mdb-timeout-vend=1 | 0 (no timeout) |
mdb-cashsale-enabled | 0 or 1 | Indicate to the VMC that it should inform the cashless implementation about Cash sales | C,SETCONF,mdb-cashsale-enabled=1 | 0 (disabled) |
mdb-restore-funds | 0 or 1 | Tells the VMC that the Cashless Device is able to restore funds to the Cards or not. | C,SETCONF,mdb-restore-funds=1 | 0(disabled) |
mdb-display-time | Positive Integer | Allows configuration of the time which the messages displayed with the Display Request command will be presented in the VMC screen. | C,SETCONF,mdb-display-time=100 | 10 |
Set Cashless Master Parameter
D,SETCONF,<parameter>=<value>
Answer:
- d,SET,OK
Description:
- Assigns value to parameter. The list of possible parameters is presented in the table below. To confirm the respective possible values, please check MDB specification.
These parameters must be set every time that the interface is powered on.
Parameter | Value | Description | Example | Default |
---|---|---|---|---|
vmc-slave-address | 0x10 or 0x60 | Sets the adress of the cashless device | D,SETCONF,vmc-slave-address=0x60 | 0x10 |
vmc-feature-level | 2 or 3 | set the feature level of the VMC | D,SETCONF,vmc-feature-level=2 | 3 |
vmc-min-price | 0x0000 to 0xFFFF | Sets the minimum price of the VMC | D,SETCONF,vmc-min-price=0x0010 | 0x0000 |
vmc-max-price | 0x0000 to 0xFFFF | Sets the maximum price of the VMC | D,SETCONF,vmc-max-price=0xF000 | 0xFFFF |
vmc-display-columns | 0 to 255 | Tells the reader how many columns on the VMC's display. | D,SETCONF,vmc-display-columns=10 | |
vmc-display-rows | 0 to 255 | Tells the reader how many rows on the VMC's display. | D,SETCONF,vmc-display-rows=2 |