The MOBIL-ID project is an engineering systems capstone project for Oklahoma Christian University. The team’s mission statement is to create a mobile platform front-end to Oklahoma Christian University’s user management system. Students and Faculty will use their mobile ID to gain chapel attendance, enter the university cafeteria, and pay using Eagle Bucks.
The MOBIL-ID Reader is a slave device responsible for scanning MOBIL-ID passes. It captures the QR data from a scanned pass and sends it in a GET request to the MOBIL-ID Server. The MOBIL-ID Server returns the associated user ID number. The MOBIL-ID Reader then hands the ID number to the transactional system via the USB connection. Below is a guide to creating a fully functional MOBIL-ID Reader.
The MOBIL-ID Server is a Python web service responsible for creating, deploying, and updating passes using Apple PassKit & Google Pay API. It tracks the pass’s complete lifecycle. When a user requests a pass, the server gets the user's data from OC’s database, creates a new pass, and signs it before delivering it to the user. It keeps a log of every pass it creates. When a user adds the pass to Apple Wallet, the pass will send a registration request to our server. The server will log the device id and pass relationship. When users data is changed, the MOBIL-ID server then knows what device to send the update push notification to. If a user deletes a pass of their device, the server will receive a request to delete the pass and it will be deleted from the server’s database and no longer receive updates. The user will also recieve real-time push notifications when pass data has change. View MOBIL-ID Server
- Andrew Siemer - Electrical/Software Engineer - Team Lead
- Jacob Button - Electrical/Software Engineer
- Kyla Tarpey - Electrical Engineer
- Zach Jones - Computer/Software Engineer
- Steve Maher - Mentor
- Luke Hartman - Customer
- Peyton Chenault - System Integrator
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
The Hardware Setup Guide is a long but detailed document that steps through the entire process of creating a MOBIL-ID Reader. The document can be viewed or downloaded from the link below.
Before we start, check that you have:
- A clean installation of Raspberry Pi OS LITE on a microSD card
- Added the
sshfile to the/bootdirectory - Added the
wpa_supplicant.conffile to the/bootdirectory
You will not be able to continue without completing these steps. Use the links above to properly allow headless setup.
If you are confident you have completed the steps above, put the microSD card into the Raspberry Pi and plug the USB power cable in. You should hear a startup beep and the LED on the MOBIL-ID Reader Board should be magenta. If one of theses did not happen, you will need to troubleshoot your hardware setup.
In macOS/Linux, open Terminal and enter:
ssh pi@raspberrypi.localThe default password is raspberry.
Once you are logged into as user pi run:
curl https://raw.githubusercontent.com/andrewsiemer/MOBIL-ID-Reader/main/install.sh > install.sh && sudo bash install.shThis script installs software for the MOBIL-ID Reader on the Raspberry Pi.
This includes:
- Creating a new hostname & password
- Updating the package index files (apt-get update)
- Installing prerequisite software
- Installing MOBIL-ID software and examples
- Configuring boot options
Run time ~20 minutes. Reboot recommended after install. EXISTING INSTALLATION, IF ANY, WILL BE OVERWRITTEN.
The MOBIL-ID Reader will not work correctly until the system has been rebooted.
Once the MOBIL-ID Reader software is installed correctly and has been rebooted, the unit will use the LED on the MOBIL-ID Reader Board to show its status.
| LED Color | Description |
|---|---|
| Magenta | reader powered, starting program (~1 min) |
| Turquoise | connecting to network/updating software (<30 secs) |
| Yellow | waiting to connect to server |
| Green | connected, ready to scan |
| Red | processing scan |