Configuration

Set RS232 Interface Baudrate (MDB USB Plus & MDB USB Ultra versions only)

Info

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.

Info

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.

Info

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

Warning

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.

Info

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.

Info

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.

Info

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