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.

Set Interface Baudrate
Copy

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)

Set the response timeout (milliseconds)
Copy

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.

Disable Cashless Slave Mode
Copy

Once the Cashless Slave is disabled, configurations can be modified by parameter changes. That can be done by the following command:

Set Cashless Slave Parameter
Copy

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.

ParameterValueDescriptionExampleDefault
mdb-always-idle0 or 1When 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=01 (Enabled)
mdb-currency-code0x1<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 GBPC,SETCONF,mdb-currency-code=0x1840Swiss Francs
mdb-ftl-enabled0 or 1Makes the Cashless Peripheral announce FTL Capability to the VMCC,SETCONF,mdb-ftl-enabled=10
mdb-address0x10 or 0x60Cashless device addressC,SETCONF,mdb-address=0x600x10
mdb-decimal-places0 to 3Set number of decimal digits (increase precision and decrease maximum limit)C,SETCONF,mdb-decimal-places=02
mdb-scale-factor1 to 100Multiplier to increase/decrease maximum value allowed for transactions (used in undervalue currency)C,SETCONF,mdb-scale-factor=21
mdb-timeout1 to 10000000000MDB message timeout (seconds)C,SETCONF,mdb-timeout=35
mdb-timeout-idle0 to 10000000000Idle session timeout (seconds)C,SETCONF,mdb-timeout-idle=100 (no timeout)
mdb-timeout-vend0 to 10000000000Vend confirm timeout (seconds)C,SETCONF,mdb-timeout-vend=10 (no timeout)
mdb-cashsale-enabled0 or 1Indicate to the VMC that it should inform the cashless implementation about Cash salesC,SETCONF,mdb-cashsale-enabled=10 (disabled)
mdb-restore-funds0 or 1Tells the VMC that the Cashless Device is able to restore funds to the Cards or not.C,SETCONF,mdb-restore-funds=10(disabled)
mdb-display-timePositive IntegerAllows 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=10010

Set Cashless Master Parameter

Set Cashless Master Parameter
Copy

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.

ParameterValueDescriptionExampleDefault
vmc-slave-address0x10 or 0x60Sets the adress of the cashless deviceD,SETCONF,vmc-slave-address=0x600x10
vmc-feature-level2 or 3set the feature level of the VMCD,SETCONF,vmc-feature-level=23
vmc-min-price0x0000 to 0xFFFFSets the minimum price of the VMCD,SETCONF,vmc-min-price=0x00100x0000
vmc-max-price0x0000 to 0xFFFFSets the maximum price of the VMCD,SETCONF,vmc-max-price=0xF0000xFFFF
vmc-display-columns0 to 255Tells the reader how many columns on the VMC's display.D,SETCONF,vmc-display-columns=10
vmc-display-rows0 to 255Tells the reader how many rows on the VMC's display.D,SETCONF,vmc-display-rows=2
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard