> For the complete documentation index, see [llms.txt](https://help.smvend.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smvend.io/equipment-installation/coffee-machines/mdb.md).

# MDB

**Attention!** All equipment must be connected with the power turned off. Connecting devices while the system is powered can result in damage that is not covered under warranty.

**MDB (Multi-Drop Bus)** is a standardized communication protocol used in vending machines. It acts as a common language that allows different components — such as coin validators, bill acceptors, cashless payment systems, and product dispensers — to communicate with each other.&#x20;

## Installation

{% tabs %}
{% tab title="Coffee Mini" %}
Below is a scheme for connecting the SmVend Coffee Mini controller to a vending machine via MDB.

<figure><img src="https://3872119397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnrXt79Zqh1vochrJxgjb%2Fuploads%2FI5hCEPqcdJCv44ByZ7Ie%2Fimage.png?alt=media&amp;token=255d3a64-d7e7-49e2-9cdd-ccd53a5f8eee" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Smart Connector" %}
Below is the cable and video guide for connecting the SmVend Smart Connector controller to a vending machine via MDB.

<figure><img src="https://3872119397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnrXt79Zqh1vochrJxgjb%2Fuploads%2F3ML4gf8hzxmQBa2zYhgY%2Fimage.png?alt=media&amp;token=c1a0f181-b453-48bb-960c-51c7dbf282dc" alt=""><figcaption></figcaption></figure>

{% embed url="<https://drive.google.com/file/d/1dOYUtWw-rSPwrXT01Qq9cZQFZgi-XQI6/view?usp=sharing>" %}
{% endtab %}
{% endtabs %}

## FAQ MDB

Here you’ll find answers to the most frequently asked questions about connecting MDB vending machines.

<details>

<summary>How can I check if the controller is working?</summary>

Connect the controller to the vending machine and check the LED indicator responsible for MDB data exchange. If the LED is on or blinking, communication has been established and you can proceed with the next steps in the setup.

If the LED is off, check the following:

* Whether the cables between the controller and the vending machine are connected correctly
* Whether the MDB protocol and the Cashless Device option are enabled in the machine’s settings

| Smart Connector                                                                                                                                                                                                                                                                           | Coffee Mini                                                                                                                                                                                                                                                                               |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div><figure><img src="https://3872119397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnrXt79Zqh1vochrJxgjb%2Fuploads%2FzM7yxJXkvSTVSQD5jMT8%2Fimage.png?alt=media&amp;token=aeed13f6-ad66-423f-904b-2380f9703d4d" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://3872119397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnrXt79Zqh1vochrJxgjb%2Fuploads%2FZw2qzd8003fErDp7zEK6%2Fimage.png?alt=media&amp;token=1fcd6ace-8a45-4e5c-8a50-f5b2cf059a3a" alt=""><figcaption></figcaption></figure></div> |

</details>

<details>

<summary>Events show «Zero item, change the PLU number to 1» — what should I do?</summary>

To fix the “zero product” error, go to the <kbd>Configuration</kbd> page for the relevant machine in your [SmVend personal account](https://app.smvend.io/).

In the <kbd>MDB</kbd> section, enable the option <kbd>Shift PLU to PLU+1</kbd>, then click <kbd>Save</kbd> at the bottom of the page.

<figure><img src="https://3872119397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnrXt79Zqh1vochrJxgjb%2Fuploads%2FWi1WXdngw2TcDst4CYdU%2Fimage.png?alt=media&amp;token=a7d9a5af-b2b6-43f5-89f0-79b4c2f399de" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>How to configure a controller after installation?</summary>

### 1. Pre-authorization (Recommended)

The lightest and most universally compatible setup.&#x20;

| Smart Connector with mdb\_019 firmware                                                                                                                                                                                                                                                    | Coffee Mini |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| <div><figure><img src="https://3872119397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnrXt79Zqh1vochrJxgjb%2Fuploads%2FkuUry4aPqJzFVv3u6gGl%2Fimage.png?alt=media&amp;token=7c3140dc-81b3-4e94-a0fc-91a4ec63f7d0" alt=""><figcaption></figcaption></figure></div> |             |

{% hint style="info" %}
If your vending machine does not support Cash Sale but does have a coin acceptor, some transactions may appear merged — combining card and coin data.
{% endhint %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcTftvZwoEj5i7s7ukfGKux4QALEQ--7QZq-DUFriRRjqTIQPQRt59q19LNbQr3BQskGJpPwZXecqERvBZiDH09kRvfJiHD5YoGoGLWjGgTTMIs2kEy0VoL5-DlPbQOpxn2x8rxHw?key=4ZAJ2HLy0Ei0IICzAMlT-sDn" alt=""><figcaption></figcaption></figure>

### 2. Pseudo Always Idle

If your vending machine doesn’t support Cash Sale, or requires the product selection before payment workflow, use the following configuration.

| Smart Connector with mdb\_020 firmware                                                                                                                                                                                                                                                    | Coffee Mini                                                                                                                                                                                                                                                                               |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div><figure><img src="https://3872119397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnrXt79Zqh1vochrJxgjb%2Fuploads%2FC5BPTrDJkjAMkLcuZKnu%2Fimage.png?alt=media&amp;token=fb36c37d-9ade-49a7-9b43-b904de7ff2ef" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://3872119397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnrXt79Zqh1vochrJxgjb%2Fuploads%2FUCjKwwri0YIgvP7eJoh5%2Fimage.png?alt=media&amp;token=33918efb-63d6-4e5d-b2b8-b8721b28b941" alt=""><figcaption></figcaption></figure></div> |

{% hint style="info" %}
You may need to adjust the <kbd>Deposit displayed on the machine</kbd> parameter.
{% endhint %}

</details>

<details>

<summary>What is Always Idle mode?</summary>

Always Idle mode allows the customer to select a product first, then see its price displayed on the terminal before completing the payment.

</details>

<details>

<summary>How to check if my machine supports Always Idle with the Smart Connector controller? </summary>

To determine whether your vending machine supports Always Idle mode, we added a self-detecting <kbd>Default</kbd> mode.

### If you are using the Smart Connector controller

#### Steps to check Always Idle:

1. On the <kbd>Configuration</kbd> page of the machine in [your SmVend personal account](https://app.smvend.io/), set the <kbd>Cashless flag</kbd> parameter to <kbd>Default</kbd>
2. Reboot the vending machine.
3. Test whether the machine processes payments correctly:

* If payments are processed without errors, the machine supports Always Idle mode and the configuration is correct.
* If payment errors occur, the machine does not support Always Idle. In this case, switch the POS terminal to <kbd>Pre-authorization</kbd> mode.

| With Always Idle                                                                                                                                                                                                                                                                          | Without Always Idle                                                                                                                                                                                                                                                                       |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div><figure><img src="https://3872119397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnrXt79Zqh1vochrJxgjb%2Fuploads%2FUYXNLF1LjFd1RX6qK7EU%2Fimage.png?alt=media&amp;token=b60fe7c1-7343-4132-bf9e-6b06da9c657f" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://3872119397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnrXt79Zqh1vochrJxgjb%2Fuploads%2FNWplVa1c2t0TgOEJuYBw%2Fimage.png?alt=media&amp;token=36fa0d26-9545-4fb6-a583-c37eb2b0b2d8" alt=""><figcaption></figcaption></figure></div> |

### If you are using the Coffee Mini controller

#### Steps to check Always Idle:

1. On the <kbd>Configuration</kbd> page of the machine in [your SmVend personal account](https://app.smvend.io/), set the <kbd>Cashless flag</kbd> parameter to <kbd>Default</kbd>
2. Reboot the vending machine.
3. On the <kbd>Debug</kbd> page find the <kbd>ia</kbd> tag in the first message:

* If the tag value is <kbd>0</kbd>, enable the <kbd>Pre-authorization</kbd> switch.
* If the tag value is <kbd>1</kbd>, disable the <kbd>Pre-authorization</kbd> switch.

<figure><img src="https://3872119397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnrXt79Zqh1vochrJxgjb%2Fuploads%2FTlgVJoxqAI9vtppQ1riM%2Fimage.png?alt=media&amp;token=777cb4ef-11b1-41c6-98e7-a497d1b6507b" alt=""><figcaption></figcaption></figure>

| ia=0                                                                                                                                                                                                                                                                                      | ia=1                                                                                                                                                                                                                                                                                      |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div><figure><img src="https://3872119397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnrXt79Zqh1vochrJxgjb%2Fuploads%2F6jsXipui15KH4nNf2w9G%2Fimage.png?alt=media&amp;token=ae7fb5db-92d5-4e27-a6cf-cc1a5dfd59d6" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://3872119397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnrXt79Zqh1vochrJxgjb%2Fuploads%2FQDEZdnCdfZwM1RdXIk9R%2Fimage.png?alt=media&amp;token=ffcf92a1-6480-4d81-b72b-6d81c2299ddd" alt=""><figcaption></figcaption></figure></div> |

</details>

<details>

<summary>Режим предавторизации POS-терминала </summary>

If the vending machine supports Always Idle, both of the following modes are available:

* Pre-authorization mode, where the amount is first blocked on the card, and then the product is selected.
* Post-selection mode, where the product is selected first, and then the corresponding amount is displayed on the POS terminal.

If the machine does not support Always Idle, only one of the following modes will be available:

* Pre-authorization mode, where the amount is first blocked on the card, and then the product is selected.
* Post-selection mode, where the product is selected first, and then the corresponding amount is displayed on the POS terminal.

To activate the post-selection mode on machines that do not support Always Idle, set the Cashless flag to Pseudo Always Idle.

However, note that in this case, the coin and bill acceptors will be disabled, since proper price display before product selection requires full support for Always Idle mode.

</details>

<details>

<summary>Режим Master Mode</summary>

</details>

<details>

<summary>Решение проблемы с cash sale </summary>

</details>

> If you have any questions, feel free to contact our support team at **<support@smvend.io>**, via the chat in the bottom-right corner of the app, or WhatsApp at **+371 28 701 129**.
