Skip to the content
2 layers141.5 × 163.5 mmParking, the printed circuit board in 3D

An IoT smart parking gate system using Arduino, Python serial communication, and a Dockerized PostgreSQL database.

Size
141.5 × 163.5 mm
Copper layers
2
Thickness
1.6 mm
Parts
12
Nets
38
Pads
73
Tracks, vias
129, 0
Pours
1
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
11 May 2026
Updated
7 Jun 2026

Overview

Parking is an open-source printed circuit board by Freshovsky23, from the Freshovsky23/smart-parking-gate-iot repository on GitHub. It is a 2-layer board of 141.5 × 163.5 mm with 12 parts on 38 nets, routed with 129 tracks and 0 vias.

It is built around the ARDUINO UNO R3. Its parts include 3 resistors, 3 diodes, 2 connectors and 1 switch. It belongs with the AVR (ATmega, ATtiny) boards of this library.

Main components

1

README

README.md

Smart Parking Gate System & IoT Data Logger 🚗🅿️🖥️

An automated parking entrance system based on Arduino, integrated with a Python backend and a Dockerized PostgreSQL database for real-time event logging.

This project demonstrates a complete IoT pipeline: from physical hardware sensors and human-machine interaction (HMI), through custom PCB design, up to serial data communication and persistent database storage.


📺 Project Presentation & Demo

Watch the system in action on YouTube:

Watch the video

Click the badge above to watch the project implementation and physical mechanical execution details.


🚀 Key Features

  • Ultrasonic Detection: Automatically detects arriving vehicles within a range of 2-15 cm using the HC-SR04 sensor.
  • Interactive LCD UI: A 20x4 character display provides real-time instructions and feedback to the driver.
  • Smooth LED Animations: Uses PWM (Pulse Width Modulation) for professional-looking fade-in and fade-out effects on status LEDs.
  • Custom PCB Shield: Features a tailored, 2-layer Arduino Uno Shield designed in KiCad with a solid ground plane (GND copper zone) for stable operation.
  • Smart Event Logging: Python script (parking_logger.py) listens to the Arduino via USB Serial and processes system events in real time.
  • Dockerized Database: Uses docker-compose to instantly spin up a PostgreSQL instance for storing entry/exit logs securely.
  • Debounced Input: Intelligent button handling with software debouncing and edge detection to prevent accidental double-triggering.

🛠️ Hardware & PCB Design

The project has evolved from a breadboard prototype into a robust, custom-designed Arduino Uno Shield created in KiCad. This ensures optimal signal integrity, eliminates loose jumper wires, and makes the system deployment-ready.

📐 PCB View (3D Render)

The board features optimized power traces (0.50 mm), a precise potentiometer for contrast alignment, and a solid ground plane (GND Copper Zone) on the bottom layer.

Custom PCB Shield 3D Render

🛠️ Hardware Components

  • Microcontroller: Arduino Uno R3 (or compatible)
  • Custom PCB: 2-layer Custom Shield (KiCad design files included)
  • Display: LCD 20x4 (Hitachi HD44780 compatible)
  • Sensors: HC-SR04 Ultrasonic Distance Sensor
  • Indications: * Red LED (Entry blocked)
    • Green LED (Entry allowed)
    • White LED (Object in range)
    • Active/Passive Buzzer (Audio alert)
  • Input: Tactile Push Button (Gate Close trigger)
  • Passives: Resistors ($3 \times 220,\Omega$), Bourns 3386P Potentiometer (LCD Contrast adjust).

💻 Software Requirements

  • Arduino IDE: To compile and upload the .ino firmware.
  • Docker & Docker Compose: To containerize and run the PostgreSQL database.
  • Python 3.x: To execute the serial data logger.
  • Python Libraries: pyserial, sqlalchemy, psycopg2-binary.

🔌 Pinout Configuration

ComponentArduino PinTypeDescriptionTrack Width
VCC (+5V)+5VPowerMain power rail for LCD, Sensor, and Potentiometer0.50 mm
GNDGNDPowerCommon ground plane (Bottom Copper Zone)Copper Zone
LCD RSD2OutputRegister Select0.25 mm
LCD EnableD3OutputEnable Signal0.25 mm
LCD D4 - D7D4, D5, D6, D7OutputParallel Data Lines0.25 mm
HC-SR04 TrigD8OutputTrigger Pulse0.25 mm
HC-SR04 EchoD9InputEcho Pulse0.25 mm
Red LEDD10Output (PWM)Status Indicator (Entry Blocked)0.25 mm
Green LEDD11Output (PWM)Status Indicator (Entry Allowed)0.25 mm
White LEDD12OutputRange Warning Indicator0.25 mm
Push ButtonD13InputGate Close Trigger (Internal Pull-up)0.25 mm
BuzzerA5 (SCL)OutputAudio Alert Signal0.25 mm
LCD ContrastRV1 (Pin 2)AnalogContrast adjustment connected to LCD Pin 30.25 mm

