Hardware & Wiring
Step 1 of 5 — wire the USB relay to the door strike, connect the QR scanner, and power on the Raspberry Pi.
This is the first of five steps to install a new ByteGate Edge device. Before any software runs, the Raspberry Pi needs three things physically connected: the USB relay wired to the door lock (this is what actually unlocks the door), the QR scanner for customers to present their code, and power/network so the Pi can boot and reach the ByteGate cloud.
The full install is five steps and takes about 20–30 minutes. Gather these before you start so you're not hunting mid-install: physical access to the Pi, the hardware from What You Need, a GitHub personal-access token (for Step 3), and this device's Location ID + Device Secret from the dashboard — Locations → your device (for Step 4).
Check relay ratings before energizing
Verify the relay's voltage and current ratings match your door lock before connecting power. Wrong ratings can damage the lock or relay. Terminal 1 is positive, Terminal 2 is negative — double-check polarity.
Connect the relay to the door strike
Wire the relay module's output terminals to your door lock mechanism:
- Terminal 1 → Door lock positive
- Terminal 2 → Door lock negative
Before connecting, verify the relay's voltage/current ratings match your door lock's requirements, use an appropriate wire gauge for the lock's current draw, and ensure proper grounding.
Plug the relay's USB cable into the Pi
Connect the USB relay module to any available USB port on the Raspberry Pi. The relay is bus-powered — it draws power over USB and needs no separate power supply.
Plug the QR scanner into the Pi
Connect the USB QR scanner to another available USB port. It works as a standard USB HID keyboard-emulation device, so no drivers are needed — the scanner types the scanned customer ID as if it were keyboard input.
Connect HDMI, network, and power
Connect an HDMI display if this device will show the kiosk UI (the system also runs headless, without a display, if you skip this). Connect Ethernet, or make sure Wi-Fi will be available, so the device can reach the ByteGate cloud. Connect the official Raspberry Pi power supply (5V, 3A recommended) last, once everything else is wired.
Field tip
The single most common wiring mistake is skipping the ratings check on Terminal 1/Terminal 2. The relay only switches the circuit — it doesn't supply the lock's power. Double-check the relay's voltage/current rating against your door lock's specification before you energize anything, and make sure the terminal polarity (positive to Terminal 1, negative to Terminal 2) is correct.
Last updated on