Bill Acceptor Setup
WifiCone supports bill acceptors via GPIO pulse counting. The acceptor sends a specific number of pulses to identify each denomination.
Wiring
A bill acceptor typically has 4 wires:
| Wire | Connection |
|---|---|
| +12V | 12V power supply |
| GND | Ground |
| Signal | GPIO pin on your board |
| Inhibit (optional) | GPIO pin to disable the acceptor when not in use |
Connect the signal wire to a free GPIO pin on your board.
Configuration
Go to Admin Panel → Payment Portals → Bill Acceptor.
| Setting | Description |
|---|---|
| Enable | Toggle the bill acceptor on/off |
| GPIO Pin | GPIO pin the signal wire is connected to |
| Pulse Map | Maps pulse count → denomination |
Default Pulse Map
| Pulses Received | Denomination |
|---|---|
| 2 | ₱20 |
| 3 | ₱50 |
| 4 | ₱100 |
| 5 | ₱200 |
| 6 | ₱500 |
These defaults work with most Philippine bill acceptors. If your acceptor uses different pulse counts, update the map to match.
How Pulse Mapping Works
When a customer inserts a bill:
- The bill acceptor validates and accepts the note.
- It sends a series of pulses to the GPIO pin (e.g., 4 pulses for ₱100).
- WifiCone counts the pulses and maps them to the denomination.
- The denomination amount is added to the customer's session balance.
Testing
- Insert a ₱20 bill.
- Open Dashboard → Payment Events — you should see a ₱20 event.
- Repeat with ₱50, ₱100, ₱200, ₱500 to verify each denomination maps correctly.
Troubleshooting
| Problem | Likely Cause | Fix |
|---|---|---|
| Bills not registering | Wrong GPIO pin | Verify wiring and update pin |
| Wrong amount credited | Pulse map mismatch | Count pulses manually and update the map |
| Bills rejected | Acceptor not powered | Check 12V supply |
| Double-counting | Electrical noise | Add a debounce delay (contact support for firmware setting) |
Supported Bill Acceptors
WifiCone works with any GPIO pulse-type bill acceptor. Common models:
- JCM Global series
- CPI / Crane Payment Innovations
- ICT Bill Validator B1 series
- Generic pulse-output validators
Verify that your acceptor is set to pulse mode (not serial/UART mode), as WifiCone uses GPIO pulse counting, not serial communication.