⚙️ How to Run the Project (Quick Start)

1. Hardware & PCB Setup

  1. Open the KiCad files in hardware/ to inspect the schematic and PCB layout.
  2. Fabricate the PCB or assemble the prototype on a breadboard according to the Pinout Configuration table.
  3. Open simulator-parking.ino in the Arduino IDE and upload it to your board.
  4. Note the COM port your Arduino is connected to (e.g., COM9 or /dev/ttyUSB0).

2. Database Setup (Docker)

  1. Open your terminal in the project directory.
  2. Start the containerized PostgreSQL database by running:
    bash
    docker-compose up -d
  3. Backend Data Logger Setup Navigate to the directory containing parking_logger.py.

Configure your database connection string and correct COM port inside the script.

Run the Python application to start logging events into PostgreSQL: python parking_logger.py

📂 Repository Structure Plaintext ├── .github/ # GitHub workflows (if applicable) ├── arduino/ # Arduino firmware (.ino code) │ └── simulator-parking.ino ├── backend/ # Python application & logger scripts │ └── parking_logger.py ├── hardware/ # KiCad EDA Project files (Shield Design) │ ├── Parking.kicad_pro │ ├── Parking.kicad_sch │ ├── Parking.kicad_pcb │ ├── Parking_Schematic.pdf │ └── Parking.png # Gorgeous 3D view of the PCB ├── docker-compose.yml # Docker services initialization (PostgreSQL) └── README.md # Documentation 👤 Author Developer: @Freshovsky23

Contact: Heilman.Wiktor23@gmail.com

Parts

12
QtyValueFootprintReferences
3220Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR1, R2, R3
3LEDLED_THT:LED_D5.0mmD1, D2, D3
1Arduino_UNO_R3Module:Arduino_UNO_R3A1
1BuzzerBuzzer_Beeper:Buzzer_12x9.5RM7.6BZ1
1Conn_01x04_PinConnector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_VerticalJ2
1Conn_01x16_PinConnector_PinHeader_2.54mm:PinHeader_1x16_P2.54mm_VerticalJ1
1R_PotentiometerPotentiometer_THT:Potentiometer_Bourns_3386P_VerticalRV1
1SW_PushButton_Switch_THT:SW_PUSH_6mm_H5mmSW1

Similar boards

  • 2 layers68.8 × 53.6 mmRelatively Universal ROM Programmer, the printed circuit board in 3D

    Relatively Universal ROM Programmer

    AndersBNielsen/Relatively-Universal-ROM-Programmer

    Hardware to program W27C512 EEPROM or any 24/28/32 pin ROM requiring from 5V to 27V programming voltage.

    149 parts257GPL-3.0
  • 2 layers69.1 × 53.8 mmMotor controller, the printed circuit board in 3D

    Motor controller

    AlanFord/self-balancing-stick

    Dual Axis Reaction Wheel Inverted Pendulum

    25 parts79MIT
  • 2 layers68.6 × 53.3 mmProtogasm Board V2, the printed circuit board in 3D

    Protogasm Board V2

    Edging-Machines/Edging-Machines

    This repository is intended to contain as much information as possible about building, designing, prototyping, and using automated edging machines.

    14 parts67MIT
  • 2 layers53.8 × 69.6 mmEVSE V2 2, the printed circuit board in 3D

    EVSE V2 2

    PedroCNeves/AC_ChargingStation

    A learning project to create an EV AC Charging station based on an Arduino Uno

    32 parts50
  • 2 layers113.7 × 61 mmArduTester SMD, the printed circuit board in 3D

    ArduTester SMD

    jonsag/arduTester

    An arduino component tester based on https://create.arduino.cc/projecthub/plouc68000/ardutester-v1-13-the-arduino-uno-transistor-tester-dbafb4

    17 parts14
  • 4 layers65.9 × 52.9 mmMotor shield, the printed circuit board in 3D

    Motor shield

    DCC-EX/EX-MotorShield8874

    Design files for the open source 5A Motor Shield

    114 parts12
  • 4 layers68.6 × 53.3 mm101 PCB, the printed circuit board in 3D

    101 PCB

    ICRS/101

    The all-new open source Robotics 101 course from ICRS. It's specifically designed to be run in hackspaces, after school clubs and university societies.

    89 parts10CC-BY-4.0
  • 2 layers53.3 × 68.3 mmAnac 2040, the printed circuit board in 3D

    Anac 2040

    rallekralle11/Anna2040

    RP2040-based board in the shape of the Arduino uno

    63 parts9

Questions

How big is the Parking PCB?

It measures 141.5 × 163.5 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Parking use?

12 parts, built around the ARDUINO UNO R3. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Parking KiCad files?

From the Freshovsky23/smart-parking-gate-iot repository on GitHub, at the commit this page was made from: the board is hardware/Parking.kicad_pcb and its schematic hardware/Parking.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Parking design in my own project?

Its repository states no licence, so its author keeps all rights: ask Freshovsky23 before reusing the design.