Welcome to the README for the 42 Prague Smart Sign — a self-sufficient information display designed to be installed on a cluster door. Its purpose is to notify students when the cluster is reserved for an exam and prevent them from accidental entering. The device automatically retrieves exam dates from Intra and displays appropriate warnings and information on its e-paper screen. In the spare time it simply displays the cluster number.
For more information please refer to the technical documentation in this repository.
Once the 42 Prague Smart Sign is installed and powered on, it will automatically retrieve exam dates from Intra and update the display accordingly. The device operates in the following states:
- Normal state: The device displays the number of the cluster, accompanied by pictograms that depict some of the cluster use cases: cooperating with fellow peers, working on a computer, and studying from books. The last pictogram indicates "free to enter" contrasting with the "do not enter" cross pictogram that appears during exams. In case the Sign needs to communicate an issue with its operation, the pictograms are replaced with an appropriate error message, e.g.: "Low battery" or "Could not get exam info".
- Pre-exam warning: On the day of an exam, the device hides the pictograms and adds a small warning note informing students of an upcoming exam later in the day. This way, students who want to settle into the room can plan their work with the cluster availability limitations in mind.
- 1-hour countdown: 1 hour before the exam, a countdown begins. The device no longer displays the cluster number but a full-screen sign with the minutes left until the exam, indicating to students that it is time to vacate the classroom.
- Exam in progress: During the exam, the device displays a big bright-red warning sign indicating the ongoing exam. The drastically changed colour palette attracts attention, enhancing the sign's effectiveness.
- Post-exam state: After the exam ends, the Sign returns to its normal state, displaying the number of the cluster.
The device operates fully automatically and does not require any input from the school personnel.
- Automatic exam time check: the Sign keeps track of the exams published on Intra on its own;
- Exam subscribers check: if there is noone undertaking the exam, there is no need in blocking the room;
- Automatic battery charge monitoring: you will surely know when to charge the device;
- Deep Sleep mode: the microcontroller wakes up only when it has a task to do, drastically saving the battery charge;
- Telegram enabled: control the Sign, update its security token, and receive operational information — all remotely, via your Telegram chat;
- Over The Air firmware update: develop and upload new features from anywhere on the campus.
The following components are used in the 42 Prague Smart Sign:
- Seeed Studio XIAO ESP32C3 Wi-Fi module: provides connectivity to the Internet for retrieving exam dates, updates the display, takes care of the battery with its battery management and charging circuit — all of that while rocking modern USB-C port for charging and easy software updating.
- Good Display GDEY075Z08 7.5" 800x480 ePaper black/red/white SPI display: a high-resolution display that allows for clear and easy-to-read information.
- Good Display DESPI-C02 universal SPI e-Paper adapter: transforms display's FPC interface into microcontroller's SPI.
- 4000mAh Li-ion battery with overcharge and undercharge protection: powers the device and ensures continuous operation.
- IKEA RÖDALM photo frame, black, 13x18 cm: made a good enclosure.
- Custom 3D-printed board: to hold all the electronics in place.
The 42 Prague Smart Sign is designed with low-maintenance in mind. The battery capacity of 4000mAh ensures long periods of operation before requiring a recharge, typically once every few months. To recharge the device, it needs to be connected to a power source using any USB-C 5V power adapter. During the recharge, the Sign remains completely operational.
This project is a group effort of various 42 students with support from the 42 Prague Bocal team. Here they are:
- raleksan, 42 Prague — firmware and electronic hardware developer. Made the idea reality,
- gsura, 42 Prague — idea starter and motivation supporter. Pitched the idea to Bocal so well they ended up asking for two devices,
- cgray, 42 Prague — hardware development. Modeled beautiful and functional inner frame for the electronics,
- phelebra, 42 Prague — 3D printing. Turned 3D model into high-quality pieces of hardware.
- arosado-, 42 Lisboa — 42 API expert. Tought how to get the data from the 42 servers,
- jrathelo, 42 Nice — memory wizard. Helped resolve the microcontroller's RAM overflow.
The project is based on Jean-Marc Zingg's GxEPD2 library for e-paper displays. The project uses the ArduinoOTA library by Juraj Andrassy for the Over-The-Air software update functionality. The Sign's Telegram Bot functionality is provided by Brian Lough's UniversalTelegramBot library.
Contributions to the 42 Prague Smart Sign project are welcome! If you have any ideas, bug fixes, or improvements, feel free to open an issue, fork or submit a pull request on the GitHub repository.
When contributing, please adhere to the existing code style and follow the established guidelines. Clearly describe your changes and provide any necessary documentation or tests.
The 42 Prague Smart Sign project is licensed. Please, familiarise yourself with the license before using the software or working on it. The text of the license can be found in this repository.
Please note that while the project strives to provide accurate information, it is provided "as is" without any warranty. Use the project at your own risk.
Thank you for your interest in the 42 Prague Smart Sign project! We hope this README provides you with the necessary information to understand the project's purpose, features, installation process, usage, and maintenance. If you did not find the information you need, please, refer to the technical documentation in this repository. If you have any further questions or need assistance, please don't hesitate to reach out. Happy coding!