https://github.com/nodestark/mdb-esp32-cashless
ESP32-based MDB cashless device for vending machines, supporting EVA DTS DEX/DDCMP telemetry and payments over the MDB protocol via Bluetooth and MQTT
https://github.com/nodestark/mdb-esp32-cashless
esp32 iot nuttx protocol-mdb vending-machine
Last synced: 3 days ago
JSON representation
ESP32-based MDB cashless device for vending machines, supporting EVA DTS DEX/DDCMP telemetry and payments over the MDB protocol via Bluetooth and MQTT
- Host: GitHub
- URL: https://github.com/nodestark/mdb-esp32-cashless
- Owner: nodestark
- License: mit
- Created: 2024-05-10T18:07:56.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2026-05-30T15:26:10.000Z (9 days ago)
- Last Synced: 2026-05-30T17:12:58.465Z (9 days ago)
- Topics: esp32, iot, nuttx, protocol-mdb, vending-machine
- Language: Vue
- Homepage: https://vmflow.xyz
- Size: 83.9 MB
- Stars: 136
- Watchers: 16
- Forks: 45
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](pcbway-award-2026.jpg)
[](https://vmflow.xyz/dashboard)
[](https://discord.gg/YgnusQaDHM)
[](LICENSE)
[](https://docs.espressif.com/projects/esp-idf/en/v5.5.1/)
# VMflow — Open-Source Vending Machine IoT Platform
**The first open-source vending platform designed for AI agents.**
---
The project aims to provide a modern, open, and extensible platform for vending machine connectivity. Based on the ESP32 platform, it enables machines to communicate via Bluetooth and cloud services, receive remote credits, report telemetry, and integrate with mobile applications and web dashboards.
# 🤖 Manage It With Your AI Agent
VMflow is built to be driven by AI agents. Paste this into your agent and it picks up the whole project — MQTT RPC control, the device commands, and the Supabase data API:
```
read https://raw.githubusercontent.com/nodestark/mdb-esp32-cashless/main/AGENTS.md
```
# Features
- ESP32-based vending machine controller implementing MDB telemetry, cashless payments, and IoT connectivity;
- PCB design done in **KiCad**, facilitating production and customization of the hardware;
- Support for **EVA DTS DEX/DDCMP** (European Vending Association Data Transfer Standard), allowing remote monitoring and control of machines;
- **Web Dashboard**: [📊 Open Dashboard](https://vmflow.xyz/dashboard) – Centralized interface to monitor the vending machine network in real time, including device status, telemetry, sales data, inventory control, product catalog management, and real-time stock alerts. Features AI-powered diagnostics (via OpenAI) for operation-wide analysis, per-machine insights, and product catalog recommendations;
- **PAX Counter**: detects nearby mobile devices and periodically reports anonymized presence metrics to estimate foot traffic around the vending machine. This enables heatmaps, peak-hour analysis, and location performance insights;
# Getting Started
### 1. Flash the Firmware
👉 Install firmware via Web Installer (no setup required): **https://install.vmflow.xyz**
👉 Advanced (for development): ESP-IDF
```bash
# Clone the repository (with submodules — pulls in the VMC project)
git clone --recurse-submodules https://github.com/nodestark/mdb-esp32-cashless
cd mdb-esp32-cashless/mdb-slave-esp32s3
idf.py flash monitor
```
### 2. Register and Configure the Device — VMflow [Android App](./android)
Use the **VMflow Android app** to register the board and link it to your operator account. The app allows you to:
- **Device Registration**: register telemetry boards and bind them to your operator account
- **Wi-Fi Configuration**: remotely configure the Wi-Fi network of your devices via Bluetooth
- **Send Credits**: interact with devices in real time via Bluetooth and MQTT
[](https://play.google.com/store/apps/details?id=xyz.vmflow.target)
## Hardware
[](https://www.pcbway.com/project/member/?bmbno=1B3B95CB-4E28-4D)
---
[](https://supabase.com)
### 1️⃣ Get a Bearer Token
```bash
curl -X POST 'https://supabase.vmflow.xyz/auth/v1/token?grant_type=password' \
-H "apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoiYW5vbiIsImlzcyI6InN1cGFiYXNlLWRlbW8iLCJpYXQiOjE2NDE3NjkyMDAsImV4cCI6MTc5OTUzNTYwMH0.VGEEIztVo-do9cy_Qw2-2sF8bSONckhX71Nvtwj15X4" \
-H "Content-Type: application/json" \
-d '{ "email": "your_email@domain.xyz", "password": "your_password"}'
```
### 2️⃣ Send Credit to the Machine over MQTT
```bash
curl -X POST 'https://supabase.vmflow.xyz/functions/v1/send-credit' \
-H "apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoiYW5vbiIsImlzcyI6InN1cGFiYXNlLWRlbW8iLCJpYXQiOjE2NDE3NjkyMDAsImV4cCI6MTc5OTUzNTYwMH0.VGEEIztVo-do9cy_Qw2-2sF8bSONckhX71Nvtwj15X4" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "subdomain":51,"amount":1.50 }'
```
### 3️⃣ View Sales
```bash
curl -X GET 'https://supabase.vmflow.xyz/rest/v1/sales' \
-H "apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoiYW5vbiIsImlzcyI6InN1cGFiYXNlLWRlbW8iLCJpYXQiOjE2NDE3NjkyMDAsImV4cCI6MTc5OTUzNTYwMH0.VGEEIztVo-do9cy_Qw2-2sF8bSONckhX71Nvtwj15X4" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```
### 4️⃣ View Devices
```bash
curl -X GET 'https://supabase.vmflow.xyz/rest/v1/embedded' \
-H "apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoiYW5vbiIsImlzcyI6InN1cGFiYXNlLWRlbW8iLCJpYXQiOjE2NDE3NjkyMDAsImV4cCI6MTc5OTUzNTYwMH0.VGEEIztVo-do9cy_Qw2-2sF8bSONckhX71Nvtwj15X4" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```
### 5️⃣ View Paxcounter
```bash
curl -X GET 'https://supabase.vmflow.xyz/rest/v1/metrics?name=eq.paxcounter' \
-H "apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoiYW5vbiIsImlzcyI6InN1cGFiYXNlLWRlbW8iLCJpYXQiOjE2NDE3NjkyMDAsImV4cCI6MTc5OTUzNTYwMH0.VGEEIztVo-do9cy_Qw2-2sF8bSONckhX71Nvtwj15X4" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```
# How to Contribute:
- Contributions are welcome! Feel free to open issues, send pull requests, or propose new features
- Before submitting a pull request, make sure the code complies with the style and quality guidelines defined in the project
- Help us improve documentation by adding usage examples, installation instructions, and any other relevant information
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.