Tatlong device ang suportado — Mini PC (x86_64, ISO installer), Orange Pi One
(prebuilt image) at NodeMCU coin box (ESP8266 firmware). Nasa
Installers section ang mga files.
x86_64 · Debian 13
Mini PC setup
Bootable ISO na may awtomatikong Debian install at Pay-Fi na naka-install sa dulo. I-boot lang at hintayin — walang manual partitioning.
x86_64 (Intel/AMD)
4 GB RAM+
16 GB+ disk
USB 4 GB+
LAN + internet
⚠️ Buburahin ang unang disk ng mini PC — partisyon at lahat ng laman.
Huwag i-boot ang USB sa makinang may importanteng data. Kung 2+ ang disk, tatanungin ka
ng installer kung alin ang gagamitin.
Part 1 — Pag-flash sa USB
I-download ang ISOKunin ang payfi-debian-minipc-amd64.iso sa Installers. Kung may .sha256 file, pwede mong i-verify bago i-flash.
Ihanda ang USB flash drive4 GB pataas. Mabubura din ang laman ng USB, kaya gumamit ng walang importanteng file.
I-flash gamit ang Balena EtcherFlash from file → piliin ang .iso → Select target → ang USB → Flash! Hintayin ang “Flash Complete”.
O kaya Rufus (Windows)Piliin ang ISO → Start → kapag nagtanong, piliin ang DD mode (hindi ISO mode) para tama ang hybrid boot.
Kailangan ng internet sa install. Netinst ang Debian base, kaya i-connect ang LAN cable na may internet (DHCP) bago i-boot.
Part 2 — I-boot at mag-install
I-boot mula sa USBIsaksak ang USB sa mini PC at pindutin ang boot menu key — F12, F2 o Del depende sa board.
Piliin ang automatic installNasa Debian boot menu ang “Pay-Fi automatic install (ERASES the first disk)” — default na ito, hintayin ang 30s o pindutin ang Enter.
Hintayin ang ~15–30 minutoAwtomatik: language, disk, users, packages, GRUB, tapos ang Pay-Fi install sa dulo. Depende sa bilis ng internet at disk.
Tanggalin ang USBAwtomatikong mag-reboot. Tanggalin ang USB kapag nagsimula nang mag-boot mula sa internal disk.
Hanapin ang IP at buksan ang dashboardTingnan ang DHCP list ng router, tapos buksan ang http://<ip>:3000/admin sa browser.
Default credentials — palitan agad. Dashboard: admin / admin2234.
Debian console/SSH: root / payfi2025 (at user payfi / payfi2025).
Pagkatapos mag-login, palitan agad sa dashboard → Security, at sa Debian gamit ang passwd.
Part 3 — Setup sa dashboard
Network → RoutingI-assign ang roles: WAN = enp*/eth* na papunta sa modem, LAN/AP = pangalawang interface kung meron. I-on ang Auto WAN DHCP → Apply router setup.
PayMongoIlagay ang public at secret key para gumana ang online payment.
Pricing at VouchersI-set ang rates at gumawa ng voucher codes para sa customers.
Security → Captive portalI-on ang captive portal → Apply rules. Ito ang magre-redirect sa customers papunta sa payment page.
Fixed IP + bypassPara sa coin box o printer na hindi dapat hingan ng bayad: Network → Devices → Fixed/static IP → Fix + bypass.
Updates: System tab → Software update → Check for updates → Update now.
Hindi nabubura ang data.db, settings at admin password.
Prebuilt na image — flash lang sa microSD, boot, at bukas na ang dashboard. Walang SSH o manual install na kailangan.
Orange Pi One (H3)
microSD 8 GB+ (Class 10)
5V 2A PSU (barrel)
LAN cable
USB WiFi dongle*
⚠️ Hardware check: isang Ethernet port lang at walang onboard WiFi ang Orange Pi One.
Para makapag-serve ng customers, kailangan ng USB WiFi dongle na AP-capable
(RTL8188EU / RTL8192CU / MT7601U / RT5370) o USB Ethernet adapter. Kung wala, dashboard lang ang gagana.
Part 1 — Pag-flash sa microSD
I-download ang imageKunin ang payfi-orangepione-trixie-minimal.img.xz sa Installers. Huwag nang i-extract — direktang tinatanggap ng Etcher ang .img.xz.
Ihanda ang microSD8 GB pataas, Class 10 / A1. Mabubura ang laman, kaya i-backup muna kung may files.
I-flash gamit ang Balena EtcherFlash from file → piliin ang .img.xz → Select target → ang microSD → Flash! Mga 5–10 minuto.
I-cancel ang format promptKapag nag-“You need to format the disk” ang Windows pagkatapos mag-flash, i-click ang Cancel — normal lang iyon.
Ilagay sa boardSafe eject ang card, ilagay sa Orange Pi One, ikabit ang LAN cable, at saksakan ng 5V 2A sa barrel jack (huwag sa micro-USB/OTG).
Part 2 — First boot at dashboard
Hintayin ang unang bootMga 1–2 minuto. Awtomatikong nire-resize ang filesystem at may isang reboot.
Hanapin ang IPTingnan ang DHCP client list ng router. Sa console naman, ip -4 addr show.
Buksan ang dashboardDashboard: http://<ip>:3000/admin · Customer portal: http://<ip>:3000/
Default credentials — palitan agad. Dashboard: admin / admin2234.
Armbian console/SSH: root / payfi2025. Nasa
/opt/pay-fi/admin-initial-password.txt din ang dashboard password kung nakalimutan.
Part 3 — Setup sa dashboard
Network → RoutingWAN = eth0, AP = wlan0 kung may USB WiFi (o LAN = eth1 kung USB Ethernet). I-on ang Auto WAN DHCP → Apply router setup.
WiFi AP (kung may dongle)WiFi tab → ilagay ang SSID at password → Start Access Point.
PayMongo, Pricing at VouchersI-set ang payment keys, rates at voucher codes.
Security → Captive portalI-on at Apply rules para doon pumasok ang customers bago mag-internet.
Coin slot sa GPIO (optional)NodeMCU → Coin Slot → Connection mode = SBC GPIO (Orange Pi One) → piliin ang pulse pin/edge → Save. 3.3V lang ang GPIO — gumamit ng optocoupler kung 12V ang acceptor.
Updates: System tab → Software update → Update now, o sa CLI:
sudo bash /opt/pay-fi/scripts/update.sh. Hindi nabubura ang data.db at config.
Firmware ng coin acceptor — WiFi version. Ang board mismo ang nag-uulat ng barya sa server at sumusunod sa INHIBIT (bara) nito.
NodeMCU v2/v3 (ESP-12E)
USB data cable
CH340 / CP2102 driver
Arduino IDE
12V coin acceptor
PC817 optocoupler
⚠️ 12V ang pulse ng coin acceptor, 3.3V lang ang GPIO ng ESP8266.
Huwag ikabit nang diretso — gumamit ng optocoupler (PC817), 1kΩ sa LED side at
10kΩ pull-up papuntang 3.3V. Kailangan din ng common GND ng 12V supply at ng NodeMCU.
Wiring — kung WALANG custom board
Bare NodeMCU + breadboard o sariling wiring? Ito ang tamang connection. Kailangan ng
optocoupler para hindi masira ang 3.3V GPIO ng ESP8266.
PC817 pin
Ikabit sa
1 — anode
Coin acceptor COIN / pulse (kadalasan WHITE wire) — dumaan sa 1kΩ resistor
2 — cathode
GND ng coin acceptor (12V side)
4 — collector
NodeMCU D4 (GPIO2) + 10kΩ pull-up papuntang 3.3V
3 — emitter
GND (common ground)
I-power ang coin acceptor12V DC (hiwalay na PSU o shared). Ang COIN wire ang pulse output nito.
Ikabit ang optocouplerPin 1 sa pulse via 1kΩ · pin 2 sa GND ng acceptor · pin 4 sa D4 · pin 3 sa GND.
Lagyan ng pull-up ang D410kΩ resistor mula D4 papuntang 3.3V. (May internal pull-up ang firmware, pero mas stable ang external.)
I-common ang GNDIkonekta ang GND ng 12V supply sa GND ng NodeMCU. Kung hindi common, walang reference ang pulse at hindi mabibilang ang barya.
I-power ang NodeMCUSa USB o 5V → VIN. Huwag kailanman lagyan ng 12V ang 3.3V pin.
I-check kung D4 ang gumagalawSerial Monitor (115200) → i-type ang MON → maghulog ng barya. Kung D6 ang lumilipat, ikabit doon o i-set ang COIN_PIN2.
(Optional) Inhibit / bara sa baryaKung may ika-4 na wire (kadalasan GRAY) ang acceptor, ikabit ito sa D3 (GPIO0) via opto o transistor. Kung walang inhibit wire, hindi pisikal na bumabara ang barya — report lang ang gumagana.
Kung MAY custom board (eAzy MT & WS5 v2.0): may built-in optocoupler na, kaya huwag nang mag-PC817 —
ikabit lang ang acceptor sa COINSLOT (+ = 12V, WHITE = pulse, − = GND).
Default: coin sa D4 (GPIO2), inhibit sa D3 (GPIO0). Walang routing ang D2 sa board na ito.
Part 1 — Ihanda ang Arduino IDE
I-install ang Arduino IDE at driverI-download ang Arduino IDE 2.x at i-install. Kung hindi lumalabas ang port ng board, i-install ang CH340 o CP2102 driver para sa USB bridge nito.
Idagdag ang ESP8266 board URLFile → Preferences → Additional Boards Manager URLs at ilagay: https://arduino.esp8266.com/stable/package_esp8266com_index.json
I-install ang ESP8266 coreTools → Board → Boards Manager → hanapin ang esp8266 (ESP8266 Community) → Install.
Piliin ang board at portTools → Board → NodeMCU 1.0 (ESP-12E Module), Upload Speed115200, tapos piliin ang COM port ng board.
Part 2 — I-flash ang firmware
Buksan ang firmwareAng file ay nodemcu/coinbox-wifi/coinbox-wifi.ino sa Pay-Fi repo. Ito ang WiFi version — hindi na kailangan ng USB serial sa server.
Palitan ang DEVICE_ID kada boardcoinbox-1, coinbox-2, coinbox-3, … Kung pareho ang ID ng dalawang board, mag-o-overwrite ang counter nila sa isa't isa.
I-uploadPindutin ang Upload (→) at hintayin ang “Done uploading”. Kung naka-stuck sa “Connecting…”, pindutin at hawakan ang FLASH button ng board habang nag-u-upload.
Buksan ang Serial MonitorBaud: 115200. Itakda ang line ending sa Newline o Both NL & CR.
I-check ang boot logDapat may BOOT coinbox-wifi 1.0, MAC AA:BB:…, IP MODE dhcp, tapos STATUS … kada 5 segundo.
Part 3 — WiFi setup ng board
I-connect ang phone sa setup WiFiWiFi: CoinBox-Setup · password: coinbox123
Buksan ang setup pageKusang bubukas ito (auto-popup) pagka-connect ng phone dahil may captive portal ang firmware. Kung hindi bumukas, i-open ang http://192.168.4.1.
Ilagay ang settingsAP SSID at password ng box, pati server host/port/token → I-save at kumonekta. Naka-save ito sa EEPROM ng board.
I-check ang statusDapat CONNECTED at HTTP 200 para may heartbeat. Makikita rin dito ang IP (DHCP) at ang MAC ng board.
Case-sensitive ang SSID at kasama ang flag emoji sa dulo (hal. ShaiderBAM PisoWIFI).
Kung “SSID HINDI MAKITA”, i-type ang SCAN sa Serial Monitor para makita kung anong SSID ang talagang nakikita ng board.
Part 4 — Pairing sa dashboard
Itugma ang Connection modeAdmin → NodeMCU → Coin Slot → piliin ang WiFi / network HTTP. Dapat tugma sa na-flash na firmware — kung hindi, tahimik na walang mabibilang.
I-test ang coin slotMaghulog ng barya. Dapat tumaas ang counter at may POST /api/hardware/coins na nagre-return ng 200.
I-reserve at i-bypass sa adminAdmin → Network → Fixed / static IP devices → ilagay ang IP (kahit anong libre sa subnet) at ang MAC ng board (nasa Serial Monitor o setup dashboard), tapos Add device → Save & apply rules. Naka-bypass na ito — hindi sisingilin ng captive portal at laging pareho ang IP.
Buong flow: i-flash ang firmware → i-connect ang phone sa CoinBox-Setup
(auto-popup ang setup page) → i-save ang WiFi + server settings → i-add ang MAC sa
Admin → Network → Fixed / static IP devices para naka-bypass at reserved ang IP →
maghulog ng barya para i-test.
Diagnostics sa Serial Monitor:MON (hanapin kung D4 o D6 ang gumagalaw kapag may barya),
SETPIN D3|D8, POLARITY NORMAL|INVERTED, SWEEP, at CLEAR (bura ng EEPROM).