Coin-operated hotspot software for single-board computers.
Issue licence keys, bind them to hardware, group units into fleets, and manage every machine
from one console.
Orange Pi 1Orange Pi PCOrange Pi Zero 3Raspberry Pi 3Raspberry Pi 4
GWIFI
SOFTWARE SOLUTION
OPI 1
OPI PC
OPI Zero 3
RPI 3
RPI 4
Ultra-fast bootOnline in seconds
SD card protectionSurvives power cuts
Remote monitoringNo VPN needed
Fleet consoleOne login, every unit
READY TO SECURE YOUR VENDO?g-coinvendo.com
WHAT YOU GET
Eight things this software does
BAKIT G-PISOTAB
Sawa ka na ba sa system na may expiry at sobrang tagal ng support?
Huwag mong sayangin ang oras, pera at pagod mo sa kiosk software na nagbibigay lang ng sakit sa
ulo tuwing may biglang error. Bakit ka magtitiis sa system na may expiry date, may palihim na
recurring renewal fees, at inaabot ng ilang araw ang tech support bago mag-reply?
Oras na para lumipat sa G-PisoTab — ang maasahan, mabilis at builder-friendly na system
para sa mga DIY builders. Hindi ka na mastuck, maiiwan o malulugi sa pisotab assembly at custom
vending box business mo dahil sa mabagal na technical response.
Para sa orders, immediate licence activation at bulk inquiries.
HOW IT FITS TOGETHER
One console, many machines
●
Each unit stands alone
A machine keeps taking coins and serving customers whether or not this console is reachable. Entitlements are signed and verified offline, with a grace period on top.
🔑
One key, one machine
A licence binds to the board's hardware ID on first activation. A second board presenting the same key is refused, not quietly shared.
↻
Recover after a reinstall
Reinstalling the daemon or resetting config needs no key — the hardware ID is the credential. A re-imaged card is new hardware and needs unbinding first.
⚡
Revoking frees the key immediately
Revoke stops the licence and clears its hardware binding in the same click, so it's ready to activate on a different board right away. The unit it was running on still gets its clean, signed stop on its next check-in — the server remembers exactly which hardware was revoked, even after the key has moved on, so a fast cutoff and freeing the key for reuse are never a tradeoff against each other.
About
G-WIFI turns a single-board computer into a coin-operated hotspot: coin
acceptor on GPIO, captive portal, session engine, admin panel and sales reporting, all in one
Go daemon with no external services to keep alive.
Runs on Orange Pi 1, Orange Pi PC, Orange Pi Zero 3, Raspberry Pi 3 and
Raspberry Pi 4. Each unit works entirely on its own — this console is for managing many of
them, not for keeping any one of them running.
Features
What is actually shipping today. Anything still in progress says so.
Downloads
The system image, built from source with build-image.sh.
Only the current build is kept here — publishing a new one replaces it.
Each .img.xz flashes straight to an SD card with
balena Etcher
— Etcher decompresses on the fly, so there is no separate unzip step.
Tutorial
Everything from a blank SD card to a working, coin-taking hotspot. Roughly 20-30
minutes the first time, faster once you've built a few.
WHAT YOU NEED
A supported boardOrange Pi 1, Orange Pi PC, Orange Pi Zero 3, Raspberry Pi 3, or Raspberry Pi 4
MicroSD card8GB or larger. Class 10 / A1 recommended — it takes constant writes
Power supplyRated for your board — an underpowered supply causes random reboots, not a clean failure
Coin acceptorPulse-output type, wired to an enable relay/driver stage
A WiFi access pointFor customers to connect to — the board itself does the portal, licensing and coin logic, not the radio
balena EtcherFree, from etcher.balena.io, on any Windows/Mac/Linux PC
STEP BY STEP
1
Download the image
Grab the .img.xz for your board from the
Downloads page.
2
Flash the card
Open balena Etcher, point it straight at the .img.xz file — Etcher
decompresses it on the fly, so there's no separate unzip step. Select your SD card and flash.
Flashing erases everything already on the card. Double-check you've picked the
right drive before confirming.
3
Wire the coin acceptor
Physical pin 3 is the coin input, physical pin 5 is the acceptor-enable output. Pin 5 stays
inactive until the software has fully started — that's deliberate, it's the boot-complete
signal, so the coin slot can never go live before the unit is actually ready to accept payment.
If the enable relay behaves backwards once it's running (energized when it should be off, or
the reverse), don't rewire anything — flip the Active High / Active Low toggle in the admin
panel's Network & GPIO settings instead.
4
First boot
Insert the card, connect the board's client-side port to your WiFi access point, and power on.
Boot takes a few seconds.
If you can't reach the unit yet — first-time setup, or something looks wrong — plug a laptop
directly into the board with a cable. It always holds a rescue address
(169.254.77.1) that Windows, macOS and Linux all find automatically
with zero network configuration on your end.
5
Log in and set a real password
Open the admin panel at the unit's address (shown on the console banner on first boot).
Change the default password immediately — this is the account that controls rates, the coin
slot, and your licence.
6
Choose your connection type
In Network settings, set how this unit reaches the internet: DHCP, PPPoE, a static IP, or a
SIM-based 4G/LTE modem. Pick whichever matches what's actually available on site — this is a
one-time setting, not something you need to rebuild the image for.
7
Activate your licence
Enter your licence key under System → License. It binds to this unit's hardware ID on
first activation — reinstalling the software later doesn't need a new key, only a different
board would.
8
Set your rates, vouchers, and any free-time promo
Rates — how much time a coin buys
Vouchers — issue prepaid codes with their own value and speed
Free Time — optional promo run with a start/end date and a per-device limit, useful
for a soft launch
9
Go live
Connect a phone to the WiFi, confirm the captive sign-in page opens by itself (Android, iOS
and Windows all auto-redirect), then insert a real coin and confirm time is credited and the
phone gets online. That's the whole loop working end to end.
AFTER YOU'RE LIVE
Fixes and new features reach the unit over the network from here on — no
re-flashing the card for future updates. When a new version is published, install it from the
System page with one click.
SUB-VENDO EXPANSIONplanned
One host unit running multiple physical coin-slot stations at different spots,
auto-detecting which station a customer is at — no manual switching. This
is a planned feature. The network design below is real and you can prepare the hardware and
wiring for it in advance, but the coin-report firmware and the admin panel screens that make it
work end to end have not been released yet. Everything above this section is what you can build
today.
HOW IT WILL WORK
Each sub-vendo location gets its own WiFi access point
(any brand) set to router / NAT mode, not bridge mode — that's what gives each location a
single, stable IP the host can recognize, no matter how many customers connect to it. A NodeMCU at
that location — wired to a coin acceptor the same way as a normal unit — reports coin events to
the host over its own wired connection, not its own WiFi. The host tells the two apart purely by
which static IP the traffic came from.
ADDRESS PLAN
Sub-vendo N → AP static IP
= 10.0.0.(149+N), NodeMCU static IP = 10.0.0.(199+N).
This reserves 10.0.0.150–10.0.0.249 (100
addresses, up to 50 sub-vendos) and leaves 10.0.0.2–10.0.0.149
free for the normal customer DHCP pool and the host itself — no separate network, no VLAN
required, everything stays on the same family of addresses the unit already uses.
Sub-vendo
AP static IP
NodeMCU static IP
1
10.0.0.150
10.0.0.200
2
10.0.0.151
10.0.0.201
3
10.0.0.152
10.0.0.202
…
…
…
50
10.0.0.199
10.0.0.249
FANNING OUT THE WIRING
Orange Pi One and Orange Pi Zero 3 have a single USB
port, already used for the client-facing link — there's no free port for a second network. A
VLAN-capable smart switch (or even a plain unmanaged switch) solves this: uplink one port to the
board, and connect every sub-vendo AP and NodeMCU to the remaining ports, all in the same single
VLAN, untagged. That behaves exactly like a plain switch — the address-based detection above
doesn't depend on VLANs at all — but it turns one port into as many as the switch has, which is the
actual constraint being solved.
HOW MANY SUB-VENDOS PER BOARD (estimate)
Rough engineering estimates, not bench-tested — actual
capacity depends on traffic patterns and what else the unit is doing.
Board
SoC / RAM
Concurrent clients
Sub-vendos as host
Orange Pi One
Allwinner H3, quad A7 @ 1.2GHz, 512MB–1GB
~30–50
~5–8
Orange Pi PC
Allwinner H3, quad A7 @ 1.6GHz, 1GB
~30–50
~5–8
Orange Pi Zero 3
Allwinner H618, quad A53 @ 1.5GHz, 1–4GB
~60–100
~10–20
Mini PC (x86)
multi-core, 4GB+
~150–300+
~50+
Not available yet: NodeMCU coin-report firmware, the host-side handler that receives it, and the
admin panel screens to configure sub-vendo IPs and view per-location sales. If you want to prepare
hardware ahead of a release, the network design above is what to build against — check back here
for updates once it ships.
VIDEO WALKTHROUGHS
Short walkthroughs of the steps above, when a video is quicker to follow than text.
ADD A TUTORIAL VIDEO — super admin
Title
Video link (YouTube or direct)
Description (optional)
Reviews
What operators running this software say. Posted by visitors, shown as written — no moderation queue.
—
☆☆☆☆☆
No reviews yet
LEAVE A REVIEW
Your rating
★★★★★
Distributors
Our authorized distributors — tap a card to open their Facebook.
Create a new licence key for a customer or walk-in sale. Leave the email blank to hold it as stock until you sell it. This always creates one key: if you fill in an email, that account owns it and the name is just a label on it (nothing is issued to the name separately); leave the email blank and the name alone records who has it as a walk-in sale.
Give a customer credits
owner account
Add credits to a customer's balance. They convert credits into licences themselves, from their own Credits page.
Credits
Available credits
0
Turn credits into licences
Licences
Every licence
owner account
This is not your personal list. It's every licence in the whole system — every customer's units, walk-in sales and unsold stock. Your own holdings are only in the "Licences" section above, at the top of this page.
Unsold stock & walk-ins
Not yet settled to a customer account — genuine unsold stock plus walk-in sales you might still reassign or revoke.
Customer licences — every customer, not yours
Every row below is already transferred to whoever the "Held by" column names and is presumably in use — that is expected, not a mistake, and is exactly why this list exists: so you can find any customer's licence again from one place. It is not a record of what you own. Copy, transfer, revoke, monitor, mark-lifetime and transfer-history all work here as before.
Transfer log
Transferred licences leave your list and appear in the recipient's; this is the history, and nothing here can be edited. To transfer a licence, use the Transfer button on its row above.
Pisowifi Live
Fleets
Your own groups of units. A customer's remaining time follows them between any units in the same fleet — different shop, different SSID, different ISP. Nothing to switch on: putting units together is the setting.
Fleet
Members
Add from your pisowifi list
Units currently in another fleet, or unassigned.
Customers
All registered accounts — they appear here automatically after sign-up.
Roaming balances
Wallets
Look up a customer's wallet by the phone number they registered with it. A wallet with no phone on file will not turn up here -- ask for their code directly.
Software
Downloads
Available while you hold an active licence.
Your account
Account
Signed in as .
Change your password
You have to type your current password even though you are already
signed in — being signed in on this device must not be enough on
its own to take the account over. Changing it signs this account out on
every other phone and computer, and leaves you signed in here.
At least 8 characters.
This is the owner account. Its password is a server secret, not
something stored here, so it cannot be changed from this page. Change
it on the server with fly secrets set
OPERATOR_PASSWORD=... and redeploy.
Owner
Sales
Every licence you have issued or handed to a reseller or customer, newest first — your record of what was sold, for review.
Owner
Reseller remittance
A manual ledger of what each reseller owes you. Add an entry when you hand licences to a reseller, and tick it off when they pay.
Owner
Distributors
Add the people who sell your units and keys. They appear on the public Distributors page with their photo and a link to their Facebook.