vender

module

v0.211016.0 Latest Latest Go to latest Published: Oct 16, 2021 License: CC0-1.0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/AlexTransit/vender

Links

Open Source Insights

README ¶

What

Vender is free open source VMC (Vending Machine Controller). (fork https://github.com/temoto/vender)

Status:

MDB adapter hardware module - works
VMC - in development
Configuration editor - planned

Hardware

Required for VMC:

Works on RaspberryPI and OrangePi Lite (H3). Possibly anything with GPIO that runs Go/Linux.
MDB signal level inverter and current limiter - required, see files in hardware/schematic
MDB adapter, takes care of 9bit and timing, we use ATMega328p with hardware/mega-firmware It is not mandatory, software option is available: https://github.com/temoto/iodin

Supported peripherals:

MDB coin acceptor, bill validator
Evend MDB drink devices
any MDB device via configuration scenarios (work in progress)
MT16S2R HD44780-like text display
TWI(I2C) numpad keyboard
SSD1306-compatible graphic display (planned)

Design

VMC overall structure:

engine (see internal/engine packages) executes actions, handles concurrency and errors
device/feature drivers provide actions to engine
configuration scenario specifies action groups and when to execute them

Build

Install Go 1.15 from https://golang.org/dl/
Set target environment, default is GOARCH=arm GOOS=linux
Run script/build
Deploy file build/vender to your hardware

Supported Go versions: 1.13 and 1.15

Vender compiled with Go 1.13 was successfully running in production until release v0.200630.0. Go 1.14 introduced async preemtible runtime by interrupting syscalls. Go 1.15 os and net packages automatically retry on EINTR.

Directories ¶

Path	Synopsis
cmd
mega-cli command
vender command
vender/engine
vender/mdb
vender/subcmd Support sub-commands in vender application.	Support sub-commands in vender application.
vender/tele
vender/ui Helper for developing vender user interfaces	Helper for developing vender user interfaces
vender/vmc Main, user facing mode of operation.	Main, user facing mode of operation.
crc
currency
hardware
display
display/framebuffer
hd44780
input Abstract input events	Abstract input events
mdb
mdb/bill Package bill incapsulates work with bill validators.	Package bill incapsulates work with bill validators.
mdb/client
mdb/coin
mdb/config Separate package to for hardware/mdb related config structure.	Separate package to for hardware/mdb related config structure.
mdb/evend Package evend incapsulates common parts of MDB protocol for eVend machine devices like conveyor, hopper, cup dispenser, elevator, etc.	Package evend incapsulates common parts of MDB protocol for eVend machine devices like conveyor, hopper, cup dispenser, elevator, etc.
mdb/evend/config Separate package to for hardware/evend related config structure.	Separate package to for hardware/evend related config structure.
mega-client
money
text_display
helpers
atomic_float
cacheval Atomic value with validity timeout.	Atomic value with validity timeout.
cli
internal
engine Engine tasks: - let drivers register actions - parse scenario .dot files - execute scenarios	Engine tasks: - let drivers register actions - parse scenario .dot files - execute scenarios
engine/config
engine/inventory
money Package money provides high-level interaction with money devices.	Package money provides high-level interaction with money devices.
state
state/new Sorry, workaround to import cycles.	Sorry, workaround to import cycles.
state/persist
tele
types
ui
ui/config
log2 Package log2 solves these issues: - log level filtering, e.g.	Package log2 solves these issues: - log level filtering, e.g.
tele Package tele is vender telemetry network/binary API for external usage.	Package tele is vender telemetry network/binary API for external usage.
config Telemetry client config, vending machine side.	Telemetry client config, vending machine side.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL