UBIQON RASPBERRY PI

Wiring & Installation Guide

Install Ubiqon on a Raspberry Pi 3 to 5 Model, connect the coin slot, and prepare the microSD card for your Ubiqon Piso WiFi system.

← Back to Downloads

Requirements

01
Raspberry Pi 3 to 5 Model

Raspberry Pi 3 to 5 Model single-board computer for the Ubiqon system.

02
MicroSD Card

16GB or larger, high-quality microSD card microSD card or larger.

03
Ubiqon System Image

Download the latest Ubiqon .img system image.

04
Raspberry Pi Power Supply

5V DC, 2.5A recommended.

05
Coin Slot Power Supply

12V DC, minimum 2A.

Default Coin Slot Wiring

The Raspberry Pi configuration described in this guide uses BCM GPIO2 (physical pin 3) for the coin-slot pulse input and BCM GPIO3 (physical pin 5) for the coin-slot set/relay output.

Function Raspberry Pi GPIO Physical Pin
Coin Slot Pulse BCM GPIO2 Pin 3
Coin Slot Set Pin BCM GPIO3 Pin 5
Ground GND Pin 9
GPIO numbering note: The values 2 and 3 refer to BCM GPIO numbers in Ubiqon settings. The corresponding physical header positions are pins 3 and 5. Confirm that the installed Ubiqon GPIO driver uses BCM numbering before connecting the coin-slot wires. These pins are shared with I²C.

Coin Slot Configuration

Configure the coin slot for:

Pulse Output: HIGH
Set Pin / Relay: ACTIVE HIGH
GPIO numbering: BCM (2 and 3)

Wiring

Coin Slot Pulse
→
Raspberry Pi BCM GPIO2
Physical Pin 3
Coin Slot Set
→
Raspberry Pi BCM GPIO3
Physical Pin 5
Power Supply GND
→
Raspberry Pi GND
Physical Pin 9
Important: The Raspberry Pi GPIO pins are 3.3V logic. BCM GPIO2 and BCM GPIO3 are also the I²C SDA/SCL pins (physical pins 3 and 5). Do not use them for another I²C device while assigned to the coin slot. Do not connect a 12V signal directly to a GPIO pin. The coin-slot pulse and set-pin signals connected to BCM GPIO2 and BCM GPIO3 must be electrically compatible with 3.3V GPIO. Use an appropriate level shifter or interface circuit if the coin-slot output is 5V or 12V.

Power Requirements

Device Required Power
Raspberry Pi 3 to 5 Model 5V DC / 2.5A recommended
Coin Slot 12V DC / 2A minimum
Important: Never connect the 12V coin-slot power supply directly to the Raspberry Pi power input. The Raspberry Pi requires a stable 5V supply. Use a suitable regulated supply and avoid powering the board through an undersized adapter.

Flashing the Ubiqon System Image

Ubiqon is distributed as a Raspberry Pi system image. Use balenaEtcher to write the downloaded image directly to the microSD card. If the download is compressed, select the supported image archive as provided.

1. Download the Ubiqon Image

Download the latest Raspberry Pi 3 to 5 Model image from the Ubiqon download page.

Download Raspberry Pi Image

2. Prepare the microSD Card

Use a 16GB or larger, high-quality microSD card microSD card or larger.

Insert the microSD card into your Windows PC using an SD or microSD card reader.

3. Download balenaEtcher

Download the official balenaEtcher application for Windows.

Download balenaEtcher

Official balenaEtcher Windows installer.

4. Start balenaEtcher

Open balenaEtcher on your Windows PC.

5. Select the Ubiqon Image

Click Flash from file and select the downloaded Raspberry Pi system image file. If using Android, extract the archive first when required by its format.

6. Select the microSD Card

Select the 16GB or larger, high-quality microSD card microSD card as the target drive.

Important: Make absolutely sure that the selected drive is the microSD card. Flashing will erase the selected drive.

7. Flash the Image

Click Flash and wait for balenaEtcher to finish writing and validating the image.

8. Remove the microSD Card

After flashing and verification are complete, safely eject the microSD card from Windows.

Start the Raspberry Pi

  1. Insert the flashed microSD card into the Raspberry Pi.
  2. Connect the network cable.
  3. Connect the coin slot wiring.
  4. Connect the required common ground.
  5. Connect the 5V power supply to the Raspberry Pi.
  6. Connect the 12V power supply to the coin slot.
  7. Power on the system.
Important: The Raspberry Pi requires 5V power. Do not connect a 12V power supply to the Raspberry Pi.

After Installation

  1. Allow Ubiqon to finish starting.
  2. Connect to the Ubiqon network.
  3. Access the Ubiqon portal.
  4. Configure the network settings.
  5. Configure the coin slot.
  6. Verify the coin slot pulse is detected.

Troubleshooting

Raspberry Pi does not boot

  • Check that the microSD card was flashed successfully.
  • Make sure the card is at least 16GB and is a reliable, high-quality card.
  • Check the 5V power supply and cable.
  • Use a stable 5V supply rated for 2.5A.

Coin is not detected

  • Check the coin-slot pulse connection to BCM GPIO2 / physical pin 3.
  • Check the coin-slot set connection to BCM GPIO3 / physical pin 5.
  • Check the common ground connection.
  • Confirm the coin slot is configured for Active High.
  • Verify that the GPIO signals are 3.3V-compatible.