Project ID: LIX2
Supervisor: Dr Cindy Xin LI
By: Cheung Ka Yi Grace // Ng Chi Him // Wong Hiu Nam // Wong Ho Yan Veronica
This repository contains all source code for Year 2019-20 Group LIX2's Final Year Project: Smart Car Park.
Source code for different components of the system are stored in their own respectively folders.
Please refer to READMEs in the respective folders for setup, usage and more.
The car park of the HKUST campus operates on manual and paper processes, which is inefficient and prone to human error. By leveraging technologies like the Internet of Things, cloud computing, and artificial intelligence, the operations of the car park could be smoothened and speeded up with a reduction in human resources required. This project aims to develop an integrated solution to digitize car park operations, such as visitor guidance, payment, access control, and park management.
This report presents a data-driven, integrated smart car park system that features a wide range of components ranging from sensor devices, cloud-based backend, a tablet app for gate kiosks, a mobile app for drivers, to a web management portal. Data collection and analysis tasks like live telemetry collection and license plate recognition are continuously carried out. Utilizing the real-time data collected, the system then provides useful features to visitors and staff of the car park, such as visualization of lot vacancy, self-serviced e-payment, automated access control, visitor management, and car park usage analytics. The system has been tested in HKUST Car Park and has proven to be effective to improve the user experience and operational effectiveness of the car park.
Source code located in mobile/
Flutter is used as the main framework for building both apps
The kiosk app and the client app shares the same codebase. To switch between the two modes, change the isKioskMode boolean flag located in /lib/main.dart
Source code located in iot/
Scripts are written in TypeScript and transpiled to JavaScript to run in NodeJS. Controls ultrasonic distance sensor, manages IoT device state, takes snapshots and sync data to backend
Notice that Yarn package manager must be used for Raspiberry Pi Zero W (arm6l) compatibility
Source code located in web/
Web Admin Panel for monitoring and controlling car park. Also provides demo functionalities and data visualization. Based on Vue.js
Source code located in backend/
Cloud functions are separated into their own respective folders in functions/src:
-
cv/- License Plate Recognition -
iot/- Handles IoT devices' snapshot uploads and database iotStates changes -
stripe/- Calculate parking fee, generate payment secrets and provides webhook for Stripe events -
users/- Handles Stripe ID generation after user creation -
common/- Common modules and objects shared across different cloud functions
Source code located in license-experiments/
Obsolete code for experimenting with different approaches to license plate recognition.
For production implementation, refer to backend/functions/src/cv/