G-WIFI
G-COINVENDO
g-wifi
G-COINVENDO.com
SYSTEM ONLINE — SECURE LICENCE PLATFORM
POWERING YOUR VENDO

G-WIFI

Software Solution

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 3 Raspberry Pi 3Raspberry Pi 4
G-WIFI software solution
WHAT YOU GET

Eight things this software does

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 stops the machine

A revoked unit collects a signed revocation on its next check-in and stops trading. Signed with the same key it was built with, so nothing on the wire can fake one — and silence is never treated as revocation, so an ISP outage does not switch off a paying customer.

About

G-WIFI software solution

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.15010.0.0.249 (100 addresses, up to 50 sub-vendos) and leaves 10.0.0.210.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-vendoAP static IPNodeMCU static IP
110.0.0.15010.0.0.200
210.0.0.15110.0.0.201
310.0.0.15210.0.0.202
5010.0.0.19910.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.

BoardSoC / RAMConcurrent clientsSub-vendos as host
Orange Pi OneAllwinner H3, quad A7 @ 1.2GHz, 512MB–1GB~30–50~5–8
Orange Pi PCAllwinner H3, quad A7 @ 1.6GHz, 1GB~30–50~5–8
Orange Pi Zero 3Allwinner 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.

Distributorscoming

Where to buy units and licence keys. Nothing listed yet.

DEVELOPED BY

THATAY KHO NEÑO

Operator account

Log in

One account for both products — G-WIFI and G-PISOTAB.

Signing up gives you a console for units you already own. Bought a licence key? Create an account, then add the key from the Licences page.

READY TO SECURE YOUR KIOSKS?  ·  gpisotab.com